# README (Svenska) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Den kostnadsfria AI-gatewayen **Skapad av [Diego Souza](https://github.com/diegosouzapw)**

OmniRoute — Sluta aldrig koda. Alla AI-verktyg → 388 leverantörer — 150+ kostnadsfria — via en enda endpoint. Claude Code, Codex, Cursor, Cline, Copilot och Antigravity till kostnadsfria Claude / GPT / Gemini med automatisk återställning. RTK + Caveman-staplad komprimering sparar 15–95 % tokens (~89 % i genomsnitt) — nå aldrig gränserna. 388 AI-leverantörer · 150+ kostnadsfria nivåer · ~1,62 miljarder kostnadsfria tokens/månad · 20 routningsstrategier · $0 för att komma igång.

## 💰 ~1.62B token per månad från kostnadsfria tredjepartsnivåer

> **Använd dina egna leverantörskonton.** Detta är en uppskattad totalsumma från separat berättigade kostnadsfria tredjepartsnivåer, inte ett tokenanslag från OmniRoute. Registrera dig, skaffa autentiseringsuppgifter där det krävs och anslut de leverantörer du kan använda; varje leverantör styr sina begränsningar, sin tillgänglighet och sina villkor. > > Att stapla kostnadsfria nivåer manuellt är besvärligt — dussintals SDK:er, dussintals hastighetsbegränsningar och ingen uppfattning om hur mycket du faktiskt har. OmniRoute katalogiserar **465 poster på kostnadsfria nivåer över 34 återkommande poolnycklar** och beräknar tokenrubriken från **17 pooler med en publicerad positiv månadsbudget plus fem Groq-gränser per modell**, deduplicerade efter delad pool. Kvoter som endast blir tillgängliga efter en regional identitetskontroll (i dag: ModelScope) visas separat, +~6M efter regional identitetsverifiering, och summeras aldrig i rubriken. Resultatet förblir synligt på instrumentpanelen (`/dashboard/free-tiers`).

OmniRoutes budgetkort för kostnadsfria nivåer: ~1.62B kostnadsfria token per månad stadigt, upp till ~2.22B den första månaden med registreringskrediter, från 34 dokumenterade återkommande poolnycklar som täcker 465 katalogiserade poster på kostnadsfria nivåer bakom en enda slutpunkt. Ärlig pooldeduplicerad beräkning — varje delad pool räknas en gång, inklusive 17 återkommande pooler med en publicerad positiv månatlig tokenbudget samt fem Groq-gränser per modell; 12 leverantörer är markerade som bör undvikas i katalogen över villkorsrisker så att du kan avgöra själv. Budgetfältet inkluderar Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (fem gränser per modell) och mindre pooler, samt registreringskrediter för den första månaden och leverantörer som är permanent kostnadsfria utan tokenbegränsning, vilka visas separat så att de aldrig blåser upp rubriken. Aktuellt använda och återstående mängder på /dashboard/free-tiers.

> Animerad sammanfattning av den aktuella sidan `/dashboard/free-tiers`. Fullständig metodik (pooldeduplicering, kreditnivåer, leverantörsvillkor): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Dessa siffror granskas på nytt varannan vecka mot den aktuella katalogen och **kan röra sig åt båda hållen** — en leverantör avslutar en kostnadsfri nivå och siffran sjunker; en ny tillkommer och den stiger. Vi publicerar det som katalogen faktiskt beräknar, aldrig ett avrundat bästa scenario.}

⭐ Stjärnmärk repot om OMNIROUTE hjälpte dig att spara pengar och göra ditt arbete enklare.

[![Stjärnor](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Ranking för stjärnhistorik](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Gå med i communityn **👋 Följ underhållaren — få nya leverantörer, versioner och tips först:** [![Följ Diego på LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Följ @diegosouzapw på GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasilien](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Webbplats](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Frågor, leverantörstips, färdplan och support → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasilien](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gatewayen fortsätter att växa

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | ------------------------------ | :----------------------: | :---------: | :-------------------: | | 🌐 Leverantörer | 352 | **358** | 388 | | 🧠 Unika chattmodell-ID:n | 1320 | **1374** | 1491 | | 🖼️ Modalitetsbrygga | 🆕 vision + ljud + video | ✓ | ✓ | | 📡 Radars gratiskatalog | 🆕 valfritt deltagande | ✓ | ✓ | | ⚖️ Kvotmedveten schemaläggning | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kvottelemetri | 🆕 live | ✓ | ✓ | | 🧰 Huvudlöst läge | — | — | 🆕 `serve --headless` | | 🛤️ LTS-spårinfrastruktur | — | — | 🆕 releasekanaler | | 🔎 API för modellidentifiering | — | — | 🆕 `/v1/models/query` | **→ [Färdplan](ROADMAP.md) — på spåret mot `v3.9.0 LTS`**

## 🧩 Tillgänglig [![npm-version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM månadsvis](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) ![Licens: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker-nedladdningar](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron-nedladdningar](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Kom igång	🚀 Snabbstart	📦 Installera	🆓 Anslut en leverantör
💡 Lär dig	💥 Löftet	🤔 Varför OmniRoute	🏆 Vad som särskiljer OmniRoute
⚙️ Funktioner	🎯 Kombinationer	🌐 Leverantörer	🔌 CLI & MCP
	🗜️ Komprimering	🖥️ Var det körs	🔒 Privat
👀 Se det	🎬 I praktiken	✨ Vad är nytt	🤖 Kompatibla CLI:er
💚 Stöd	💚 Stöd / Donera	💬 Gemenskap	💖 Sponsorer
📦 Projekt	🛠️ Teknikstack	📖 Dokumentation	👥 Bidragsgivare

🌐 På 67 språk

## 🆓 Installera, anslut en leverantör och dirigera sedan via en enda slutpunkt

Tre steg: installera och starta OmniRoute, anslut en kvalificerad leverantör med ditt eget konto eller din egen API-nyckel och peka sedan ditt verktyg mot localhost:20128/v1 med en OmniRoute API-nyckel och modellen auto. Routningen beror på tillgängliga kvalificerade anslutningar och leverantörsbegränsningar.

```bash # När du har anslutit en leverantör kopierar du din OmniRoute-nyckel från Dashboard → Endpoints: 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!"}]}' ``` _{`auto` behöver en kvalificerad rutt. En ny installation kan sakna kvalificerade mål utan nyckel, och en leverantör utan nyckel kan avvisa klienter från tredje part. Leverantörer märkta med `tos: avoid`, inklusive Kiro, utesluts som standard från automatisk routning; anslutning av ett konto åsidosätter inte den inställningen. Se [guiden om kostnadsfria nivåer](docs/getting-started/FREE-TIERS-GUIDE.md) innan du väljer leverantör.} _{📦 Kopiera-och-klistra-in-skript för snabbstart för **Python, Node.js, PHP och cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Löftet

# 🤔 Varför OmniRoute?

OmniRoutes begärandeflöde: din IDE eller CLI (Claude Code, Cursor, Cline…) anropar en enda lokal slutpunkt (http://localhost:20128/v1); OmniRoutes smarta router (RTK + Caveman-komprimering, 20 routningsstrategier, kretsbrytare, TLS-stealth, MCP, A2A, skyddsräcken) kan växla över mellan 4 leverantörsnivåer så länge en kvalificerad fungerande målanslutning finns — nivå 1 Prenumeration, nivå 2 API-nyckel, nivå 3 Billig och nivå 4 Kostnadsfri.

## 🤝 Stöds av våra Open Source-vänner

> **Vill du bli en Open Source-vän?** Dessa företag stöder öppen källkod och hjälper till att hålla OmniRoute igång – och vi berättar offentligt vart varje token de ger oss går. Hör av dig: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Tack till Kimi (Moonshot AI), vår grundande Open Source-vän, för att de stöder detta projekt! Kimi är AI-labbet bakom de öppna K2- och K3-modellfamiljerna — Kimi K3 levererar ett 1M-token kontextfönster, inbyggd syn och kodning på gränsnivå till en bråkdel av priset för slutna modeller, och fungerar direkt med Claude Code, Codex och alla kodningsverktyg som OmniRoute använder.

Vad Kimis stöd driver: Kimis API-krediter driver OmniRoutes AI-validerade release-pipeline — steget *sammanslagningsvalidering driven av Kimi K3* som granskar varje pull request innan den släpps — plus daglig funktionsutveckling. Förstklassigt Kimi-stöd levereras på båda sätten: det direkta Kimi API (kimi-k3) och Kimi Code kodningsplan (OAuth och API-nyckel). OmniRoute är också det första brasilianska open source-projektet i Kimis supportprogram. Skaffa en Kimi API-nyckel med 15% extra krediter →

Cheaper Inference
_{cheaperinference.com} Tack till Cheaper Inference, en OmniRoute Open Source-vän, för att de stöder detta projekt! Cheaper Inference är en kostnadsrankad gateway som säljer vidare 42 gränsmodeller — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok och MiniMax — bakom en OpenAI-kompatibel slutpunkt, som dirigerar varje förfrågan till den billigaste kvalificerade leverantören utan att någonsin ta ut mer än modellskaparens listpris.

Förstklassigt stöd i OmniRoute: Chat Completions, den inbyggda /v1/responses-slutpunkten, syn, verktygsanrop och 3 bildmodeller (grok-imagine, nano-banana-pro, nano-banana-2, nåbara som cheaperinference/<model>). Skaffa en API-nyckel →

_{Länkar taggade aff=omniroute är partnerlänkar. De finansierar projektet utan extra kostnad för dig.}

_{🎟️ Affiliates Promo — gratis registreringskuponger från leverantörer vi inte sponsrar (klicka för att expandera)}

_{Detta avsnitt är endast för hänvisnings-/kupongkoder. Sponsrade partnerskap finns under 🤝 Stöds av våra Open Source-vänner ovan. OmniRoute har ingen sponsring eller partnerskap med de leverantörer som listas här — dessa är offentliga kuponger som vem som helst kan använda.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — affiliate-registrering · $100 gratis krediter vid registrering (gratis server, förvänta dig högre latens — bäst för testning, inte produktion). Förstklassigt stöd i OmniRoute sedan v3.8.50: Chat Completions, det Anthropic-kompatibla trådformatet och den OpenAI-kompatibla sökvägen. Tillgängliga modeller inkluderar claude-opus-4-8, claude-opus-5, gpt-5.6-sol och mer. Hämta dina $100 →}

_{⚠️ Affiliatelänk — OmniRoute har ingen sponsring eller partnerskap med denna leverantör.}

_{Känner du till någon annan leverantör med en generös gratis registreringskupong som gynnar OmniRoutes användare? Öppna ett ärende så lägger vi till den här.}

## 🎯 Kombinationer — flaggskeppet

Animerade exempel för 18 av de 20 routningsstrategierna för kombinationer — en ruta per strategi: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. cache-optimized och quota-weighted är inte animerade; tabellen nedan beskriver alla 20.

> En **kombination** är en kedja av modeller som OmniRoute routar mellan **automatiskt**. Om kvoten tar slut, en leverantör slutar fungera eller kostnaderna skjuter i höjden kan kombinationen gå vidare till nästa kvalificerade och fungerande modell. 🛡️ ### ⚡ Nollkonfiguration — använd bara `auto` Du behöver inte skapa någon kombination. Ställ in modellen på `auto` (eller en variant), så skapar OmniRoute en virtuell kombination från dina anslutna leverantörer, poängsatt i realtid:

Modell-ID	Vad den optimerar för
`auto`	🎯 Balanserad standardinställning (LKGP — håller fast vid din senast fungerande leverantör)
`auto/coding`	🧑💻 Kvalitetsprioriterade vikter för kodgenerering
`auto/fast`	⚡ Lägsta latens först
`auto/cheap`	💰 Lägsta kostnad per token först
`auto/subscription`	🎟️ Endast prenumerationskvoten du redan betalar för — stoppar vid fel, utan avgiftsbelagd reservlösning (guide)
`auto/thrifty`	🪜 Plankvoten först, därefter ett steg i taget till de billigaste betalda alternativen — tillbaka till planen efter att den återställts (guide)
`auto/offline`	🔋 Störst marginal för kvot/hastighetsgräns först
`auto/smart`	🔭 Kvalitet först + 10 % utforskning för att hitta bättre modeller
`auto/lkgp`	📌 Håller uttryckligen fast vid senast kända fungerande leverantör
`auto/chaos`	🧪 Parallell utspridning till en panel av modeller (en per leverantör, 5 som standard), returnerar ett svar; ett uppströmsanrop per panelmodell, inte felinjektion

## ### 🔀 Eller bygg din egen — 20 routningsstrategier Alla **20** strategier — blanda fritt per steg i kombinationen:

#	Strategi	Vad den gör
1	`priority`	Ordnad lista med första målet först — töm varje mål innan nästa används 🥇
2	`fill-first`	Fyll varje måls kvot helt innan nästa används
3	`weighted`	Viktat slumpmässigt val enligt vikten för varje mål
4	`round-robin`	Växla mellan målen i ordningsföljd
5	`p2c`	Slumpmässig lastbalansering enligt principen ”två val”
6	`least-used`	Välj målet med lägst aktuell belastning
7	`random`	Likformigt slumpmässigt val (dubbletter tas bort)
8	`strict-random`	Slumpmässigt val utan att ta bort upprepningar 🎲
9	`cost-optimized`	Minimera $ per begäran utifrån katalogpriser i realtid 💸
10	`headroom`	Välj målet med störst återstående kvot
11	`quota-weighted`	Hoppa över konton med förbrukad kvot och välj sedan proportionellt mot återstående kvot ÷ pågående belastning — befintliga konversationer förblir låsta ⚖️
12	`reset-window`	Föredra målet vars kvotfönster återställs först
13	`reset-aware`	Rangordna efter kvotens återställningstid — korta fönster först 📊
14	`context-relay`	Överför kontext mellan mål för långa konversationer 🧠
15	`context-optimized`	Välj det mål som passar bäst för den aktuella kontextstorleken
16	`cache-optimized`	Lås varje återanvändbart promptprefix till samma konto — maximera träffar i promptcachen 🎯
17	`lkgp`	Senast kända fungerande väg — låser till den senast fungerande leverantören och använder därefter reservregler
18	`auto`	Poängsättning i realtid utifrån 16 faktorer för varje anslutning 🤖
19	`fusion`	Sprider begäran till en panel av modeller + en bedömare sammanställer ett enda svar 🧬
20	`pipeline`	Kedjar steg — varje måls utdata matas till nästa mål 🔗

_{Auto-Combo-motorn poängsätter varje kandidat utifrån **16 faktorer** (hälsa, kvot, kostnad, latens, uppgiftslämplighet, kvalitet, sessionstillgänglighet …) – se [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Motståndskraft är inbyggd (3 oberoende lager)

OmniRoutes motståndskraft – 3 oberoende, självläkande lager, rätt lager för rätt fel. Lager 1: kretsbrytare för leverantör (hela leverantören): utlöses endast vid 408/5xx, tröskelvärden OAuth 8× / API-nyckel 12× / lokal 2×, återställs efter 60s/30s/15s till en HALF-OPEN-sondering, behovsstyrd återställning; medan den är OPEN dirigerar kombinationen om till nästa leverantör. Lager 2: anslutningens nedkylningsperiod (en nyckel/ett konto): basvärde 5s för OAuth / 3s för API-nyckel, exponentiell ×2-backoff med skydd mot samtidiga anropsstormar, 429 respekterar Retry-After, ett lyckat anrop rensar all felstatus; en nyckel under nedkylning hoppas över medan övriga nycklar fortsätter hantera anrop. Lager 3: modellspärr (en modell): modellspecifik 429, lokal 404 eller nekanden på grund av läge spärrar endast den modellen – aldrig hela anslutningen. Slutgiltiga tillstånd (avstängd, utgången, krediter förbrukade) hanteras av operatören, inte med nedkylningsperioder.

_{📖 [Auto-Combo-motorn](docs/routing/AUTO-COMBO.md) · [Guide till motståndskraft](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Vad som skiljer OmniRoute från mängden

_{📊 Fullständig metodbeskrivning och detaljinformation per funktion jämfört med 9router, OpenRouter, CLIProxyAPI och LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Stöd OmniRoute OmniRoute är MIT-licensierat och underhålls öppet. Om det sparar tid eller pengar åt dig kan du hjälpa till att hålla det oberoende — välj det alternativ som passar dig. Sponsring påverkar aldrig routningsprioriteten; den ger synlighet, inte högre rankning.

⭐ Stjärnmärk kodförrådet	Kostnadsfritt — hjälper verkligen synligheten	Stjärnmärk OmniRoute
🐙 GitHub Sponsors	Engångsbidrag eller månadsvis · ingen plattformsavgift	github.com/sponsors/diegosouzapw
☕ Ko-fi	Snabbt engångsbidrag, ingen registrering krävs för givaren	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Liten, informell gest	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Återkommande · ideellt · öppen källkod	liberapay.com/diegosouzapw
🇧🇷 PIX (Brasilien)	Omedelbart, utan avgifter	nyckel och QR-kod nedan
₿ Kryptovaluta	BTC · ETH · USDT-TRC20 · USDC-Solana	adresser nedan

**🇧🇷 PIX** — omedelbart, utan avgifter (Brasilien) OmniRoutes QR-kod för PIX

Nyckel (slumpmässig): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia-e-cola: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Kryptovaluta — BTC · ETH · USDT-TRC20 · USDC-Solana (klicka för att expandera)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Skicka varje valuta endast via det nätverk som visas — om du skickar via fel nätverk kan pengarna gå förlorade.}

🐛 Hittat ett fel eller har du synpunkter? Starta en [diskussion](https://github.com/diegosouzapw/OmniRoute/discussions).

Information för utvecklare: Projektet kan generera en lokal .env-fil under npm install/postinstall för att underlätta för utvecklare. Den här filen ignoreras avsiktligt via .gitignore (se .gitignore) och får aldrig checkas in — om den av misstag checkas in ska alla exponerade hemligheter bytas ut och filen tas bort från historiken. Se docs/DEVELOPER-ENVIRONMENT.md för vägledning om hantering av lokala miljöfiler och hemligheter.

## 📡 OmniRoute Radar Den huvudsakliga rubriken för gratisnivån är fortfarande **~1,62 md tokens/månad** från den dokumenterade, pooldeduplicerade katalogen ovan. Tillfälliga registreringskrediter från leverantörer kan separat höja den första månaden till **~2,22 md**. Radar är ett valfritt, signerat katalogöverlägg för dem som vill ha mer aktuell tillgänglighet för gratismodeller mellan OmniRoute-versioner; communitykatalogen och alla befintliga kostnadsfria funktioner förblir gratis. Supportrar kan få tillgång till livekatalogen och ytterligare leverantörsmöjligheter. Dess separata, föränderliga tak är **högst cirka 3 md tokens/månad**, beroende på leverantörernas tillgänglighet. Detta tak är ingen garanti: leverantörer kan när som helst ändra kvoter, behörighetskrav, modeller eller regioner. Radar är frivilligt och använder endast GET. OmniRoute-klienten laddar inte upp prompter, trafik, leverantörs- konfiguration, användningstelemetri eller lokal status för avfärdade meddelanden. Läs mer om behörighetskraven och den aktuella katalogen på **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Nyheter

> Senaste höjdpunkterna från **v3.8.20 → v3.8.54**. Fullständig historik finns i [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ Routning med `quota-weighted`** — den 20:e kombostrategin hoppar över uttömda konton och väljer sedan bland de återstående i proportion till återstående kvot ÷ pågående belastning, samtidigt som befintliga konversationer förblir bundna. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Huvudlöst läge** — `omniroute serve --headless` (eller `OMNIROUTE_HEADLESS=1`) kör endast proxy-motorn för `/v1/*`, medan instrumentpanelen och dess exklusiva delsystem är avstängda. → [Huvudlöst läge](docs/guides/HEADLESS.md) - **🔎 Modellidentifiering** — `/v1/models` filtrerar efter funktion, kontext, typ och text, och `POST /v1/models/query` returnerar en kort deterministisk lista med samma synlighet per nyckel. → [API-referens](docs/reference/API_REFERENCE.md) - **🔑 Routningskontroll per nyckel** — bind en API-nyckel till en modell eller kombination med `forcedModel`, och lägg till eller ta bort en nyckels modeller och kombinationer atomärt (`/api/keys/{id}/access`). → [API-referens](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Mer detaljerad PII-kontroll** — val per typ, upp till 20 validerade anpassade maskeringsmönster och detekteringsräknare per typ; själva maskeringen förblir valfri. → [Skyddsräcken](docs/security/GUARDRAILS.md) - **🌍 67 språk** — instrumentpanel, dokumentationsspeglar och CLI, där `npm run i18n:add-locale` lägger till ett språk överallt med ett enda kommando. → [i18n-guide](docs/guides/I18N.md) - **🎛️ OmniConductor** — inkommande A2A-delegering till din agentflotta, Conductor-färdigheter på Agent Card och en panel i instrumentpanelen med Faro push-to-talk-röstchatt. → [A2A-server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptiv åtkomstkontroll och överbelastningsskydd** — tunga chattförfrågningar köas i stället för att ge 503, med atomiska rullande RPM-leasingavtal per anslutning. → [Resiliensguide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonisk ordning för `/v1/models`** — ett sammanhängande leverantörsgrupperat block per leverantör (kombinationer först), stabilt för alla katalogkällor. → [API-referens](docs/reference/API_REFERENCE.md) - **🗜️ Härdning av komprimering** — inflationsskydd aktiverat som standard, Caveman-paket för DE / FR / JA + kinesiska (wényán), RTK-filter för Gradle och .NET. → [Komprimering](docs/compression/COMPRESSION_ENGINES.md) - **💸 Ärlig kostnad för fast pris** — prenumerations- och kodplansleverantörer visas som **$0** i kostnadsanalysen; budget, kvot och routning fortsätter att uppskattas. → [API-referens](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share-routning** — fördelar ett delat kontos kvot rättvist mellan poolade nycklar och utnyttjar resurserna effektivt genom att låna ut inaktiva delar. → [Resiliensguide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 CLI-/agentkonfiguration med ett kommando** — 15 registrerade `setup-*`-kommandon; `omniroute run` startar 7 CLI:er (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` stöder 11 mål med en interaktiv leverantörs- och modellväljare samt favoriter per kontext. → [CLI-integrationer](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Fjärrläge** — styr en fjärransluten OmniRoute med begränsade tokens (`connect` / `contexts` / `tokens`) samt en `antigravity`-hjälpfunktion för OAuth vid VPS-installationer. → [Fjärrläge](docs/guides/REMOTE-MODE.md) - **🧭 Smartare automatisk routning** — `auto/:`-kombinationer, **Fusion** (modellpanel + bedömare), uppgiftsmedveten routning och åsidosättningar per förfrågan för modell, läge och USD-budget. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Modulär komprimering** — 12 kombinerbara motorer + Compression Studios: LLMLingua-2, Ultra i två nivåer, omniglyph, trohetskontroll per steg, GCF v3.2 och en editor med drag-and-drop-omordning. → [Komprimering](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparent MITM-dekryptering (TPROXY)** — fångar upp CLI:er som ignorerar proxy-miljövariabler, med ett CA-certifikat per SNI samt installerare för trust stores. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Kostnadstelemetri överallt** — `X-OmniRoute-*`-headers för kostnad/användning på alla endpoints, en header för besparingar från cache-träffar och USD-utgiftskvoter per nyckel. → [API-referens](docs/reference/API_REFERENCE.md) - **🧠 Minne under din kontroll** — avstängt som standard, opt-in-int8-vektorkvantisering + typad avklingning samt `x-omniroute-no-memory` per förfrågan. → [Minne](docs/frameworks/MEMORY.md) - **🛡️ Säkerhet** — skydd mot promptinjektion på varje LLM-rutt (red-team-testsvit), valfritt skydd för maskering av autentiseringsuppgifter (redigerar läckta API-nycklar/hemligheter i båda riktningarna), kostnadsfri webbsökning i DuckDuckGo som sista utväg samt en valfri OIDC-inloggningsspärr för instrumentpanelen (lösenordsinloggning är alltid tillgänglig). → [Skyddsräcken](docs/security/GUARDRAILS.md) - **🖼️ Nya endpoints** — `/v1/ocr` (Mistral OCR) och `/v1/audio/translations` (Whisper-liknande) kompletterar medieytan. → [API-referens](docs/reference/API_REFERENCE.md) - **🎨 Bild-, video- och ljudgenerering** — ett API för medier: xAI Grok Imagine och Novita AI-video, ComfyUI, Magnific, Adobe Firefly, Segmind samt talleverantörer som ElevenLabs. → [API-referens](docs/reference/API_REFERENCE.md) - **🌍 Driftsättning och drift** — reverse-proxy-`basePath`, automatisk identifiering av webbläsarspråk, enhetsspårning per nyckel, root-lös MITM-trust och zh-TW-lokalisering. → [Miljö](docs/reference/ENVIRONMENT.md) - **🤝 Fler leverantörer och agenter** — molnagenter (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) med webbläsar- och OAuth-inloggning, förstaklasskort för Ollama, Claude Opus 5 och Sonnet 5, officiellt Kimi-samarbete (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI … samt en uppdaterad **388-leverantörskatalog**. → [Leverantörer](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparens i routningen** — varje svar innehåller en `X-OmniRoute-Decision`-header som anger strategin, leverantören och latensen som hanterade det, en ny `cache-optimized`-kombostrategi samt faktorn `cacheAffinity` i Auto-Combo som dirigerar upprepade förfrågningar tillbaka till anslutningen som innehåller det cachade prefixet, och en skrivskyddad endpoint på `/v1/auto-combo/{channel}/candidates` visar den aktuella kandidatpoolen för en `auto/*`-kanal. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokal prestanda och infrastruktur** — Redis lokalt med ett klick, relädistributörer för Cloudflare Workers / Deno Deploy, Bifrost och Mux som övervakade inbäddade tjänster. → [Inbäddade tjänster](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Ingår också** — pluginramverk och marknadsplats, ramverk för Omni-/Agent-/GitHub-färdigheter, Obsidian-valvintegrering (22 MCP-verktyg), OpenAI-kompatibla Batch- och Files-API:er, semantisk svarscache, spelifiering med topplistor, ACP-agentidentifiering (15 inbyggda agenter), schemalagd loggexport till BigQuery, parallell `auto/chaos`-fan-out med flera modeller, en Telegram-botbrygga, en versionshanterare i appen och LMArena-ELO-rankningar av kostnadsfria leverantörer. → [Dokumentation](docs/README.md)

## 🤖 Kompatibla CLI:er & Kodningsagenter > En konfiguration — `http://localhost:20128/v1` — och **alla** AI IDE:er eller CLI:er körs på gratis & lågkostnadsmodeller.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ fungerar även med · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · alla OpenAI-kompatibla verktyg

_{📖 Verktygsspecifik installation för alla 39 verktyg (28 CLI Code's + 11 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode-plugin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Starta valfritt stödd CLI via OmniRoute med ett enda kommando** — inga konfigurationsfiler skrivs, uppgifter injiceras per process, Qwen/Gemini får ett tillfälligt isolerat hem: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # Eller välj leverantör+modell interaktivt och skriv verktygets egen konfiguration: omniroute configure codex # även: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Varje kommando respekterar den aktiva fjärrkontexten (`omniroute connect `), `--dry-run` visar exakt miljö/argument utan att köra, och `--api-key-env NAME` håller hemligheter borta från din shellhistorik. → [CLI-integrationer](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 AI-leverantörer — 153 katalogmarkerade som gratis

> **388 registrerade leverantörer** i de kanoniska samlingarna för chatt, media, sökning, lokalt, molnagenter och system, inklusive **153 med `hasFree: true`-metadata för upptäckt**. Chattmodellregistret omfattar **239 leverantörer / 3 059 unika leverantör-modell-par / 1 475 råa modell-ID:n**; den separata katalogen för gratisbudgetar har **471 rader per modell**, **34 återkommande pooler** och **52 återkommande eller nyckellösa leverantörer som är gratis för alltid**. Dessa är avsiktligt olika nämnare; definitioner och pooldeduplicerade beräkningar finns i [Leverantörsreferensen](docs/reference/PROVIDER_REFERENCE.md) och [Gratisnivåer](docs/reference/FREE_TIERS.md).

### 🏢 Alla större labb — via en enda endpoint

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…och över 350 till — varje ikon hämtas live från dashboardens leverantörskatalog. 📖 [Leverantörsreferens](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Gratis för alltid — $0, inget kort

OpenCode Zen _{DeepSeek V4, Nemotron 3 Ingen tokenbegränsning}	Kilo Code _{Automatisk router, Tencent Hy3 Gratis för alltid}	Requesty _{GPT-OSS 120B, Nemotron Gratis för alltid}	SiliconFlow _{DeepSeek V3.2 / R1 Gratisnivå}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Gratis för alltid}	Baidu ERNIE _{ERNIE 4.0 Gratis för alltid}
Qoder AI _{Qwen3-Max, Kimi-K2 Obegränsat GRATIS}	Pollinations _{GPT, Llama, Claude Ingen nyckel krävs}	Cloudflare AI _{Över 50 modeller 10K neuroner/dag}	NVIDIA NIM _{GLM, MiniMax ~40 RPM gratis}	Cerebras _{GLM 4.7, GPT-OSS Engångskredit på 5 $; kort krävs}	OpenRouter _{:free-modeller +10 $ → högre RPM}

📖 Fullständig maskinläsbar katalog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Där OmniRoute körs — var som helst

> Samma app, din maskin, dina regler. Från en global npm-installation till** din telefon** via Termux.

Plattform	Installera	Höjdpunkter
📦 npm (global)	`npm installera -g omniroute`	Ett kommando, valfri OS
⚡ Bun (global)	`bun add -g omniroute`	Samma register tarball, snabbare installationer
🐳 Docker	`docker run … diegosouzapw/omniroute`	Flerbågar AMD64 + ARM64
🖥️ Desktop (Electron)	`npm kör elektron:bygga`	Native window + systembricka — Windows / macOS / Linux
🎩 Menyrad (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Övervakar & automatiskt uppdaterar servern — macOS
💪 ARM	native `arm64`	Raspberry Pi, ARM servrar, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Kör på din telefon , 24/7, no root
📲 PWA	"Lägg till på startskärmen"	Helskärm, offline, installeras från webbläsaren
🧩 OpenCode plugin	`@omniroute/opencode-provider`	Native OpenCode integration
🤖 VS Kod Copilot Chat	installera OmniCopilot extension	OmniRoute -modell i den inbyggda Copilot Chat-väljaren — stabil & Insiders
🛠️ Från källan	`npm installera && npm kör dev`	Hacka på den, bidra med

_{📖 [Docker Guide](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Menyfältsbricka](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Nytt: OmniRoute inuti VS Codes ursprungliga Copilot Chat

> Ingen ny sidofält, ingen ny chatt- UI - varje modell OmniRoute tjänar dyker upp direkt i**Copilot Chat modellväljare som du redan använder** . Sedan VS Code 1.122 fungerar leverantörsmodeller utan en GitHub -inloggning eller en Copilot prenumeration – agentläge, verktygsanrop och vision, gratis. Installera** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** förlängning, rikta den mot din OmniRoute server (standard är `localhost:20128`), öppna sedan Copilot Chat → modellväljare →** Hantera modeller...** →**OmniRoute** . < td align ="left">VS Code — stabil & Insiders registret < td align ="left">Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Store	Link	Fungerar med
🧩 VS Code Marketplace	Installera →
🔓 Öppna VSX
Installera →

Inifrån redigeraren: öppna** Tillägg** se, sök** "OmniRoute"** , klicka** Installera** — fungerar på samma sätt i båda butikerna. Källa, nummer och publiceringsrunbook live på [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Code Copilot Chattguide](docs/guides/VSCODE-COPILOT.md) — inställning, vad väljaren visar, instrumentpanel-i-en-flik, felsökning av}

### 🎩 Nytt: OmniRouteTray — din gateway, som bor i menyraden

> `omniroute serve` är lyckligast när den alltid är på.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** förvandlar det till en ställ-och-glöm-menyradsapp för macOS: den startar servern, håller den vid liv vid omstarter, uppdaterar den på plats och lägger din token-budget ett klick bort —** inget terminalfönster lämnat öppet, ingen `npm install -g omniroute` att vara barnvakt.** Byggd med [Tauri v2](https://v2.tauri.app/) (en Rust-kärna storleken på ett avrundningsfel), levererar den sin egen signerade Node 24-körtid och hanterar en appägd OmniRoute installation, så den bekämpar aldrig din globala `node`/`bun`. Det** delar din befintliga `~/.omniroute/` -konfiguration och databas** — så det är samma OmniRoute som du redan kör, bara med en hatt på. 🎩

Vad det gör	Hur
🟢 Övervakar servern	Spawns `omniroute serve` , antar en redan körande instans istället för att duplicera den
📊 Liveanvändning i korthet	Leverantörskvotstaplar, Claude session/weekly gränser med återställda nedräkningar, 30-dagars kostnadsuppdelning
🔄 Automatiska uppdateringar på plats	Etappinstallation, atomärt byte, återställning vid fel — alltid på den senaste versionen
🚀 Starta vid inloggning	Valfri start vid inloggning; Endast fack, ingen dockningsikon
🩺 Doktor & loggar	Diagnostik med ett klick och serverloggåtkomst

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Föredrar du en nedladdning? Ta den senaste .dmg från
Släpper . Källa, frågor och bygga
docs live på zoispag/omniroute-tray.

💛 Ett community-projekt av @zoispag — inte en officiell OmniRoute release.}

## 🔒 Privat och lokal i första hand

_{📖 [Auktorisering](docs/architecture/AUTHZ_GUIDE.md) · [Skyddsräcken](docs/security/GUARDRAILS.md) · [Efterlevnad](docs/security/COMPLIANCE.md)}

## 🔌 Fullständigt CLI + A2A & MCP

> Utöver servern är OmniRoute en **fullständig kommandoradscentral** med **över 80 kommandon**, samt öppna agentprotokoll så att en AI-agent kan styra den **på egen hand**. ### ⌨️ Ett riktigt CLI (inte bara `start`) ```bash omniroute # kör gateway + kontrollpanel (port 20128) omniroute chat # interaktiv TUI-chattklient (snabbkommandon: /model /combo /skill /memory) omniroute setup # guidad guide för första körningen omniroute doctor # diagnostisera leverantörer, portar och inbyggda beroenden ``` ### 🛰️ Fjärrläge — kör CLI:t här och OmniRoute på en VPS Kör du OmniRoute på en server? Styr den från din bärbara dator med **samma CLI**. Logga in en gång med en åtkomsttoken med avgränsad behörighet; därefter riktas varje kommando mot fjärrservern. ```bash omniroute connect 192.168.0.15 # lösenord → avgränsad token, sparad som en kontext omniroute models # ← körs mot FJÄRRSERVERN omniroute configure codex # ← väljer en fjärrmodell och skriver en lokal Codex-profil omniroute tokens create --name ci --scope read # skapa mer begränsade token för andra datorer omniroute contexts use default # ← växla tillbaka till den lokala servern ``` Token har behörighetsnivåerna `read` / `write` / `admin`; rutter som startar processer förblir begränsade till loopback. _{📖 [Fjärrläge](docs/guides/REMOTE-MODE.md)}

Animerad terminal som demonstrerar OmniRoute CLI — omniroute providers list, omniroute combo list och omniroute health — och växlar mellan de 89 kommandona på toppnivå: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 Anslut en agent — så styr den OmniRoute själv Exponera OmniRoute via **MCP**, **A2A**, ett **REST-API**, **webhooks** eller ett **CLI för fjärråtkomst** — valfri kapabel agent (eller din egen kod) får tillgång till hela gatewayen: routning, leverantörer, kombinationer, cache, komprimering och minne — autonomt. HTTP-ändpunkterna nedan tillhandahålls under `http://localhost:20128`.

Gränssnitt	Ändpunkt/kommando	Använd det för att
🧰 MCP (stdio)	`omniroute --mcp`	Ansluta till Claude Desktop, Cursor eller valfri MCP-klient
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP på distans — 110 verktyg, 33 behörighetsomfattningar (tillämpning är valfri), fullständig granskningslogg
📡 MCP (SSE)	`/api/mcp/sse`	Strömmande MCP-transport
🤝 A2A	`/.well-known/agent.json`	Agent-till-agent, JSON-RPC 2.0 + SSE, 6 färdigheter
🌐 REST-API	`/v1/*`	OpenAI-kompatibelt — chatt, inbäddningar, bilder, ljud, OCR
🔔 Webhooks	`/api/webhooks`	Skicka begärande- och kvothändelser till Slack, Discord, Telegram eller valfri URL
🛰️ CLI för fjärråtkomst	`omniroute connect`	Styr en fjärrinstans med åtkomsttoken med avgränsad behörighet

```bash # Ge Claude Code tillgång till hela OmniRoutes verktygsuppsättning via MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP-server](docs/frameworks/MCP-SERVER.md) · [A2A-server](docs/frameworks/A2A-SERVER.md) · [Agentprotokoll](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Spara 15–95 % tokens — automatiskt

### 📖 Så fungerar det — pipeline, arkitektur och besparingsmatematik

OmniRoute-komprimeringspipeline: en illustrativ klientbegäran på 10 000 tokens passerar genom 12 komponerbara motorer — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra och OmniGlyph — och kan nå leverantören med cirka 1 080 tokens i det dokumenterade staplade exemplet. Strukturerat innehåll skyddas av bevarandegarantier och tillförlitlighetsgrindar per steg; explicita förlustbringande eller experimentella lägen kan transformera berättigat innehåll.

Standardkombinationen kör `RTK → Caveman`. När båda verkar på samma verktygs-/kontextnyttolast ackumuleras besparingarna: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Kodblock, URL:er, JSON och strukturerade data är **alltid skyddade** av bevarandemotorn. > **Varför använda många tokens när få tokens räcker?** Varje begäran passerar genom OmniRoutes komprimeringspipeline **transparent** — inga klientändringar krävs. Den består nu av en **stack med 12 komponerbara motorer** som körs i ordning och kan kombineras fritt per routningskombination — med idéer från [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) och [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Stacken med 12 motorer Motorerna körs i pipelineordning; var och en kan aktiveras eller inaktiveras oberoende och konfigureras per kombination:

#	Motor	Vad den gör
1	Session-Dedup	Tar bort innehåll som upprepas mellan turer (innehållsadresserat, mellan turer)
2	CCR	Arkiverar stora block bakom hämtningsmarkörer som hämtas vid behov
3	Lite	Borttagning av blanksteg och trimning av bild-URL:er (latenslätt baslinje)
4	RTK	Smart filtrering, deduplicering och trunkering av verktygsresultat (kommandomedveten)
5	Responses Tool Output	Förlustfri förstahandskomprimering av JSON samt begränsad diagnostikkomprimering för shell-/patch-/sök-/byggutdata (Responses API)
6	Headroom	Förlustfri tabellkomprimering av JSON-matriser (~30 %) via en medföljande GCF-codec
7	Relevance	Extraktiv meningsbedömning utifrån den senaste användarfrågan
8	Caveman	Regelbaserad prosa-komprimering (~65–75 % av utdata)
9	Aggressive	Sammanfattning och progressiv åldring av äldre turer
10	LLMLingua-2	ML-baserad semantisk gallring via MobileBERT ONNX — kodsäker, asynkron
11	Ultra	Heuristisk tokengallring med ett valfritt småmodellsskikt (SLM)
12	OmniGlyph	Experimentell kontext-som-bild-kodning för uppmätt Claude Fable 5 på den direkta Anthropic-tråden; GPT 5.6-transformatorer förblir stängda vid fel i väntan på leverantörskvitton. Fyra komprimeringsprofiler (aggressiv standard, balanserad, kodsäker, oförändrad) (mest aggressiv; opt-in)

Kodblock, URL:er och strukturerade data bevaras **alltid** byte-exakt. **Förinställningar med ett klick** kombinerar motorerna:

Läge	Besparing	Bäst för
🪶 Lite	~15 %	Säkert standardläge som alltid är aktivt
🪨 Standard (Caveman)	~30 %	Daglig kodning
⚡ Aggressive	~50 %	Långa sessioner med många verktyg
🔥 Ultra	~75 %	Maximala besparingar
🧰 RTK	60–90 %	Shell-/test-/bygg-/git-utdata
🔗 Staplade (RTK → Caveman)	78–95 %	Blandade promptar och verktygsloggar

**Verkligt exempel — Standardläge:** > **Före (69 tokens):** _"Anledningen till att din React-komponent renderas om är troligen att du skapar en ny objektreferens vid varje renderingscykel. När du skickar ett inline-objekt som prop ser Reacts ytliga jämförelse det som ett annat objekt varje gång, vilket utlöser en omrendering. Jag rekommenderar att du använder useMemo för att memorera objektet."_ > > **Efter (19 tokens):** _"Ny objektreferens vid varje rendering. Inline-objekt som prop = ny referens = omrendering. Omslut i useMemo."_ > > **Samma svar. 72 % färre tokens. Ingen förlust av precision.** ✅ **PT-BR-exempel — [Troglodita](https://github.com/leninejunior/troglodita)-läge:** > **Före (42 tokens):** _"Problemet är att komponenten renderas om eftersom en ny objektreferens skapas i varje renderingscykel. Jag rekommenderar att du använder useMemo."_ > > **Efter (12 tokens):** _"Renderas om: ny ref i varje cykel (inline-objekt återskapas). Använd `useMemo`."_ > > **Samma svar. ~70 % färre tokens. Teknisk precision intakt.** ✅
### 🎚️ Bortom motorerna — utdatasstilar, den adaptiva ratten och kontroll per begäran De 12 motorerna ovan minskar det som går **in**. Ytterligare tre lager formar **hur**, **när** och vad som kommer **ut**: - **🪄 Utdatasstilar** _(styrning längs utdataaxeln)_ — infogar deterministiska, cache-säkra instruktioner för att forma svar; kan kombineras, var och en med intensiteten `lite` / `full` / `ultra`. Att lägga till en stil är en rad i registret: - **Kortfattad prosa** — ta bort utfyllnad / artiklar / garderingar; behåll det tekniska innehållet exakt. - **Mindre kod** — "lat seniorutvecklare" enligt YAGNI: minsta fungerande ändring, ingen oönskad ställningskod. - **Hästsvans (lat seniorutvecklare)** — klättra på YAGNI-stegen, åtgärda grundorsaken, minsta fungerande diff. - **Jag har ADHD (handlingsorienterad)** — nästa åtgärd först, numrerade steg, ett konkret nästa steg, ingen inledning. - **Kortfattad CJK (文言)** — ultrakort stil på klassisk kinesiska (lokaliseringsstyrd till `zh`). - **🎯 Adaptiv kontextbudget** _(ratten)_ — i stället för ett enda tröskelvärde för på/av eskaleras de billigaste motorerna med minst informationsförlust endast så långt som krävs för att **rymmas i modellens kontextfönster**. Policy: `reserve-output` (standard, modellmedveten) · `percentage` · `absolute`. Läge: `floor` (garanterar att det ryms) · `replace-autotrigger` (ditt uttryckliga val vinner) · `off` (äldre tröskel). - **🎛️ Var komprimering avgörs** _(prioritet, hög → låg)_ — `x-omniroute-compression`-header per begäran › åsidosättning för routingkombination › aktiv namngiven profil › adaptiv / automatisk utlösare › standardinställning i panelen › av. Den tillämpade planen återspeglas i svarshuvudet `X-OmniRoute-Compression: ; source=`. Utlös automatiskt efter tokentröskel, aktivera den adaptiva ratten, fäst en namngiven profil, ange en engångsinställning per begäran eller tilldela en pipeline per routingkombination — beroende på vad som passar arbetsbelastningen. En valfri offline-**utvärderingsmiljö** (`npm run eval:compression`) bedömer trohet kontra besparingar på en fixerad korpus innan du lanserar en ändring. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Snabbstart

**1) Installera och kör** ```bash npm install -g omniroute omniroute ``` > 💡 Ser du `npm warn ERESOLVE` eller varningar om peer-beroenden? [De är ofarliga](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Använder du npm 11 eller senare?** npm kan blockera pakets livscykelskript om de inte tillåts. OmniRoutes `postinstall` (`node scripts/build/postinstall.mjs`) krävs för att förbereda dess inbyggda runtimefiler. Tillåt paketen som anges i npms varning när du installerar globalt. För den paketuppsättning som rapporteras av OmniRoute 3.8.54: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Om du vill återanvända denna tillåtelselista för framtida globala installationer konfigurerar du den en gång och installerar sedan normalt: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Beroendelistan kan ändras mellan versioner. Om npm rapporterar en annan lista använder du paketnamnen från den varningen. Att tillåta ett paket gör att dess installationsskript får köras. > **Använder du Gemini Web eller en annan leverantör av webbkakor?** npm-paketet innehåller > Playwright men inte dess Chromium-binär. Se anmärkningen om > [konfiguration av Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > innan du gör den första begäran till en webbleverantör. Instrumentpanelen finns på `http://localhost:20128` · API:t finns på `http://localhost:20128/v1`. **2) Anslut en kvalificerad leverantör med ditt eget konto** Instrumentpanel → **Leverantörer** → välj en leverantör vars aktuella villkor och kvot passar ditt användningsfall → lägg till dess API-nyckel eller slutför dess kontoflöde. Gratisnivåer kan kräva registrering, godkännande eller en betalningsmetod. Läs [guiden om gratisnivåer](docs/getting-started/FREE-TIERS-GUIDE.md); tillgänglighet utan nyckel garanteras inte, och leverantörer märkta med `tos: avoid` utesluts från `auto` som standard. **3) Ange ditt kodverktyg** ```txt Bas-URL: http://localhost:20128/v1 API-nyckel: [kopiera från Instrumentpanel → Slutpunkter] Modell: auto (dirigerar mellan kvalificerade anslutningar — eller välj leverantör/modell) ``` **4) Kontrollera att det fungerar** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Du bör se dina anslutna modeller listade. 🎉 Det var allt — börja koda, så dirigerar och återkopplar OmniRoute automatiskt åt dig. Om din klient inte kan skicka anpassade headers exponerar OmniRoute även tokeniserade kompatibilitetsalias: ```txt OpenAI-katalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI-modeller: http://localhost:20128/vscode/YOUR_KEY/models OpenAI-chatt: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI-svar: http://localhost:20128/vscode/YOUR_KEY/responses Ollama-chatt: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama-taggar: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Använd dessa endast för klienter som inte kan bifoga `Authorization: Bearer ...`. Header-autentisering är fortfarande det rekommenderade läget.
## 📦 Fler installationsmetoder — Docker, källkod, pnpm, Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` följer den högsta **publicerade** stabila SemVer-versionen. Den följer inte git `main`. Lås till `:X.Y.Z` för GitOps. Se [Docker-utgivningskanaler](docs/guides/DOCKER_GUIDE.md#release-channels). Avbildningen låser **`OMNIROUTE_MEMORY_MB=1024`**. Det räcker för kontrollpanelen och enklare chatt. **Kodningsagenter** (`POST /v1/responses` från Claude Code, Codex, Grok, …) behöver en mycket större V8-heap, annars får processen ett `FATAL ERROR` vid cirka 12 GiB med två överlappande långa kontexter. Dimensionera containern större än heapen (inbyggda buffertar ligger utanför V8): | Arbetsbelastning | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) | | ----------------------------------- | ------------------------------- | ---------------------- | | Kontrollpanel/enklare chatt | `1024` (avbildningens standard) | ≥2 g | | En kodningsagent | `8192` | ≥10 g | | Två samtidiga långa `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` Fullständig tabell: [Docker-guide — RAM vid körning](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Docker-kanal för förhandsversioner:** `diegosouzapw/omniroute:next` och > `diegosouzapw/omniroute:next-web` följer den aktuella standardgrenen `release/v*`. > Dessa föränderliga taggar är endast avsedda för att testa ännu ej utgivna korrigeringar och > **stöds inte för produktion**. Se > [Docker-utgivningskanaler](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standardinstallation med `bun install` och global installation (`bun install -g omniroute`) stöds via detektering av Bun-körmiljön: - **Inbyggd `bun:sqlite`**: OmniRoute använder Buns inbyggda `bun:sqlite`-drivrutin när det körs under Bun och återgår till `better-sqlite3` på Node.js eller `sql.js`. - **Automatiskt val av Webpack-paketerare vid utveckling**: Utvecklingsläget (`bun run dev`) identifierar automatiskt Bun och inaktiverar Turbopack till förmån för Webpack för att förhindra inkompatibilitet med inbyggda V8-bindningar. Produktionsbyggen (`bun run build`) följer `OMNIROUTE_USE_TURBOPACK` exakt som på Node: Turbopack som standard, `OMNIROUTE_USE_TURBOPACK=0` för att bygga med Webpack (`Dockerfile.bun` exponerar detta som ett `--build-arg`). - **Dedikerad Dockerfile för Bun**: `Dockerfile.bun` i flera steg för produktionsdistributioner med inbyggd Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Installera och kör med Bun bun install bun run dev ``` **🛠️ Från källkod** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux (AUR)** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix (Flake)** ```bash # Med Nix flakes nix develop npm run dev # Eller med devbox devbox run npm run dev ``` 📖 [Docker-guide](docs/guides/DOCKER_GUIDE.md) — Compose-profiler, Caddy HTTPS, Cloudflare-tunnlar. **🦭 Podman** ```bash # 1. Förbered datakatalogen som ska bind-monteras mkdir -p data # 2. Endast Linux + lokal rootless Podman (aldrig en fjärrklient för Podman Machine): podman unshare chown 1000:1000 ./data # 3. Ange körmiljötips, bygg den lokala Compose-avbildningen och starta echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` På macOS eller Windows använder Podman en fjärransluten Podman Machine: hoppa över `podman unshare` och följ den [topologispecifika vägledningen för datakataloger](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Podman-guide](contrib/podman/README.md) — Compose-byggen, Podman Machine och konfiguration av Quadlet för Linux/systemd. **⚡ Snabbare/resurssnålare installation (hoppa över det inbyggda bygget)** Den inbyggda SQLite-motorn (`better-sqlite3`) är ett **valfritt** beroende, så en global installation blockeras aldrig av kompilering från källkod: den använder en förkompilerad binärfil när någon matchar din plattform/Node och återgår annars transparent till en ren JS-motor (`node:sqlite` på Node 22+, annars medföljande `sql.js` WASM) — inga byggverktyg krävs. Så här hoppar du helt över den inbyggda uppvärmningen efter installationen (CI, headless eller långsamma datorer): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 hoppar också över den ``` För de snabbaste installationerna bör du använda **pnpm** (innehållsadresserat lager + hårda länkar — se ovan). För en headless-körmiljö utan kontrollpanel använder du Docker-profilen `base` (ovan) eller [Termux-guiden](docs/guides/TERMUX_GUIDE.md). CLI-verktyget och webbkontrollpanelen tillhandahålls av samma process på en port, så det finns för närvarande inget separat paket enbart för CLI.

# 🎬 OmniRoute i praktiken

## 📹 Videoguider

_{Ögonblicksbild av panelen den 2026-10-18 · Råkatalog: YT 1.352 | TT 334 | IG 290 · Aktualitet (dagar): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 visningar}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 visningar}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 visningar}

🎬 #4 — Instagram
_{theopenstack — 692,419 visningar}

🎬 #5 — TikTok
_{migue.baena — 685,788 visningar}

**Fullständig rankning (deduplicerade kanoniska URL:er, `v > 0`, störst räckvidd):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Kanoniska mätvärden den 2026-10-18: **1.976 unika videor** · **20.220.289 kända visningar** (`v > 0`) · **1.210 kanaler/profiler per nätverk**. Råpanelen innehåller 1.976 rader (YouTube 1.352 = 740 långa videor + 612 Shorts · TikTok 334 · Instagram 290); inga dubbletter återstod efter normaliseringen utifrån den kanoniska URL:en, där det högsta antalet per video behålls. Insamlingen från YouTube är fryst sedan 2026-10-13 (API-kvoten var förbrukad från 14 till 18/10) och TikTok/Instagram sedan 2026-09-02 (inga insamlingskrediter); 76 videor saknar fortfarande antal visningar. > 🎬 **Har du gjort en video om OmniRoute?** Öppna ett [ärende](https://github.com/diegosouzapw/OmniRoute/issues/new) eller en [diskussion](https://github.com/diegosouzapw/OmniRoute/discussions) med länken — så lyfter vi fram den här.

# 📧 Community och hjälp > Allt på ett ställe — följ underhållaren, chatta med communityn eller öppna ett ärende. | Kanal | Var/hur | | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — följ underhållaren | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — följ för releaser och tips | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Globalt** | [gå med i gruppen](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brasilien** | [gå med i gruppen](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Webbplats** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute-community (gratis)** | [StHub-portalen](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Källkod** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Rapportera ett fel** | [skapa ett ärende](https://github.com/diegosouzapw/OmniRoute/issues) — bifoga utdata från `npm run system-info` | | 🤝 **Bidra** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Förgrenings- och releasemodell](docs/ops/BRANCHING_MODEL.md) · välj ett `good first issue` | | 💚 **Stöd projektet** | [Sätt att stödja ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Teknikstack

Lager	Teknik
Körmiljö	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Språk	TypeScript 6.0 — 100 % TypeScript i `src/` och `open-sse/` (ingen `any` i kärnan sedan v2.0)
Ramverk	Next.js 16 + React 19 + Tailwind CSS 4
Databas	better-sqlite3 (SQLite, WAL-journalföring) + LowDB (äldre JSON) — 147 domänmoduler, 233 migreringar
Minne	SQLite FTS5-fulltext + int8-kvantiserade vektorinbäddningar, typad avklingning
Scheman	Zod 4 — validering av MCP-verktygens indata/utdata + API-kontrakt
Protokoll	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Strömning	Server-Sent Events (SSE) + WebSocket-brygga (`/v1/ws`)
Komprimering	Pipeline med 12 motorer — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentisering & säkerhet	OAuth 2.0 (PKCE) + JWT + API-nycklar + MCP-autentisering med omfång · AES-256-GCM i vila · DOMPurify
Förklädnad	wreq-js — JA3- / JA4-impersonering av TLS-fingeravtryck, proxy i tre nivåer
Resiliens	Kretsbrytare, exponentiell backoff, skydd mot flockbeteende, automatisk självläkning med kombinationer
Loggning	pino — strukturerade JSON-loggar med kontext för begäranden
Testning	Node.js-testkörning + Vitest — över 60 000 statiska testdeklarationer i över 8 400 spårade testfiler (enhets-, integrations-, E2E-, säkerhets- och ekosystemtester)
Plattformar	Desktop (Electron) · Android (Termux) · PWA (valfri webbläsare)
CI/CD	GitHub Actions — automatisk npm-publicering + Docker Hub vid utgåvor
Länkar	Webbplats · npm · Docker Hub

## 📖 Dokumentation

### 📘 Kom igång

Dokument	Beskrivning
Användarhandbok	Leverantörer, kombinationer, CLI-integrering, driftsättning
Installationsguide	Fullständiga installationsmetoder, konfigurationer av CLI-verktyg, protokollkonfiguration, justering av tidsgränser
Guide för CLI-verktyg	Verktygsspecifik konfiguration för Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Fjärrläge	Styr en fjärransluten OmniRoute (VPS) från din CLI på den bärbara datorn via åtkomsttoken med begränsad omfattning
Claude Code-konfiguration	Anslut Claude Code till OmniRoute (lokalt/fjärranslutet) med `launch` + profiler per modell
Snabbstart	Installation → anslutning → konfiguration i tre steg

### 🔧 Drift och driftsättning

Dokument	Beskrivning
Docker-guide	Docker-körning, Compose-profiler, Caddy HTTPS, tunnlar, avbildningstaggar
Podman-guide	Quadlet-systemd-integrering, podman-compose, SELinux
VM-driftsättning	Fullständig guide: konfiguration av VM + nginx + Cloudflare
Fly.io-driftsättning	Distribuera till Fly.io med beständig lagring
Termux-guide	Kör OmniRoute på Android via Termux
PWA-guide	Installation, cachning och arkitektur för progressiva webbappar
Avinstallationsguide	Fullständig borttagning för alla installationsmetoder
Miljökonfiguration	Fullständiga `.env`-variabler och referenser

### 🧠 Funktioner och arkitektur

Dokument	Beskrivning
Arkitektur	Systemarkitektur, dataflöde och interna funktioner
Komprimeringsguide	Pipeline med 7 alternativ: off / lite / standard / aggressive / ultra / RTK / stacked
RTK-komprimering	Komprimering av kommandoutdata, filter, tillit, verifiering, återställning av råutdata
Komprimeringsmotorer	Caveman, RTK, staplade pipelines, gränssnitt för instrumentpanel/API/MCP
Format för komprimeringsregler	JSON-scheman för regelpaket för Caveman- och RTK-filter
Språkpaket för komprimering	Språkidentifiering och skapande av Caveman-regelpaket
Resiliensguide	Kretsbrytare, nedkylningsperioder, kö, skydd mot flockbeteende, TLS-förfalskning
Auto-Combo-motor	Poängsättning baserad på 16 faktorer, lägespaket, självläkning
Proxyguide	Proxy-system i tre nivåer, 1proxy-marknadsplats, CRUD för register
Kostnadsfria nivåer	Konsoliderad katalog: 34 dokumenterade återkommande pooler / 465 katalogiserade poster på kostnadsfria nivåer
Funktionsgalleri	Visuell genomgång av instrumentpanelen med skärmbilder
Dokumentation av kodbasen	Ny börjarvänlig genomgång av kodbasen

### 🤖 Protokoll och API:er

Dokument	Beskrivning
API-referens	Alla slutpunkter med exempel
OpenAPI-specifikation	OpenAPI 3.0-specifikation
MCP-server	110 MCP-verktyg, IDE-konfigurationer, Python/TS/Go-klienter
Guide för MCP-server	MCP-installation, transportmekanismer och verktygsreferens
A2A-server	JSON-RPC 2.0-protokoll, färdigheter, strömning, aktivitetshantering
Guide för A2A-server	A2A-agentkort, aktiviteter, färdigheter och strömning

### 📋 Projekt och kvalitet

Dokument	Beskrivning
Bidra	Utvecklingskonfiguration och riktlinjer
Förgrenings- och utgivningsmodell	Vart PR:er riktas (`release/*`), vad `main` och taggar betyder
Ändringslogg	Fullständig utgivningshistorik per version
Säkerhetspolicy	Rapportering av sårbarheter och säkerhetsrutiner
i18n-guide	Stöd för 67 språk, arbetsflöde för översättning, RTL
Checklista för utgivning	Valideringssteg före utgivning
Täckningsplan	Strategi för testtäckning av över 60 000 statiska testdeklarationer i över 8 400 spårade testfiler

# ⭐ Främsta bidragsgivare > OmniRoute formas av en engagerad öppen källkod-gemenskap. Dessa personer har gjort enastående insatser som direkt påverkar projektets kvalitet, stabilitet och räckvidd. **Tack.** ### Externa bidragsgivare efter sammanfogade pull requests

Placering	Bidragsgivare	Sammanfogade PR:er	~Ändrade rader
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{Inventeringen genomfördes 2026-11-03 03:01:19 UTC med aktuell release/v3.8.53-spets 05bc048d6c. Den paginerade GitHub GraphQL-inventeringen innehåller 9 947 sammanfogade PR:er: 4 130 av arkivägaren, 240 av Dependabot, 6 av andra botar/appar och 5 571 externa PR:er från 883 unika bidragsgivare. ”Ändrade rader” är GitHub-tillägg + borttagningar och omfattar genererade filer, låsfiler, kataloger, översättningar och dokumentation; det är förändringsvolym, inte författade kodrader. 53 PR:er rapporterar GitHub-diffar på över 500 000 rader (till exempel #13399, ett enda tillägg av en provider, listar 2 347 ändrade filer), vilket blåser upp flera av totalsummorna ovan. Lika resultat rangordnas tillsammans.} ### Commits som tillskrivs GitHub

Dizzle _{🥇 418 GitHub-attribuerade commits}	Bob.Hou _{🥈 294 GitHub-attribuerade commits}	Paijo _{🥉 229 GitHub-attribuerade commits}	Paco Cartones _{🏅 222 GitHub-attribuerade commits}	backryun _{🏅 202 GitHub-attribuerade commits}	Jan Leon _{🏅 134 GitHub-attribuerade commits}
Ravi Tharuma _{🏅 126 GitHub-attribuerade commits}	Markus Hartung _{🏅 115 GitHub-attribuerade commits}	Randi _{🏅 108 GitHub-attribuerade commits}	Chris _{🏅 70 GitHub-attribuerade commits}	WebPerson _{🏅 68 GitHub-attribuerade commits}	Koosha Paridehpour _{🏅 68 GitHub-attribuerade commits}

_{Kontrollerad igen 2026-11-03 02:09:16 UTC: GitHub-attribuerade commits rapporterade av Contributors API för repots standardgren release/v3.8.53. API:et returnerade 903 identiteter (429 användare, 2 botar, 472 anonyma); denna tabell exkluderar underhållaren, botar och anonyma identiteter och behåller delade placeringar. Den skiljer sig från både rankningen ovan av mergade PR:er och Git-metadatafolkräkningen nedan.} > 🙏 Dessa bidragsgivares funktioner, buggfixar och infrastrukturförbättringar är en **central del** av det som gör OmniRoute tillförlitligt och funktionsrikt. Varje pull request, varje testfall och varje i18n-översättningsfil spelar roll. Öppen källkod byggs av människor som dem.

---
## 💖 Sponsorer

Ett varmt tack till alla som finansierar OmniRoute ur egen ficka — varje bidrag hjälper projektet att förbli kostnadsfritt, oberoende och i ständig utveckling.

Andrew _{💛 Aktiv månadssponsor}	Vlad I _{💛 Aktiv månadssponsor}	小妍儿 _{💛 Aktiv månadssponsor}	Guilherme Costa _{💛 Aktiv engångssponsor}	Henrique Iurkiv _{💛 Aktiv engångssponsor}	Somesh Ghaturle _{💛 Aktiv engångssponsor}
Kolonie AI _{💛 Tidigare engångssupporter}	Prof. Igor Morais _{💛 Tidigare engångssupporter}	Pixma _{💛 Tidigare engångssupporter}	Paco Cartones _{💛 Tidigare engångssupporter}	longtao _{💛 Tidigare engångssupporter}

_{… och andra som föredrar att förbli privata 💛} _{Offentliga GitHub-sponsorer validerades på nytt 2026-10-18 via GitHub Sponsors GraphQL API: 11 offentliga sponsorskap (6 aktiva, 5 tidigare) av totalt 14. GitHubs isActive-status avgör de aktiva etiketterna ovan; tidigare offentliga engångssupportrar fortsätter att uppmärksammas, och privata sponsorer förblir anonyma. Donationer via Ko-fi, Buy Me a Coffee, Liberapay, PIX och kryptovalutor listas inte eftersom de saknar offentliga sponsorposter.} 💖 Bli sponsor → — varje dollar hjälper OmniRoute att förbli kostnadsfritt och oberoende.

## 👥 1 000+ bidragsgivare

[![Bidragsgivare](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Granskad 2026-11-02 vid live-release/v3.8.53-tippen 1c7135e0fb (7 972 commits): 1 074 normaliserade mänskliga Git-identiteter — 759 visas som commitförfattare (inklusive underhållaren) och 315 endast i explicita Co-authored-by-trailers. Kartläggningen tillämpar .mailmap, jämför e-postadresser skiftlägesokänsligt, sammanfogar numeriska och vanliga GitHub noreply-adresser endast när de kodar samma användarnamn, utesluter 29 bot-/agent-/tjänste-/platshållaridentiteter och slår inte samman vanliga e-postadresser enbart för att deras visningsnamn matchar. Granskningen 2026-08-24 publicerade 639; när denna metod körs igen på den granskningens bas ac02c5b42f blir resultatet 619, så ökningen beror på nya bidragsgivare, inte på en mindre strikt metod.} ### Så bidrar du 1. Skapa en fork av kodförrådet 2. Skapa en gren från den **aktiva** tippen för `release/vX.Y.Z` (inte `main`) — se [Förgrenings- och versionsmodellen](docs/ops/BRANCHING_MODEL.md) 3. Skapa din funktionsgren (`git checkout -b feat/amazing-feature`) 4. Committa dina ändringar (`git commit -m 'feat: add amazing feature'`) 5. Pusha till grenen (`git push origin feat/amazing-feature`) 6. Öppna en pull request med **base = den `release/vX.Y.Z`-grenen** Se [CONTRIBUTING.md](CONTRIBUTING.md) för detaljerade riktlinjer. ### Släppa en ny version ```bash # Skapa en version — npm publish sker automatiskt VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Stjärnor

## 🌍 StarMapper

## 🙏 Tack

OmniRoute står på jättars axlar. Det började som en fork av **[9router](https://github.com/decolua/9router)** och en TypeScript-port av Go-projektet **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — och därefter inspirerades varje subsystem nedan av ett open source-projekt som var först med att nå dit. Vart och ett formade en konkret del av OmniRoute. Detta är vårt tack till dem alla. 🙏 > ⭐ antal stjärnor verifierades via GitHubs REST API den 3 november 2026 — gå och ge dessa projekt en stjärna. Antalen är en exakt ögonblicksbild från detta datum och kommer naturligtvis att förändras. ### 🧬 Arv & gateway

Projekt	⭐	Så inspirerade det OmniRoute
9router	31,861	Det ursprungliga projekt som denna fork bygger på — här utökat med multimodala API:er och en fullständig omskrivning i TypeScript.
CLIProxyAPI	57,329	Go-implementationen som inspirerade denna port till JavaScript / TypeScript.
LiteLLM	62,580	AI-gatewayen vars publika prisdataset används i vår synkronisering av kostnadsspårning och vars modell för leverantörsnormalisering informerade vår routning.
codex-chatgpt-web	15,435	MIT-källkod som anpassats till den levererade ChatGPT Web → Codex Responses-bryggan, inklusive adaptrar för webbläsarsessioner, svarsramning, användning och webbsökning.
free-claude-code	65,966	Mönster som porterats till strömningsåterställning, alias utan tänkande, reservlösning för webbsökning, gränser med glidande fönster, loggredigering och härdade startflöden.
composer-api	347	Mönster för verktygsval, utdatarestriktioner och verktygskvittering i Cursor Composer, anpassade till den inbyggda Cursor-exekveraren.
codex-multi-auth	561	Mönster för ny inloggning och rotation av refresh-token, porterade till Codex OAuth-återautentisering.
opencode-anthropic-auth	562	Claude Code-kompatibla standardvärden för transformering och beteende för billing-header generaliserades till OmniRoutes konfigurationsdrivna brygga.
grok2api-merged	2	Dess Grok-modellmappningar, fake-TypeError Statsig-generator, standardvärden för förfrågningar och enheter samt NDJSON-svarsprocessor anpassades i betydande omfattning till OmniRoutes Grok Web-exekverare.
TQZHR/grok2api	707	Den huvudsakliga transitiva kodkällan bakom grok2api-merged; dess implementationer av modeller, headers, payloads, Statsig och processor bevaras i Grok Web-arvslinjen.
chenyme/grok2api	7,874	Den underliggande MIT-källan för Grok-payloads och standardvärden för enheter, Statsig-generatorn och processorn `result.response` som förts vidare genom TQZHR och grok2api-merged.
grok2api-pro	27	En transitiv källa som grok2api-merged anger för sitt proxy-pool-lager; OmniRoute bevarar denna arvshänvisning men gör inte anspråk på att ha porterat en proxy-pool i sin avgränsade Grok Web-exekverare.
GrokProxy	52	Dess cookie-autentiserade Grok-proxy och strömningsmönster med `result.response.token` informerade OmniRoutes Grok Web-transport.
GrokBridge	5	Den ursprungliga Grok Web-implementationen konsulterades för dess design av HTTP-/webbläsaruppströms; dess direkta HTTP-sökväg härstammar från GrokProxy, så inget självständigt kodarbete anges som portning.

### 🗜️ Kontext- & tokenkomprimering — motorer

Projekt	⭐	Hur det inspirerade OmniRoute
Caveman	116,957	Projektet bakom det virala uttrycket "why use many token when few token do trick" – dess grottmänniskoaktiga filosofi driver vårt standardläge för komprimering och över 30 regler för utfyllnad/kondensering.
RTK – Rust Token Killer	85,350	Högpresterande komprimering av kommandoutdata – inspirerade vår RTK-motor, DSL:en för JSON-filter, återställning av råutdata och den staplade RTK → Caveman-pipelinen.
headroom	78,672	Reversibel kontextkomprimering (SmartCrusher) – inspirerade vår `headroom`-motor och mönstret med hämtningsmarkören `ccr`.
LLMLingua	6,797	Forskning om promptkomprimering (LLMLingua / LLMLingua-2) – inspirerade vår asynkrona, kodsäkra och fail-open-motor `llmlingua`.
llmlingua-2-js	33	JS/ONNX-portningen (MobileBERT / XLM-RoBERTa) som används som backend i arbetartråden för vår LLMLingua-motor.
Troglodita	50	PT-BR-tokenkomprimering – driver vårt pt-BR-språkpaket: reduktion av pleonasmer och borttagning av utfyllnadsord anpassad för brasiliansk portugisisk grammatik.
ponytail	182,929	Den virala YAGNI-kodarfärdigheten för "lat seniorutvecklare" – inspirerade vår less-code-utdataformat: styrning mot minsta fungerande ändring som minskar _genererad_ kod (motsvarigheten på utdatasidan till Cavemans kortfattade prosa).
i-have-adhd	59,838	Dess handlingsinriktade och ADHD-vänliga svarsstil anpassades till OmniRoutes koncisa utdataformat på fem språk.

### 🧩 Kompakta format, tokenforskning och kodmedvetna verktyg

Projekt	⭐	Hur det inspirerade OmniRoute
TOON	25,602	Token-Oriented Object Notation – dess kolumnbaserade modell med rubrik och rader formade vårt steg för tabellkomprimering.
GCF – Graph Compact Format	61	Dess kompakta grafformat och design med generiska profiler bidrog till utformningen av OmniRoutes tabellkomprimering och Headrooms codec-format.
gcf-typescript	4	MIT-implementationen i TypeScript, direkt inkluderad och utökad som Headrooms codec för generiska profiler.
token-optimizer-mcp	566	Brotli/SQLite-cache och kontextdelta per session – inspirerade vår `session-dedup`-motor.
token-savior	1,203	Komprimering av Bash-utdata och MCP-profiler – inspirerade vår disciplin för att avbryta komprimering och vår reduktion av MCP-verktygsmanifest.
token-saver	162	Innehållsmedveten komprimering av utdata per filtyp med avbrott vid fel – bekräftade vår dispatch per typ och överhoppning vid minsta vinst.
token-optimizer	2,853	"Hitta spöktokenen" – dess mönster med avlastning och återställningsbart handtag bidrog till våra tankar kring CCR-avlastning.
TokenMizer	34	En ritning för sessionsgraf och rad-deduplicering mellan turer som bidrog till utformningen av vår session-dedup.
OmniCompress	3	Kolumnbaserad JSON i Rust, innehållsadresserad hämtning och deduplicering mellan meddelanden – bekräftade vår design av motorerna `headroom`/`ccr`/`session-dedup` samt invariantet att den cache-stabila "komprimerade formen är positionsoberoende".
mcp-compressor	140	Komprimering av MCP-verktygsscheman och beskrivningar – bidrog till vår reduktion av kardinaliteten hos MCP-verktygsmanifest.
RepoMapper	218	Repo-map-rangordning i Aider-stil – bidrog till vår utforskning av repo-map och rangordning av hämtning.
quiet-shell-mcp	4	Deklarativ reduktion av skalutdata via MCP – bekräftade vår deklarativa komprimering av Bash-utdata.
ts-morph	6,222	Verktygslåda för TypeScript Compiler API – inspirerade vår parserbaserade borttagning av kommentarer som bevarar sträng-, mall- och reguljära uttryckslitteraler.

### 🧠 Minne och RAG

Projekt	⭐	Hur det inspirerade OmniRoute
Mem0	68,294	Universellt minneslager — dess proxy-som-skriv-/läsgränsmodell formade vår minnesarkitektur.
Letta (MemGPT)	25,321	Agentlösningar med tillstånd och nivåindelat minne — inspirerade vår nivåindelade modell för Context Control & Recovery (CCR).
WFGY	1,804	Taxonomin ProblemMap med 16 återkommande felmoder för RAG/LLM — det gemensamma ordförrådet i vår felsökningsguide.

### 🛰️ Trafikanalys, MITM och transparent proxy

Projekt	⭐	Hur det inspirerade OmniRoute
llm-interceptor	81	MITM-interception och analys av trafik mellan kodassistent och LLM låg till grund för de tidiga kraven på Traffic Inspector. Fyra tidigare härledda moduler — SSE-sammanslagning, konversationsnormalisering, maskering av hemligheter och sanering av headers — har ersatts av oberoende clean-room-implementationer baserade på offentliga protokollstandarder. De två ytorna för host-passthrough (`passthrough.ts` och `_internal/bypass.cjs`) är fortfarande OmniRoute-interna implementationer som klassificeras separat; de skrevs inte om som en del av den ersättningen.
ProxyBridge	6,978	Transparent proxydirigering per process — inspirerade vår krasch-säkra MITM-nedmontering, socketens inaktivitets-timeouts, processattribuering via `/proc` och TPROXY-infångning.

### 📚 Modellinformation, observerbarhet och användargränssnitt

Projekt	⭐	Hur det inspirerade OmniRoute
models.dev	7,486	Öppen databas med specifikationer, priser och funktioner för AI-modeller — synkroniseras inbyggt till vår modellkatalog.
React Flow / xyflow	38,874	Det nodbaserade grafbibliotek som driver våra realtidsvyer i Compression Studio och Combo/Routing Studio.
LangGraph	44,349	Visualiseringen av arbetsflödesgrafer i realtid i LangGraph Studio inspirerade realtidsvyn av kaskader i våra Studios.
Langfuse	36,907	Modellen för observerbarhet med trace → span → generation formade vattenfallsvisningen i vår Compression Studio.
Kiali	3,647	Observerbarhet för Istio service mesh — inspirerade våra circuit-breaker-märken och visualiseringar av felkanter i Routing/Combo Studio.
lobe-icons	2,666	Varumärkeslogotyper för AI/LLM som återger leverantörsikonerna i hela vår instrumentpanel.
flag-icons	12,499	Tillhandahåller de MIT-licensierade SVG-flaggor som används av språkvalet i README.

### 🛡️ Säkerhet

Projekt	⭐	Hur det inspirerade OmniRoute
awesome-secure-defaults	723	En kurerad lista över bibliotek som är säkra som standard och som vägleder våra säkerhetsval (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Kompletterande verktyg

Projekt	⭐	Hur det inspirerade OmniRoute
ClawRouter	6,649	Inspirerade deduplicering av förfrågningar, nödfallback utan kostnad, pluggbara Auto-Combo-strategier och flerspråkig intentklassificering.
Antigravity-Manager	32,785	Dess kontomedvetna ommappning av modeller, validering av körbara sökvägar och beteende för planetiketter låg till grund för OmniRoutes Antigravity-runtime.
vscode-antigravity-cockpit	4,852	Dess kompakta format för nedräkning till kvotåterställning inspirerade motsvarande visning av leverantörsgränser i OmniRoute.
AionUi	33,996	Dess ACP-integrationer inspirerade OmniRoutes automatiska identifiering av installerade CLI-agenter.
CodexBar	22,955	Identifierade Grok Build-kvotytan; OmniRoute verifierade och korrigerade därefter det aktiva wire-formatet oberoende.

## 📄 Licens MIT-licens – se [LICENSE](LICENSE) för mer information. ---

**[⬆ Tillbaka till toppen](#-omniroute)** · Byggt med ❤️ för den AI-gemenskap med öppen källkod. _{Skapat av Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT-licens · omniroute.online}