python-sdk: pin repo runtime bootstrap version (2026-03-12)

Remove CODEX_PYTHON_RUNTIME_VERSION from the repo bootstrap path and always provision the checked-in pinned codex-cli-bin runtime version for examples, notebook, and real integration coverage.

This keeps repo-source Python execution aligned with one binary contract, rewires the real integration harness and notebook bootstrap to use the pinned runtime directly, and updates the docs to describe automatic pinned-runtime provisioning instead of env-driven overrides.

Validation:
- RUN_REAL_CODEX_TESTS=1 python3 -m pytest sdk/python/tests -rs
- RUN_REAL_CODEX_TESTS=1 python3 -m pytest sdk/python/tests/test_real_app_server_integration.py -rs

Co-authored-by: Codex <noreply@openai.com>
This commit is contained in:
Shaqayeq
2026-03-12 23:20:04 -07:00
parent 3cf1306968
commit 09a265122d
5 changed files with 22 additions and 59 deletions

View File

@@ -25,11 +25,12 @@ When running examples from this repo checkout, the SDK source uses the local
tree and does not bundle a runtime binary. The helper in `examples/_bootstrap.py`
uses the installed `codex-cli-bin` runtime package.
If `codex-cli-bin` is not already installed, set `CODEX_PYTHON_RUNTIME_VERSION`
to a release version like `0.115.0-alpha.11`; the bootstrap will download the
matching GitHub release artifact, stage a temporary local `codex-cli-bin`
package, install it into your active interpreter, and clean up the temporary
files afterward.
If the pinned `codex-cli-bin` runtime is not already installed, the bootstrap
will download the matching GitHub release artifact, stage a temporary local
`codex-cli-bin` package, install it into your active interpreter, and clean up
the temporary files afterward.
Current pinned runtime version: `0.115.0-alpha.11`
## Run examples
@@ -43,12 +44,11 @@ python examples/<example-folder>/async.py
The examples bootstrap local imports from `sdk/python/src` automatically, so no
SDK wheel install is required. You only need the Python dependencies for your
active interpreter and an installed `codex-cli-bin` runtime package (either
already present or provisioned through `CODEX_PYTHON_RUNTIME_VERSION`).
already present or automatically provisioned by the bootstrap).
## Recommended first run
```bash
export CODEX_PYTHON_RUNTIME_VERSION=0.115.0-alpha.11
python examples/01_quickstart_constructor/sync.py
python examples/01_quickstart_constructor/async.py
```