OmniRoute
Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot.
Install / Use
npx skills add cheaper-inference/OmniRouteInstalls into whichever agent you are using.
CLAUDE.md
Claude Code project instructions
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of OmniRoute
OmniRoute scores 91/100 on our quality scale, 290th of 946 AI & Machine Learning skills we index (top 31%).
Its CLAUDE.md is 136 KB long, well organised into 74 sections with 22 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
With 79,388 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated today, so OmniRoute is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
OmniRoute compared with similar skills
All 4 of these similar skills score higher than OmniRoute; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| OmniRoute (this skill)by cheaper-inference | 91 | 79.4k | today | CLAUDE.md |
| claude-memby thedotmack | 100 | 102.1k | 1d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 100.6k | 1d ago | CLAUDE.md |
| taste-skillby Leonxlnx | 100 | 100.5k | 1d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 87.5k | today | CLAUDE.md |
Frequently asked questions
- How do I install OmniRoute?
- Run
npx skills add cheaper-inference/OmniRoute. The install tabs above show the steps for each supported agent. - Which AI agents does OmniRoute work with?
- It is written for Claude Code, Cursor, GitHub Copilot, Cline, Gemini CLI and OpenAI Codex, as a CLAUDE.md file. Other agents that read the same format can often use it too.
- Is OmniRoute safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is OmniRoute still maintained?
- The repository was last updated today, so OmniRoute is actively maintained.
Skill content
View source on GitHub🚀 OmniRoute — The Free AI Gateway
<img src="./docs/diagrams/readme-hero.svg" width="100%" alt="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."/> </div> <div align="center">💰 ~1.62B Tokens / Month Across Third-Party Free Tiers
</div><img src="./docs/diagrams/free-tier-budget.svg" width="100%" alt="OmniRoute free-tier budget card: ~1.62B free tokens per month steady, up to ~2.22B in the first month with signup credits, from 34 documented recurring pool keys covering 467 cataloged free-tier entries behind one endpoint. Honest pool-deduped math — each shared pool counted once, including 17 recurring pools with a published positive monthly token budget plus five per-model Groq caps; 12 providers are marked avoid in the terms-risk catalog so you decide. Budget bar includes Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (five per-model caps) and smaller pools, plus first-month signup credits and permanently-free no-token-cap providers surfaced separately so they never inflate the headline. Live used/remaining on /dashboard/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).
<br/> <div align="center"> <h3>Animated summary of the live
/dashboard/free-tierspage. Full methodology (pool dedupe, credit tiers, provider terms): docs/reference/FREE_TIERS.md.<sub>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.</sub>
⭐ Star the repo if OMNIROUTE helped you save money and make your work easier.
</h3>
<a href="https://trendshift.io/repositories/23589" target="_blank"><img src="https://trendshift.io/api/badge/repositories/23589" alt="diegosouzapw%2FOmniRoute | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
💬 Join the community
👋 Follow the maintainer — get new providers, releases & tips first:
Questions, provider tips, roadmap & support → Discord · Telegram · WhatsApp 🌍 Global / 🇧🇷 Brasil / Portal
<br/>📈 The Gateway Keeps Growing
<div align="center">| | v3.8.50 | v3.8.51 | v3.8.53+ |
| ------------------------- | :-----------------------: | :---------: | :-------------------: |
| 🌐 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
<table> <tr> <td align="right"><b>🚀 Start</b></td> <td align="center"><a href="#-quick-start">🚀 Quick Start</a></td> <td align="center"><a href="#-more-install-methods--docker-source-pnpm-arch">📦 Install</a></td> <td align="center"><a href="#first-run">🆓 Connect a provider</a></td> </tr> <tr> <td align="right"><b>💡 Learn</b></td> <td align="center"><a href="#-the-promise">💥 The Promise</a></td> <td align="center"><a href="#-why-omniroute">🤔 Why OmniRoute</a></td> <td align="center"><a href="#-what-sets-omniroute-apart">🏆 What Sets Apart</a></td> </tr> <tr> <td align="right"><b>⚙️ Features</b></td> <td align="center"><a href="#-combos--the-flagship">🎯 Combos</a></td> <td align="center"><a href="#-375-ai-providers--153-catalog-marked-free">🌐 Providers</a></td> <td align="center"><a href="#-full-cli--a2a--mcp">🔌 CLI & MCP</a></td> </tr> <tr> <td align="right"></td> <td align="center"><a href="#%EF%B8%8F-save-1595-tokens--automatically">🗜️ Compression</a></td> <td align="center"><a href="#%EF%B8%8F-where-omniroute-runs--anywhere">🖥️ Where It Runs</a></td> <td align="center"><a href="#-private--local-first">🔒 Private</a></td> </tr> <tr> <td align="right"><b>👀 See it</b></td> <td align="center"><a href="#-omniroute-in-action">🎬 In Action</a></td> <td align="center"><a href="#-whats-new">✨ What's New</a></td> <td align="center"><a href="#-compatible-clis--coding-agents">🤖 Compatible CLIs</a></td> </tr> <tr> <td align="right"><b>💚 Support</b></td> <td align="center"><a href="#-support-omniroute">💚 Support / Donate</a></td> <td align="center"><a href="#-community--help">💬 Community</a></td> <td align="center"><a href="#-sponsors">💖 Sponsors</a></td> </tr> <tr> <td align="right"><b>📦 Project</b></td> <td align="center"><a href="#%EF%B8%8F-tech-stack">🛠️ Tech Stack</a></td> <td align="center"><a href="#-documentation">📖 Docs</a></td> <td align="center"><a href="#-900-contributors">👥 Contributors</a></td> </tr> </table> </div> <div align="center"> <b>🌐 In 67 languages</b> <br/><br/> <a href="README.md"><img src="docs/assets/flags/us.svg" width="30" alt="English (en)" title="English (en)"></a> <a href="docs/i18n/pt-BR/README.md"><img src="docs/assets/flags/br.svg" width="30" alt="Português — Brasil (pt-BR)" title="Português — Brasil (pt-BR)"></a> <a href="docs/i18n/pt/README.md"><img src="docs/assets/flags/pt.svg" width="30" alt="Português (pt)" title="Português (pt)"></a> <a href="docs/i18n/es/README.md"><img src="docs/assets/flags/es.svg" width="30" alt="Español (es)" title="Español (es)"></a> <a href="docs/i18n/fr/README.md"><img src="docs/assets/flags/fr.svg" width="30" alt="Français (fr)" title="Français (fr)"></a> <a href="docs/i18n/it/README.md"><img src="docs/assets/flags/it.svg" width="30" alt="Italiano (it)" title="Italiano (it)"></a> <a href="docs/i18n/de/README.md"><img src="docs/assets/flags/de.svg" width="30" alt="Deutsch (de)" title="Deutsch (de)"></a> <a href="docs/i18n/nl/README.md"><img src="docs/assets/flags/nl.svg" width="30" alt="Nederlands (nl)" title="Nederlands (nl)"></a> <a href="docs/i18n/ru/README.md"><img src="docs/assets/flags/ru.svg" width="30" alt="Русский (ru)" title="Русский (ru)"></a> <a href="docs/i18n/uk-UA/README.md"><img src="docs/assets/flags/ua.svg" width="30" alt="Українська (uk-UA)" title="Українська (uk-UA)"></a> <a href="docs/i18n/pl/README.md"><img src="docs/assets/flags/pl.svg" width="30" alt="Polski (pl)" title="Polski (pl)"></a> <a href="docs/i18n/cs/README.md"><img src="docs/assets/flags/cz.svg" width="30" alt="Čeština (cs)" title="Čeština (cs)"></a> <a href="docs/i18n/sk/README.md"><img src="docs/assets/flags/sk.svg" width="30" alt="Slovenčina (sk)" title="Slovenčina (sk)"></a> <a href="docs/i18n/ro/README.md"><img src="docs/assets/flags/ro.svg" width="30" alt="Română (ro)" title="Română (ro)"></a> <a href="docs/i18n/hu/README.md"><img src="docs/assets/flags/hu.svg" width="30" alt="Magyar (hu)" title="Magyar (hu)"></a> <a href="docs/i18n/bg/README.md"><img src="docs/assets/flags/bg.svg" width="30" alt="Български (bg)" title="Български (bg)"></a> <a href="docs/i18n/da/README.md"><img src="docs/assets/flags/dk.svg" width="30" alt="Dansk (da)" title="Dansk (da)"></a> <a href="docs/i18n/fi/README.md"><img src="docs/assets/flags/fi.svg" width="30" alt="Suomi (fi)" title="Suomi (fi)"></a> <a href="docs/i18n/no/README.md"><img src="docs/assets/flags/no.svg" width="30" alt="Norsk (no)" title="Norsk (no)"></a> <a href="docs/i18n/sv/README.md"><img src="docs/aTruncated for display — read the full file on GitHub.
Related Skills
claude-mem
102.1kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
100.6kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
taste-skill
100.5kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Understand-Anything
87.5kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
