An Army of AI Agents at Your Fingertips
An open-source locally-running orchestrator for managing multiple agents in parallel.
Launch, monitor, and coordinate entire swarms of coding agents from a single interface.

Why Open Swarm?

Running agents in a terminal works fine for one task. But when you're juggling five agents across different branches, approving tool calls in separate windows, and losing track of who's doing what — it falls apart fast.

Parallel agents, one screen — Launch as many agents as you need, arranged on a spatial canvas you can pan and zoom freely
Unified approval workflow — Every tool-use request from every agent surfaces in one place. Approve or deny with a click or a keyboard shortcut.
Full conversation control — Edit prior messages to fork conversations, navigate between branches, resume closed sessions
100% local — Everything runs on your machine. No cloud relay, no telemetry, no third-party backend.

Features

Spatial Dashboard — Infinite canvas with drag-and-drop agent cards, view cards, and embedded browser cards. Create multiple dashboards for different workspaces.

Agent Chat — Full streaming chat interface powered by WebSockets. Real-time token output, cost tracking per session, and persistent history that survives restarts.

Human-in-the-Loop Approvals — Agents request permission before executing tools. Approve or deny individually, or batch-approve from the dashboard. Configurable per-tool permissions (always allow, ask, deny).

Message Branching — Edit any prior message to fork the conversation. Navigate freely between branches without losing context.

Skills Library — Manage skills that sync directly to ~/.claude/skills/. Browse and install from the official Anthropic skills marketplace.

Tools Library — Configure MCP tool servers (stdio, HTTP, SSE) with automatic tool discovery. Browse the MCP registry and Google's catalog with GitHub star counts. Includes Google Workspace OAuth integration.

Agent Modes — Five built-in modes (Agent, Ask, Plan, View Builder, Skill Builder) plus custom user-defined modes with configurable system prompts and tool restrictions.

Views & Outputs — Create interactive HTML/JS/CSS artifacts rendered in iframes. Supports vibe coding (LLM-generates the view), backend Python execution, auto-run with LLM-generated data, and agent-driven data gathering.

Git Worktree Isolation — Each agent operates in its own git worktree and branch, preventing conflicts between parallel workstreams.

Diff Viewer — Inspect uncommitted changes in any agent's worktree without leaving the app.

Cost Tracking — Real-time USD spend tracking per agent session.

Dark & Light Themes — Full theme support with design tokens.

Keyboard Shortcuts — Navigate between agents, approve/deny requests, and switch pages. Press ? in-app to see all shortcuts.

Quick Start

Desktop App

Download the latest release for macOS from GitHub Releases.

Windows and Linux builds are planned but not yet available.

Development Setup

Prerequisites: Python 3.11+, Node.js 18+, Git

git clone https://github.com/openswarm-ai/openswarm.git
cd openswarm
bash run/local.sh

This starts the backend (port 8325), frontend (port 3000), and Electron shell together. Once running, set your Anthropic API key in the in-app Settings page.

See the Contributing Guide for detailed setup options, environment configuration, Google Workspace integration, and troubleshooting.

Architecture

Electron Shell (desktop wrapper, auto-updater)
├─────────────────────────────────────────────────────────────────────┐
│                                                                     │
│   Frontend (React/TypeScript :3000)       Backend (FastAPI :8325)   │
│   ┌───────────────────────────────┐      ┌───────────────────────┐  │
│   │  Spatial Dashboard Canvas     │◄────►│  REST API  (/api/*)   │  │
│   │  Agent Chat (streaming)       │      │  WebSocket (/ws/*)    │  │
│   │  Skills / Tools / Modes       │ WS   │  Agent Manager        │  │
│   │  Modes / Views / Commands     │◄────►│    └─ claude-agent-sdk│  │
│   │  Settings                     │      │  MCP Tool Discovery   │  │
│   │  Redux Toolkit (state)        │      │  JSON File Storage    │  │
│   └───────────────────────────────┘      └───────────────────────┘  │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

Tech Stack

Frontend — React 18, TypeScript, Redux Toolkit, Material UI v7, CodeMirror 6, Framer Motion, React Router v7, Webpack 5

Backend — FastAPI, Python 3.11+, Pydantic v2, claude-agent-sdk, Anthropic SDK, WebSockets, httpx

Desktop — Electron 33, electron-builder, electron-updater (auto-updates via GitHub Releases)

Bundled Runtime — Standalone Python 3.13 (via python-build-standalone) so end users don't need Python installed

Contributing

Contributions are welcome — see CONTRIBUTING.md for the full development setup, project structure, and contribution workflow.

License

MIT — see LICENSE for details.