# openai/swarm

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/openai-swarm).**

20,980 stars · 2,234 forks · Python · mit

## Links

- GitHub: https://github.com/openai/swarm
- awesome-repositories: https://awesome-repositories.com/repository/openai-swarm.md

## Description

Swarm is a framework for building conversational systems that coordinate multi-agent workflows. It functions as an orchestration engine that manages persistent, multi-turn dialogues by routing tasks between specialized agents and executing local functions. The system is designed to handle complex, multi-step processes by maintaining shared state and context across agent interactions.

The framework distinguishes itself through its approach to dynamic task delegation and execution control. It enables agents to hand off tasks to one another by returning agent objects, allowing for modular, domain-specific handling of user requests. The runtime manages these transitions through a synchronous execution loop that resolves structured function calls and maintains persistent variables, ensuring that session context remains consistent as control shifts between agents.

Beyond core orchestration, the system provides capabilities for integrating external tools and data sources to inform agent responses. It supports real-time visibility into multi-agent workflows through incremental stream processing, which emits updates and control signals as tasks are executed. The framework also includes tools for monitoring and validating agent decision-making performance through automated testing of conversation inputs.

## Tags

### Artificial Intelligence & ML

- [Agent Delegation](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-delegation.md) — Enables modular task delegation by allowing agents to transfer execution to specialized agents. ([source](https://github.com/openai/swarm/blob/main/README.md))
- [Multi-Agent Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-agent-orchestrators.md) — Coordinates teams of specialized agents that collaborate and hand off tasks to one another to complete complex workflows.
- [Agentic Loops](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/ai-agents/execution-runtimes/agentic-loops.md) — Processes agent responses and function outputs sequentially in a central control loop.
- [Conversational Workflow Engines](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/agentic-workflow-orchestration/conversational-workflow-engines.md) — Manages persistent, multi-turn dialogues by dynamically delegating tasks between agents and maintaining session context.
- [Multi-Agent Routing Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/autonomous-agents/agent-orchestration-frameworks/multi-agent-routing-systems.md) — Directs user requests to specialized agents based on intent using a central triage agent. ([source](https://github.com/openai/swarm/blob/main/examples/triage_agent))
- [Conversational State Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-state-managers.md) — Maintains persistent user context and shared variables across multi-turn dialogues.
- [Multi-Agent Orchestration Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-agent-orchestration-frameworks.md) — Coordinates handoffs and shared state between specialized agents to execute complex, multi-step LLM workflows.
- [Multi-Agent Coordination Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/multi-agent-coordination-systems.md) — Provides a toolkit for building conversational systems that route tasks between specialized agents and execute local functions.
- [Agent Orchestration Loops](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-orchestration-loops.md) — Sustains continuous communication cycles between users and agents to facilitate ongoing dialogue. ([source](https://github.com/openai/swarm/blob/main/examples/basic))
- [AI Agent Capabilities](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-capabilities-skills-tooling/ai-agent-capabilities.md) — Provides functional extensions that allow agents to execute custom code and retrieve data during conversations. ([source](https://github.com/openai/swarm/blob/main/examples/basic))
- [External Tool Integration](https://awesome-repositories.com/f/artificial-intelligence-ml/external-tool-integration.md) — Supports the invocation of custom external tools to retrieve real-time data or perform actions. ([source](https://github.com/openai/swarm/blob/main/examples/weather_agent))
- [Function Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/function-orchestrators.md) — Resolves structured function calls returned by agents to execute local code within the conversation loop.
- [LLM Tool Calling](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-tool-calling.md) — Maps natural language intents to executable local functions and external tools within multi-agent workflows.
- [Context Persistence](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-reasoning-engines/context-persistence.md) — Maintains persistent variables and conversation state across multi-turn interactions. ([source](https://github.com/openai/swarm/blob/main/examples/basic))
- [Session Management Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-runtimes/session-management-systems.md) — Executes persistent loops that allow users to engage with multi-agent systems through a conversational interface. ([source](https://github.com/openai/swarm/blob/main/examples/personal_shopper))
- [Agent Streaming Interfaces](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-runtimes/agent-streaming-interfaces.md) — Streams incremental updates and control signals to provide visibility into agent switches and task execution. ([source](https://github.com/openai/swarm#readme))
- [Agent Response Streamers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-runtimes/streaming-response-processors/agent-response-streamers.md) — Streams agent responses and function execution events incrementally to provide real-time visibility into task progress. ([source](https://github.com/openai/swarm/blob/main/README.md))
- [Technical Documentation Retrieval](https://awesome-repositories.com/f/artificial-intelligence-ml/technical-documentation-retrieval.md) — Queries vector databases to fetch relevant information for support responses during agent interactions. ([source](https://github.com/openai/swarm/blob/main/examples/support_bot))
- [Agent Evaluation Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-evaluation-frameworks.md) — Validates agent decision-making by running automated test cases against conversation inputs to verify function calls and task execution. ([source](https://github.com/openai/swarm/blob/main/examples/airline))

### Data & Databases

- [Agent State Persistence](https://awesome-repositories.com/f/data-databases/agent-state-persistence.md) — Maintains a persistent dictionary of variables passed between agents to preserve session state.
- [State and Context Management](https://awesome-repositories.com/f/data-databases/data-management/state-context-management.md) — Passes and updates shared state across agent interactions to ensure consistent data availability. ([source](https://github.com/openai/swarm/blob/main/README.md))
- [External Data Connectors](https://awesome-repositories.com/f/data-databases/external-data-connectors.md) — Connects agent logic to persistent databases to retrieve and update records during task execution. ([source](https://github.com/openai/swarm/blob/main/examples/personal_shopper))

### DevOps & Infrastructure

- [Schema-Driven Specifications](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/declarative-configuration-frameworks/schema-driven-specifications.md) — Maps external capabilities to executable functions using schema-driven definitions.

### Development Tools & Productivity

- [Agent-Integrated Functions](https://awesome-repositories.com/f/development-tools-productivity/local-function-execution/agent-integrated-functions.md) — Enables agents to invoke local code directly to perform data transformations or external actions. ([source](https://github.com/openai/swarm#readme))

### Operating Systems & Systems Programming

- [Incremental Streaming](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/system-administration-utilities/system-utilities/process-and-task-orchestration/incremental-streaming.md) — Emits real-time updates and control signals during agent task execution for workflow visibility.