diegosouzapw/omniroute

By diegosouzapw

•Updated 3 minutes ago

OmniRoute — Unified AI proxy. Route any LLM through one endpoint.

Image

1M+

Overview Tags

diegosouzapw/omniroute repository overview

⁠🚀 OmniRoute — The Free AI Gateway

OmniRoute — Never stop coding. Every AI tool → 375 providers — 150+ 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. 375 AI providers · 150+ free tiers · ~1.62B free tokens/mo · 20 routing strategies · $0 to start.

⁠💰 ~1.62B Tokens / Month Across Third-Party Free Tiers

Bring your own provider accounts. This is an estimated aggregate across separately eligible third-party free tiers, not a token grant from OmniRoute. Sign up, obtain credentials where required, and connect the providers you can use; each provider controls its limits, availability, and terms.

Stacking free tiers by hand is painful — dozens of SDKs, dozens of rate limits, and no idea how much you actually have. OmniRoute catalogs 467 free-tier entries across 34 recurring pool keys and computes the token headline from the 17 pools with a published positive monthly budget plus five per-model Groq caps, deduplicated by shared pool. Quotas that only open after a regional identity check (today: ModelScope) are shown apart, +~6M behind regional identity verification, and never summed into the headline. The result stays visible on the dashboard (/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.}

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

⁠💬 Join the community

👋 Follow the maintainer — get new providers, releases & tips first:

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

⁠📈 The Gateway Keeps Growing

	v3.8.50	v3.8.51	`v3.8.52+`
🌐 Providers	352	358	375
🧠 Unique chat model IDs	1320	1374	1475
🖼️ Modality Bridge	🆕 vision + audio + video	✓	✓
📡 Radar free catalog	🆕 opt-in	✓	✓
⚖️ Quota-aware scheduling	🆕 Quota-Share	✓	✓
📊 Quota telemetry	🆕 live	✓	✓
🧰 Headless mode	—	—	🆕 `serve --headless`
🛤️ LTS rail infra	—	—	🆕 release channels
🔎 Model discovery API	—	—	🆕 `/v1/models/query`

→ Roadmap⁠ — riding the rail to v3.9.0 LTS

⁠🧩 Available

🚀 Start	🚀 Quick Start⁠	📦 Install⁠	🆓 Connect a provider⁠
💡 Learn	💥 The Promise⁠	🤔 Why OmniRoute⁠	🏆 What Sets Apart⁠
⚙️ Features	🎯 Combos⁠	🌐 Providers⁠	🔌 CLI & MCP⁠
	🗜️ Compression⁠	🖥️ Where It Runs⁠	🔒 Private⁠
👀 See it	🎬 In Action⁠	✨ What's New⁠	🤖 Compatible CLIs⁠
💚 Support	💚 Support / Donate⁠	💬 Community⁠	💖 Sponsors⁠
📦 Project	🛠️ Tech Stack⁠	📖 Docs⁠	👥 Contributors⁠

🌐 In 67 languages

⁠🆓 Install, connect a provider, then route through one endpoint

Three steps: install and start OmniRoute, connect an eligible provider with your own account or API key, then point your tool at localhost:20128/v1 using an OmniRoute API key and model auto. Routing depends on available eligible connections and provider limits.

# After connecting a provider, copy your OmniRoute key from Dashboard → Endpoints:
curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{auto needs an eligible route. A fresh installation can have no eligible keyless targets, and a keyless provider may reject third-party clients. Providers marked tos: avoid, including Kiro, are excluded from automatic routing by default; connecting an account does not override that setting. See the Free Tiers Guide⁠ before choosing a provider.}

_{📦 Copy-paste quickstart scripts for Python, Node.js, PHP, and cURL → examples/quickstart/⁠}

⁠💥 The Promise

⁠🤔 Why OmniRoute?

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, 20 routing strategies, circuit breakers, TLS stealth, MCP, A2A, guardrails) can fall back across 4 provider tiers while an eligible healthy target remains — Tier 1 Subscription, Tier 2 API Key, Tier 3 Cheap and Tier 4 Free.

⁠🤝 Supported by our Open Source Friends

⁠

Want to join as an Open Source Friend? These are the companies that back open source and help keep OmniRoute moving — and we say publicly where every token they give us goes. Reach out: [email protected]⁠

⁠
Kimi
_{Moonshot AI} Thanks to Kimi (Moonshot AI), our founding Open Source Friend, for backing 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.

What Kimi's support powers: 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 Kimi API⁠ (kimi-k3) and the Kimi Code coding plan⁠ (OAuth and API key). OmniRoute is also the first Brazilian open-source project in Kimi's support program. Get a Kimi API key with 15% extra credits →⁠

⁠
Cheaper Inference
_che

Tag summary

Recent tags

Content type

Image

Digest

sha256:b08a12e87…

Size

422.3 MB

Last updated

14 days ago

docker pull diegosouzapw/omniroute