openai/swarm

github.com/openai/swarm AI Agent Frameworks Open-source projectOpen source

Educational framework exploring ergonomic, lightweight multi-agent orchestration. Managed by OpenAI Solution team.

github.com/openai/swarm
openai/swarm homepage screenshot

About openai/swarm

Swarm is an open-source Python framework from OpenAI's Solution team, published as an educational project for exploring multi-agent orchestration. It coordinates work through two primitives: agents, which hold instructions and tools, and handoffs, which pass a conversation from one agent to another. The client's run() method returns messages, executes tool calls, switches agents when needed, and updates context variables, all within one call.

Swarm is marked experimental and educational. The repository states that it has been replaced by the OpenAI Agents SDK, which it describes as a production-ready successor, and it recommends migrating to the Agents SDK for production use. Swarm runs almost entirely on the client and stores no state between calls, so conversation history must be supplied each time.

Key features

  • Agents defined with instructions and tools, with handoffs to other agents
  • A client run() loop that executes tool calls and switches agents
  • Context variables that can be updated during an agent run
  • Example projects covering triage, function calling, airline and support bots
  • Example of a personal shopping agent for sales and refunds
  • Installable with pip directly from the GitHub repository
Best for: Developers who want to learn how multi-agent orchestration works, rather than teams building production systems.
Good for
  • Designed to be lightweight, highly controllable and easy to test
  • Includes several annotated example projects of increasing scope
  • Open source and available under the repository's license
Watch out for
  • Marked as experimental and educational, not intended for production
  • The repository recommends migrating to the OpenAI Agents SDK for production use
  • Requires Python 3.10 or later and stores no state between calls

openai/swarm at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Yes · Source code
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

openai/swarm alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in AI Agent Frameworks

Well-known listings from the same topic.

All 75

openai/swarm FAQ

Is Swarm recommended for production use?
No. The repository states that Swarm has been replaced by the OpenAI Agents SDK and recommends migrating to the Agents SDK for all production use cases.
Is Swarm related to the Assistants API?
No. Swarm agents share a similar name for convenience but are unrelated to Assistants in the Assistants API. Swarm is built entirely on the Chat Completions API.
Which Python version does Swarm require?
Python 3.10 or later.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing