Skip to main content

​
Choose your setup path

There are two ways to get started with OpenSwarm. Pick the one that fits you best.

One-Click Download

Download the macOS app and launch instantly — no terminal required.

Clone the Repo

Grab the source, run locally, and contribute or customize.

​
One-Click Download

The fastest way to get started. OpenSwarm ships as a standalone macOS .dmg — Python is bundled, so there’s nothing extra to install.
1

Download the app

Go to openswarm.info and click Download for macOS.Open the .dmg, drag OpenSwarm into your Applications folder, and launch it.
OpenSwarm requires macOS. Linux and Windows support is on the roadmap.

​
Clone the Repo

For developers who want to run from source, contribute, or build on top of OpenSwarm.

​
Prerequisites

  • Node.js 18+ and npm
  • Python 3.11+ (or use the bundled runtime)

​
Setup

1

Clone the repository & open it's root directory

git clone https://github.com/openswarm/openswarm.git && cd openswarm
2

Create the .env file

cp backend/.env.example backend/.env
3

Fill in the .env variables

Set your anthropic keys, google auth credentials, etc.
4

Run the app

bash run.sh
This starts both the FastAPI backend and the Electron frontend together.

​
What’s next

Spawn multiple agents

Learn how to run agents in parallel — each in its own git worktree, zero conflicts.

Set up MCP tools

Connect Reddit, Google Workspace, Twitter, browser automation, and more.

Build Skills & Templates

Create reusable slash-command skills and prompt templates for your team.

Approvals & Permissions

Configure per-tool permissions and keep humans in the loop.
Pro tip: Use message branching to fork any conversation and explore multiple approaches without losing your original thread.