# 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 Dashboard

# 🚀 OmniRoute — 無料のAIゲートウェイ OmniRoute — Never stop coding. Every AI tool → 358 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 358 AI providers · 150+ free tiers · ~1.62B free tokens/mo · 19 routing strategies · $0 to start.
## 💰 月間約16.2億無料トークン
> 無料枠を手作業で積み上げるのは大変です。数十ものSDK、数十ものレート制限があり、実際にどれだけ利用できるのかも分かりません。OmniRouteは、**35個の継続プールキーにまたがる489件の無料枠エントリ**をカタログ化し、**公開済みの月間予算がプラスである17個のプールと、モデルごとに設定された5個のGroq上限**から、共有プールを重複排除してトークン総数を算出します。地域別の本人確認を完了した後でのみ利用可能になるクォータ(現時点ではModelScope)は別枠で表示され、地域別本人確認後に利用できる約600万トークンは総数には決して加算されません。結果はダッシュボード(`/dashboard/free-tiers`)で常に確認できます。 OmniRouteの無料枠予算カード:毎月約16.2億の無料トークンを継続的に利用でき、登録クレジットを含めると初月は最大約22.2億。1つのエンドポイントから利用できる、35個の文書化された継続プールキーにまたがる489件のカタログ化済み無料枠エントリに基づきます。共有プールを重複排除した正確な計算で、各共有プールは1回だけ集計されます。公開済みの月間トークン予算がプラスである17個の継続プールと、モデルごとに設定された5個のGroq上限を含みます。利用規約リスクカタログでは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が費用の節約や作業の効率化に役立ったなら、リポジトリにStarをお願いします。

[![Star数](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute) diegosouzapw%2FOmniRoute | Trendshift [![Star履歴ランキング](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.49 | **v3.8.50** | `v3.8.51+` | | ------------------------------- | :-----: | :-----------------------: | :------------: | | 🌐 プロバイダー | 290 | **357** | さらに追加予定 | | 🧠 一意のチャットモデル ID | 1185 | **1312** | — | | 🖼️ モダリティブリッジ | — | 🆕 ビジョン + 音声 + 動画 | — | | 📡 Radar 無料カタログ | — | 🆕 オプトイン | — | | ⚖️ クォータ対応スケジューリング | — | 🆕 Quota-Share | — | | 📊 クォータテレメトリ | — | 🆕 リアルタイム | — | **→ [ロードマップ](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 Pull 数](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 を選ぶ理由 🏆 他との違い
⚙️ 機能 🎯 コンボ 🌐 プロバイダー 🔌 CLI & MCP
🗜️ 圧縮 🖥️ 実行環境 🔒 プライベート
👀 見てみる 🎬 実際の動作 ✨ 新着情報 🤖 対応 CLI
💚 支援 💚 支援 / 寄付 💬 コミュニティ 💖 スポンサー
📦 プロジェクト 🛠️ 技術スタック 📖 ドキュメント 👥 コントリビューター
🌐 66言語に対応

英語 (en) ポルトガル語 — ブラジル (pt-BR) ポルトガル語 (pt) スペイン語 (es) フランス語 (fr) イタリア語 (it) ドイツ語 (de) オランダ語 (nl) ロシア語 (ru) ウクライナ語 (uk-UA) ポーランド語 (pl) チェコ語 (cs) スロバキア語 (sk) ルーマニア語 (ro) ハンガリー語 (hu) ブルガリア語 (bg) デンマーク語 (da) フィンランド語 (fi) ノルウェー語 (no) スウェーデン語 (sv) 中国語 — 簡体字 (zh-CN) 中国語 — 繁体字 (zh-TW) 日本語 (ja) 韓国語 (ko) タイ語 (th) ベトナム語 (vi) インドネシア語 (id) マレー語 (ms) フィリピノ語 (phi) ヒンディー語 (hi) グジャラート語 (gu) マラーティー語 (mr) タミル語 (ta) テルグ語 (te) ベンガル語 (bn) ウルドゥー語 (ur) ペルシャ語 (fa) アラビア語 (ar) ヘブライ語 (he) トルコ語 (tr) アゼルバイジャン語 (az) スワヒリ語 (sw) ギリシャ語 (el) クロアチア語 (hr) セルビア語 (sr) リトアニア語 (lt) エストニア語 (et) ラトビア語 (lv) スロベニア語 (sl) マルタ語 (mt) アイルランド語 (ga) カンナダ語 (kn) マラヤーラム語 (ml) オディア語 (or) パンジャブ語 (pa) ネパール語 (ne) シンハラ語 (si) ミャンマー語 (my) クメール語 (km) ハウサ語 (ha) ヨルバ語 (yo) イボ語 (ig) アムハラ語 (am) ウズベク語 (uz) ジョージア語 (ka) アルメニア語 (hy)


## 🆓 インストール後すぐに動作 — キーも設定も不要
インストール後すぐに動作 — 設定不要。3つのステップ:1. インストール — npm i -g omniroute、サーバーはlocalhost:20128で起動します。2. ツールをhttp://localhost:20128/v1にポイントします — OpenAI互換ツール(Claude Code、Cursor、Cline)なら何でも。3. 応答します — APIキー、サインアップ、設定なしで、即座に返信を得るためにモデルautoを呼び出します。キーレスプロバイダーOpenCode Freeはautoコンボに事前に配線されているため、新規インストールで箱から出してすぐに応答します。 ```bash # 新規インストール、認証情報ゼロ — `auto`はすでに動作します: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` 特定の無料バックエンドをご希望ですか?`oc/…` (OpenCode Free) を直接呼び出してください。その後、`auto`に移行してOmniRouteに選択させましょう。 📦 **Python、Node.js、PHP、cURL** のクイックスタートスクリプトをコピー&ペースト → [`examples/quickstart/`](examples/quickstart/)
# 💥 約束
約束 — 1つのエンドポイントと358のプロバイダー。自動フォールバックにより、健全なターゲットが利用可能な限りルーティングを維持します。6つの柱:358のプロバイダーにわたる回復力のあるフォールバック · 対象となるワークロードで最大95%のトークン節約 · 150以上の無料ティアと54の定期/キーレス永久無料プロバイダーで$0から開始 · 1つの設定で36のCLI/エージェント統合 · /v1でのOpenAI、Claude、GeminiおよびResponses API互換性 · サーキットブレーカー、TLSステルス、MCP 110ツール、A2A、メモリ、ガードレール、評価、5,100以上の追跡されたテストファイルにわたる39,000以上の静的テスト宣言を含む本番環境制御。

# 🤔 なぜOmniRouteなのか?
なぜOmniRouteなのか — 10個のダッシュボード、期限切れのAPIキー、予期せぬ請求に悩まされるのをやめましょう。10の日常的な問題と解決策:未使用のクォータが期限切れになる → サブスクリプションを最大化;コーディング中にレート制限 → 4層自動フォールバック(サブスクリプション → API → 安価 → 無料);ツール出力がトークンを消費 → RTK + Caveman圧縮(15~95%);高価なAPI → コスト最適化ルーティング;すべてのツールに独自のセットアップ → 1つのエンドポイント、1つのダッシュボード;AIがブロックされる → 3レベルプロキシ + TLSステルス;期限切れのキー → 3層レジリエンス(サーキットブレーカー、キークールダウン、モデルロックアウト);チームで1つのサブスクリプションを共有 → 公平なクォータを持つキープール;誰かのクラウドを介したプロンプト → AES-256-GCM暗号化キーによるローカルファースト;支出の可視性なし → ライブ分析(使用量、クォータ、節約、p95レイテンシ)。
OmniRouteリクエストフロー:IDEまたはCLI(Claude Code、Cursor、Clineなど)が1つのローカルエンドポイント(http://localhost:20128/v1)を呼び出します。OmniRouteスマートルーター(RTK + Caveman圧縮、19のルーティング戦略、サーキットブレーカー、TLSステルス、MCP、A2A、ガードレール)は、適格な健全なターゲットが残っている限り、4つのプロバイダーティア(ティア1サブスクリプション、ティア2 APIキー、ティア3安価、ティア4無料)にフォールバックできます。

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

Kimi K3 — オープンフロンティアインテリジェンス · 2.8Tパラメータ · 1Mトークンコンテキスト

> **オープンソースフレンドとして参加しませんか?** これらの企業はオープンソースを支援し、OmniRouteの活動を継続するのに役立っています。そして、私たちは彼らが提供するすべてのトークンがどこに使われるかを公にしています。ご連絡ください: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi (Moonshot AI)
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
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
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🧪 レジリエンステスト(カオスエンジニアリング)向けの障害注入ウェイト
## ### 🔀 または独自に構築 — 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 キー 12回 / ローカル 2回。60s/30s/15s 後に HALF-OPEN プローブへ移行し、遅延回復を行う。OPEN 中は、コンボが次のプロバイダーへ再ルーティングする。レイヤー2:接続クールダウン(1つのキー/アカウント)。基本時間は OAuth 5s / API キー 3s。サンダリングハード防止ガード付きの指数関数的 ×2 バックオフを適用し、429 では Retry-After に従い、成功するとすべてのエラー状態がクリアされる。クールダウン中のキーはスキップされ、同じグループ内の他のキーは引き続き処理を行う。レイヤー3:モデルのロックアウト(1つのモデル)。モデル単位の 429、ローカルの 404、またはモード拒否では、そのモデルだけをロックし、接続全体をロックすることはない。終端状態(禁止、期限切れ、クレジット枯渇)はオペレーターが対処するものであり、クールダウンの対象ではない。 📖 [自動コンボエンジン](docs/routing/AUTO-COMBO.md) · [レジリエンスガイド](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute の特徴
OmniRoute の特徴 — 9router、OpenRouter、CLIProxyAPI、LiteLLM との13の機能における最新の機能スナップショット。OmniRoute: 358のプロバイダー、150以上の無料ティアを内蔵、19のルーティング戦略、12エンジンのトークン圧縮、110のツールを備えた内蔵MCPサーバー、A2Aエージェントプロトコル、永続メモリ、ガードレール、クラウドエージェント、TLSフィンガープリントステルス、デスクトップ/Termux/PWA、42のi18n UIロケール。OmniRoute は MIT ライセンスで自己ホスト可能です。競合の機能と数は変更される可能性があります。リンクされた方法論を参照してください。 📊 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(クリックして展開)
₿ BTCBitcoin (SegWit)bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETHEthereum (ERC20)0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDTTron (TRC20)TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDCSolana2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ 各コインは、表示されているネットワークでのみ送金してください。誤ったネットワークで送金すると、資金を失う可能性があります。
🐛 バグを見つけた場合やフィードバックがある場合は、[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`)を使用してリモートの OmniRoute を操作し、VPS インストール向けの `antigravity` OAuth ヘルパーも提供。→ [リモートモード](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)** — プロキシ環境変数を無視する CLI を、SNI ごとの CA とトラストストアインストーラーを使用してキャプチャ。→ [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 の動画生成、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
Claude Code
                           
Codex CLI
Codex CLI
                           
Cline
Cline
                           
Kilo Code
Kilo Code
Zoo Code
Zoo Code
Continue
Continue
                           
Aider
Aider
                           
ForgeCode
ForgeCode
                           
jcode
jcode
                           
DeepSeek TUI
DeepSeek TUI
                           
CodeWhale
CodeWhale
                           
OpenCode
OpenCode
                           
Factory Droid
Factory Droid
                           
GitHub Copilot CLI
Copilot CLI
                           
Cursor CLI
Cursor CLI
                           
Smelt
Smelt
                           
Pi (pi-coding-agent)
Pi
                           
Grok Build (xAI)
Grok Build
                           
Hermes Agent (Nous Research)
Hermes Agent
                           
OpenClaw
OpenClaw
                           
Goose
Goose
                           
Open Interpreter
Open Interpreter
                           
Warp AI
Warp AI
                           
deyin.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)
## 🌐 357のAIプロバイダー — うち152がカタログ上で無料
> **357の登録済みプロバイダー**を、標準のチャット、メディア、検索、ローカル、クラウドエージェント、システムの各コレクションにわたって収録しており、そのうち**152には`hasFree: true`の検出用メタデータが付与されています**。チャットモデルレジストリは**229プロバイダー / 2,554の一意なプロバイダー・モデルの組み合わせ / 1,283の未加工モデルID**を網羅しています。これとは別に、無料枠カタログには**モデル別に491行**、**35の定期更新プール**、および**54の定期更新型またはキーレスの永久無料プロバイダー**があります。これらは意図的に異なる母数を使用しています。定義およびプールの重複を除外した計算については、[プロバイダーリファレンス](docs/reference/PROVIDER_REFERENCE.md)と[無料枠](docs/reference/FREE_TIERS.md)を参照してください。
### 🏢 主要なすべてのラボへ、1つのエンドポイントからアクセス
OpenAI
OpenAI
                           
Anthropic
Anthropic
                           
Gemini
Gemini
                           
xAI Grok
xAI Grok
                           
DeepSeek
DeepSeek
                           
Mistral
Mistral
                           
Qwen
Qwen
                           
Meta Llama
Meta Llama
                           
Groq
Groq
                           
NVIDIA
NVIDIA
                           
MiniMax
MiniMax
                           
Cohere
Cohere
                           
Perplexity
Perplexity
                           
Hugging Face
HuggingFace
                           
Together
Together
                           
Fireworks
Fireworks
                           
Cloudflare
Cloudflare
                           
Baidu
Baidu
                           
…ほか330以上 — すべてのアイコンは、ダッシュボードのプロバイダーカタログからリアルタイムに取得されます。📖 [プロバイダーリファレンス](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 永久無料 — $0、カード不要
OpenCode Zen
OpenCode Zen
DeepSeek V4, Nemotron 3
トークン上限なし
Kilo Code
Kilo Code
自動ルーター、Tencent Hy3
永久無料
Requesty
Requesty
GPT-OSS 120B, Nemotron
永久無料
SiliconFlow
SiliconFlow
DeepSeek V3.2 / R1
無料枠
Z.AI GLM
Z.AI GLM
GLM-4.7 / 4.5-Flash
永久無料
Baidu ERNIE
Baidu ERNIE
ERNIE 4.0
永久無料
Qoder AI
Qoder AI
Qwen3-Max, Kimi-K2
無制限で無料
Pollinations
Pollinations
GPT, Llama, Claude
キー不要
Cloudflare AI
Cloudflare AI
50以上のモデル
1日あたり10Kニューロン
NVIDIA NIM
NVIDIA NIM
GLM, MiniMax
無料で約40 RPM
Cerebras
Cerebras
GLM 4.7, GPT-OSS
1日あたり1Mトークン
OpenRouter
OpenRouter
:freeモデル
+$10 → RPM上限を引き上げ
📖 機械可読形式の完全なカタログ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute の実行環境 — どこでも
> 同じアプリを、あなたのマシンで、あなたのルールに従って。グローバル npm インストールから、Termux を介した **あなたのスマートフォン** まで。
プラットフォームインストール特長
📦 npm(グローバル)npm install -g omniroute1つのコマンドで、あらゆる OS に対応
🐳 Dockerdocker run … diegosouzapw/omnirouteマルチアーキテクチャ対応:AMD64 + ARM64
🖥️ デスクトップ(Electron)npm run electron:buildネイティブウィンドウ + システムトレイ — Windows / macOS / Linux
🎩 メニューバー(OmniRouteTray)brew install --cask zoispag/tap/omniroute-trayサーバーの監視と自動更新 — macOS
💪 ARMネイティブ arm64Raspberry Pi、ARM サーバー、Apple Silicon
📱 Android(Termux)pkg install nodejs && npx -y omnirouteスマートフォン上で年中無休で動作、root 不要
📲 PWA「ホーム画面に追加」全画面表示、オフライン対応、ブラウザからインストール可能
🧩 OpenCode プラグイン@omniroute/opencode-providerOpenCode ネイティブ統合
🤖 VS Code Copilot ChatOmniCopilot 拡張機能をインストール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 --mcpClaude 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 へプッシュ
🛰️ リモート CLIomniroute 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トークンでプロバイダーに到達する様子を示しています。構造化コンテンツは、保持ガードとステップごとの忠実性ゲートによって保護されます。明示的な非可逆モードまたは実験的モードでは、対象となるコンテンツが変換される場合があります。 デフォルトのスタック構成では、`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エンジンのスタック エンジンはパイプラインの順序で実行され、それぞれを構成ごとに個別に有効化/無効化および設定できます:
#エンジン機能
1Session-Dedupターン間で繰り返されるコンテンツを除外(コンテンツアドレス方式、ターン横断)
2CCR大きなブロックを取得マーカーの背後にアーカイブし、必要に応じて取得
3Lite空白と画像URLのトリミング(低レイテンシのベースライン)
4RTKツール結果のスマートなフィルタリング、重複排除、切り詰め(コマンド対応)
5Responses Tool Outputシェル/パッチ/検索/ビルド出力向けの、可逆性を優先したJSON処理と制限付き診断圧縮(Responses API)
6Headroom同梱されたGCFコーデックによるJSON配列の可逆な表形式圧縮(約30%)
7Relevance最後のユーザークエリに対する抽出型の文スコアリング
8Cavemanルールベースの文章圧縮(出力を約65~75%削減)
9Aggressive古いターンの要約と段階的な経年圧縮
10LLMLingua-2MobileBERT ONNXによるMLベースの意味的枝刈り — コードセーフ、非同期
11Ultraオプションの小規模モデル(SLM)階層を備えたヒューリスティックなトークン枝刈り
12OmniGlyphAnthropicへの直接接続で実測されたClaude Fable 5向けの実験的なコンテキスト画像化エンコーディング。GPT 5.6トランスフォーマーは、プロバイダーの受領証明が得られるまでフェイルクローズを維持します。4つの圧縮プロファイル(デフォルトのaggressive、balanced、coding-safe、passthrough)(最も積極的、オプトイン)
コードブロック、URL、構造化データは、**常にバイト単位で完全に保持**されます。**ワンクリックプリセット**で各エンジンを組み合わせられます:
モード削減率最適な用途
🪶 Lite~15%常時有効にできる安全なデフォルト
🪨 Standard (Caveman)~30%日常的なコーディング
⚡ Aggressive~50%ツール使用の多い長時間セッション
🔥 Ultra~75%最大限の削減
🧰 RTK60–90%シェル/テスト/ビルド/gitの出力
🔗 Stacked (RTK → Caveman)78–95%混在するプロンプトとツールログ
**実例 — Standardモード:** > **圧縮前(69トークン):** _「Reactコンポーネントが再レンダリングされる原因は、レンダリングサイクルごとに新しいオブジェクト参照を作成しているためである可能性が高いです。インラインオブジェクトをpropsとして渡すと、Reactの浅い比較では毎回異なるオブジェクトとして認識され、再レンダリングが発生します。useMemoを使ってオブジェクトをメモ化することをお勧めします。」_ > > **圧縮後(19トークン):** _「レンダリングごとに新しいオブジェクト参照。インラインオブジェクトのprops = 新しい参照 = 再レンダリング。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)。 ダッシュボードは `http://localhost:20128`、APIは `http://localhost:20128/v1` です。 **2) 無料プロバイダーに接続(登録不要)** ダッシュボード → **プロバイダー** → **Kiro AI**(無料のClaude、アカウントごとに月約50クレジット)または **OpenCode Free**(認証不要)に接続 → 完了。 **3) コーディングツールの接続先を設定** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (zero-config smart routing — or any provider/model) ``` **4) 動作を確認** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` 接続済みモデルの一覧が表示されるはずです。🎉 これで完了です。コーディングを始めれば、OmniRouteが自動的にルーティングし、必要に応じてフォールバックします。 クライアントがカスタムヘッダーを送信できない場合、OmniRouteはトークン化された互換エイリアスも提供します: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: 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
Instagramリール
🎬 #1 — Instagram
nick_saraev — 3,042,474 回視聴
Instagramリール — theopenstack
🎬 #2 — Instagram
theopenstack — 692,419 回視聴
TikTok — milesreevesai
🎬 #3 — TikTok
milesreevesai — 620,400 回視聴
YouTube — Vaibhav Sisinty
🎬 #4 — YouTube
Vaibhav Sisinty — 391,109 回視聴
Instagramリール — buildwithai.club
🎬 #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レガシー) — 122のドメインモジュール、183のマイグレーション
メモリSQLite FTS5全文検索 + int8量子化ベクトル埋め込み、型付き減衰
スキーマZod 4 — MCPツールI/O検証 + 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以上の追跡されたテストファイル(ユニット、統合、E2E、セキュリティ、エコシステム)にわたる39,000以上の静的テスト宣言
プラットフォームデスクトップ (Electron) · Android (Termux) · PWA (任意のブラウザ)
CI/CDGitHub 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 数変更行数(概算)
1backryun190227,977
2oyi77180407,678
3rdself14580,663
4JxnLexn128387,049
5KooshaPari101125,747
6herjarsa88230,872
7RaviTharuma7955,106
8maxmad64bis69394,715
9artickc5933,260
10HouMinXi5147,334
10chirag127515,153
12xz-dev50245,976
13hartmark4752,185
14rqzbeh39143,181
15dhaern3419,559
16Dingding-leo331,986
17NomenAK3213,854
18MumuTW3016,953
19benzntech2911,641
20pacocartones249,331
20Prudhvivuda246,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
backryun

🥇 GitHub に帰属するコミット 220 件
Paijo
Paijo

🥈 GitHub に帰属するコミット 219 件
Randi
Randi

🥉 GitHub に帰属するコミット 108 件
Ravi Tharuma
Ravi Tharuma

🏅 GitHub に帰属するコミット 81 件
Chris
Chris

🏅 GitHub に帰属するコミット 70 件
Markus Hartung
Markus Hartung

🏅 GitHub に帰属するコミット 69 件 · 同率 6 位
Dizzle
Dizzle

🏅 GitHub に帰属するコミット 69 件 · 同率 6 位
Jan Leon
Jan Leon

🏅 GitHub に帰属するコミット 64 件
zenobit
zenobit

🏅 GitHub に帰属するコミット 62 件
Bob.Hou
Bob.Hou

🏅 GitHub に帰属するコミット 51 件 · 同率 10 位
Xiangzhe
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
Andrew

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

💛 現在継続中の月額スポンサー
Paco Cartones
Paco Cartones

💛 現在の単発スポンサー
Professor Igor Morais Vasconcelos
Prof. Igor Morais

💛 過去の単発支援者
longtao
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 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 に与えた影響
9router26,161このフォークの基盤となった元のプロジェクトです。ここではマルチモーダル API を追加し、TypeScript で全面的に書き直しています。
CLIProxyAPI48,497この JavaScript / TypeScript 移植版の着想源となった Go 実装です。
LiteLLM57,100コスト追跡の同期に使用する公開料金データセットを提供し、プロバイダー正規化モデルがルーティング設計の参考となった AI ゲートウェイです。
codex-chatgpt-web1,410ベンダー化された ChatGPT Web → Codex Responses ブリッジに適用した MIT ライセンスのソースで、ブラウザーセッション、レスポンスフレーミング、使用量、Web 検索の各アダプターが含まれます。
free-claude-code48,112ストリーム復旧、思考なしエイリアス、フォールバック Web 検索、スライディングウィンドウ制限、ログの墨消し、強化されたランチャーフローに移植したパターンです。
composer-api322Cursor Composer のツール選択、出力制約、ツールコミットのパターンをネイティブ Cursor エグゼキューターに適用しました。
codex-multi-auth457新規ログインとリフレッシュトークンのローテーションパターンを Codex OAuth の再認証に移植しました。
opencode-anthropic-auth510Claude Code 互換の変換デフォルト値と課金ヘッダーの動作を、OmniRoute の設定駆動型ブリッジに汎用化しました。
grok2api-merged2Grok のモデルマッピング、偽 TypeError を使用する Statsig ジェネレーター、リクエストとデバイスのデフォルト値、NDJSON レスポンスプロセッサーを、OmniRoute の Grok Web エグゼキューターに実質的に適用しました。
TQZHR/grok2api705grok2api-merged の主要な間接コードソースです。そのモデル、ヘッダー、ペイロード、Statsig、プロセッサーの各実装は、Grok Web の系譜に継承されています。
chenyme/grok2api7,520TQZHR と grok2api-merged を経由して継承された、Grok のペイロードとデバイスのデフォルト値、Statsig ジェネレーター、result.response プロセッサーの基礎となる MIT ライセンスのソースです。
grok2api-pro27grok2api-merged がプロキシプール層の出典として明記している間接ソースです。OmniRoute はその系譜に関する表記を維持していますが、範囲を限定した Grok Web エグゼキューターへプロキシプールを移植したとは主張しません。
GrokProxy50Cookie 認証を使用する Grok プロキシと result.response.token ストリーミングパターンが、OmniRoute の Grok Web トランスポートの参考となりました。
GrokBridge5元の Grok Web 実装では、その HTTP/ブラウザーのアップストリーム設計を参照しました。直接 HTTP パスは GrokProxy から派生しているため、独立したコード移植であるとは主張しません。
grok-web-api14Rust の ChatOptions とレスポンスエンベロープのスキーマが、OmniRoute の TypeScript による Grok リクエスト型およびストリーミングレスポンス型の参考となりました。
### 🗜️ コンテキストとトークンの圧縮 — エンジン
プロジェクト⭐OmniRoute に与えた影響
Caveman100,538「多くのトークンを使う理由ない、少ないトークンでうまくいく」というバイラルプロジェクト — その原始人風の表現哲学が、標準圧縮モードと30以上の冗長語除去・短縮ルールの基盤となっています。
RTK – Rust Token Killer77,185高性能なコマンド出力圧縮 — RTK エンジン、JSON フィルター DSL、生出力の復元、そして RTK → Caveman の多段パイプラインに着想を与えました。
headroom67,310可逆的なコンテキスト圧縮(SmartCrusher) — headroom エンジンと ccr 取得マーカーパターンに着想を与えました。
LLMLingua6,598プロンプト圧縮の研究(LLMLingua / LLMLingua-2) — 非同期でコードセーフ、かつフェイルオープンな llmlingua エンジンに着想を与えました。
llmlingua-2-js31LLMLingua エンジンのワーカースレッド用バックエンドとして使用されている JS/ONNX ポート(MobileBERT / XLM-RoBERTa)です。
Troglodita40ブラジルポルトガル語(pt-BR)のトークン圧縮 — ブラジルポルトガル語の文法に合わせて調整された冗語削減と不要語除去を備える、pt-BR 言語パックの基盤です。
ponytail108,957バイラルな「怠惰なシニア開発者」向け YAGNI コーダースキル — less-code 出力スタイルに着想を与えました。これは、動作する最小限の変更へ誘導して_生成される_コードを削減するもので、Caveman の簡潔な文章に対応する出力軸の機能です。
i-have-adhd23,526行動を第一に考えた ADHD フレンドリーな応答スタイルを、5言語に対応する OmniRoute の簡潔な出力スタイルへ応用しました。
### 🧩 コンパクト形式、トークン研究、コード対応ツール
プロジェクト⭐OmniRoute に与えた影響
TOON25,233トークン指向オブジェクト表記法 — その列指向の「ヘッダー+行」モデルが、表形式圧縮ステージの設計に影響を与えました。
GCF – Graph Compact Format41そのコンパクトなグラフ形式と汎用プロファイル設計が、OmniRoute の表形式圧縮と Headroom コーデック形式の参考になりました。
gcf-typescript4Headroom の汎用プロファイルコーデックとして直接ベンダー化し、拡張した MIT ライセンスの TypeScript 実装です。
token-optimizer-mcp494Brotli/SQLite キャッシュ+セッション単位のコンテキスト差分 — session-dedup エンジンに着想を与えました。
token-savior1,122Bash 出力圧縮+MCP プロファイル — 圧縮を中止する際の規律と、MCP ツールマニフェストの削減に着想を与えました。
token-saver138コンテンツを考慮したファイル形式別の出力圧縮と、失敗を考慮した中止処理 — 種類別のディスパッチと、削減量が最小基準に満たない場合のスキップが妥当であることを裏付けました。
token-optimizer1,951「ゴーストトークンを見つける」 — そのオフロード+復元可能なハンドルというパターンが、CCR のオフロード設計の参考になりました。
TokenMizer28セッショングラフ+ターンをまたぐ行重複排除の設計図が、session-dedup の設計に影響を与えました。
OmniCompress3Rust による列指向 JSON+コンテンツアドレス指定の取得+メッセージ間重複排除 — headroom/ccr/session-dedup エンジンの設計と、キャッシュを安定させる「圧縮形式は位置に依存しない」という不変条件が妥当であることを裏付けました。
mcp-compressor113MCP ツールのスキーマ/説明の圧縮 — MCP ツールマニフェストのカーディナリティ削減の参考になりました。
RepoMapper197Aider スタイルのリポジトリマップランキング — リポジトリマップ/検索ランキングの調査に役立ちました。
quiet-shell-mcp4MCP を介した宣言的なシェル出力削減 — 宣言的な Bash 出力圧縮が妥当であることを裏付けました。
ts-morph6,162TypeScript Compiler API ツールキット — 文字列、テンプレート、正規表現リテラルを保持する、パーサーベースのコメント除去に着想を与えました。
### 🧠 メモリと RAG
プロジェクト⭐OmniRoute が受けた影響
Mem063,902汎用メモリレイヤー — プロキシを読み書きの境界とするモデルが、私たちのメモリアーキテクチャの基礎となりました。
Letta (MemGPT)24,382階層型メモリを備えたステートフルエージェント — 私たちの Context Control & Recovery (CCR) 階層モデルの着想源となりました。
WFGY1,781繰り返し発生する16種類の RAG/LLM 障害モードを分類する ProblemMap — 私たちのトラブルシューティングガイドで使用する共通語彙となりました。
### 🛰️ トラフィック検査、MITM、透過型プロキシ
プロジェクト⭐OmniRoute が受けた影響
llm-interceptor66コーディングアシスタント ↔ LLM 間のトラフィックに対する MITM 傍受/分析は、初期の Traffic Inspector 要件策定に影響を与えました。以前派生していた4つのモジュール — SSE マージ、会話の正規化、シークレットのマスキング、ヘッダーのサニタイズ — は、公開プロトコル標準に基づく独立したクリーンルーム実装に置き換えられています。2つのホストパススルー領域(passthrough.ts と _internal/bypass.cjs)は、独立して分類された OmniRoute 内部実装のままであり、この置き換えの一環として書き直されたものではありません。
ProxyBridge5,995プロセス単位の透過型プロキシルーティング — クラッシュセーフな MITM 終了処理、ソケットのアイドルタイムアウト、/proc によるプロセス帰属判定、TPROXY キャプチャの着想源となりました。
### 📚 モデルデータ、オブザーバビリティ、UI
プロジェクト⭐OmniRoute が受けた影響
models.dev6,555AI モデルの仕様、料金、機能に関するオープンデータベース — 私たちのモデルカタログにネイティブに同期されています。
React Flow / xyflow38,108リアルタイムの Compression Studio と Combo/Routing Studio を支えるノードベースのグラフライブラリです。
LangGraph40,314LangGraph Studio のライブワークフローグラフ可視化が、私たちの Studios におけるリアルタイムのカスケード表示の着想源となりました。
Langfuse33,592トレース → スパン → 生成というオブザーバビリティモデルが、私たちの Compression Studio のウォーターフォール表示の基礎となりました。
Kiali3,631Istio サービスメッシュのオブザーバビリティ — Routing/Combo Studio におけるサーキットブレーカーバッジとエラーエッジ表示の着想源となりました。
lobe-icons2,428私たちのダッシュボード全体でプロバイダーアイコンとして表示される AI/LLM ブランドロゴです。
flag-icons12,354README の言語セレクターで使用される MIT ライセンスの SVG 国旗を提供します。
### 🛡️ セキュリティ
プロジェクト⭐OmniRoute が受けた影響
awesome-secure-defaults721セキュアバイデフォルトのライブラリを厳選したリストであり、私たちのセキュリティ上の選択(Helmet.js、DOMPurify、ssrf-req-filter、safe-regex、Google Tink)の指針となっています。
### 🧭 補完ツール
プロジェクト⭐OmniRoute が受けた影響
ClawRouter6,564リクエストの重複排除、緊急時のゼロコストフォールバック、プラグイン可能な Auto-Combo 戦略、多言語の意図分類の着想源となりました。
Antigravity-Manager30,652アカウントを考慮したモデルの再マッピング、実行可能ファイルのパス検証、プランラベルの動作が、OmniRoute の Antigravity ランタイムの設計に影響を与えました。
vscode-antigravity-cockpit4,817コンパクトなクォータリセットのカウントダウン形式が、OmniRoute における対応するプロバイダー上限表示の着想源となりました。
AionUi32,230ACP 連携が、OmniRoute によるインストール済み CLI エージェントの自動検出の着想源となりました。
CodexBar20,507Grok Build のクォータ取得インターフェースを特定しました。その後 OmniRoute は、実際の通信フォーマットを独自に検証して修正しました。
## 📄 ライセンス MIT License - 詳細は [LICENSE](LICENSE) をご覧ください。 ---
**[⬆ トップに戻る](#-omniroute)** · オープンソースAIコミュニティのために❤️を込めて開発されています。 OmniRoute v3.8.51 · Node ≥22.22.2 · MIT License · omniroute.online