@GitTrend0x: AI 网关天花板! 一个端点接 268+ 提供商、500+ 模型,Cursor/Claude Code 直接用 用 AI coding 时最烦的几个问题: • 模型太多,切换麻烦 • 免费额度分散,经常超限 • Token 吃得太凶,成本…

X AI KOLs Timeline 工具

摘要

OmniRoute is a free, open-source AI gateway that unifies access to 268+ providers and 500+ models through a single local endpoint, featuring smart routing, token compression, and free tier aggregation to reduce costs and complexity for developers.

AI 网关天花板! 一个端点接 268+ 提供商、500+ 模型,Cursor/Claude Code 直接用 用 AI coding 时最烦的几个问题: • 模型太多,切换麻烦 • 免费额度分散,经常超限 • Token 吃得太凶,成本高 • Agent 想自主调用模型却很难 OmniRoute 把这些问题一次性干掉了。它是一个免费开源的 AI 网关,通过一个本地端点(http://localhost:20128/v1),就能访问 268+ 提供商、500+ 模型(包括 Claude、GPT、Gemini、Kimi K3、GLM、DeepSeek 等)。支持 Claude Code、Cursor、Codex、Cline、Copilot 等主流 AI coding 工具。 // 核心黑科技: • 智能路由 + 自动 fallback:18 种路由策略(优先级、加权、成本最优、融合等),配额感知,模型挂了自动切下一个 • RTK + Caveman 压缩:可叠加 11 种压缩引擎,节省 15-95% tokens,代码/JSON 几乎无损 • MCP/A2A 支持:AI Agent 可以直接控制网关,实现真正的自主调用 • 免费额度聚合:把散落在各家的免费额度集中管理,据称每月可省下巨量成本 • 本地优先:完全自托管,支持 Desktop/PWA/Termux,隐私安全 • 开箱即用:npm 一键安装,Dashboard 可视化配置,支持 43 种语言(含中文) // 简单来说:把“模型碎片化”变成“统一智能入口”,让开发者真正实现 “Never stop coding”。目前已获 22k stars,由 500+ 贡献者共同打造,社区非常活跃。 GitHub:https://github.com/diegosouzapw/OmniRoute… 去 star 一下,装上后把你的 Cursor 或 Claude Code 指向这个端点,model 填 auto,立刻感受丝滑体验。
查看原文
查看缓存全文

缓存时间: 2026/07/21 08:38

AI 网关天花板!

一个端点接 268+ 提供商、500+ 模型,Cursor/Claude Code 直接用

用 AI coding 时最烦的几个问题: • 模型太多,切换麻烦 • 免费额度分散,经常超限 • Token 吃得太凶,成本高 • Agent 想自主调用模型却很难

OmniRoute 把这些问题一次性干掉了。它是一个免费开源的 AI 网关,通过一个本地端点(http://localhost:20128/v1),就能访问 268+ 提供商、500+ 模型(包括 Claude、GPT、Gemini、Kimi K3、GLM、DeepSeek 等)。支持 Claude Code、Cursor、Codex、Cline、Copilot 等主流 AI coding 工具。

//

核心黑科技:

• 智能路由 + 自动 fallback:18 种路由策略(优先级、加权、成本最优、融合等),配额感知,模型挂了自动切下一个 • RTK + Caveman 压缩:可叠加 11 种压缩引擎,节省 15-95% tokens,代码/JSON 几乎无损 • MCP/A2A 支持:AI Agent 可以直接控制网关,实现真正的自主调用 • 免费额度聚合:把散落在各家的免费额度集中管理,据称每月可省下巨量成本 • 本地优先:完全自托管,支持 Desktop/PWA/Termux,隐私安全 • 开箱即用:npm 一键安装,Dashboard 可视化配置,支持 43 种语言(含中文)

//

简单来说:把“模型碎片化”变成“统一智能入口”,让开发者真正实现 “Never stop coding”。目前已获 22k stars,由 500+ 贡献者共同打造,社区非常活跃。

GitHub:https://github.com/diegosouzapw/OmniRoute…

去 star 一下,装上后把你的 Cursor 或 Claude Code 指向这个端点,model 填 auto,立刻感受丝滑体验。


diegosouzapw/OmniRoute

Source: https://github.com/diegosouzapw/OmniRoute

OmniRoute Dashboard

🚀 OmniRoute — The Free AI Gateway

OmniRoute — Never stop coding. Every AI tool → 271 providers — 90+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 271 AI providers · 90+ free tiers · ~1.4B free tokens/mo · 18 routing strategies · $0 to start.

💰 ~1.4B Free Tokens / Month

Stacking free tiers by hand is painful — dozens of SDKs, dozens of rate limits, and no idea how much you actually have. OmniRoute aggregates the documented free tiers of 39 provider pools / 460+ models into one honest number and shows it live on the dashboard (/dashboard/free-tiers).

OmniRoute free-tier budget card: ~1.4B free tokens per month steady, up to ~2.0B in the first month with signup credits, from the documented free tiers of 39 provider pools / 460+ models behind one endpoint. Honest pool-deduped math — each shared pool counted once (counting every rate limit 24/7 would read ~10B; not published), 15 providers ToS-flagged so you decide. Budget bar of the 19 countable free pools with per-model grid (Mistral Large 3 1B, GPT-4o mini 150M, Gemini 2.5 Flash 60M … Claude Sonnet 4.5 25K), ~626M one-time first-month signup credits (vertex 300M, agentrouter 200M, predibase 25M, together 25M, glm-cn 20M, doubao 15M, ai21 10M, longcat 10M, deepseek 5M, hyperbolic 5M, nscale 5M), plus permanently-free no-token-cap providers (SiliconFlow, Z.AI GLM-Flash, Kilo, OpenCode Zen, baidu …) and a $10 OpenRouter top-up unlocking +24M/mo — surfaced separately so they never inflate the headline. Live used/remaining on /dashboard/free-tiers.

Animated summary of the live /dashboard/free-tiers page. Full methodology (pool dedupe, credit tiers, provider terms): docs/reference/FREE_TIERS.md.

These figures are re-audited every two weeks against the live catalog and move both ways — a provider ends a free tier and the number drops; a new one lands and it climbs. We publish what the catalog actually computes, never a rounded-up best case. A CI gate (check:docs-counts) fails the build if this headline drifts from the code.

⭐ Star the repo if OMNIROUTE helped you save money and make your work easier.

Stars diegosouzapw%2FOmniRoute | Trendshift Star History Rank


💬 Join the community

Discord Telegram WhatsApp Global WhatsApp Brasil Website

Questions, provider tips, roadmap & support → Discord · Telegram · WhatsApp 🌍 Global / 🇧🇷 Brasil


🧩 Available

npm version NPM Monthly Docker Hub License: MIT Docker Pulls Electron Downloads

🚀 Quick Start🎯 Combos🌐 Providers🔌 CLI & MCP🗜️ Compression🌍 Website

💥 The Promise🤔 Why🏆 What Sets Apart🤖 Compatible CLIs🖥️ Where It Runs🔒 Private🎬 In Action📸 Screenshots📧 Support

🌐 In 43 languages
🇺🇸 🇧🇷 🇵🇹 🇪🇸 🇫🇷 🇮🇹 🇩🇪 🇳🇱 🇷🇺 🇺🇦 🇵🇱 🇨🇿 🇸🇰 🇷🇴 🇭🇺
🇧🇬 🇩🇰 🇫🇮 🇳🇴 🇸🇪 🇨🇳 🇹🇼 🇯🇵 🇰🇷 🇹🇭 🇻🇳 🇮🇩 🇲🇾 🇵🇭
🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇮🇳 🇧🇩 🇵🇰 🇮🇷 🇸🇦 🇮🇱 🇹🇷 🇦🇿 🇹🇿

💥 The Promise

The Promise — One endpoint. 271 providers. Never stop building — OmniRoute picks the cheapest one that works. Six pillars: Never hit limits (auto-fallback across 271 providers in milliseconds, zero downtime) · Save up to 95% tokens (RTK + Caveman stacked compression cuts 15–95%, ~89% avg on tool-heavy sessions) · $0 to start (90+ free tiers, 40+ free forever — no card needed) · Every tool works (26 coding agents through one config) · One endpoint (OpenAI ↔ Claude ↔ Gemini ↔ Responses API at /v1) · Production-grade (circuit breakers, TLS stealth, MCP 104 tools, A2A, memory, guardrails, evals — 25,000+ tests).

🤔 Why OmniRoute?

Why OmniRoute — stop juggling 10 dashboards, dead API keys and surprise bills. Ten daily pains vs fixes: quota expiring unused → maximize subscriptions; rate limits mid-coding → 4-tier auto-fallback (Subscription → API → Cheap → Free); tool outputs burning tokens → RTK + Caveman compression (15–95%); expensive APIs → cost-optimized routing; every tool its own setup → one endpoint, one dashboard; AI blocked → 3-level proxy + TLS stealth; dead keys → 3-layer resilience (circuit breakers, key cooldown, model lockout); team sharing one subscription → key pools with fair-share quotas; prompts through someone's cloud → local-first with AES-256-GCM encrypted keys; no spend visibility → live analytics (usage, quota, savings, p95 latency).
OmniRoute request flow: your IDE or CLI (Claude Code, Cursor, Cline…) calls one local endpoint (http://localhost:20128/v1); the OmniRoute Smart Router (RTK + Caveman compression, 18 routing strategies, circuit breakers, TLS stealth, MCP, A2A, guardrails) auto-falls back across 4 provider tiers — Tier 1 Subscription (Claude Code, Codex, Copilot), quota out? Tier 2 API Key (DeepSeek, Groq, xAI), budget hit? Tier 3 Cheap (GLM $0.5, MiniMax $0.2), budget hit? Tier 4 Free (Kiro, Qoder, Pollinations) — always on.

🎯 Combos — The Flagship

A combo is a chain of models OmniRoute routes across automatically. Quota runs out, a provider fails, or costs spike — the combo silently slides to the next model. This is what makes OmniRoute unbreakable. 🛡️

⚡ Zero-config — just use auto

No combo to create. Set your model to auto (or a variant) and OmniRoute builds a virtual combo from your connected providers, scored live:

Model IDWhat it optimizes for                                                                                                                                                                 
auto🎯 Balanced default (LKGP — sticks to your last good provider)
auto/coding🧑‍💻 Quality-first weights for code generation
auto/fast⚡ Lowest latency first
auto/cheap💰 Cheapest per token first
auto/offline🔋 Most quota / rate-limit headroom first
auto/smart🔭 Quality-first + 10% exploration to discover better models

🔀 Or build your own — 18 routing strategies

All 18 strategies — mix & match per combo step:

#StrategyWhat it does                                                                                                                                                            
1priorityFirst-target ordered list — drain each before the next 🥇
2fill-firstFill each target’s quota fully before moving on
3weightedWeighted random by per-target weight
4round-robinCycle through targets in order
5p2cPower-of-two-choices random load balancing
6least-usedPick the target with the lowest current load
7randomUniform random pick (deduplicated)
8strict-randomRandom without de-duplicating repeats 🎲
9cost-optimizedMinimize $ per request from live catalog pricing 💸
10headroomPick the target with the most remaining quota
11reset-windowPrefer the target whose quota window resets soonest
12reset-awareRank by quota reset time — short windows first 📊
13context-relayHand off context across targets for long conversations 🧠
14context-optimizedPick the best fit for the current context size
15lkgpLast-Known-Good Path — sticky to the last successful target
16auto12-factor live scoring across every connection 🤖
17fusionFan out to a panel of models + a judge synthesizes one answer 🧬
18pipelineChain steps — each target’s output feeds the next one 🔗
All 18 combo routing strategies animated, one tile per strategy showing the flow it executes: priority (drain the 1st, then the next), fill-first (fill a target's quota, then move on), weighted (weighted random), round-robin (cycle in order), p2c (pick 2, take the lighter), least-used (lowest load wins), random (uniform, deduped), strict-random (repeats allowed), cost-optimized (cheapest $ per request), headroom (most remaining quota), reset-window (resets soonest → use it), reset-aware (rank by reset, short first), context-relay (hand off long context), context-optimized (fit the context size), lkgp (sticky to last success), auto (live 12-factor scoring), fusion (panel + judge → one answer), pipeline (each output feeds the next).

The Auto-Combo engine scores every candidate on 12 factors (health, quota, cost, latency, success rate, freshness…) — see docs/routing/AUTO-COMBO.md.

⚖️ Quota-Share — split one subscription across a team ✨ NEW

Running several keys against the same upstream account (one Codex Pro plan, one Kimi key, one GLM Coding seat)? A burst on one key can burn the whole 5-hour / hourly quota and lock everyone else out. Quota-Share distributes a provider’s time-based quota fairly across the keys in a pool — and it’s work-conserving, so an idle member’s slice is lent out instead of wasted.

KnobWhat it controls                                                                                                                                                             
⚖️ Allocation weighteach key’s slice of the pool — e.g. 50 / 30 / 20
📐 Dimensionstrack % · requests · tokens · $, per 5h / 7d / per-model window
🚦 Policyhard (block over share) · soft (deprioritize) · burst (use idle headroom)
🧱 Capabsolute ceiling per key, independent of mode
OmniRoute key pool 'team-codex': one Codex Pro account shared by 3 keys over a 5-hour window. alice weight 50 (up to 50% of the shared 5h quota), bob weight 30, ci-bot weight 20. In generous mode (under 50% pool used) idle shares are lent out; once the pool crosses 50% strict mode holds each key to its fair share.

Enforced in the hot path before the request leaves OmniRoute, with per-(key, model) caps + session stickiness for prompt-cache integrity (now with a per-combo / global disable toggle). 📖 Quota Sharing Engine

🧱 Resilience is built in (3 independent layers)

OmniRoute resilience — 3 independent self-healing layers, the right layer for the right failure. Layer 1 provider circuit breaker (whole provider): trips only on 408/5xx, thresholds OAuth 3× / API-key 5× / local 2×, resets 60s/30s/15s into a HALF-OPEN probe, lazy recovery; while OPEN the combo reroutes to the next provider. Layer 2 connection cooldown (one key/account): base 5s OAuth / 3s API-key, exponential ×2 backoff with anti-thundering-herd guard, 429 honors Retry-After, success clears all error state; one cooling key is skipped while sibling keys keep serving. Layer 3 model lockout (one model): per-model 429, local 404 or mode denials lock just that model — never the whole connection. Terminal states (banned, expired, credits exhausted) are for the operator, not cooldowns.

📖 Auto-Combo Engine · Resilience Guide


🏆 What Sets OmniRoute Apart

FeatureOmniRouteOther routers
🌐 Providers27120–100
🆓 Free providers90+ (40+ free forever)1–5
🔀 Routing strategies18 (priority, weighted, cost-optimized, context-relay, fusion…)1–3
🗜️ Token compressionRTK + Caveman stacked (15–95%)None / 20–40%
🧰 Built-in MCP server104 tools, 3 transports, 31 scopesRare
🤝 A2A agent protocol6 skills, JSON-RPC 2.0None
🧠 Memory (FTS5 + vector)YesRare
🛡️ Guardrails (PII, injection, vision)YesRare
☁️ Cloud agentsCodex, Cursor, Devin, JulesNone
🥷 TLS fingerprint stealthJA3/JA4 via wreq-jsNone
🖥️ Multi-platformWeb · Desktop · Termux · PWAWeb only
🌍 i18n43 locales0–4

📊 Detailed comparison vs LiteLLM, OpenRouter & Portkey → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md


✨ What’s New

Recent highlights from v3.8.20 → v3.8.49. Full history in CHANGELOG.md.

  • 🗜️ Compression hardening — default-on inflation guard, Caveman packs for DE / FR / JA + Chinese (wényán), RTK filters for Gradle & .NET. → Compression
  • 💸 Honest flat-rate cost — subscription / coding-plan providers read $0 in cost analytics; budget, quota & routing keep estimating. → API Reference
  • ⚖️ Quota-Share routing — split load across accounts by available quota: DRR scheduling, per-connection concurrency, multi-window buckets, session stickiness. → Resilience Guide
  • 🤖 One-command CLI/agent setupsetup-* configures 12+ coding tools; omniroute launch / launch-codex are zero-config. → CLI Integrations
  • 🛰️ Remote mode — drive a remote OmniRoute with scoped tokens (connect / contexts / tokens) + an antigravity OAuth helper for VPS installs. → Remote Mode
  • 🧭 Smarter auto-routingauto/<category>:<tier> combos, Fusion (model panel + judge), task-aware routing, per-request model / mode / USD-budget overrides. → Auto-Combo
  • 🗜️ Pluggable compression — 11 composable engines + Compression Studios: LLMLingua-2, two-tier Ultra, omniglyph, per-step fidelity gate, GCF v3.2, drag-reorder editor. → Compression
  • 🕵️ Transparent MITM decrypt (TPROXY) — capture CLIs that ignore proxy env vars, with a per-SNI CA + trust-store installer. → MITM/TPROXY
  • 💸 Cost telemetry everywhereX-OmniRoute-* cost/usage headers on every endpoint, cache-HIT savings header, per-key USD spend quotas. → API Reference
  • 🧠 Memory you control — off by default, opt-in int8 vector quantization + typed decay, per-request x-omniroute-no-memory. → Memory
  • 🛡️ Security — prompt-injection guard on every LLM route (red-team suite) + free DuckDuckGo last-resort web search. → Guardrails
  • 🖼️ New endpoints/v1/ocr (Mistral OCR) and /v1/audio/translations (Whisper-style) round out the media surface. → API Reference
  • 🌍 Deployment & ops — reverse-proxy basePath, browser-language auto-detect, per-key device tracking, root-less MITM trust, zh-TW localization. → Environment
  • 🤝 More providers & agents — Cursor Cloud Agent, Grok Build (xAI), Ollama first-class card, Claude Sonnet 5, Zed, Requesty, SenseNova, Yuanbao… and a refreshed 250-provider catalog. → Providers
  • ⚡ Local performance & infra — one-click local Redis, Cloudflare Workers / Deno Deploy relay deployers, Bifrost & Mux as supervised embedded services. → Embedded Services

🤖 Compatible CLIs & Coding Agents

One config — http://localhost:20128/v1 — and every AI IDE or CLI runs on free & low-cost models.

Claude Code
Claude Code
                           
Codex CLI
Codex CLI
                           
Cline
Cline
                           
Kilo Code
Kilo Code
                           
Roo CodeRoo Code
Roo Code
                           
Continue
Continue
                           
Aider
Aider
                           
ForgeCode
ForgeCode
                           
jcode
jcode
                           
DeepSeek TUI
DeepSeek TUI
                           
CodeWhale
CodeWhale
                           
OpenCode
OpenCode
                           
Factory Droid
Factory Droid
                           
GitHub Copilot CLI
Copilot CLI
                           
Cursor CLI
Cursor CLI
                           
Smelt
Smelt
                           
Pi (pi-coding-agent)
Pi
                           
Grok Build (xAI)
Grok Build
                           
Hermes Agent (Nous Research)
Hermes Agent
                           
OpenClaw
OpenClaw
                           
Goose
Goose
                           
Open Interpreter
Open Interpreter
                           
Warp AI
Warp AI
                           
Agent Deck
Agent Deck
                           
+ also works with · Kiro · Command Code · Antigravity · Windsurf · AMP · any OpenAI-compatible tool

📖 Per-tool setup for all 33 tools (25 CLI Code’s + 8 CLI Agents) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode plugin → @omniroute/opencode-provider


🌐 271 AI Providers — 90+ Free

The most complete catalog of any open-source router: 271 providers, 90+ with a free tier, 40+ free forever.

🏢 Every major lab — through one endpoint

OpenAI
OpenAI
                           
Anthropic
Anthropic
                           
Gemini
Gemini
                           
xAI Grok
xAI Grok
                           
DeepSeek
DeepSeek
                           
Mistral
Mistral
                           
Qwen
Qwen
                           
Meta Llama
Meta Llama
                           
Groq
Groq
                           
NVIDIA
NVIDIA
                           
MiniMax
MiniMax
                           
Cohere
Cohere
                           
Perplexity
Perplexity
                           
Hugging Face
HuggingFace
                           
Together
Together
                           
Fireworks
Fireworks
                           
Cloudflare
Cloudflare
                           
Baidu
Baidu
                           

…and 220+ more — every icon resolves live from the dashboard’s provider catalog. 📖 Provider Reference


🆓 Free Forever — $0, no card

AgentRouter
AgentRouter
GPT-5, Claude, Gemini
$100 free credits

                                     
Qoder AI
Qoder AI
Kimi-K2, DeepSeek-R1
Unlimited FREE

                                     
Pollinations
Pollinations
GPT-5, Claude, Llama 4
No key needed

                                     
LongCat
LongCat
LongCat-2.0
10M tokens one-time (KYC) 🔑

                                     
Cloudflare AI
Cloudflare AI
50+ models
10K neurons/day

                                     
NVIDIA NIM
NVIDIA NIM
129 models
~40 RPM free

                                     
Cerebras
Cerebras
Qwen3 235B
1M tokens/day

                                     

📖 Full machine-readable catalog → docs/reference/PROVIDER_REFERENCE.md


🖥️ Where OmniRoute Runs — Anywhere

Same app, your machine, your rules. From a global npm install to your phone via Termux.

PlatformInstallHighlights
📦 npm (global)npm install -g omnirouteOne command, any OS
🐳 Dockerdocker run … diegosouzapw/omnirouteMulti-arch AMD64 + ARM64
🖥️ Desktop (Electron)npm run electron:buildNative window + system tray — Windows / macOS / Linux
💪 ARMnative arm64Raspberry Pi, ARM servers, Apple Silicon
📱 Android (Termux)pkg install nodejs && npx -y omnirouteRuns on your phone, 24/7, no root
📲 PWA“Add to Home Screen”Fullscreen, offline, installable from browser
🧩 OpenCode plugin@omniroute/opencode-providerNative OpenCode integration
🛠️ From sourcenpm install && npm run devHack on it, contribute

📖 Docker Guide · Desktop · Termux · PWA · OpenCode


🔒 Private & Local-First

Private and local-first — your keys, your machine, your data; OmniRoute is a local proxy that never phones home. Eleven guarantees: runs 100% on your hardware (0 cloud hops), zero telemetry by default, credentials encrypted at rest (AES-256-GCM), no account or sign-up, hardened gateway (API-key scoping, IP filtering, rate limits, prompt-injection guard), loopback-only process routes, upstream header scrubbing, strictly opt-in PII redaction, sanitized errors that never leak internals, a local audit trail in your own SQLite, and MIT-licensed fully open-source code.

📖 Authorization · Guardrails · Compliance


🔌 Full CLI + A2A & MCP

OmniRoute isn’t just a server — it’s a full command-line cockpit with 80+ commands, plus open agent protocols so an AI agent can drive OmniRoute by itself.

⌨️ A real CLI (not just start)

omniroute               # serve gateway + dashboard (port 20128)
omniroute chat          # interactive TUI chat client (slash: /model /combo /skill /memory)
omniroute setup         # guided first-run wizard
omniroute doctor        # diagnose providers, ports, native deps

🛰️ Remote mode — run the CLI here, OmniRoute on a VPS

OmniRoute on a server? Drive it from your laptop with the same CLI. Log in once with a scoped access token; every command then targets the remote.

omniroute connect 192.168.0.15            # password → scoped token, saved as a context
omniroute models list                     # ← runs against the REMOTE server
omniroute configure codex                 # ← picks a remote model, writes a local Codex profile
omniroute tokens create --name ci --scope read   # mint narrower tokens for other machines
omniroute contexts use default            # ← switch back to the local server

Tokens are scoped read / write / admin; process-spawning routes stay loopback-only. 📖 Remote Mode

Animated terminal demoing the OmniRoute CLI — omniroute providers list, omniroute combo list, omniroute health — cycling over the 80+ command surface: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

🤝 Connect an agent — and it controls OmniRoute itself

Expose OmniRoute over MCP or A2A and any capable agent gets the keys to the whole gateway — routing, providers, combos, cache, compression, memory — autonomously.

ProtocolEndpointUse it for
🧰 MCP (stdio)omniroute --mcpPlug into Claude Desktop, Cursor, any MCP client
🌊 MCP (HTTP)http://localhost:20128/api/mcp/streamRemote MCP — 104 tools, 31 scopes, full audit trail
📡 MCP (SSE)http://localhost:20128/api/mcp/sseStreaming MCP transport
🤝 A2Ahttp://localhost:20128/.well-known/agent.jsonAgent-to-agent, JSON-RPC 2.0 + SSE, 6 skills
# Give Claude Code the full OmniRoute toolset over MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

📖 MCP Server · A2A Server · Agent Protocols


🗜️ Save 15–95% Tokens — Automatically

Why use many tokens when few tokens do the trick? Every request passes through OmniRoute’s compression pipeline transparently — no client changes. It’s now a stack of 11 composable engines that run in order and mix & match per routing combo — building on ideas from RTK, Caveman (⭐ 90K+), LLMLingua-2, and Troglodita (PT-BR).

🧱 The 11-engine stack

Engines run in pipeline order; each is independently toggleable and configurable per combo:

#EngineWhat it does
1Session-DedupDrops content repeated across turns (content-addressed, cross-turn)
2CCRArchives large blocks behind retrieve markers, fetched on demand
3RTKSmart tool-result filtering, dedup & truncation (command-aware)
4HeadroomLossless tabular compaction of homogeneous JSON arrays, flat or nested (~30%), via a vendored GCF codec (spec v3.2)
5RelevanceExtractive sentence scoring against the last user query
6CavemanRule-based prose compression (~65–75% on output)
7LLMLingua-2ML semantic pruning via MobileBERT ONNX — code-safe, async
8LiteWhitespace + image-URL trimming (latency-light baseline)
9AggressiveSummarization + progressive aging of old turns
10UltraHeuristic token pruning with an optional small-model (SLM) tier

Code blocks, URLs and structured data are always preserved byte-perfect. One-click presets combine the engines:

ModeSavingsBest for                                                                                                                                       
🪶 Lite~15%Always-on safe default
🪨 Standard (Caveman)~30%Daily coding
Aggressive~50%Long tool-heavy sessions
🔥 Ultra~75%Maximum savings
🧰 RTK60–90%Shell/test/build/git output
🔗 Stacked (RTK → Caveman)78–95%Mixed prompts + tool logs

Real example — Standard mode:

Before (69 tokens): “The reason your React component is re-rendering is likely because you’re creating a new object reference on each render cycle. When you pass an inline object as a prop, React’s shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object.”

After (19 tokens): “New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo.”

Same answer. 72% fewer tokens. Zero accuracy loss.

PT-BR example — Troglodita mode:

Antes (42 tokens): “O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo.”

Depois (12 tokens): “Re-render: ref nova cada ciclo (objeto inline recriado). Usar useMemo.”

Mesma resposta. ~70% menos tokens. Precisão técnica intacta.


📖 How it works — pipeline, architecture & savings math

OmniRoute compression pipeline: a client request of 10,000 tokens passes through 11 stacked engines — Session-Dedup, CCR, RTK, Headroom, Relevance, Caveman, LLMLingua-2, Omniglyph, Lite, Aggressive, Ultra — and reaches the provider at about 1,080 tokens, up to 95% saved. Code, URLs and JSON are always preserved byte-perfect.

Default stacked combo runs RTK → Caveman. When both act on the same tool/context payload, savings compound:

combined = 1 − (1 − RTK) × (1 − Caveman_input)
average  = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range    = 78.4 – 94.6%

Code blocks, URLs, JSON and structured data are always protected by the preservation engine.

🎚️ Beyond the engines — output styles, the adaptive dial & per-request control

The 10 engines above shrink what goes in. Three more layers shape how, when, and what comes out:

  • 🪄 Output Styles (output-axis steering) — inject deterministic, cache-safe response-shaping instructions; combinable, each at lite / full / ultra intensity. Adding a style is a one-line registry entry:
    • Terse prose — drop filler / articles / hedging; keep technical substance exact.
    • Less code — “lazy senior dev” YAGNI: smallest working change, no unrequested scaffolding.
    • Terse CJK (文言) — classical-Chinese ultra-terse style (locale-gated to zh).
  • 🎯 Adaptive context-budget (the dial) — instead of one on/off token threshold, escalate the cheapest, most-lossless engines only as far as needed to fit the model’s context window. Policy: reserve-output (default, model-aware) · percentage · absolute. Mode: floor (guarantee fit) · replace-autotrigger (your explicit choice wins) · off (legacy threshold).
  • 🎛️ Where compression is decided (precedence, high → low) — per-request x-omniroute-compression header › routing-combo override › active named profile › adaptive / auto-trigger › panel default › off. The applied plan echoes back in the X-OmniRoute-Compression: <mode>; source=<source> response header.

Auto-trigger by token threshold, flip on the adaptive dial, pin a named profile, set a one-off per request, or assign a pipeline per routing combo — whichever fits the workload. An opt-in offline eval harness (npm run eval:compression) scores fidelity vs. savings on a pinned corpus before you promote a change.

📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md


⚡ Quick Start

1) Install & run

npm install -g omniroute
omniroute

Dashboard at http://localhost:20128 · API at http://localhost:20128/v1.

2) Connect a FREE provider (no signup)

Dashboard → Providers → connect Kiro AI (free Claude, ~50 credits/month per account) or OpenCode Free (no auth) → done.

3) Point your coding tool

Base URL: http://localhost:20128/v1
API Key:  [copy from Dashboard → Endpoints]
Model:    auto            (zero-config smart routing — or any provider/model)

4) Verify it’s working

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

You should see your connected models listed. 🎉 That’s it — start coding, and OmniRoute auto-routes & falls back for you.

If your client cannot send custom headers, OmniRoute also exposes tokenized compatibility aliases:

OpenAI catalog:   http://localhost:20128/vscode/YOUR_KEY/
OpenAI models:    http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat:      http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat:      http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags:      http://localhost:20128/vscode/YOUR_KEY/api/tags

Use these only for clients that cannot attach Authorization: Bearer .... Header auth remains the preferred mode.


📦 More install methods — Docker, source, pnpm, Arch

🐳 Docker

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
  -p 20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

🛠️ From source

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# Using Nix flakes
nix develop
npm run dev

# Or using devbox
devbox run npm run dev

📖 Docker Guide — Compose profiles, Caddy HTTPS, Cloudflare tunnels.

🦭 Podman

# 1. Build the image
podman build --target runner-base -t omniroute:base .

# 2. Fix data directory permissions for rootless Podman
mkdir -p data && podman unshare chown 1000:1000 ./data

# 3. Set runtime in .env, then run (see contrib/podman/ for Quadlet)
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d

📖 Podman Guide — Quadlet setup, podman-compose, Quadlet.

⚡ Faster / leaner install (skip the native build)

The native SQLite engine (better-sqlite3) is an optional dependency, so a global install never blocks on compiling from source: it uses a prebuilt binary when one matches your platform/Node, and otherwise falls back transparently to a pure-JS engine (node:sqlite on Node 22+, else the bundled sql.js WASM) — no build tools required.

To skip the post-install native warm-up entirely (CI, headless, or slow machines):

OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute   # CI=1 also skips it

For the fastest installs prefer pnpm (content-addressed store + hard links — see above). For a dashboard-free, headless runtime use the Docker base profile (above) or the Termux guide. The CLI and the web dashboard are served by the same process on one port, so there is no separate CLI-only package today.


🎬 OmniRoute in Action

Guia em Português
🇧🇷 Português
Guia completo
English Guide
🇺🇸 English
Complete walkthrough
Руководство
🇷🇺 Русский
Полное руководство

🎬 Made a video about OmniRoute? Open an issue or discussion with the link — we’ll feature it here.


📸 Dashboard Screenshots

PageScreenshotPageScreenshot
ProvidersProvidersCombosCombos
AnalyticsAnalyticsHealthHealth
TranslatorTranslatorSettingsSettings
CLI ToolsCLI ToolsUsage LogsUsage

📧 Support & Community

💬 Chat with the community — Discord, Telegram & WhatsApp (🌍 / 🇧🇷) links are at the top of this README.



🛠️ Tech Stack

  • Runtime: Node.js 22.x or 24.x LTS (24 LTS recommended) — >=22.22.2 <23 || >=24.0.0 <27
  • Language: TypeScript 6.0 — 100% TypeScript across src/ and open-sse/ (zero any in core modules since v2.0)
  • Framework: Next.js 16 + React 19 + Tailwind CSS 4
  • Database: better-sqlite3 (SQLite) + LowDB (JSON legacy) — domain state, proxy logs, MCP audit, routing decisions, memory, skills
  • Schemas: Zod (MCP tool I/O validation, API contracts)
  • Protocols: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
  • Streaming: Server-Sent Events (SSE) + WebSocket bridge (/v1/ws)
  • Auth: OAuth 2.0 (PKCE) + JWT + API Keys + MCP Scoped Authorization
  • Testing: Node.js test runner + Vitest (25,000+ test cases across 3,300+ files — unit, integration, E2E, security, ecosystem)
  • Platforms: Desktop (Electron), Android (Termux), PWA (any browser)
  • CI/CD: GitHub Actions (auto npm publish + Docker Hub on release)
  • Website: omniroute.online
  • Package: npmjs.com/package/omniroute
  • Docker: hub.docker.com/r/diegosouzapw/omniroute
  • Resilience: Circuit breaker, exponential backoff, anti-thundering herd, TLS spoofing, auto-combo self-healing

📖 Documentation

📘 Getting Started

DocumentDescription                                                                                                                                                                         
User GuideProviders, combos, CLI integration, deployment
Setup GuideFull install methods, CLI tool configs, protocol setup, timeout tuning
CLI Tools GuidePer-tool setup for Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Remote ModeDrive a remote OmniRoute (VPS) from your laptop CLI via scoped access tokens
Claude Code ConfigPoint Claude Code at OmniRoute (local/remote) with launch + per-model profiles
Quick Start3-step install → connect → configure

🔧 Operations & Deployment

DocumentDescription                                                                                                                                                                        
Docker GuideDocker run, Compose profiles, Caddy HTTPS, tunnels, image tags
Podman GuideQuadlet systemd integration, podman-compose, SELinux
VM DeploymentComplete guide: VM + nginx + Cloudflare setup
Fly.io DeploymentDeploy to Fly.io with persistent storage
Termux GuideRun OmniRoute on Android via Termux
PWA GuideProgressive Web App install, caching, architecture
Uninstall GuideClean removal for all install methods
Environment ConfigComplete .env variables and references

🧠 Features & Architecture

DocumentDescription                                                                                                                                                       
ArchitectureSystem architecture, data flow, and internals
Compression Guide7-option pipeline: off / lite / standard / aggressive / ultra / RTK / stacked
RTK CompressionCommand-output compression, filters, trust, verify, raw-output recovery
Compression EnginesCaveman, RTK, stacked pipelines, dashboard/API/MCP surfaces
Compression Rules FormatJSON rule-pack schemas for Caveman and RTK filters
Compression Language PacksLanguage detection and Caveman rule-pack authoring
Resilience GuideCircuit breakers, cooldowns, queue, anti-thundering herd, TLS spoofing
Auto-Combo Engine12-factor scoring, mode packs, self-healing
Proxy Guide3-level proxy system, 1proxy marketplace, registry CRUD
Free Tiers25+ free API providers consolidated directory
Features GalleryVisual dashboard tour with screenshots
Codebase DocumentationBeginner-friendly codebase walkthrough

🤖 Protocols & APIs

DocumentDescription                                                                                                                                                                            
API ReferenceAll endpoints with examples
OpenAPI SpecOpenAPI 3.0 specification
MCP Server104 MCP tools, IDE configs, Python/TS/Go clients
MCP Server GuideMCP installation, transports, and tool reference
A2A ServerJSON-RPC 2.0 protocol, skills, streaming, task mgmt
A2A Server GuideA2A agent card, tasks, skills, and streaming

📋 Project & Quality

DocumentDescription                                                                                                                                                                             
ContributingDevelopment setup and guidelines
ChangelogFull per-version release history
Security PolicyVulnerability reporting and security practices
i18n Guide40+ language support, translation workflow, RTL
Release ChecklistPre-release validation steps
Coverage PlanTest coverage strategy and 25,000+ test suite

⭐ Top Contributors

OmniRoute is shaped by a passionate open-source community. These individuals have made exceptional contributions that directly impact the quality, stability, and reach of the project. Thank you.

oyi77
oyi77

🥇 207 commits • +114K lines
Analytics engine, SQL aggregations,
proxy marketplace, test coverage
R.D. & Randi
R.D. & Randi

🥈 108 commits • +38K lines
Endpoints page, tunnel integrations,
Docker workflows, A2A status, compression UI
Chris Staley
Chris Staley

🥉 70 commits • +1.8K lines
SSE stream hardening, Responses API,
Gemini pagination, test regression fixes
zenobit
zenobit

🏅 62 commits • +22K lines
CI/CD pipeline, i18n for 33 languages,
Void Linux package, platform fixes
Jan Leon
Jan Leon

🏅 52 commits • +22K lines
Reasoning-effort routing, proxy controls,
quota visibility, Live Zone compression
Chirag Singhal
Chirag Singhal

🏅 46 commits • +4.8K lines
Error sanitization, MITM prefill fix,
fusion judge, breaker/429 correctness
backryun
backryun

🏅 43 commits • +70K lines
Provider catalog curation — Perplexity, Kimi,
Cerebras, Copilot, LMArena refreshes
kfiramar
kfiramar

🏅 38 commits • +1.7K lines
Codex websocket + passthrough, auth/onboarding,
Electron hardening, DB migrations
Benson K B
Benson K B

🏅 28 commits • +9.2K lines
Electron desktop app, auto-updater,
release build workflows, cross-platform CI
Hernan J. Ardila
Hernan J. Ardila

🏅 22 commits • +174K lines
Zero-latency combos, vision-bridge auto-routing,
catalog context-length, resilience 429 hints

🙏 These contributors’ features, bug fixes, and infrastructure improvements are a core part of what makes OmniRoute reliable and feature-rich. Every pull request, every test case, and every i18n translation file matters. Open source is built by people like them.



👥 350+ Contributors

Contributors

How to Contribute

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

Releasing a New Version

# Create a release — npm publish happens automatically
gh release create v3.8.2 --title "v3.8.2" --generate-notes

📊 Stars

Star History Chart

🌍 StarMapper

StarMapper

🙏 Acknowledgments

OmniRoute stands on the shoulders of giants. It started as a fork of 9router and a TypeScript port of the Go project CLIProxyAPI — and from there, every subsystem below was inspired by an open-source project that got there first. Each one shaped a concrete piece of OmniRoute. This is our thank-you to all of them. 🙏

⭐ star counts as of July 2026 — go give these projects a star.

🧬 Lineage & gateway

ProjectHow it inspired OmniRoute
9router · decolua22.7kThe original project this fork is built on — extended here with multi-modal APIs and a full TypeScript rewrite.
CLIProxyAPI · router-for-me43.6kThe Go implementation that inspired this JavaScript / TypeScript port.
LiteLLM · BerriAI54.0kThe AI gateway whose public pricing dataset feeds our cost-tracking sync and whose provider-normalization model informed our routing.

🗜️ Context & token compression — engines

ProjectHow it inspired OmniRoute
Caveman · JuliusBrussee90.8kThe viral “why use many token when few token do trick” project — its caveman-speak philosophy powers our standard compression mode and 30+ filler/condensation rules.
RTK – Rust Token Killer · rtk-ai71.8kHigh-performance command-output compression — inspired our RTK engine, JSON filter DSL, raw-output recovery and the stacked RTK → Caveman pipeline.
headroom · headroomlabs-ai60.1kReversible context-compression (SmartCrusher) — inspired our headroom engine and the ccr retrieve-marker pattern.
LLMLingua · Microsoft6.5kPrompt-compression research (LLMLingua / LLMLingua-2) — inspired our async, code-safe, fail-open llmlingua engine.
llmlingua-2-js · atjsh30The JS/ONNX port (MobileBERT / XLM-RoBERTa) used as the worker-thread backend for our LLMLingua engine.
Troglodita · Lenine Júnior26PT-BR token compression — powers our pt-BR language pack: pleonasm reduction and filler removal tuned for Brazilian-Portuguese grammar.
ponytail · DietrichGebert86.0kThe viral “lazy senior dev” YAGNI-coder skill — inspired our less-code Output Style: smallest-working-change steering that cuts generated code (the output-axis sibling to Caveman’s terse prose).

🧩 Compact formats, token research & code-aware tooling

ProjectHow it inspired OmniRoute
TOON · toon-format24.9kToken-Oriented Object Notation — its columnar, header-plus-rows model shaped our tabular compaction stage.
GCF – Graph Compact Format · Blackwell Systems22First inspired our tabular compaction stage; now its zero-dependency, lossless generic-profile encoder is vendored directly as the Headroom codec (MIT, SPDX-marked), current with GCF spec v3.2.
token-optimizer-mcp · ooples444Brotli/SQLite cache + per-session context-delta — inspired our session-dedup engine.
token-savior · Mibayy1.1kBash-output compaction + MCP profiles — inspired our compression bail-out discipline and MCP tool-manifest reduction.
token-saver · ppgranger117Content-aware, per-file-type output compression with failure-aware bail-out — validated our per-type dispatch and minimum-gain skip.
token-optimizer · alexgreensh1.7k“Find the ghost tokens” — its offload + recoverable-handle pattern informed our CCR offload thinking.
TokenMizer · Shweta-Mishra-ai16A session-graph + cross-turn line-dedup blueprint that informed our session-dedup design.
OmniCompress · jessefreitas3Rust columnar-JSON + content-addressed retrieve + cross-message dedup — validated our headroom/ccr/session-dedup engine design and the cache-stable “compressed form is position-independent” invariant.
mcp-compressor · Atlassian Labs98MCP tool-schema/description compression — informed our MCP tool-manifest cardinality reduction.
RepoMapper · pdavis68187Aider-style repo-map ranking — informed our repo-map / retrieval-ranking exploration.
quiet-shell-mcp · mrsimpson4Declarative shell-output reduction over MCP — validated our declarative bash-output compaction.
ts-morph · David Sherret6.1kTypeScript Compiler API toolkit — inspired our parser-based comment removal that preserves string, template and regex literals.

🧠 Memory & RAG

ProjectHow it inspired OmniRoute
Mem0 · mem0ai61.2kUniversal memory layer — its proxy-as-write/read-boundary model shaped our memory architecture.
Letta (MemGPT) · letta-ai23.9kStateful agents with tiered memory — inspired our Context Control & Recovery (CCR) tiered model.
WFGY · onestardao1.8kThe ProblemMap taxonomy of 16 recurring RAG/LLM failure modes — the shared vocabulary in our troubleshooting guide.

🛰️ Traffic inspection, MITM & transparent proxy

ProjectHow it inspired OmniRoute
llm-interceptor · chouzz49MITM interception/analysis of coding-assistant ↔ LLM traffic — our Traffic Inspector ports its SSE merge, conversation normalization, host passthrough and secret masking (MIT).
ProxyBridge · InterceptSuite5.5kTransparent per-process proxy routing — inspired our crash-safe MITM teardown, socket idle-timeouts, /proc process attribution and TPROXY capture.

📚 Model data, observability & UI

ProjectHow it inspired OmniRoute
models.dev · SST / OpenCode6.0kOpen database of AI model specs, pricing and capabilities — synced natively into our model catalog.
React Flow / xyflow · xyflow37.7kThe node-based graph library powering our real-time Compression Studio and Combo/Routing Studio.
LangGraph · LangChain37.6kLangGraph Studio’s live workflow-graph visualization inspired our Studios’ real-time cascade view.
Langfuse · Langfuse31.4kIts trace → span → generation observability model shaped our Compression Studio waterfall.
Kiali · Kiali3.6kIstio service-mesh observability — inspired our circuit-breaker badges and error-edge visuals in the Routing/Combo Studio.
lobe-icons · LobeHub2.2kAI/LLM brand logos that render the provider icons across our dashboard.

🛡️ Security

ProjectHow it inspired OmniRoute
awesome-secure-defaults · tldrsec710A curated list of secure-by-default libraries that guides our security choices (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

🧭 Complementary tools

ProjectHow it composes with OmniRoute
CodeWebChat · robertpiosikEditor-side companion — VS Code + browser extension that autofills 15+ chatbot web UIs with editor context. Owns the free-web-UI rail alongside OmniRoute’s API rail; can point its API mode at OmniRoute.

💖 Sponsors

Want to appear here? OmniRoute puts sponsors in front of one of GitHub’s fastest-growing AI-gateway communities — and we say publicly where every sponsored token goes. Reach out: [email protected]

Kimi (Moonshot AI)
Kimi
Moonshot AI

Official Supporter
Thanks to Kimi (Moonshot AI) for sponsoring this project! Kimi is the AI lab behind the open-weight K2 and K3 model families — Kimi K3 delivers a 1M-token context window, native vision and frontier-level coding at a fraction of closed-model prices, and works out of the box with Claude Code, Codex and every coding tool OmniRoute serves.

Where the sponsorship goes: Kimi's API credits power OmniRoute's AI-validated release pipeline — the merge validation powered by Kimi K3 stage that reviews every pull request before it ships — plus day-to-day feature development. First-class Kimi support ships on both rails: the direct Moonshot API (kimi-k3) and the Kimi Code coding plan (OAuth and API key). Get a Moonshot API key →

❤️ Support

OmniRoute is free and open source, built and maintained in the open. If it saves you time or money, consider supporting development:

  • Star the repo — it genuinely helps visibility
  • 💖 GitHub Sponsors — fund ongoing maintenance and new providers
  • 🐛 Report bugs and share feedback in Discussions

📄 License

MIT License - see LICENSE for details.


⬆ Back to top · Built with ❤️ for the open-source AI community.

OmniRoute v3.8.49 · Node ≥22.22.2 · MIT License · omniroute.online

相似文章

@GitHub_Daily: 最近一个名为 9router 的开源工具火了,给所有 AI 编程工具加了一个智能调度中心。 像平时用 Claude Code 写代码,API 额度消耗极快,遇到大段报错日志更是瞬间把 Token 烧光。 而 9router 则内置了智能压…

X AI KOLs Timeline

9router 是一个开源的 AI 编程工具智能路由中心,内置压缩算法节省 Token,支持三级降级自动切换模型,原生兼容 Claude Code、Cursor 等主流工具,可路由到数十家模型服务商,有效降低 API 调用成本。

diegosouzapw/OmniRoute

GitHub Trending (daily)

OmniRoute 是一个免费、开源的 AI 网关,连接超过 230 个提供商(包括 50 多个免费层级),具备智能路由和令牌压缩功能,可节省成本。它为 Claude Code、Cursor、Copilot 等各种 AI 工具提供统一端点。