diegosouzapw/OmniRoute

What it is

OmniRoute is a gateway that gives tools like Claude Code, Codex, Cursor, Cline and Copilot a single local endpoint (http://localhost:20128/v1) in front of hundreds of AI providers. It can fall back across four provider tiers (Subscription, API Key, Cheap, Free) while a healthy target remains. It also offers RTK + Caveman compression, 19 routing strategies, circuit breakers, MCP, A2A and a dashboard that tracks free-tier budgets. It is not a token grant: you connect your own provider accounts or API keys.

Who it's for

• Developers using AI coding CLIs and agents (Claude Code, Codex, Cursor, Cline, Copilot) who want one endpoint for many providers
• Users who want to stack third-party free tiers and avoid hitting rate limits mid-coding
• Teams that want local-first routing with usage, quota and savings visibility

Requirements

Setup

1. Install and start OmniRoute

   The README describes 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. The install commands are in the README's Quick Start section, which was not included in the provided text.

2. Connect a provider and get your key

   Connect a provider you are eligible to use, then copy your OmniRoute key from Dashboard → Endpoints.

3. Send a test request

   Call the local endpoint with your OmniRoute key and the model auto.

   bashCopy

   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!"}]}'

Examples

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!"}]}'

Pros & cons

Images