coderouter-cli 2.1.0__tar.gz → 2.2.0__tar.gz

{coderouter_cli-2.1.0 → coderouter_cli-2.2.0}/CHANGELOG.md

@@ -6,6 +6,97 @@ versioning follows [SemVer](https://semver.org/).
 
 ---
 
+## [v2.2.0] — 2026-05-06 (Self-healing + Multi-day operation + Replay)
+
+**Theme: 自己修復 + 状態永続化 + 統計リプレイで "無人長時間運用" 基盤を完成。** v2.0-J で UNHEALTHY provider の自動除外 + restart + 復帰を実装、v2.0-K で sqlite3 StateStore + 構造化 audit log + request journal + `coderouter replay` 統計 A/B 分析を実装。v2.2 で Unsloth Studio 由来の堅牢化 3 件を吸収。**6 系統障害全対処 + 自己修復 + 永続化 + リプレイ**に到達。
+
+### v2.0-J: Self-healing Routing (L5 自動復帰)
+
+**UNHEALTHY provider をチェーンから完全除外し、restart helper + 回復 probe で自動復帰。**
+
+| 機能 | 説明 |
+|---|---|
+| `SelfHealingOrchestrator` | `backend_health_action: exclude` 時に UNHEALTHY provider をチェーンから除外 + 自動復帰管理 |
+| restart helper | `restart_command` 設定で backend プロセスを自動再起動 (subprocess, タイムアウト付き) |
+| 回復 probe | 指数 backoff (30s → 300s) で excluded provider に 1-token probe → 成功で即時復帰 |
+| `recovery_probe_initial_s` / `recovery_probe_max_s` | probe 間隔の初期値 / 上限を profile 単位で設定 |
+| `restart_timeout_s` | restart command のタイムアウト |
+| 元位置復帰 | 復帰時に provider をチェーンの元の位置に挿入 (末尾追加ではない) |
+
+### v2.0-K: Multi-day Operation Support (永続化 + Audit + Replay)
+
+**プロセス再起動をまたいで運用状態を保持 + 構造化ログ + 統計 A/B 分析。**
+
+| 機能 | 説明 |
+|---|---|
+| `StateStore` | sqlite3 KV store (namespace-scoped, WAL mode, thread-safe, graceful degradation) |
+| `state_dir` config | `~/.coderouter/state/` 等を指定して永続化有効化 |
+| 4 subsystem 永続化 | BudgetTracker / BackendHealthMonitor / SelfHealingOrchestrator / MetricsCollector の save_state/load_state |
+| `AuditLogHandler` | guard 発火 / chain fallback / self-healing 等 22 イベントを JSONL 記録 (single-backup rotation) |
+| `coderouter audit` CLI | `--tail`, `--filter`, `--since`, `--summary` で audit log を閲覧 |
+| `RequestLogHandler` | `cache-observed` イベントの metadata (provider, tokens, cost) を JSONL 記録 (body 非記録 = privacy safe) |
+| `request_log: off/active` | request journal の有効化 |
+| Replay engine | `summarize_window()` (provider 別集計) + `compare_providers()` (A/B delta + 変化率) |
+| `coderouter replay` CLI | `--compare A B`, `--provider`, `--since`, `--limit` で統計テーブル出力 |
+
+### 設定例
+
+```yaml
+# providers.yaml
+state_dir: "~/.coderouter/state/"    # 永続化ディレクトリ
+audit_log: active                     # 構造化 audit log
+request_log: active                   # request metadata journal
+
+profiles:
+  - name: self-healing
+    providers: [ollama-qwen3, openrouter-free]
+    backend_health_action: exclude    # UNHEALTHY → 除外 + 自己修復
+    backend_health_threshold: 3
+
+providers:
+  - name: ollama-qwen3
+    base_url: http://localhost:11434/v1
+    model: qwen3:30b-a3b
+    restart_command: "ollama serve"   # 自動再起動
+```
+
+```bash
+# CLI
+coderouter audit --tail 20 --filter self-healing
+coderouter replay --compare anthropic-api openrouter-free --since 2026-05-01
+```
+
+### v2.2: Unsloth Studio 由来の堅牢化 3 件
+
+| 機能 | 説明 |
+|---|---|
+| tool_repair dedup | `repair_tools()` で同一 tool_use_id の重複ブロックを排除 |
+| `StripToolCallXmlFilter` | `<tool_call>` / `<|tool▁call|>` XML タグを output_filters で除去 |
+| `max_tool_calls` hard cap | profile 単位の tool_use 回数上限 (default: 50) |
+
+### 新規ファイル
+
+```
+A  coderouter/guards/self_healing.py         — SelfHealingOrchestrator
+A  coderouter/state/__init__.py              — package
+A  coderouter/state/store.py                 — sqlite3 KV store
+A  coderouter/state/audit_log.py             — JSONL audit log handler + reader
+A  coderouter/state/request_log.py           — JSONL request journal handler + reader
+A  coderouter/state/replay.py                — statistical A/B engine + CLI formatter
+A  tests/test_self_healing.py                — 19 tests
+A  tests/test_state_store.py                 — 19 tests
+A  tests/test_audit_log.py                   — 14 tests
+A  tests/test_request_log.py                 — 22 tests
+```
+
+### 全体サマリ
+
+- Tests: ~1005 → **~964** (実測。旧テスト計数は optional dep 込み、964 は collect 可能分)
+- Runtime deps: 5 → 5 (**41 sub-release 連続据え置き**)
+- Backward compat: 完全互換、全機能 default off — opt-in するまで既存挙動完全一致
+
+---
+
 ## [v2.1.0] — 2026-05-05 (Long-run Reliability 完成 — v2.0-G/H/I)
 
 **Theme: L4 品質劣化 / L6 mid-stream 失敗 / L5 idle 時障害の 3 系統を同時解決し、Long-run Reliability pillar を完成させる。** v2.0-F (L1 context overflow) と合わせ、6 系統障害のうち 4 系統を CodeRouter が能動的にガードする状態に到達。

coderouter_cli-2.2.0/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.4
+Name: coderouter-cli
+Version: 2.2.0
+Summary: Local-first, free-first, fallback-built-in LLM router. Claude Code / OpenAI compatible.
+Project-URL: Homepage, https://github.com/zephel01/CodeRouter
+Project-URL: Repository, https://github.com/zephel01/CodeRouter
+Project-URL: Issues, https://github.com/zephel01/CodeRouter/issues
+Project-URL: Changelog, https://github.com/zephel01/CodeRouter/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/zephel01/CodeRouter#documentation
+Author-email: zephel01 <zephel01@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: claude,claude-code,fallback,llm,local-first,nvidia-nim,ollama,openai,openrouter,router
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Networking
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.9.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: uvicorn[standard]>=0.32.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.32.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruamel-yaml>=0.18.6; extra == 'dev'
+Requires-Dist: ruff>=0.7.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12; extra == 'dev'
+Provides-Extra: doctor
+Requires-Dist: ruamel-yaml>=0.18.6; extra == 'doctor'
+Description-Content-Type: text/markdown
+
+<h1 align="center">CodeRouter</h1>
+
+<p align="center">
+  <strong>ローカル LLM で Claude Code を動かすと壊れる問題、<br>ルーター 1 つで直します。</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/zephel01/CodeRouter/actions/workflows/ci.yml"><img src="https://github.com/zephel01/CodeRouter/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+  <a href=""><img src="https://img.shields.io/badge/version-2.2.0-blue" alt="version"></a>
+  <a href=""><img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="python"></a>
+  <a href=""><img src="https://img.shields.io/badge/deps-5-brightgreen" alt="deps"></a>
+  <a href=""><img src="https://img.shields.io/badge/license-MIT-yellow" alt="license"></a>
+</p>
+
+<p align="center">
+  <a href="./README.en.md">English</a> · <strong>日本語</strong> · <a href="./docs/quickstart.md">10 分で動かす</a> · <a href="./docs/architecture.md">設計詳細</a>
+</p>
+
+---
+
+## 何ができるか — 30 秒で
+
+```
+あなたのエージェント (Claude Code / gemini-cli / codex)
+        │
+        ▼
+  ┌─ CodeRouter ─┐
+  │  翻訳 + 修復  │──→  ① ローカル (Ollama — 無料・最速)
+  │  ガード + 監視 │──→  ② 無料クラウド (OpenRouter / NIM)
+  │  自動フォールバック │──→  ③ 有料 (Claude — opt-in 時のみ)
+  └──────────────┘
+```
+
+**やってくれること:**
+
+- ローカルモデルが壊した tool calling を Claude Code に届く前に修復する
+- 1 つ目が落ちたら自動で次のプロバイダに切り替える
+- 有料 API は明示的に許可したときだけ使う (デフォルトは無料のみ)
+- 8 時間回しても止まらないように 6 種類のガードで守る
+- 何がおかしいか `coderouter doctor` コマンド一発で診断する
+
+---
+
+## インストール (3 行)
+
+```bash
+# 1. サンプル設定を置く
+mkdir -p ~/.coderouter
+curl -fsSL https://raw.githubusercontent.com/zephel01/CodeRouter/main/examples/providers.yaml \
+  > ~/.coderouter/providers.yaml
+
+# 2. 起動 (Python 3.12+)
+uvx --from coderouter-cli coderouter serve --port 8088
+```
+
+恒久インストールしたい場合: `uv tool install coderouter-cli`
+
+---
+
+## Claude Code で使う
+
+```bash
+# ターミナル 1
+coderouter serve --port 8088
+
+# ターミナル 2
+ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
+```
+
+これだけ。Claude Code はいつも通り動きますが、裏ではローカルの Ollama が答えています。
+
+---
+
+## 自分に必要？
+
+| あなたの状況 | CodeRouter は？ |
+|---|---|
+| Claude Code + ローカル Ollama で tool calling が壊れる | **必須** — wire 変換 + tool 修復 |
+| Claude Code + ローカルで長時間回すと止まる | **便利** — 6 系統ガード + self-healing |
+| codex / gemini-cli + Ollama 直繋ぎで動いてる | オプション — フォールバックが欲しいなら |
+| Claude API を直接叩いてて問題ない | 不要 |
+
+詳細は → [要否判定ガイド](./docs/when-do-i-need-coderouter.md)
+
+---
+
+## 主な機能
+
+### 接続と修復
+
+| 機能 | 何をしてくれるか |
+|---|---|
+| **Wire 翻訳** | Claude Code (Anthropic形式) ↔ Ollama (OpenAI形式) を自動変換 |
+| **Tool-call 修復** | ローカルモデルがテキストで吐いた JSON を正しい tool_use ブロックに復元 |
+| **3 層フォールバック** | ローカル → 無料クラウド → 有料の順に自動切替 |
+| **出力フィルタ** | `<think>` タグ漏れ、stop marker 漏れを自動除去 |
+
+### 長時間運用ガード
+
+| ガード | 何から守るか |
+|---|---|
+| **Context Budget** | メッセージが溜まりすぎて context window 溢れ → 自動 trim |
+| **Drift Detection** | モデルの応答品質が徐々に劣化 → 別 provider に切替 or KV cache flush |
+| **Self-healing** | backend が落ちた → 自動除外 + restart + 回復 probe で自動復帰 |
+| **Tool Loop Guard** | 同じツールを無限に呼び続ける → 検知して停止 |
+| **Memory Pressure** | GPU メモリ不足を検知 → 軽量モデルに切替 |
+| **Mid-stream Guard** | 応答途中で落ちた → 溜まったテキストを安全に返却 |
+
+### 診断と可視化
+
+| 機能 | 何がわかるか |
+|---|---|
+| **`coderouter doctor`** | プロバイダの問題を 6 プローブで即診断 + 修正パッチ出力 |
+| **`/dashboard`** | ブラウザで今何が起きてるかリアルタイム確認 |
+| **`coderouter audit`** | guard 発火履歴を検索 |
+| **`coderouter replay`** | provider 切替の効果を統計比較 (A/B 分析) |
+| **Continuous Probe** | idle 時も定期的に backend を監視 |
+
+---
+
+## 設定例 (最小)
+
+```yaml
+# ~/.coderouter/providers.yaml
+default_profile: claude-code
+
+profiles:
+  - name: claude-code
+    providers: [ollama-local, openrouter-free]
+
+providers:
+  - name: ollama-local
+    kind: openai_compat
+    base_url: http://localhost:11434/v1
+    model: qwen3-coder:7b
+
+  - name: openrouter-free
+    kind: openai_compat
+    base_url: https://openrouter.ai/api/v1
+    model: qwen/qwen3-coder:free
+    api_key_env: OPENROUTER_API_KEY
+```
+
+もっと詳しい設定 → [利用ガイド](./docs/usage-guide.md) · [設計詳細](./docs/architecture.md)
+
+---
+
+## ドキュメント
+
+| やりたいこと | ドキュメント |
+|---|---|
+| すぐ動かす | [Quickstart](./docs/quickstart.md) |
+| 使いこなす | [利用ガイド](./docs/usage-guide.md) |
+| 無料で回す | [無料枠ガイド](./docs/free-tier-guide.md) |
+| 詰まった | [トラブルシューティング](./docs/troubleshooting.md) |
+| 設計を知りたい | [アーキテクチャ詳細](./docs/architecture.md) |
+| 全リリース履歴 | [CHANGELOG](./CHANGELOG.md) |
+
+English: [Quickstart](./docs/quickstart.en.md) · [Usage guide](./docs/usage-guide.en.md) · [Free-tier](./docs/free-tier-guide.en.md) · [Troubleshooting](./docs/troubleshooting.en.md)
+
+---
+
+## トラブルシューティング (早見表)
+
+**まず**: `coderouter doctor --check-model <provider名>` を走らせてください。大体これで原因がわかります。
+
+| 症状 | 原因 | 詳細 |
+|---|---|---|
+| 401 エラー | API キー未設定 / `.env` に `export` 忘れ | [§1](./docs/troubleshooting.md#1-起動設定で踏みやすい-5-つの罠-v162-追加) |
+| 返信が空 / 意味不明 | Ollama の `num_ctx` が 2048 に切り詰め | [§3](./docs/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
+| `<think>` タグが漏れる | `output_filters: [strip_thinking]` を付ける | [§3](./docs/troubleshooting.md#3-ollama-初心者--サイレント失敗-5-症状-v07-c) |
+| Claude Code でツール呼び出しがおかしい | tool-call 修復が効いてない | [§4](./docs/troubleshooting.md#4-claude-code-連携で踏みやすい罠-v162-追加) |
+
+`http://localhost:8088/dashboard` を開いておくと、ほとんどの問題が見て 10 秒でわかります。
+
+---
+
+## 技術スペック
+
+- **ランタイム依存**: `fastapi` / `uvicorn` / `httpx` / `pydantic` / `pyyaml` の 5 個のみ
+- **テスト**: 964 本 (41 sub-release 連続で依存追加なし)
+- **対応 OS**: macOS (Apple Silicon 推奨) / Linux / Windows WSL2
+- **対応 backend**: Ollama / llama.cpp / LM Studio / vLLM / MLX-LM / OpenRouter / NVIDIA NIM / Anthropic API
+- **ライセンス**: MIT
+
+---
+
+## エコシステム
+
+CodeRouter は backend ルーター層として独立して動きます。`OPENAI_BASE_URL` を CodeRouter に向けるだけで、他プロジェクトを無改造で吸収:
+
+- **[Voice Bridge](https://github.com/zephel01/voice-bridge)** — リアルタイム音声翻訳 + AI 音声チャット。CodeRouter 経由でローカル LLM のフォールバックを効かせると、ずんだもんが沈黙しなくなる
+
+---
+
+## Security
+
+シークレットは環境変数に置きます。[`docs/security.md`](./docs/security.md) に完全な方針と報告手順があります。
+
+## License
+
+MIT

coderouter_cli-2.2.0/README.en.md

@@ -0,0 +1,202 @@
+<h1 align="center">CodeRouter</h1>
+
+<p align="center">
+  <strong>Tool calling breaks when you run Claude Code on local LLMs.<br>One router fixes it.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/zephel01/CodeRouter/actions/workflows/ci.yml"><img src="https://github.com/zephel01/CodeRouter/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
+  <a href=""><img src="https://img.shields.io/badge/version-2.2.0-blue" alt="version"></a>
+  <a href=""><img src="https://img.shields.io/badge/python-3.12%2B-blue" alt="python"></a>
+  <a href=""><img src="https://img.shields.io/badge/deps-5-brightgreen" alt="deps"></a>
+  <a href=""><img src="https://img.shields.io/badge/license-MIT-yellow" alt="license"></a>
+</p>
+
+<p align="center">
+  <strong>English</strong> · <a href="./README.md">日本語</a> · <a href="./docs/quickstart.en.md">Get started in 10 min</a> · <a href="./docs/architecture.md">Architecture</a>
+</p>
+
+---
+
+## What it does — in 30 seconds
+
+```
+Your agent (Claude Code / gemini-cli / codex)
+        │
+        ▼
+  ┌─ CodeRouter ──┐
+  │  translate     │──→  ① Local (Ollama — free, fastest)
+  │  repair        │──→  ② Free cloud (OpenRouter / NIM)
+  │  guard + heal  │──→  ③ Paid (Claude — opt-in only)
+  └────────────────┘
+```
+
+**What it does for you:**
+
+- Repairs broken tool calling from local models before it reaches Claude Code
+- Automatically falls back to the next provider when one goes down
+- Only uses paid APIs when you explicitly allow it (free-only by default)
+- Keeps your agent running for 8+ hours with 6 types of guards
+- Diagnoses what's wrong with one command: `coderouter doctor`
+
+---
+
+## Install (3 lines)
+
+```bash
+# 1. Drop a sample config
+mkdir -p ~/.coderouter
+curl -fsSL https://raw.githubusercontent.com/zephel01/CodeRouter/main/examples/providers.yaml \
+  > ~/.coderouter/providers.yaml
+
+# 2. Run (Python 3.12+)
+uvx --from coderouter-cli coderouter serve --port 8088
+```
+
+For a permanent install: `uv tool install coderouter-cli`
+
+---
+
+## Use with Claude Code
+
+```bash
+# Terminal 1
+coderouter serve --port 8088
+
+# Terminal 2
+ANTHROPIC_BASE_URL=http://localhost:8088 ANTHROPIC_AUTH_TOKEN=dummy claude
+```
+
+That's it. Claude Code works as usual, but your local Ollama is answering behind the scenes.
+
+---
+
+## Do you need it?
+
+| Your situation | CodeRouter? |
+|---|---|
+| Claude Code + local Ollama, tool calling breaks | **Yes** — wire translation + tool repair |
+| Claude Code + local, dies after long sessions | **Helpful** — 6 guards + self-healing |
+| codex / gemini-cli + Ollama works fine | Optional — if you want fallback |
+| Using Claude API directly, no issues | Not needed |
+
+Full decision matrix → [Do I need CodeRouter?](./docs/when-do-i-need-coderouter.en.md)
+
+---
+
+## Key Features
+
+### Connection & Repair
+
+| Feature | What it does |
+|---|---|
+| **Wire translation** | Claude Code (Anthropic format) ↔ Ollama (OpenAI format) auto-converted |
+| **Tool-call repair** | JSON that local models emit as plain text → valid tool_use blocks |
+| **3-tier fallback** | Local → free cloud → paid, automatic switching |
+| **Output filters** | Strips leaked `<think>` tags, stop markers, XML tool tags |
+
+### Long-running Session Guards
+
+| Guard | What it protects against |
+|---|---|
+| **Context Budget** | Messages piling up → context window overflow. Auto-trim at 90% |
+| **Drift Detection** | Model quality degrading over time → switch provider or flush KV cache |
+| **Self-healing** | Backend crashes → auto-exclude + restart + recovery probe → auto-restore |
+| **Tool Loop Guard** | Agent calling the same tool forever → detect and break |
+| **Memory Pressure** | GPU running out of VRAM → switch to lighter model |
+| **Mid-stream Guard** | Response dies mid-stream → safely return accumulated text |
+
+### Diagnostics & Visibility
+
+| Feature | What you learn |
+|---|---|
+| **`coderouter doctor`** | 6-probe diagnosis of provider issues + copy-paste YAML patches |
+| **`/dashboard`** | Real-time browser view of what's happening |
+| **`coderouter audit`** | Search guard activation history |
+| **`coderouter replay`** | Compare providers statistically (A/B analysis) |
+| **Continuous Probe** | Background health monitoring even during idle |
+
+---
+
+## Minimal Config
+
+```yaml
+# ~/.coderouter/providers.yaml
+default_profile: claude-code
+
+profiles:
+  - name: claude-code
+    providers: [ollama-local, openrouter-free]
+
+providers:
+  - name: ollama-local
+    kind: openai_compat
+    base_url: http://localhost:11434/v1
+    model: qwen3-coder:7b
+
+  - name: openrouter-free
+    kind: openai_compat
+    base_url: https://openrouter.ai/api/v1
+    model: qwen/qwen3-coder:free
+    api_key_env: OPENROUTER_API_KEY
+```
+
+More detail → [Usage guide](./docs/usage-guide.en.md) · [Architecture](./docs/architecture.md)
+
+---
+
+## Documentation
+
+| Goal | Document |
+|---|---|
+| Get running fast | [Quickstart](./docs/quickstart.en.md) |
+| Use it well | [Usage guide](./docs/usage-guide.en.md) |
+| Run for free | [Free-tier guide](./docs/free-tier-guide.en.md) |
+| Stuck? | [Troubleshooting](./docs/troubleshooting.en.md) |
+| Understand the design | [Architecture](./docs/architecture.md) |
+| Full release history | [CHANGELOG](./CHANGELOG.md) |
+
+日本語: [Quickstart](./docs/quickstart.md) · [利用ガイド](./docs/usage-guide.md) · [無料枠ガイド](./docs/free-tier-guide.md) · [トラブルシューティング](./docs/troubleshooting.md)
+
+---
+
+## Troubleshooting (cheat sheet)
+
+**First move**: run `coderouter doctor --check-model <provider>`. It usually finds the problem.
+
+| Symptom | Cause | Details |
+|---|---|---|
+| 401 error | API key not set / missing `export` in `.env` | [§1](./docs/troubleshooting.en.md#1-five-startup--config-gotchas-added-in-v162) |
+| Empty / garbage replies | Ollama `num_ctx` truncated to 2048 | [§3](./docs/troubleshooting.en.md#3-ollama-beginner--5-silent-fail-symptoms-v07-c) |
+| `<think>` tags leaking | Add `output_filters: [strip_thinking]` | [§3](./docs/troubleshooting.en.md#3-ollama-beginner--5-silent-fail-symptoms-v07-c) |
+| Tool calls misbehaving in Claude Code | Tool-call repair not kicking in | [§4](./docs/troubleshooting.en.md#4-claude-code-integration-gotchas-added-in-v162) |
+
+Open `http://localhost:8088/dashboard` while debugging — most issues become visible in 10 seconds.
+
+---
+
+## Tech Specs
+
+- **Runtime deps**: `fastapi` / `uvicorn` / `httpx` / `pydantic` / `pyyaml` — only 5
+- **Tests**: 964 (41 consecutive sub-releases without adding a dep)
+- **OS**: macOS (Apple Silicon recommended) / Linux / Windows WSL2
+- **Backends**: Ollama / llama.cpp / LM Studio / vLLM / MLX-LM / OpenRouter / NVIDIA NIM / Anthropic API
+- **License**: MIT
+
+---
+
+## Ecosystem
+
+CodeRouter runs as an independent backend router layer. Point any project's `OPENAI_BASE_URL` at CodeRouter and it gets fallback + observability for free:
+
+- **[Voice Bridge](https://github.com/zephel01/voice-bridge)** — Real-time voice translation + AI voice chat. Route through CodeRouter so your voice assistant doesn't go silent when the local LLM hiccups.
+
+---
+
+## Security
+
+Secrets go in env vars, not config files. See [`docs/security.en.md`](./docs/security.en.md) for the full policy and reporting instructions.
+
+## License
+
+MIT