OpenAI Codex Python SDK
Build Python applications that start Codex threads, run turns, stream progress, and control workspace access.
Install
Install the SDK:
pip install openai-codex
Quickstart
The SDK reuses your existing Codex authentication when one is already available:
from openai_codex import Codex
with Codex() as codex:
thread = codex.thread_start()
result = thread.run("Explain this repository in three bullets.")
print(result.final_response)
thread.run(...) returns a TurnResult containing the final response,
collected items, and token usage.
Authentication
Existing Codex authentication is reused automatically. To start ChatGPT browser login explicitly:
from openai_codex import Codex
with Codex() as codex:
login = codex.login_chatgpt()
print(login.auth_url)
print(login.wait().success)
For device-code login:
with Codex() as codex:
login = codex.login_chatgpt_device_code()
print(login.verification_url, login.user_code)
login.wait()
For API-key login:
with Codex() as codex:
codex.login_api_key("sk-...")
Built-In Help
Use Python's standard help(openai_codex), help(Codex), or
python -m pydoc openai_codex documentation tools.
Documentation
The package is licensed under the repository Apache License 2.0.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file openai_codex-0.144.4.tar.gz.
File metadata
- Download URL: openai_codex-0.144.4.tar.gz
- Upload date:
- Size: 68.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
91c63a7cb213441569f130e593386b34657ab9e726ae88af255f0ecb8de08ea5
|
|
| MD5 |
6a0ffaaa35a49f0e753a3bb841cc8f7f
|
|
| BLAKE2b-256 |
b97d4b999b0ddd05c22d83cc2e879c95e1e92e3b7808b58ac561c4ea91fca1c4
|
Provenance
The following attestation bundles were made for openai_codex-0.144.4.tar.gz:
Publisher:
python-sdk-release.yml on openai/codex
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
openai_codex-0.144.4.tar.gz -
Subject digest:
91c63a7cb213441569f130e593386b34657ab9e726ae88af255f0ecb8de08ea5 - Sigstore transparency entry: 2192467026
- Sigstore integration time:
-
Permalink:
openai/codex@5354e4951a8d10567ab2e43f8e483331f9ffe49e -
Branch / Tag:
refs/tags/python-v0.144.4 - Owner: https://github.com/openai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-sdk-release.yml@5354e4951a8d10567ab2e43f8e483331f9ffe49e -
Trigger Event:
push
-
Statement type:
File details
Details for the file openai_codex-0.144.4-py3-none-any.whl.
File metadata
- Download URL: openai_codex-0.144.4-py3-none-any.whl
- Upload date:
- Size: 76.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
de1513a6e94b9a8d7728a3b74298bc1469428ade10ba0ef2d5db47dd1cb606f5
|
|
| MD5 |
ff73350aeb100fa0575f81306cf051e4
|
|
| BLAKE2b-256 |
17355d2a13e38d91278019f18757ac10426d2649b7ec6f031818c792f64559e9
|
Provenance
The following attestation bundles were made for openai_codex-0.144.4-py3-none-any.whl:
Publisher:
python-sdk-release.yml on openai/codex
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
openai_codex-0.144.4-py3-none-any.whl -
Subject digest:
de1513a6e94b9a8d7728a3b74298bc1469428ade10ba0ef2d5db47dd1cb606f5 - Sigstore transparency entry: 2192467030
- Sigstore integration time:
-
Permalink:
openai/codex@5354e4951a8d10567ab2e43f8e483331f9ffe49e -
Branch / Tag:
refs/tags/python-v0.144.4 - Owner: https://github.com/openai
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-sdk-release.yml@5354e4951a8d10567ab2e43f8e483331f9ffe49e -
Trigger Event:
push
-
Statement type:
