OpenSwarm Files

OpenSwarm is an open-source AI agent team that lives in your terminal. Version 1.1.0 is the first stable release of its biggest upgrade yet: you can now design, build, and run your own multi-agent swarms from a single command — using OpenAI models, the whole model market through OpenRouter, or fully local models through Ollama.

Install

:::bash
npx @vrsen/openswarm

One command installs the terminal, prepares an isolated Python environment, and starts your agent team. Python 3.12+ and Node.js 20+ are required. Already on an earlier version? Run the same command again to get 1.1.0.

Agent Builder

Turn a plain-English idea into a working agent swarm without leaving the terminal.

• Use /agents to switch between Plan, Build, and Run modes.
• Plan designs the swarm with you first — agents, tools, and how they hand work to each other — before anything is created.
• Build creates the agents, their instructions, and their tools in your project.
• Run puts the finished swarm to work, with live agent, handoff, usage, and cost status as it runs.
• If a project fails to start, the full error stays on screen and OpenSwarm opens the right recovery path — fix it and retry with one key.

OpenRouter support

One API key unlocks the whole model market.

• Run any openrouter/... model with correct routing and credentials — including reasoning models, with reasoning output preserved across turns.
• Generate and edit Slides through OpenRouter-backed models.
• OpenSwarm automatically keeps OpenAI-only hosted tools away from models that cannot execute them.

Ollama support

Keep everything on your own machine.

• Run local Ollama models — or a custom local or remote Ollama endpoint — through the LiteLLM path.
• Unsupported OpenAI-hosted tools are replaced with safe provider-compatible behavior, so local models work instead of erroring.

OpenRouter and Ollama are separate integrations under the hood: OpenRouter uses a dedicated OpenAI-compatible client and reasoning adapter, while Ollama runs through the LiteLLM local-provider path.

Live Slides previews

Watch your deck take shape in the browser while the Slides agent is still building it. Setup installs everything Slides needs — Node dependencies and Playwright included — and OpenRouter-backed Slides requests use compatible routing and reasoning settings.

A terminal you can trust

• A failed prompt no longer eats your message: the draft and its attachments come right back for retry.
• Startup names each phase and keeps errors fully visible — no more silent hangs behind a spinner.
• Dependency refresh keeps compatible installed packages instead of re-upgrading them on every run, so switching modes is fast.
• Model, agent, handoff, usage, and cost indicators are easier to follow.
• Commands that don't apply to OpenSwarm (like the local-server /connect flow) are hidden entirely.

Add-ons, images, and video

• /addons is the single place to add optional provider keys: web search, Anthropic Claude, Google Gemini, Composio, fal.ai, and stock-media sources.
• Image and video tools tell you which providers are available and exactly which key is missing.
• Keys added mid-session are picked up by later tool calls — no restart needed.

Email, tools, and file safety

• Email workflows use the registered FindEmails tool for Gmail and Outlook.
• Document conversion can only embed images from inside the managed project directory — path-traversal and symlink escapes are blocked.
• Structured tool outputs are used where the agent contract requires them, and long-running tools send heartbeats instead of timing out.
• Windows startup, circular imports, output-path guidance, and UTF-8 bootstrap issues were fixed.

Under the hood

• One-command install, 12 native packages. The terminal now ships as native npm packages for macOS, Linux (glibc and musl), and Windows across ARM64, x64, and baseline x64 — no runtime binary downloads.
• A tested, reproducible release set. OpenSwarm 1.1.0 pins AgentSwarm 1.4.41 and Agency Swarm 1.10.4, so every fresh install gets the exact combination this release was tested with. Agency Swarm 1.10.4 also keeps LiteLLM on prebuilt wheels, fixing failed installs on macOS and Windows.
• A built-in catalog of 100+ providers and 4,000+ models, validated at build time so a release can never ship with an empty model list.
• Fork-ready product platform. OpenSwarm's branding, packages, and behavior are driven by product configuration on top of the generic AgentSwarm terminal, and forks can declare validated marketplace identity through openswarm.marketplace.json.
• Telemetry stays optional. Pass --no-telemetry or set ENABLE_TELEMETRY=0, OPEN_SWARM_TELEMETRY=0, or AGENTSWARM_TELEMETRY=0.

Complete OpenSwarm pull-request record

- Fix the macOS launcher and release path by @nicko-ai in [#1](https://github.com/VRSEN/OpenSwarm/pull/1) - Fix the macOS custom TUI build by @nicko-ai in [#2](https://github.com/VRSEN/OpenSwarm/pull/2) - Update the API-key reference by @LuiHedlund02 in [#9](https://github.com/VRSEN/OpenSwarm/pull/9) - Add the GitHub release workflow by @nicko-ai in [#16](https://github.com/VRSEN/OpenSwarm/pull/16) - Fix the orchestrator instruction typo by @DevSidd2006 in [#18](https://github.com/VRSEN/OpenSwarm/pull/18) - Update the OpenSwarm README by @nicko-ai in [#21](https://github.com/VRSEN/OpenSwarm/pull/21) - Regenerate the package lock by @nicko-ai in [#22](https://github.com/VRSEN/OpenSwarm/pull/22) - Correct the shared-instruction typo by @DevSidd2006 in [#30](https://github.com/VRSEN/OpenSwarm/pull/30) - Fix the Intel macOS release runner by @nicko-ai in [#34](https://github.com/VRSEN/OpenSwarm/pull/34) - Build the terminal with the OpenSwarm product profile by @nicko-ai in [#36](https://github.com/VRSEN/OpenSwarm/pull/36) - Prepare the rc.3 package by @nicko-ai in [#39](https://github.com/VRSEN/OpenSwarm/pull/39) - Add a live Run-mode smoke test by @nicko-ai in [#40](https://github.com/VRSEN/OpenSwarm/pull/40) - Use structured outputs for internal agents by @ArtemShatokhin in [#41](https://github.com/VRSEN/OpenSwarm/pull/41) - Restore OpenSwarm release parity by @nicko-ai in [#45](https://github.com/VRSEN/OpenSwarm/pull/45) - Install Slides dependencies during setup by @nicko-ai in [#46](https://github.com/VRSEN/OpenSwarm/pull/46) - Move product configuration into the launcher by @nicko-ai in [#50](https://github.com/VRSEN/OpenSwarm/pull/50) - Pass telemetry configuration to official builds by @nicko-ai in [#51](https://github.com/VRSEN/OpenSwarm/pull/51) - Use product configuration for npm packages by @nicko-ai in [#53](https://github.com/VRSEN/OpenSwarm/pull/53) - Fix wheel product-root bootstrap paths by @nicko-ai in [#54](https://github.com/VRSEN/OpenSwarm/pull/54) - Support `agency.py` as an OpenSwarm entry file by @nicko-ai in [#55](https://github.com/VRSEN/OpenSwarm/pull/55) - Prepare the rc.8 package by @nicko-ai in [#57](https://github.com/VRSEN/OpenSwarm/pull/57) - Publish platform tarballs as local files by @nicko-ai in [#58](https://github.com/VRSEN/OpenSwarm/pull/58) - Remove redundant Agency Swarm patches by @nicko-ai in [#59](https://github.com/VRSEN/OpenSwarm/pull/59) - Prepare the rc.9 package by @nicko-ai in [#60](https://github.com/VRSEN/OpenSwarm/pull/60) - Point add-on key guidance to `/addons` by @nicko-ai in [#61](https://github.com/VRSEN/OpenSwarm/pull/61) - Default Codex agents to `gpt-5.4` and remove stale onboarding by @nicko-ai in [#62](https://github.com/VRSEN/OpenSwarm/pull/62) - Add live Slides previews by @ArtemShatokhin in [#66](https://github.com/VRSEN/OpenSwarm/pull/66) - Fix OpenRouter reasoning and Slides routing by @ArtemShatokhin in [#70](https://github.com/VRSEN/OpenSwarm/pull/70) - Reuse the AgentSwarm telemetry binary by @nicko-ai in [#71](https://github.com/VRSEN/OpenSwarm/pull/71) - Add marketplace and fork attribution metadata by @nicko-ai in [#72](https://github.com/VRSEN/OpenSwarm/pull/72) - Prepare rc.10 with AgentSwarm 1.4.40 by @nicko-ai in [#73](https://github.com/VRSEN/OpenSwarm/pull/73) - Fix stale unread-email tool references by @nicko-ai in [#75](https://github.com/VRSEN/OpenSwarm/pull/75) - Release OpenSwarm 1.1.0 by @nicko-ai in [#76](https://github.com/VRSEN/OpenSwarm/pull/76)

Additional changes shipped without pull requests

- Early launcher and package work fixed release triggers, Windows binary lookup, package contents, and Windows postinstall paths: [1340437](https://github.com/VRSEN/OpenSwarm/commit/134043701c934b68efca7e760e39437ab489baad), [349ca2b](https://github.com/VRSEN/OpenSwarm/commit/349ca2bac1527cf82f43dce3d515afc756fcfa1c), [6ebed17](https://github.com/VRSEN/OpenSwarm/commit/6ebed179b418c0fe782278a1dc033945429f41f5), [13fc667](https://github.com/VRSEN/OpenSwarm/commit/13fc66746a090127defdf627eebd80cc77984f1c), and [94feb1b](https://github.com/VRSEN/OpenSwarm/commit/94feb1bd478501c4e80ab71987694c5f41321e58). - Agent instructions, Playwright setup, uv output, circular imports, and output-path guidance changed in [31cd991](https://github.com/VRSEN/OpenSwarm/commit/31cd991782173bf52a3d2518276a40aefe96ef81), [1a59d51](https://github.com/VRSEN/OpenSwarm/commit/1a59d51e45d982b5281a4b70358e7a7e9ecce421), [d31ae38](https://github.com/VRSEN/OpenSwarm/commit/d31ae38322e451ca29844921767720e42a1ddbde), and [1d94509](https://github.com/VRSEN/OpenSwarm/commit/1d94509f335c2ef0487fd3a8b72b06a2e5542d17). - Windows startup, Agency Swarm metadata, tool heartbeats, media-provider availability, and runtime add-on key refresh changed in [eff59f1](https://github.com/VRSEN/OpenSwarm/commit/eff59f1bd9b8d287679ba9c5f0d8ebfffd73e262), [cc6efab](https://github.com/VRSEN/OpenSwarm/commit/cc6efab220012925ec3102c9318a9e30171eb725), [173ad34](https://github.com/VRSEN/OpenSwarm/commit/173ad3473360a1da91fdae7f7cfc0f73c8bdc232), [95fad1d](https://github.com/VRSEN/OpenSwarm/commit/95fad1d21c815a407b8011960d0a80a1fde33314), and [04a92b9](https://github.com/VRSEN/OpenSwarm/commit/04a92b917315502d155026709554a6ea5246115d). - Direct release, version, and platform preparation shipped in [4db9f23](https://github.com/VRSEN/OpenSwarm/commit/4db9f23ebe4b0cc1a6574a7ac93cd13832702ce7), [77af598](https://github.com/VRSEN/OpenSwarm/commit/77af5985b21ae73e6081cf81f08808fcd155c8c4), [8240d8e](https://github.com/VRSEN/OpenSwarm/commit/8240d8e48fe97c7c5aee9b83076091c701ab1743), [17e4117](https://github.com/VRSEN/OpenSwarm/commit/17e41177e8874763e623440afb1dba5710dbda01), [b90b9bb](https://github.com/VRSEN/OpenSwarm/commit/b90b9bbb), [574e4da](https://github.com/VRSEN/OpenSwarm/commit/574e4da8), [ad04ab3](https://github.com/VRSEN/OpenSwarm/commit/ad04ab32), [529d05b](https://github.com/VRSEN/OpenSwarm/commit/529d05b4), [692e95a](https://github.com/VRSEN/OpenSwarm/commit/692e95a0), [694adf0](https://github.com/VRSEN/OpenSwarm/commit/694adf00), and [e555f49](https://github.com/VRSEN/OpenSwarm/commit/e555f497). - The issue template and README were updated in [0a1e1ca](https://github.com/VRSEN/OpenSwarm/commit/0a1e1ca1), [5da250e](https://github.com/VRSEN/OpenSwarm/commit/5da250e4), and [1075f33](https://github.com/VRSEN/OpenSwarm/commit/1075f337). - Live add-on key reload shipped in [54e77f1](https://github.com/VRSEN/OpenSwarm/commit/54e77f1172256139d53e7e72b7bfa482221acdaf). - The document-image containment fix shipped in [1d0fd9a](https://github.com/VRSEN/OpenSwarm/commit/1d0fd9a2b).

Contributors

• Nick Bobrowski (@nicko-ai)
• Artemii (@ArtemShatokhin)
• @LuiHedlund02
• Sid (@DevSidd2006)
• Syed Osama Ali Shah (@Osamaali313)
• Arseny Shatokhin (@VRSEN)

Provider requirements

• GPT Image and Sora operations require direct OpenAI API-key authentication; they are not available through Codex/browser authentication.
• Google, fal.ai, Composio, search, and stock-media features require their matching add-on keys.

Full changelog