🌐 Languages: 🇺🇸 English · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇮🇹 it · 🇷🇺 ru · 🇨🇳 zh-CN · 🇯🇵 ja · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi · 🇮🇳 in · 🇹🇭 th · 🇻🇳 vi · 🇮🇩 id · 🇲🇾 ms · 🇳🇱 nl · 🇵🇱 pl · 🇸🇪 sv · 🇳🇴 no · 🇩🇰 da · 🇫🇮 fi · 🇵🇹 pt · 🇷🇴 ro · 🇭🇺 hu · 🇧🇬 bg · 🇸🇰 sk · 🇺🇦 uk-UA · 🇮🇱 he · 🇵🇭 phi · 🇧🇷 pt-BR · 🇨🇿 cs · 🇹🇷 tr

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

ユニバーサル API プロキシ - 1 つのエンドポイント、60 以上のプロバイダー、ダウンタイムなし。MCP サーバー (25 ツール)、A2A プロトコル、メモリ/スキルシステム、Electron デスクトップアプリが追加されました。

チャット補完 • 埋め込み • 画像生成 • ビデオ • 音楽 • オーディオ • 再ランキング •Web 検索• MCP サーバー • A2A プロトコル • 100% TypeScript---

🌐 ウェブサイト • 🚀 クイックスタート • 💡 機能 • 📖 ドキュメント • 💰 価格 • 💬 WhatsApp

🖼️ Main Dashboard

📸 Dashboard Preview

<詳細>

クリックするとダッシュボードのスクリーンショットが表示されます

ページ	スクリーンショット
プロバイダー
コンボ
分析
健康
翻訳者
Settings
CLI ツール
使用ログ
エンドポイント

🤖 Free AI Provider for your favorite coding agents

AI を活用した IDE または CLI ツールを、無制限のコーディングのための無料 API ゲートウェイである OmniRoute 経由で接続します。

<テーブル>

オープンクロー
_{⭐ 205K}

ナノボット
_{⭐ 20.9K}

ピコクロー
_{⭐ 14.6K}

ゼロクロー
_{⭐ 9.9K}

アイアンクロー
_{⭐ 2.1K}

オープンコード
_{⭐ 106K}

コーデックス CLI
_{⭐ 60.8K}

クロード・コード
_{⭐ 67.3K}

Gemini CLI
_{⭐ 94.7K}

キロコード
_{⭐ 15.5K}

_{📡 すべてのエージェントは http://localhost:20128/v1 または http://cloud.omniroute.online/v1 経由で接続します - 1 つの構成、無制限のモデルとクォータ}---

🤔 Why OmniRoute?

お金の無駄遣いや限界に達するのはやめましょう:

サブスクリプション割り当ては毎月未使用のまま期限切れになります
レート制限によりコーディングの途中で停止する
高価な API (プロバイダーあたり月額 20 ～ 50 ドル)
プロバイダー間の手動切り替え

OmniRoute はこれを解決します:

✅サブスクリプションを最大化- クォータを追跡し、リセットする前にすべてのビットを使用します
✅自動フォールバック- サブスクリプション → API キー → 安価 → 無料、ダウンタイムなし
✅マルチアカウント- プロバイダーごとのアカウント間のラウンドロビン
✅ユニバーサル- Claude Code、Codex、Gemini CLI、Cursor、Cline、OpenClaw、あらゆる CLI ツールで動作します---

📧 Support

💬コミュニティに参加してください!WhatsApp グループ — ヘルプを取得し、ヒントを共有し、最新情報を入手してください。

-ウェブサイト: omniroute.online -GitHub: github.com/diegosouzapw/OmniRoute -問題: github.com/diegosouzapw/OmniRoute/issues -WhatsApp: コミュニティグループ -寄稿: CONTRIBUTING.md を参照するか、PR を開くか、「良い最初の号」を選択してください。-オリジナルプロジェクト: 9router by decolua### 🐛 Reporting a Bug?

問題を開くときは、system-info コマンドを実行して、生成されたファイルを添付してください。```bash npm run system-info


これにより、Node.js バージョン、OmniRoute バージョン、OS の詳細、インストールされている CLI ツール (qoder、gemini、claude、codex、antigravity、droid など)、Docker/PM2 ステータス、およびシステム パッケージを含む `system-info.txt` が生成されます。これには、問題を迅速に再現するために必要なものがすべて含まれています。ファイルを GitHub の問題に直接添付します。---

## 🔄 How It Works

┌─────────────┐ │ Your CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) │ Tool │ └──────┬──────┘ │ http://localhost:20128/v1 ↓ ┌─────────────────────────────────────────┐ │ OmniRoute (Smart Router) │ │ • Format translation (OpenAI ↔ Claude) │ │ • Quota tracking + Embeddings + Images │ │ • Auto token refresh │ └──────┬──────────────────────────────────┘ │ ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI │ ↓ quota exhausted ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc. │ ↓ budget limit ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) │ ↓ budget limit └─→ [Tier 4: FREE] Qoder, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost


---

## 🎯 What OmniRoute Solves — 30 Real Pain Points & Use Cases

>**AI ツールを使用するすべての開発者は、これらの問題に日々直面しています。**OmniRoute は、コスト超過から地域ブロック、壊れた OAuth フローからプロトコル操作、企業の可観測性まで、それらすべてを解決するために構築されました。

<詳細>
<summary><b>💸 1. 「高額なサブスクリプションの料金を支払っているのに、制限によって中断される」</b></summary>

開発者は、Claude Pro、Codex Pro、または GitHub Copilot に月額 20 ～ 200 ドルを支払います。有料であっても、割り当てには上限があり、5 時間の使用量、週ごとの制限、または分ごとのレート制限があります。コーディング セッションの途中でプロバイダーが応答を停止し、開発者はフローと生産性を失います。

**OmniRoute がそれを解決する方法:**

-**スマート 4 層フォールバック**— サブスクリプション クォータが不足すると、手動介入なしで API キー→格安→無料に自動的にリダイレクトされます。
-**プロバイダー制限の追跡**- キャッシュされたクォータ スナップショットはサーバー側のスケジュール (デフォルトは「PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70」) で更新され、UI で手動更新が可能になります。
-**マルチアカウントのサポート**— 自動ラウンドロビンによるプロバイダーごとの複数のアカウント — 1 つのアカウントがなくなると、次のアカウントに切り替わります
-**カスタム コンボ**— 9 つのバランス戦略 (優先順位、重み付け、フィルファースト、ラウンドロビン、P2C、ランダム、最も使用されていない、コスト最適化、厳密ランダム) を備えたカスタマイズ可能なフォールバック チェーン
-**Codex Business クォータ**— ビジネス/チームのワークスペース クォータをダッシュボードで直接監視</details>

<詳細>
<summary><b>🔌 2. 「複数のプロバイダーを使用する必要があるが、それぞれに異なる API がある」</b></summary>

OpenAI は 1 つの形式を使用し、Claude (Anthropic) は別の形式を使用し、Gemini はさらに別の形式を使用します。開発者が異なるプロバイダーのモデルをテストしたり、プロバイダー間でフォールバックしたりする場合は、SDK を再構成し、エンドポイントを変更し、互換性のない形式に対処する必要があります。カスタム プロバイダー (FriendLI、NIM) には、非標準モデルのエンドポイントがあります。

**OmniRoute がそれを解決する方法:**

-**統合エンドポイント**— 単一の「http://localhost:20128/v1」が 60 を超えるすべてのプロバイダーのプロキシとして機能します
-**フォーマット変換**— 自動かつ透過的: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
-**レスポンスのサニタイズ**— OpenAI SDK v1.83+ を破壊する非標準フィールド (`x_groq`、`usage_breakdown`、`service_tier`) を削除します。
-**ロールの正規化**— 非 OpenAI プロバイダーの場合は「開発者」→「システム」に変換します。 GLM/ERNIEの場合は「システム」→「ユーザー」
-**Think Tag Extraction**— DeepSeek R1 などのモデルから `<think>` ブロックを標準化された `reasoning_content` に抽出します。
-**Gemini の構造化出力**— `json_schema` → `responseMimeType`/`responseSchema` の自動変換
-**`stream` のデフォルトは `false`**— OpenAI 仕様に準拠し、Python/Rust/Go SDK での予期しない SSE を回避します</details>

<詳細>
<summary><b>🌐 3. 「AI プロバイダーが私の地域/国をブロックしています」</b></summary>

OpenAI/Codex などのプロバイダーは、特定の地理的地域からのアクセスをブロックします。ユーザーは、OAuth および API 接続中に「unsupported_country_region_territory」のようなエラーを受け取ります。これは、発展途上国の開発者にとって特にイライラさせられます。

**OmniRoute がそれを解決する方法:**

-**3 レベルのプロキシ構成**— 3 つのレベルで構成可能なプロキシ: グローバル (すべてのトラフィック)、プロバイダーごと (1 つのプロバイダーのみ)、および接続/キーごと
-**色分けされたプロキシ バッジ**— 視覚的なインジケーター: 🟢 グローバル プロキシ、🟡 プロバイダー プロキシ、🔵 接続プロキシ、常に IP を表示
-**プロキシを介した OAuth トークン交換**— OAuth フローもプロキシを通過し、「unsupported_country_region_territory」を解決します
-**プロキシ経由の接続テスト**— 接続テストは構成されたプロキシを使用します (直接バイパスはありません)。
-**SOCKS5 サポート**— アウトバウンド ルーティングに対する SOCKS5 プロキシの完全なサポート
-**TLS フィンガープリント スプーフィング**— 「wreq-js」を介したブラウザーのような TLS フィンガープリントによりボット検出をバイパスします
-**🔏 CLI フィンガープリント マッチング**— ネイティブ CLI バイナリ署名と一致するようにヘッダーと本文フィールドの順序を変更し、アカウントにフラグを立てるリスクを大幅に軽減します。プロキシ IP は保持されます。ステルス**と**IP マスキングの両方を同時に取得できます。</details>

<詳細>
<summary><b>🆓 4. 「コーディングに AI を使用したいが、お金がない」</b></summary>

誰もが AI サブスクリプションに月額 20 ～ 200 ドルを支払えるわけではありません。学生、新興国の開発者、愛好家、フリーランサーは、高品質のモデルに無料でアクセスできる必要があります。

**OmniRoute がそれを解決する方法:**

-**無料利用枠プロバイダーの組み込み**— 100% 無料プロバイダーのネイティブ サポート: Qoder (OAuth 経由の 5 つの無制限のモデル: kimi-k2- Thinking、qwen3-coder-plus、deepseek-r1、minimax-m2、kimi-k2)、Qwen (4 つの無制限のモデル: qwen3-coder-plus、qwen3-coder-flash、qwen3-coder-next、 vision-model)、Kiro (Claude + AWS Builder ID は無料)、Gemini CLI (180,000 トークン/月は無料)
-**Ollama Cloud**— `api.ollama.com` にあるクラウド ホスト型の Ollama モデル (無料の「ライト使用量」レベル)。 `ollamacloud/<model>` プレフィックスを使用します
-**無料のみのコンボ**— チェーン `gc/gemini-3-flash → if/kimi-k2- Thinking → qw/qwen3-coder-plus` = 月額 0 ドル、ダウンタイムなし
-**NVIDIA NIM 無料アクセス**— ~40 RPM 開発 - build.nvidia.com で 70 以上のモデルに永久に無料アクセス (クレジットから純粋なレート制限に移行)
-**コスト最適化戦略**— 利用可能な最も安価なプロバイダーを自動的に選択するルーティング戦略</details>

<詳細>
<summary><b>🔒 5. 「AI ゲートウェイを不正アクセスから保護する必要がある」</b></summary>

AI ゲートウェイをネットワーク (LAN、VPS、Docker) に公開すると、アドレスを持っている人は誰でも開発者のトークン/クォータを消費できます。保護がなければ、API は誤用、即時挿入、悪用に対して脆弱になります。

**OmniRoute がそれを解決する方法:**

-**API キー管理**— 専用の `/dashboard/api-manager` ページを使用したプロバイダーごとの生成、ローテーション、スコープ設定
-**モデルレベルの権限**— すべて許可/制限の切り替えにより、API キーを特定のモデル (`openai/*`、ワイルドカード パターン) に制限します
-**API エンドポイント保護**— `/v1/models` のキーを要求し、リストから特定のプロバイダーをブロックします
-**認証ガード + CSRF 保護**— すべてのダッシュボード ルートは「withAuth」ミドルウェア + CSRF トークンで保護されています
-**レート リミッター**— 構成可能なウィンドウによる IP ごとのレート制限
-**IP フィルタリング**— アクセス制御の許可リスト/ブロックリスト
-**プロンプト インジェクション ガード**— 悪意のあるプロンプト パターンに対するサニタイズ
-**AES-256-GCM 暗号化**— 認証情報は保存時に暗号化されます</details>

<詳細>
<summary><b>🛑 6. 「プロバイダーがダウンし、コーディング フローが失われてしまいました。」</b></summary>

AI プロバイダーが不安定になったり、5xx エラーを返したり、一時的なレート制限に達したりする可能性があります。開発者が単一のプロバイダーに依存している場合、それらは中断されます。サーキット ブレーカーがないと、再試行を繰り返すとアプリケーションがクラッシュする可能性があります。

**OmniRoute がそれを解決する方法:**

-**モデルごとのサーキット ブレーカー**— 設定可能なしきい値とクールダウン (閉/開/半開) による自動開閉、カスケード ブロックを回避するためのモデルごとのスコープ
-**指数バックオフ**— 漸進的な再試行遅延
-**Anti-Thundering Herd**— 同時再試行の嵐に対するミューテックス + セマフォ保護
-**コンボ フォールバック チェーン**- プライマリ プロバイダーに障害が発生した場合、介入なしで自動的にチェーンを通過します。
-**コンボ サーキット ブレーカー**— コンボ チェーン内の障害が発生したプロバイダーを自動的に無効にします
-**ヘルス ダッシュボード**— 稼働時間モニタリング、サーキット ブレーカーの状態、ロックアウト、キャッシュ統計、p50/p95/p99 レイテンシ</details>

<詳細>
<summary><b>🔧 7. 「各 AI ツールの設定は面倒で繰り返しが多い」</b></summary>

開発者は、Cursor、Claude Code、Codex CLI、OpenClaw、Gemini CLI、Kilo Code を使用します。各ツールには異なる構成 (API エンドポイント、キー、モデル) が必要です。プロバイダーや機種変更時に再設定するのは時間の無駄です。

**OmniRoute がそれを解決する方法:**

-**CLI ツール ダッシュボード**— Claude Code、Codex CLI、OpenClaw、Kilo Code、Antigravity、Cline をワンクリックでセットアップできる専用ページ
-**GitHub Copilot Config Generator**— モデルを一括選択して VS Code の `chatLanguageModels.json` を生成します
-**オンボーディング ウィザード**- 初めてユーザー向けのガイド付き 4 ステップ セットアップ
-**1 つのエンドポイント、すべてのモデル**- `http://localhost:20128/v1` を一度構成すると、60 を超えるプロバイダーにアクセスできます</details>

<詳細>
<summary><b>🔑 8. 「複数のプロバイダーからの OAuth トークンを管理するのは地獄です」</b></summary>

Claude Code、Codex、Gemini CLI、Copilot — すべては有効期限切れのトークンを持つ OAuth 2.0 を使用します。開発者は定期的に再認証し、「client_secret is missing」、「redirect_uri_mismatch」、およびリモートサーバー上の障害に対処する必要があります。 LAN/VPS 上の OAuth は特に問題があります。

**OmniRoute がそれを解決する方法:**

-**自動トークン更新**— OAuth トークンは有効期限が切れる前にバックグラウンドで更新されます。
-**OAuth 2.0 (PKCE) ビルトイン**— Claude Code、Codex、Gemini CLI、Copilot、Kiro、Qwen、Qoder の自動フロー
-**マルチアカウント OAuth**— JWT/ID トークン抽出によるプロバイダーごとの複数のアカウント
-**OAuth LAN/リモート修正**— `redirect_uri` のプライベート IP 検出 + リモート サーバーの手動 URL モード
-**Nginx の背後にある OAuth**— リバース プロキシの互換性のために `window.location.origin` を使用します
-**リモート OAuth ガイド**— VPS/Docker での Google Cloud 認証情報のステップバイステップ ガイド</details>

<詳細>
<summary><b>📊 9. 「どこにいくら使っているのか分かりません」</b></summary>

開発者は複数の有料プロバイダーを使用していますが、支出について統一した見解がありません。各プロバイダーには独自の請求ダッシュボードがありますが、統合されたビューはありません。予期せぬ出費がかさむ可能性があります。

**OmniRoute がそれを解決する方法:**

-**コスト分析ダッシュボード**— トークンごとのコスト追跡とプロバイダーごとの予算管理
-**階層ごとの予算制限**— 自動フォールバックをトリガーする階層ごとの支出上限
-**モデルごとの価格構成**— モデルごとに構成可能な価格
-**API キーごとの使用統計**— キーごとのリクエスト数と最後に使用されたタイムスタンプ
-**分析ダッシュボード**— 統計カード、モデル使用状況グラフ、成功率と遅延を含むプロバイダー表</details>

<詳細>
<summary><b>🐛 10. 「AI 呼び出しのエラーや問題を診断できない」</b></summary>

呼び出しが失敗すると、開発者はそれがレート制限なのか、トークンの期限切れなのか、間違った形式なのか、プロバイダーのエラーなのかわかりません。異なる端末間で断片化されたログ。可観測性がなければ、デバッグは試行錯誤になります。

**OmniRoute がそれを解決する方法:**

-**統合ログ ダッシュボード**— 4 つのタブ: リクエスト ログ、プロキシ ログ、監査ログ、コンソール
-**コンソール ログ ビューア**— 色分けされたレベル、自動スクロール、検索、フィルターを備えたリアルタイムのターミナル スタイルのビューア
-**SQLite プロキシ ログ**— サーバーの再起動後も存続する永続的なログ
-**Translator Playground**— 4 つのデバッグ モード: プレイグラウンド (形式変換)、チャット テスター (往復)、テストベンチ (バッチ)、ライブ モニター (リアルタイム)
-**リクエスト テレメトリ**— p50/p95/p99 レイテンシ + X-Request-Id トレース
-**ファイルベースのローテーションによるログ**- アプリのログは、サイズ、保存日数、アーカイブ数に基づいてローテーションされます。通話ログのアーティファクトは保存日数とファイル数によってローテーションされます
-**システム情報レポート**- 「npm run system-info」は、完全な環境 (ノードのバージョン、OmniRoute のバージョン、OS、CLI ツール、Docker/PM2 ステータス) を含む「system-info.txt」を生成します。即時トリアージのために問題を報告するときに添付してください。</details>

<詳細>
<summary><b>🏗️ 11. 「ゲートウェイの導入と保守は複雑です」</b></summary>

さまざまな環境 (ローカル、VPS、Docker、クラウド) 間で AI プロキシをインストール、構成、維持するには、多大な労力がかかります。ハードコードされたパス、ディレクトリの「EACCES」、ポートの競合、クロスプラットフォーム ビルドなどの問題により、摩擦が増大します。

**OmniRoute がそれを解決する方法:**

-**npm global install**— `npm install -gomniroute &&omniroute` — 完了
-**Docker マルチプラットフォーム**— AMD64 + ARM64 ネイティブ (Apple Silicon、AWS Graviton、Raspberry Pi)
-**Docker Compose プロファイル**— `base` (CLI ツールなし) および `cli` (Claude Code、Codex、OpenClaw を含む)
-**Electron デスクトップ アプリ**— システム トレイ、自動起動、オフライン モードを備えた Windows/macOS/Linux 用ネイティブ アプリ
-**分割ポート モード**- 高度なシナリオ (リバース プロキシ、コンテナ ネットワーキング) 向けに個別のポート上の API とダッシュボード
-**Cloud Sync**— Cloudflare Workers を介したデバイス間での設定の同期
-**DB バックアップ**— 外部管理バックアップ用の `DISABLE_SQLITE_AUTO_BACKUP` を使用した、すべての設定の自動バックアップ、復元、エクスポートおよびインポート</details>

<詳細>
<summary><b>🌍 12. 「インターフェースは英語のみで、私のチームは英語を話せません。」</b></summary>

非英語圏の国、特にラテンアメリカ、アジア、ヨーロッパのチームは、英語のみのインターフェースに苦労しています。言語の壁があると採用が減り、構成エラーが増加します。

**OmniRoute がそれを解決する方法:**

-**ダッシュボード i18n — 30 言語**— アラビア語、ブルガリア語、デンマーク語、ドイツ語、スペイン語、フィンランド語、フランス語、ヘブライ語、ヒンディー語、ハンガリー語、インドネシア語、イタリア語、日本語、韓国語、マレー語、オランダ語、ノルウェー語、ポーランド語、ポルトガル語 (PT/BR)、ルーマニア語、ロシア語、スロバキア語、スウェーデン語、タイ語、ウクライナ語、ベトナム語、中国語、フィリピン語、英語
-**RTL サポート**— アラビア語とヘブライ語の右から左へのサポート
-**Multi-Language READMEs**— 30 complete documentation translations
-**言語セレクター**— リアルタイム切り替えのためのヘッダーの地球儀アイコン</details>

<詳細>
<summary><b>🔄 13. 「チャット以上のものが必要です - 埋め込み、画像、音声が必要です」</b></summary>

AIは単なるチャット補完ではありません。開発者は、画像の生成、音声の文字起こし、RAG の埋め込みの作成、ドキュメントの再ランク付け、およびコンテンツの管理を行う必要があります。各 API には異なるエンドポイントと形式があります。

**OmniRoute がそれを解決する方法:**

-**Embeddings**— 6 つのプロバイダーと 9 つ以上のモデルを含む `/v1/embeddings`
-**画像生成**— 10 のプロバイダーと 20 以上のモデル (OpenAI、xAI、Togetter、Fireworks、Nebius、Hyperbolic、NanoBanana、Antigravity、SD WebUI、ComfyUI) を含む `/v1/images/generations`
-**Text-to-Video**— `/v1/videos/generations` — ComfyUI (AnimateDiff、SVD) および SD WebUI
-**Text-to-Music**— `/v1/music/generations` — ComfyUI (Stable Audio Open、MusicGen)
-**音声転写**— `/v1/audio/transcriptions` — Whisper + Nvidia NIM、HuggingFace、Qwen3
-**テキスト読み上げ**— `/v1/audio/speech` — イレブンラボ、Nvidia NIM、HuggingFace、Coqui、Tortoise、Qwen3、**Inworld**、**Cartesia**、**PlayHT**、+ 既存のプロバイダー
-**モデレーション**— `/v1/moderations` — コンテンツの安全性チェック
-**再ランキング**— `/v1/rerank` — ドキュメントの関連性の再ランキング
-**Responses API**— Codex の完全な `/v1/responses` サポート</details>

<詳細>
<summary><b>🧪 14. 「モデル間で品質をテストして比較する方法がない」</b></summary>

開発者は、コード、翻訳、推論などのユースケースにどのモデルが最適であるかを知りたいと考えていますが、手動で比較するのは時間がかかります。統合された評価ツールは存在しません。

**OmniRoute がそれを解決する方法:**

-**LLM 評価**— 挨拶、数学、地理、コード生成、JSON 準拠、翻訳、マークダウン、安全性の拒否をカバーする 10 個の事前ロードされたケースによるゴールデン セット テスト
-**4 つの一致戦略**— `exact`、`contains`、`regex`、`custom` (JS 関数)
-**Translator Playground Test Bench**— 複数の入力と予想される出力を使用したバッチ テスト、クロスプロバイダー比較
-**チャット テスター**— 視覚的な応答レンダリングによる完全な往復
-**ライブ モニター**— プロキシを通過するすべてのリクエストのリアルタイム ストリーム</details>

<詳細>
<summary><b>📈 15. 「パフォーマンスを落とさずにスケールする必要がある」</b></summary>

リクエストの量が増えると、同じ質問をキャッシュしないと重複したコストが発生します。冪等性がないと、重複したリクエストにより処理が無駄になります。プロバイダーごとのレート制限を遵守する必要があります。

**OmniRoute がそれを解決する方法:**

-**セマンティック キャッシュ**— 2 層キャッシュ (署名 + セマンティック) によりコストと遅延が削減されます。
-**リクエストの冪等性**— 同一のリクエストに対する重複排除ウィンドウは 5 秒です
-**レート制限検出**— プロバイダーごとの RPM、最小ギャップ、最大同時トラッキング
-**編集可能なレート制限**— [設定] → [永続性を伴う回復力] で構成可能なデフォルト
-**API キー検証キャッシュ**— 運用パフォーマンスのための 3 層キャッシュ
-**テレメトリ付きヘルス ダッシュボード**— p50/p95/p99 レイテンシ、キャッシュ統計、稼働時間</details>

<詳細>
<summary><b>🤖 16. 「モデルの動作をグローバルに制御したい」</b></summary>

すべての応答を特定の言語、特定の口調で行いたい、または推論トークンを制限したい開発者。すべてのツール/リクエストでこれを設定するのは現実的ではありません。

**OmniRoute がそれを解決する方法:**

-**システム プロンプト インジェクション**— すべてのリクエストに適用されるグローバル プロンプト
-**思考予算検証**— リクエストごとの推論トークン割り当て制御 (パススルー、自動、カスタム、適応)
-**9 ルーティング戦略**— リクエストの分散方法を決定するグローバル戦略
-**ワイルドカード ルーター**— `provider/*` パターンは任意のプロバイダーに動的にルーティングします。
-**コンボ有効/無効切り替え**— ダッシュボードから直接コンボを切り替えます
-**プロバイダー切り替え**— ワンクリックでプロバイダーのすべての接続を有効/無効にします。
-**ブロックされたプロバイダー**— `/v1/models` リストから特定のプロバイダーを除外します</details>

<詳細>
<summary><b>🧰 17. 「一流の製品機能として MCP ツールが必要です」</b></summary>

多くの AI ゲートウェイは、MCP を非表示の実装詳細としてのみ公開します。チームには、目に見えて管理しやすいオペレーション レイヤーが必要です。

**OmniRoute がそれを解決する方法:**

- MCP はダッシュボードのナビゲーションとエンドポイント プロトコル タブに表示されます
- プロセス、ツール、スコープ、監査を備えた専用の MCP 管理ページ
- 「omniroute --mcp」およびクライアントのオンボーディング用の組み込みクイックスタート</details>

<詳細>
<summary><b>🧠 18. 「同期 + ストリーム タスク パスを備えた A2A オーケストレーションが必要です」</b></summary>

エージェント ワークフローには、直接応答と、ライフサイクル制御による長時間実行のストリーミング実行の両方が必要です。

**OmniRoute がそれを解決する方法:**

- A2A JSON-RPC エンドポイント (`POST /a2a`) と `message/send` および `message/stream`
- 端末状態の伝播を伴う SSE ストリーミング
- `tasks/get` および `tasks/cancel` のタスク ライフサイクル API</details>

<詳細>
<summary><b>🛰️ 19. 「推測されたステータスではなく、実際の MCP プロセスの健全性が必要です」</b></summary>

運用チームは、API が到達可能かどうかだけでなく、MCP が実際に生きているかどうかを知る必要があります。

**OmniRoute がそれを解決する方法:**

- PID、タイムスタンプ、トランスポート、ツール数、およびスコープモードを含むランタイムハートビートファイル
- ハートビートと最近のアクティビティを組み合わせた MCP ステータス API
- プロセス/稼働時間/ハートビートの鮮度を示す UI ステータス カード</details>

<詳細>
<summary><b>📋 20. 「監査可能な MCP ツールの実行が必要です」</b></summary>

ツールが構成を変更したり、運用アクションをトリガーしたりする場合、チームはフォレンジックなトレーサビリティを必要とします。

**OmniRoute がそれを解決する方法:**

- MCP ツール呼び出しの SQLite ベースの監査ログ
- ツール、成功/失敗、API キー、ページネーションによるフィルター
- ダッシュボード監査テーブル + 自動化のための統計エンドポイント</details>

<詳細>
<summary><b>🔐 21. 「統合ごとにスコープ指定された MCP 権限が必要です」</b></summary>

異なるクライアントには、ツール カテゴリへの最小限の特権アクセスが必要です。

**OmniRoute がそれを解決する方法:**

- 制御されたツールアクセスのための 10 個の詳細な MCP スコープ
- MCP 管理 UI でのスコープの適用と可視性
- 運用ツールの安全なデフォルト姿勢</details>

<詳細>
<summary><b>⚙️ 22. 「再展開せずに運用管理が必要です」</b></summary>

チームは、インシデントやコスト イベントが発生した際に、実行時の変更を迅速に行う必要があります。

**OmniRoute がそれを解決する方法:**

- MCP ダッシュボードからコンボのアクティブ化を直接切り替えます
- 事前定義されたポリシーパックから復元プロファイルを適用
- 同じ操作パネルからサーキットブレーカーの状態をリセット</details>

<詳細>
<summary><b>🔄 23. 「ライブ A2A タスクのライフサイクルの可視化とキャンセルが必要です」</b></summary>

ライフサイクルの可視性がなければ、タスク インシデントの優先順位付けが困難になります。

**OmniRoute がそれを解決する方法:**

- ページネーションを使用した状態/スキルによるタスクのリスト/フィルタリング
- タスクのメタデータ、イベント、アーティファクトのドリルダウン
- タスクキャンセルエンドポイントと確認付きの UI アクション</details>

<詳細>
<summary><b>🌊 24. 「A2A ロード用のアクティブ ストリーム メトリクスが必要です」</b></summary>

ストリーミング ワークフローには、同時実行性とライブ接続に関する運用上の洞察が必要です。

**OmniRoute がそれを解決する方法:**

- アクティブ ストリーム カウンターが A2A ステータスに統合されました
- 最後のタスクのタイムスタンプと状態ごとのカウント
- リアルタイム運用監視用の A2A ダッシュボード カード</details>

<詳細>
<summary><b>🪪 25. 「クライアント用の標準エージェント検出が必要です」</b></summary>

外部クライアントとオーケストレーターには、オンボーディング用の機械可読メタデータが必要です。

**OmniRoute がそれを解決する方法:**

- エージェント カードは `/.well-known/agent.json` で公開されます
- 管理UIに表示される能力とスキル
- A2A ステータス API には自動化のための検出メタデータが含まれています</details>

<詳細>
<summary><b>🧭 26. 「製品の UX にプロトコルの検出機能が必要です」</b></summary>

ユーザーがプロトコルの表面を発見できない場合、導入とサポートの品質が低下します。

**OmniRoute がそれを解決する方法:**

- プロキシ、MCP、A2A、API エンドポイントのタブを備えた統合された**エンドポイント**ページ
- MCP および A2A のインライン サービス ステータスの切り替え (オンライン/オフライン)
- 概要から専用の管理タブへのリンク</details>

<詳細>
<summary><b>🧪 27. 「実際のクライアントを使用したエンドツーエンドのプロトコル検証が必要です」</b></summary>

模擬テストは、リリース前にプロトコルの互換性を検証するには十分ではありません。

**OmniRoute がそれを解決する方法:**

- アプリを起動し、実際の MCP SDK クライアント トランスポートを使用する E2E スイート
- A2A クライアントは、フローの検出、送信、ストリーミング、取得、キャンセルをテストします。
- MCP 監査および A2A タスク API に対するアサーションのクロスチェック</details>

<詳細>
<summary><b>📡 28. 「すべてのインターフェースにわたって統合された可観測性が必要です」</b></summary>

プロトコルごとに可観測性を分割すると、盲点が生じ、MTTR が長くなります。

**OmniRoute がそれを解決する方法:**

- ダッシュボード/ログ/分析を 1 つの製品に統合
- OpenAI、MCP、A2A レイヤーにわたるヘルス + 監査 + リクエスト テレメトリ
- ステータスと自動化のための運用 API</details>

<詳細>
<summary><b>💼 29. 「プロキシ + ツール + エージェント オーケストレーション用に 1 つのランタイムが必要です」</b></summary>

多くの個別のサービスを実行すると、運用コストが増加し、障害モードが増加します。

**OmniRoute がそれを解決する方法:**

- OpenAI互換プロキシ、MCPサーバー、A2Aサーバーを1つのスタックに搭載
- 共有認証、復元力、データストア、可観測性
- すべての対話面にわたる一貫したポリシー モデル</details>

<詳細>
<summary><b>🚀 30. 「グルーコードのスプロールを発生させずにエージェント ワークフローを出荷する必要がある」</b></summary>

複数のアドホック サービスとスクリプトをつなぎ合わせると、チームの速度が低下します。

**OmniRoute がそれを解決する方法:**

- クライアントとエージェント向けの統合エンドポイント戦略
- 組み込みのプロトコル管理 UI とスモーク検証パス
- 本番環境に対応した基盤 (セキュリティ、ロギング、復元力、バックアップ)</details>

### Example Playbooks (Integrated Use Cases)

**戦略 A: 有料サブスクリプション + 安価なバックアップを最大限に活用する**```txt
Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

Monthly cost: $20 + small backup spend
Outcome: higher quality, near-zero interruption

プレイブック B: ゼロコストのコーディングスタック```txt Combo: "free-forever"

gc/gemini-3-flash
if/kimi-k2-thinking
qw/qwen3-coder-plus

Monthly cost: $0 Outcome: stable free coding workflow


**プレイブック C: 24 時間年中無休の常時オンのフォールバック チェーン**```txt
Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads

プレイブック D: MCP + A2A を使用したエージェントの運用```txt

Start MCP transport (omniroute --mcp) for tool-driven operations
Run A2A tasks via message/send and message/stream
Observe via /dashboard/endpoint (MCP and A2A tabs)
Toggle services via inline status controls


---

## 🆓 Start Free — Zero Configuration Cost

>**$0/月**で AI コーディングを数分でセットアップできます。これらの無料アカウントを接続し、組み込みの**Free Stack**コンボを使用します。

|ステップ |アクション |プロバイダーのロックが解除されました |
| ---- | -------------------------------------------------- | ------------------------------------------------------------------ |
| 1 |**Kiro**に接続 (AWS ビルダー ID OAuth) | Claude Sonnet 4.5、Haiku 4.5 —**無制限**|
| 2 |**Qoder**に接続 (Google OAuth) | kimi-k2- Thinking、qwen3-coder-plus、deepseek-r1... —**無制限**|
| 3 |**Qwen**を接続 (デバイス コード) | qwen3-coder-plus、qwen3-coder-flash... —**無制限**|
| 4 |**Gemini CLI**に接続する (Google OAuth) | gemini-3-flash、gemini-2.5-pro —**180K/月無料**|
| 5 | `/dashboard/combos` →**無料スタック ($0)**テンプレート |すべての無料プロバイダーを自動的にラウンドロビンします。

**任意の IDE/CLI を次のように指定します。**`http://localhost:20128/v1` · API キー: `any-string` · 完了。

>**オプションの追加補償範囲 (こちらも無料):**Groq API キー (30 RPM 無料)、NVIDIA NIM (40 RPM 無料、70 以上のモデル)、Cerebras (100 万トークン/日)、LongCat API キー (5000 万トークン/日!)、Cloudflare Workers AI (10,000 ニューロン/日、50 以上のモデル)。## クイックスタート

### 1) Install and run

```bash
npm install -g omniroute
omniroute

**pnpm ユーザー:**インストール後に pnpmapprove-builds -g を実行して、better-sqlite3 および @swc/core に必要なネイティブビルドスクリプトを有効にします。

「バッシュ」 pnpm install -g オムニルート pnpm accept-builds -g # すべてのパッケージを選択 → 承認オムニルート「」

Dashboard opens at http://localhost:20128 and API base URL is http://localhost:20128/v1.

コマンド	説明
`オムニルート`	サーバーを起動します (`PORT=20128`、API とダッシュボードは同じポート上にあります)
`オムニルート --ポート 3000`	正規/API ポートを 3000 に設定します。
`omniroute --mcp`	MCP サーバー (stdio トランスポート) を開始します。
`omniroute --no-open`	ブラウザを自動的に開かない
`omniroute --help`	ヘルプを表示

オプションの分割ポートモード:```bash PORT=20128 DASHBOARD_PORT=20129 omniroute

API: http://localhost:20128/v1

Dashboard: http://localhost:20129


### Long-Running Streaming Timeouts

ほとんどの展開では、次のものだけが必要です。

|変数 |デフォルト |目的 |
| ------------------------ | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| `REQUEST_TIMEOUT_MS` | `600000` |アップストリームフェッチ、非表示の Undici タイムアウト、TLS フィンガープリントリクエスト、API ブリッジリクエスト/プロキシタイムアウトの共有ベースライン |
| `STREAM_IDLE_TIMEOUT_MS` | `REQUEST_TIMEOUT_MS` を継承します。 OmniRoute が SSE ストリームを中止するまでのストリーミング チャンク間の最大ギャップ |

下位互換性は維持されます。既存の `FETCH_TIMEOUT_MS`、`API_BRIDGE_PROXY_TIMEOUT_MS`、およびその他のレイヤーごとのタイムアウト変数は引き続き機能し、共有ベースラインをオーバーライドします。

Advanced overrides are available if you need finer control:|変数 |デフォルト |目的 |
| -------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------- |
| `FETCH_TIMEOUT_MS` | `REQUEST_TIMEOUT_MS` を継承します。メインのフェッチ中止信号によって使用されるアップストリーム要求タイムアウトの合計 |
| `FETCH_HEADERS_TIMEOUT_MS` | `FETCH_TIMEOUT_MS` を継承します。アップストリーム応答ヘッダーを受信するための Undici 時間制限 |
| `FETCH_BODY_TIMEOUT_MS` | `FETCH_TIMEOUT_MS` を継承します。上流の本体チャンク間の Undici 時間制限 (「0」はそれを無効にします) |
| `FETCH_CONNECT_TIMEOUT_MS` | `30000` | Undici TCP 接続タイムアウト |
| `FETCH_KEEPALIVE_TIMEOUT_MS` | `4000` | Undici アイドル キープアライブ ソケット タイムアウト |
| `TLS_CLIENT_TIMEOUT_MS` | `FETCH_TIMEOUT_MS` を継承します。 「wreq-js」を通じて行われた TLS フィンガープリント要求のタイムアウト |
| `API_BRIDGE_PROXY_TIMEOUT_MS` | `REQUEST_TIMEOUT_MS` または `30000` を継承します。 API ポートからダッシュボード ポートへの「/v1」プロキシ転送のタイムアウト |
| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `max(API_BRIDGE_PROXY_TIMEOUT_MS, 300000)` | API ブリッジ サーバーでの受信リクエストのタイムアウト |
| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | `60000` | API ブリッジ サーバーでの受信ヘッダーのタイムアウト |
| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | `5000` | API ブリッジ サーバーでのキープアライブ タイムアウト |
| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | `0` | API ブリッジ サーバーのソケット非アクティブ タイムアウト (「0」は無効にします) |

Nginx、Caddy、Cloudflare、または別のリバース プロキシの背後で OmniRoute を実行している場合は、プロキシが
タイムアウトも、OmniRoute のストリーム/フェッチ タイムアウトよりも長くなります。### 2) Connect providers and create your API key

1. ダッシュボード → 「プロバイダー」を開き、少なくとも 1 つのプロバイダー (OAuth または API キー) に接続します。
2. 「ダッシュボード」→「エンドポイント」を開き、API キーを作成します。
3. (オプション) [ダッシュボード] → [コンボ] を開き、フォールバック チェーンを設定します。### 3) Point your coding tool to OmniRoute

```txt
Base URL: http://localhost:20128/v1
API Key:  [copy from Endpoint page]
Model:    if/kimi-k2-thinking (or any provider/model prefix)

Claude Code、Codex CLI、Gemini CLI、Cursor、Cline、OpenClaw、OpenCode、OpenAI 互換 SDK で動作します。### 4) Enable and validate protocols (v2.0)

MCP (ツール主導の操作用):```bash omniroute --mcp


次に、MCP クライアントを「stdio」経由で接続し、次のようなツールをテストします。

- `omniroute_get_health`
- `omniroute_list_combos`

**A2A (エージェント間のワークフロー用):**```bash
curl http://localhost:20128/.well-known/agent.json

curl -X POST http://localhost:20128/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}'

5) Validate everything end-to-end (recommended)

npm run test:protocols:e2e

このスイートは、実行中のアプリに対して実際の MCP および A2A クライアントフローを検証します。### Alternative: run from source

cp .env.example .env
npm install
PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev

<詳細>

Void Linux (`xbps-src` テンプレート)

Void Linux ユーザーの場合は、「xbps-src」を使用してネイティブパッケージを構築できます。このブロックを srcpkgs/omniroute/template として保存します。```bash

Template file for 'omniroute'

pkgname=omniroute version=3.4.1 revision=1 hostmakedepends="nodejs python3 make" depends="openssl" short_desc="Universal AI gateway with smart routing for multiple LLM providers" maintainer="zenobit zenobit@disroot.org" license="MIT" homepage="https://github.com/diegosouzapw/OmniRoute" distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz" checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b system_accounts="_omniroute" omniroute_homedir="/var/lib/omniroute" export NODE_ENV=production export npm_config_engine_strict=false export npm_config_loglevel=error export npm_config_fund=false export npm_config_audit=false

do_build() { # Determine target CPU arch for node-gyp local _gyp_arch case "$XBPS_TARGET_MACHINE" in aarch64*) _gyp_arch=arm64 ;; armv7*|armv6*) _gyp_arch=arm ;; i686*) _gyp_arch=ia32 ;; *) _gyp_arch=x64 ;; esac

# 1) Install all deps – skip scripts (no network in do_build, native modules
#    compiled separately below; better-sqlite3 is serverExternalPackage so
#    Next.js does not execute it during next build)
NODE_ENV=development npm ci --ignore-scripts

# 2) Build the Next.js standalone bundle
npm run build

# 3) Copy static assets into standalone
cp -r .next/static .next/standalone/.next/static
[ -d public ] && cp -r public .next/standalone/public || true

# 4) Compile better-sqlite3 native binding for the target architecture.
#    Use node-gyp directly so CC/CXX from xbps-src cross-toolchain are used
#    without npm altering them.
local _node_gyp=/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js
(cd node_modules/better-sqlite3 && node "$_node_gyp" rebuild --arch="$_gyp_arch")

# 5) Place the compiled binding into the standalone bundle
local _bs3_release=.next/standalone/node_modules/better-sqlite3/build/Release
mkdir -p "$_bs3_release"
cp node_modules/better-sqlite3/build/Release/better_sqlite3.node "$_bs3_release/"

# 6) Remove arch-specific sharp bundles – upstream sets images.unoptimized=true
#    so sharp is not used at runtime; x64 .so files would break aarch64 strip
rm -rf .next/standalone/node_modules/@img

# 7) Copy pino runtime deps omitted by Next.js static analysis:
#    pino-abstract-transport – required by pino's worker thread
#    split2 – dep of pino-abstract-transport
#    process-warning – dep of pino itself
for _mod in pino-abstract-transport split2 process-warning; do
	cp -r "node_modules/$_mod" .next/standalone/node_modules/
done

}

do_check() { npm run test:unit }

do_install() { vmkdir usr/lib/omniroute/.next

vcopy .next/standalone/. usr/lib/omniroute/.next/standalone

# Prevent removal of empty Next.js app router dirs by the post-install hook
for _d in \
	.next/standalone/.next/server/app/dashboard \
	.next/standalone/.next/server/app/dashboard/settings \
	.next/standalone/.next/server/app/dashboard/providers; do
	touch "${DESTDIR}/usr/lib/omniroute/${_d}/.keep"
done

cat > "${WRKDIR}/omniroute" <<'EOF'

#!/bin/sh export PORT="${PORT:-20128}" export DATA_DIR="${DATA_DIR:-${XDG_DATA_HOME:-${HOME}/.local/share}/omniroute}" export LOG_TO_FILE="${LOG_TO_FILE:-false}" mkdir -p "${DATA_DIR}" exec node /usr/lib/omniroute/.next/standalone/server.js "$@" EOF vbin "${WRKDIR}/omniroute" }

post_install() { vlicense LICENSE }


</details>

---

## 🐳 Docker

OmniRoute は、[Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute) でパブリック Docker イメージとして利用できます。

**クイック実行:**```bash
docker run -d \
  --name omniroute \
  --restart unless-stopped \
  --stop-timeout 40 \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

環境ファイルあり:```bash

Copy and edit .env first

cp .env.example .env

docker run -d
--name omniroute
--restart unless-stopped
--stop-timeout 40
--env-file .env
-p 20128:20128
-v omniroute-data:/app/data
diegosouzapw/omniroute:latest


**Docker Compose の使用:**```bash
# Base profile (no CLI tools)
docker compose --profile base up -d

# CLI profile (Claude Code, Codex, OpenClaw built-in)
docker compose --profile cli up -d

Docker デプロイメントのダッシュボードのサポートには、「ダッシュボード → エンドポイント」のワンクリックCloudflare Quick Tunnelが含まれるようになりました。最初の有効化では、必要な場合にのみ「cloudflared」をダウンロードし、現在の「/v1」エンドポイントへの一時トンネルを開始し、生成された「https://*.trycloudflare.com/v1」 URL を通常のパブリック URL の直下に表示します。

注:

クイックトンネル URL は一時的なもので、再起動するたびに変更されます。
クイックトンネルは、OmniRoute またはコンテナの再起動後に自動復元されません。必要に応じて、ダッシュボードから再度有効にします。
マネージドインストールは現在、x64 / arm64 上の Linux、macOS、および Windows をサポートしています。
マネージドクイックトンネルは、制約のあるコンテナ環境でのノイズの多い QUIC UDP バッファ警告を回避するために、デフォルトで HTTP/2 トランスポートになります。別のトランスポートが必要な場合は、「CLOUDFLARED_PROTOCOL=quic」または「auto」を設定します。
Docker イメージはシステム CA ルートをバンドルし、管理対象の「cloudflared」に渡します。これにより、トンネルがコンテナ内でブートストラップするときの TLS 信頼障害が回避されます。
SQLite は WAL モードで実行されます。 OmniRoute が最新の変更をチェックポイントで「storage.sqlite」に戻すことができるように、「docker stop」の終了を許可する必要があります。
バンドルされている Compose ファイルには、すでに 40 秒の停止猶予期間が設定されています。イメージを直接実行する場合は、手動停止によってシャットダウンのクリーンアップが中断されないように、「--stop-timeout 40」 (または同様のもの) を維持してください。
OmniRoute でバイナリをダウンロードする代わりに既存のバイナリを使用する場合は、「CLOUDFLARED_BIN=/absolute/path/to/cloudflared」を設定します。

Caddy での Docker Compose の使用 (HTTPS 自動 TLS):

OmniRoute は、Caddy の自動 SSL プロビジョニングを使用して安全に公開できます。ドメインの DNS A レコードがサーバーの IP を指していることを確認してください。```yaml services: omniroute: image: diegosouzapw/omniroute:latest container_name: omniroute restart: unless-stopped volumes: - omniroute-data:/app/data environment: - PORT=20128 - NEXT_PUBLIC_BASE_URL=https://your-domain.com

caddy: image: caddy:latest container_name: caddy restart: unless-stopped ports: - "80:80" - "443:443" command: caddy reverse-proxy --from https://your-domain.com --to http://omniroute:20128

volumes: omniroute-data:


|画像 |タグ |サイズ |説明 |
| ------------------------ | -------- | ------ | --------------------- |
| `diegosouzapw/オムニルート` | `最新` | ～250MB |最新の安定版リリース |
| `diegosouzapw/オムニルート` | `1.0.3` | ～250MB |現在のバージョン |---

## 🖥️ Desktop App — Offline & Always-On

> 🆕**新規!**OmniRoute は、Windows、macOS、Linux の**ネイティブ デスクトップ アプリケーション**として利用できるようになりました。

OmniRoute をスタンドアロンのデスクトップ アプリとして実行します。ローカル モデルにはターミナル、ブラウザ、インターネットは必要ありません。 Electron ベースのアプリには次のものが含まれます。

- 🖥️**ネイティブ ウィンドウ**— システム トレイと統合された専用アプリ ウィンドウ
- 🔄**自動開始**— システムログイン時に OmniRoute を起動します
- 🔔**ネイティブ通知**— クォータの枯渇またはプロバイダーの問題に関するアラートを受け取ります
- ⚡**ワンクリック インストール**— NSIS (Windows)、DMG (macOS)、AppImage (Linux)
- 🌐**オフライン モード**— バンドルされたサーバーを使用して完全にオフラインで動作します### クイックスタート

```bash
# Development mode
npm run electron:dev

# Build for your platform
npm run electron:build         # Current platform
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg) — x64 & arm64
npm run electron:build:linux   # Linux (.AppImage)

System Tray

最小化すると、OmniRoute はシステムトレイに常駐し、簡単なアクションが実行されます。

ダッシュボードを開く
サーバーポートの変更
アプリケーションを終了する

📖 完全なドキュメント: electron/README.md---

💰 Pricing at a Glance

階層	プロバイダー	コスト	クォータのリセット	最適な用途
💳 サブスクリプション	クロード・コード (プロ)	$20/月	5 時間 + 毎週	すでに購読済み
	コーデックス (プラス/プロ)	$20-200/月	5 時間 + 毎週	OpenAI ユーザー
	ジェミニ CLI	無料	180K/月 + 1K/日	みんな！
	GitHub コパイロット	$10-19/月	月刊	GitHub ユーザー
🔑 API キー	NVIDIA NIM	無料(開発は永久に)	~40 RPM	70 以上のオープンモデル
	大脳	FREE(1M tok/day)	60K TPM / 30 RPM	世界最速
	グロク	無料(30 RPM)	14.4K RPD	超高速ラマ/ジェマ
	ディープシーク V3.2	100 万あたり $0.27/$1.10	なし	最高の価格/品質の理由
	xAI Grok-4 高速	100 万あたり $0.20/$0.50🆕	なし	最速 + ツール呼び出し、超低コスト
	xAI Grok-4 (標準)	100 万あたり $0.20/$1.50 🆕	なし	xAI の推論フラッグシップ
	ミストラル	無料トライアル + 有料	レート制限	ヨーロッパのAI
	オープンルーター	従量課金制	なし	合計 100 以上のモデル
💰安い	GLM-5 (Z.AI経由) 🆕	$0.5/100万	毎日午前 10 時	128K 出力、最新のフラッグシップ
	GLM-4.7	$0.6/100万	毎日午前 10 時	予算のバックアップ
	ミニマックス M2.5 🆕	100 万ドルあたり 0.3 ドルの入力	5時間ローリング	推論 + エージェントタスク
	ミニマックス M2.1	$0.2/100万	5時間ローリング	最も安いオプション
	キミ K2.5 (ムーンショット API) 🆕	従量課金制	None	Moonshot API への直接アクセス
	キミ K2	月額 9 ドルのフラット	1,000 万トークン/月	予測可能なコスト
🆓 無料	コーダー	$0	無制限	5モデル無制限
	クウェン	$0	無制限	4モデル無制限
	キロ	$0	無制限	クロード・ソネット/俳句 (AWS ビルダー)
	LongCat Flash-Lite 🆕	$0(5,000 万トーク/日 🔥)	1 RPS	地球上で最大の無料割り当て
	受粉 AI 🆕	$0(キーは必要ありません)	1 リクエスト/15 秒	GPT-5、クロード、ディープシーク、ラマ 4
	Cloudflare ワーカー AI 🆕	$0(10,000 ニューロン/日)	~150 回/日	50 を超えるモデル、グローバルエッジ
	スケールウェイ AI 🆕	$0(合計 100 万トークン)	レート制限	EU/GDPR、Qwen3 235B、ラマ 70B	> 🆕新しいモデルの追加 (2026 年 3 月):$0.20/$0.50/M の Grok-4 Fast ファミリ (1143 ミリ秒でベンチマーク - Gemini 2.5 フラッシュより 30% 高速)、128K 出力の Z.AI 経由の GLM-5、MiniMax M2.5 推論、DeepSeek V3.2 の最新価格、Moonshot direct API 経由の Kim K2.5。

💡 $0 コンボスタック — 完全な無料セットアップ:```

🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever

Kiro (kr/) → Claude Sonnet/Haiku UNLIMITED Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED LongCat Lite (lc/) → LongCat-Flash-Lite — 50M tokens/day 🔥 Pollinations (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — no key needed Qwen (qw/) → qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next UNLIMITED Gemini (gemini/) → Gemini 2.5 Flash — 1,500 req/day free API key Cloudflare AI (cf/) → Llama 70B, Gemma 3, Mistral — 10K Neurons/day Scaleway (scw/) → Qwen3 235B, Llama 70B — 1M free tokens (EU) Groq (groq/) → Llama/Gemma ultra-fast — 14.4K req/day NVIDIA NIM (nvidia/) → 70+ open models — 40 RPM forever Cerebras (cerebras/) → Llama/Qwen world-fastest — 1M tok/day


**コストゼロ。コーディングを決してやめません。**これを 1 つの OmniRoute コンボとして設定すると、すべてのフォールバックが自動的に行われ、手動で切り替える必要はありません。---

---

## 🆓 Free Models — What You Actually Get

> 以下のすべてのモデルは**完全に無料で、クレジット カードは必要ありません**。 OmniRoute は、1 つのクォータがなくなると、それらの間で自動ルーティングを行います。すべてを組み合わせて、破ることのできない $0 コンボを実現します。### 🔵 CLAUDE MODELS (via Kiro — AWS Builder ID)

|モデル |プレフィックス |制限 |レート制限 |
| ------------------- | ------ | ------------- | --------------------- |
| `クロード・ソネット-4.5` | `kr/` |**無制限**| 1 日あたりの上限は報告されていません |
| `クロード俳句-4.5` | `kr/` |**無制限**| 1 日あたりの上限は報告されていません |
| `クロード作品-4.6` | `kr/`  |**無制限**| Kiro 経由の最新作品 |### 🟢 QODER MODELS (Free PAT via qodercli)

|モデル |プレフィックス |制限 |レート制限 |
| ------------------ | ------ | ------------- | --------------- |
| `kimi-k2-thing` | `if/` |**無制限**|報告された上限はありません |
| `qwen3-coder-plus` | `if/` |**無制限**|報告された上限はありません |
| `ディープシーク-r1` | `if/` |**無制限**|報告された上限はありません |
| `ミニマックス-m2.1` | `if/` |**無制限**|報告された上限はありません |
| `kimi-k2` | `if/` |**無制限**|報告された上限はありません |

> 推奨される接続方法:**パーソナル アクセス トークン + `qodercli`**。 Browser OAuth is
> 実験的であり、`QODER_OAUTH_*` 環境変数が設定されていない限り、デフォルトで無効になっています。### 🟡 QWEN MODELS (Device Code Auth)

|モデル |プレフィックス |制限 |レート制限 |
| ------------------- | ------ | ------------- | ------------------- |
| `qwen3-coder-plus`  | `qw/` |**無制限**|報告された上限はありません |
| `qwen3-コーダー-フラッシュ` | `qw/` |**無制限**|報告された上限はありません |
| `qwen3-coder-next` | `qw/` |**無制限**|報告された上限はありません |
| `ビジョンモデル` | `qw/` |**無制限**|マルチモーダル (画像) |### 🟣 GEMINI CLI (Google OAuth)

|モデル |プレフィックス |制限 |レート制限 |
| ------------------------ | ------ | ------------------------- | ------------- |
| `gemini-3-フラッシュ-プレビュー` | `gc/` |**180,000 トーク/月**+ 1,000 トーク/日 |毎月のリセット |
| `ジェミニ-2.5-プロ` | `gc/` | 180K/月 (共有プール) |高品質 |### ⚫ NVIDIA NIM (Free API Key — build.nvidia.com)

|階層 | 1 日あたりの制限 |レート制限 |メモ |
| ---------- | ------------ | ----------- | -------------------------------------------------------- |
|無料 (開発) |トークンキャップなし |**~40 RPM**| 70以上のモデル; 2025 年半ばに純粋なレート制限に移行 |

人気の無料モデル: `moonshotai/kimi-k2.5` (Kimi K2.5)、`z-ai/glm4.7` (GLM 4.7)、`deepseek-ai/deepseek-v3.2` (DeepSeek V3.2)、`nvidia/llama-3.3-70b-instruct`、`deepseek/deepseek-r1`### ⚪ CEREBRAS (Free API Key — inference.cerebras.ai)

|階層 | 1 日あたりの制限 |レート制限 |メモ |
| ---- | ----------------- | ---------------- | ------------------------------------------ |
|無料 |**100 万トークン/日**| 60K TPM / 30 RPM |世界最速の LLM 推論。毎日リセット |

無料で入手可能: `llama-3.3-70b`、`llama-3.1-8b`、`deepseek-r1-distill-llama-70b`### 🔴 GROQ (Free API Key — console.groq.com)

|階層 | 1 日あたりの制限 |レート制限 |メモ |
| ---- | ------------- | ---------------- | -------------------------------------- |
|無料 |**14.4K RPD**|モデルごとに 30 RPM |クレジットカードはありません。 429 が制限、課金されない |

無料で入手可能: `llama-3.3-70b-versatile`、`gemma2-9b-it`、`mixtral-8x7b`、`whisper-large-v3`### 🔴 LONGCAT AI (Free API Key — longcat.chat) 🆕

|モデル |プレフィックス |毎日の無料割り当て |メモ |
| ----------------------------- | ------ | ----------------- | ----------------------- |
| `LongCat-Flash-Lite` | `lc/` |**5,000 万トークン**💥 |史上最大の無料割り当て |
| `LongCat-Flash-Chat` | `lc/` | 500K トークン |マルチターンチャット |
| `LongCat-Flash-Thinking` | `lc/` | 500K トークン |推論/CoT |
| `LongCat-Flash-Thinking-2601` | `lc/` | 500K トークン | 2026年1月版 |
| `LongCat-Flash-Omni-2603` | `lc/` | 500K トークン |マルチモーダル |

> パブリックベータ版の間は完全に無料です。 [longcat.chat](https://longcat.chat) にメールまたは電話で登録してください。毎日 00:00 UTC にリセットされます。### 🟢 POLLINATIONS AI (No API Key Required) 🆕

|モデル |プレフィックス |レート制限 |背後のプロバイダー |
| ---------- | ------ | ---------- | ------------------ |
| `オープンナイ` | `ポール/` | 1 リクエスト/15 秒 | GPT-5 |
|クロード`ポール/` | 1 リクエスト/15 秒 |人間のクロード |
|ジェミニ`ポール/` | 1 リクエスト/15 秒 | Google ジェミニ |
| `ディープシーク` | `ポール/` | 1 リクエスト/15 秒 |ディープシーク V3 |
|ラマ`ポール/` | 1 リクエスト/15 秒 |メタラマ 4 スカウト |
| `ミストラル` | `ポール/` | 1 リクエスト/15 秒 |ミストラルAI |

> ✨**摩擦ゼロ:**サインアップも API キーも必要ありません。空のキーフィールドを使用して Pollinations プロバイダーを追加すると、すぐに機能します。### 🟠 CLOUDFLARE WORKERS AI (Free API Key — cloudflare.com) 🆕

|階層 |デイリーニューロン |同等の使用法 |メモ |
| ---- | ------------- | -------------------------------------- | ----------------------- |
|無料 |**10,000**| ~150 LLM 対応 / 500 秒オーディオ / 15K 埋め込み |グローバル エッジ、50 以上のモデル |

人気のある無料モデル: `@cf/meta/llama-3.3-70b-instruct`、`@cf/google/gemma-3-12b-it`、`@cf/openai/whisper-large-v3-turbo` (無料音声!)、`@cf/qwen/qwen2.5-coder-15b-instruct`

> [dash.cloudflare.com](https://dash.cloudflare.com) からの API トークン + アカウント ID が必要です。アカウント ID をプロバイダー設定に保存します。### 🟣 SCALEWAY AI (1M Free Tokens — scaleway.com) 🆕

|階層 |無料割り当て |場所 |メモ |
| ---- | ------------- | ------------ | ----------------------------------- |
|無料 |**100 万トークン**| 🇫🇷 パリ、EU |制限内ではクレジットカードは必要ありません |

無料で入手可能: `qwen3-235b-a22b-instruct-2507` (Qwen3 235B!)、`llama-3.1-70b-instruct`、`mistral-small-3.2-24b-instruct-2506`、`deepseek-v3-0324`

> EU/GDPR に準拠。 [console.scaleway.com](https://console.scaleway.com) で API キーを取得します。

>**💡 究極の無料スタック (11 プロバイダー、永久に $0):**
>
>「」
> Kiro (kr/) → クロード・ソネット/Haiku UNLIMITED
> Qoder (if/) → kimi-k2- Thinking、qwen3-coder-plus、deepseek-r1 UNLIMITED
> LongCat Lite (lc/) → LongCat-Flash-Lite — 5,000 万トークン/日 🔥
> 受粉 (pol/) → GPT-5、Claude、DeepSeek、Llama 4 — キーは必要ありません
> Qwen (qw/) → qwen3-coder モデル無制限
> Gemini (gemini/) → Gemini 2.5 Flash — 1,500 リクエスト/日無料
> Cloudflare AI (cf/) → 50 以上のモデル — 10,000 ニューロン/日
> Scaleway (scw/) → Qwen3 235B、Llama 70B — 100 万の無料トークン (EU)
> Groq (groq/) → ラマ/ジェマ — 14.4K 要求/日の超高速
> NVIDIA NIM (nvidia/) → 70 以上のオープン モデル — 永久に 40 RPM
> Cerebras (cerebras/) → ラマ/クウェン世界最速 — 100 万トーク/日
>「」## 🎙️ Free Transcription Combo

> あらゆるオーディオ/ビデオを**$0**で文字起こし — Deepgram は 200 ドルを無料、AssemblyAI は 50 ドルのフォールバック、無制限の緊急バックアップとして Groq Whisper を提供します。

|プロバイダー |無料クレジット |ベストモデル |レート制限 |
| ----------------- | ---------------------- | -------------------------------------------- | ---------------------------- |
| 🟢**ディープグラム**|**200 ドル無料**(サインアップ) | `nova-3` — 最高の精度、30 以上の言語 |無料クレジットには RPM 制限なし |
| 🔵**AssemblyAI**|**50 ドル無料**(サインアップ) | 「universal-3-pro」 — 章、センチメント、PII |無料クレジットには RPM 制限なし |
| 🔴**グロク**|**永久無料**| `whisper-large-v3` — OpenAI ウィスパー | 30 RPM (レート制限) |

**「/dashboard/combos」内の推奨コンボ:**```
Name: free-transcription
Strategy: Priority
Nodes:
  [1] deepgram/nova-3          → uses $200 free first
  [2] assemblyai/universal-3-pro → fallback when Deepgram credits run out
  [3] groq/whisper-large-v3    → free forever, emergency fallback

次に、「/dashboard/media」→「文字起こし」タブで、オーディオまたはビデオファイルをアップロードし、コンボエンドポイントを選択し、サポートされている形式で文字起こしを取得します。## 💡 Key Features

OmniRoute v2.0 は、単なるリレープロキシではなく、運用プラットフォームとして構築されています。### 🆕 New — ClawRouter-Inspired Improvements (Mar 2026)

特集	何をするのか
⚡Grok-4 高速ファミリー	xAI モデルは $0.20/$0.50/M です — ベンチマークでは 1143 ミリ秒 (Gemini 2.5 フラッシュより 30% 高速)
🧠GLM-5 (Z.AI 経由)	128K 出力コンテキスト、0.5/100 万ドル — GLM ファミリの最新フラッグシップ
🔮ミニマックス M2.5	推論 + エージェントタスクを $0.30/1M で – M2.1 からの大幅なアップグレード
🎯モデルごとのツール呼び出しフラグ	レジストリ内のモデルごとの `toolCalling: true/false` — AutoCombo はツール非対応モデルをスキップします。
🌍多言語の意図の検出	オートコンボスコアリングにおける PT/ZH/ES/AR キーワード — 英語以外のコンテンツに対するより適切なモデル選択
📊ベンチマーク主導のフォールバック	ライブリクエストからの実際の p95 レイテンシがコンボスコアリングにフィード — AutoCombo は実際のデータから学習
🔁重複排除をリクエスト	コンテンツハッシュベースの重複排除ウィンドウ - マルチエージェントで安全、重複請求を防止
🔌プラグイン可能なルーター戦略	拡張可能な「RouterStrategy」インターフェイス — カスタムルーティングロジックをプラグインとして追加します。### 🚀 Previous v2.0.9+ — Playground, CLI Fingerprints & ACP

特集	何をするのか
🎮モデルの遊び場	任意のモデルを直接テストするためのダッシュボードページ — プロバイダー/モデル/エンドポイントセレクター、モナコエディター、ストリーミング、中止、タイミング
🔏CLI 指紋照合	ネイティブ CLI 署名と一致するようにプロバイダーごとにヘッダー/本文を順序付けします。[設定] > [セキュリティ] でプロバイダーごとに切り替えます。プロキシ IP は保持されます
🤝ACP サポート (エージェントクライアントプロトコル)	CLI エージェント検出 (Codex、Claude、Goose、Gemini CLI、OpenClaw + その他 9 つ)、プロセススポーナー、`/api/acp/agents` エンドポイント
🤖ACP エージェントダッシュボード	デバッグ › エージェントページ — インストールステータス、バージョン、CLI ツールのカスタムエージェントフォームを含む 14 個のエージェントのグリッド。OpenCodeユーザーには、利用可能なすべてのモデルですぐに使用できる構成を自動生成する [opencode.json をダウンロード] ボタンが表示されます。
🔧カスタムモデル `apiFormat` ルーティング	`apiFormat: "responses"` を持つカスタムモデルは、Responses API トランスレーターに正しくルーティングされるようになりました。
🏢Codex ワークスペースの分離	電子メールごとに複数の Codex ワークスペース - OAuth はワークスペース ID によって接続を正しく分離します。
🔄Electron 自動アップデート	デスクトップアプリがアップデートをチェックし、再起動時に自動インストール	### 🤖 Agent & Protocol Operations (v2.0)

特集	何をするのか
🔧MCP サーバー (25 ツール)	3 つのトランスポート経由の IDE/エージェントツール: stdio、SSE (`/api/mcp/sse`)、ストリーミング可能な HTTP (`/api/mcp/stream`)。 18 コア + 3 メモリ + 4 スキルツール
🤝A2A サーバー (JSON-RPC + SSE)	同期およびストリーミングフローを使用したエージェント間のタスクの実行
🧭統合エンドポイントページ	[エンドポイントプロキシ]、[MCP]、[A2A]、および [API エンドポイント] タブを備えたタブ付き管理ページ
🎚️サービスの有効化/無効化の切り替え	設定永続性を備えた MCP および A2A の ON/OFF スイッチ (デフォルト: OFF)
🛰️MCP ランタイムハートビート	実際のプロセスステータス (pid、稼働時間、ハートビート経過時間、トランスポート、スコープモード)
📋MCP 監査証跡	成功/失敗およびキーの属性を含むフィルタリング可能な監査ログ
🔐MCP スコープの適用	制御されたツールアクセスのための 10 の詳細な範囲の権限
📡A2A タスクライフサイクル管理	タスクのリスト/フィルター、イベント/アーティファクトの検査、実行中のタスクのキャンセル
📋エージェントカードの検出	クライアント自動検出用の `/.well-known/agent.json`
🧪プロトコル E2E テストハーネス	`test:protocols:e2e` での実際の MCP SDK + A2A クライアントフロー
⚙️運用管理	1 つのコントロールサーフェスからコンボを切り替え、レジリエンスプロファイルを適用し、ブレーカーをリセット	### 🧠 Routing & Intelligence

特集	何をするのか
🎯スマート 4 層フォールバック	自動ルート: サブスクリプション → API キー → 格安 → 無料
📊リアルタイムのクォータ追跡	プロバイダーごとのライブトークン数 + リセットカウントダウン
🔄フォーマット変換	OpenAI ↔ Claude ↔ Gemini ↔ スキーマセーフな変換による応答
👥マルチアカウントのサポート	インテリジェントな選択によるプロバイダーごとの複数のアカウント
🔄自動トークン更新	OAuth トークンは再試行によって自動的に更新されます。
🎨カスタムコンボ	9 つのバランシング戦略 + フォールバックチェーン制御
🌐ワイルドカードルーター	`provider/*` 動的ルーティング
🧠予算管理について考える	パススルー、自動、カスタム、および適応推論の制限
🔀モデルのエイリアス	組み込み + カスタムモデルのエイリアシングと移行の安全性
⚡背景の劣化	優先度の低いバックグラウンドタスクを安価なモデルにルーティングする
🧪タスク認識型スマートルーティング	コンテンツタイプ (コーディング/ビジョン/分析/要約) によるモデルの自動選択
🔄A2A エージェントのワークフロー	ステートフルな複数ステップのエージェント実行のための決定論的 FSM オーケストレーター
🔀適応ルーティング	トークン量とプロンプトの複雑さに基づいた動的な戦略オーバーライド
🎲プロバイダーの多様性	シャノンのエントロピースコアリングバランシングオートコンボトラフィック分散
💬システムプロンプトインジェクション	一貫して適用されるグローバルな動作制御
📄レスポンス API の互換性	Codex および高度なエージェントワークフローの完全な `/v1/responses` サポート	### 🎵 Multi-Modal APIs

特集	何をするのか
🖼️画像生成	クラウドとローカルのバックエンドを備えた `/v1/images/generations`
📐埋め込み	検索および RAG パイプライン用の `/v1/embeddings`
🎤音声文字起こし	`/v1/audio/transcriptions` — 7 プロバイダー (Deepgram Nova 3、AssemblyAI、Groq Whisper、HuggingFace、イレブンラボ、OpenAI、Azure)、自動言語検出、MP4/MP3/WAV サポート
🔊テキスト読み上げ	`/v1/audio/speech` — 10 プロバイダー (Celebrities、OpenAI、Deepgram、Cartesia、PlayHT、HuggingFace、Nvidia NIM、Inworld、Coqui、Tortoise) と正しいエラーメッセージ
🎬ビデオ生成	`/v1/videos/generations` (ComfyUI + SD WebUI ワークフロー)
🎵音楽生成	`/v1/music/generations` (ComfyUI ワークフロー)
🛡️モデレーション	`/v1/moderations` の安全性チェック
🔀再ランキング	関連性スコアリング用の `/v1/rerank`
🔍ウェブ検索🆕	`/v1/search` — 5 プロバイダー (Serper、Brave、Perplexity、Exa、Tavily)、6,500 以上無料/月、自動フェイルオーバー、キャッシュ	### 🛡️ Resilience, Security & Governance

特集	何をするのか
🔌サーキットブレーカー	閾値制御によるモデルごとのトリップ/リカバリ
🎯エンドポイント対応モデル	カスタムモデルは、サポートされるエンドポイント + API 形式を宣言します。
🛡️対雷鳴の群れ	再試行/レートイベントにおけるミューテックス + セマフォ保護
🧠セマンティック + 署名キャッシュ	2 つのキャッシュ層によるコスト/遅延の削減
⚡冪等性のリクエスト	重複保護ウィンドウ
🔒TLS 指紋スプーフィング	ブラウザのような TLS フィンガープリント —ボットの検出とアカウントのフラグ付けを削減します
🔏CLI 指紋照合	ネイティブ CLI リクエスト署名と一致 —プロキシ IP を保持しながら禁止リスクを軽減
🌐IP フィルタリング	公開された展開のホワイトリスト/ブロックリストの制御
📊編集可能なレート制限	永続性を備えた構成可能なグローバル/プロバイダーレベルの制限
📉グレースフルデグラデーション	コアゲートウェイの動作を保護するマルチレイヤー機能フォールバック
📜構成監査証跡	差分ベースの変更追跡により、単純なロールバックで運用上のドリフトを防止
⏳プロバイダーヘルス同期	プロアクティブなトークン有効期限監視により、認証が失敗する前にアラートをトリガー
🚪禁止されたアカウントを自動的に無効にする	永久にブロックされたトークンアカウントを自動的に封印する運用上のサーキットブレーカー
🔑API キー管理 + スコーピング	安全なキーの発行/ローテーションとモデル/プロバイダーの制御
👁️スコープ指定された API キーの公開🆕	`ALLOW_API_KEY_REVEAL` による API キーのオプトイン回復
🛡️保護された `/models`	モデルカタログのオプションの認証ゲートとプロバイダーの非表示	### 📊 Observability & Analytics

特集	何をするのか
📝リクエスト + プロキシログ	完全なリクエスト/レスポンスとプロキシログ
📉ストリーミングされた詳細ログ🆕	SSE ペイロードストリームを UI にきれいに再構築します。
📋統合ログダッシュボード	リクエスト、プロキシ、監査、およびコンソールのビューを 1 ページに表示
🔍テレメトリのリクエスト	p50/p95/p99 レイテンシーとリクエストのトレース
🏥健康ダッシュボード	稼働時間、ブレーカー状態、ロックアウト、キャッシュ統計
💰コスト追跡	予算管理とモデルごとの価格の可視性
📈分析の視覚化	モデル/プロバイダーの使用状況に関する洞察と傾向ビュー
🧪評価フレームワーク	構成可能な一致戦略を使用したゴールデンセットテスト
📡ライブ診断🆕	正確なコンボライブテストのためのセマンティックキャッシュバイパス	### ☁️ Deployment & Platform

特集	何をするのか
🌐どこにでも展開	Localhost、VPS、Docker、クラウド環境
🚇クラウドフレアトンネル🆕	ダッシュボードからのワンクリックのクイックトンネル統合
🔑API キーモデルのフィルタリング	割り当てられたベアラーコンテキストロールによってフィルタリングされたネイティブ /v1/models 応答
⚡スマートキャッシュバイパス	構成可能な TTL ヒューリスティックと強制再フェッチ制御
🔄バックアップ/復元	エクスポート/インポートと災害復旧フロー
🧙オンボーディングウィザード	初回実行のガイド付きセットアップ
🔧CLI ツールダッシュボード	人気のコーディングツールをワンクリックでセットアップ
🎮モデルの遊び場	ダッシュボードから任意のプロバイダー/モデル/エンドポイントをテストします。
🔏CLI 指紋切り替え	[設定] > [セキュリティ]	でのプロバイダーごとの指紋照合
🌐i18n (30 言語)	RTL をカバーする完全なダッシュボード + ドキュメント言語サポート
🧹すべてのモデルをクリア	ワンクリックでプロバイダー詳細のモデルリストをクリア
👁️サイドバーコントロール🆕	外観設定からコンポーネントと統合を非表示にする
📋問題テンプレート	バグと機能用の標準化された GitHub テンプレート
📂カスタムデータディレクトリ	格納場所の `DATA_DIR` オーバーライド	### Feature Deep Dive

Smart fallback with practical cost control

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6
  2. nvidia/llama-3.3-70b
  3. glm/glm-4.7
  4. if/kimi-k2-thinking

クォータ、レート、またはヘルスに障害が発生した場合、OmniRoute は手動で切り替えることなく、次の候補に自動的に移動します。#### Protocol management that is visible and operable

MCP + A2A は UI とドキュメントで検出可能です (非表示ではありません)
プロトコルステータス API はライブ運用データを公開します (/api/mcp/*、/api/a2a/*)
ダッシュボードには 2 日目の操作のアクション (コンボの切り替え、ブレーカーのリセット、タスクのキャンセル) が含まれています#### Translator + validation workflow

翻訳領域には次のものが含まれます。

-プレイグラウンド: 変換チェックをリクエストします -チャットテスター: 完全なリクエスト/レスポンスの往復 -テストベンチ: 1 回の実行で複数のケース -ライブモニター: リアルタイムの交通状況ビュー

さらに、「npm run test:protocols:e2e」による実際のクライアントでのプロトコル検証。

📖MCP サーバー README— ツールリファレンス、IDE 構成、およびクライアントの例

📖A2A サーバー README— スキル、JSON-RPC メソッド、ストリーミング、タスクのライフサイクル## 🧪 Evaluations (Evals)

OmniRoute には、ゴールデンセットに対して LLM 応答品質をテストするための評価フレームワークが組み込まれています。ダッシュボードのAnalytics → Evalsからアクセスします。### Built-in Golden Set

プリロードされた「OmniRoute Golden Set」には、次のテストケースが含まれています。

挨拶、数学、地理、コード生成
JSON形式への準拠、翻訳、マークダウン生成
安全拒否（有害なコンテンツ）、カウント、ブール論理### Evaluation Strategies

戦略	説明	例
'正確'	出力は正確に一致する必要があります	`"4"`
`を含む`	出力には部分文字列が含まれている必要があります (大文字と小文字は区別されません)。「パリ」
`正規表現`	出力は正規表現パターンと一致する必要があります	`"1.2.3"`
`カスタム`	カスタム JS 関数は true/false を返します。 `(出力) => 出力.長さ > 10`	---

📖 Setup Guide

Protocol Setup (MCP + A2A)

<詳細>

🧩 MCP セットアップ (モデルコンテキストプロトコル)

MCP トランスポートを標準入出力モードで開始します。```bash omniroute --mcp


推奨される検証フロー:

1. MCP クライアントを標準入出力経由で接続します。
2. 「omniroute_get_health」を実行します。
3. 「omniroute_list_combos」を実行します。
4. 「/dashboard/mcp」を開いて、ハートビート、アクティビティ、および監査を確認します。

自動化に役立つ API:

- `/api/mcp/statusを取得`
- `/api/mcp/tools` を取得します
- `GET /api/mcp/audit`
- `/api/mcp/audit/stats` を取得します</details>

<詳細>
<summary><b>🤝 A2A セットアップ (Agent2Agent)</b></summary>

エージェントを検出します。```bash
curl http://localhost:20128/.well-known/agent.json

タスクを送信します。```bash curl -X POST http://localhost:20128/a2a
-H 'content-type: application/json'
-d '{"jsonrpc":"2.0","id":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'


ライフサイクルを管理する:

- `GET /api/a2a/status`
- `/api/a2a/tasks`を取得します
- `GET /api/a2a/tasks/:id`
- `POST /api/a2a/tasks/:id/cancel`

操作UI:

- タスク/状態/ストリームの可観測性とスモークアクション用の「/dashboard/a2a」</details>

<詳細>
<summary><b>🧪 エンドツーエンドのプロトコル検証</b></summary>

実際のクライアントを使用して両方のプロトコルを検証します。```bash
npm run test:protocols:e2e

これにより以下が検証されます。

MCP SDK クライアントの接続/リスト/呼び出し
A2A 検出/送信/ストリーム/取得/キャンセル
MCP監査およびA2Aタスク管理APIのデータをクロスチェックします

<詳細>

💳 サブスクリプションプロバイダー

### Claude Code (Pro/Max)

Dashboard → Providers → Connect Claude Code
→ OAuth login → Auto token refresh
→ 5-hour + weekly quota tracking

Models:
  cc/claude-opus-4-6
  cc/claude-sonnet-4-5-20250929
  cc/claude-haiku-4-5-20251001

**プロのヒント:**複雑なタスクには Opus を使用し、速度を求める場合は Sonnet を使用します。 OmniRoute はモデルごとの割り当てを追跡します。### OpenAI Codex (Plus/Pro)

Dashboard → Providers → Connect Codex
→ OAuth login (port 1455)
→ 5-hour + weekly reset

Models:
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

Codex Account Limit Management (5h + Weekly)

各 Codex アカウントには、「ダッシュボード -> プロバイダー」でポリシーの切り替えができるようになりました。

5h (オン/オフ): 5 時間のウィンドウしきい値ポリシーを適用します。
「毎週」 (オン/オフ): 毎週のウィンドウしきい値ポリシーを適用します。
しきい値の動作: 有効なウィンドウの使用率が 90% 以上に達すると、そのアカウントはスキップされます。
ローテーション動作: OmniRoute は、次の対象となる Codex アカウントに自動的にルーティングします。
リセット動作: プロバイダーの「resetAt」時間が経過すると、アカウントは自動的に再び適格になります。

シナリオ:

「5 時間 ON」 + 「毎週 ON」: いずれかのウィンドウがしきい値に達すると、アカウントはスキップされます。
「5 時間オフ」 + 「毎週オン」: 毎週の使用のみアカウントをブロックできます。
「5時間オン」 + 「毎週オフ」: 5時間の使用のみでアカウントをブロックできます。
resetAt が渡されました: アカウントは自動的にローテーションを再開します (手動での再有効化はありません)。### Gemini CLI (FREE 180K/month!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

**ベストバリュー:**膨大な無料枠!有料レベルの前にこれを使用してください。### GitHub Copilot

Dashboard → Providers → Connect GitHub
→ OAuth via GitHub
→ Monthly reset (1st of month)

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3.1-pro-preview

<詳細>

🔑 API キープロバイダー

### NVIDIA NIM (FREE developer access — 70+ models)

サインアップ: build.nvidia.com
無料の API キーを取得します (1000 推論クレジットが含まれます)
ダッシュボード → プロバイダーの追加 → NVIDIA NIM:
- API キー: nvapi-your-key

モデル:nvidia/llama-3.3-70b-instruct、nvidia/mistral-7b-instruct、および 50 以上

**プロのヒント:**OpenAI 互換 API — OmniRoute のフォーマット変換とシームレスに連携します。### DeepSeek

サインアップ: platform.deepseek.com
APIキーを取得する
ダッシュボード → プロバイダーの追加 → DeepSeek

モデル:ディープシーク/ディープシークチャット、ディープシーク/ディープシークコーダー### Groq (Free Tier Available!)

サインアップ: console.groq.com
API キーを取得します (無料利用枠を含む)
ダッシュボード → プロバイダーの追加 → Groq

モデル:groq/llama-3.3-70b、groq/mixtral-8x7b

**プロのヒント:**超高速推論 — リアルタイムコーディングに最適です。### OpenRouter (100+ Models)

サインアップ: openrouter.ai
APIキーを取得する
ダッシュボード → プロバイダーの追加 → OpenRouter

**モデル:**単一の API キーを通じて、すべての主要プロバイダーの 100 以上のモデルにアクセスします。

ダッシュボードの動作:OpenRouter モデルは利用可能なモデルから管理されます。手動追加、インポート、自動同期はすべて同じリストを更新します。

<詳細>

💰 格安プロバイダー (バックアップ)

### GLM-4.7 (Daily reset, $0.6/1M)

サインアップ: Zhipu AI 2.コーディングプランからAPIキーを取得
ダッシュボード → API キーの追加:
- プロバイダー: glm
- API キー: your-key

使用:glm/glm-4.7

**プロのヒント:**コーディングプランでは、1/7 のコストで 3 倍の割り当てを提供します。毎日午前 10 時にリセットされます。### MiniMax M2.1 (5h reset, $0.20/1M)

サインアップ：MiniMax
APIキーを取得する
ダッシュボード → APIキーの追加

使用方法:minimax/MiniMax-M2.1

**プロのヒント:**長いコンテキスト (100 万トークン) の最も安価なオプション!### Kimi K2 ($9/month flat)

購読：ムーンショット AI
APIキーを取得する
ダッシュボード → APIキーの追加

使用方法:kimi/kimi-latest

**プロのヒント:**1,000 万トークンの固定 $9/月 = 0.90 ドル/100 万の実効コスト!

<詳細>

🆓 無料プロバイダー (緊急バックアップ)

### Qoder (5 FREE models via OAuth)

Dashboard → Connect Qoder
→ Qoder OAuth login
→ Unlimited usage

Models:
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

Qwen (4 FREE models via Device Code)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

Kiro (Claude FREE)

Dashboard → Connect Kiro
→ AWS Builder ID or Google/GitHub
→ Unlimited usage

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

<詳細>

🎨 コンボを作成する

### Example 1: Maximize Subscription → Cheap Backup

Dashboard → Combos → Create New

Name: premium-coding
Models:
  1. cc/claude-opus-4-6 (Subscription primary)
  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)

Use in CLI: premium-coding

Example 2: Free-Only (Zero Cost)

Name: free-combo
Models:
  1. gc/gemini-3-flash-preview (180K free/month)
  2. if/kimi-k2-thinking (unlimited)
  3. qw/qwen3-coder-plus (unlimited)

Cost: $0 forever!

<詳細>

🔧 CLI の統合

### Cursor IDE

Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [from OmniRoute dashboard]
  Model: cc/claude-opus-4-6

Claude Code

ダッシュボードのCLI ツールページを使用してワンクリック構成を行うか、~/.claude/settings.json を手動で編集します。### Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"

codex "your prompt"

OpenClaw

オプション 1 — ダッシュボード (推奨):``` Dashboard → CLI Tools → OpenClaw → Select Model → Apply


**オプション 2 — 手動:**`~/.openclaw/openclaw.json` を編集します:```json
{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

**注:**OpenClaw はローカル OmniRoute でのみ機能します。 IPv6 解決の問題を回避するには、「localhost」の代わりに「127.0.0.1」を使用してください。### Cline / Continue / RooCode

Settings → API Configuration:
  Provider: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [from OmniRoute dashboard]
  Model: if/kimi-k2-thinking

OpenCode

**ステップ 1:**OmniRoute をカスタムプロバイダーとして追加します。```bash opencode /connect

Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key


**ステップ 2:**プロジェクト ルートで `opencode.json` を作成/編集します。```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1"
      },
      "models": {
        "cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
      }
    }
  }
}

**ステップ 3:**OpenCode でモデルを選択します。```bash /models

Select any OmniRoute model from the list


>**ヒント:**OmniRoute `/v1/models` エンドポイントで利用可能なモデルを `models` セクションに追加します。 OmniRoute ダッシュボードの「provider/model-id」形式を使用します。</details>

---

## トラブルシューティング

<詳細>
<summary><b>クリックしてトラブルシューティング ガイドを展開します</b></summary>

**「言語モデルがメッセージを提供しませんでした」**

- プロバイダー クォータが枯渇した → ダッシュボード クォータ トラッカーを確認してください
- 解決策: コンボフォールバックを使用するか、より安価なレベルに切り替える

**レート制限**

- サブスクリプション クォータ アウト → GLM/MiniMax へのフォールバック
- コンボを追加: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2- Thinking`

**OAuth トークンの有効期限が切れました**

- OmniRouteによる自動更新
- 問題が解決しない場合: ダッシュボード → プロバイダー → 再接続

**高コスト**

- [ダッシュボード] → [コスト] で使用状況の統計を確認します。
- プライマリ モデルを GLM/MiniMax に切り替えます
- 重要ではないタスクには無料枠 (Gemini CLI、Qoder) を使用する

**ダッシュボード/API ポートが間違っています**

- `PORT` は正規のベースポート (デフォルトでは API ポート) です。
- `API_PORT` は OpenAI 互換の API リスナーのみをオーバーライドします
- `DASHBOARD_PORT` はダッシュボード/Next.js リスナーのみをオーバーライドします
- `NEXT_PUBLIC_BASE_URL` をダッシュボード/パブリック URL に設定します (OAuth コールバック用)

**クラウド同期エラー**

- 「BASE_URL」が実行中のインスタンスを指していることを確認します
- 「CLOUD_URL」が予想されるクラウド エンドポイントを指していることを確認します
- `NEXT_PUBLIC_*` 値をサーバー側の値と一致させます。

**最初のログインが機能しない**

- `.env`の`INITIAL_PASSWORD`を確認してください
- 設定されていない場合、フォールバックパスワードは「123456」です。

**リクエストログなし**

- リクエスト アーティファクトは、リクエストごとに 1 つの JSON ファイルとして「DATA_DIR/call_logs/」に書き込まれます。
- 詳細なステージごとのペイロードが必要な場合は、「ダッシュボード」→「ログ」→「ログのリクエスト」からパイプライン キャプチャを有効にします。
- `logs/application/app.log` にもアプリケーション コンソール ログが必要な場合は、`APP_LOG_TO_FILE=true` を設定します。
- 必要に応じて、「APP_LOG_MAX_FILE_SIZE」、「APP_LOG_RETENTION_DAYS」、「APP_LOG_MAX_FILES」、「CALL_LOG_MAX_ENTRIES」を調整します。

**OpenAI 互換プロバイダーの接続テストで「無効」と表示される**

- 多くのプロバイダーは「/models」エンドポイントを公開していません
- OmniRoute v1.0.6+ には、チャット完了によるフォールバック検証が含まれています
- ベース URL に「/v1」サフィックスが含まれていることを確認してください### 🔐 OAuth on a Remote Server

<a name="oauth-on-a-remote-server"></a>
<a name="oauth-em-servidor-remoto"></a>

>**⚠️ VPS、Docker、または任意のリモート サーバーで OmniRoute を実行しているユーザーにとって重要**#### Why does Antigravity / Gemini CLI OAuth fail on remote servers?

**Antigravity**プロバイダーと**Gemini CLI**プロバイダーは**Google OAuth 2.0**を使用します。 Google では、OAuth フロー内の「redirect_uri」が、アプリの Google Cloud Console に事前登録された URI の 1 つと正確に一致することを要求しています。

OmniRoute にバンドルされている OAuth 資格情報は、**「localhost」に対してのみ**登録されます。リモート サーバー (例: 「https://omniroute.myserver.com」) 上の OmniRoute にアクセスすると、Google は次のような認証を拒否します。```
Error 400: redirect_uri_mismatch

Solution: Configure your own OAuth credentials

Google Cloud Console でサーバーの URI を使用してOAuth 2.0 クライアント IDを作成する必要があります。#### Step-by-step

1. Google Cloud コンソールを開きます

https://console.cloud.google.com/apis/credentials に移動します。

2.新しい OAuth 2.0 クライアント ID を作成します

-「+ 資格情報の作成」→**「OAuth クライアント ID」**をクリックします。

アプリケーションの種類:「Web アプリケーション」
名前: 任意の名前 (例:「OmniRoute Remote」)

3.承認されたリダイレクト URI の追加

**「承認されたリダイレクト URI」**フィールドに、次を追加します。``` https://your-server.com/callback


> 「your-server.com」をサーバーのドメインまたはIPに置き換えます（必要に応じてポートを含めます、例：「http://45.33.32.156:20128/callback」）。

**4.資格情報を保存してコピーします**

作成後、Google には**クライアント ID**と**クライアント シークレット**が表示されます。

**5.環境変数を設定します**

`.env` (または Docker 環境変数) 内:```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

# For Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

6. OmniRoute を再起動します```bash

npm:

npm run dev

Docker:

docker restart omniroute


**7.もう一度接続してみてください**

ダッシュボード → プロバイダー → Antigravity (または Gemini CLI) → OAuth

Google は「https://your-server.com/callback」に正しくリダイレクトされるようになりました。---

#### Temporary workaround (without custom credentials)

今すぐ独自の認証情報を設定したくない場合でも、**手動 URL フロー**を使用できます。

1. OmniRoute が Google 認証 URL を開きます
2. 承認後、Google は「localhost」へのリダイレクトを試行します (リモート サーバーでは失敗します)。
3. ブラウザのアドレス バーから**完全な URL をコピー**します (ページが読み込まれない場合でも)
4. その URL を OmniRoute 接続モーダルに表示されるフィールドに貼り付けます。
5.**「接続」**をクリックします。

> これは、リダイレクト ページが読み込まれたかどうかに関係なく、URL 内の認証コードが有効であるため機能します。---

<詳細>
<summary><b>🇧🇷 ポルトガル語について</b></summary>#### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?

**反重力**と**Gemini CLI**を使用して**Google OAuth 2.0**を認証します。 O Google は、「redirect_uri」を使用して、フラクソ OAuth 認証を実行せず、**exatamente**の URI を事前に管理し、Google Cloud Console でアプリケーションを実行しません。

認証情報として OAuth は、「localhost」**に対する OmniRoute データベースの構築をサポートしません。 OmniRoute サーバー リモートへのアクセス (例: `https://omniroute.meuservidor.com`)、Google による認証:```
Error 400: redirect_uri_mismatch

Solução: Configure suas próprias credenciais OAuth

OAuth 2.0 クライアント IDでは、Google Cloud Console の URI がサーバーを参照する必要があります。#### Passo a passo

1. Google Cloud コンソールへのアクセス

アブラ: https://console.cloud.google.com/apis/credentials

2.新しい OAuth 2.0 クライアント ID

Clique em**「+ 認証情報の作成」→「OAuth クライアント ID」**
応用情報:「Web アプリケーション」
名前: escolha qualquer nome (例: OmniRoute Remote)

3.承認されたリダイレクト URI としての Adicione

**「承認されたリダイレクト URI」**はありません、アディシオン:``` https://seu-servidor.com/callback


> `seu-servidor.com` をサーバーの IP アドレスに置き換えます (必要なポータルを含む、例: `http://45.33.32.156:20128/callback`)。

**4.コピーを認証情報として保存**

Google のほとんどの情報、**クライアント ID**、または**クライアント シークレット**を使用してください。

**5.環境変数として設定**

`.env` はありません (Docker の環境変数を変更します):```bash
# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

6.レイニシー・オ・オムニルート```bash

Se usando npm:

npm run dev

Se usando Docker:

docker restart omniroute


**7.テンテ コネクター ノヴァメンテ**

ダッシュボード → プロバイダー → Antigravity (Gemini CLI) → OAuth

`https://seu-servidor.com/callback` の機能を確認するには、Google からアクセスしてください。---

#### Workaround temporário (sem configurar credenciais próprias)

**URL のマニュアル**:

1. OmniRoute は Google の自動 URL を提供します
2. `localhost` による Google の自動リダイレクト (サーバー リモートの呼び出し)
3.**URL をコピーしてください**ブラウザを使用してブラウザを開きます (カレーグのページを表示します)
4. コール エッサ URL は、OmniRoute の接続モーダルなしです。
5. クリーク**「接続」**

> 自動回避策の機能は URL から独立してリダイレクトされます。</details>

---

</details>

## 🛠️ Tech Stack

<詳細>
<summary><b>クリックして技術スタックの詳細を展開します</b></summary>

-**ランタイム**: Node.js 18–22 LTS (⚠️ Node.js 24+ は**サポートされていません**— `better-sqlite3` ネイティブ バイナリは互換性がありません)
-**言語**: TypeScript 5.9 - `src/` と `open-sse/` で**100% TypeScript**(v2.0 以降のコア モジュールには `any` はありません)
-**フレームワーク**: Next.js 16 + React 19 + Tailwind CSS 4
-**データベース**: LowDB (JSON) + SQLite (ドメイン状態 + プロキシ ログ + MCP 監査 + ルーティング決定)
-**スキーマ**: Zod (MCP ツール I/O 検証、API コントラクト)
-**プロトコル**: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
-**ストリーミング**: サーバー送信イベント (SSE)
-**認証**: OAuth 2.0 (PKCE) + JWT + API キー + MCP スコープの認証
-**テスト**: Node.js テスト ランナー + Vitest (単体、統合、E2E を含む 900 以上のテスト)
-**CI/CD**: GitHub アクション (自動 npm パブリッシュ + リリース時の Docker Hub)
-**ウェブサイト**: [omniroute.online](https://omniroute.online)
-**パッケージ**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
-**Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
-**回復力**: サーキット ブレーカー、エクスポネンシャル バックオフ、アンチサンダー ハード、TLS スプーフィング、自動コンボ自己修復</details>

---

## ドキュメント

|ドキュメント |説明 |
| ------------------------------------------------ | --------------------------------------------------- |
| [ユーザーガイド](docs/USER_GUIDE.md) |プロバイダー、コンボ、CLI 統合、展開 |
| [API リファレンス](docs/API_REFERENCE.md) |すべてのエンドポイントと例 |
| [MCP サーバー](open-sse/mcp-server/README.md) | 16 MCP ツール、IDE 構成、Python/TS/Go クライアント |
| [A2A サーバー](src/lib/a2a/README.md) | JSON-RPC 2.0 プロトコル、スキル、ストリーミング、タスク管理 |
| [オートコンボ エンジン](docs/auto-combo.md) | 6 要素スコアリング、モード パック、自己修復 |
| [トラブルシューティング](docs/TROUBLESHOOTING.md) |よくある問題と解決策 |
| [アーキテクチャ](docs/ARCHITECTURE.md) |システム アーキテクチャと内部構造 |
| [寄稿](CONTRIBUTING.md) |開発セットアップとガイドライン |
| [OpenAPI 仕様](docs/openapi.yaml) | OpenAPI 3.0 仕様 |
| [セキュリティポリシー](SECURITY.md) |脆弱性の報告とセキュリティの実践 |
| [VM の展開](docs/VM_DEPLOYMENT_GUIDE.md) |完全ガイド: VM + nginx + Cloudflare セットアップ |
| [機能ギャラリー](docs/FEATURES.md) |スクリーンショットを含むビジュアル ダッシュボード ツアー |
| [リリースチェックリスト](docs/RELEASE_CHECKLIST.md) |リリース前の検証手順 |---

## 🗺️ Roadmap

OmniRoute には、複数の開発フェーズにわたって**210 以上の機能が計画されています**。主要な領域は次のとおりです。

|カテゴリー |計画されている機能 |ハイライト |
| ----------------------------- | ---------------- | -------------------------------------------------------------------------------------- |
| 🧠**ルーティングとインテリジェンス**| 25+ |最低レイテンシのルーティング、タグベースのルーティング、クォータ プリフライト、P2C アカウントの選択 |
| 🔒**セキュリティとコンプライアンス**| 20歳以上 | SSRF の強化、資格情報のクローキング、エンドポイントごとのレート制限、管理キーのスコーピング |
| 📊**可観測性**| 15 歳以上 | OpenTelemetry 統合、リアルタイム クォータ監視、モデルごとのコスト追跡 |
| 🔄**プロバイダーの統合**| 20歳以上 |動的モデル レジストリ、プロバイダーのクールダウン、マルチアカウント Codex、Copilot クォータ解析 |
| ⚡**パフォーマンス**| 15 歳以上 |デュアル キャッシュ レイヤー、プロンプト キャッシュ、応答キャッシュ、ストリーミング キープアライブ、バッチ API |
| 🌐**生態系**| 10+ | WebSocket API、構成ホットリロード、分散構成ストア、商用モード |### 🔜 Coming Soon

- 🔗**OpenCode Integration**— OpenCode AI コーディング IDE のネイティブ プロバイダー サポート
- 🔗**TRAE 統合**— TRAE AI 開発フレームワークの完全サポート
- 📦**バッチ API**— 一括リクエストの非同期バッチ処理
- 🎯**タグベースのルーティング**— カスタムタグとメタデータに基づいてリクエストをルーティングします
- 💰**最低コスト戦略**— 利用可能な最も安価なプロバイダーを自動的に選択します

> 📝 全機能仕様は [`docs/new-features/`](docs/new-features/) で入手可能 (217 の詳細仕様)---

## 👥 Contributors

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)

### How to Contribute

1. リポジトリをフォークする
2. 機能ブランチを作成します (`git checkout -b feature/amazing-feature`)
3. 変更をコミットします (`git commit -m '素晴らしい機能を追加'`)
4. ブランチにプッシュします (`git Push Origin feature/amazing-feature`)
5. プルリクエストを開く

詳細なガイドラインについては、[CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。### Releasing a New Version

```bash
# Create a release — npm publish happens automatically
gh release create v2.0.0 --title "v2.0.0" --generate-notes

📊 Star History

Stargazers over time

🙏 Acknowledgments

このフォークのきっかけとなった元のプロジェクトである**decoluaによる9router**に感謝します。 OmniRoute は、追加機能、マルチモーダル API、完全な TypeScript の書き換えを備えた素晴らしい基盤の上に構築されています。

CLIProxyAPI— この JavaScript 移植のきっかけとなったオリジナルの Go 実装に感謝します。---

ライセンス

MIT ライセンス - 詳細については、LICENSE を参照してください。---

_{Built with ❤️ for developers who code 24/7}
_{omniroute.online}

README.md Unescape Escape

🚀 OmniRoute — The Free AI Gateway (日本語)

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

🖼️ Main Dashboard

📸 Dashboard Preview

🤖 Free AI Provider for your favorite coding agents

🤔 Why OmniRoute?

📧 Support

API: http://localhost:20128/v1

Dashboard: http://localhost:20129

5) Validate everything end-to-end (recommended)

Template file for 'omniroute'

Copy and edit .env first

System Tray

💰 Pricing at a Glance

🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever

Smart fallback with practical cost control

📖 Setup Guide

Protocol Setup (MCP + A2A)

Codex Account Limit Management (5h + Weekly)

Qwen (4 FREE models via Device Code)

Kiro (Claude FREE)

Example 2: Free-Only (Zero Cost)

Claude Code

OpenClaw

OpenCode

Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key

Select any OmniRoute model from the list

Solution: Configure your own OAuth credentials

npm:

Docker:

Solução: Configure suas próprias credenciais OAuth

Se usando npm:

Se usando Docker:

📊 Star History

Stargazers over time

🙏 Acknowledgments

ライセンス

README.md