# 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 

- **URL**: https://www.freshcrate.ai/projects/OmniRoute
- **Author**: diegosouzapw
- **Category**: Infrastructure
- **Latest version**: `v3.8.8` (2026-06-03)
- **License**: MIT
- **Source**: https://github.com/diegosouzapw/OmniRoute
- **Language**: TypeScript
- **GitHub**: 3,250 stars, 509 forks
- **Registry**: github
- **Tags**: `typescript`

## Description

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.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v3.8.8` | 2026-06-03 | High | ## [3.8.8] — 2026-06-03  ### Added  - **Plugins framework** (`src/lib/plugins/`, `/api/plugins/*`, `/dashboard/plugins`) — hooks + registry unification, plugin SDK (`definePlugin`), worker-thread sandbox, per-plugin hook rate limiting, SHA-256 integrity verification, semver-gated upgrade, and execution analytics. Plugin routes are loopback-only (`isLocalOnlyPath`) and `child_process` exec is opt-in via `OMNIROUTE_PLUGINS_ALLOW_EXEC`. (#2913 / #3041 — thanks @oyi77) - **Plugin system: response-ho |
| `v3.8.4` | 2026-05-27 | High | ### 🔒 Security  - **authz:** redirect `/home` and `/home/:path*` to `/login` when unauthenticated — Next.js middleware matcher omitted `/home`, so any visit reached the page directly on `REQUIRE_LOGIN` deployments (#2712 — thanks @diegosouzapw) - **review:** resolve v3.8.4 important + minor findings from consolidated review including SSRF guards (#2749 — thanks @diegosouzapw)  ### ✨ New Features  - **feat(credential-health):** fail-fast credential health check with TTL cache and background sch |
| `v3.8.1` | 2026-05-21 | High | ## [3.8.1] — 2026-05-21  ### ✨ New Features  - **feat(settings):** Feature Flags Settings Page (Card Grid + DB overrides) — fully implements the feature flags UI dashboard using Variant A (Card Grid) with Glassmorphism, complete with global `GET/PUT/DELETE` API routes, Zod validation, debounced search, category filters, and full 30+ locale i18n support. Resolves priority hierarchy to DB > ENV > Defaults. ([#2457](https://github.com/diegosouzapw/OmniRoute/pull/2457)) - **feat(db):** multi-driver |
| `v3.7.9` | 2026-05-06 | High | ### ✨ New Features - **feat(docs):** integrate multi-page documentation into OmniRoute dashboard (#1969) - **feat(settings):** add request body limit setting (#1968) - **feat(auth):** add Gemini CLI OAuth client secret default (#1974) - **feat(models):** expose models.dev context windows in /v1/models (#1972)  - **feat(compression):** major upgrade to Caveman and RTK compression pipelines (#1876, #1889): - Add RTK tool-output compression, stacked Caveman + RTK pipelines, compression combo assig |
| `v3.7.7` | 2026-05-01 | High | ### ✨ New Features  - **Prompt Compression Pipeline:** Implemented a multi-phase prompt compression engine including `lite` (whitespace/duplication collapse), `aggressive` (summarization, tool compression), and `ultra` modes (heuristic pruning and SLM stub) (#1633, #1738, #1739, #1741) - **Compression Dashboard & Analytics:** Added a compression settings UI, real-time log viewer, pipeline statistics tracking, and interactive playground preview (#1756) - **Compression Caching & MCP:** Added cach |
| `v3.7.1` | 2026-04-27 | High | ### ✨ New Features  - **feat(providers):** Add GPT-5.5 support to the Codex provider — includes 1.05M context window, tool calling, vision, and reasoning capabilities with proper pricing entries across `cx` and `openai` providers. Refactors `splitCodexReasoningSuffix()` into a shared helper for cleaner effort-level parsing (#1617 — thanks @Zhaba1337228). - **feat(cli):** Add `omniroute reset-encrypted-columns` recovery command — nulls encrypted credential columns (`api_key`, `access_token`, `re |
| `v3.6.9` | 2026-04-19 | High | ### ✨ New Features  - **feat(providers):** Mark Qwen OAuth provider as deprecated following the upstream free tier shutdown on 2026-04-15. Adds deprecation warning to CLI tool UI and rewrites `saveQwenConfig` to inject OmniRoute as a multi-provider (openai, anthropic, gemini) via `.qwen/settings.json` and `.qwen/.env` (#1437) - **feat(cc-compatible):** Align Claude Code-compatible request shape with the official Claude CLI protocol, including proper system skeleton and request normalization (#1 |
| `v3.6.8` | 2026-04-18 | High | ### ✨ New Features  - **feat(providers):** Support `xhigh` reasoning tier exclusively on Claude models that expose it (#1356) - **feat(providers):** Add CC Compatible connection-level 1M context toggle (#1357) - **feat(core):** Add full support for Node.js 24 LTS (Krypton) environments with continuous integration coverage (#1340) - **feat(dashboard):** Display Antigravity credit balance in dashboard Limits & Quotas (#1338) - **feat(i18n):** Add internationalization support for combo features an |
| `v3.6.6` | 2026-04-16 | High | ### ✨ New Features  - **feat(storage):** Add database backup cleanup controls, UI management, and customizable retention period env vars (#1304) - **feat(providers):** Add Freepik Pikaso image generation provider with support for cookie/subscription-based auth modes (#1277) - **feat(providers): Add Perplexity Web (Session) Provider** — Routes through Perplexity's internal SSE API using a session cookie, giving native proxy access without separate API costs to GPT-5.4, Claude Opus, Gemini 3.1 Pr |
| `v3.6.5` | 2026-04-14 | High | ### ✨ New Features  - **Antigravity AI Credits Fallback:** Automatically retries with `GOOGLE_ONE_AI` credit injection when free-tier quota is exhausted. Per-account credit balance (5-hour TTL) is cached from SSE `remainingCredits` and exposed as a numeric badge in the Provider Usage dashboard (#1190 — thanks @sFaxsy) - **Claude Code Native Parity:** Full header/body signing parity with the Claude Code 2.1.87 OAuth client — CCH xxHash64 body signing with singleton WASM initialization promise (f |

## Dependency audit

- **Score**: 96/100
- **Total deps**: 69
- **Resolved**: 69
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 2
- **Scanned**: 2026-05-04

## Citation

- HTML: https://www.freshcrate.ai/projects/OmniRoute
- Markdown: https://www.freshcrate.ai/projects/OmniRoute.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/OmniRoute/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._