davidondrej/superbot
AI EngineeringSelf-hosted multi-agent workspace where named AI bots share one Linux VPS and run on coding-agent CLIs.
What it is
SuperBot is a self-hosted web service for running a team of named AI bots. You talk to a main bot, which hands work to focused bots (Developer, Researcher, Inbox, and so on); each bot keeps its own chat and memory, and all of them share one Linux machine on your VPS so files and sign-ins persist between tasks. It runs on an existing coding-agent CLI rather than shipping its own model: Claude Code works first, with Codex and Pi supported through small adapters, while Grok Build and Hermes Agent are planned.
It is positioned as an open-source alternative to Grok Bot and is not affiliated with xAI or X. The intended user is someone comfortable running a Rust service on a server they control and who already pays for or has installed a supported agent CLI.
How it works
- You message the main bot.
- It distributes work to specialized bots.
- Each bot executes through the agent CLI selected for it.
- All bots share one Linux computer, with persistent files and logins.
Memory is stored as plain files, so you can ask a bot what it remembers about you. Bots can also create their own cron-style schedules and ask each other for help. The Rust server, adapters and CLI are designed to keep the deployment to a small binary; browser-side code is used only where needed.
Quick start
Requirements: a Linux environment with Rust/Cargo, and at least one supported agent CLI (claude, codex, or pi) installed and logged in as the same user that will run the server.
cargo build --release
cp .env.example .env
# edit .env with your settings
set -a; . ./.env; set +a
./target/release/botd
The build produces target/release/botd and target/release/botctl. After botd is running, open the web app and say hello to SuperBot. For VPS deployment details, see the backend guide.
Constraints and status
- The project labels itself early-stage: chat with bots over Claude Code, Codex or Pi, plus memory, routines and bot-to-bot handoff, is described as working. Approvals, computer use, skills and Slack are listed as planned, not available.
- The architecture is tied to one shared Linux machine; it is not a cross-platform desktop tool.
- You must supply and authenticate separate agent CLIs; SuperBot does not include model access.
- License is MIT.
HotRepo's take
Among Rust repositories tracked on the new-project list for 2026-11-16, SuperBot recorded 102 stars and 29 forks in a growth window that began on 2026-11-15, but it has no recorded ranking on the all-language daily chart. The early-stage label and the planned features matter more than the single-snapshot numbers: the working scope today is the shared-computer bot team over existing agent CLIs, and approvals/computer use are still ahead. The project's own architecture notes about how Grok Bot might work are explicitly a guess, so they should be read as design context rather than documentation of either product.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- elie222/rakazoA self-hosted multi-channel AI agent platform for persistent bots with sandboxed computers, aimed at people who want to own the stack.
- ahmadrosid/nakamaSelf-hostable multi-tenant platform for teams to run, share and govern AI agents with tools, memory and messaging channels.
- nickvasilescu/bot-hqA multi-agent chat workspace where each bot runs as a Hermes agent with its own screen on a shared cloud computer.
- 2SinceJuly/SkyDotSelf-hosted multi-user agent workbench for creating named AI companions with shared group chats, scheduled tasks, skills, MCP, and memory.
- milind-soni/OpenMausBotAn open-source desktop chat app that runs a roster of local Claude, Codex, or Grok agents, each with its own computer and connected apps.