Installation

Install prerequisites (Codex CLI) and then install the Python SDK.

When to use this page

• You are installing acodex for the first time.

• You need to install or verify the Codex CLI prerequisite.

• You want the recommended uv-first install commands.

Important

acodex is an independently maintained SDK for the Codex CLI and is not affiliated with, sponsored by, or endorsed by OpenAI.

Prerequisite: Codex CLI

acodex spawns an external executable named codex (or a custom path passed via codex_path_override). You can install the upstream CLI with Node.js:

npm install -g @openai/codex
codex --version

See the upstream project for details: Codex CLI.

Install acodex

uv (recommended):

uv add acodex

pip:

pip install acodex

Optional: Structured-output extra for typed structured output

If you want output_type=... validation via Pydantic, install the extra:

uv add "acodex[structured-output]"
# or:
pip install "acodex[structured-output]"