OpenAI Agents SDK

OpenAI

Open Source

Production successor to Swarm for agentic OpenAI workflows with broader model support.

Curated by Tiberiu ArvaStale

MITVersion 0.23.1Released 2026-10-0229,401

Strengths

  • Hosted tracing support
  • Production successor to Swarm
  • Handoffs and tool orchestration

Practitioner note

Fast path for OpenAI-centric agent builds, though portability and provider concentration should be weighed before making it a platform default.

Warning

OpenAI Agents SDK: OpenAI Swarm was replaced by the Agents SDK.

Where it sits in the stack

Listed under Agent frameworks in the Build & orchestrate layer.

  1. Build & orchestrate
  2. Control plane
  3. Use

Governance posture

Reviewed 2026-05-26
PartialData residency

Library is self-hosted, but built-in tracing sends run data to OpenAI's platform unless disabled.

Source
YesDeployment model

pip-installed SDK (self-hosted); API calls go to OpenAI's hosted endpoints. (self-hosted)

Source
PartialAudit logging

Hosted tracing logs runs to OpenAI's platform; self-hosted logging is operator-implemented.

Source
N/ASOC 2

Self-hosted library; SOC 2 applies to the operator's infrastructure, not the package.

N/AISO 27001

Self-hosted library; ISO 27001 applies to the operator's ISMS, not the package.

N/AISO 42001

Self-hosted library; ISO 42001 applies to the deploying organisation.

N/AEU AI Act

Developer component, not an AI system placed on the market; obligations rest with the deployer. (role: not-applicable)

YesLicense risk

MIT — permissive, OSI-approved. (low)

Source

EU AI Act obligations

Risk tier: Not applicable · as of 2026-10-10

Source-backed information mapped from OpenAI Agents SDK's tracked risk tier — not legal advice. Obligations depend on how your organisation deploys the system; see the full obligation reference and timeline.

This record's EU AI Act risk tier is marked not applicable, so no tier-specific obligations attach. Deployers embedding it in an AI system in scope of the Act should assess that system's own tier.

Change history

Source-backed and auto-detected events for this tool, newest first.

  1. Release

    OpenAI Agents SDK 0.23.x adds configurable MCP listing page limits and opt-in Docker removal protection for sandboxes.

    Release v0.23.1 · openai/openai-agents-python
  2. ReleaseHigh impact

    OpenAI Agents SDK 0.22.2 added current image-generation tool options and hardened UnixLocal sandbox file handling against symlink races, following the broader MCP guardrail and isolation work in 0.22.1.

    Release v0.22.2 · openai/openai-agents-python
  3. ReleaseHigh impact

    OpenAI Agents SDK 0.22.0 hardened runtime state and guardrail handling, including redaction of rejected terminal tool output, and tightened explicit OpenAI client configuration rules.

    Release v0.22.0 · openai/openai-agents-python
  4. ReleaseHigh impact

    OpenAI Agents SDK 0.21.0 added provider-neutral deterministic testing utilities, OpenAI Python 3 compatibility, and hardened interruption snapshots, approvals, MCP lifecycle isolation, and sensitive-error redaction.

    Release v0.21.0 · openai/openai-agents-python
  5. Release

    OpenAI Agents SDK 0.18.3 added configurable task/turn tracing spans and realtime response usage tracking in session context.

    Release v0.18.3 · openai/openai-agents-python
  6. Release

    OpenAI Agents SDK 0.18.2 added GPT-5.6 request controls and hosted multi-agent beta support, plus sandbox and usage fixes.

    Release v0.18.2 · openai/openai-agents-python
  7. Release

    OpenAI Agents SDK 0.18.1 added GPT-5.6 model defaults and migrated examples, with cache-write usage fixes.

    Release v0.18.1 · openai/openai-agents-python
  8. Release

    OpenAI Agents SDK 0.18.0 changed the default RealtimeAgent model to gpt-realtime-2.1.

    Release v0.18.0 · openai/openai-agents-python
  9. Release

    OpenAI Agents SDK 0.17.8 added invalid final-output recovery handling and fixed realtime session cancellation propagation.

    Release v0.17.8 · openai/openai-agents-python
  10. ReleaseHigh impact

    OpenAI Agents SDK 0.17.7 exposed configurable WebSocket size limits, added buffered Chat Completions tool-call streaming, made AdvancedSQLiteSession add_items atomic, and tightened sandbox, guardrail, and Realtime multi-agent edge cases.

    Release v0.17.7 · openai/openai-agents-python
  11. ReleaseHigh impact

    OpenAI Agents SDK 0.17.6 added pre-approval tool-input guardrails and SDK-only custom tool-output metadata, tightening human approval control points around agent tool execution.

    Release v0.17.6 · openai/openai-agents-python
  12. ReleaseHigh impact

    OpenAI Agents SDK 0.16.0 changed the default model to gpt-5.4-mini for runs without an explicit model, altering baseline behavior, reasoning defaults, and potential cost/perf expectations.

    Release v0.16.0 · openai/openai-agents-python · GitHub
  13. ReleaseHigh impact

    OpenAI Agents SDK 0.15.0 changed refusal handling to raise ModelRefusalError explicitly instead of surfacing empty outputs, a behavior change that can affect run-loop integrations.

    Release v0.15.0 · openai/openai-agents-python · GitHub
  14. Release
    OpenAI Agents SDK release hardens tracing and SQL session handling

    The OpenAI Agents SDK April 9 release hardened SQLite and SQLAlchemy session handling and expanded tracing documentation, signaling continued stabilization of the production agent stack.

    Releases · openai/openai-agents-python
  15. Auto-detected
    lastRelease: 2026-09-09 → 2026-10-02

    From snapshot diff 2026-09-13 → 2026-10-10.

  16. Auto-detected
    version: 0.22.2 → 0.23.1

    From snapshot diff 2026-09-13 → 2026-10-10.

  17. Auto-detected
    githubStars: 28877 → 29401

    From snapshot diff 2026-08-22 → 2026-09-13.

  18. Auto-detected
    lastRelease: 2026-08-19 → 2026-09-09

    From snapshot diff 2026-08-22 → 2026-09-13.

  19. Auto-detected
    version: 0.22.0 → 0.22.2

    From snapshot diff 2026-08-22 → 2026-09-13.

  20. Auto-detected
    githubStars: 28376 → 28877

    From snapshot diff 2026-08-04 → 2026-08-22.

  21. Auto-detected
    lastRelease: 2026-08-04 → 2026-08-19

    From snapshot diff 2026-08-04 → 2026-08-22.

  22. Auto-detected
    version: 0.19.3 → 0.22.0

    From snapshot diff 2026-08-04 → 2026-08-22.

  23. Auto-detected
    githubStars: 27802 → 28376

    From snapshot diff 2026-07-17 → 2026-08-04.

  24. Auto-detected
    lastRelease: 2026-07-11 → 2026-08-04

    From snapshot diff 2026-07-17 → 2026-08-04.

  25. Auto-detected
    version: 0.18.2 → 0.19.3

    From snapshot diff 2026-07-17 → 2026-08-04.

  26. Auto-detected
    githubStars: 26965 → 27802

    From snapshot diff 2026-06-07 → 2026-07-17.

  27. Auto-detected
    lastRelease: 2026-05-26 → 2026-07-11

    From snapshot diff 2026-06-07 → 2026-07-17.

  28. Auto-detected
    version: 0.17.4 → 0.18.2

    From snapshot diff 2026-06-07 → 2026-07-17.

Explore the category

Compare this tool against the rest of its category and the cloud platform foundation layer.