Skip to content
プロジェクト

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.

AI

README.ja.md

オリジナル

🚀 SRouter

ローカルファーストのスマート AI ゲートウェイ & 無料 LLM ルーター

レート制限(429)によるコーディング中断をゼロに。プロンプト圧縮と自動フォールバックで、約60社の無料 AI プロバイダーと 1,200 以上のエンドポイントを統合。

すべての AI コーディングツール(Claude Code、Cursor、Windsurf、Cline、Codex、Copilot、Aider、OpenCode など)を、単一の OpenAI 互換エンドポイントにシームレス接続。

npm version License: MIT Node.js Docker Ready GHCR Desktop App i18n Locales PRs Welcome Sponsor

⚡ クイックスタート • 🤖 エージェント接続 • 🔌 対応プロバイダー • 🌐 API エンドポイント • 🛠️ MCP 設定 • 🤔 選ばれる理由 • 🔄 動作の仕組み • ✨ 主な機能 • 🏗️ プロジェクト構造 • 📚 ドキュメント

言語 / Language: 🇺🇸 English • 🇮🇩 Bahasa Indonesia • 🇨🇳 简体中文 • 🇯🇵 日本語

Docker でセルフホスト Windows 版をダウンロード macOS (Apple Silicon) 版をダウンロード macOS (Intel) 版をダウンロード Linux 版をダウンロード

SRouter ダッシュボード — リアルタイムルーティング、月間トークン予算、使用量統計

ルーターは 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 内に暗号化保存され、リクエストは端末から直接各公式プロバイダーへ送信されます。

SRouter と OpenRouter・LiteLLM・Portkey の比較 — 単一ルーター、自有キー、マークアップなし


🔄 アーキテクチャと動作の仕組み

┌─────────────────────────────────────────────────────────────────────────────┐
│                      ご利用の 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 アプリケーションをご希望の場合:

  1. Releases リリースページ を開きます。
  2. インストーラーをダウンロード:
    • Windows: SRouter-Setup-x.x.x.exe
    • macOS: SRouter-x.x.x-arm64.dmg(Apple Silicon)または x64.dmg(Intel)。
  3. アプリを起動するとタスクトレイ / メニューバーに常駐し、クリックするとリアルタイム統計と統合 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
Claude Code
Cursor
Cursor
Codex CLI
Codex CLI
Cline
Cline
Continue
Continue
Aider
Aider
OpenCode
OpenCode
Gemini CLI
Gemini CLI
Roo Code
Roo Code
Kilo Code
Kilo Code
Zed
Zed
JetBrains
JetBrains
Goose
Goose
Qwen Code
Qwen Code
Crush
Crush
Factory Droid
Factory Droid
OpenClaw
OpenClaw
DeepSeek Harness
DeepSeek Harness
Oh My Pi
Oh My Pi
Hermes
Hermes
Pi
Pi
AtomCode
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 以上のエンドポイント を統合しています。

積み上がる無料枠 — 約60プロバイダー、1,200以上の無料モデルエンドポイント、900以上のモデルファミリー

Google Gemini
Google Gemini
Groq
Groq
Mistral
Mistral
OpenRouter
OpenRouter
Alibaba Qwen
Alibaba Qwen
Nous Research
Nous Research
SiliconFlow
SiliconFlow
ModelScope
ModelScope
Cloudflare
Cloudflare
Cohere
Cohere
Zhipu GLM
Zhipu GLM
NVIDIA NIM
NVIDIA NIM
Baidu Qianfan
Baidu Qianfan
ByteDance Ark
ByteDance Ark
iFlytek Spark
iFlytek Spark
AMD Radeon
AMD Radeon
HuggingFace
HuggingFace
Kilo
Kilo
LLM7
LLM7
Ollama
Ollama
OVH
OVH
Pollinations
Pollinations
OpenCode
OpenCode
AI Horde
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 ワークスペース定義

✨ 主な機能

SRouter の機能概要 — スマートルーティング、自動フェイルオーバー、Fusion、分析、マルチプロトコル

  • マルチプロトコル自動相互変換:
    • 完全な 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 エミュレーション。
  • プロンプト圧縮 & トークンセーバー:
    • 構造認識と正規表現による非破壊フィルタで、肥大化したツール呼び出し結果(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 翻訳の改善など:

  1. コントリビューターガイド (CONTRIBUTING.md) をご覧ください。
  2. 行動規範 (CODE_OF_CONDUCT.md) を遵守してください。
  3. セキュリティ上の問題を発見した場合は、セキュリティポリシー (SECURITY.md) に従ってご報告ください。

❤️ 開発者をサポート

SRouter が日々の開発コスト削減や生産性向上にお役に立ちましたら、ぜひ継続的な開発のご支援をお願いいたします:

Trakteer Ko-fi PayPal


📄 ライセンスと免責事項

  • ライセンス: オープンソース MIT License の下で公開されています。
  • 免責事項: SRouter は個人の研究開発、プロトタイピング、コーディングエージェントの最適化を目的として設計されています。各無料利用枠の運用は各提供元の利用規約に準拠します。企業の本番運用には公式のエンタープライズ有料エンドポイントを推奨します。
Crafted with passion by @baiibayu & community contributors.