v0.1.5

Changed

• Added scaled README overview images for English and Simplified Chinese.
• Kept README image links compatible with GitHub and the PyPI project page.

v0.1.4

Changed

• Changed README language-switch links to absolute GitHub URLs so they work from the PyPI project page.

v0.1.3

Changed

• Clarified that development/source installs should start by cloning the GitHub repository.
• Added git clone and cd codex-bridge-python before pip install . in English and Chinese README files.

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 optional context_size
• Fixes the launcher port to 127.0.0.1:5057 and starts both codex-bridge and codex as child processes in one command
• Stores launcher config under ~/.codex-bridge-python and writes auth.json, config.toml, and model-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_KEY for the saved key and defaults reasoning effort to high
• 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 found warning 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-bridge after the launcher has already saved config under ~/.codex-bridge-python

codex-bridge-python 2026.6.5

Overview

This release adds forced default model routing so codex-bridge-python can rewrite every incoming request model to one configured upstream model.

It is useful when Codex sends different model ids but you want the bridge to pin all traffic to a single provider model without changing the client-side request flow.

Highlights

• Adds --force-default-model and CODEX_BRIDGE_FORCE_DEFAULT_MODEL
• Adds --default-model and CODEX_BRIDGE_DEFAULT_MODEL
• Rewrites all incoming request models to the configured default model when the switch is enabled
• Falls back to deepseek-v4-flash when no default model is configured
• Preserves the existing CODEX_BRIDGE_MODEL_MAP behavior when forced routing is disabled
• Adds request translation and app-level tests for forced model routing
• Updates English and Simplified Chinese documentation with CLI reference and usage examples

Package

• Version: 2026.6.5
• Release tag: v2026.6.5
• Wheel: codex_bridge-2026.6.5-py3-none-any.whl
• SHA256: 33ff27e762937f2977873f1141e389577c4371caf6e1747a63c3af3b7ece511d

The uploaded wheel is a universal pure-Python build with tag py3-none-any.

Validation

• Local test suite: 14 passed
• Verified wheel metadata reports Root-Is-Purelib: true and Tag: py3-none-any
• Built a release wheel locally with python3 -m build --wheel

Notes

Use CODEX_BRIDGE_FORCE_DEFAULT_MODEL=true to enable forced routing. If CODEX_BRIDGE_DEFAULT_MODEL is unset or empty, the bridge defaults to deepseek-v4-flash.

v0.1.2

Changed

• Reworked the README feature section to highlight automatic protocol conversion.
• Emphasized the three-argument Codex launch: codex-bridge-python base_url api_key model.
• Clarified context and compression management as a core feature.

v0.1.1

Changed

• Simplified the README install and quick-start instructions for PyPI.
• Clarified the primary launch form as codex-bridge-python base_url api_key model.
• Clarified the optional fourth positional argument name as context_size.

v0.1.0

Changelog

All notable changes to this project are documented here.

This project follows Semantic Versioning.

[0.1.0] - 2026-06-06

Added

• Initial PyPI-ready release as codex-bridge-python.
• Console entry point: codex-bridge-python.
• Python API package: codex_bridge.
• Responses API to Chat Completions proxy for Codex CLI.
• Simplified launcher with persisted Codex config in ~/.codex-bridge-python.
• Model catalog generation and upstream /v1/models normalization.
• Release documentation and GitHub Actions workflow for PyPI Trusted Publishing.

codex-bridge-python 2026.6.4

Overview

Initial public release of codex-bridge-python.

codex-bridge-python is a pure-Python bridge that lets Codex talk to standard Chat Completions providers through the Responses API shape Codex expects.

Highlights

• Implements POST /v1/responses to POST /v1/chat/completions translation
• Proxies and normalizes GET /v1/models
• Supports blocking and streaming response conversion
• Preserves previous_response_id session history
• Supports tool calls, namespace tools, and grouped parallel tool-call replay
• Retains reasoning content where the upstream provides it
• Supports memory-backed and disk-backed session storage
• Includes English and Simplified Chinese documentation
• Targets Python >=3.10

Package

• Version: 2026.6.4
• Release tag: v2026.6.4
• Wheel: codex_bridge-2026.6.4-py3-none-any.whl
• SHA256: 7650d5de31d85291abfcc96a7990757f3a842dbf124fc8560055a041f7cce828

The uploaded wheel is a universal pure-Python build with tag py3-none-any.

Validation

• Local test suite: 11 passed
• Verified wheel metadata reports Root-Is-Purelib: true and Tag: py3-none-any
• End-to-end smoke-tested against a real OpenAI-compatible Chat Completions upstream during development

Notes

This release is intended to be used as a local bridge in front of an OpenAI-compatible provider such as DashScope, DeepSeek, Kimi, OpenRouter, Groq, or xAI.