Quickstart
Get Swarm running
Install the box on a Linux machine, add a model key, then connect your own AI and tell it to set up Swarm.
Install the box.
Swarm is a box you deploy AI workers to. It comes with three workers on the recommended models: a coder, a designer and a finder.
Run the installer
Use Ubuntu 24.04 on x86_64, your own PC or a server. Run it from your own account.
curl -fsSL https://swarmagent.dev/install | sudo bashLet it finish
The installer installs Docker (unless a working one is there) and gVisor, and runs Swarm and its setup page as services listening on 127.0.0.1 only.
At the end it creates Swarm's owner for you, puts an AI key for your AI in ~/.config/swarm/ai-key (only you can read it) and prints how to connect.
Tailscale is not needed. Add --tailnet only to reach the machine from other devices.
Add a model provider key
Open the setup page at 127.0.0.1:8443, or add the key by script. Never paste keys into chat.
sudo bash /var/lib/swarm-headless/src/containers/headless/app/install.sh key PROVIDER < key-fileConnect your AI.
Your own AI gives the workers jobs, waits, reads what they delivered and what it cost, and merges it.
Install the Swarm plugin. It needs Node 22+ and finds ~/.config/swarm/ai-key itself.
claude plugin marketplace add swarm-agent/swarmclaude plugin install swarm@swarmThe installer prints the line to add. It reads the key from an environment variable.
Claude Code with the tools only, without the plugin: use the claude mcp add line in the README.
Set up Swarm.
Tell your AI "set up Swarm". It does the rest with you.
Your AI checks that a model provider is connected.
It asks which folders your work is in and creates a project with them: a name and your folders.
Each job runs on its own branch, in a sandbox per project, with no access to the host, your network or Swarm's keys. Delivering a job is a local git merge, never a push.
Tip: Ask your AI whether the box is all right and what happened since last time. There is no dashboard to learn; the only page is the setup page.