Metadata-Version: 2.3
Name: python-codex-sdk
Version: 0.1.2
Summary: Python SDK for OpenAI Codex CLI - A port of the official TypeScript SDK
Keywords: codex,openai,cli,sdk,ai,coding-agent
Author: yor-dev
Author-email: yor-dev <52931599+yor-dev@users.noreply.github.com>
License: Apache-2.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Dist: aiohttp>=3.13.2
Requires-Dist: pydantic>=2.12.4
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/yor-dev/python-codex-sdk
Project-URL: Repository, https://github.com/yor-dev/python-codex-sdk
Description-Content-Type: text/markdown

# Python Codex SDK

Python SDK for OpenAI Codex CLI. This is a port of the official [TypeScript SDK](https://github.com/openai/codex/tree/main/sdk/typescript).

Based on commit [`3f1c4b9`](https://github.com/openai/codex/commit/3f1c4b9add8908936699ce47b17c94f8c9fd8018) (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

```bash
pip install python-codex-sdk
```

Requires Python 3.12+ and the [Codex CLI](https://developers.openai.com/codex/cli/).


## Testing

```bash
uv run pytest
```

Currently tested with `codex-cli 0.58.0`.

## License

Apache-2.0
