# README (日本語) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — 無料のAIゲートウェイ OmniRoute — コーディングを止めない。あらゆるAIツールを、1つのエンドポイントから372のプロバイダー（150以上は無料）へ。Claude Code、Codex、Cursor、Cline、Copilot、Antigravityを無料のClaude / GPT / Geminiに接続し、自動フォールバック。RTK + Cavemanの多段圧縮によりトークンを15～95%（平均約89%）削減し、上限到達を回避。372のAIプロバイダー · 150以上の無料枠 · 月間約16.2億無料トークン · 19種類のルーティング戦略 · $0で開始。

OmniRoute — コーディングを止めない。あらゆるAIツールを、1つのエンドポイントから372のプロバイダー（150以上は無料）へ。Claude Code、Codex、Cursor、Cline、Copilot、Antigravityを無料のClaude / GPT / Geminiに接続し、自動フォールバック。RTK + Cavemanの多段圧縮によりトークンを15～95%（平均約89%）削減し、上限到達を回避。372のAIプロバイダー · 150以上の無料枠 · 月間約16.2億無料トークン · 19種類のルーティング戦略 · $0で開始。

## 💰 サードパーティーの無料枠全体で月間約16.2億トークン

> **ご自身のプロバイダーアカウントをご用意ください。** これは、個別に利用資格を満たすサードパーティーの無料枠を合算した推定値であり、OmniRouteが付与するトークンではありません。サインアップし、必要に応じて認証情報を取得して、利用可能なプロバイダーを接続してください。上限、可用性、利用規約は各プロバイダーが管理します。 > > 無料枠を手作業で組み合わせるのは大変です。何十ものSDK、何十ものレート制限があり、実際にどれだけ利用できるのかも分かりません。OmniRouteは、**繰り返し利用可能な35個のプールキーにまたがる489件の無料枠エントリ**をカタログ化し、**公開済みの月間予算が正の値である17個のプールと、モデルごとに設定された5つのGroq上限**から、共有プールの重複を排除してトークン総数を算出します。地域IDの確認後にのみ利用可能になる割り当て（現時点ではModelScope）は別枠として表示され、地域ID確認後に約600万トークンが追加されますが、見出しの合計には一切含まれません。算出結果はダッシュボード（`/dashboard/free-tiers`）で常時確認できます。

OmniRouteの無料枠予算カード：通常は月間約16.2億無料トークン、サインアップクレジットを含む初月は最大約22.2億トークン。1つのエンドポイントを通じて、文書化された繰り返し利用可能な35個のプールキーと、カタログ化された489件の無料枠エントリを利用できます。共有プールごとに重複を排除した正確な計算で、公開済みの月間トークン予算が正の値である17個の繰り返し利用可能なプールと、モデルごとに設定された5つのGroq上限を含め、各共有プールを1回だけ計上します。利用規約リスクカタログでは13のプロバイダーが回避対象としてマークされており、利用するかどうかはご自身で判断できます。予算バーには、Mistralの10億、Naraの2.1億、LLM7の1.5億、xKiroの1.5億、Groqの3,000万（モデルごとの5つの上限）および小規模なプールが含まれます。さらに、初月のサインアップクレジットと、トークン上限のない永続無料プロバイダーは個別に表示されるため、見出しの数値を水増しすることはありません。使用済みおよび残りの割り当ては/dashboard/free-tiers/でリアルタイムに確認できます。

> 実際の`/dashboard/free-tiers`ページの概要アニメーション。完全な算出方法（プールの重複排除、クレジット階層、プロバイダーの利用規約）：**[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**。 > > _{これらの数値は、実際のカタログに照らして2週間ごとに再監査され、**増減の両方向に変動します**。プロバイダーが無料枠を終了すれば数値は下がり、新しい無料枠が追加されれば上がります。切り上げた最良ケースではなく、カタログが実際に算出した数値を公開しています。}

⭐ OMNIROUTEで費用を節約でき、作業が楽になったら、リポジトリにスターを付けてください。

[![スター](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![スター履歴ランキング](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 コミュニティに参加 **👋 メンテナーをフォローして、新しいプロバイダー、リリース、ヒントの情報をいち早く入手しましょう：** [![LinkedInでDiegoをフォロー](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![GitHubで@diegosouzapwをフォロー](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp グローバル](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp ブラジル](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![ウェブサイト](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **質問、プロバイダー情報、ロードマップ、サポート → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 グローバル](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 ブラジル](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [ポータル](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 ゲートウェイは成長を続けています

| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | ------------------------------- | :-----------------------: | :---------: | :-------------------: | | 🌐 プロバイダー | 352 | **358** | 372 | | 🧠 一意のチャットモデル ID | 1320 | **1374** | 1443 | | 🖼️ モダリティブリッジ | 🆕 ビジョン + 音声 + 動画 | ✓ | ✓ | | 📡 Radar 無料カタログ | 🆕 オプトイン | ✓ | ✓ | | ⚖️ クォータ対応スケジューリング | 🆕 クォータ共有 | ✓ | ✓ | | 📊 クォータテレメトリー | 🆕 リアルタイム | ✓ | ✓ | | 🧰 ヘッドレスモード | — | — | 🆕 `serve --headless` | | 🛤️ LTS 系列インフラ | — | — | 🆕 リリースチャンネル | **→ [ロードマップ](ROADMAP.md) — `v3.9.0 LTS` に向けて進行中**

## 🧩 利用可能 [![npm バージョン](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM 月間ダウンロード数](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![ライセンス: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker プル数](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron ダウンロード数](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 はじめる	🚀 クイックスタート	📦 インストール	🆓 設定不要
💡 学ぶ	💥 お約束	🤔 OmniRouteを選ぶ理由	🏆 OmniRouteの特長
⚙️ 機能	🎯 コンボ	🌐 プロバイダー	🔌 CLI & MCP
	🗜️ 圧縮	🖥️ 実行環境	🔒 プライベート
👀 見てみる	🎬 実際の動作	✨ 新着情報	🤖 対応CLI
💚 支援	💚 支援 / 寄付	💬 コミュニティ	💖 スポンサー
📦 プロジェクト	🛠️ 技術スタック	📖 ドキュメント	👥 コントリビューター

🌐 67言語に対応

## 🆓 インストールしてプロバイダーを接続し、1つのエンドポイント経由でルーティング

3つのステップ：OmniRouteをインストールして起動し、自分のアカウントまたはAPIキーで対象プロバイダーに接続してから、OmniRoute APIキーとモデルautoを使用してツールの接続先をlocalhost:20128/v1に設定します。ルーティングは、利用可能な対象接続とプロバイダーの制限によって決まります。

```bash # プロバイダーに接続した後、Dashboard → EndpointsからOmniRouteキーをコピーします： curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto`には対象となるルートが必要です。新規インストール直後は、対象となるキーレス接続先が存在しない場合があり、キーレスプロバイダーがサードパーティ製クライアントを拒否することもあります。OpenCode FreeやKiroなど、`tos: avoid`と記されたプロバイダーは、デフォルトで自動ルーティングから除外されます。アカウントを接続しても、この設定は上書きされません。プロバイダーを選択する前に、[無料枠ガイド](docs/getting-started/FREE-TIERS-GUIDE.md)を参照してください。} _{📦 **Python、Node.js、PHP、cURL**向けのコピー＆ペースト可能なクイックスタートスクリプト → [`examples/quickstart/`](examples/quickstart/)}

# 💥 お約束すること

# 🤔 OmniRouteを選ぶ理由

OmniRouteのリクエストフロー：IDEまたはCLI（Claude Code、Cursor、Clineなど）が1つのローカルエンドポイント（http://localhost:20128/v1）を呼び出します。OmniRoute Smart Router（RTK + Caveman圧縮、19のルーティング戦略、サーキットブレーカー、TLSステルス、MCP、A2A、ガードレール）は、対象となる正常な接続先が存在する間、4つのプロバイダー階層を横断してフォールバックできます — Tier 1 サブスクリプション、Tier 2 APIキー、Tier 3 低コスト、Tier 4 無料。

## 🤝 オープンソースフレンドによるサポート

> **オープンソースフレンドとして参加しませんか？** これらの企業はオープンソースを支援し、OmniRouteの活動を継続するのに役立っています。そして、私たちは彼らが提供するすべてのトークンがどこに使われるかを公にしています。ご連絡ください: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} このプロジェクトを支援してくださる、創設オープンソースフレンドであるKimi (Moonshot AI)に感謝いたします！Kimiは、オープンウェイトのK2およびK3モデルファミリーを開発するAIラボです。Kimi K3は、1Mトークンのコンテキストウィンドウ、ネイティブビジョン、フロンティアレベルのコーディングを、クローズドモデルのわずかな価格で提供し、Claude Code、Codex、およびOmniRouteが提供するすべてのコーディングツールとすぐに連携します。

Kimiのサポートがもたらすもの: KimiのAPIクレジットは、OmniRouteのAI検証済みリリースパイプライン（すべてのプルリクエストが出荷される前にレビューされるKimi K3によるマージ検証ステージ）と、日々の機能開発を支えています。ファーストクラスのKimiサポートは、直接のKimi API（kimi-k3）とKimi Codeコーディングプラン（OAuthおよびAPIキー）の両方で提供されます。OmniRouteは、Kimiのサポートプログラムにおける最初のブラジル製オープンソースプロジェクトでもあります。15%追加クレジット付きのKimi APIキーを入手 →

Cheaper Inference
_{cheaperinference.com} このプロジェクトを支援してくださる、OmniRouteのオープンソースフレンドであるCheaper Inferenceに感謝いたします！Cheaper Inferenceは、42のフロンティアモデル（Claude、GPT-5.x、Gemini、Kimi K3、GLM、DeepSeek、Grok、MiniMax）を1つのOpenAI互換エンドポイントの背後で再販する、コストランク付けされたゲートウェイです。各リクエストを最も安価な適格プロバイダーにルーティングし、モデルメーカーの定価を超える料金を請求することはありません。

OmniRouteでのファーストクラスサポート: チャット補完、ネイティブの/v1/responsesエンドポイント、ビジョン、ツール呼び出し、および3つの画像モデル（grok-imagine、nano-banana-pro、nano-banana-2、cheaperinference/<model>としてアクセス可能）。APIキーを入手 →

_{aff=omnirouteタグ付きのリンクはパートナーリンクです。これらは追加費用なしでプロジェクトに資金を提供します。}

_{🎟️ アフィリエイトプロモーション — スポンサーではないプロバイダーからの無料登録クーポン（クリックで展開）}

_{このセクションは紹介/クーポンコードのみを対象としています。スポンサーシップパートナーシップは上記の🤝 オープンソースフレンドによるサポートに記載されています。OmniRouteはここに記載されているプロバイダーとのスポンサーシップやパートナーシップは一切ありません。これらは誰でも利用できる公開クーポンです。}

_AgentRouter
_{agentrouter.org} _{AgentRouter — アフィリエイト登録 · 登録時に$100の無料クレジット（無料サーバー、レイテンシが高くなる可能性があります — 本番環境ではなくテストに最適）。OmniRouteではv3.8.50以降、チャット補完、Anthropic互換のワイヤーフォーマット、OpenAI互換パスでファーストクラスのサポートを提供。利用可能なモデルにはclaude-opus-4-8、claude-opus-5、gpt-5.6-solなどがあります。$100を獲得 →}

_{⚠️ アフィリエイトリンク — OmniRouteはこのプロバイダーとのスポンサーシップやパートナーシップはありません。}

_{OmniRouteユーザーに利益をもたらす、寛大な無料登録クーポンを提供する他のプロバイダーをご存知ですか？イシューをオープンしていただければ、ここに追記します。}

## 🎯 コンボ — フラッグシップ機能

19種類すべてのコンボルーティング戦略のアニメーション — 戦略ごとに1つのタイル：priority、fill-first、weighted、round-robin、p2c、least-used、random、strict-random、cost-optimized、headroom、reset-window、reset-aware、context-relay、context-optimized、cache-optimized、lkgp、auto、fusion、pipeline。それぞれの動作については上の表を参照してください。

> **コンボ**とは、OmniRouteがモデル間を**自動的に**ルーティングするチェーンです。クォータを使い切った場合、プロバイダーで障害が発生した場合、またはコストが急増した場合、コンボは条件を満たす次の正常なモデルへ移行できます。🛡️ ### ⚡ 設定不要 — `auto`を使うだけコンボを作成する必要はありません。モデルを`auto`（またはそのバリエーション）に設定すると、OmniRouteが接続済みのプロバイダーから仮想コンボを構築し、リアルタイムでスコアリングします：

モデルID	最適化の対象
`auto`	🎯 バランスの取れたデフォルト（LKGP — 最後に正常だったプロバイダーを継続使用）
`auto/coding`	🧑💻 コード生成向けの品質優先ウェイト
`auto/fast`	⚡ レイテンシが最も低いものを優先
`auto/cheap`	💰 トークン単価が最も安いものを優先
`auto/offline`	🔋 クォータ／レート制限の余裕が最も大きいものを優先
`auto/smart`	🔭 品質優先 + より優れたモデルを発見するための10%の探索
`auto/lkgp`	📌 最後に正常だったプロバイダーへの明示的な固定
`auto/chaos`	🧪 モデルのパネル（プロバイダーごとに1つ、デフォルトでは5つ）へ並列にファンアウトし、1つの回答を返します。上流呼び出しはパネルモデルごとに1回であり、フォールトインジェクションではありません

## ### 🔀 または独自に構築 — 19種類のルーティング戦略 **19種類**すべての戦略を、コンボのステップごとに自由に組み合わせられます：

#	戦略	動作
1	`priority`	最初のターゲットを優先する順序付きリスト — 各ターゲットを使い切ってから次へ移行 🥇
2	`fill-first`	次へ移行する前に、各ターゲットのクォータを完全に使い切る
3	`weighted`	ターゲットごとのウェイトに基づく重み付きランダム選択
4	`round-robin`	ターゲットを順番に巡回
5	`p2c`	2つの候補から選択するランダム負荷分散
6	`least-used`	現在の負荷が最も低いターゲットを選択
7	`random`	一様ランダム選択（重複を除外）
8	`strict-random`	繰り返しの重複を除外せずにランダム選択 🎲
9	`cost-optimized`	最新のカタログ価格に基づいてリクエストあたりのコストを最小化 💸
10	`headroom`	残りのクォータが最も多いターゲットを選択
11	`reset-window`	クォータ期間が最も早くリセットされるターゲットを優先
12	`reset-aware`	クォータのリセット時間で順位付け — 短い期間を優先 📊
13	`context-relay`	長い会話のコンテキストをターゲット間で引き継ぐ 🧠
14	`context-optimized`	現在のコンテキストサイズに最も適したターゲットを選択
15	`cache-optimized`	再利用可能な各プロンプト接頭辞を同じアカウントに固定 — プロンプトキャッシュのヒット率を最大化 🎯
16	`lkgp`	最後に正常だったパス（Last-Known-Good Path）— 最後に成功したプロバイダーに固定し、その後ルールにフォールバック
17	`auto`	すべての接続を対象とした16要素のリアルタイムスコアリング 🤖
18	`fusion`	モデルのパネルへファンアウトし、判定モデルが1つの回答に統合 🧬
19	`pipeline`	ステップを連結 — 各ターゲットの出力を次のターゲットへ入力 🔗

_{Auto-Comboエンジンは、すべての候補を**16の要素**（正常性、クォータ、コスト、レイテンシ、タスク適合度、品質、セッション可用性など）でスコアリングします — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)を参照してください。} ## ### 🧱 レジリエンスを標準搭載（独立した3つのレイヤー）

OmniRoute のレジリエンス — 3つの独立した自己修復レイヤーにより、障害ごとに適切なレイヤーで対処します。レイヤー1：プロバイダーのサーキットブレーカー（プロバイダー全体）。408/5xx の場合にのみ作動し、しきい値は OAuth 8回 / API-key 12回 / local 2回です。60s/30s/15s 後に HALF-OPEN のプローブ状態へ移行し、遅延回復します。OPEN の間、コンボは次のプロバイダーへ再ルーティングします。レイヤー2：接続クールダウン（1つのキー/アカウント）。基本時間は OAuth 5s / API-key 3s で、サンダリングハード防止機構を備えた指数関数的な ×2 バックオフを使用します。429 では Retry-After に従い、成功するとすべてのエラー状態がクリアされます。クールダウン中のキーはスキップされますが、同じグループの他のキーは処理を継続します。レイヤー3：モデルのロックアウト（1つのモデル）。モデル単位の 429、local の 404、またはモード拒否では、そのモデルだけがロックされ、接続全体がロックされることはありません。終端状態（禁止、期限切れ、クレジット枯渇）はクールダウンではなく、オペレーターによる対応が必要です。

_{📖 [自動コンボエンジン](docs/routing/AUTO-COMBO.md) · [レジリエンスガイド](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 OmniRoute が他と一線を画す理由

_{📊 9router、OpenRouter、CLIProxyAPI、LiteLLMとの比較に関する完全な評価方法 & 機能ごとの詳細 → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 OmniRoute を支援する OmniRoute は MIT ライセンスで公開され、オープンに保守されています。時間や費用の節約に役立った場合は、独立性を維持するために、ご自分に合った方法でご支援ください。スポンサーシップがルーティングの優先順位に影響することはありません。得られるのは可視性であり、順位ではありません。

⭐ リポジトリにスターを付ける	無料 — 可視性の向上に本当に役立ちます	OmniRoute にスターを付ける
🐙 GitHub Sponsors	単発または月額 · プラットフォーム手数料なし	github.com/sponsors/diegosouzapw
☕ Ko-fi	手軽な単発支援、支援者の登録は不要	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	少額で気軽な支援	buymeacoffee.com/diegosouzapw
🖐 Liberapay	継続支援 · 非営利 · オープンソース	liberapay.com/diegosouzapw
🇧🇷 PIX（ブラジル）	即時、手数料なし	キーと QR は以下
₿ 暗号資産	BTC · ETH · USDT-TRC20 · USDC-Solana	アドレスは以下

**🇧🇷 PIX** — 即時、手数料なし（ブラジル） OmniRoute の PIX QR コード

キー（ランダム）：`5d865059-bc44-483a-962d-43ceb80126eb` Pix コピー＆ペースト： ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ 暗号資産 — BTC · ETH · USDT-TRC20 · USDC-Solana（クリックして展開）

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ 各コインは、表示されているネットワークでのみ送金してください。誤ったネットワークで送金すると、資金を失う可能性があります。}

🐛 バグを見つけた場合やフィードバックがある場合は、[Discussion](https://github.com/diegosouzapw/OmniRoute/discussions) を作成してください。

開発者向け注記： このプロジェクトでは、開発者の利便性のため、npm install/postinstall の実行中にローカルの .env ファイルが生成される場合があります。このファイルは意図的に .gitignore 経由で無視されており（.gitignore を参照）、決してコミットしてはなりません。誤ってコミットした場合は、露出したシークレットをすべてローテーションし、履歴からそのファイルを削除してください。ローカル環境ファイルとシークレットの管理方法については、docs/DEVELOPER-ENVIRONMENT.md を参照してください。

## 📡 OmniRoute Radar 無料枠の主な目安は、上記のドキュメント化されたプール重複排除済みカタログに基づき、引き続き**月間約1.62Bトークン**です。プロバイダーの一時的なサインアップクレジットにより、初月は別途**約2.22B**まで増える可能性があります。Radarは、OmniRouteのリリース間でも無料モデルの提供状況をより最新の状態で把握したい方のための、署名付きカタログオーバーレイです。利用は任意であり、コミュニティカタログおよび既存のすべての無料機能は、引き続き無料です。サポーターは、ライブカタログと追加のプロバイダー利用機会を受け取ることができます。この枠は独立して変動し、プロバイダーの提供状況に応じて、上限は**最大で月間約3Bトークン**です。この上限は保証されるものではありません。プロバイダーは、割り当て量、利用資格、モデル、または対象地域をいつでも変更できます。 Radarはオプトイン方式で、GETリクエストのみを使用します。OmniRouteクライアントが、プロンプト、トラフィック、プロバイダー設定、使用状況テレメトリ、またはローカルのお知らせ非表示状態をアップロードすることはありません。利用資格と現在のカタログについては、**[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**をご覧ください。

## ✨ 新機能

> **v3.8.20 → v3.8.50** の最近のハイライト。完全な履歴は [`CHANGELOG.md`](CHANGELOG.md) を参照してください。 - **🎛️ OmniConductor** — エージェント群への受信 A2A 委任、Agent Card 上の Conductor スキル、Faro のプッシュ・トゥ・トーク音声チャットを備えたダッシュボードパネル。→ [A2A サーバー](docs/frameworks/A2A-SERVER.md) - **🛂 適応型アドミッション制御と過負荷保護** — 高負荷なチャットリクエストは 503 を返す代わりにキューへ入り、接続ごとにアトミックな RPM ローリングリースを使用。→ [レジリエンスガイド](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ 正規化された `/v1/models` の順序** — プロバイダーごとに連続したプロバイダー別ブロックを1つ配置（コンボを先頭に固定）し、すべてのカタログソースで順序を安定化。→ [API リファレンス](docs/reference/API_REFERENCE.md) - **🗜️ 圧縮の堅牢化** — デフォルト有効の展開ガード、DE / FR / JA + 中国語（文言）の Caveman パック、Gradle と .NET 向けの RTK フィルター。→ [圧縮](docs/compression/COMPRESSION_ENGINES.md) - **💸 正確な定額料金コスト** — サブスクリプション／コーディングプランのプロバイダーは、コスト分析で **$0** として表示。予算、クォータ、ルーティングでは引き続き推定を実施。→ [API リファレンス](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share ルーティング** — 共有アカウントのクォータをプールされたキー間で公平に分割し、未使用の割り当てを貸し出すことで処理能力を無駄なく活用。→ [レジリエンスガイド](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 1コマンドでの CLI／エージェント設定** — 登録済みの `setup-*` コマンドは13個。`omniroute run` は7つの CLI（Claude Code、Codex、Aider、Goose、OpenCode、Qwen Code、Gemini CLI）を起動。`omniroute configure` は、対話式のプロバイダー＋モデル選択とコンテキストごとのお気に入り機能を備え、10のターゲットに対応。→ [CLI 統合](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ リモートモード** — スコープ付きトークン（`connect` / `contexts` / `tokens`）と VPS インストール向けの `antigravity` OAuth ヘルパーを使用して、リモートの OmniRoute を操作。→ [リモートモード](docs/guides/REMOTE-MODE.md) - **🧭 よりスマートな自動ルーティング** — `auto/:` コンボ、**Fusion**（モデルパネル＋ジャッジ）、タスク対応ルーティング、リクエストごとのモデル／モード／USD 予算オーバーライド。→ [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ プラグイン可能な圧縮** — 12種類の合成可能なエンジン＋Compression Studios：LLMLingua-2、2段階 Ultra、omniglyph、ステップごとの忠実度ゲート、GCF v3.2、ドラッグによる並べ替えエディター。→ [圧縮](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ 透過的な MITM 復号（TPROXY）** — SNI ごとの CA とトラストストアインストーラーを使用して、プロキシ環境変数を無視する CLI を捕捉。→ [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 あらゆる場所でのコストテレメトリ** — すべてのエンドポイントに `X-OmniRoute-*` コスト／使用量ヘッダー、キャッシュ HIT による節約額ヘッダー、キーごとの USD 支出クォータを追加。→ [API リファレンス](docs/reference/API_REFERENCE.md) - **🧠 自分で制御できるメモリ** — デフォルトでは無効。オプトインの int8 ベクトル量子化＋型付き減衰、リクエストごとの `x-omniroute-no-memory`。→ [メモリ](docs/frameworks/MEMORY.md) - **🛡️ セキュリティ** — すべての LLM ルートにプロンプトインジェクションガード（レッドチームスイート）を適用。オプトインの認証情報マスキングガードレール（双方向で漏えいした API キー／シークレットを秘匿化）、無料の最終手段となる DuckDuckGo ウェブ検索、ダッシュボード向けのオプションの OIDC ログインゲート（パスワードログインは常に利用可能）。→ [ガードレール](docs/security/GUARDRAILS.md) - **🖼️ 新しいエンドポイント** — `/v1/ocr`（Mistral OCR）と `/v1/audio/translations`（Whisper 形式）により、メディア機能をさらに拡充。→ [API リファレンス](docs/reference/API_REFERENCE.md) - **🎨 画像／動画／音声生成** — メディア向けの統一 API：xAI Grok Imagine と Novita AI video、ComfyUI、Magnific、Adobe Firefly、Segmind、および ElevenLabs などの音声プロバイダー。→ [API リファレンス](docs/reference/API_REFERENCE.md) - **🌍 デプロイと運用** — リバースプロキシの `basePath`、ブラウザー言語の自動検出、キーごとのデバイス追跡、root 不要の MITM 信頼設定、zh-TW ローカライズ。→ [環境](docs/reference/ENVIRONMENT.md) - **🤝 さらに多くのプロバイダーとエージェント** — クラウドエージェント（Codex Cloud、Cursor、Devin、Jules）、ブラウザー＋OAuth ログインを備えた Grok Build（xAI）、ファーストクラスの Ollama カード、Claude Opus 5 と Sonnet 5、Kimi 公式パートナーシップ（Code/Web/Moonshot）、Zed、Requesty、SenseNova、Yuanbao、Agnes AI…さらに刷新された **352プロバイダーのカタログ**。→ [プロバイダー](docs/reference/PROVIDER_REFERENCE.md) - **📡 ルーティングの透明性** — すべてのレスポンスに、処理を担当した戦略／プロバイダー／レイテンシーを示す `X-OmniRoute-Decision` ヘッダーを付与。新しい `cache-optimized` コンボ戦略と Auto-Combo の `cacheAffinity` 係数により、繰り返しリクエストをキャッシュ済みプレフィックスを保持する接続へ戻すほか、読み取り専用の `/v1/auto-combo/{channel}/candidates` エンドポイントで `auto/*` チャンネルのライブ候補プールを公開。→ [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ ローカルパフォーマンスとインフラ** — ワンクリックのローカル Redis、Cloudflare Workers / Deno Deploy リレーデプロイヤー、監視対象の組み込みサービスとしての Bifrost と Mux。→ [組み込みサービス](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 そのほかの同梱機能** — プラグインフレームワーク＋マーケットプレイス、Omni/Agent/GitHub スキルフレームワーク、Obsidian Vault 統合（22個の MCP ツール）、OpenAI 互換の Batch API と Files API、セマンティックレスポンスキャッシュ、リーダーボード付きゲーミフィケーション、ACP エージェント検出（15個の組み込みエージェント）、BigQuery へのスケジュール済みログエクスポート、`auto/chaos` による複数モデルへの並列ファンアウト、Telegram ボットブリッジ、アプリ内バージョンマネージャー、LMArena-ELO の無料プロバイダーランキング。→ [ドキュメント](docs/README.md)

## 🤖 対応 CLI & コーディングエージェント > 設定は 1 つだけ — `http://localhost:20128/v1` — **すべての** AI IDE や CLI を無料・低コストのモデルで実行できます。

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋以下にも対応 · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · あらゆる OpenAI 互換ツール

_{📖 全36ツール（26個のCLI Code + 10個のCLI Agent）向けツール別セットアップ → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCodeプラグイン → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**サポートされている任意のCLIを、1つのコマンドでOmniRoute経由で起動** — 設定ファイルは書き込まず、認証情報はプロセスごとに注入され、Qwen/Geminiには使い捨ての分離されたホームディレクトリが割り当てられます。 ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # または、プロバイダーとモデルを対話形式で選択し、ツール独自の設定を書き込みます： omniroute configure codex # 対応ツール：claude opencode qwen aider goose gemini cline continue kilo ``` すべてのコマンドは、アクティブなリモートコンテキスト（`omniroute connect `）に従います。`--dry-run`では、実行せずに正確な環境変数と引数をプレビューでき、`--api-key-env NAME`を使えば秘密情報をシェル履歴に残さずに済みます。→ [CLI連携](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 372 の AI プロバイダー — うち 154 はカタログ上で無料と明記

> 正規のチャット、メディア、検索、ローカル、クラウドエージェント、システムの各コレクション全体で **372 の登録済みプロバイダー**があり、そのうち **154 には検出用メタデータ `hasFree: true` が付与されています**。チャットモデルレジストリには **237 プロバイダー / 3,009 の個別プロバイダー・モデルペア / 1,443 の未加工モデル ID** が含まれます。これとは別の無料枠カタログには、**モデル単位の 491 行**、**35 の定期更新プール**、および **54 の定期更新型またはキーレスの永久無料プロバイダー**があります。これらの分母は意図的に異なります。定義と、プールの重複を排除した計算については、[プロバイダーリファレンス](docs/reference/PROVIDER_REFERENCE.md)および[無料枠](docs/reference/FREE_TIERS.md)をご覧ください。

### 🏢 すべての主要ラボへ、単一のエンドポイントからアクセス

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…ほか 330 以上 — すべてのアイコンは、ダッシュボードのプロバイダーカタログからリアルタイムで取得されます。📖 [プロバイダーリファレンス](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 永久無料 — $0、カード不要

OpenCode Zen _{DeepSeek V4、Nemotron 3 トークン上限なし}	Kilo Code _{自動ルーター、Tencent Hy3 永久無料}	Requesty _{GPT-OSS 120B、Nemotron 永久無料}	SiliconFlow _{DeepSeek V3.2 / R1 無料枠}	Z.AI GLM _{GLM-4.7 / 4.5-Flash 永久無料}	Baidu ERNIE _{ERNIE 4.0 永久無料}
Qoder AI _{Qwen3-Max、Kimi-K2 無制限・無料}	Pollinations _{GPT、Llama、Claude キー不要}	Cloudflare AI _{50以上のモデル 1日あたり10Kニューロン}	NVIDIA NIM _{GLM、MiniMax 無料で約40 RPM}	Cerebras _{GLM 4.7、GPT-OSS 1回限りの$5クレジット（カード必須）}	OpenRouter _{:freeモデル +$10 → RPM引き上げ}

📖 機械可読形式の完全なカタログ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ OmniRoute の実行環境 — どこでも

> 同じアプリを、あなたのマシンで、あなたのルールに従って。グローバル npm インストールから、Termux を介した **あなたのスマートフォン** まで。

プラットフォーム	インストール	特長
📦 npm（グローバル）	`npm install -g omniroute`	1つのコマンドで、あらゆる OS に対応
🐳 Docker	`docker run … diegosouzapw/omniroute`	マルチアーキテクチャ対応：AMD64 + ARM64
🖥️ デスクトップ（Electron）	`npm run electron:build`	ネイティブウィンドウ + システムトレイ — Windows / macOS / Linux
🎩 メニューバー（OmniRouteTray）	`brew install --cask zoispag/tap/omniroute-tray`	サーバーの監視と自動更新 — macOS
💪 ARM	ネイティブ `arm64`	Raspberry Pi、ARM サーバー、Apple Silicon
📱 Android（Termux）	`pkg install nodejs && npx -y omniroute`	スマートフォン上で年中無休で動作、root 不要
📲 PWA	「ホーム画面に追加」	全画面表示、オフライン対応、ブラウザからインストール可能
🧩 OpenCode プラグイン	`@omniroute/opencode-provider`	OpenCode ネイティブ統合
🤖 VS Code Copilot Chat	OmniCopilot 拡張機能をインストール	OmniRoute のすべてのモデルをネイティブ Copilot Chat ピッカーで利用可能 — 安定版と Insiders に対応
🛠️ ソースから	`npm install && npm run dev`	カスタマイズやコントリビューションに

_{📖 [Docker ガイド](docs/guides/DOCKER_GUIDE.md) · [デスクトップ](electron/README.md) · [メニューバートレイ](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 新機能：VS Code のネイティブ Copilot Chat 内で OmniRoute を利用

> 新しいサイドバーも、新しいチャット UI も不要です。OmniRoute が提供するすべてのモデルが、 > **使い慣れた Copilot Chat のモデルピッカー**に直接表示されます。VS Code 1.122 以降では、プロバイダーモデルを > GitHub へのサインインや Copilot サブスクリプションなしで利用できます。エージェントモード、ツール呼び出し、ビジョン機能も > 無料です。 **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** 拡張機能をインストールし、OmniRoute サーバー（デフォルトは `localhost:20128`）を指定してから、Copilot Chat → モデルピッカー → **モデルの管理…** → **OmniRoute** を開きます。

ストア	リンク	対応環境
🧩 VS Code Marketplace	インストール →	VS Code — 安定版と Insiders
🔓 Open VSX Registry	インストール →	Cursor、Windsurf、VSCodium、Theia、code-server、Gitpod、Antigravity、Kiro…

エディター内から行う場合：**拡張機能**ビューを開き、**「OmniRoute」**を検索して、**インストール**をクリックします — どちらのストアでも同じように動作します。ソース、Issue、公開手順書は [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) にあります。 _{📖 [VS Code Copilot Chat ガイド](docs/guides/VSCODE-COPILOT.md) — セットアップ、ピッカーの表示内容、タブ内ダッシュボード、トラブルシューティング}

### 🎩 新機能：OmniRouteTray — メニューバーに常駐する、あなた専用のゲートウェイ

> `omniroute serve` は常時稼働させるのが最適です。**[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** は、 > それを一度設定すれば後は任せられる macOS 用メニューバーアプリに変えます。サーバーを起動して稼働状態を維持し、 > 再起動後も自動で復帰させ、その場で更新を行い、使用中のトークン予算をワンクリックで確認できます。**ターミナルウィンドウを > 開いたままにする必要も、`npm install -g omniroute` の面倒を見る必要もありません。** [Tauri v2](https://v2.tauri.app/)（誤差と言えるほど小さな Rust コア）で構築されており、署名済みの Node 24 ランタイムを同梱し、アプリ専用の OmniRoute インストールを管理するため、グローバルの `node`/`bun` と競合することはありません。**既存の `~/.omniroute/` 設定とデータベースを共有**するため、いつも実行しているものと同じ OmniRoute に、帽子をかぶせただけです。🎩

機能	仕組み
🟢 サーバーを監視	`omniroute serve` を起動し、すでに実行中のインスタンスがある場合は、重複して起動せずにそれを引き継ぎます
📊 使用状況をひと目で確認	プロバイダーのクォータバー、リセットまでのカウントダウン付き Claude セッション／週間上限、30日間のコスト内訳
🔄 その場で自動更新	段階的インストール、アトミックな切り替え、失敗時のロールバックにより、常に最新リリースを維持
🚀 ログイン時に起動	任意でログイン時に起動可能。トレイのみに常駐し、Dock アイコンは表示されません
🩺 診断とログ	ワンクリックで診断を実行し、サーバーログにアクセス

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{ダウンロードをご希望ですか？最新の.dmgは
Releasesから入手できます。ソースコード、Issue、ビルド
ドキュメントはzoispag/omniroute-trayにあります。

💛 @zoispagによるコミュニティプロジェクトです。OmniRouteの公式リリースではありません。}

## 🔒 プライベート＆ローカルファースト

プライベートかつローカルファースト — OmniRoute のゲートウェイとコントロールプレーンは、お使いのマシン上で動作します。プロンプトはリクエストごとに選択されたアップストリームプロバイダーへ送信されます。OmniRoute がホストするプロンプト処理の中継地点はなく、テレメトリはデフォルトで無効です。認証情報は保存時に AES-256-GCM で暗号化されます。セキュリティ制御には、API キーのスコープ設定、IP フィルタリング、レート制限、プロンプトインジェクション対策、アップストリームヘッダーの除去、オプトイン方式の PII 編集、サニタイズされたエラー、ローカル SQLite 監査証跡が含まれます。OmniRoute は MIT ライセンスで提供され、セルフホストできます。

_{📖 [認可](docs/architecture/AUTHZ_GUIDE.md) · [ガードレール](docs/security/GUARDRAILS.md) · [コンプライアンス](docs/security/COMPLIANCE.md)}

## 🔌 完全な CLI + A2A＆MCP

> OmniRoute はサーバーだけでなく、**80 以上のコマンド**を備えた**本格的なコマンドライン・コックピット**です。さらに、オープンなエージェントプロトコルにより、AI エージェントが**自律的に**操作できます。 ### ⌨️ 本格的な CLI（単なる `start` ではありません） ```bash omniroute # ゲートウェイ + ダッシュボードを起動（ポート 20128） omniroute chat # 対話型 TUI チャットクライアント（スラッシュコマンド：/model /combo /skill /memory） omniroute setup # ガイド付き初回セットアップウィザード omniroute doctor # プロバイダー、ポート、ネイティブ依存関係を診断 ``` ### 🛰️ リモートモード — CLI はここで、OmniRoute は VPS 上で実行 OmniRoute をサーバーで実行していますか？**同じ CLI** を使ってノート PC から操作できます。スコープ付きアクセストークンで一度ログインすれば、それ以降はすべてのコマンドがリモートを対象に実行されます。 ```bash omniroute connect 192.168.0.15 # パスワード → スコープ付きトークン、コンテキストとして保存 omniroute models list # ← リモートサーバーに対して実行 omniroute configure codex # ← リモートモデルを選択し、ローカルの Codex プロファイルを書き込み omniroute tokens create --name ci --scope read # 他のマシン向けに、より制限されたトークンを発行 omniroute contexts use default # ← ローカルサーバーへ切り替え ``` トークンには `read` / `write` / `admin` のスコープが設定されます。プロセスを起動するルートはループバック専用のままです。 _{📖 [リモートモード](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI のアニメーション付きターミナルデモ — omniroute providers list、omniroute combo list、omniroute health を実行 — providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate … など、86 コマンドからなるトップレベルインターフェースを順に表示

### 🤝 エージェントを接続 — OmniRoute 自体を制御 OmniRoute を **MCP**、**A2A**、**REST API**、**webhooks**、または**リモート CLI** 経由で公開できます。対応する任意のエージェント（または独自のコード）が、ルーティング、プロバイダー、コンボ、キャッシュ、圧縮、メモリなど、ゲートウェイ全体を自律的に操作できます。以下の HTTP エンドポイントは `http://localhost:20128` 配下で提供されます。

インターフェース	エンドポイント / コマンド	用途
🧰 MCP（stdio）	`omniroute --mcp`	Claude Desktop、Cursor、任意の MCP クライアントに接続
🌊 MCP（HTTP）	`/api/mcp/stream`	リモート MCP — 110 個のツール、33 個のスコープ（適用はオプトイン）、完全な監査証跡
📡 MCP（SSE）	`/api/mcp/sse`	ストリーミング MCP トランスポート
🤝 A2A	`/.well-known/agent.json`	エージェント間通信、JSON-RPC 2.0 + SSE、6 個のスキル
🌐 REST API	`/v1/*`	OpenAI 互換 — チャット、埋め込み、画像、音声、OCR
🔔 Webhooks	`/api/webhooks`	リクエスト / クォータイベントを Slack、Discord、Telegram、または任意の URL へプッシュ
🛰️ リモート CLI	`omniroute connect`	スコープ付きアクセストークンを使用してリモートインスタンスを操作

```bash # MCP 経由で OmniRoute の全ツールセットを Claude Code に提供： claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP サーバー](docs/frameworks/MCP-SERVER.md) · [A2A サーバー](docs/frameworks/A2A-SERVER.md) · [エージェントプロトコル](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ トークンを15～95%削減 — 自動で

### 📖 仕組み — パイプライン、アーキテクチャ、削減率の計算 OmniRoute圧縮パイプライン：10,000トークンのクライアントリクエストが、Session-Dedup、CCR、Lite、RTK、Responses Tool Output、Headroom、Relevance、Caveman、Aggressive、LLMLingua-2、Ultra、OmniGlyphという12個の組み合わせ可能なエンジンを通過し、文書化されたスタック例では約1,080トークンでプロバイダーに到達する様子を示しています。構造化コンテンツは保持ガードと各ステップの忠実度ゲートによって保護されます。明示的に指定された非可逆モードまたは実験的モードでは、対象となるコンテンツが変換される場合があります。

OmniRoute圧縮パイプライン：10,000トークンのクライアントリクエストが、Session-Dedup、CCR、Lite、RTK、Responses Tool Output、Headroom、Relevance、Caveman、Aggressive、LLMLingua-2、Ultra、OmniGlyphという12個の組み合わせ可能なエンジンを通過し、文書化されたスタック例では約1,080トークンでプロバイダーに到達する様子を示しています。構造化コンテンツは保持ガードと各ステップの忠実度ゲートによって保護されます。明示的に指定された非可逆モードまたは実験的モードでは、対象となるコンテンツが変換される場合があります。

デフォルトのスタック構成では、`RTK → Caveman`を実行します。両方が同じツール／コンテキストペイロードに作用する場合、削減効果は複合されます： ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` コードブロック、URL、JSON、構造化データは、保持エンジンによって**常に保護**されます。 > **少ないトークンで十分なら、なぜ多くのトークンを使うのでしょうか？** すべてのリクエストは、クライアント側の変更なしで、OmniRouteの圧縮パイプラインを**透過的に**通過します。現在では、順番に実行され、ルーティング構成ごとに自由に組み合わせられる**12個の組み合わせ可能なエンジンのスタック**になっています。[RTK](https://github.com/rtk-ai/rtk)、[Caveman](https://github.com/JuliusBrussee/caveman)（⭐ 90K+）、[LLMLingua-2](https://github.com/microsoft/LLMLingua)、[Troglodita](https://github.com/leninejunior/troglodita)（PT-BR）のアイデアを基盤としています。 ### 🧱 12エンジンのスタックエンジンはパイプライン順に実行され、それぞれを構成ごとに個別に有効化／無効化および設定できます：

#	エンジン	機能
1	Session-Dedup	ターン間で繰り返されるコンテンツを除去（コンテンツアドレス方式、ターン横断）
2	CCR	大きなブロックを取得マーカーの背後にアーカイブし、必要に応じて取得
3	Lite	空白文字と画像URLのトリミング（低レイテンシーのベースライン）
4	RTK	ツール結果のスマートなフィルタリング、重複排除、切り詰め（コマンド認識）
5	Responses Tool Output	シェル／パッチ／検索／ビルド出力向けの、ロスレス優先のJSON処理と上限付き診断圧縮（Responses API）
6	Headroom	同梱されたGCFコーデックによる、JSON配列のロスレスな表形式圧縮（約30%）
7	Relevance	直近のユーザークエリに対する抽出的な文スコアリング
8	Caveman	ルールベースの文章圧縮（出力で約65～75%）
9	Aggressive	要約と古いターンの段階的なエイジング
10	LLMLingua-2	MobileBERT ONNXによるMLセマンティック枝刈り — コードセーフ、非同期
11	Ultra	オプションの小規模モデル（SLM）階層を備えた、ヒューリスティックなトークン枝刈り
12	OmniGlyph	Anthropicへの直接接続上で計測済みのClaude Fable 5向け、実験的なコンテキスト画像化エンコーディング。GPT 5.6トランスフォーマーについては、プロバイダーの受領確認が得られるまでフェイルクローズを維持。4つの圧縮プロファイル（デフォルトのaggressive、balanced、coding-safe、passthrough）（最も積極的、オプトイン）

コードブロック、URL、構造化データは、**常にバイト単位で完全に保持**されます。**ワンクリックプリセット**で各エンジンを組み合わせられます：

モード	削減率	最適な用途
🪶 Lite	約15%	常時有効にできる安全なデフォルト
🪨 Standard (Caveman)	約30%	日常的なコーディング
⚡ Aggressive	約50%	ツール使用の多い長時間セッション
🔥 Ultra	約75%	最大限の削減
🧰 RTK	60～90%	シェル／テスト／ビルド／gitの出力
🔗 Stacked (RTK → Caveman)	78～95%	プロンプトとツールログが混在する場合

**実例 — Standardモード：** > **圧縮前（69トークン）：** _「Reactコンポーネントが再レンダリングされるのは、各レンダリングサイクルで新しいオブジェクト参照を作成していることが原因と考えられます。インラインオブジェクトをpropとして渡すと、Reactの浅い比較では毎回異なるオブジェクトと見なされ、再レンダリングが発生します。useMemoを使ってオブジェクトをメモ化することをお勧めします。」_ > > **圧縮後（19トークン）：** _「レンダリングごとに新しいオブジェクト参照。インラインオブジェクトprop = 新規参照 = 再レンダリング。useMemoでラップ。」_ > > **答えは同じ。トークンを72%削減。精度低下ゼロ。** ✅ **PT-BRの例 — [Troglodita](https://github.com/leninejunior/troglodita)モード：** > **変更前（42トークン）：** _「問題は、レンダリングのたびに新しいオブジェクト参照が作成されるため、コンポーネントが再レンダリングされていることです。`useMemo`の使用をお勧めします。」_ > > **変更後（12トークン）：** _「再レンダリング：毎回新規参照（インラインオブジェクトを再作成）。`useMemo`を使用。」_ > > **同じ回答。トークンを約70%削減。技術的な正確性はそのまま。** ✅
### 🎚️ エンジンの先へ — 出力スタイル、適応型ダイヤル、リクエスト単位の制御上記の12個のエンジンは、**入力されるもの**を圧縮します。さらに3つのレイヤーが、**どのように**、**いつ**、そして何が**出力されるか**を調整します。 - **🪄 出力スタイル** _(出力軸の制御)_ — 決定論的でキャッシュセーフな応答整形指示を注入します。組み合わせ可能で、それぞれ `lite` / `full` / `ultra` の強度を選択できます。スタイルの追加は、レジストリに1行加えるだけです。 - **簡潔な文章** — 冗長表現、冠詞、曖昧な言い回しを削除し、技術的な内容は正確に維持します。 - **少ないコード** — 「怠惰なシニア開発者」式のYAGNI：動作する最小限の変更にとどめ、要求されていない足場は作りません。 - **ポニーテール（怠惰なシニア開発者）** — YAGNIの段階を上り、根本原因を修正し、動作する最小限の差分にします。 - **ADHDです（行動優先）** — 次のアクションを先に示し、手順には番号を付け、具体的な次の一歩を1つ提示し、前置きは省きます。 - **簡潔なCJK（文言）** — 漢文調の極めて簡潔なスタイル（ロケールが `zh` の場合のみ）。 - **🎯 適応型コンテキスト予算** _(ダイヤル)_ — 単一のオン／オフ式トークンしきい値の代わりに、モデルのコンテキストウィンドウに**収まる**まで、最も低コストで損失の少ないエンジンだけを必要な範囲で段階的に適用します。ポリシー：`reserve-output`（デフォルト、モデル対応）· `percentage` · `absolute`。モード：`floor`（収まることを保証）· `replace-autotrigger`（明示した選択を優先）· `off`（従来のしきい値）。 - **🎛️ 圧縮の決定箇所** _(優先順位、高 → 低)_ — リクエスト単位の `x-omniroute-compression` ヘッダー › ルーティングコンボのオーバーライド › 有効な名前付きプロファイル › 適応型／自動トリガー › パネルのデフォルト › オフ。適用されたプランは、`X-OmniRoute-Compression: ; source=` レスポンスヘッダーで返されます。トークンしきい値による自動トリガー、適応型ダイヤルの有効化、名前付きプロファイルの固定、リクエスト単位の一時設定、ルーティングコンボ単位のパイプライン割り当てなど、ワークロードに合う方法を選べます。オプトイン式のオフライン**評価ハーネス**（`npm run eval:compression`）では、変更を昇格させる前に、固定コーパス上で忠実度と削減量を評価できます。 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ クイックスタート

**1）インストールして実行** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` やpeer dependencyの警告が表示されますか？[問題ありません](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)。 > **npm 11以降を使用していますか？** npmでは、許可されていないパッケージライフサイクルスクリプトがブロックされる場合があります。OmniRouteの `postinstall`（`node scripts/build/postinstall.mjs`）は、ネイティブランタイムファイルの準備に必要です。グローバルインストール時に、npmの警告に記載されたパッケージを許可してください。OmniRoute 3.8.51で報告されるパッケージセットの場合： > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > 今後のグローバルインストールでもこの許可リストを再利用するには、一度設定してから通常どおりインストールします。 > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > 依存関係の一覧はリリース間で変更される場合があります。npmが異なる一覧を報告した場合は、その警告に記載されたパッケージ名を使用してください。パッケージを許可すると、そのインストールスクリプトの実行が許可されます。 > **Gemini Webや別のWeb Cookieプロバイダーを使用していますか？** npmパッケージには > Playwrightが含まれていますが、Chromiumバイナリは含まれていません。最初のWebプロバイダーリクエストを行う前に、 > [Playwright Chromiumのセットアップ](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > に関する注意事項を確認してください。ダッシュボード：`http://localhost:20128` · API：`http://localhost:20128/v1` **2）自分のアカウントを使用して、利用資格のあるプロバイダーに接続** ダッシュボード → **プロバイダー** → 現在の利用規約とクォータが用途に合うプロバイダーを選択 → APIキーを追加するか、アカウント連携フローを完了します。無料枠では、登録、承認、または支払い方法が必要になる場合があります。[無料枠ガイド](docs/getting-started/FREE-TIERS-GUIDE.md)を確認してください。キー不要での利用は保証されず、`tos: avoid` と記されたプロバイダーはデフォルトで `auto` から除外されます。 **3）コーディングツールの接続先を設定** ```txt ベースURL： http://localhost:20128/v1 APIキー： [ダッシュボード → エンドポイントからコピー] モデル： auto （利用可能な接続間でルーティング。プロバイダー／モデルの指定も可能） ``` **4）動作を確認** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` 接続済みモデルの一覧が表示されれば完了です。🎉 これでコーディングを開始できます。OmniRouteが自動的にルーティングし、必要に応じてフォールバックします。クライアントがカスタムヘッダーを送信できない場合、OmniRouteはトークン付きの互換エイリアスも公開しています。 ```txt OpenAIカタログ： http://localhost:20128/vscode/YOUR_KEY/ OpenAIモデル： http://localhost:20128/vscode/YOUR_KEY/models OpenAIチャット： http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAIレスポンス： http://localhost:20128/vscode/YOUR_KEY/responses Ollamaチャット： http://localhost:20128/vscode/YOUR_KEY/api/chat Ollamaタグ： http://localhost:20128/vscode/YOUR_KEY/api/tags ``` これらは、`Authorization: Bearer ...` を付与できないクライアントでのみ使用してください。引き続きヘッダー認証が推奨方式です。
## 📦 その他のインストール方法 — Docker、ソース、pnpm、Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` は、**公開済み**の安定版 SemVer のうち最も高いバージョンを指します。git の `main` は追跡しません。GitOps では `:X.Y.Z` に固定してください。[Docker リリースチャンネル](docs/guides/DOCKER_GUIDE.md#release-channels)を参照してください。このイメージでは **`OMNIROUTE_MEMORY_MB=1024`** に固定されています。これはダッシュボードと軽量なチャットには十分です。**コーディングエージェント**（Claude Code、Codex、Grok などからの `POST /v1/responses`）には、はるかに大きな V8 ヒープが必要です。そうでない場合、2 つの長いコンテキストが重複すると約 12 GiB でプロセスが `FATAL ERROR` になります。ネイティブバッファは V8 の外部に配置されるため、コンテナのサイズはヒープより大きく設定してください。 | ワークロード | ヒープ（`-e OMNIROUTE_MEMORY_MB`） | コンテナ（`--memory`） | | ------------------------------------------ | ---------------------------------- | ---------------------- | | ダッシュボード／軽量なチャット | `1024`（イメージのデフォルト） | ≥2 g | | 1 つのコーディングエージェント | `8192` | ≥10 g | | 2 つの長時間実行される同時 `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` 完全な表：[Docker ガイド — ランタイム RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents)。 > **プレリリース Docker チャンネル：** `diegosouzapw/omniroute:next` と > `diegosouzapw/omniroute:next-web` は、現在のデフォルトの `release/v*` > ブランチを追跡します。これらの可変タグは、未リリースの修正をテストする目的にのみ使用するものであり、 > **本番環境ではサポートされません**。詳しくは > [Docker リリースチャンネル](docs/guides/DOCKER_GUIDE.md#release-channels)を参照してください。 **🥟 Bun** Bun ランタイムの検出により、標準の `bun install` とグローバルインストール（`bun install -g omniroute`）がサポートされています。 - **組み込みの `bun:sqlite`**：OmniRoute は Bun 上で実行されている場合、Bun 組み込みの `bun:sqlite` ドライバーを使用し、Node.js では `better-sqlite3` または `sql.js` にフォールバックします。 - **開発時の Webpack バンドラー自動選択**：開発環境（`bun run dev`）では Bun を自動的に検出し、ネイティブ V8 バインディングの非互換性を防ぐため、Turbopack を無効にして Webpack を使用します。本番ビルド（`bun run build`）では、Node とまったく同様に `OMNIROUTE_USE_TURBOPACK` に従います。デフォルトでは Turbopack を使用し、`OMNIROUTE_USE_TURBOPACK=0` を指定すると Webpack でビルドします（`Dockerfile.bun` では `--build-arg` として公開されています）。 - **専用の Bun Dockerfile**：ネイティブ Bun 本番デプロイ用のマルチステージ `Dockerfile.bun`（`docker build -f Dockerfile.bun -t omniroute:bun .`）。 ```bash # Bun でインストールして実行 bun install bun run dev ``` **🛠️ ソースから** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux（AUR）** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix（Flake）** ```bash # Nix flakes を使用 nix develop npm run dev # または devbox を使用 devbox run npm run dev ``` 📖 [Docker ガイド](docs/guides/DOCKER_GUIDE.md) — Compose プロファイル、Caddy HTTPS、Cloudflare トンネル。 **🦭 Podman** ```bash # 1. バインドマウントするデータディレクトリを準備 mkdir -p data # 2. Linux + ローカルのルートレス Podman のみ（リモートの Podman Machine クライアントでは決して実行しないでください）： podman unshare chown 1000:1000 ./data # 3. ランタイムヒントを設定し、ローカルの Compose イメージをビルドして起動 echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS または Windows では、Podman はリモートの Podman Machine を使用します。`podman unshare` を省略し、 [トポロジー別のデータディレクトリに関するガイダンス](contrib/podman/README.md#data-directory-permissions-by-topology)に従ってください。 📖 [Podman ガイド](contrib/podman/README.md) — Compose ビルド、Podman Machine、および Linux/systemd Quadlet のセットアップ。 **⚡ より高速／軽量なインストール（ネイティブビルドを省略）** ネイティブ SQLite エンジン（`better-sqlite3`）は**オプション**の依存関係であるため、グローバルインストールがソースからのコンパイルでブロックされることはありません。プラットフォーム／Node に適合するビルド済みバイナリがある場合はそれを使用し、ない場合は透過的に純粋な JS エンジン（Node 22+ では `node:sqlite`、それ以外では同梱の `sql.js` WASM）にフォールバックします。ビルドツールは不要です。インストール後のネイティブウォームアップを完全に省略するには（CI、ヘッドレス環境、または低速なマシン）： ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 でも省略されます ``` 最速でインストールするには、**pnpm**（コンテンツアドレス方式のストア + ハードリンク — 上記参照）を推奨します。ダッシュボードを使用しないヘッドレスランタイムには、Docker の `base` プロファイル（上記）または [Termux ガイド](docs/guides/TERMUX_GUIDE.md)を使用してください。CLI と Web ダッシュボードは同じプロセスから 1 つのポートで提供されるため、現時点では CLI 専用パッケージはありません。

# 🎬 OmniRoute の動作デモ

## 📹 動画ガイド

_{2026-08-24 時点のダッシュボードスナップショット · 未加工カタログ: YT 809 | TT 137 | IG 124 · 鮮度（日数）: YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 回視聴}

🎬 #2 — Instagram
_{theopenstack — 692,419 回視聴}

🎬 #3 — TikTok
_{milesreevesai — 620,400 回視聴}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 回視聴}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 回視聴}

**完全ランキング（重複を除去した正規URL、`v > 0`、リーチ順）:** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | 2026-08-24 時点の正規化済み指標: **1.029 本のユニーク動画** · **11.132.922 回の既知の視聴**（`v > 0`）· **ネットワーク別639チャンネル／プロフィール**。未加工のダッシュボードには1.070行が含まれています。Instagramの重複41件は正規URLによって正規化され、動画ごとに最大の視聴回数が保持されています。 > 🎬 **OmniRouteについての動画を作成しましたか？** リンクを添えて[issue](https://github.com/diegosouzapw/OmniRoute/issues/new)または[discussion](https://github.com/diegosouzapw/OmniRoute/discussions)を作成してください。こちらで紹介します。

# 📧 コミュニティとヘルプ > すべてを1か所に — メンテナーをフォローしたり、コミュニティとチャットしたり、issueを作成したりできます。 | チャンネル | 場所 / 方法 | | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — メンテナーをフォロー | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — リリース情報やヒントをフォロー | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 グローバル** | [グループに参加](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 ブラジル** | [グループに参加](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **ウェブサイト** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute コミュニティ（無料）** | [StHub ポータル](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **ソースコード** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **バグを報告** | [Issue を作成](https://github.com/diegosouzapw/OmniRoute/issues) — `npm run system-info` の出力を添付 | | 🤝 **コントリビュート** | [CONTRIBUTING.md](CONTRIBUTING.md) · [ブランチおよびリリースモデル](docs/ops/BRANCHING_MODEL.md) · `good first issue` を選択 | | 💚 **プロジェクトを支援** | [支援方法 ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ 技術スタック

レイヤー	テクノロジー
ランタイム	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
言語	TypeScript 6.0 — `src/` と `open-sse/` の全体で 100% TypeScript（v2.0 以降、コアでの `any` 使用はゼロ）
フレームワーク	Next.js 16 + React 19 + Tailwind CSS 4
データベース	better-sqlite3（SQLite、WAL ジャーナリング）+ LowDB（従来の JSON）— 137 のドメインモジュール、202 のマイグレーション
メモリ	SQLite FTS5 全文検索 + int8 量子化ベクトル埋め込み、型付き減衰
スキーマ	Zod 4 — MCP ツールの入出力検証 + API コントラクト
プロトコル	MCP（stdio / HTTP / SSE）+ A2A v0.3（JSON-RPC 2.0 + SSE）
ストリーミング	Server-Sent Events（SSE）+ WebSocket ブリッジ（`/v1/ws`）
圧縮	12 エンジンのパイプライン — RTK、Caveman、LLMLingua-2（MobileBERT ONNX）、GCF、OmniGlyph
認証 & セキュリティ	OAuth 2.0（PKCE）+ JWT + API キー + MCP スコープ認証 · 保存時の AES-256-GCM 暗号化 · DOMPurify
ステルス	wreq-js — JA3 / JA4 TLS フィンガープリント偽装、3 段階プロキシ
耐障害性	サーキットブレーカー、指数バックオフ、サンダリングハード対策、自動コンボ自己修復
ロギング	pino — リクエストコンテキストを含む構造化 JSON ログ
テスト	Node.js テストランナー + Vitest — 5,100 以上の追跡対象テストファイル全体で 39,000 以上の静的テスト宣言（ユニット、統合、E2E、セキュリティ、エコシステム）
プラットフォーム	デスクトップ（Electron）· Android（Termux）· PWA（任意のブラウザー）
CI/CD	GitHub Actions — リリース時に npm および Docker Hub へ自動公開
リンク	ウェブサイト · npm · Docker Hub

## 📖 ドキュメント

### 📘 はじめに

ドキュメント	説明
ユーザーガイド	プロバイダー、コンボ、CLI 統合、デプロイ
セットアップガイド	すべてのインストール方法、CLI ツール設定、プロトコル設定、タイムアウト調整
CLI ツールガイド	Claude Code、Codex、Cursor、Cline、OpenClaw、Kilo、Copilot のツール別セットアップ
リモートモード	スコープ付きアクセストークンを介して、ノート PC の CLI からリモートの OmniRoute（VPS）を操作
Claude Code 設定	`launch` とモデル別プロファイルを使用して Claude Code を OmniRoute（ローカル／リモート）に接続
クイックスタート	インストール → 接続 → 設定の 3 ステップ

### 🔧 運用とデプロイ

ドキュメント	説明
Docker ガイド	Docker の実行、Compose プロファイル、Caddy HTTPS、トンネル、イメージタグ
Podman ガイド	Quadlet systemd 統合、podman-compose、SELinux
VM デプロイ	完全ガイド：VM + nginx + Cloudflare のセットアップ
Fly.io デプロイ	永続ストレージを使用して Fly.io にデプロイ
Termux ガイド	Termux を介して Android 上で OmniRoute を実行
PWA ガイド	プログレッシブウェブアプリのインストール、キャッシュ、アーキテクチャ
アンインストールガイド	すべてのインストール方法に対応した完全削除
環境設定	`.env` の全変数とリファレンス

### 🧠 機能とアーキテクチャ

ドキュメント	説明
アーキテクチャ	システムアーキテクチャ、データフロー、内部構造
圧縮ガイド	7 種類のパイプライン：オフ／ライト／標準／アグレッシブ／ウルトラ／RTK／スタック
RTK 圧縮	コマンド出力の圧縮、フィルター、信頼、検証、生出力の復元
圧縮エンジン	Caveman、RTK、スタック型パイプライン、ダッシュボード／API／MCP インターフェース
圧縮ルール形式	Caveman および RTK フィルター向け JSON ルールパックのスキーマ
圧縮言語パック	言語検出と Caveman ルールパックの作成
レジリエンスガイド	サーキットブレーカー、クールダウン、キュー、サンダリングハード対策、TLS スプーフィング
自動コンボエンジン	16 要素のスコアリング、モードパック、自己修復
プロキシガイド	3 レベルのプロキシシステム、1proxy マーケットプレイス、レジストリ CRUD
無料枠	統合ディレクトリ：文書化された 35 の定期提供プール／カタログ登録された 489 件の無料枠エントリ
機能ギャラリー	スクリーンショットで見るダッシュボードツアー
コードベースドキュメント	初心者向けのコードベース解説

### 🤖 プロトコルと API

ドキュメント	説明
API リファレンス	すべてのエンドポイントを例付きで解説
OpenAPI 仕様	OpenAPI 3.0 仕様
MCP サーバー	110 個の MCP ツール、IDE 設定、Python／TS／Go クライアント
MCP サーバーガイド	MCP のインストール、トランスポート、ツールリファレンス
A2A サーバー	JSON-RPC 2.0 プロトコル、スキル、ストリーミング、タスク管理
A2A サーバーガイド	A2A エージェントカード、タスク、スキル、ストリーミング

### 📋 プロジェクトと品質

ドキュメント	説明
コントリビューション	開発環境のセットアップとガイドライン
ブランチおよびリリースモデル	PR のマージ先（`release/*`）、`main` とタグの意味
変更履歴	バージョンごとの完全なリリース履歴
セキュリティポリシー	脆弱性の報告とセキュリティ対策
i18n ガイド	42 言語のサポート、翻訳ワークフロー、RTL
リリースチェックリスト	リリース前の検証手順
カバレッジ計画	追跡対象の 5,100 以上のテストファイルに含まれる 39,000 以上の静的テスト宣言に対するテストカバレッジ戦略

# ⭐ トップコントリビューター > OmniRoute は、情熱あふれるオープンソースコミュニティによって形作られています。以下の方々は、プロジェクトの品質、安定性、普及に直接影響を与える卓越した貢献をしています。**ありがとうございます。** ### マージされたプルリクエスト数による外部コントリビューターのランキング

順位	コントリビューター	マージ済み PR 数	変更行数（概算）
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{稼働中の release/v3.8.50 の先端 dafb4ae808 時点で固定されており、2026-08-24 05:26:03 UTC までのマージを含みます。ページ分割された GitHub GraphQL の集計には、マージ済み PR が 5,911 件含まれています。その内訳は、リポジトリ所有者によるものが 2,707 件、Dependabot によるものが 179 件、そして異なる 535 人のコントリビューターによる外部 PR が 3,025 件です。「変更行数」は GitHub の追加行数と削除行数の合計であり、生成ファイル、ロックファイル、カタログ、翻訳、ドキュメントを含みます。これは変更量であり、実際に記述されたコード行数ではありません。境界順位で同数の場合は、すべて掲載しています。} ### GitHub に帰属するコミット

backryun _{🥇 GitHub に帰属するコミット 220 件}	Paijo _{🥈 GitHub に帰属するコミット 219 件}	Randi _{🥉 GitHub に帰属するコミット 108 件}	Ravi Tharuma _{🏅 GitHub に帰属するコミット 81 件}	Chris _{🏅 GitHub に帰属するコミット 70 件}	Markus Hartung _{🏅 GitHub に帰属するコミット 69 件 · 同率 6 位}
Dizzle _{🏅 GitHub に帰属するコミット 69 件 · 同率 6 位}	Jan Leon _{🏅 GitHub に帰属するコミット 64 件}	zenobit _{🏅 GitHub に帰属するコミット 62 件}	Bob.Hou _{🏅 GitHub に帰属するコミット 51 件 · 同率 10 位}	Xiangzhe _{🏅 GitHub に帰属するコミット 51 件 · 同率 10 位}

_{2026-08-24 06:14:31 UTC に再確認：デフォルトブランチ release/v3.8.50 について、リポジトリの Contributors API が報告した GitHub に帰属するコミット数です。API は 525 個のアイデンティティ（ユーザー 415、ボット 2、匿名 108）を返しました。この表ではメンテナー、ボット、および匿名のアイデンティティを除外し、同順位はそのまま保持しています。これは、上記のマージ済み PR ランキングとも、下記の 639 人を対象とした Git メタデータ調査とも異なります。} > 🙏 これらのコントリビューターによる機能、バグ修正、インフラストラクチャの改善は、OmniRoute の信頼性と豊富な機能を支える**中核的な要素**です。すべてのプルリクエスト、すべてのテストケース、すべての i18n 翻訳ファイルに価値があります。オープンソースは、このような人々によって築かれています。

---
## 💖 スポンサー

私費で OmniRoute を支援してくださっている皆さまに、心より感謝申し上げます。皆さまからのご支援の一つひとつが、このプロジェクトを無料かつ独立した状態に保ち、前進させる力となっています。

Andrew
_{💛 現在継続中の月額スポンサー}

Vlad I
_{💛 現在継続中の月額スポンサー}

Paco Cartones
_{💛 現在の単発スポンサー}

Prof. Igor Morais
_{💛 過去の単発支援者}

longtao
_{💛 過去の単発支援者}

_{…そして、匿名を希望されるその他の皆さまにも感謝いたします 💛} _{公開されている GitHub Sponsors の情報は 2026-08-24 に再検証済みです。上記のアクティブ状態のラベルは GitHub の activeOnly ステータスに基づいています。過去に公開されていた単発支援者については引き続き謝意を表し、非公開スポンサーの匿名性は維持されます。} 💖 スポンサーになる → — ご支援の一つひとつが、OmniRoute を無料かつ独立した状態に保つ力となります。

## 👥 600人以上のコントリビューター

[![コントリビューター](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-08-24 に固定ベース ac02c5b42f で監査し、最新の release/v3.8.50 の先端 dafb4ae808 でも再確認しました。その結果、正規化された人間の Git ID は 639 件でした。このうち 407 件はコミット作成者（メンテナーを含む）として確認され、232 件は明示的な Co-authored-by トレーラーにのみ記載されています。この集計では、GitHub の noreply ハンドルを正規化し、26 件のボット、エージェント、サービス、プレースホルダーの ID を除外しています。また、表示名が一致するという理由だけで通常のメールアドレスを統合することはありません。} ### コントリビュート方法 1. リポジトリをフォークします 2. `main` ではなく、**アクティブな** `release/vX.Y.Z` の先端からブランチを作成します — [ブランチおよびリリースモデル](docs/ops/BRANCHING_MODEL.md)を参照してください 3. 機能ブランチを作成します（`git checkout -b feat/amazing-feature`） 4. 変更をコミットします（`git commit -m 'feat: add amazing feature'`） 5. ブランチにプッシュします（`git push origin feat/amazing-feature`） 6. **base = 対象の `release/vX.Y.Z` ブランチ**として Pull Request を作成します詳細なガイドラインについては、[CONTRIBUTING.md](CONTRIBUTING.md)を参照してください。 ### 新しいバージョンのリリース ```bash # リリースを作成します — npm publish は自動的に実行されます VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 スター

## 🌍 StarMapper

## 🙏 謝辞

OmniRouteは、巨人たちの肩の上に立っています。**[9router](https://github.com/decolua/9router)** のフォーク、およびGoプロジェクト **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** のTypeScript移植版として始まり、その後、以下の各サブシステムは、先駆けとなったオープンソースプロジェクトから着想を得ました。それぞれのプロジェクトが、OmniRouteの具体的な一部分を形作っています。これらすべてのプロジェクトに感謝を捧げます。🙏 > ⭐ スター数は2026年8月24日にGitHubのREST APIで確認済みです。ぜひ、これらのプロジェクトにスターを付けてください。記載数は特定日時点の正確なスナップショットであり、今後当然変動します。 ### 🧬 系譜とゲートウェイ

プロジェクト	⭐	OmniRoute に与えた影響
9router	26,161	このフォークの基盤となった元のプロジェクトです。ここではマルチモーダル API を追加し、TypeScript で全面的に書き直しています。
CLIProxyAPI	48,497	この JavaScript / TypeScript 移植版の着想源となった Go 実装です。
LiteLLM	57,100	コスト追跡の同期に使用する公開料金データセットを提供し、プロバイダー正規化モデルがルーティング設計の参考となった AI ゲートウェイです。
codex-chatgpt-web	1,410	ベンダー化された ChatGPT Web → Codex Responses ブリッジに適用した MIT ライセンスのソースで、ブラウザーセッション、レスポンスフレーミング、使用量、Web 検索の各アダプターが含まれます。
free-claude-code	48,112	ストリーム復旧、思考なしエイリアス、フォールバック Web 検索、スライディングウィンドウ制限、ログの墨消し、強化されたランチャーフローに移植したパターンです。
composer-api	322	Cursor Composer のツール選択、出力制約、ツールコミットのパターンをネイティブ Cursor エグゼキューターに適用しました。
codex-multi-auth	457	新規ログインとリフレッシュトークンのローテーションパターンを Codex OAuth の再認証に移植しました。
opencode-anthropic-auth	510	Claude Code 互換の変換デフォルト値と課金ヘッダーの動作を、OmniRoute の設定駆動型ブリッジに汎用化しました。
grok2api-merged	2	Grok のモデルマッピング、偽 TypeError を使用する Statsig ジェネレーター、リクエストとデバイスのデフォルト値、NDJSON レスポンスプロセッサーを、OmniRoute の Grok Web エグゼキューターに実質的に適用しました。
TQZHR/grok2api	705	grok2api-merged の主要な間接コードソースです。そのモデル、ヘッダー、ペイロード、Statsig、プロセッサーの各実装は、Grok Web の系譜に継承されています。
chenyme/grok2api	7,520	TQZHR と grok2api-merged を経由して継承された、Grok のペイロードとデバイスのデフォルト値、Statsig ジェネレーター、`result.response` プロセッサーの基礎となる MIT ライセンスのソースです。
grok2api-pro	27	grok2api-merged がプロキシプール層の出典として明記している間接ソースです。OmniRoute はその系譜に関する表記を維持していますが、範囲を限定した Grok Web エグゼキューターへプロキシプールを移植したとは主張しません。
GrokProxy	50	Cookie 認証を使用する Grok プロキシと `result.response.token` ストリーミングパターンが、OmniRoute の Grok Web トランスポートの参考となりました。
GrokBridge	5	元の Grok Web 実装では、その HTTP/ブラウザーのアップストリーム設計を参照しました。直接 HTTP パスは GrokProxy から派生しているため、独立したコード移植であるとは主張しません。
grok-web-api	14	Rust の `ChatOptions` とレスポンスエンベロープのスキーマが、OmniRoute の TypeScript による Grok リクエスト型およびストリーミングレスポンス型の参考となりました。

### 🗜️ コンテキストとトークンの圧縮 — エンジン

プロジェクト	⭐	OmniRoute に与えた影響
Caveman	100,538	「多くのトークンを使う理由ない、少ないトークンでうまくいく」というバイラルプロジェクト — その原始人風の表現哲学が、標準圧縮モードと30以上の冗長語除去・短縮ルールの基盤となっています。
RTK – Rust Token Killer	77,185	高性能なコマンド出力圧縮 — RTK エンジン、JSON フィルター DSL、生出力の復元、そして RTK → Caveman の多段パイプラインに着想を与えました。
headroom	67,310	可逆的なコンテキスト圧縮（SmartCrusher） — `headroom` エンジンと `ccr` 取得マーカーパターンに着想を与えました。
LLMLingua	6,598	プロンプト圧縮の研究（LLMLingua / LLMLingua-2） — 非同期でコードセーフ、かつフェイルオープンな `llmlingua` エンジンに着想を与えました。
llmlingua-2-js	31	LLMLingua エンジンのワーカースレッド用バックエンドとして使用されている JS/ONNX ポート（MobileBERT / XLM-RoBERTa）です。
Troglodita	40	ブラジルポルトガル語（pt-BR）のトークン圧縮 — ブラジルポルトガル語の文法に合わせて調整された冗語削減と不要語除去を備える、pt-BR 言語パックの基盤です。
ponytail	108,957	バイラルな「怠惰なシニア開発者」向け YAGNI コーダースキル — less-code 出力スタイルに着想を与えました。これは、動作する最小限の変更へ誘導して_生成される_コードを削減するもので、Caveman の簡潔な文章に対応する出力軸の機能です。
i-have-adhd	23,526	行動を第一に考えた ADHD フレンドリーな応答スタイルを、5言語に対応する OmniRoute の簡潔な出力スタイルへ応用しました。

### 🧩 コンパクト形式、トークン研究、コード対応ツール

プロジェクト	⭐	OmniRoute に与えた影響
TOON	25,233	トークン指向オブジェクト表記法 — その列指向の「ヘッダー＋行」モデルが、表形式圧縮ステージの設計に影響を与えました。
GCF – Graph Compact Format	41	そのコンパクトなグラフ形式と汎用プロファイル設計が、OmniRoute の表形式圧縮と Headroom コーデック形式の参考になりました。
gcf-typescript	4	Headroom の汎用プロファイルコーデックとして直接ベンダー化し、拡張した MIT ライセンスの TypeScript 実装です。
token-optimizer-mcp	494	Brotli/SQLite キャッシュ＋セッション単位のコンテキスト差分 — `session-dedup` エンジンに着想を与えました。
token-savior	1,122	Bash 出力圧縮＋MCP プロファイル — 圧縮を中止する際の規律と、MCP ツールマニフェストの削減に着想を与えました。
token-saver	138	コンテンツを考慮したファイル形式別の出力圧縮と、失敗を考慮した中止処理 — 種類別のディスパッチと、削減量が最小基準に満たない場合のスキップが妥当であることを裏付けました。
token-optimizer	1,951	「ゴーストトークンを見つける」 — そのオフロード＋復元可能なハンドルというパターンが、CCR のオフロード設計の参考になりました。
TokenMizer	28	セッショングラフ＋ターンをまたぐ行重複排除の設計図が、session-dedup の設計に影響を与えました。
OmniCompress	3	Rust による列指向 JSON＋コンテンツアドレス指定の取得＋メッセージ間重複排除 — `headroom`/`ccr`/`session-dedup` エンジンの設計と、キャッシュを安定させる「圧縮形式は位置に依存しない」という不変条件が妥当であることを裏付けました。
mcp-compressor	113	MCP ツールのスキーマ／説明の圧縮 — MCP ツールマニフェストのカーディナリティ削減の参考になりました。
RepoMapper	197	Aider スタイルのリポジトリマップランキング — リポジトリマップ／検索ランキングの調査に役立ちました。
quiet-shell-mcp	4	MCP を介した宣言的なシェル出力削減 — 宣言的な Bash 出力圧縮が妥当であることを裏付けました。
ts-morph	6,162	TypeScript Compiler API ツールキット — 文字列、テンプレート、正規表現リテラルを保持する、パーサーベースのコメント除去に着想を与えました。

### 🧠 メモリと RAG

プロジェクト	⭐	OmniRoute が受けた影響
Mem0	63,902	汎用メモリレイヤー — プロキシを読み書きの境界とするモデルが、私たちのメモリアーキテクチャの基礎となりました。
Letta (MemGPT)	24,382	階層型メモリを備えたステートフルエージェント — 私たちの Context Control & Recovery (CCR) 階層モデルの着想源となりました。
WFGY	1,781	繰り返し発生する16種類の RAG/LLM 障害モードを分類する ProblemMap — 私たちのトラブルシューティングガイドで使用する共通語彙となりました。

### 🛰️ トラフィック検査、MITM、透過型プロキシ

プロジェクト	⭐	OmniRoute が受けた影響
llm-interceptor	66	コーディングアシスタント ↔ LLM 間のトラフィックに対する MITM 傍受／分析は、初期の Traffic Inspector 要件策定に影響を与えました。以前派生していた4つのモジュール — SSE マージ、会話の正規化、シークレットのマスキング、ヘッダーのサニタイズ — は、公開プロトコル標準に基づく独立したクリーンルーム実装に置き換えられています。2つのホストパススルー領域（`passthrough.ts` と `_internal/bypass.cjs`）は、独立して分類された OmniRoute 内部実装のままであり、この置き換えの一環として書き直されたものではありません。
ProxyBridge	5,995	プロセス単位の透過型プロキシルーティング — クラッシュセーフな MITM 終了処理、ソケットのアイドルタイムアウト、`/proc` によるプロセス帰属判定、TPROXY キャプチャの着想源となりました。

### 📚 モデルデータ、オブザーバビリティ、UI

プロジェクト	⭐	OmniRoute が受けた影響
models.dev	6,555	AI モデルの仕様、料金、機能に関するオープンデータベース — 私たちのモデルカタログにネイティブに同期されています。
React Flow / xyflow	38,108	リアルタイムの Compression Studio と Combo/Routing Studio を支えるノードベースのグラフライブラリです。
LangGraph	40,314	LangGraph Studio のライブワークフローグラフ可視化が、私たちの Studios におけるリアルタイムのカスケード表示の着想源となりました。
Langfuse	33,592	トレース → スパン → 生成というオブザーバビリティモデルが、私たちの Compression Studio のウォーターフォール表示の基礎となりました。
Kiali	3,631	Istio サービスメッシュのオブザーバビリティ — Routing/Combo Studio におけるサーキットブレーカーバッジとエラーエッジ表示の着想源となりました。
lobe-icons	2,428	私たちのダッシュボード全体でプロバイダーアイコンとして表示される AI/LLM ブランドロゴです。
flag-icons	12,354	README の言語セレクターで使用される MIT ライセンスの SVG 国旗を提供します。

### 🛡️ セキュリティ

プロジェクト	⭐	OmniRoute が受けた影響
awesome-secure-defaults	721	セキュアバイデフォルトのライブラリを厳選したリストであり、私たちのセキュリティ上の選択（Helmet.js、DOMPurify、ssrf-req-filter、safe-regex、Google Tink）の指針となっています。

### 🧭 補完ツール

プロジェクト	⭐	OmniRoute が受けた影響
ClawRouter	6,564	リクエストの重複排除、緊急時のゼロコストフォールバック、プラグイン可能な Auto-Combo 戦略、多言語の意図分類の着想源となりました。
Antigravity-Manager	30,652	アカウントを考慮したモデルの再マッピング、実行可能ファイルのパス検証、プランラベルの動作が、OmniRoute の Antigravity ランタイムの設計に影響を与えました。
vscode-antigravity-cockpit	4,817	コンパクトなクォータリセットのカウントダウン形式が、OmniRoute における対応するプロバイダー上限表示の着想源となりました。
AionUi	32,230	ACP 連携が、OmniRoute によるインストール済み CLI エージェントの自動検出の着想源となりました。
CodexBar	20,507	Grok Build のクォータ取得インターフェースを特定しました。その後 OmniRoute は、実際の通信フォーマットを独自に検証して修正しました。

## 📄 ライセンス MIT License - 詳細は [LICENSE](LICENSE) をご覧ください。 ---

**[⬆ トップに戻る](#-omniroute)** · オープンソースAIコミュニティのために❤️を込めて開発されています。 _{OmniRoute v3.8.52 · Node ≥22.22.2 · MIT License · omniroute.online}