Live in one command.
One line of curl and the swarm is up.
It clones, inspects your machine, adopts your provider and keys, and verifies
the whole stack before it hands you the dashboard.
- DETECTSYour machinePython 3.11+, a browser, an existing Hermes config — it picks the right path automatically.
- ADOPTSYour provider40+ LLM providers via
hermes setup. Already configured? It reuses your keys and skips the wizard. - VERIFIESThe stack
hermes-swarm doctorconfirms runtime, model reachability, and Chromium before you start.
Every node is a full agent.
Not a prompt in a loop. Each agent has a real terminal, a browser, a filesystem, and the autonomy to use them — then collaborates with the rest of the team to push the mission forward.
Watch them workBrowses the live web
Search and extract from any page. Hits a login, CAPTCHA or 2FA? It hands the browser back to you — embedded right in the dashboard, even on a headless server.
Runs a real terminal
Executes commands, writes and edits files in a shared project directory, and builds its own tools when one is missing.
Collaborates peer-to-peer
Agents message teammates directly on a shared brief. Supervisors review and nudge; a loop detector breaks stalls before they waste a cent.
Publishes to real platforms
Drafts, posts, and ships to live services through the browser — with you approving anything that needs a human sign-off from the inbox.
Tunes itself — with your approval
Agents read their own config and telemetry and propose changes ("raise my iteration limit"). You approve or reject from the inbox.
One pane of glass for the whole swarm.
See each agent think, call a tool, and answer — in real time. Read team health at a glance, then intervene with one click: reply to a question, approve a change, or take over a browser.
Built for unattended runs you can trust.
auto-pauses at the cap — work held, not lost
max_iterations 90 → 140“hitting the cap on deep-research tasks”Human inbox
Agents ask for a decision, a credential, or a login they can't do alone. It lands in your inbox; you reply and they resume.
Daily budget caps
Set a per-team USD ceiling. At the cap, agents pause — work held, not lost — and auto-resume at 00:00 UTC or when you raise it.
Embedded browser takeover
Drive an agent's live browser session right inside the dashboard to clear a login or CAPTCHA — then hand it back. Works on a display-less VPS.
Scheduled work (cron)
A 9am competitor check, an hourly metrics pull, a Monday digest. Recurring or one-shot — agents can even schedule their own wake-ups.
Crash-safe by design
Restart freely. In-flight tasks recover and resume, history persists, and a budget-paused team stays correctly paused.
Your keys, your data
Runs entirely on your hardware. Provider keys and credentials stay local on disk with 0600 permissions — never echoed back.
From zero to a working team in three steps.
Configure a provider
One hermes setup wizard — pick from 40+ providers, paste a key, choose a model. The swarm reads it directly.
Build a team
Tell the Architect what you want to accomplish. It proposes the agents, their roles, and who talks to whom — then builds it live on your approval.
GUIDED BY THE ARCHITECTDeploy & steer
Hand the team a mission and watch it run 24/7 from the console. Answer questions, approve changes, adjust budgets — all from one screen.
RUNS UNATTENDEDYour hardware. Your rules.
No SaaS, no tenant, no data leaving your box. Run it on a laptop for an afternoon or a VPS for a year — the specifications are the same.
| Runtime | Docker or Python 3.11+. The image bundles Python, Hermes, Chromium and the dashboard; agents run contained inside it. |
|---|---|
| Providers | 40+ LLM providers via hermes setup — Anthropic, OpenAI, OpenRouter, Groq, DeepSeek, local models — or a custom / OpenAI-compatible endpoint. |
| Access control | Single shared API key. Set SWARM_API_KEY and every endpoint and the live WebSocket require it; the dashboard prompts once. |
| State | Everything on disk under one data dir — team configs, task queues, conversation history, the shared project, and credentials. Rotating backups on every save. |
| Observability | /health + structured logs. Uptime, queue depth, and backend reachability for any uptime monitor; logs to stdout or a rotating file. |
| License | Open source. Self-hostable, inspectable, yours to fork. |