SRouter

Watch the short walkthrough to see the dashboard, provider controls, routing surface, quotas, logs, and supporting features in context.

• Quick start
• Connect coding tools
• Configure a client
• Supported providers
• API endpoints
• Development
• Docker Compose

docker run -d \
  --name srouter \
  --restart unless-stopped \
  -p 3000:3000 \
  -p 1455:1455 \
  -v "$HOME/.srouter:/root/.srouter" \
  ghcr.io/seaavey/srouter:latest

SRouter stores its SQLite database and provider credentials in ~/.srouter on the host.

Open http://localhost:3000 and configure a provider from the dashboard. Then create a virtual API key from API Keys and test a model from Playground.

Requirements: Node.js 22 or later and pnpm 11.

git clone https://github.com/seaavey/SRouter.git
cd SRouter
pnpm install
pnpm build
pnpm start

The dashboard is available at http://localhost:3000.

Install and configure the CLI from npm:

npx @srouter/cli setup
npx @srouter/cli doctor
npx @srouter/cli link claude --model claude-3-7-sonnet
npx @srouter/cli link opencode --model antigravity/gemini-3.7-flash-high

Run a coding tool with SRouter's proxy environment:

npx @srouter/cli run claude

Use --dry-run to preview configuration changes without writing files:

npx @srouter/cli link claude --dry-run

The CLI supports Claude Code and OpenCode. Configuration changes are backed up and can be restored with unlink.

SRouter exposes OpenAI-compatible and Anthropic-compatible endpoints.

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:3000/v1",
    api_key="sr-live-your_virtual_key"
)

response = client.chat.completions.create(
    model="antigravity/gemini-3.7-flash-high",
    messages=[{"role": "user", "content": "Ping!"}],
    stream=True
)

for chunk in response:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
    baseURL: "http://localhost:3000/v1",
    apiKey: "sr-live-your_virtual_key"
});

const message = await client.messages.create({
    model: "anthropic/claude-3-7-sonnet",
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello from SRouter!" }]
});

console.log(message.content[0].text);

curl -N http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sr-live-your_virtual_key" \
  -d '{
    "model": "antigravity/gemini-3.7-flash-high",
    "messages": [{"role": "user", "content": "Ping!"}],
    "stream": true
  }'

SRouter normalizes authentication, model routing, streaming, quotas, and protocol differences across providers.

• OpenAI chat/completions and Anthropic messages protocol translation
• OAuth token refresh for supported providers
• Fallback chains for rate limits and provider failures
• Virtual API keys with rate limits, token quotas, and expiration
• Cloudflare Tunnel management from the dashboard
• Request logs, token usage, quota data, and estimated costs
• Token Saver prompt processing

Most gateway endpoints use the /v1 prefix. The health check is available at /health.

Copy .env.example to .env for local development. The main settings are:

When SROUTER_PUBLIC_URL is set, OAuth callbacks use the main PORT instead of the secondary OAUTH_PORT listener.

This repository is a pnpm workspace managed by Turborepo. It contains the API, web dashboard, CLI, and shared packages.

pnpm install
pnpm dev

The development servers use these ports:

Run focused checks for the app or package you changed:

pnpm --filter <app-or-package> build
pnpm --filter web lint
pnpm exec prettier --check <changed-files>
git diff --check

Run one test file with the package's test setup:

cd apps/api
pnpm exec tsx --test --test-concurrency=1 --import ./tests/setup.ts tests/<focused-file>.test.ts

Do not run root pnpm build, pnpm test, or broad lint commands on resource-constrained development machines. CI runs the full build and test workflow.

services:
    srouter:
        image: ghcr.io/seaavey/srouter:latest
        container_name: srouter
        restart: unless-stopped
        ports:
            - "3000:3000"
            - "1455:1455"
        volumes:
            - ${HOME}/.srouter:/root/.srouter
        environment:
            PORT: 3000
            NODE_ENV: production

SRouter is distributed under the MIT License.