codex-relay 0.1.2__py3-none-win_amd64.whl

codex_relay/__init__.py

@@ -0,0 +1,46 @@
+"""
+codex-relay Python shim.
+
+Provides a minimal interface to start/stop the relay process.
+The actual binary is installed to PATH by the wheel.
+"""
+
+import os
+import shutil
+import subprocess
+from pathlib import Path
+
+
+def _find_binary() -> Path:
+    path = shutil.which("codex-relay")
+    if path:
+        return Path(path)
+    # Fallback: look next to this file (editable / dev install)
+    local = Path(__file__).parent / "_bin" / "codex-relay"
+    if local.exists():
+        return local
+    raise FileNotFoundError(
+        "codex-relay binary not found. "
+        "Install with: pip install codex-relay  or  cargo install codex-relay"
+    )
+
+
+def start(
+    port: int = 4444,
+    upstream: str = "https://openrouter.ai/api/v1",
+    api_key: str = "",
+) -> subprocess.Popen:
+    """Start codex-relay as a background process and return the Popen handle."""
+    env = os.environ.copy()
+    if api_key:
+        env["CODEX_RELAY_API_KEY"] = api_key
+
+    return subprocess.Popen(
+        [str(_find_binary()), "--port", str(port), "--upstream", upstream],
+        env=env,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.PIPE,
+    )
+
+
+__all__ = ["start"]

codex_relay-0.1.2.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: codex-relay
+Version: 0.1.2
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Libraries
+License-File: LICENSE
+Summary: Responses API ↔ Chat Completions translation bridge for Codex CLI
+Keywords: codex,llm,proxy,relay
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+# codex-relay
+
+A lightweight Rust proxy that translates the OpenAI **Responses API** (used by [Codex CLI](https://github.com/openai/codex)) into the **Chat Completions API**, letting Codex work with any OpenAI-compatible provider — DeepSeek, Kimi, Qwen, Mistral, Groq, xAI, OpenRouter, and more.
+
+## Why
+
+Codex CLI speaks the OpenAI Responses API, which is an OpenAI-proprietary stateful protocol. Every other provider exposes the standard Chat Completions API. `codex-relay` sits between Codex and your chosen provider, translating on the fly — no code changes to Codex required.
+
+## Install
+
+```bash
+# From PyPI — prebuilt binary for your platform
+pip install codex-relay
+
+# From crates.io
+cargo install codex-relay
+```
+
+## Quick start
+
+**1. Start the relay**
+
+```bash
+CODEX_RELAY_UPSTREAM=https://api.deepseek.com/v1 \
+CODEX_RELAY_API_KEY=$DEEPSEEK_API_KEY \
+CODEX_RELAY_PORT=4446 \
+codex-relay
+```
+
+**2. Configure Codex** (`~/.codex/config.toml`)
+
+```toml
+model = "deepseek-chat"
+model_provider = "deepseek-relay"
+
+[model_providers.deepseek-relay]
+name = "DeepSeek"
+api_base_url = "http://127.0.0.1:4446/v1"
+env_key = "DEEPSEEK_API_KEY"
+```
+
+**3. Use Codex normally** — it routes through the relay transparently.
+
+## Supported providers
+
+| Provider | Base URL | Suggested port |
+|---|---|---|
+| DeepSeek | `https://api.deepseek.com/v1` | 4446 |
+| Kimi (Moonshot) | `https://api.moonshot.cn/v1` | 4447 |
+| Qwen | `https://dashscope.aliyuncs.com/compatible-mode/v1` | 4448 |
+| Mistral | `https://api.mistral.ai/v1` | 4449 |
+| Groq | `https://api.groq.com/openai/v1` | 4450 |
+| xAI | `https://api.x.ai/v1` | 4451 |
+| OpenRouter | `https://openrouter.ai/api/v1` | 4452 |
+
+Any OpenAI-compatible endpoint works.
+
+## Features
+
+- **Streaming** — full SSE streaming with correct event sequencing
+- **Tool calls** — accumulates streaming deltas and emits structured function_call items
+- **Parallel tool calls** — consecutive function_call input items merged into one assistant message
+- **Reasoning models** — preserves `reasoning_content` across turns (Kimi k2.6, DeepSeek-R1)
+- **Model catalog** — proxies `/v1/models` from the upstream provider
+
+## Configuration
+
+| Variable | Default | Description |
+|---|---|---|
+| `CODEX_RELAY_PORT` | `4444` | Port to listen on |
+| `CODEX_RELAY_UPSTREAM` | `https://openrouter.ai/api/v1` | Upstream Chat Completions base URL |
+| `CODEX_RELAY_API_KEY` | _(empty)_ | API key forwarded to upstream |
+| `RUST_LOG` | `codex_relay=info` | Log verbosity |
+
+## Python API
+
+```python
+from codex_relay import start
+
+proc = start(port=4446, upstream="https://api.deepseek.com/v1", api_key="sk-...")
+# ... use Codex ...
+proc.terminate()
+```
+
+## Disclaimer
+
+This project is **not affiliated with, endorsed by, or sponsored by OpenAI**. "Codex" refers to [OpenAI Codex CLI](https://github.com/openai/codex), an open-source project licensed under Apache-2.0. codex-relay is an independent, community-built translation proxy.
+
+## License
+
+MIT
+

codex_relay-0.1.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+codex_relay/__init__.py,sha256=0WdFOcsS3-tc2Af6XUUnocPnXyldjrq1zaOPIXd8JGg,1214
+codex_relay-0.1.2.data/scripts/codex-relay.exe,sha256=gYeSPqz2tZh7zSoCukW4pJTZmzXzXKKCDFdI_nbUmtw,5823488
+codex_relay-0.1.2.dist-info/METADATA,sha256=M7O43wU8EP_M2HJMlIwhUN-sQKzmGpDOzrnbo_EBC0g,3599
+codex_relay-0.1.2.dist-info/WHEEL,sha256=0cg7uMdVM1SNK0ih4zFWnV0wsxqvcArlTmRGOaRhEnw,94
+codex_relay-0.1.2.dist-info/licenses/LICENSE,sha256=dwfkKVrUBe67tEbrhqBoVKDUCEihiBimm1mZD2WXIzY,1090
+codex_relay-0.1.2.dist-info/sboms/codex-relay.cyclonedx.json,sha256=TxiUeTlSE9UHzP6dR5UEFmjO8KQWNQavsEa_fJKAkvk,199151
+codex_relay-0.1.2.dist-info/RECORD,,

codex_relay-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.13.1)
+Root-Is-Purelib: false
+Tag: py3-none-win_amd64

codex_relay-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sapient Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.