openai/openai-agents-python

What is it?

Key features

• 01Agents configured with instructions, tools, guardrails and handoffs
• 02Works with OpenAI Responses and Chat Completions APIs and 100+ other LLMs
• 03Sandbox agents that inspect files, run commands and apply patches in a workspace
• 04Realtime and voice agents for WebSocket-based voice pipelines
• 05Automatic session history management and built-in tracing

Use cases

• Building a multi-agent system where specialist agents handle delegated subtasks
• Creating a voice assistant that combines speech recognition, an agent and speech synthesis
• Running a coding or research agent that needs to read files and execute commands in a sandbox
• Debugging and monitoring agent runs in production with built-in tracing

Quick start

1. 1

   Create a virtual environment

   python -m venv .venv
2. 2

   Activate the virtual environment

   source .venv/bin/activate
3. 3

   Install the openai-agents package

   pip install openai-agents
4. 4

   Set the OPENAI_API_KEY environment variable, then run a text agent

Things to know

• !Requires Python 3.10 or newer.
• !Needs an OpenAI API key (OPENAI_API_KEY) to run the examples.

Topics

FAQ

What is openai-agents-python?

A lightweight Python framework for building multi-agent workflows with tools, handoffs, guardrails, sessions and tracing, provider-agnostic across OpenAI and 100+ LLMs. The OpenAI Agents SDK is a Python framework for building agents: LLMs configured with instructions, tools, guardrails and handoffs that delegate work to other agents. It supports the OpenAI Responses and Chat Completions APIs as well as 100+ other LLMs, so it is not tied to a single provider.

Is openai-agents-python free to use? What license does it have?

openai-agents-python is open source under the MIT license. Check the license terms before using it in commercial products.

Is openai-agents-python still maintained?

Actively maintained. The last commit to openai-agents-python was on Oct 20, 2026.

What can I use openai-agents-python for?

Building a multi-agent system where specialist agents handle delegated subtasks Creating a voice assistant that combines speech recognition, an agent and speech synthesis Running a coding or research agent that needs to read files and execute commands in a sandbox Debugging and monitoring agent runs in production with built-in tracing

How do I install openai-agents-python?

Create a virtual environment: python -m venv .venv Activate the virtual environment: source .venv/bin/activate Install the openai-agents package: pip install openai-agents Set the OPENAI_API_KEY environment variable, then run a text agent

Where can I get openai-agents-python?

The source code and installation instructions are on GitHub: https://github.com/openai/openai-agents-python