SWARM WRIGHT
multi-agent AI, built by you.

A self-hosted workbench for designing, running, and inspecting swarms of AI agents. Agents are plain markdown, orchestrated by one config, observable in real time.

QUICK START — two commands ↓
$ docker pull ralphbarendse/swarmwright:latest
$ docker run -d --name swarmwright --network host --restart unless-stopped -v ./data:/data ralphbarendse/swarmwright:latest
or skip the server — get a hosted instance →
free source-available · CC BY-NC 4.0 self-hosted read the docs →

SwarmWright — Self-hosted multi-agent AI orchestration platform for agentic LLM workflows

01 why we built this

Most AI agent tools
pull you to one extreme.

Either you hand over full control and hope for the best, or you hand-code every step yourself. We built SwarmWright for the space in between — structured enough to trust, flexible enough to actually use.

← give away control
SwarmWright lives here
hand-roll everything →
not this
The autonomy trap

Full Autonomy

Autonomous agents · no guardrails · hope for the best

Give agents a goal and let them figure out the rest. They call anything, spawn sub-agents, take actions you never explicitly authorized. Looks impressive in demos. It's a liability in production.

  • Agents call anything — no enforcement
  • You can't explain what happened
  • Important calls happen without review
  • Your compliance team will never sign off
this

Structured Agent Work

SwarmWright

Agents operate inside a topology you design. Every connection is declared upfront. Every decision leaves a reason. You approve the ones that matter. Non-technical people can read the configuration and know exactly what the system does.

  • All connections declared — nothing unchecked
  • Every edge has a stated purpose
  • Human gates built directly into workflows
  • Readable by business, ops, and compliance
not this
The rigidity trap

Custom Pipelines

Custom code · DIY pipelines · hard-coded chains

Write every step by hand. It works — until it doesn't. Changing one thing breaks three others. Six months in, nobody understands it. Every new workflow is another one-off only one person can maintain.

  • Every swarm is a unique implementation
  • No standard structure to onboard into
  • Expensive to change, brittle to extend
  • Auditing means reading source code

SwarmWright is the operating system for your AI workforce — structured enough to deploy with confidence, expressive enough to handle real-world complexity, and every decision is traceable back to the rule that caused it.

02 what you get

Features

opinionated by design. every choice has a reason.

SwarmWright is opinionated by design. Every architectural choice has a reason. Every agent connection must be declared. Every action leaves a trace.

localhost:5001 · setup
one command

Up and running in one command.

No server to configure, no infrastructure to manage. Pull the container, create your account, point it at your API key — your swarm is live in under a minute. Everything your agents produce stays on your machine.

  • Works on any machine that runs Docker
  • All data stored locally in a single folder you own
  • Survives restarts — pick up exactly where you left off
  • LLM credentials are encrypted and never leave the container
Claude (Anthropic) GPT-4 (OpenAI) Deepseek Runs on Docker Local-first data
localhost:5001 · canvas
visual canvas

Design your AI team visually.

Drag agents onto a canvas, draw connections between them, and describe why each connection exists. It looks and feels like sketching on paper — because it should. No YAML to write by hand. No diagram that's out of date the moment you deploy.

  • Drag-and-drop canvas — place agents, draw connections
  • The diagram is the configuration — always in sync
  • Each connection asks: what is this for? Forces clear thinking
  • Color-coded by role so the structure is obvious at a glance
localhost:5001 · constitution
plain-english identity

Write what your agents believe in.

Every agent is a plain-language constitution — its role, its rules, the knowledge that shapes how it thinks. No prompt spaghetti buried in code. A finance manager can read exactly what an agent is for, and so can you, six months from now.

  • Markdown you can read, diff, and sign off on
  • Identity lives in the constitution; what it can call lives in the topology
  • Your compliance officer can review it — no code required
  • Drafts in seconds, then edit by hand whenever you like
localhost:5001 · control room
live audit trail

See every decision, always.

Watch a run unfold step by step, live. Every single action records the plain-English purpose that authorized it — straight from the topology. It isn't a generic log; it's a semantic audit trail an auditor can read without touching a line of code.

  • Every step streamed live as it happens
  • Each action carries the exact reason it was allowed
  • Unauthorized calls flagged as first-class concerns, not buried errors
  • Hand a run to an auditor — it explains itself
and everything else

Know exactly what your agents can do.

Every connection declared upfront. Unauthorized actions caught and surfaced immediately.

Or just describe what you need.

Tell the built-in Operator in plain English — it designs the topology, writes the agents, and wires the skills for you.

Roles your team already understands.

Policy, Orchestrator, Executioner, Perceptionist — like a real org chart.

Give your agents superpowers, safely.

Python, databases, APIs — run as subprocesses. Permissions always explicit.

Stay in control when it matters.

Agents pause for high-stakes decisions. You approve, work resumes exactly where it stopped.

Use the AI model you trust.

Claude, GPT-4, or Deepseek. Switch providers without rebuilding anything.

Share knowledge across your whole team.

Upload once. Company docs, department rules, swarm context — all properly scoped.

Watch your swarm work in real time.

Live feed of every agent action. Problems flagged the moment they appear.

Team access, your way.

Per-user permission flags enforced in the UI and on the API. Users only see what they can do.

03 run it your way

Pricing

Run SwarmWright yourself for free, forever — or let us run it for you. The hosted version is the same product on a dedicated instance: your own isolated container, your own encryption key, your own subdomain. Export your data anytime.

Self-hosted
Free
forever · CC BY-NC 4.0
  • The full product — nothing held back
  • Runs on your hardware, your rules
  • Data never leaves your machine
  • Multi-user
  • Community support
two docker commands ↑
Hobby
$9.99$4.99/mo
or $100 $50/yr  50% off
  • 1 dedicated vCPU · 1 GB RAM
  • 5 GB disk
  • Hosted in Finland 🇫🇮
  • Your own <name>.swarmwright.com
  • Multi-user
  • Bring your own API key
  • Email support
get hosted →
Enterprise
Custom
invoiced · SLA
  • Custom CPU / RAM / disk
  • Host on your own domain
  • Dedicated host option
  • Multi-user
  • Priority email support
email us →

Hosted instances run in their own isolated container with a dedicated, per-instance encryption key — nothing is shared between customers. Cancel anytime; your data stays exportable for 30 days after.

One command.
Your swarm runs.

no broker setup · no cluster · no build step

docker pull ralphbarendse/swarmwright:latest