github openai/openai-agents-python v1.0.0-alpha.1
Agents SDK v1.0.0-alpha.1

pre-releaseone hour ago

Agents SDK v1.0.0-alpha.1

This first preview from feat/simple-codex adds Codex as an opt-in model provider for the Python Agents SDK. The prebuilt openai-agents wheels (version 1.0.0a1) are available exclusively through GitHub Releases.

Highlights

  • Choose Codex per run. Import CodexProvider from agents.models.codex and create provider = CodexProvider(). Pass RunConfig(model_provider=provider) to the Runner. Codex uses your saved login. For API key authentication, use CodexProvider(api_key=...). The provider selects the model for agents that use a model name or the default model. Run the same agent with either provider
  • Reuse Codex Core inside Python. The wheel embeds unmodified Codex Core rust-v0.166.0 through PyO3. Direct calls to Core eliminate codex app-server startup and JSON-RPC. Reuse the provider to share one ThreadManager across calls. Each call gets a fresh thread. Use an SDK session for history and close the provider with await provider.aclose() when you finish. Thread lifetime and history · Codex source
  • Use SDK tools and approvals. Stream text, hand off to a specialist, pause for approval before a Python tool runs, and validate typed output. Native commands follow Codex's sandbox and approval settings. A native approval prompt ends the model call. Execution and approvals · Supported tools and model settings

Install and try it

Activate a virtual environment with standard CPython 3.10–3.14. Copy the link for your platform and replace WHEEL_URL in the command below. Each link includes the SHA-256 digest that pip checks when it downloads the wheel. Checksums for all four wheels

Linux x86-64 (glibc 2.28+) · Linux ARM64 (glibc 2.28+) · macOS 11+ on Apple silicon · Windows x64

python -m pip install --only-binary=:all: "WHEEL_URL"

To try the wildlife example, check out v1.0.0-alpha.1 and run the command below from the repository root with the wheel installed. If your only credential is a saved Codex login, set OPENAI_AGENTS_DISABLE_TRACING=1 in your shell first. Wildlife example · Authentication

python -I examples/model_providers/codex_provider.py --codex

Fixed

  • Automatic session compaction uses local conversation history for Codex, including after an approval pause. Compaction needs its own OpenAI client or credentials. Session compaction
  • Saved sandbox manifests preserve inline binary files when you resume a run. If you share these manifests, upgrade all readers before saving non-UTF-8 content. Use LocalFile when older SDKs need to read the manifest. Manifest compatibility

Moving from the harness preview

If you use Agent.run() or Session.submit() in v0.24.0-alpha.8, move execution to Runner.run() or Runner.run_streamed() and select CodexProvider in your run config. If you use agents.classic, import Agent, Runner, and RunConfig from agents. Previous harness release · Runner example

Finish pending native runs and approvals in your alpha.8 environment. Its SessionState checkpoints use a different format from the Runner's RunState. Start a fresh SDK session for conversation history in alpha.1. SDK sessions

Release verification

The SDK suite passed on the merged feat/simple-codex commit. CI built all four wheels and tested fresh installs on CPython 3.10 and 3.14 on each platform. We verified all four downloads against SHA256SUMS. Source 87e8f533 · SDK tests · Wheel builds and installation checks

We also ran the wildlife example with a live model and the Linux x86-64 wheel on CPython 3.12. The specialist identified an American bison from the photo, called the Python catalog tool, and returned a typed report with record ID synthetic-bison-001. Example and assertions

Don't miss a new openai-agents-python release

NewReleases is sending notifications on new releases.