openswarm

Name: openswarm
Author: unohee

byunohee· 1 MCP server

Stars

830

Forks

144

How to install openswarm?

unohee/openswarm

$git clone https://github.com/unohee/openswarm

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install openswarm by running `git clone https://github.com/unohee/openswarm`, then use it for the current task and follow its documentation at https://github.com/unohee/openswarm.

Files · 1

View on GitHub

README.md

1	<h1 align="center">
2	<img src="https://raw.githubusercontent.com/unohee/OpenSwarm/main/assets/openswarm_hero.png" alt="OpenSwarm" width="480" />
3	</h1>
4
5	[![Sponsored by Atlas Cloud](https://img.shields.io/badge/⚡_Sponsored_by-Atlas_Cloud-4F46E5?labelColor=0B1120)](https://www.atlascloud.ai)
6	[![npm version](https://img.shields.io/npm/v/@intrect/openswarm.svg)](https://www.npmjs.com/package/@intrect/openswarm)
7	[![npm downloads](https://img.shields.io/npm/dm/@intrect/openswarm.svg)](https://www.npmjs.com/package/@intrect/openswarm)
8	[![license](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
9	[![SWE-bench Lite](https://img.shields.io/badge/SWE--bench_Lite-hybrid_3%2F3_resolved-2ea44f)](benchmarks/RUBRIC.md)
10	[![GitHub Discussions](https://img.shields.io/github/discussions/unohee/OpenSwarm?logo=github&label=discussions)](https://github.com/unohee/OpenSwarm/discussions)
11
12	> Autonomous AI agent orchestrator — Codex, GPT, OpenRouter (any model), local models (Ollama/LM Studio), and Claude Code (`claude -p`)
13
14	> 💬 Help shape OpenSwarm. Share feature ideas, vote on the roadmap, and ask questions in [GitHub Discussions](https://github.com/unohee/OpenSwarm/discussions). The roadmap is built in the open — your feedback decides what ships next.
15
16	---
17
18	OpenSwarm orchestrates multiple AI agents as autonomous code workers. It picks up issues from Linear or a built-in local tracker, runs Worker/Reviewer pair pipelines, reports through a pluggable notifier (Discord, Slack, Telegram, webhook), and retains long-term memory via LanceDB. Workers run on OpenAI Codex/GPT, any OpenRouter model, local open-source models (Ollama, LM Studio), or Claude Code (`claude -p`, opt-in) — with cost-aware routing measured on an L0–L6 benchmark ladder.
19
20	Verified on real GitHub issues: the agentic harness solves SWE-bench Lite instances graded by the official harness. Hybrid mode — a frontier model diagnoses read-only, a lightweight model implements with a verification loop — resolved 3/3 attempted instances that every single lightweight model had failed, at a fraction of frontier-only cost. Workers also learn each repository over time: task outcomes are stored as per-repo knowledge and recalled into future prompts. ([benchmark rubric & results](benchmarks/RUBRIC.md))
21
22	## Sponsors
23
24	OpenSwarm is proudly supported by [Atlas Cloud](https://www.atlascloud.ai) — an enterprise AI infrastructure platform serving fast, stable LLM, image, and video APIs (partnered with OpenRouter and SGLang).
25
26	As an official provider sponsor, Atlas Cloud ships as the built-in `atlascloud` adapter (OpenAI-compatible Chat Completions, `ATLASCLOUD_API_KEY`) and provides ongoing monthly API credits that keep the project's autonomous runs going. To run OpenSwarm on Atlas Cloud, grab a key at [atlascloud.ai](https://www.atlascloud.ai/console/api-keys), set `ATLASCLOUD_API_KEY`, and select `adapter: atlascloud`.
27
28	## Quick Start
29
30	```bash
31	npm install -g @intrect/openswarm
32	openswarm init # interactive setup wizard — provider auth + Linear OAuth + config
33	openswarm doctor # verify your environment (runtime, native deps, providers, ports)
34	openswarm # launches the TUI chat
35	```
36
37	`openswarm init` walks you through provider authentication, optional Linear OAuth (team/project picker), and writes a validated `config.yaml`. Prefer wiring a provider by hand? You need one first: `openswarm auth login` (ChatGPT OAuth, used by `codex`/`gpt`), `openswarm auth login --provider openrouter` (or `export OPENROUTER_API_KEY=…`), or just have an authenticated `claude` on PATH. Check what's wired with `openswarm auth status`, and diagnose any gaps with `openswarm doctor`.
38
39	### What `openswarm init` sets up
40
41	The wizard asks three questions, detects what you already have, and writes the config for you:
42
43	1. AI provider (worker/reviewer) — it auto-detects existing auth and offers inline login:
44	- `codex-responses` — ChatGPT subscr

6 picks

Type

openswarm

byunohee· 1 MCP server

Stars

830

Forks

144

How to install openswarm?

unohee/openswarm

$git clone https://github.com/unohee/openswarm

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install openswarm by running `git clone https://github.com/unohee/openswarm`, then use it for the current task and follow its documentation at https://github.com/unohee/openswarm.

Files · 1

View on GitHub

README.md

1	<h1 align="center">
2	<img src="https://raw.githubusercontent.com/unohee/OpenSwarm/main/assets/openswarm_hero.png" alt="OpenSwarm" width="480" />
3	</h1>
4
5	[![Sponsored by Atlas Cloud](https://img.shields.io/badge/⚡_Sponsored_by-Atlas_Cloud-4F46E5?labelColor=0B1120)](https://www.atlascloud.ai)
6	[![npm version](https://img.shields.io/npm/v/@intrect/openswarm.svg)](https://www.npmjs.com/package/@intrect/openswarm)
7	[![npm downloads](https://img.shields.io/npm/dm/@intrect/openswarm.svg)](https://www.npmjs.com/package/@intrect/openswarm)
8	[![license](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
9	[![SWE-bench Lite](https://img.shields.io/badge/SWE--bench_Lite-hybrid_3%2F3_resolved-2ea44f)](benchmarks/RUBRIC.md)
10	[![GitHub Discussions](https://img.shields.io/github/discussions/unohee/OpenSwarm?logo=github&label=discussions)](https://github.com/unohee/OpenSwarm/discussions)
11
12	> Autonomous AI agent orchestrator — Codex, GPT, OpenRouter (any model), local models (Ollama/LM Studio), and Claude Code (`claude -p`)
13
14	> 💬 Help shape OpenSwarm. Share feature ideas, vote on the roadmap, and ask questions in [GitHub Discussions](https://github.com/unohee/OpenSwarm/discussions). The roadmap is built in the open — your feedback decides what ships next.
15
16	---
17
18	OpenSwarm orchestrates multiple AI agents as autonomous code workers. It picks up issues from Linear or a built-in local tracker, runs Worker/Reviewer pair pipelines, reports through a pluggable notifier (Discord, Slack, Telegram, webhook), and retains long-term memory via LanceDB. Workers run on OpenAI Codex/GPT, any OpenRouter model, local open-source models (Ollama, LM Studio), or Claude Code (`claude -p`, opt-in) — with cost-aware routing measured on an L0–L6 benchmark ladder.
19
20	Verified on real GitHub issues: the agentic harness solves SWE-bench Lite instances graded by the official harness. Hybrid mode — a frontier model diagnoses read-only, a lightweight model implements with a verification loop — resolved 3/3 attempted instances that every single lightweight model had failed, at a fraction of frontier-only cost. Workers also learn each repository over time: task outcomes are stored as per-repo knowledge and recalled into future prompts. ([benchmark rubric & results](benchmarks/RUBRIC.md))
21
22	## Sponsors
23
24	OpenSwarm is proudly supported by [Atlas Cloud](https://www.atlascloud.ai) — an enterprise AI infrastructure platform serving fast, stable LLM, image, and video APIs (partnered with OpenRouter and SGLang).
25
26	As an official provider sponsor, Atlas Cloud ships as the built-in `atlascloud` adapter (OpenAI-compatible Chat Completions, `ATLASCLOUD_API_KEY`) and provides ongoing monthly API credits that keep the project's autonomous runs going. To run OpenSwarm on Atlas Cloud, grab a key at [atlascloud.ai](https://www.atlascloud.ai/console/api-keys), set `ATLASCLOUD_API_KEY`, and select `adapter: atlascloud`.
27
28	## Quick Start
29
30	```bash
31	npm install -g @intrect/openswarm
32	openswarm init # interactive setup wizard — provider auth + Linear OAuth + config
33	openswarm doctor # verify your environment (runtime, native deps, providers, ports)
34	openswarm # launches the TUI chat
35	```
36
37	`openswarm init` walks you through provider authentication, optional Linear OAuth (team/project picker), and writes a validated `config.yaml`. Prefer wiring a provider by hand? You need one first: `openswarm auth login` (ChatGPT OAuth, used by `codex`/`gpt`), `openswarm auth login --provider openrouter` (or `export OPENROUTER_API_KEY=…`), or just have an authenticated `claude` on PATH. Check what's wired with `openswarm auth status`, and diagnose any gaps with `openswarm doctor`.
38
39	### What `openswarm init` sets up
40
41	The wizard asks three questions, detects what you already have, and writes the config for you:
42
43	1. AI provider (worker/reviewer) — it auto-detects existing auth and offers inline login:
44	- `codex-responses` — ChatGPT subscr

6 picks

Type

openswarm

How to install openswarm?

Related

openswarm

How to install openswarm?

Related