submind

Create autonomous AI agents that live in git repos. Every action is a commit, every decision is auditable, every mistake is revertible.

Quick Start

mkdir my-agent && cd my-agent
npx submind@latest init
npm run setup
docker compose up -d

The setup wizard handles everything: GitHub repo creation, API keys, secrets, and environment config.

How It Works

1. You interact with your agent via web chat, Telegram, webhooks, or cron schedules
2. The Event Handler (Next.js) creates a job branch on GitHub
3. GitHub Actions spins up a Docker container with the Pi coding agent
4. The agent does the work, commits results, and opens a PR
5. Auto-merge handles the rest. You get a notification when it's done.

Requirements

• Node.js 18+
• Git & GitHub CLI
• Docker & Docker Compose
• An LLM API key (Anthropic, OpenAI, or Google)

Updating

npm install submind@latest
npx submind init
git add -A && git commit -m "upgrade submind"
git push

Pushing to main triggers an automatic rebuild on your server.

Docs

• Architecture — Two-layer design, API endpoints, GitHub Actions
• Configuration — Environment variables, secrets, Telegram
• Deployment — VPS setup, Docker Compose, HTTPS
• Security — What's exposed and how to secure it
• Upgrading — Automated upgrades, troubleshooting

License

MIT