codex-bridge-python 2026.6.10
Overview
This release introduces the simplified codex-bridge launcher workflow and packages it as a wheel-ready Python release.
The launcher now focuses on direct positional startup for Codex, creates and manages its own CODEX_HOME, persists the upstream API key and selected model, and maintains a local model catalog that accumulates metadata over time.
Highlights
- Adds a simplified launcher flow based on positional arguments:
base_url,api_key,model, and optionalcontext_size - Fixes the launcher port to
127.0.0.1:5057and starts bothcodex-bridgeandcodexas child processes in one command - Stores launcher config under
~/.codex-bridge-pythonand writesauth.json,config.toml, andmodel-catalog.local.json - Reuses saved launch values when starting without arguments, and reports exactly which required values are missing when they cannot be restored
- Keeps existing cached model metadata entries and only adds or refreshes the currently selected model entry
- Writes Codex model catalog metadata in the format expected by current Codex releases, removing the fallback metadata warning for configured models
- Uses
OPENAI_API_KEYfor the saved key and defaults reasoning effort tohigh - Supports wheel packaging and updates README usage around local wheel builds and GitHub Release wheel installs
- Simplifies README startup guidance to the 3 supported cases: 3 args, 4 args, and no args with saved config
Package
- Version:
2026.6.10 - Release tag:
v2026.6.10 - Wheel:
codex_bridge-2026.6.10-py3-none-any.whl - SHA256:
1e339f442015544799458728c85f2f297daf3c68f37e02114b593de9ca65a219
The uploaded wheel is a universal pure-Python build with tag py3-none-any.
Validation
- Local test suite:
29 passed - Built a release wheel locally with
python3 -m build --wheel - Verified the simplified launcher with a real DashScope configuration and confirmed that Codex no longer emits the
Model metadata ... not foundwarning for the configured model
Notes
This release does not replace or delete older releases. Previous release artifacts remain available on GitHub Releases.
Recommended startup forms:
codex-bridge <base_url> <api_key> <model>codex-bridge <base_url> <api_key> <model> <context_size>codex-bridgeafter the launcher has already saved config under~/.codex-bridge-python