# openai-agents

> OpenAI Agents SDK

- **URL**: https://www.freshcrate.ai/projects/openai-agents
- **Author**: pypi
- **Category**: Frameworks
- **Latest version**: `v0.17.4` (2026-05-26)
- **License**: Unknown
- **Source**: https://github.com/openai/openai-agents-python
- **Homepage**: https://pypi.org/project/openai-agents/
- **Language**: Python
- **GitHub**: 24,345 stars, 3,732 forks
- **Registry**: pypi (`openai-agents`)
- **Tags**: `pypi`

## Description

# OpenAI Agents SDK [![PyPI](https://img.shields.io/pypi/v/openai-agents?label=pypi%20package)](https://pypi.org/project/openai-agents/)

The OpenAI Agents SDK is a lightweight yet powerful framework for building multi-agent workflows. It is provider-agnostic, supporting the OpenAI Responses and Chat Completions APIs, as well as 100+ other LLMs.

<img src="https://cdn.openai.com/API/docs/images/orchestration.png" alt="Image of the Agents Tracing UI" style="max-height: 803px;">

> [!NOTE]
> Looking for the JavaScript/TypeScript version? Check out [Agents SDK JS/TS](https://github.com/openai/openai-agents-js).

### Core concepts:

1. [**Agents**](https://openai.github.io/openai-agents-python/agents): LLMs configured with instructions, tools, guardrails, and handoffs
1. [**Sandbox Agents**](https://openai.github.io/openai-agents-python/sandbox_agents): Agents preconfigured to work with a container to perform work over long time horizons.
1. **[Agents as tools](https://openai.github.io/openai-agents-python/tools/#agents-as-tools) / [Handoffs](https://openai.github.io/openai-agents-python/handoffs/)**: Delegating to other agents for specific tasks
1. [**Tools**](https://openai.github.io/openai-agents-python/tools/): Various Tools let agents take actions (functions, MCP, hosted tools)
1. [**Guardrails**](https://openai.github.io/openai-agents-python/guardrails/): Configurable safety checks for input and output validation
1. [**Human in the loop**](https://openai.github.io/openai-agents-python/human_in_the_loop/): Built-in mechanisms for involving humans across agent runs
1. [**Sessions**](https://openai.github.io/openai-agents-python/sessions/): Automatic conversation history management across agent runs
1. [**Tracing**](https://openai.github.io/openai-agents-python/tracing/): Built-in tracking of agent runs, allowing you to view, debug and optimize your workflows
1. [**Realtime Agents**](https://openai.github.io/openai-agents-python/realtime/quickstart/): Build powerful voice agents with `gpt-realtime-1.5` and full agent features

Explore the [examples](https://github.com/openai/openai-agents-python/tree/main/examples) directory to see the SDK in action, and read our [documentation](https://openai.github.io/openai-agents-python/) for more details.

## Get started

To get started, set up your Python environment (Python 3.10 or newer required), and then install OpenAI Agents SDK package.

### venv

```bash
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install openai-agents
```

For voice support, install with the optional `voice` group: `pip install 'openai-agents[voice]'`. For Redis session support, install with the optional `redis` group: `pip install 'openai-agents[redis]'`.

### uv

If you're familiar with [uv](https://docs.astral.sh/uv/), installing the package would be even easier:

```bash
uv init
uv add openai-agents
```

For voice support, install with the optional `voice` group: `uv add 'openai-agents[voice]'`. For Redis session support, install with the optional `redis` group: `uv add 'openai-agents[redis]'`.

## Run your first Sandbox Agent

[Sandbox Agents](https://openai.github.io/openai-agents-python/sandbox_agents) are new in version 0.14.0. A sandbox agent is an agent that uses a computer environment to perform real work with a filesystem, in an environment you configure and control. Sandbox agents are useful when the agent needs to inspect files, run commands, apply patches, or carry workspace state across longer tasks.

```python
from agents import Runner
from agents.run import RunConfig
from agents.sandbox import Manifest, SandboxAgent, SandboxRunConfig
from agents.sandbox.entries import GitRepo
from agents.sandbox.sandboxes import UnixLocalSandboxClient

agent = SandboxAgent(
    name="Workspace Assistant",
    instructions="Inspect the sandbox workspace before answering.",
    default_manifest=Manifest(
        entries={
            "repo": GitRepo(repo="openai/openai-agents-python", ref="main"),
        }
    ),
)

result = Runner.run_sync(
    agent,
    "Inspect the repo README and summarize what this project does.",
    # Run this agent on the local filesystem
    run_config=RunConfig(sandbox=SandboxRunConfig(client=UnixLocalSandboxClient())),
)
print(result.final_output)

# This project provides a Python SDK for building multi-agent workflows.
```

(_If running this, ensure you set the `OPENAI_API_KEY` environment variable_)

(_For Jupyter notebook users, see [hello_world_jupyter.ipynb](https://github.com/openai/openai-agents-python/blob/main/examples/basic/hello_world_jupyter.ipynb)_)

Explore the [examples](https://github.com/openai/openai-agents-python/tree/main/examples) directory to see the SDK in action, and read our [documentation](https://openai.github.io/openai-agents-python/) for more details.

## Acknowledgements

We'd like to acknowledge the excellent work of the open-source community, especially:

- [Pydantic](https://docs.pydantic.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.17.4` | 2026-05-26 | High | ## What's Changed  * feat: support Realtime custom voice objects by @lionel-oai in https://github.com/openai/openai-agents-python/pull/3473 * fix: #3459 add opt-in recovery for missing function tools by @seratch in https://github.com/openai/openai-agents-python/pull/3461 * fix: apply hardened http client default to MCP SSE transport by @ioleksiuk in https://github.com/openai/openai-agents-python/pull/3466 * fix: use non-None value for output in FunctionSpanData by @rmotgi1227 in https://git |
| `v0.17.3` | 2026-05-19 | High | a## What's Changed  * fix: keep mountpoint credentials out of sandbox commands by @seratch in https://github.com/openai/openai-agents-python/pull/3429 * fix: unify memory optional dependency import errors by @seratch in https://github.com/openai/openai-agents-python/pull/3389 * fix: guard None text in text_message_output and add output guardrail count to RunErrorDetails by @zhoufengen in https://github.com/openai/openai-agents-python/pull/3375 * fix: avoid mutating FunctionTool params_json_ |
| `v0.17.2` | 2026-05-12 | High | ## What's Changed  * fix: #3268 fix OpenAI Conversations reasoning persistence by @seratch in https://github.com/openai/openai-agents-python/pull/3352 * fix: avoid auto response for unknown realtime tools (ref: #3287) by @seratch in https://github.com/openai/openai-agents-python/pull/3366 * fix: #3354 interrupt tracing retry backoff on shutdown by @Aphroq in https://github.com/openai/openai-agents-python/pull/3355 * fix: #3359 preserve local approval rejection reasons by @Aphroq in https:// |
| `v0.16.1` | 2026-05-07 | High | ## What's Changed  * fix: #3109 stabilize chat completions stream output indexes by @seratch in https://github.com/openai/openai-agents-python/pull/3176 * fix: #3168 validate MCP require_approval policies by @seratch in https://github.com/openai/openai-agents-python/pull/3179 * fix: #3116 restore session history after compaction replacement failures by @Aphroq in https://github.com/openai/openai-agents-python/pull/3117 * fix: #3171 reject corrupt Dapr session state updates by @Aphroq in htt |
| `v0.15.1` | 2026-05-02 | High | ## What's Changed  * feat: expose Responses WebSocket keepalive options by @seratch in https://github.com/openai/openai-agents-python/pull/3080 * fix: restore UnixLocal PTY terminal signal defaults by @seratch in https://github.com/openai/openai-agents-python/pull/3082 * fix: #3074 restore SIGINT defaults for UnixLocal PTY children by @Aphroq in https://github.com/openai/openai-agents-python/pull/3075  ### Documentation & Other Changes  * docs: add 0.15 changelog by @seratch in https://g |
| `v0.14.8` | 2026-04-29 | High | ## What's Changed  * fix: #3046 preserve MCP re-export import errors by @seratch in https://github.com/openai/openai-agents-python/pull/3048 * fix: #3043 delimit sandbox prompt instruction sections by @seratch in https://github.com/openai/openai-agents-python/pull/3047  ### Documentation & Other Changes  * docs: fix typo in comment for WS event handler by @ateamofantsintheirprime in https://github.com/openai/openai-agents-python/pull/3050 * Release 0.14.8 by @github-actions[bot] in https |
| `v0.14.5` | 2026-04-23 | High | ## What's Changed  * feat: #3001 add Modal sandbox idle timeout option by @seratch in https://github.com/openai/openai-agents-python/pull/3005 * fix: #3004 serve HITL resume tool outputs by @seratch in https://github.com/openai/openai-agents-python/pull/3006 * fix: backfill streamed terminal output by @ankitphogat in https://github.com/openai/openai-agents-python/pull/3000  ### Documentation & Other Changes  * docs: clarify lazy skill source host paths by @alfozan in https://github.com/o |
| `0.14.4` | 2026-04-21 | Low | Imported from PyPI (0.14.4) |
| `v0.14.4` | 2026-04-21 | High | ## What's Changed * docs: remove duplicate word in voice interruptions section by @abhicris in https://github.com/openai/openai-agents-python/pull/2981 * docs: update translated document pages by @github-actions[bot] in https://github.com/openai/openai-agents-python/pull/2982 * test: add sandbox compatibility guards by @seratch in https://github.com/openai/openai-agents-python/pull/2984 * fix: ignore relative snapshot base overrides by @matthewflint in https://github.com/openai/openai-agents |
| `v0.14.3` | 2026-04-20 | High | ## What's Changed  * fix: #2962 normalize sandbox paths and add Windows CI by @seratch in https://github.com/openai/openai-agents-python/pull/2963 * fix: #2938 make sandboxes importable on Windows by @seratch in https://github.com/openai/openai-agents-python/pull/2948 * fix: prepare Daytona workspace root before start by @seratch in https://github.com/openai/openai-agents-python/pull/2956 * fix: windows errors with #2956 by @seratch in https://github.com/openai/openai-agents-python/pull/297 |

## Citation

- HTML: https://www.freshcrate.ai/projects/openai-agents
- Markdown: https://www.freshcrate.ai/projects/openai-agents.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/openai-agents/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._