Install
pip install "openai>=2.0" openai-agentsOpenAI Agents SDK (Python)
The official production-ready replacement for Swarm. Lightweight primitives (Agent, Handoff, Guardrail, Session, Tool) with built-in tracing, MCP support, and provider-agnostic LLM access (OpenAI + 100+ via LiteLLM).
Version
v0.15.1 · May 2026 · Python 3.10+
Best for
Multi-agent handoffs, customer-service bots, tracing-first apps.
Zero → Hero
Section titled “Zero → Hero” 1 · Install & setup Environment, API key, first agent · 10 min
2 · Design philosophy Why minimal primitives, where the seams are · 10 min
3 · Core primitives Agent, Handoff, Guardrail, Session, Tool, Runner · 20 min
4 · Your first agent Linear chat, context, async patterns · 20 min
5 · Multi-agent systems Handoffs, specialist routing · 25 min
6 · Tools integration Function tools, MCP, built-in tools · 20 min
7 · Structured outputs Pydantic validation, type-safe responses · 15 min
8 · Guardrails & safety Input/output validation, custom checks · 15 min
9 · Middleware Lifecycle hooks, custom processing · 20 min
10 · Tracing & observability Platform traces, Langfuse/AgentOps · 15 min
11 · Production Deployment, scaling, resilience · 30 min
Jump to a topic
Section titled “Jump to a topic”Reference
Section titled “Reference” Comprehensive guide Single-page technical reference.
2025 features Sandbox agents, WebSocket transport, tracing, LiteLLM, MCP.
Swarm migration guide Side-by-side code comparisons + migration checklist.
Recipes Customer service, research, code review, translation, moderation.
What’s new in v0.15.1 (May 2026)
Section titled “What’s new in v0.15.1 (May 2026)”- v0.15.1 (May 2) — Patch release; stability and dependency updates.
- v0.15.0 (May 1) — Minor release; stability and dependency updates.
- v0.14.8 (April 29) — Patch release; stability improvements.
- v0.14.7 (April 28) — Patch release; stability improvements.
- Sandbox agents — persistent isolated workspaces with files, directories, Git repos, snapshots. Backends: local Unix, Docker, Blaxel, E2B, Modal, Runloop, Vercel.
- WebSocket transport for OpenAI Responses models — low-latency multi-turn conversations via
responses_websocket_session(). - Sync function tools now run on worker threads via
asyncio.to_thread().
Install, minimal example
Section titled “Install, minimal example”from agents import Agent, Runner
agent = Agent( name="Assistant", instructions="You are a helpful assistant.",)
result = Runner.run_sync(agent, "What is 2 + 2?")print(result.final_output)Ready? Start Zero → Hero Step 1 →
Revision history
Section titled “Revision history”| Date | Version | Changes | Reviewer |
|---|---|---|---|
| 2026-05-02 | 0.15.1 | Version bumped 0.15.0 → 0.15.1; “What’s new” heading updated; comprehensive guide header updated; revision history entry added. Agent, Runner, Handoff, guardrail imports verified against installed 0.15.1 (.routine-envs/check-openai-0502). | Claude routine |
| 2026-05-01 | 0.15.0 | Version bumped 0.14.8 → 0.15.0; “What’s new” heading updated; comprehensive guide header updated; revision history entry added. Agent, Runner, Handoff, guardrail imports verified against installed 0.15.0 (.routine-envs/check-openai-0501). | Claude routine |
| 2026-04-29 | 0.14.8 | Version bumped 0.14.7 → 0.14.8; “What’s new” heading updated; comprehensive guide header updated; revision history entry added. Snippets verified against installed 0.14.8 (.routine-envs/main-py-0429). | Claude routine |
| 2026-04-28 | 0.14.7 | Version bumped 0.14.6 → 0.14.7; “What’s new” heading updated; comprehensive guide header updated; revision history entry added. Snippets verified against installed 0.14.7. | Claude routine |
| 2026-04-25 | 0.14.6 | Version bumped 0.14.5 → 0.14.6; “What’s new” heading updated; comprehensive guide header updated; revision history entry added. Snippets verified against installed 0.14.6. | Claude routine |
| 2026-04-24 | 0.14.5 | Version bumped 0.14.4 → 0.14.5; “What’s new” heading updated; comprehensive guide header updated; revision history entry added. | — |
| 2026-04-21 | 0.14.3 | Index redesigned with Zero → Hero + Jump-to-topic grid. | — |
| 2026-04-20 | 0.14.3 | Patch release; no breaking changes from 0.14.2. | — |
| April 16, 2026 | 0.14.0 | Sandbox agents; WebSocket transport; openai v2 requirement; Python 3.9 dropped. | — |
| November 2025 | 0.6.1 | Initial 2025 features; Swarm migration; MCP; guardrails; sessions. | — |
Note: TypeScript implementation lives at OpenAI Agents SDK (TypeScript).