supastishn/automate

⚡ AutoMate Self-hosted personal AI agent. Multi-channel, tool-using, plugin-extensible.

Features • Quick Start • Architecture • Tools • Plugins • Web UI • Configuration

---

AutoMate is a personal AI assistant platform that runs on your own hardware. Connect any OpenAI-compatible LLM, give it tools (shell, browser, files, web search, etc.), and let it work for you across Discord, the web UI, or the CLI.

Built in TypeScript. Runs on anything from a beefy server to an Android tablet via Termux. ~24K lines of code — lean, fast, no bloat.

Features

• Multi-channel — Web UI, Discord, CLI. Talk to your agent from anywhere.
• 30+ built-in tools — Shell, file ops, browser automation, web search, image analysis/generation, cron jobs, background processes, memory, and more.
• Stealth browser — Undetected Chrome via Selenium + stealth patches. Bot-proof web automation with human-like typing, clicking, and navigation.
• Plugin system — Drop a JS file in a folder, get new tools instantly. Hot-reload, config schemas, lifecycle hooks.
• Persistent memory — Two-layer system: daily logs (journal) + curated MEMORY.md (long-term brain). Vector search across all memory.
• Session management — Multiple concurrent sessions with independent tool states. Context compaction when conversations get long.
• Sub-agents — Spawn parallel autonomous agents for multitasking. Blocking or fire-and-forget modes.
• Skills — Hot-reloadable SKILL.md files that teach the agent new capabilities without code changes.
• ClawHub — Browse and install community skills from the registry.
• Heartbeat system — Periodic autonomous check-ins. Your agent does work even when you’re not talking to it.
• Canvas — Push HTML, Markdown, code, or JSON to the web UI in real-time. Great for dashboards, games, visualizations.
• Multi-agent — Run multiple agents with different personalities, models, and tool access.

Quick Start

Prerequisites

• Node.js 22+
• An OpenAI-compatible API endpoint (OpenAI, Anthropic via proxy, Ollama, LM Studio, etc.)
• Optional: Python 3.10+ for browser automation, Chrome/Chromium for stealth browsing

Install

git clone https://github.com/supastishn/automate.git
cd automate
npm install

# Build the web UI
cd ui && npm install && npm run build && cd ..

Configure

# Copy the example config
cp automate.example.json ~/.automate/automate.json

# Edit with your API details
nano ~/.automate/automate.json

Minimal config — just set your model and API endpoint:

{
  "agent": {
    "model": "claude-sonnet-4-20250514",
    "apiBase": "https://api.openai.com/v1",
    "apiKey": "sk-..."
  }
}