“Simplifies task decomposition and tool orchestration—define tools once and reuse across multiple browsing flows. Strong state management, invocation constraints, and observability, so we focus on user experience instead of glue code.”
AI SDK & Agent FrameworkMaker says so · source ↗
OpenAI Agents SDK
Python framework from OpenAI for building agents with instructions, tools, handoffs, guardrails, and built-in tracing.
53 open-source projects declare OpenAI Agents SDK in their code; 1 maker's product we track uses it. What makers like most: Minimal and simpler than most agent frameworks, a sensible default when starting out. Their most common complaint: Hosting, observability and reliable scaling are left to you, which is the bigger effort.
Profile checked
How makers use OpenAI Agents SDK
Makers' products we track use OpenAI Agents SDK for AI SDK & agent framework (1).
What OpenAI Agents SDK is used for
OpenAI Agents SDK vs the alternatives makers chose
For AI SDK & agent framework, 1 of the 115 makers' products we know the choice of picked OpenAI Agents SDK (1%), behind LangChain (57%).
| Option | Makers' products | Open source | |
|---|---|---|---|
| 66 57% | Yes | ||
| 24 21% | Yes | ||
| 16 14% | Yes | ||
| 5 4% | Yes | ||
| 3 3% | Yes | ||
| 1 1% | Yes | ||
| 1 1% | Yes |
For AI SDK & agent framework: how many of the 115 makers' products we know the AI SDK & agent framework of chose each option.
When to use OpenAI Agents SDK, and when not
Pick OpenAI Agents SDK if
- You want a small typed agent loop in Python, close to the raw API. AI SDK & Agent Framework →
Something else fits better if
- Your app is TypeScript and you want agents without adding a Python service: AI SDK or Mastra.
- Your agent works on files and runs commands, like a coding or research agent: Claude Agent SDK.
- You need many prebuilt connectors for models, tools and data sources: LangChain.
- Your agent is a long-running workflow with branches, saved state and human approval steps: LangGraph.
- The agent mostly retrieves and reasons over your own documents: LlamaIndex.
The OpenAI Agents SDK is OpenAI's open-source library for building agents in Python, with a TypeScript version alongside it. It is the production successor to Swarm, OpenAI's earlier agents experiment with a deliberately small set of building blocks.
More about OpenAI Agents SDK
An Agent is instructions, a model and tools; any Python function becomes a tool with its schema generated automatically and inputs validated by Pydantic. A Runner executes the loop: call the model, run the tool calls it asks for, repeat until there is a final output. Agents can hand the conversation off to another agent or be called as tools by a manager agent, and guardrails check inputs and outputs in parallel and stop the run early when a check fails. OpenAI models are called through the Responses API by default.
Tracing is on by default and shows each run, model call, tool call and handoff in OpenAI's Traces dashboard. Sessions keep conversation history between runs, runs can pause for human approval and resume, agents can call MCP server tools, and sandbox agents work inside isolated local or Docker workspaces. It is a library, so it runs in your own process on any host.
It is built around OpenAI's API. Other providers work through an OpenAI-compatible endpoint, a custom model provider, or the LiteLLM and Any-LLM adapters, which are beta and best-effort, and some features only work on the Responses API. Tracing needs an OpenAI key and is unavailable to organizations under Zero Data Retention.
How OpenAI Agents SDK itself is built
11 tools, from its own code, website and Product Hunt page.
OpenAI Agents SDK pros and cons
What makers like most: Minimal and simpler than most agent frameworks, a sensible default when starting out. Their most common complaint: Hosting, observability and reliable scaling are left to you, which is the bigger effort.
Pros
- Minimal and simpler than most agent frameworks, a sensible default when starting out. HNHN 2
- Its abstractions for handoffs, subagents, tools, guardrails and structured output hold up in real use. HNPHHN 2
- MIT-licensed and self-hosted, so you control integrations and what gets exposed to the model provider. HNHN 2
Cons and watch-outs
- Hosting, observability and reliable scaling are left to you, which is the bigger effort. HN
Themes that recur in makers' words and Hacker News comments, each linked to what it summarises.
Who uses it
1 makers' products, each linked to the source that shows it, and 53 open-source projects that declare it in their code. The best known on Product Hunt: DeepvBrowser (96 followers).
None of these in makers' own words.
Open source: a project that declares OpenAI Agents SDK as a dependency in its public code — verifiable, but not necessarily a live product.
What its projects tell coding agents
29 of the 40 open-source products built with OpenAI Agents SDK that were worked on in the last 180 days keep instruction files for coding agents — 73%, against 53% of all the projects we read. AGENTS.md is in 21, CLAUDE.md in 16.
Alternatives to OpenAI Agents SDK
All alternatives by situation →Further reading
Questions makers ask about OpenAI Agents SDK
What is OpenAI Agents SDK used for?
Python framework from OpenAI for building agents with instructions, tools, handoffs, guardrails, and built-in tracing. Makers' products we track use it for AI SDK & agent framework (1).
What are the pros and cons of OpenAI Agents SDK?
Pros makers name: Minimal and simpler than most agent frameworks, a sensible default when starting out. Its abstractions for handoffs, subagents, tools, guardrails and structured output hold up in real use. MIT-licensed and self-hosted, so you control integrations and what gets exposed to the model provider. Cons: Hosting, observability and reliable scaling are left to you, which is the bigger effort.
What are the alternatives to OpenAI Agents SDK?
For AI SDK & agent framework, the other options makers' products we track chose most are LangChain (66), Mastra (24), LlamaIndex (16), AI SDK (5), CrewAI (3), LangGraph (1). Open source or self-hostable among them: LangChain, Mastra, LlamaIndex, AI SDK, CrewAI, LangGraph. Each alternative, with the situation it fits, is on the OpenAI Agents SDK alternatives page.
When should you use OpenAI Agents SDK?
You want a small typed agent loop in Python, close to the raw API (AI SDK & agent framework). Something else fits better if: your app is TypeScript and you want agents without adding a Python service, pick AI SDK or Mastra; your agent works on files and runs commands, like a coding or research agent, pick Claude Agent SDK.
Is there a TypeScript version?
Yes. The Agents SDK for TypeScript has the same primitives (agents, handoffs, guardrails, function tools and tracing) and its own documentation. source ↗
Can I use non-OpenAI models?
Yes. Point the SDK at any OpenAI-compatible endpoint, set a custom model provider for a run, or set a model per agent; LiteLLM and Any-LLM adapters are available as beta. Without an OpenAI key, the docs recommend disabling tracing or sending traces elsewhere. source ↗
Where do traces go, and can I turn them off?
By default to OpenAI's Traces dashboard. Disable them globally with OPENAI_AGENTS_DISABLE_TRACING=1 or per run, or add custom processors to send them to another destination. Tracing is not available under a Zero Data Retention policy. source ↗
How does the agent remember earlier turns?
Pass a session to the runner and it loads and saves history automatically; SQLite is built in, with Redis, SQLAlchemy, MongoDB and encrypted options. Alternatively use OpenAI's server-side conversation state, but not both in the same run. source ↗
When should I use the Responses API directly instead?
When you want to own the loop, tool dispatch and state yourself, or the job is a short call that just returns the model's answer. The SDK is for when you want it to manage turns, tools, guardrails, handoffs and sessions, and many apps use both. source ↗
Is OpenAI Agents SDK free?
Yes — it is free, open-source software.
Is OpenAI Agents SDK open source or self-hostable?
Open source, and you can self-host it. source ↗
Can AI coding agents work with OpenAI Agents SDK?
No llms.txt, official MCP server or CLI found yet.
Who uses OpenAI Agents SDK?
1 makers' products we track, each with a source, and 53 open-source projects declare it in their code. The best known of them on Product Hunt: DeepvBrowser (96 followers). source ↗