OmniRoute
OmniRoute is an AI gateway for multi-provider LLMs: an OpenAI-compatible endpoint with smart routing, load balancing, retries, and fallbacks. Add policies, rate limits, caching, and observability for reliable, cost-aware inference.
Install / Use
/learn @diegosouzapw/OmniRouteREADME
🚀 OmniRoute — The Free AI Gateway
Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.
Your universal API proxy — one endpoint, 67+ providers, zero downtime. Now with MCP & A2A agent orchestration.
Chat Completions • Embeddings • Image Generation • Video • Music • Audio • Reranking • Web Search • MCP Server • A2A Protocol • 100% TypeScript
<div align="center">
🌐 Website • 🚀 Quick Start • 💡 Features • 📖 Docs • 💰 Pricing • 💬 WhatsApp
</div>🌐 Available in: 🇺🇸 English | 🇧🇷 Português (Brasil) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 Deutsch | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino | 🇨🇿 Čeština
🆕 What's New in v3.0.0
Upgrading from v2.9.5? — See the full CHANGELOG for all changes.
| Area | Change |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🔒 CodeQL Security | Fixed 10+ CodeQL alerts: polynomial-redos, insecure-randomness, shell-injection remediation |
| ✅ Route Validation | All 176 API routes now validated with Zod schemas + validateBody() — CI check:route-validation:t06 passes |
| 🐛 omniModel Tag Leak | Internal <omniModel> tags no longer leak to clients in SSE streaming responses (#585) |
| 🔑 Registered Keys API | Auto-provision API keys via POST /api/v1/registered-keys with per-provider/account quota enforcement, idempotency, SHA-256 storage, and optional GitHub issue reporting |
| 🎨 Provider Icons | 130+ provider logos via @lobehub/icons (SVG) with PNG → generic fallback chain |
| 🔄 Model Auto-Sync | 24h scheduler refreshes model lists for 16 providers on startup — configurable via MODEL_SYNC_INTERVAL_HOURS |
| 🌐 OpenCode Zen/Go | Two new providers from @kang-heewon via PR #530: free tier + subscription tier via OpencodeExecutor |
| 🐛 Gemini CLI OAuth | Actionable error when GEMINI_OAUTH_CLIENT_SECRET is missing in Docker (was cryptic Google error) |
| 🐛 OpenCode config | saveOpenCodeConfig() now correctly writes TOML to XDG_CONFIG_HOME |
| 🐛 Pinned model override | body.model correctly set to pinnedModel on context-cache protection |
| 🐛 Codex/Claude loop | tool_result blocks now converted to text to stop infinite loops |
| 🐛 Login redirect | Login no longer freezes after skipping password setup |
| 🐛 Windows paths | MSYS2/Git-Bash paths (/c/...) normalized to C:\... automatically |
🖼️ Main Dashboard
<div align="center"> <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/> </div>📸 Dashboard Preview
<details> <summary><b>Click to see dashboard screenshots</b></summary>| Page | Screenshot |
| -------------- | ------------------------------------------------- |
| Providers |
|
| Combos |
|
| Analytics |
|
| Health |
|
| Translator |
|
| Settings |
|
| CLI Tools |
|
| Usage Logs |
|
| Endpoints |
|
🤖 Free AI Provider for your favorite coding agents
Connect any AI-powered IDE or CLI tool through OmniRoute — free API gateway for unlimited coding.
<table> <tr> <td align="center" width="110"> <a href="https://github.com/openclaw/openclaw"> <img src="./public/providers/openclaw.png" alt="OpenClaw" width="48"/><br/> <b>OpenClaw</b> </a><br/> <sub>⭐ 205K</sub> </td> <td align="center" width="110"> <a href="https://github.com/HKUDS/nanobot"> <img src="./public/providers/nanobot.png" alt="NanoBot" width="48"/><br/> <b>NanoBot</b> </a><br/> <sub>⭐ 20.9K</sub> </td> <td align="center" width="110"> <a href="https://github.com/sipeed/picoclaw"> <img src="./public/providers/picoclaw.jpg" alt="PicoClaw" width="48"/><br/> <b>PicoClaw</b> </a><br/> <sub>⭐ 14.6K</sub> </td> <td align="center" width="110"> <a href="https://github.com/zeroclaw-labs/zeroclaw"> <img src="./public/providers/zeroclaw.png" alt="ZeroClaw" width="48"/><br/> <b>ZeroClaw</b> </a><br/> <sub>⭐ 9.9K</sub> </td> <td align="center" width="110"> <a href="https://github.com/nearai/ironclaw"> <img src="./public/providers/ironclaw.png" alt="IronClaw" width="48"/><br/> <b>IronClaw</b> </a><br/> <sub>⭐ 2.1K</sub> </td> </tr> <tr> <td align="center" width="110"> <a href="https://github.com/anomalyco/opencode"> <img src="./public/providers/opencode.svg" alt="OpenCode" width="48"/><br/> <b>OpenCode</b> </a><br/> <sub>⭐ 106K</sub> </td> <td align="center" width="110"> <a href="https://github.com/openai/codex"> <img src="./public/providers/codex.png" alt="Codex CLI" width="48"/><br/> <b>Codex CLI</b> </a><br/> <sub>⭐ 60.8K</sub> </td> <td align="center" width="110"> <a href="https://github.com/anthropics/claude-code"> <img src="./public/providers/claude.png" alt="Claude Code" width="48"/><br/> <b>Claude Code</b> </a><br/> <sub>⭐ 67.3K</sub> </td> <td align="center" width="110"> <a href="https://github.com/google-gemini/gemini-cli"> <img src="./public/providers/gemini-cli.png" alt="Gemini CLI" width="48"/><br/> <b>Gemini CLI</b> </a><br/> <sub>⭐ 94.7K</sub> </td> <td align="center" width="110"> <a href="https://github.com/Kilo-Org/kilo