Python Codex SDK

Unofficial Python SDK for OpenAI Codex CLI. This is a port of the official TypeScript SDK.

Based on commit 3f1c4b9 (Nov 15, 2025) from the official repository.

Overview

Embed the Codex agent in your workflows and apps.

The Python SDK wraps the bundled codex binary. It spawns the CLI and exchanges JSONL events over stdin/stdout.

Installation

pip install python-codex-sdk

Requires Python 3.12+ and the Codex CLI.

Examples

See the examples/ directory for usage samples.

Testing

uv run pytest

Currently tested with codex-cli 0.58.0.

License

Apache-2.0