🚀 OmniRoute — 無料のAIゲートウェイ

🛠️ 技術スタック

レイヤー	テクノロジー
ランタイム	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/CD	GitHub Actions — リリース時にnpm自動公開 + Docker Hub
リンク	ウェブサイト · npm · Docker Hub

📖 ドキュメント

📘 はじめに

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

🔧 運用とデプロイ

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

🧠 機能とアーキテクチャ

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

🤖 プロトコルと API

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

📋 プロジェクトと品質

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

⭐ トップコントリビューター

OmniRoute は、情熱あふれるオープンソースコミュニティによって形作られています。以下の方々は、プロジェクトの品質、安定性、普及に直接影響を与える卓越した貢献をしています。ありがとうございます。

マージされたプルリクエスト数による外部コントリビューターのランキング

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

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

GitHub に帰属するコミット

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

_{2026-08-24 06:14:31 UTC に再確認：デフォルトブランチ release/v3.8.50 について、リポジトリの Contributors API が報告した GitHub に帰属するコミット数です。API は 525 個のアイデンティティ（ユーザー 415、ボット 2、匿名 108）を返しました。この表ではメンテナー、ボット、および匿名のアイデンティティを除外し、同順位はそのまま保持しています。これは、上記のマージ済み PR ランキングとも、下記の 639 人を対象とした Git メタデータ調査とも異なります。}

🙏 これらのコントリビューターによる機能、バグ修正、インフラストラクチャの改善は、OmniRoute の信頼性と豊富な機能を支える中核的な要素です。すべてのプルリクエスト、すべてのテストケース、すべての i18n 翻訳ファイルに価値があります。オープンソースは、このような人々によって築かれています。

💖 スポンサー

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

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

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

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

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

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

_{…そして、匿名を希望されるその他の皆さまにも感謝いたします 💛}

_{公開されている GitHub Sponsors の情報は 2026-08-24 に再検証済みです。上記のアクティブ状態のラベルは GitHub の activeOnly ステータスに基づいています。過去に公開されていた単発支援者については引き続き謝意を表し、非公開スポンサーの匿名性は維持されます。}

💖 スポンサーになる → — ご支援の一つひとつが、OmniRoute を無料かつ独立した状態に保つ力となります。

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

_{2026-08-24 に固定ベース ac02c5b42f で監査し、最新の release/v3.8.50 の先端 dafb4ae808 でも再確認しました。その結果、正規化された人間の Git ID は 639 件でした。このうち 407 件はコミット作成者（メンテナーを含む）として確認され、232 件は明示的な Co-authored-by トレーラーにのみ記載されています。この集計では、GitHub の noreply ハンドルを正規化し、26 件のボット、エージェント、サービス、プレースホルダーの ID を除外しています。また、表示名が一致するという理由だけで通常のメールアドレスを統合することはありません。}

コントリビュート方法

リポジトリをフォークします
main ではなく、アクティブな release/vX.Y.Z の先端からブランチを作成します — ブランチおよびリリースモデルを参照してください
機能ブランチを作成します（git checkout -b feat/amazing-feature）
変更をコミットします（git commit -m 'feat: add amazing feature'）
ブランチにプッシュします（git push origin feat/amazing-feature）
base = 対象の release/vX.Y.Z ブランチとして Pull Request を作成します

詳細なガイドラインについては、CONTRIBUTING.mdを参照してください。

新しいバージョンのリリース

# リリースを作成します — npm publish は自動的に実行されます
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 スター

🌍 StarMapper

🙏 謝辞

OmniRouteは、巨人たちの肩の上に立っています。9router のフォーク、およびGoプロジェクト CLIProxyAPI のTypeScript移植版として始まり、その後、以下の各サブシステムは、先駆けとなったオープンソースプロジェクトから着想を得ました。それぞれのプロジェクトが、OmniRouteの具体的な一部分を形作っています。これらすべてのプロジェクトに感謝を捧げます。🙏

⭐ スター数は2026年8月24日にGitHubのREST APIで確認済みです。ぜひ、これらのプロジェクトにスターを付けてください。記載数は特定日時点の正確なスナップショットであり、今後当然変動します。

🧬 系譜とゲートウェイ

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

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

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

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

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

🧠 メモリと RAG

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

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

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

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

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

🛡️ セキュリティ

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

🧭 補完ツール

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