diegosouzapw

OmniRoute: Route AI Tools Through One Gateway

OmniRoute is a self-hosted AI gateway that gives coding tools and applications one endpoint for many model providers. It adds configurable routing, quota-aware fallback, and optional token compression, with support for free and paid provider accounts.

Stars
72.7k
Forks
10.4k
Stars, last 12 days
+4,479

Our take

Health score

72/100

How it is scored
Activity
91
Community
74
Issues
73
Pull requests
51

+4,479 stars in the last 12 days

  • Releases more often than 93% of the projects we track
  • Merges more pull requests than 88% of the projects we track
  • More contributors than 77% of the projects we track
  • Slower to merge pull requests than 86% of the projects we track

Overview

OmniRoute is a TypeScript AI gateway that sits between AI coding tools or applications and model providers. It exposes a shared endpoint, so users can work with multiple providers without configuring every client separately.

Its main purpose is to make provider switching and request routing easier. It can select among configured backends and fall back when a provider is unavailable or out of quota. The project is aimed at developers who want a self-hosted control point for AI-assisted coding and other model-powered workflows.

Key Features

  • OpenAI-compatible API endpoint for connecting supported clients and tools.
  • Provider catalog spanning free and paid model services, with provider and model configuration managed through the gateway.
  • Automatic routing and fallback, including strategies that account for quota, cost, latency, and provider health.
  • Optional token-compression engines for reducing prompt size on supported workloads.
  • Integrations for coding CLIs and agents, plus MCP and A2A support described by the project.
  • Dashboard for configuring providers and reviewing routing and usage information.
  • Multiple deployment options, including npm, Docker, desktop app, and Android through Termux.

Use Cases

  • Developers using several coding assistants can point compatible tools at one endpoint and change model providers centrally.
  • Individuals with a mix of free-tier and paid accounts can route requests across available backends and use fallback when a provider is unavailable.
  • Teams or self-hosters can run a local gateway to manage provider credentials and view usage in one place.
  • Users with long prompts or tool-heavy coding sessions can try its optional compression and quota-aware routing features.

Getting Started

Install globally with npm:

npm install -g omniroute

The README describes configuration, provider setup, Docker and other installation options, and connecting compatible tools. See the repository README for setup details.

Alternatives

  • freellmapi: FreeLLMAPI focuses on combining free provider accounts and custom endpoints, while OmniRoute also emphasizes configurable routing and optional token compression.
ProjectLanguageLicenseStarsStatus
OmniRouteTypeScriptMIT72.7kNot checked yet
freellmapiTypeScriptMIT30.3kNew

Considerations

OmniRoute is a gateway, not a model provider: access to most backends depends on their account, API key, quota, and terms. The README describes a keyless provider for an initial zero-credential test, but availability and free-tier limits can change. Self-hosting also means operating the gateway and protecting its stored provider credentials. Claims about provider counts, free quotas, and supported integrations are catalog-dependent, so check the repository documentation for current details.

Found this useful?

Share it with someone who would like OmniRoute.

Comparisons