Workflow Automation · Preview

openai-agents-python

A lightweight, powerful framework for multi-agent workflows

Best fitUsers who want source-backed project understanding before installing it.

Check whether this project matches your task before installing it.

What it can doskill, recipe, host_instruction, eval, preflight

Review the portable capability path.

Before continuingVerify in a sandbox

Do not treat a preview pack as a proven local install.

GitHub snapshot26k stars

4.0k forks · 269 contributors

Official first step Read manual preview Source repository

Preview status · 2026-05-16

What is openai-agents-python?

Related topics: Installation and Setup, Agents, Tools
Best fit: Users who want source-backed project understanding before installing it.
Capability added to an AI workflow: skill, recipe, host_instruction, eval, preflight
Evidence base: https://github.com/openai/openai-agents-python, https://github.com/openai/openai-agents-python, https://github.com/openai/openai-agents-python#readme
Preview pages are noindex until English quality, canonical, and citation gates pass.
openai-agents-python still needs sandbox verification before production use.

Quick decision

Use this section to decide whether the project is worth a deeper read.

Best forUsers who want source-backed project understanding before installing it.

Match the project to your task before installing it.

Capabilityskill, recipe, host_instruction, eval, preflight

A lightweight, powerful framework for multi-agent workflows

Repositoryopenai/openai-agents-python

26k stars · 4.0k forks

What it can do

Translate the upstream project into concrete capabilities the user can judge before installing.

OpenAI Agents SDK Overview

Related topics: Installation and Setup, Agents, Tools

Sources: [src/agents/handoffs/__init__.py]()

Installation and Setup

Related topics: OpenAI Agents SDK Overview, Examples Index

Source: https://github.com/openai/openai-agents-python / Human Manual

Examples Index

Related topics: OpenAI Agents SDK Overview, Agents

Sources: [examples/basic/hello_world.py](examples/basic/hello_world.py)

Agents

Related topics: Tools, Handoffs, Guardrails, Run Loop and Execution

Sources: [src/agents/lifecycle.py:1-50]()

Tools

Community Discussion Evidence

Project-level external discussion stays visible on the detail page, not only inside the manual.

Stars26k stars

Forks4.0k forks

Contributors269 contributors

Licenseunknown

Community Discussion Evidence

12 source-linked items

Review these external discussions before using openai-agents-python with real data or production workflows. They are review inputs, not standalone proof that the project is production-ready.

01
Tracing shutdown cannot interrupt exporter retry backoff
github / github_issue
02
Proposal: per-run BudgetGuard for token / request / cost limits (follow-
github / github_issue
03
OpenAIConversationsSession persists empty reasoning item {"type":"reason
github / github_issue
04
Chat Completions converter can send empty tool output for non-text resul
github / github_issue
05
Clarify whether retry-after delays should respect retry max_delay
github / github_issue
06
AdvancedSQLiteSession.add_items can report success after structure metad
github / github_issue
07
AdvancedSQLiteSession.delete_branch() leaves branch-only messages in the
github / github_issue
08
v0.17.1
github / github_release
09
v0.17.0
github / github_release
10
v0.16.1
github / github_release
11
v0.16.0
github / github_release
12
v0.15.3
github / github_release

How to start

Only source-backed commands are shown here. Verify them in an isolated environment first.

Try the prompt first

Test the workflow without installing the upstream project.

preview

Read the Human Manual

Understand inputs, outputs, limits, and failure modes.

manual

Take context to your AI host

Use the compiled assets in your preferred AI environment.

context

Run sandbox verification

Confirm install commands and rollback before using a primary environment.

verify

pip install openai-agents

Official start command · https://github.com/openai/openai-agents-python#readme · verified: yes

Human Manual

The English page must expose the real manual, not a short placeholder.

8+ sections · Human Manual