codex-sdk-unofficial
Unofficial, community-maintained Python SDK for the Codex CLI.
This is not an official OpenAI SDK.
Documentation
Full docs site (UV-first, beginner-first):
Local docs preview:
uv run --group docs mkdocs serve
Quickstart (UV-First)
Assumes you are already inside an existing UV-managed project.
uv add codex-sdk-unofficial
uv run python -c "from codex_sdk import Codex; print('import-ok')"
from codex_sdk import Codex
codex = Codex()
thread = codex.start_thread()
turn = thread.run("Diagnose the test failure and propose a fix", stream=True)
print(turn.final_response)
print(turn.items)
Run:
uv run python your_script.py
Package Info
- Package name:
codex-sdk-unofficial - Import name:
codex_sdk - Current version:
0.1.3
Dev Commands
PYTHONPATH=src uv run pytest -q
uv run --group docs mkdocs build --strict
uv run --with build python -m build
Publishing
Tag pushes (v*) trigger .github/workflows/publish.yml.
Manual upload fallback:
uv run --with twine twine upload dist/*
1 maintainer
Metadata
1 maintainer
Release files for codex-sdk-unofficial 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| codex_sdk_unofficial-0.1.3.tar.gz | 64.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| codex_sdk_unofficial-0.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 77.0 kB
Release files / codex_sdk_unofficial-0.1.3.tar.gz
| Download URL | codex_sdk_unofficial-0.1.3.tar.gz |
|---|---|
| Size | 64.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dce43b63697b60b8fa824bd7ad56f3c3a794b3bf08404dae92d0fd17ee05dd38
|
|
BLAKE2b-256 checksum How to use checksums |
249d4e63ce2b1558bf82a7c5823df16cd6b05c66775429828e78c22dea0fe7b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 2, 2026.
Transparency logRelease files / codex_sdk_unofficial-0.1.3-py3-none-any.whl
| Download URL | codex_sdk_unofficial-0.1.3-py3-none-any.whl |
|---|---|
| Size | 12.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
80396af0969fe9f0c052321a784b42ba0f726ae8c227c02a54b16745500f6ab4
|
|
BLAKE2b-256 checksum How to use checksums |
3407b37bb114f19f55ae5365c6d0e093b0e0a209d52191c9310c2df9b8b0e8c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Mar 2, 2026.
Transparency log
