9router Documentation

<div align="center">
<img src="./images/9router.png?1" alt="9Router Dashboard" width="800"/>

# 9Router - FREE AI Router & Token Saver

Never stop coding. Save 20-40% tokens with RTK + auto-fallback to FREE & cheap AI models.

Connect All AI Code Tools (Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini, OpenCode, Cline, OpenClaw...) to 40+ AI Providers & 100+ Models.

![npm](https://www.npmjs.com/package/9router)
![Downloads](https://www.npmjs.com/package/9router)
![Docker Pulls](https://hub.docker.com/r/decolua/9router)
![GHCR](https://github.com/decolua/9router/pkgs/container/9router)
![License](https://github.com/decolua/9router/blob/main/LICENSE)

🚀 Quick Start • 💡 Features • 📖 Setup • 🌐 Website

🇻🇳 Tiếng Việt • 🇨🇳 中文 • 🇯🇵 日本語 • 🇷🇺 Русский • 🇹🇭 ไทย • 🇮🇷 فارسی • 🇮🇩 Indonesia

</div>

---

🤔 Why 9Router?

Stop wasting money, tokens and hitting limits:

- ❌ Subscription quota expires unused every month
- ❌ Rate limits stop you mid-coding
- ❌ Tool outputs (git diff, grep, ls...) burn tokens fast
- ❌ Expensive APIs ($20-50/month per provider)
- ❌ Manual switching between providers

9Router solves this:

- ✅ RTK Token Saver - Auto-compress tool_result content, save 20-40% tokens per request
- ✅ Maximize subscriptions - Track quota, use every bit before reset
- ✅ Auto fallback - Subscription → Cheap → Free, zero downtime
- ✅ Multi-account - Round-robin between accounts per provider
- ✅ Universal - Works with Claude Code, Codex, Cursor, Cline, any CLI tool

---

🔄 How It Works

text

┌─────────────┐ │ Your CLI │ (Claude Code, Codex, OpenClaw, Cursor, Cline...) │ Tool │ └──────┬──────┘ │ http://localhost:20128/v1 ↓ ┌─────────────────────────────────────────────┐ │ 9Router (Smart Router) │ │ • RTK Token Saver (cut tool_result tokens) │ │ • Format translation (OpenAI ↔ Claude) │ │ • Quota tracking │ │ • Auto token refresh │ └──────┬──────────────────────────────────────┘ │ ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, GitHub Copilot │ ↓ quota exhausted ├─→ [Tier 2: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) │ ↓ budget limit └─→ [Tier 3: FREE] Kiro, OpenCode Free, Vertex ($300 credits)

Result: Never stop coding, minimal cost + 20-40% token savings via RTK

---

⚡ Quick Start

1. Install globally:

bash

npm install -g 9router
9router

🎉 Dashboard opens at http://localhost:20128

2. Connect a FREE provider (no signup needed):

Dashboard → Providers → Connect Kiro AI (~50 credits/month free: Claude 4.5 + GLM-5 + MiniMax) or OpenCode Free (no auth) → Done!

3. Use in your CLI tool:

text

Claude Code/Codex/OpenClaw/Cursor/Cline Settings:
  Endpoint: http://localhost:20128/v1
  API Key: [copy from dashboard]
  Model: kr/claude-sonnet-4.5

That's it! Start coding with FREE AI models.

Alternative: run from source (this repository):

This repository package is private (9router-app), so source/Docker execution is the expected local development path.

bash

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

Production mode:

bash

npm run build
PORT=20128 HOSTNAME=0.0.0.0 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run start

Default URLs:

- Dashboard: http://localhost:20128/dashboard
- OpenAI-compatible API: http://localhost:20128/v1

---

Video Guides

<table>
<tr>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=X69n5Lm06Yw">
<img src="https://img.youtube.com/vi/X69n5Lm06Yw/maxresdefault.jpg" alt="Tiết kiệm chi phí LLM với 9Router" width="300"/>
</a> 
🇻🇳 Tiếng Việt 
Tiết kiệm chi phí LLM cho OpenClaw với 9Router by <a href="https://www.youtube.com/c/M%C3%ACAIblog">Mì AI</a>
</td>
<td align="center" width="320">
<a href="https://youtu.be/VQAw612S27Y">
<img src="https://img.youtube.com/vi/VQAw612S27Y/maxresdefault.jpg" alt="9Router + Claude Code FREE Unlimited Setup" width="300"/>
</a> 
🇵🇰 اردو / हिन्दी 
9Router + Claude Code FREE Unlimited Setup by <a href="https://www.youtube.com/@BuildAIWithHamid">Build AI With Hamid</a>
</td>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=raEyZPg5xE0">
<img src="https://img.youtube.com/vi/raEyZPg5xE0/maxresdefault.jpg" alt="9Router Setup Tutorial" width="300"/>
</a> 
🇺🇸 English 
9Router + Claude Code FREE Setup by <a href="https://www.youtube.com/@BuildAIWithHamid">Build AI With Hamid</a>
</td>
<td align="center" width="320">
<a href="https://youtu.be/3dF5GIYMrcQ?si=bAyfyiHbARJQAHj_">
<img src="https://img.youtube.com/vi/3dF5GIYMrcQ/hqdefault.jpg" alt="9Router Setup Tutorial" width="300"/>
</a> 
🇺🇸 English 
9Router + Claude Code FREE Setup by <a href="https://www.youtube.com/@BuildAIWithHamid">Build AI With Hamid</a>
</td>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=o3qYCyjrFYg">
<img src="https://img.youtube.com/vi/o3qYCyjrFYg/maxresdefault.jpg" alt="Claude Code FREE Forever" width="300"/>
</a> 
🇺🇸 English 
Claude Code FREE Forever — Unlimited Models by <a href="https://www.youtube.com/@BuildAIWithHamid">Build AI With Hamid</a>
</td>
</tr>
<tr>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=Ttpc26m39Dw">
<img src="https://img.youtube.com/vi/Ttpc26m39Dw/maxresdefault.jpg" alt="Claude CLI Free Setup" width="300"/>
</a> 
🇺🇸 English 
Claude CLI Free Setup with 9Router 🚀 by <a href="https://www.youtube.com/@CodeVerseSoban">CodeVerse Soban</a>
</td>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=G-5A_D5Pm6Y">
<img src="https://img.youtube.com/vi/G-5A_D5Pm6Y/maxresdefault.jpg" alt="Cài đặt OpenClaw Free A-Z" width="300"/>
</a> 
🇻🇳 Tiếng Việt 
Cài Đặt OpenClaw Free Từ A-Z + 9Router by <a href="https://www.youtube.com/@maigia">Mai Gia</a>
</td>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=JXmg8_gccgE">
<img src="https://img.youtube.com/vi/JXmg8_gccgE/maxresdefault.jpg" alt="FREE OpenClaw with Claude Opus" width="300"/>
</a> 
🇺🇸 English 
FREE OpenClaw + Claude Opus 4.6 by <a href="https://www.youtube.com/@BuildAIWithHamid">Build AI With Hamid</a>
</td>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=CkVZZUSTXAI">
<img src="https://img.youtube.com/vi/CkVZZUSTXAI/mqdefault.jpg" alt="Claude CLI Free Setup" width="300"/>
</a> 
🇮🇩 Indonesia 
Koding 24 Jam Anti Rate Limit! Hemat Token AI 65% | Tutorial Quick Setup 9Router 🚀 by <a href="https://www.youtube.com/@krisswuh">Krisswuh</a>
</td>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=TXGv4eofe1I">
<img src="https://img.youtube.com/vi/TXGv4eofe1I/mqdefault.jpg" alt="Cara Deploy 9Router di Hugging Face GRATIS Non-Stop! | Alternatif VPS RAM 16GB" width="300"/>
</a> 
🇮🇩 Indonesia 
Cara Deploy 9Router di Hugging Face GRATIS Non-Stop! | Alternatif VPS RAM 16GB by <a href="https://www.youtube.com/@krisswuh">Krisswuh</a>
</td>
</tr>
<tr>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=GyX-DLvePW8">
<img src="https://img.youtube.com/vi/GyX-DLvePW8/hqdefault.jpg" alt="این شکلی از هر API ای استفاده کن برای هوش مصنوعی" width="300"/>
</a> 
🇮🇷 Persian-فارسی 
این شکلی از هر API ای استفاده کن برای هوش مصنوعی by <a href="https://www.youtube.com/@Matin_SenPai">Matin SenPai</a>
</td>
<td align="center" width="320">
<a href="https://www.youtube.com/watch?v=hPusYX-5Pmw">
<img src="https://img.youtube.com/vi/hPusYX-5Pmw/maxresdefault.jpg" alt="Hướng Dẫn Setup OpenClaw + 9Router: Tạo Bot Zalo AI Tự Động Từ A-Z" width="300"/>
</a> 
🇻🇳 Tiếng Việt 
Hướng Dẫn Setup OpenClaw + 9Router: Tạo Bot Zalo AI Tự Động Từ A-Z by <a href="https://github.com/tuanminhhole">tuanminhhole</a>
</td>
<td align="center" width="320"></td>
<td align="center" width="320"></td>
<td align="center" width="320"></td>
</tr>
</table>

</div>

🎬 Made a video about 9Router? Submit a Pull Request adding your video to this section — we'll merge it!

---

🛠️ Supported CLI Tools

9Router works seamlessly with all major AI coding tools:

<div align="center">
<table>
<tr>
<td align="center" width="120">
<img src="./public/providers/claude.png" width="60" alt="Claude Code"/> 
Claude-Code
</td>
<td align="center" width="120">
<img src="./public/providers/openclaw.png" width="60" alt="OpenClaw"/> 
OpenClaw
</td>
<td align="center" width="120">
<img src="./public/providers/codex.png" width="60" alt="Codex"/> 
Codex
</td>
<td align="center" width="120">
<img src="./public/providers/opencode.png" width="60" alt="OpenCode"/> 
OpenCode
</td>
<td align="center" width="120">
<img src="./public/providers/cursor.png" width="60" alt="Cursor"/> 
Cursor
</td>
<td align="center" width="120">
<img src="./public/providers/antigravity.png" width="60" alt="Antigravity"/> 
Antigravity
</td>
</tr>
<tr>
<td align="center" width="120">
<img src="./public/providers/cline.png" width="60" alt="Cline"/> 
Cline
</td>
<td align="center" width="120">
<img src="./public/providers/continue.png" width="60" alt="Continue"/> 
Continue
</td>
<td align="center" width="120">
<img src="./public/providers/droid.png" width="60" alt="Droid"/> 
Droid
</td>
<td align="center" width="120">
<img src="./public/providers/roo.png" width="60" alt="Roo"/> 
Roo
</td>
<td align="center" width="120">
<img src="./public/providers/copilot.png" width="60" alt="Copilot"/> 
Copilot
</td>
<td align="center" width="120">
<img src="./public/providers/kilocode.png" width="60" alt="Kilo Code"/> 
Kilo Code
</td>
</tr>
<tr>
<td align="center" width="120">
<img src="./public/providers/opendesign.png" width="60" alt="OpenDesign"/> 
OpenDesign
</td>
<td align="center" width="120">
<img src="./public/providers/jcode.png" width="60" alt="jcode"/> 
jcode
</td>
<td align="center" width="120">
<img src="./public/providers/grok-cli.png" width="60" alt="Grok Build"/> 
Grok Build
</td>
<td align="center" width="120">
<img src="./public/providers/devin-cli.png" width="60" alt="Devin CLI"/> 
Devin CLI
</td>
<td align="center" width="120">
<img src="./public/providers/deepseek-tui.png" width="60" alt="DeepSeek TUI"/> 
DeepSeek TUI
</td>
<td align="center" width="120">
<img src="./public/providers/qwen.png" width="60" alt="Qwen Code"/> 
Qwen Code
</td>
</tr>
</table>
</div>

---

🌐 Supported Providers

🔐 OAuth Providers

🆓 Free Providers

<div align="center">
<table>
<tr>
<td align="center" width="150">
<img src="./public/providers/kiro.png" width="70" alt="Kiro"/> 
Kiro AI 
Claude 4.5 + GLM-5 + MiniMax 50 credits/month free
</td>
<td align="center" width="150">
<img src="./public/providers/opencode.png" width="70" alt="OpenCode Free"/> 
OpenCode Free 
No auth • Auto-fetch models Free (model list varies)
</td>
<td align="center" width="150">
<img src="./public/providers/gemini.png" width="70" alt="Vertex AI"/> 
Vertex AI 
Gemini 3 Pro + GLM-5 + DeepSeek $300 credits free
</td>
</tr>
</table>
</div>

Note: iFlow, Qwen Code and Gemini CLI free tiers were discontinued in 2026. Use Kiro / OpenCode Free / Vertex instead.

> Kiro AI moved to a paid model in Sep 2025 — the free tier is now capped at 50 credits/month (plus 500 trial credits for new accounts in the first 30 days). Paid tiers: Pro $20/mo (1,000 credits), Pro+ $40/mo (2,000), Pro Max $100/mo (5,000), Power $200/mo (10,000).

OpenCode Free model list fluctuates over time (some models free only for limited promos) — subject to change without notice.

Vertex AI: the $300 free credit for new GCP accounts is still valid, but since Mar 2026 the Gemini API endpoint no longer consumes these credits — call the Vertex AI Studio endpoint instead.

🔑 API Key Providers (40+)

<div align="center">
<table>
<tr>
<td align="center" width="100">
<img src="./public/providers/openrouter.png" width="50" alt="OpenRouter"/> 
OpenRouter
</td>
<td align="center" width="100">
<img src="./public/providers/glm.png" width="50" alt="GLM"/> 
GLM
</td>
<td align="center" width="100">
<img src="./public/providers/kimi.png" width="50" alt="Kimi"/> 
Kimi
</td>
<td align="center" width="100">
<img src="./public/providers/minimax.png" width="50" alt="MiniMax"/> 
MiniMax
</td>
<td align="center" width="100">
<img src="./public/providers/openai.png" width="50" alt="OpenAI"/> 
OpenAI
</td>
<td align="center" width="100">
<img src="./public/providers/anthropic.png" width="50" alt="Anthropic"/> 
Anthropic
</td>
</tr>
<tr>
<td align="center" width="100">
<img src="./public/providers/gemini.png" width="50" alt="Gemini"/> 
Gemini
</td>
<td align="center" width="100">
<img src="./public/providers/deepseek.png" width="50" alt="DeepSeek"/> 
DeepSeek
</td>
<td align="center" width="100">
<img src="./public/providers/groq.png" width="50" alt="Groq"/> 
Groq
</td>
<td align="center" width="100">
<img src="./public/providers/xai.png" width="50" alt="xAI"/> 
xAI
</td>
<td align="center" width="100">
<img src="./public/providers/mistral.png" width="50" alt="Mistral"/> 
Mistral
</td>
<td align="center" width="100">
<img src="./public/providers/perplexity.png" width="50" alt="Perplexity"/> 
Perplexity
</td>
</tr>
<tr>
<td align="center" width="100">
<img src="./public/providers/together.png" width="50" alt="Together"/> 
Together AI
</td>
<td align="center" width="100">
<img src="./public/providers/fireworks.png" width="50" alt="Fireworks"/> 
Fireworks
</td>
<td align="center" width="100">
<img src="./public/providers/cerebras.png" width="50" alt="Cerebras"/> 
Cerebras
</td>
<td align="center" width="100">
<img src="./public/providers/cohere.png" width="50" alt="Cohere"/> 
Cohere
</td>
<td align="center" width="100">
<img src="./public/providers/nvidia.png" width="50" alt="NVIDIA"/> 
NVIDIA
</td>
<td align="center" width="100">
<img src="./public/providers/siliconflow.png" width="50" alt="SiliconFlow"/> 
SiliconFlow
</td>
</tr>
</table>
...and 20+ more providers including Nebius, Chutes, Hyperbolic, and custom OpenAI/Anthropic compatible endpoints
</div>

🏠 Self-hosted Providers

For speech and embeddings served from your own machine — whisper.cpp,
faster-whisper, Speaches, Kokoro-FastAPI, openedai-speech, llama.cpp/llama-server,
vLLM, Infinity, text-embeddings-inference, or anything else that speaks the OpenAI
shape.

| Provider | Endpoint used | Typical server |
| --- | --- | --- |
| Self-hosted STT | /v1/audio/transcriptions | whisper.cpp, faster-whisper |
| Self-hosted TTS | /v1/audio/speech | Kokoro-FastAPI, openedai-speech |
| Self-hosted Embedding | /v1/embeddings | llama-server, vLLM, Infinity |

Every other speech provider is a named cloud service with a fixed endpoint. These
three read their address from each connection, so one provider can front
several machines and load-balance across them like any other.

Set it on the connection as providerSpecificData.baseUrl:

| Provider | Give it | Result |
| --- | --- | --- |
| Self-hosted STT | the full URL — http://host:8080/v1/audio/transcriptions | used as-is |
| Self-hosted TTS | the server root — http://host:8880 | + /v1/audio/speech |
| Self-hosted Embedding | the OpenAI base, /v1 included — http://host:8080/v1 | + /embeddings |

Mind the /v1 on embeddings. The adapter appends /embeddings, so

http://host:8080 resolves to http://host:8080/embeddings and misses the

OpenAI route — llama-server answers 501. Give it the same base URL an OpenAI

client would use. A full .../v1/embeddings is also accepted, so a value pasted

from a curl example works too.

The API key is not checked by most local servers, but the field must be non-empty:
it is what gives the connection a credentials record, and baseUrl lives there.
Any placeholder works.

Self-hosted Embedding has no cloud fallback by design — a connection saved
without a baseUrl is reported as a configuration error rather than quietly
falling back to api.openai.com, which would send your input text and API key to
a third party under a provider named "Self-hosted".

---

💡 Key Features

| Feature | What It Does | Why It Matters |
| --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------- |
| 🚀 RTK Token Saver (RTK ⭐40K) | Compress tool outputs (git diff, grep, ls, tree...) before sending to LLM | Save 20-40% input tokens per request |
| 🧠 Headroom Token Saver (Headroom) | Optional external /v1/compress proxy before provider routing | Save more context tokens without changing clients |
| 🪨 Caveman Mode (Caveman ⭐52K) | Inject caveman-speak prompt → LLM replies terse, technical substance preserved | Save up to 65% output tokens |
| 🐴 Ponytail (Ponytail) | Inject "lazy senior dev" prompt → LLM writes minimal, YAGNI-first code (Lite/Full/Ultra) | Fewer output tokens, less refactoring |
| 🎯 Smart 3-Tier Fallback | Auto-route: Subscription → Cheap → Free | Never stop coding, zero downtime |
| 📊 Real-Time Quota Tracking | Live token count + reset countdown | Maximize subscription value |
| 🔄 Format Translation | OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro ↔ Vertex | Works with any CLI tool |
| 👥 Multi-Account Support | Multiple accounts per provider | Load balancing + redundancy |
| 🔄 Auto Token Refresh | OAuth tokens refresh automatically | No manual re-login needed |
| 🎨 Custom Combos | Create unlimited model combinations | Tailor fallback to your needs |
| 📝 Request Logging | Debug mode with full request/response logs | Troubleshoot issues easily |
| 💾 Cloud Sync | Sync config across devices | Same setup everywhere |
| 📊 Usage Analytics | Track tokens, cost, trends over time | Optimize spending |
| 🌐 Deploy Anywhere | Localhost, VPS, Docker, Cloudflare Workers | Flexible deployment options |

Set X-9Router-Token-Saver: off to bypass all token savers for one chat request.

<details>
<summary>📖 Feature Details</summary>

🚀 RTK Token Saver

Tool outputs (git diff, grep, find, ls, tree, log dumps...) often eat 30-50% of your prompt budget. RTK detects them and applies smart, lossless compression before the request hits the LLM:

- Filters: git-diff, git-status, grep, find, ls, tree, dedup-log, smart-truncate, read-numbered, search-list
- Auto-detect: No config needed — RTK peeks the first 1KB of each tool_result and picks the right filter.
- Safe by design: If a filter fails, throws, or makes output bigger, RTK silently keeps the original text. Errors never break your request.
- Universal: Works across all formats (OpenAI, Claude, Gemini, Cursor, Kiro, OpenAI Responses) because it runs before any format translation.
- Default ON: Toggle anytime in Dashboard → Endpoint settings.

text

Without RTK: 47K tokens sent to LLM
With RTK:    28K tokens sent to LLM   (40% saved · same context · same answer)

🧠 Headroom Token Saver

Headroom is optional and runs separately. 9Router calls Headroom's local /v1/compress endpoint, then keeps normal routing, fallback, auth, and usage tracking:

text

Client → 9Router → Headroom /v1/compress → 9Router → provider

Local setup:

bash

pip install "headroom-ai[proxy]"
headroom proxy --port 8787

Enable in Dashboard → Endpoint → Token Saver → Headroom. Default URL: http://localhost:8787.

Docker examples:

bash

Headroom service in same Docker network

http://headroom:8787
Headroom running on host machine

http://host.docker.internal:8787

If Headroom is down or returns an error, 9Router fails open and sends the original request.

🐴 Ponytail (Lazy Senior Dev)

Ponytail injects a _"lazy senior dev"_ system prompt into every request, biasing the LLM toward minimal, YAGNI-first code — deletion over addition, stdlib over new deps, one-liners over abstractions. Adapted from DietrichGebert/ponytail.

- Lite — Build what's asked, name the lazier alternative.
- Full — YAGNI ladder enforced: stdlib → native → existing deps → one-liner → minimal code.
- Ultra — YAGNI extremist: deletion first, ship the one-liner, challenge the rest of the requirement in the same response.

text

Without Ponytail: verbose code, extra abstractions, "just in case" scaffolding
With Ponytail:    shortest working diff, no unrequested abstractions, fewer tokens

Never trades away: input validation, error handling that prevents data loss, security, accessibility, or anything explicitly requested. Enable in Dashboard → Endpoint → Ponytail. Stacks with Caveman (output terseness) and RTK (input compression).

🎯 Smart 3-Tier Fallback

Create combos with automatic fallback:

text

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6        (your subscription)
  2. glm/glm-4.7               (cheap backup, $0.6/1M)
  3. if/kimi-k2-thinking       (free fallback)→ Auto switches when quota runs out or errors occur

📊 Real-Time Quota Tracking

- Token consumption per provider
- Reset countdown (5-hour, daily, weekly)
- Cost estimation for paid tiers
- Monthly spending reports

🔄 Format Translation

Seamless translation between formats:

- OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro ↔ Vertex ↔ Antigravity ↔ Ollama ↔ OpenAI Responses
- Your CLI tool sends OpenAI format → 9Router translates → Provider receives native format
- Works with any tool that supports custom OpenAI endpoints

👥 Multi-Account Support

- Add multiple accounts per provider
- Auto round-robin or priority-based routing
- Fallback to next account when one hits quota

🔄 Auto Token Refresh

- OAuth tokens automatically refresh before expiration
- No manual re-authentication needed
- Seamless experience across all providers

🎨 Custom Combos

- Create unlimited model combinations
- Mix subscription, cheap, and free tiers
- Name your combos for easy access
- Share combos across devices with Cloud Sync

📝 Request Logging

- Enable debug mode for full request/response logs
- Track API calls, headers, and payloads
- Troubleshoot integration issues
- Export logs for analysis

💾 Cloud Sync

- Sync providers, combos, and settings across devices
- Automatic background sync
- Secure encrypted storage
- Access your setup from anywhere

#### Cloud Runtime Notes

- Prefer server-side cloud variables in production:
- BASE_URL (internal callback URL used by sync scheduler)
- CLOUD_URL (cloud sync endpoint base)
- NEXT_PUBLIC_BASE_URL and NEXT_PUBLIC_CLOUD_URL are still supported for compatibility/UI, but server runtime now prioritizes BASE_URL/CLOUD_URL.
- Cloud sync requests now use timeout + fail-fast behavior to avoid UI hanging when cloud DNS/network is unavailable.

📊 Usage Analytics

- Track token usage per provider and model
- Cost estimation and spending trends
- Monthly reports and insights
- Optimize your AI spending

💡 IMPORTANT - Understanding Dashboard Costs:

> The "cost" displayed in Usage Analytics is for tracking and comparison purposes only.

9Router itself never charges you anything. You only pay providers directly (if using paid services).

> Example: If your dashboard shows "$290 total cost" while using Kiro free models, this represents

what you would have paid using paid APIs directly. Your actual cost = $0 (Kiro free tier: ~50 credits/mo).

> Think of it as a "savings tracker" showing how much you're saving by using free models or

routing through 9Router!

🌐 Deploy Anywhere

- 💻 Localhost - Default, works offline
- ☁️ VPS/Cloud - Share across devices
- 🐳 Docker - One-command deployment
- 🚀 Cloudflare Workers - Global edge network

</details>

---

💰 Pricing at a Glance

| Tier | Provider | Cost | Quota Reset | Best For |
| ------------------- | --------------------- | ------------ | ---------------- | --------------------------------------- |
| 🚀 TOKEN SAVER | RTK (built-in) | FREE | Always on | Save 20-40% tokens on EVERY request |
| 💳 SUBSCRIPTION | Claude Code (Pro/Max) | $20-200/mo | 5h + weekly | Already subscribed |
| | Codex (Plus/Pro) | $20-200/mo | 5h + weekly | OpenAI users |
| | GitHub Copilot | $10-19/mo | Monthly | GitHub users |
| | Cursor IDE | $20/mo | Monthly | Cursor users |
| 💰 CHEAP | GLM-5.1 / GLM-4.7 | $0.6/1M | Daily 10AM | Budget backup |
| | MiniMax M2.7 | $0.2/1M | 5-hour rolling | Cheapest option |
| | Kimi K2.5 | $9/mo flat | 10M tokens/mo | Predictable cost |
| 🆓 FREE | Kiro AI | $0 | 50 credits/mo | Claude 4.5 + GLM-5 + MiniMax free (paid tiers above) |
| | OpenCode Free | $0 | Varies* | No auth, auto-fetch models (list changes over time) |
| | Vertex AI | $300 credits | New GCP accounts | Gemini 3 Pro + DeepSeek + GLM-5 (use Vertex AI Studio endpoint for free credits) |

💡 Pro Tip: RTK + Kiro AI + OpenCode Free combo = $0 cost + 20-40% token savings!

---

📊 Understanding 9Router Costs & Billing

9Router Billing Reality:

✅ 9Router software = FREE forever (open source, never charges)
✅ Dashboard "costs" = Display/tracking only (not actual bills)
✅ You pay providers directly (subscriptions or API fees)
✅ FREE providers stay FREE (Kiro ~50 credits/mo, OpenCode Free, Vertex $300 credits = $0 within free-tier limits) — note iFlow/Qwen/Gemini CLI free tiers were discontinued in 2026
❌ 9Router never sends invoices or charges your card

How Cost Display Works:

The dashboard shows estimated costs as if you were using paid APIs directly. This is not billing - it's a comparison tool to show your savings.

Example Scenario:

text

Dashboard Display: • Total Requests: 1,662 • Total Tokens: 47M • Display Cost: $290

Reality Check: • Provider: Kiro (free tier: ~50 credits/mo) • Actual Payment: $0.00 • What $290 Means: Amount you SAVED by using free models!

Payment Rules:

- Subscription providers (Claude Code, Codex): Pay them directly via their websites
- Cheap providers (GLM, MiniMax): Pay them directly, 9Router just routes
- FREE providers (iFlow, Kiro, Qwen): Genuinely free forever, no hidden charges
- 9Router: Never charges anything, ever

---

🎯 Use Cases

Case 1: "I have Claude Pro subscription"

Problem: Quota expires unused, rate limits during heavy coding

Solution:

text

Combo: "maximize-claude"
  1. cc/claude-opus-4-7        (use subscription fully)
  2. glm/glm-5.1               (cheap backup when quota out)
  3. kr/claude-sonnet-4.5      (free emergency fallback)Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
vs. $20 + hitting limits = frustration

Case 2: "I want zero cost"

Problem: Can't afford subscriptions, need reliable AI coding

Solution:

text

Combo: "free-forever"
  1. kr/claude-sonnet-4.5      (Claude 4.5 free via Kiro, ~50 credits/mo)
  2. kr/glm-5                  (GLM-5 free via Kiro)
  3. oc/<auto>                 (OpenCode Free, no auth)Monthly cost: $0
Quality: Production-ready models + RTK saves 20-40% tokens

Case 3: "I need 24/7 coding, no interruptions"

Problem: Deadlines, can't afford downtime

Solution:

text

Combo: "always-on"
  1. cc/claude-opus-4-7        (best quality)
  2. cx/gpt-5.5                (second subscription)
  3. glm/glm-5.1               (cheap, resets daily)
  4. minimax/MiniMax-M2.7      (cheapest, 5h reset)
  5. kr/claude-sonnet-4.5      (free via Kiro, ~50 credits/mo)Result: 5 layers of fallback = zero downtime
Monthly cost: $20-200 (subscriptions) + $10-20 (backup)

Case 4: "I want FREE AI in OpenClaw"

Problem: Need AI assistant in messaging apps (WhatsApp, Telegram, Slack...), completely free

Solution:

text

Combo: "openclaw-free" 1. kr/claude-sonnet-4.5 (Claude 4.5 free) 2. kr/glm-5 (GLM-5 free) 3. kr/MiniMax-M2.5 (MiniMax free)

Monthly cost: $0 Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...

---

❓ Frequently Asked Questions

<details>
<summary>📊 Why does my dashboard show high costs?</summary>

The dashboard tracks your token usage and displays estimated costs as if you were using paid APIs directly. This is not actual billing - it's a reference to show how much you're saving by using free models or existing subscriptions through 9Router.

Example:

- Dashboard shows: "$290 total cost"
- Reality: You're using Kiro free models (~50 credits/mo)
- Your actual cost: $0.00
- What $290 means: Amount you saved by using free models instead of paid APIs!

The cost display is a "savings tracker" to help you understand your usage patterns and optimization opportunities.

</details>

<details>
<summary>💳 Will I be charged by 9Router?</summary>

No. 9Router is free, open-source software that runs on your own computer. It never charges you anything.

You only pay:

- ✅ Subscription providers (Claude Code $20/mo, Codex $20-200/mo) → Pay them directly on their websites
- ✅ Cheap providers (GLM, MiniMax) → Pay them directly, 9Router just routes your requests
- ❌ 9Router itself → Never charges anything, ever

9Router is a local proxy/router. It doesn't have your credit card, can't send invoices, and has no billing system. It's completely free software.

</details>

<details>
<summary>🆓 Are FREE providers really unlimited?</summary>

Mostly! The current FREE providers (Kiro, OpenCode Free, Vertex) are genuinely free, but free tiers have limits:

These are free services offered by those respective companies:

- Kiro AI: ~50 credits/month free (plus 500 trial credits for new accounts in the first 30 days) via AWS Builder ID / Google / GitHub OAuth. Paid tiers available above that.
- OpenCode Free: No-auth passthrough proxy, models auto-fetched from opencode.ai/zen/v1/models. The free model list fluctuates over time (some models free only for limited promos) — subject to change without notice.
- Vertex AI: $300 free credits for new Google Cloud accounts (90 days). Since Mar 2026 the Gemini API endpoint no longer consumes these credits — use the Vertex AI Studio endpoint instead.

9Router just routes your requests to them - there's no "catch" or future billing from 9Router itself. They're truly free services, and 9Router makes them easy to use with fallback support.

Discontinued free tiers (no longer recommended):

- ❌ iFlow: Was free unlimited, now changed to paid (2026)
- ❌ Qwen Code: Free OAuth tier fully discontinued by Alibaba on 2026-04-15
- ❌ Gemini CLI: Service fully shut down by Google on 2026-06-18 (replaced by the closed-source Antigravity CLI). Discontinued — do not use.

</details>

<details>
<summary>💰 How do I minimize my actual AI costs?</summary>

Free-First Strategy:

1. Start with 100% free combo:

text

1. kr/glm-5 (GLM-5 free via Kiro, ~50 credits/mo)
   2. OpenCode Free models (no auth, auto-fetched)
   3. Vertex AI Gemini 3 Pro (using the Vertex AI Studio endpoint with $300 credits)

Cost: $0/month (within Kiro's free credit cap; OpenCode/Vertex subject to their free-tier limits)

2. Add cheap backup only if you need it:

text

4. glm/glm-4.7 ($0.6/1M tokens)

Additional cost: Only pay for what you actually use

3. Use subscription providers last:
- Only if you already have them
- 9Router helps maximize their value through quota tracking

Result: Most users can operate at $0/month using only free tiers!

</details>

<details>
<summary>📈 What if my usage suddenly spikes?</summary>

9Router's smart fallback prevents surprise charges:

Scenario: You're on a coding sprint and blow through your quotas

Without 9Router:

- ❌ Hit rate limit → Work stops → Frustration
- ❌ Or: Accidentally rack up huge API bills

With 9Router:

- ✅ Subscription hits limit → Auto-fallback to cheap tier
- ✅ Cheap tier gets expensive → Auto-fallback to free tier
- ✅ Never stop coding → Predictable costs

You're in control: Set spending limits per provider in dashboard, and 9Router respects them.

</details>

---

📖 Setup Guide

<details>
<summary>🔐 Subscription Providers (Maximize Value)</summary>

Claude Code (Pro/Max)

bash

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

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

Pro Tip: Use Opus for complex tasks, Sonnet for speed. 9Router tracks quota per model!

OpenAI Codex (Plus/Pro)

bash

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

Models: cx/gpt-5.5 cx/gpt-5.4 cx/gpt-5.3-codex cx/gpt-5.2-codex

GitHub Copilot

bash

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

Models: gh/gpt-5.4 gh/claude-opus-4.7 gh/claude-sonnet-4.6 gh/gemini-3.1-pro-preview gh/grok-code-fast-1

Cursor IDE

bash

Dashboard → Providers → Connect Cursor → OAuth login → Monthly subscription

Models: cu/claude-4.6-opus-max cu/claude-4.5-sonnet-thinking cu/gpt-5.3-codex

</details>

<details>
<summary>💰 Cheap Providers (Backup)</summary>

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

1. Sign up: Zhipu AI
2. Get API key from Coding Plan
3. Dashboard → Add API Key:
- Provider: glm
- API Key: your-key

Use: glm/glm-5.1, glm/glm-5, glm/glm-4.7

Pro Tip: Coding Plan offers 3× quota at 1/7 cost! Reset daily 10:00 AM.

MiniMax M2.7 (5h reset, $0.20/1M)

1. Sign up: MiniMax
2. Get API key
3. Dashboard → Add API Key

Use: minimax/MiniMax-M2.7, minimax/MiniMax-M2.5

Pro Tip: Cheapest option for long context (1M tokens)!

Kimi K2.5 ($9/month flat)

1. Subscribe: Moonshot AI
2. Get API key
3. Dashboard → Add API Key

Use: kimi/kimi-k2.5, kimi/kimi-k2.5-thinking

Pro Tip: Fixed $9/month for 10M tokens = $0.90/1M effective cost!

</details>

<details>
<summary>🆓 FREE Providers (Recommended)</summary>

Kiro AI (Claude 4.5 + GLM-5 + MiniMax FREE)

bash

Dashboard → Connect Kiro → AWS Builder ID, AWS IAM Identity Center, Google, or GitHub → Unlimited usage

Models: kr/claude-sonnet-4.5 kr/claude-haiku-4.5 kr/glm-5 kr/MiniMax-M2.5 kr/qwen3-coder-next kr/deepseek-3.2

Pro Tip: Best free option for Claude. No API key, no payment, fully unlimited.

OpenCode Free (No auth, auto-fetch models)

bash

Dashboard → Connect OpenCode Free
→ No login required (passthrough proxy)
→ Models auto-fetched from opencode.ai/zen/v1/models

Pro Tip: Fastest setup. Just connect and start coding.

Vertex AI ($300 free credits for new GCP accounts)

bash

Dashboard → Connect Vertex AI → Upload Google Cloud Service Account JSON → Enable Vertex AI API in your GCP project Models: vertex/gemini-3.1-pro-preview vertex/gemini-3-flash-preview vertex/gemini-2.5-flash

Vertex Partner (Anthropic / DeepSeek / GLM / Qwen via Vertex): vertex-partner/glm-5-maas vertex-partner/deepseek-v3.2-maas vertex-partner/qwen3-next-80b-a3b-thinking-maas

Pro Tip: New Google Cloud accounts get $300 credits free for 90 days. Plenty for daily coding.

</details>

<details>
<summary>🎨 Create Combos</summary>

Example 1: Maximize Subscription → Cheap Backup

text

Dashboard → Combos → Create New
Name: premium-coding
Models:
  1. cc/claude-opus-4-7 (Subscription primary)
  2. glm/glm-5.1 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.7 (Cheapest fallback, $0.20/1M)
Use in CLI: premium-codingMonthly cost example (100M tokens):
  80M via Claude (subscription): $0 extra
  15M via GLM: $9
  5M via MiniMax: $1
  Total: $10 + your subscription

Example 2: Free-Only (Zero Cost)

text

Name: free-combo
Models:
  1. kr/claude-sonnet-4.5 (Claude 4.5 free via Kiro, ~50 credits/mo)
  2. kr/glm-5 (GLM-5 free via Kiro)
  3. vertex/gemini-3.1-pro-preview ($300 free credits)Cost: $0 forever (+ 20-40% token savings via RTK)!

</details>

<details>
<summary>🔧 CLI Integration</summary>

Cursor IDE

text

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

Or use combo: premium-coding

Claude Code

Edit ~/.claude/config.json:

json

{
  "anthropic_api_base": "http://localhost:20128/v1",
  "anthropic_api_key": "your-9router-api-key"
}

Codex CLI

bash

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

codex "your prompt"

OpenClaw

Option 1 — Dashboard (recommended):

text

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

Option 2 — Manual: Edit ~/.openclaw/openclaw.json:

json

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "9router/kr/claude-sonnet-4.5"
      }
    }
  },
  "models": {
    "providers": {
      "9router": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_9router",
        "api": "openai-completions",
        "models": [
          {
            "id": "kr/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5 (Kiro Free)"
          }
        ]
      }
    }
  }
}

Note: OpenClaw only works with local 9Router. Use 127.0.0.1 instead of localhost to avoid IPv6 resolution issues.

Cline / Continue / RooCode

text

Provider: OpenAI Compatible
Base URL: http://localhost:20128/v1
API Key: [from dashboard]
Model: cc/claude-opus-4-7

</details>

<details>
<summary>🚀 Deployment</summary>

VPS Deployment

bash

Clone and install

git clone https://github.com/decolua/9router.git
cd 9router
npm install
npm run build
Configure

export JWT_SECRET="your-secure-secret-change-this"
export INITIAL_PASSWORD="your-password"
export DATA_DIR="/var/lib/9router"
export PORT="20128"
export HOSTNAME="0.0.0.0"
export NODE_ENV="production"
export NEXT_PUBLIC_BASE_URL="http://localhost:20128"
export NEXT_PUBLIC_CLOUD_URL="https://9router.com"
export API_KEY_SECRET="endpoint-proxy-api-key-secret"
export MACHINE_ID_SALT="endpoint-proxy-salt"
Start

npm run start
Or use PM2

npm install -g pm2
pm2 start npm --name 9router -- start
pm2 save
pm2 startup

Docker

Published images (multi-platform linux/amd64 + linux/arm64):

- Docker Hub: decolua/9router
- GHCR: ghcr.io/decolua/9router

Quick start (use published image):

bash

docker run -d \
  --name 9router \
  -p 20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data \
  decolua/9router:latest

→ Open http://localhost:20128

Build from source (dev):

bash

git clone https://github.com/decolua/9router.git
cd 9router/app
docker build -t 9router .
docker run -d --name 9router -p 20128:20128 \
  -v "$HOME/.9router:/app/data" -e DATA_DIR=/app/data 9router

Container defaults:

- PORT=20128
- HOSTNAME=0.0.0.0

Useful commands:

bash

docker logs -f 9router
docker restart 9router
docker stop 9router && docker rm 9router
docker pull decolua/9router:latest   # update to latest

Data persistence: $HOME/.9router/db/data.sqlite on host ↔ /app/data/db/data.sqlite in container.

Environment Variables

| Variable | Default | Description |
| ---------------------------------------------------- | ---------------------------------------- | ----------------------------------------------------------------------------------- |
| JWT_SECRET | Auto-generated (~/.9router/jwt-secret) | JWT signing secret for dashboard auth cookie (override to share across instances) |
| INITIAL_PASSWORD | 123456 | First login password when no saved hash exists |
| DATA_DIR | ~/.9router | Main app data location (SQLite at $DATA_DIR/db/data.sqlite) |
| PORT | framework default | Service port (20128 in examples) |
| HOSTNAME | framework default | Bind host (Docker defaults to 0.0.0.0) |
| NODE_ENV | runtime default | Set production for deploy |
| BASE_URL | http://localhost:20128 | Server-side internal base URL used by cloud sync jobs |
| CLOUD_URL | https://9router.com | Server-side cloud sync endpoint base URL |
| NEXT_PUBLIC_BASE_URL | http://localhost:3000 | Backward-compatible/public base URL (prefer BASE_URL for server runtime) |
| NEXT_PUBLIC_CLOUD_URL | https://9router.com | Backward-compatible/public cloud URL (prefer CLOUD_URL for server runtime) |
| API_KEY_SECRET | endpoint-proxy-api-key-secret | HMAC secret for generated API keys |
| MACHINE_ID_SALT | endpoint-proxy-salt | Salt for stable machine ID hashing |
| ENABLE_REQUEST_LOGS | false | Enables request/response logs under logs/ |
| AUTH_COOKIE_SECURE | false | Force Secure auth cookie (set true behind HTTPS reverse proxy) |
| REQUIRE_API_KEY | false | Enforce Bearer API key on /v1/* routes (recommended for internet-exposed deploys) |
| HTTP_PROXY, HTTPS_PROXY, ALL_PROXY, NO_PROXY | empty | Optional outbound proxy for upstream provider calls |
| SEARXNG_URL | http://localhost:8888/search | Endpoint for the built-in unauthenticated SearXNG web-search provider |

Notes:

- Lowercase proxy variables are also supported: http_proxy, https_proxy, all_proxy, no_proxy.
- .env is not baked into Docker image (.dockerignore); inject runtime config with --env-file or -e.
- On Windows, APPDATA can be used for local storage path resolution.
- INSTANCE_NAME appears in older docs/env templates, but is currently not used at runtime.

Runtime Files and Storage

- Main app state: ${DATA_DIR}/db/data.sqlite (SQLite — providers, combos, aliases, keys, settings, usage history)
- Auto backups: ${DATA_DIR}/db/backups/
- Optional request/translator logs: <repo>/logs/... when ENABLE_REQUEST_LOGS=true
- Both ${DATA_DIR} and ~/.9router resolve to the same location in a Docker container — the symlink /root/.9router -> /app/data is created at build time.

</details>

---

📊 Available Models

<details>
<summary>View all available models</summary>

Claude Code (cc/) - Pro/Max:

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

Codex (cx/) - Plus/Pro:

- cx/gpt-5.5
- cx/gpt-5.4
- cx/gpt-5.3-codex
- cx/gpt-5.2-codex
- cx/gpt-5.1-codex-max

GitHub Copilot (gh/):

- gh/gpt-5.4
- gh/claude-opus-4.7
- gh/claude-sonnet-4.6
- gh/gemini-3.1-pro-preview
- gh/grok-code-fast-1

Cursor (cu/) - Subscription:

- cu/claude-4.6-opus-max
- cu/claude-4.5-sonnet-thinking
- cu/gpt-5.3-codex
- cu/kimi-k2.5

GLM (glm/) - $0.6/1M:

- glm/glm-5.1
- glm/glm-5
- glm/glm-4.7

MiniMax (minimax/) - $0.2/1M:

- minimax/MiniMax-M2.7
- minimax/MiniMax-M2.5

Kimi (kimi/) - $9/mo flat:

- kimi/kimi-k2.5
- kimi/kimi-k2.5-thinking

Kiro (kr/) - Free (~50 credits/month, paid tiers above):

- kr/claude-sonnet-4.5
- kr/claude-haiku-4.5
- kr/glm-5
- kr/MiniMax-M2.5
- kr/qwen3-coder-next
- kr/deepseek-3.2

OpenCode Free (oc/) - FREE no-auth:

- Auto-fetched from opencode.ai/zen/v1/models

Vertex AI (vertex/) - $300 free credits:

- vertex/gemini-3.1-pro-preview
- vertex/gemini-3-flash-preview
- vertex/gemini-2.5-flash
- vertex-partner/glm-5-maas
- vertex-partner/deepseek-v3.2-maas

</details>

---

🐛 Troubleshooting

"Language model did not provide messages"

- Provider quota exhausted → Check dashboard quota tracker
- Solution: Use combo fallback or switch to cheaper tier

Rate limiting

- Subscription quota out → Fallback to GLM/MiniMax
- Add combo: cc/claude-opus-4-7 → glm/glm-5.1 → kr/claude-sonnet-4.5

OAuth token expired

- Auto-refreshed by 9Router
- If issues persist: Dashboard → Provider → Reconnect

High costs

- Enable RTK in Dashboard → Endpoint settings (default ON, saves 20-40% tokens)
- Check usage stats in Dashboard
- Switch primary model to GLM/MiniMax
- Use free tier (Kiro, OpenCode Free, Vertex) for non-critical tasks

Dashboard opens on wrong port

- Set PORT=20128 and NEXT_PUBLIC_BASE_URL=http://localhost:20128

First login not working

- Check INITIAL_PASSWORD in .env
- If unset, fallback password is 123456

No request logs under logs/

- Set ENABLE_REQUEST_LOGS=true

---

🛠️ Tech Stack

- Runtime: Node.js 20+
- Framework: Next.js 16
- UI: React 19 + Tailwind CSS 4
- Database: SQLite (better-sqlite3 / node:sqlite / sql.js fallback)
- Streaming: Server-Sent Events (SSE)
- Auth: OAuth 2.0 (PKCE) + JWT + API Keys

---

📝 API Reference

Chat Completions

bash

POST http://localhost:20128/v1/chat/completions
Authorization: Bearer your-api-key
Content-Type: application/json{
  "model": "cc/claude-opus-4-6",
  "messages": [
    {"role": "user", "content": "Write a function to..."}
  ],
  "stream": true
}

List Models

bash

GET http://localhost:20128/v1/models Authorization: Bearer your-api-key

→ Returns all models + combos in OpenAI format

📧 Support

- Website: 9router.com
- GitHub: github.com/decolua/9router
- Issues: github.com/decolua/9router/issues

---

👥 Contributors

Thanks to all contributors who helped make 9Router better!

![Contributors](https://github.com/decolua/9router/graphs/contributors)

---

📊 Star Chart

![Star Chart](https://starchart.cc/decolua/9router)

🔀 Forks

OmniRoute — A full-featured TypeScript fork of 9Router. Adds 36+ providers, 4-tier auto-fallback, multi-modal APIs (images, embeddings, audio, TTS), circuit breaker, semantic cache, LLM evaluations, and a polished dashboard. 368+ unit tests. Available via npm and Docker.

---

🙏 Acknowledgments

Built on the shoulders of giants:

- CLIProxyAPI — original Go implementation that inspired this JavaScript port.
- RTK !Stars — Rust token-saver. 9Router ports its compression pipeline to JS → −20-40% input tokens on every request.
- Caveman !Stars by @JuliusBrussee — viral _"why use many token when few token do trick"_. 9Router adapts its prompt → −65% output tokens.
- Ponytail !Stars by @DietrichGebert — _"lazy senior dev"_ skill. 9Router injects its YAGNI-first ladder → fewer tokens, less code, shorter diffs.

Huge thanks to these authors — without their work, 9Router's token-saving features wouldn't exist. ⭐ them on GitHub!

---

📄 License

MIT License - see LICENSE for details.

---

<div align="center">
Built with ❤️ for developers who code 24/7
</div>

🤔 Why 9Router? Copy Chapter

🔄 How It Works Copy Chapter

⚡ Quick Start Copy Chapter

Video Guides Copy Chapter

🛠️ Supported CLI Tools Copy Chapter

🌐 Supported Providers Copy Chapter

🔐 OAuth Providers Copy Section

🆓 Free Providers Copy Section

🔑 API Key Providers (40+) Copy Section

🏠 Self-hosted Providers Copy Section

💡 Key Features Copy Chapter

🚀 RTK Token Saver Copy Section

🧠 Headroom Token Saver Copy Section

Headroom service in same Docker network

Headroom running on host machine

🐴 Ponytail (Lazy Senior Dev) Copy Section

🎯 Smart 3-Tier Fallback Copy Section

📊 Real-Time Quota Tracking Copy Section

🔄 Format Translation Copy Section

👥 Multi-Account Support Copy Section

🔄 Auto Token Refresh Copy Section

🎨 Custom Combos Copy Section

📝 Request Logging Copy Section

💾 Cloud Sync Copy Section

📊 Usage Analytics Copy Section

🌐 Deploy Anywhere Copy Section

💰 Pricing at a Glance Copy Chapter

📊 Understanding 9Router Costs & Billing Copy Section

🎯 Use Cases Copy Chapter

Case 1: "I have Claude Pro subscription" Copy Section

Case 2: "I want zero cost" Copy Section

Case 3: "I need 24/7 coding, no interruptions" Copy Section

Case 4: "I want FREE AI in OpenClaw" Copy Section

❓ Frequently Asked Questions Copy Chapter

📖 Setup Guide Copy Chapter

Claude Code (Pro/Max) Copy Section

OpenAI Codex (Plus/Pro) Copy Section

GitHub Copilot Copy Section

Cursor IDE Copy Section

GLM-5.1 / GLM-4.7 (Daily reset, $0.6/1M) Copy Section

MiniMax M2.7 (5h reset, $0.20/1M) Copy Section

Kimi K2.5 ($9/month flat) Copy Section

Kiro AI (Claude 4.5 + GLM-5 + MiniMax FREE) Copy Section

OpenCode Free (No auth, auto-fetch models) Copy Section

Vertex AI ($300 free credits for new GCP accounts) Copy Section

Example 1: Maximize Subscription → Cheap Backup Copy Section

Example 2: Free-Only (Zero Cost) Copy Section

Cursor IDE Copy Section

Claude Code Copy Section

Codex CLI Copy Section

OpenClaw Copy Section

Cline / Continue / RooCode Copy Section

VPS Deployment Copy Section

Clone and install

Configure

Start

Or use PM2

Docker Copy Section

Environment Variables Copy Section

Runtime Files and Storage Copy Section

📊 Available Models Copy Chapter

🐛 Troubleshooting Copy Chapter

🛠️ Tech Stack Copy Chapter

📝 API Reference Copy Chapter

Chat Completions Copy Section

List Models Copy Section

📧 Support Copy Chapter

👥 Contributors Copy Chapter

📊 Star Chart Copy Chapter

🔀 Forks Copy Chapter

🙏 Acknowledgments Copy Chapter

📄 License Copy Chapter

🤔 Why 9Router?

🔄 How It Works

⚡ Quick Start

Video Guides

🛠️ Supported CLI Tools

🌐 Supported Providers

🔐 OAuth Providers

🆓 Free Providers

🔑 API Key Providers (40+)

🏠 Self-hosted Providers

💡 Key Features

🚀 RTK Token Saver

🧠 Headroom Token Saver

🐴 Ponytail (Lazy Senior Dev)

🎯 Smart 3-Tier Fallback

📊 Real-Time Quota Tracking

🔄 Format Translation

👥 Multi-Account Support

🔄 Auto Token Refresh

🎨 Custom Combos

📝 Request Logging

💾 Cloud Sync

📊 Usage Analytics

🌐 Deploy Anywhere

💰 Pricing at a Glance

📊 Understanding 9Router Costs & Billing

🎯 Use Cases

Case 1: "I have Claude Pro subscription"

Case 2: "I want zero cost"

Case 3: "I need 24/7 coding, no interruptions"

Case 4: "I want FREE AI in OpenClaw"

❓ Frequently Asked Questions

📖 Setup Guide

Claude Code (Pro/Max)

OpenAI Codex (Plus/Pro)

GitHub Copilot

Cursor IDE

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

MiniMax M2.7 (5h reset, $0.20/1M)

Kimi K2.5 ($9/month flat)

Kiro AI (Claude 4.5 + GLM-5 + MiniMax FREE)

OpenCode Free (No auth, auto-fetch models)

Vertex AI ($300 free credits for new GCP accounts)

Example 1: Maximize Subscription → Cheap Backup

Example 2: Free-Only (Zero Cost)

Cursor IDE

Claude Code

Codex CLI

OpenClaw

Cline / Continue / RooCode

VPS Deployment

Docker

Environment Variables

Runtime Files and Storage

📊 Available Models

🐛 Troubleshooting

🛠️ Tech Stack

📝 API Reference

Chat Completions

List Models

📧 Support

👥 Contributors

📊 Star Chart

🔀 Forks

🙏 Acknowledgments

📄 License