baiibayu/srouter has 64 GitHub stars and 11 forks. GitHot measured 0 stars in 24 hours, +1 in 7 days, and +2 in 15 days. Last checked 2026-11-15 20:46 UTC. Last push 2026-11-06.
できること
- Full OpenAI surface (/v1/chat/completions, /v1/models, /v1/embeddings, /v1/images/generations, /v1/audio/*).
- Native Anthropic Messages API (/v1/messages) for seamless Claude Code support.
- Native Google Gemini API (/v1beta/models/*:generateContent).
- Native Ollama Emulation for local-first IDEs like Zed and JetBrains AI.
計測したスター増加
- 24時間
- 0
- 7日間
- +1
- 15日間
- +2
- 1か月
- 更新が遅れています
期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。
概要
Never hit rate limits again. One OpenAI-compatible endpoint for 60+ providers & 1,200+ models — smart auto-fallback, prompt compression, 60-language dashboard. Plug into Claude Code, Cursor, Codex & more. Free, open-source, self-hosted.
AIREADME.ja.md
オリジナル🚀 SRouter
ローカルファーストのスマート AI ゲートウェイ & 無料 LLM ルーター
レート制限(429)によるコーディング中断をゼロに。プロンプト圧縮と自動フォールバックで、約60社の無料 AI プロバイダーと 1,200 以上のエンドポイントを統合。
すべての AI コーディングツール(Claude Code、Cursor、Windsurf、Cline、Codex、Copilot、Aider、OpenCode など)を、単一の OpenAI 互換エンドポイントにシームレス接続。
⚡ クイックスタート • 🤖 エージェント接続 • 🔌 対応プロバイダー • 🌐 API エンドポイント • 🛠️ MCP 設定 • 🤔 選ばれる理由 • 🔄 動作の仕組み • ✨ 主な機能 • 🏗️ プロジェクト構造 • 📚 ドキュメント
言語 / Language: 🇺🇸 English • 🇮🇩 Bahasa Indonesia • 🇨🇳 简体中文 • 🇯🇵 日本語

ルーターは Ed25519 署名付きフィードから 1 日 2 回自動同期されます。手動の git pull を行うことなく、新しい無料モデル、クォータの更新、互換性パッチが自動適用されます。
🤔 SRouter が選ばれる理由
AI コーディングツール(Claude Code、Cursor、Windsurf、Cline)での開発は非常に強力ですが、日常的に以下の問題に直面します:
| ❌ 開発現場の課題 | ✅ SRouter による解決策 |
|---|---|
| 有料サブスク枠の失効と無駄遣い: 毎月の割り当てトークンが使い切れずに月末に消滅する。 | トークン価値を最大化: クォータ期限が近いものをインテリジェントに優先消費し、最適にプロバイダー間を巡回。 |
| 突然のレート制限(429)による作業停止: 長いプロンプトや連続したツール呼び出しで、コーディング思考が中断される。 | スマート3階層自動フォールバック: サブスク $\to$ 格安モデル $\to$ 100% 無料・キー不要モデルへと瞬時に切り替え、ダウンタイムゼロを実現。 |
ツール出力によるトークンの無駄消費: git diff、ログ、テスト結果、肥大化した JSON でコンテキスト長が瞬く間に枯渇する。 |
プロンプト圧縮 & トークンセーバー: ヒューリスティックと構造認識フィルタでノイズを剪定し、通常 20〜40% のトークンを削減。 |
| 複数 SDK・API 形式の断片化: 数十社のプロバイダーごとに異なる認証形式やエンドポイントを管理する負担。 | 単一の汎用 /v1 ゲートウェイ: 1つの OpenAI 互換エンドポイント(http://localhost:20268/v1)で、Anthropic Messages(/v1/messages)、Gemini(/v1beta)、Ollama エミュレーションに対応。 |
| 予告のない無料枠の仕様変更: 各社が週単位でモデルの追加・廃止や制限変更をサイレント実施。 | 署名付きカタログの自動同期: 約 1,200 以上のモデル情報をローカル SQLite へ自動更新。常に最新環境を維持。 |
| API キー漏洩のプライバシーリスク: 外部の未知のクラウドプロキシに生の API キーを送信するリスク。 | 100% ローカル AES-256-GCM 暗号化: キーはローカルの SQLite 内に暗号化保存され、リクエストは端末から直接各公式プロバイダーへ送信されます。 |

🔄 アーキテクチャと動作の仕組み
┌─────────────────────────────────────────────────────────────────────────────┐
│ ご利用の AI コーディングツール & IDE │
│ (Claude Code, Cursor, Windsurf, Cline, Roo Code, Codex, Aider) │
└──────────────────────────────────────┬──────────────────────────────────────┘
│ http://localhost:20268/v1
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ SRouter スマート AI ゲートウェイ │
│ • 複雑度ゲート(System One:簡易プロンプトは高速モデル、複雑な実装は深層思考)│
│ • プロンプト圧縮 & トークンセーバー(冗長なターミナル出力や JSON を圧縮) │
│ • プロトコル相互変換(OpenAI ↔ Anthropic Messages ↔ Gemini ↔ Ollama) │
│ • キー単位レート制限追跡(RPM / RPD / TPM を追跡し UTC 周期で自動リセット)│
│ • ローカル AES-256-GCM 暗号化ボールト & SQLite 永続化 │
└──────────────────────────────────────┬──────────────────────────────────────┘
│
┌──────────────────────────────┼──────────────────────────────┐
▼ ▼ ▼
┌──────────────────────────┐ ┌──────────────────────────┐ ┌──────────────────────────┐
│ 第1階層: 高速 / サブスク│ │ 第2階層: 大容量 / 格安 │ │ 第3階層: 100% 無料・免責 │
│ • Google Gemini 2.5 │ │ • Mistral / Codestral │ │ • Kilo Gateway (キー不要)│
│ • Groq (Llama 3.3 70B) │──►│ • Zhipu GLM-4 / 視覚 │──►│ • OpenCode Free(キー不要)│
│ • Pollinations (無料) │ │ • Cloudflare Workers AI │ │ • OVH Endpoints (キー不要)│
│ • OpenRouter / DeepSeek │ │ • Cohere / NVIDIA NIM │ │ • LLM7 / AI Horde │
└──────────────────────────┘ └──────────────────────────┘ └──────────────────────────┘
リクエストを受信すると、SRouter はモデルの稼働状態、残りレート制限、タスク複雑度を評価して最適なルートを選択します。プロバイダーから 429 Too Many Requests や 5xx エラーが返された場合、該当キーを一時クールダウンし、フォールバックチェーン内の次の最適モデルへ即座にリトライします。

⚡ クイックスタート
お好みの起動方法を選択してください:
方法 1:グローバル CLI / NPX(最も手軽)
Node.js 20+ がインストールされている環境であれば、リポジトリの clone なしで即座に起動できます:
# グローバルインストール(1 回だけ)
npm install -g @baiibayu/srouter
srouter
# または npx で直接実行(インストール不要)
npx @baiibayu/srouter
自動的にブラウザでダッシュボード(http://localhost:20268)が開きます。
方法 2:Docker Compose(サーバー / 自宅ラボ推奨)
# 1. リポジトリをクローン
git clone https://github.com/baiibayu/srouter.git
cd srouter
# 2. 環境変数ファイルをコピーしてコンテナを起動
cp .env.example .env
docker compose up -d
# またはクローン不要で GHCR イメージから直接起動:
# docker run -d --name srouter -p 20268:20268 -v srouter-data:/app/server/data ghcr.io/baiibayu/srouter:latest
- ダッシュボード:
http://localhost:20268 - OpenAI 互換エンドポイント:
http://localhost:20268/v1
方法 3:デスクトップアプリ(Windows & macOS)
システムトレイ常駐型の GUI アプリケーションをご希望の場合:
- Releases リリースページ を開きます。
- インストーラーをダウンロード:
- Windows:
SRouter-Setup-x.x.x.exe - macOS:
SRouter-x.x.x-arm64.dmg(Apple Silicon)またはx64.dmg(Intel)。
- Windows:
- アプリを起動するとタスクトレイ / メニューバーに常駐し、クリックするとリアルタイム統計と統合 API キーが表示されます。
方法 4:ソースコードから開発実行
# 1. リポジトリをクローンして依存関係をインストール
git clone https://github.com/baiibayu/srouter.git
cd srouter
npm install
# 2. データベースマイグレーションの実行
npm run db:migration:up
# 3. 開発サーバーの起動(サーバー :20268 + UI :5173、HMR 対応)
npm run dev
ブラウザを開いてアクセスしてください:
👉 http://localhost:20268(Web ダッシュボード)。
🤖 AI コーディングツールの接続
SRouter には自動設定ジェネレーター(setup-*)が備わっており、稼働中のモデル一覧を自動認識して各ツール用の設定ファイルを生成します:
![]() Claude Code |
![]() Cursor |
![]() Codex CLI |
![]() Cline |
![]() Continue |
![]() Aider |
![]() OpenCode |
![]() Gemini CLI |
![]() Roo Code |
![]() Kilo Code |
![]() Zed |
![]() JetBrains |
![]() Goose |
![]() Qwen Code |
![]() Crush |
![]() Factory Droid |
![]() OpenClaw |
![]() DeepSeek Harness |
![]() Oh My Pi |
![]() Hermes |
![]() Pi |
![]() AtomCode |
# Claude Code の自動設定
srouter setup-claude --url http://localhost:20268 --api-key <統合APIキー>
未インストールの場合、srouter の代わりに npx @baiibayu/srouter を先頭に付けてください。
| ツール | 自動設定コマンド | 接続先 Base URL | プロトコル対応 |
|---|---|---|---|
| Claude Code | srouter setup-claude または srouter launch |
http://localhost:20268 |
ネイティブ Anthropic /v1/messages 形式 |
| Cursor / Windsurf | srouter setup-cursor(または手動設定) |
http://localhost:20268/v1 |
OpenAI Chat Completions 形式 |
| Cline | srouter setup-cline |
http://localhost:20268/v1 |
OpenAI / Anthropic 形式 |
| Roo Code / Kilo | srouter setup-roo / setup-kilo |
http://localhost:20268/v1 |
OpenAI Chat Completions 形式 |
| Codex CLI | srouter setup-codex または srouter launch-codex |
http://localhost:20268/v1 |
ネイティブ /v1/responses 形式 |
| Aider | srouter setup-aider |
http://localhost:20268/v1 |
OpenAI Chat Completions 形式 |
| Continue.dev | srouter setup-continue |
http://localhost:20268/v1 |
チャット & ゴーストテキスト補完 |
| OpenCode | srouter setup-opencode |
http://localhost:20268/v1 |
OpenAI Chat Completions 形式 |
| Gemini CLI | ネイティブ /v1beta |
http://localhost:20268 |
ネイティブ generateContent 形式 |
| Zed / JetBrains AI | Ollama エミュレーション | http://localhost:20268 |
ネイティブ NDJSON Ollama 形式 |
設定スニペットの例(クリックして展開)
Claude Code のセキュア起動(ディスクにキー保存なし)
# 子プロセスにのみ認証情報を一時注入
srouter launch
Cursor / Windsurf の設定
{
"openai.baseUrl": "http://localhost:20268/v1",
"openai.apiKey": "srouter-your-unified-key",
"openai.model": "auto"
}
Python OpenAI SDK からの利用
from openai import OpenAI
client = OpenAI(
base_url="http://localhost:20268/v1",
api_key="srouter-your-unified-key",
)
response = client.chat.completions.create(
model="auto:smart", # または "auto:fast", "auto", 特定のモデル名
messages=[{"role": "user", "content": "TypeScript の Generics について簡潔に説明してください。"}],
)
print(response.choices[0].message.content)
print("ルーティング先:", response.headers.get("x-routed-via"))
🔌 対応プロバイダー
SRouter は 約60社のプロバイダー と 1,200 以上のエンドポイント を統合しています。

![]() Google Gemini |
![]() Groq |
![]() Mistral |
![]() OpenRouter |
![]() Alibaba Qwen |
![]() Nous Research |
SiliconFlow |
![]() ModelScope |
![]() Cloudflare |
![]() Cohere |
![]() Zhipu GLM |
![]() NVIDIA NIM |
![]() Baidu Qianfan |
![]() ByteDance Ark |
![]() iFlytek Spark |
![]() AMD Radeon |
![]() HuggingFace |
![]() Kilo |
![]() LLM7 |
![]() Ollama |
![]() OVH |
![]() Pollinations |
![]() OpenCode |
![]() AI Horde |
1. ⚡ 100% 無料・キー不要(登録不要・クレジットカード不要)
| プロバイダー | 利用可能モデル | 備考 |
|---|---|---|
| Kilo Gateway | Kilo Auto Free, Nemotron-3 Ultra Free | 匿名で即座に利用可能 |
| OpenCode Free | OpenCode Tier モデル群 | 内蔵の無料オープン推論プール |
| OVH AI Endpoints | Qwen3Guard, Stable Diffusion, Whisper TTS | 2 RPM 匿名無料枠 |
| LLM7 | Codestral, Mistral-Nemo, Gemma 4, GPT-OSS | 充実した日次無料枠 |
| AI Horde | コミュニティ LLaMA, Qwen, Gemma, Mistral | コミュニティ分散型推論ネットワーク |
2. 🌐 充実した無料枠を持つ主要プロバイダー
- Google AI Studio: Gemini 2.5 Flash / Pro(非常に寛大な日次無料枠)
- Groq: Llama 3.3 70B & Mixtral(圧倒的な高速推論、30 RPM 無料枠)
- Pollinations: 無料テキスト+画像 (キー不要)
- Mistral AI: Codestral(高精度コーディングモデル)、Mistral Small
- Cloudflare Workers AI: 1 日あたり 10,000 neurons の無料枠
- Cohere: Command R / Command R+ トライアルクレジット
- NVIDIA NIM: 1,000 回のオープンフロンティアモデル無料 API コール
3. 🌏 各種リージョナルゲートウェイ
- ModelScope(Alibaba Cloud): Qwen3.8、DeepSeek V4 Pro、GLM-5.2(日次 2,000 リクエスト無料)
- Baidu Qianfan & Volcengine Ark: DeepSeek や Doubao の無料枠
- NaraRouter & Sea-Lion: 東南アジア・多言語向け低遅延モデル
4. 🔌 ローカルモデル & カスタムゲートウェイ
Ollama、LM Studio、vLLM、llama.cpp でローカル実行しているモデルも、ダッシュボードの Keys 画面からワンクリックで追加できます。
🌐 統合 API エンドポイント
すべてのゲートウェイ機能は単一の統合 API キー(Bearer sr-xxx またはヘッダー x-api-key: sr-xxx)で統一されており、ダッシュボードの Keys タブからいつでも取得できます。
| メソッド | エンドポイント | 主なサーフェス | 説明 | 認証ヘッダー |
|---|---|---|---|---|
POST |
/v1/chat/completions |
チャット補完 (Chat) | OpenAI 完全互換サーフェス。ストリーミング (stream: true)、ツール/関数呼び出し、ビジョン入力、構造化出力、障害時の自動フォールバックに対応。 |
Bearer sr-xxx |
POST |
/v1/completions |
従来のテキスト補完 | OpenAI 旧来のテキスト補完仕様 (object: "text_completion")。エディタのゴーストテキスト補完に最適。 |
Bearer sr-xxx |
POST |
/v1/responses |
OpenAI Responses | OpenAI Codex CLI で必要な Responses API ネイティブワイヤーフォーマット (wire_api="responses"). |
Bearer sr-xxx |
POST |
/v1/messages |
Anthropic Messages | Claude Code、Cursor (Anthropic モード)、Anthropic 公式 SDK 向けの Messages プロトコル変換。/v1/messages/count_tokens をサポート。 |
Bearer sr-xxx または x-api-key: sr-xxx |
POST |
/v1/search |
Web 検索 (Search) | キー不要の Parallel Search または設定済み検索プロバイダー(Tavily、Exa、Firecrawl、Linkup)に自動ルーティングされる統合 Web 検索。 | Bearer sr-xxx |
GET |
/v1/search/engines |
Web 検索 (Search) | 設定・有効化されている検索エンジンの一覧、クォータ、利用可能状態を取得。 | Bearer sr-xxx |
POST |
/v1/decision |
意思決定 (System One) | 超低遅延な意思決定・複雑度ゲート分類(TypeSafe 仕様)。state と選択肢 choice を評価。3 階層フォールバック:リモート Jev ホスト → Chat-Judge 判定 → ローカルヒューリスティックによるゼロダウンタイム保底。 |
Bearer sr-xxx |
POST |
/v1/decisions |
多基準評価 (Decisions) | マルチクラス評価モデル(Cloudflare Clef Flash、OpenRouter Mercury Decide)。 | Bearer sr-xxx |
GET |
/v1/decisions/models |
多基準評価 (Decisions) | 利用可能な意思決定スコアリングモデルの一覧。 | Bearer sr-xxx |
POST |
/v1/fetch |
Web ページ抽出 (Fetch) | 公開 URL からノイズのない Markdown / テキストを抽出(HTML の定型文を除去)。TinyFish Fetch とキー不要の Jina Reader によるフォールバック。 | Bearer sr-xxx |
GET |
/v1/fetch/sources |
Web ページ抽出 (Fetch) | ページリーダー取得元(tinyfish-fetch、jina-reader)と稼働ステータスの一覧。 |
Bearer sr-xxx |
GET |
/v1/models |
モデルカタログ取得 | OpenAI 互換のモデル一覧。アクティブな全モデル、フォールバックエイリアス(auto、auto:fast、auto:smart、auto:cheap)、Anthropic 形式ネゴシエーションに対応。 |
Bearer sr-xxx |
POST |
/v1/embeddings |
テキスト埋め込み | 設定済みプロバイダーを経由したテキストベクトル生成。 | Bearer sr-xxx |
POST |
/v1/images/generations |
画像生成 | メディアカタログ経由のマルチモーダル画像生成。 | Bearer sr-xxx |
POST |
/v1/audio/speech |
音声合成 (TTS) | テキストから音声への変換合成。 | Bearer sr-xxx |
POST |
/v1beta/models/*:generateContent |
Gemini ネイティブ | Gemini CLI および Google 公式 SDK 向けのネイティブ Google Gemini API ワイヤーフォーマット。 | Bearer sr-xxx または x-goog-api-key |
POST |
/mcp |
MCP サーバー | Streamable HTTP ベースの Model Context Protocol サーバー(ステートレス JSON-RPC 2.0)。 | Bearer sr-xxx |
GET |
/v1/docs |
対話型 API ドキュメント | 外部依存なしで高速に動作する自己完結型インタラクティブ API リファレンス。 | 公開(認証不要) |
GET |
/v1/openapi.json |
OpenAPI 仕様書 | コード生成や各種ツール統合に使える完全な OpenAPI 3.0 仕様。 | 公開(認証不要) |
[!TIP]
- 意思決定 System One (
POST /v1/decision): 堅牢な 3 階層フォールバック構成:高速リモート判定 (< 2000ms) → 軽量 Chat-Judge 判定(decision_chat_judge_orderに準拠) → 即時ローカルヒューリスティック保底 (scoreChoice) により、エージェント側の 5xx エラーを完全に防止します。- Web ツール用キーの管理 (
Keys$\to$Web Tools): 検索・ページ抽出専用キー(Tavily、Exa、Firecrawl、TinyFish)は LLM プロバイダーとは別に専用カードで管理されます。キー不要エンジン(Parallel Search、Jina Reader)は設定不要でそのまま稼働します。
🛠️ MCP サーバー設定とプロトコル
SRouter には Streamable HTTP(POST http://localhost:20268/mcp)による Model Context Protocol (MCP) サーバーが標準搭載されており、プロトコルリビジョン 2025-06-18 に準拠しています。
Claude Desktop、Cursor、Cline、Roo Code などのコーディングアシスタントが、セッション中に利用可能なモデル一覧の確認、クォータ残量の監視、プロンプト圧縮によるトークン節約統計の取得、ルーティング戦略の動的変更を行うことができます。
設定例
1. Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"srouter": {
"url": "http://localhost:20268/mcp",
"headers": {
"Authorization": "Bearer sr-your-unified-key"
}
}
}
}
2. Cursor / Cline / Windsurf MCP
お使いのツールの設定画面で HTTP MCP サーバーを追加:
- Server URL:
http://localhost:20268/mcp - HTTP Headers:
Authorization: Bearer sr-your-unified-key
利用可能な MCP ツール一覧: list_models, check_health, get_routing_scores, set_routing_strategy, get_cache_stats, clear_cache, get_compression_stats, get_quota_outlook, ask_srouter.
🛡️ 信頼性と耐障害性のデフォルト設定
- サーキットブレーカーは初期設定でオフ(
0): 積極的なマルチプロバイダーフォールバックを重視して設計されています。一時的な 429 レート制限やタイムアウトが発生しても該当キー/モデルのみをクールダウンし、直ちに別プロバイダーへ切り替えます(ゲートウェイ全体が遮断されることはありません)。 - SSE Keepalive(接続維持): ストリーミング経路(OpenAI、Anthropic、Responses)では定期的にハートビートコメント(
: keepalive\n\n)を送信し、モデルの長考時でもリバースプロキシや NAT ファイアウォールによる接続切断を防止します。 - 一貫性のあるタイムバジェット (Coherent Time Budgets): ホップ単位のタイムアウト時間をストリーミング全体の許容時間と同期させ、不適切な早期切断を防ぎます。
🏗️ プロジェクト構造
SRouter はモジュール化されたクリーンな Monorepo 構成を採用しています:
srouter/
├── cli/ ← CLI ツール & エージェント自動ジェネレーター (`srouter setup-*`)
├── client/ ← Web ダッシュボード (React + Vite + Tailwind + Lucide、60 言語対応)
├── desktop/ ← Electron デスクトップアプリ (macOS & Windows メニューバー常駐)
├── docker/ ← Dockerfile およびコンテナ実行構成
├── docs/ ← 包括的な多言語ドキュメントと API リファレンス
│ ├── en/ ← 英語公式ガイド
│ ├── id/ ← インドネシア語公式ガイド
│ ├── zh-cn/ ← 簡体字中国語ガイド
│ └── README.md ← ドキュメントポータル入口
├── repo-assets/ ← ブランドアセット、アーキテクチャ図、UI スクリーンショット
├── scripts/ ← 環境構築、テスト、リリース自動化スクリプト
├── server/ ← ゲートウェイエンジン本体 (Node.js + TypeScript + SQLite)
│ ├── src/
│ │ ├── db/ ← SQLite データベース、マイグレーション、シードデータ
│ │ ├── providers/ ← 60社以上のプロバイダーアダプター & プロトコル実装
│ │ ├── routes/ ← OpenAI、Anthropic、Gemini、Ollama および管理 API
│ │ ├── services/ ← 多腕バンディット、クォータ監視、暗号化ボールト、圧縮
│ │ └── index.ts ← ゲートウェイサーバーのエントリポイント
├── shared/ ← 共有 TypeScript 型定義およびカタログスキーマ
├── CONTRIBUTING.md ← コントリビューターガイドと PR 規約
├── LICENSE ← オープンソース MIT ライセンス
└── package.json ← Monorepo ワークスペース定義
✨ 主な機能

- マルチプロトコル自動相互変換:
- 完全な OpenAI サーフェス(
/v1/chat/completions、/v1/models、/v1/embeddings、/v1/images/*等)。 - Claude Code をネイティブ動作させる Anthropic Messages API(
/v1/messages)。 - Google Gemini API(
/v1beta/models/*:generateContent)。 - Zed や JetBrains AI 向けのローカル Ollama エミュレーション。
- 完全な OpenAI サーフェス(
- プロンプト圧縮 & トークンセーバー:
- 構造認識と正規表現による非破壊フィルタで、肥大化したツール呼び出し結果(
git diff、ターミナルログ、ファイル内容)を剪定。 - 重複 JSON 構造を圧縮し、通常トークン消費量を 20〜40% 削減。
- 構造認識と正規表現による非破壊フィルタで、肥大化したツール呼び出し結果(
- 6つのインテリジェントルーティング戦略:
auto: 応答速度、モデル性能、残りクォータを総合判定した最適解。auto:fast: 超低遅延プロバイダー(Groq)を最優先。auto:smart: 高性能な思考モデル(Gemini 2.5 Pro、Codestral)を優先。auto:cheap: サブスク枠を温存し、軽量な無料モデルを活用。auto:<profile>: ダッシュボードで自由に作成したカスタムチェーン。
- マルチモデル協調合成(Fusion):
- 仮想モデル
fusionを呼び出すと、複数の無料モデルに並列で回答ドラフトを生成させ、審査モデルが最適な 1 つの回答に統合します。
- 仮想モデル
- 複雑度ゲート(Complexity Gate / System One):
- 簡易なプロンプトは高速モデルへ即時転送し、複数ステップを要する実装タスクは高知能モデルへ自動割り当て。
- 組み込み MCP サーバー(
/mcp):- ChatGPT、Claude Desktop、MCP クライアントから SRouter を直接ツールとして呼び出し可能。
- ローカル完結の暗号化セキュリティ:
- プロバイダーキーはローカル SQLite 内で AES-256-GCM 暗号化保存。
- クライアント側には SRouter が発行する単一の統合キーのみを公開。
- 60 言語対応:
- ダッシュボードはブラウザ言語を自動検出し、アラビア語・ヘブライ語などの RTL レイアウトにも完全対応。
🛠️ 開発コマンド一覧
| コマンド | 説明 |
|---|---|
npm run dev |
サーバー(:20268)と UI(:5173)をホットリロード有効で起動 |
npm run dev:lan |
ローカルネットワーク(LAN)内の他端末からもアクセス可能に起動 |
npm run build |
サーバー、CLI、クライアントの本番ビルドを実行 |
npm test |
全テストスイート(単体テスト、初期化テスト、フック)を実行 |
npm run lint |
TypeScript とコードスタイルの静的解析を実行 |
npm run db:migration:up |
未適用の SQLite マイグレーションをすべて実行 |
npm run db:migration:down |
直前のデータベースマイグレーションをロールバック |
npm run db:migration:create --name=<n> |
新規マイグレーションファイルを生成 |
npm run desktop:dev |
Electron デスクトップアプリを開発モードで起動 |
npm run desktop:dist:win |
Windows 用インストーラー(.exe)をビルド |
npm run desktop:dist:mac:x64 |
macOS Intel 用インストーラー(.dmg)をビルド |
🖼️ ダッシュボード画面プレビュー
動的モデルフォールバック & リアルタイムスコアリング

ローカル暗号化キーストア & クォータ監視

マルチモーダル対応のインタラクティブ・プレイグラウンド

リアルタイムのレイテンシ & トークン消費アナリティクス

⚠️ トラブルシューティング(FAQ)
1. ポート 20268 がすでに使用されている
.env ファイルを変更するか、起動引数で指定してください:
srouter serve --port 20270
2. プロバイダーから 429 Too Many Requests が返される
SRouter はレート制限を受けたキーを自動的にクールダウンし、フォールバックチェーン内の次のモデルに即座にリクエストを転送します。ダッシュボードでキー不要の無料枠(Kilo や OpenCode Free)を有効にしておくことで、完全な停止を防止できます。
3. ダッシュボードのログインパスワードを忘れた
ログイン画面の "Forgot password?" をクリックしてください。ローカルファースト設計のため、1回限りの6桁リセットコードはサーバーのターミナルログに直接出力されます:
# Docker をご利用の場合:
docker compose logs -f srouter
# CLI またはデスクトップアプリの場合:
# ターミナル出力、または ~/.srouter/logs/srouter.log を確認してください
4. データベースと設定ファイルはどこに保存されますか?
- グローバル CLI / ソース実行:
~/.srouter/srouter.db - Docker コンテナ:
/app/server/dataにマウントされたボリューム - Windows デスクトップ:
%APPDATA%\SRouter\srouter.db - macOS デスクトップ:
~/Library/Application Support/SRouter/srouter.db
🤝 コントリビューション
コミュニティからの貢献を心より歓迎します!新しい無料プロバイダーのアダプター追加、プロンプト圧縮の最適化、UI 翻訳の改善など:
- コントリビューターガイド (CONTRIBUTING.md) をご覧ください。
- 行動規範 (CODE_OF_CONDUCT.md) を遵守してください。
- セキュリティ上の問題を発見した場合は、セキュリティポリシー (SECURITY.md) に従ってご報告ください。
❤️ 開発者をサポート
SRouter が日々の開発コスト削減や生産性向上にお役に立ちましたら、ぜひ継続的な開発のご支援をお願いいたします:
📄 ライセンスと免責事項
- ライセンス: オープンソース MIT License の下で公開されています。
- 免責事項: SRouter は個人の研究開発、プロトタイピング、コーディングエージェントの最適化を目的として設計されています。各無料利用枠の運用は各提供元の利用規約に準拠します。企業の本番運用には公式のエンタープライズ有料エンドポイントを推奨します。












































