# 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

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

## 💰 ~1,62 md tokens/månad via kostnadsfria nivåer från tredje part

> **Använd dina egna leverantörskonton.** Detta är en uppskattad totalsumma för separata kostnadsfria nivåer från tredje part som du kan vara berättigad till, inte en tokentilldelning från OmniRoute. Registrera dig, skaffa autentiseringsuppgifter där det krävs och anslut de leverantörer du kan använda. Varje leverantör bestämmer sina egna gränser, sin tillgänglighet och sina villkor. > > Att kombinera kostnadsfria nivåer manuellt är besvärligt — dussintals SDK:er, dussintals hastighetsgränser och ingen aning om hur mycket du faktiskt har. OmniRoute katalogiserar **489 poster för kostnadsfria nivåer fördelade på 35 återkommande poolnycklar** och beräknar antalet tokens i rubriken utifrån de **17 poolerna med en publicerad positiv månadsbudget plus fem Groq-gränser per modell**, deduplicerade per delad pool. Kvoter som endast blir tillgängliga efter en regional identitetskontroll (i dag: ModelScope) visas separat, +~6M bakom regional identitetsverifiering, och räknas aldrig in i rubriken. Resultatet visas fortlöpande på kontrollpanelen (`/dashboard/free-tiers`).

OmniRoutes budgetkort för kostnadsfria nivåer: stabilt ~1,62 md kostnadsfria tokens per månad, upp till ~2,22 md under den första månaden med registreringskrediter, från 35 dokumenterade återkommande poolnycklar som omfattar 489 katalogiserade poster för kostnadsfria nivåer bakom en enda slutpunkt. Transparent matematik med deduplicering per pool — varje delad pool räknas en gång, inklusive 17 återkommande pooler med en publicerad positiv månatlig tokenbudget plus fem Groq-gränser per modell; 13 leverantörer är markerade som undvik i katalogen över villkorsrisker så att du själv kan avgöra. Budgetstapeln omfattar 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 permanent kostnadsfria leverantörer utan tokengräns som visas separat så att de aldrig blåser upp rubriksiffran. Aktuell förbrukning/återstående mängd 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 ändras i båda riktningarna** — om en leverantör avslutar en kostnadsfri nivå sjunker siffran, och om en ny tillkommer stiger den. Vi publicerar det som katalogen faktiskt beräknar, aldrig ett uppåtrundat bästa scenario.}

⭐ Stjärnmarkera repot om OMNIROUTE har hjälpt dig att spara pengar och gjort ditt arbete enklare.

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

[![Placering i stjärnhistoriken](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 gemenskapen **👋 Följ underhållaren — få information om nya leverantörer, utgåvor 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 globalt](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 [🌍 Globalt](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.52+` | | ------------------------------ | :--------------------: | :---------: | :-------------------: | | 🌐 Leverantörer | 352 | **358** | 372 | | 🧠 Unika chattmodell-ID:n | 1320 | **1374** | 1443 | | 🖼️ Modalitetsbrygga | 🆕 bild + ljud + video | ✓ | ✓ | | 📡 Radars gratiskatalog | 🆕 aktivt tillval | ✓ | ✓ | | ⚖️ Kvotmedveten schemaläggning | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kvottelemetri | 🆕 i realtid | ✓ | ✓ | | 🧰 Headless-läge | — | — | 🆕 `serve --headless` | | 🛤️ Infrastruktur för LTS-spår | — | — | 🆕 utgivningskanaler | **→ [Färdplan](ROADMAP.md) — på spåret mot `v3.9.0 LTS`**

## 🧩 Tillgängligt [![npm-version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM per månad](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-hämtningar](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron-hämtningar](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Kom igång	🚀 Snabbstart	📦 Installera	🆓 Ingen konfiguration
💡 Lär dig	💥 Löftet	🤔 Varför OmniRoute	🏆 Vad som utmärker OmniRoute
⚙️ Funktioner	🎯 Kombinationer	🌐 Leverantörer	🔌 CLI & MCP
	🗜️ Komprimering	🖥️ Var det körs	🔒 Privat
👀 Se det	🎬 I praktiken	✨ Nyheter	🤖 Kompatibla CLI:er
💚 Stöd	💚 Stöd/donera	💬 Community och hjälp	💖 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 kompatibel leverantör med ditt eget konto eller din API-nyckel och dirigera sedan ditt verktyg till localhost:20128/v1 med hjälp av en OmniRoute-API-nyckel och modellen auto. Dirigeringen beror på tillgängliga kompatibla anslutningar och leverantörernas begränsningar.

```bash # När du har anslutit en leverantör kopierar du din OmniRoute-nyckel från Instrumentpanel → Slutpunkter: 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` kräver en kompatibel rutt. En ny installation kan sakna kompatibla nyckellösa mål, och en nyckellös leverantör kan avvisa tredjepartsklienter. Leverantörer som är märkta med `tos: avoid`, däribland OpenCode Free och Kiro, undantas som standard från automatisk dirigering. Att ansluta ett konto åsidosätter inte den inställningen. Läs [Guiden till kostnadsfria nivåer](docs/getting-started/FREE-TIERS-GUIDE.md) innan du väljer en leverantör.} _{📦 Kopiera-och-klistra-in-snabbstartsskript 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 lokal slutpunkt (http://localhost:20128/v1); OmniRoute Smart Router (RTK + Caveman-komprimering, 19 dirigeringsstrategier, kretsbrytare, TLS-maskering, MCP, A2A, skyddsräcken) kan växla mellan 4 leverantörsnivåer så länge ett kompatibelt och fungerande mål återstår – nivå 1: prenumeration, nivå 2: API-nyckel, nivå 3: billigt och nivå 4: kostnadsfritt.

## 🤝 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.}

## 🎯 Combos — flaggskeppet

Alla 19 strategier för combo-routing animerade — 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, cache-optimized, lkgp, auto, fusion, pipeline. Se tabellen ovan för vad var och en gör.

> En **combo** är en kedja av modeller som OmniRoute dirigerar mellan **automatiskt**. Om kvoten tar slut, en leverantör slutar fungera eller kostnaderna skjuter i höjden kan combon gå vidare till nästa tillgängliga och fungerande modell. 🛡️ ### ⚡ Ingen konfiguration — använd bara `auto` Du behöver inte skapa någon combo. Ställ in din modell på `auto` (eller en variant), så bygger OmniRoute en virtuell combo från dina anslutna leverantörer som poängsätts i realtid:

Modell-ID	Vad den optimerar för
`auto`	🎯 Balanserat standardval (LKGP — håller fast vid din senast fungerande leverantör)
`auto/coding`	🧑💻 Kvalitetsorienterad viktning för kodgenerering
`auto/fast`	⚡ Lägsta latens först
`auto/cheap`	💰 Lägsta kostnad per token först
`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 den senast fungerande leverantören
`auto/chaos`	🧪 Parallell utskickning till en panel av modeller (en per leverantör, 5 som standard), returnerar ett svar; ett anrop till en extern tjänst per panelmodell, inte felinjicering

## ### 🔀 Eller bygg din egen — 19 routingstrategier Alla **19** strategier — blanda fritt för varje steg i en combo:

#	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 du går vidare
3	`weighted`	Viktat slumpmässigt val baserat på varje måls vikt
4	`round-robin`	Växla mellan målen i ordningsföljd
5	`p2c`	Slumpmässig lastbalansering enligt principen ”power of two choices”
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 borttagning av upprepningar 🎲
9	`cost-optimized`	Minimera kostnaden per begäran utifrån aktuella katalogpriser 💸
10	`headroom`	Välj målet med störst återstående kvot
11	`reset-window`	Föredra målet vars kvotfönster återställs först
12	`reset-aware`	Rangordna efter kvotens återställningstid — korta fönster först 📊
13	`context-relay`	Överlämna kontext mellan mål vid långa konversationer 🧠
14	`context-optimized`	Välj det bästa alternativet för den aktuella kontextstorleken
15	`cache-optimized`	Knyt varje återanvändbart promptprefix till samma konto — maximera träffarna i promptcachen 🎯
16	`lkgp`	Senast kända fungerande väg — håller fast vid den senast fungerande leverantören och faller sedan tillbaka på regler
17	`auto`	Poängsättning i realtid utifrån 16 faktorer för varje anslutning 🤖
18	`fusion`	Skickar ut till en panel av modeller + en domare sammanställer ett enda svar 🧬
19	`pipeline`	Kedja steg — utdata från varje mål matas till nästa 🔗

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

OmniRoute-resiliens — 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, lat återhämtning; medan den är OPEN dirigerar kombinationen om till nästa leverantör. Lager 2: anslutningens nedkylningsperiod (en nyckel/ett konto): bas 5s OAuth / 3s API-nyckel, exponentiell ×2-backoff med skydd mot stampede-effekt, 429 respekterar Retry-After, en lyckad begäran rensar all felstatus; en nyckel under nedkylning hoppas över medan parallella nycklar fortsätter att betjäna. Lager 3: modellspärr (en modell): modellspecifika 429-fel, lokala 404-fel eller lägesnekanden spärrar endast den modellen — aldrig hela anslutningen. Slutgiltiga tillstånd (blockerad, utgången, krediter förbrukade) är till för operatören, inte för nedkylningsperioder.

_{📖 [Automatisk kombinationsmotor](docs/routing/AUTO-COMBO.md) · [Resiliensguide](docs/architecture/RESILIENCE_GUIDE.md)}

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

_{📊 Fullständig metodik 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

> De senaste höjdpunkterna från **v3.8.20 → v3.8.50**. Fullständig historik finns i [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — inkommande A2A-delegering till din agentflotta, Conductor-färdigheter på agentkortet och en instrumentpanel med Faro-röstchatt med talknapp. → [A2A-server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptiv åtkomst- och överbelastningshantering** — resurskrävande chattförfrågningar köas i stället för att ge 503-fel, med atomära 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ästs först), stabilt över alla katalogkällor. → [API-referens](docs/reference/API_REFERENCE.md) - **🗜️ Förstärkt 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) - **💸 Korrekt fast kostnad** — leverantörer med prenumerations-/kodningsabonnemang visar **$0** i kostnadsanalysen; budget, kvot och dirigering fortsätter att göra uppskattningar. → [API-referens](docs/reference/API_REFERENCE.md) - **⚖️ Kvotdelningsdirigering** — fördela ett delat kontos kvot rättvist mellan poolade nycklar, med arbetsbevarande utlåning av oanvända andelar. → [Resiliensguide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Konfiguration av CLI/agent med ett kommando** — 13 registrerade `setup-*`-kommandon; `omniroute run` startar 7 CLI-verktyg (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` stöder 10 mål med en interaktiv väljare för leverantör och modell samt favoriter per kontext. → [CLI-integrationer](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Fjärrläge** — styr en fjärransluten OmniRoute med avgränsade token (`connect` / `contexts` / `tokens`) samt en `antigravity`-OAuth-hjälpare för VPS-installationer. → [Fjärrläge](docs/guides/REMOTE-MODE.md) - **🧭 Smartare automatisk dirigering** — `auto/:`-kombinationer, **Fusion** (modellpanel + domare), uppgiftsmedveten dirigering samt åsidosättningar per begäran för modell, läge och USD-budget. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Utbytbar komprimering** — 12 kombinerbara motorer + Compression Studios: LLMLingua-2, Ultra i två nivåer, omniglyph, tillförlitlighetskontroll per steg, GCF v3.2 och dra-och-släpp-redigerare för omordning. → [Komprimering](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparent MITM-dekryptering (TPROXY)** — fånga upp CLI-verktyg som ignorerar proxymiljövariabler, med en CA per SNI samt installation i betrodda certifikatarkiv. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Kostnadstelemetri överallt** — `X-OmniRoute-*`-huvuden för kostnad/användning på varje slutpunkt, ett huvud för besparing vid cache-HIT samt USD-utgiftskvoter per nyckel. → [API-referens](docs/reference/API_REFERENCE.md) - **🧠 Minne som du kontrollerar** — avstängt som standard, valfri int8-vektorkvantisering + typad avklingning samt `x-omniroute-no-memory` per begäran. → [Minne](docs/frameworks/MEMORY.md) - **🛡️ Säkerhet** — skydd mot promptinjektion på varje LLM-rutt (red-team-svit), valfritt skydd för maskering av autentiseringsuppgifter (maskerar läckta API-nycklar/hemligheter i båda riktningarna), kostnadsfri DuckDuckGo-webbsökning som sista utväg samt en valfri OIDC-inloggningsspärr för instrumentpanelen (lösenordsinloggning förblir alltid tillgänglig). → [Skyddsmekanismer](docs/security/GUARDRAILS.md) - **🖼️ Nya slutpunkter** — `/v1/ocr` (Mistral OCR) och `/v1/audio/translations` (i Whisper-stil) kompletterar mediestödet. → [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** — omvänd proxy med `basePath`, automatisk identifiering av webbläsarspråk, enhetsspårning per nyckel, root-fritt MITM-förtroende 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äsare + OAuth-inloggning, fullvärdigt Ollama-kort, Claude Opus 5 och Sonnet 5, officiellt Kimi-partnerskap (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… samt en uppdaterad **katalog med 352 leverantörer**. → [Leverantörer](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparent dirigering** — varje svar innehåller ett `X-OmniRoute-Decision`-huvud som anger strategin/leverantören/latensen som hanterade det, en ny `cache-optimized`-kombinationsstrategi + Auto-Combo-faktorn `cacheAffinity` dirigerar upprepade begäranden tillbaka till anslutningen som innehåller det cachade prefixet, och en skrivskyddad `/v1/auto-combo/{channel}/candidates`-slutpunkt visar den aktuella kandidatpoolen för en `auto/*`-kanal. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokal prestanda och infrastruktur** — lokal Redis med ett klick, relädistributionsverktyg för Cloudflare Workers / Deno Deploy samt Bifrost och Mux som övervakade inbäddade tjänster. → [Inbäddade tjänster](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Ingår också** — ramverk för insticksprogram + marknadsplats, färdighetsramverk för Omni/Agent/GitHub, Obsidian-valvintegration (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 multimodellsutspridning med `auto/chaos`, en Telegram-botbrygga, en versionshanterare i appen samt LMArena-ELO-rankningar för kostnadsfria leverantörer. → [Dokumentation](docs/README.md)

## 🤖 Kompatibla CLI:er och kodningsagenter > En konfiguration — `http://localhost:20128/v1` — och **varje** AI-IDE eller CLI körs med kostnadsfria och billiga modeller.

_{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 konfiguration för alla 36 verktyg (26 CLI-kodverktyg + 10 CLI-agenter) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode-plugin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Starta valfri CLI som stöds via OmniRoute med ett enda kommando** — inga konfigurationsfiler skrivs, autentiseringsuppgifter injiceras per process och Qwen/Gemini får en tillfällig, isolerad hemkatalog: ```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 och modell interaktivt och skriv verktygets egen konfiguration: omniroute configure codex # även: claude opencode qwen aider goose gemini cline continue kilo ``` Varje kommando respekterar den aktiva fjärrkontexten (`omniroute connect `), `--dry-run` förhandsvisar exakt miljö och argument utan att köra något, och `--api-key-env NAME` håller hemligheter borta från din skikhistorik. → [CLI-integrationer](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 372 AI-leverantörer — 154 katalogmarkerade som kostnadsfria

> **372 registrerade leverantörer** i de kanoniska samlingarna för chatt, media, sökning, lokala tjänster, molnagenter och system, varav **154 har identifieringsmetadata med `hasFree: true`**. Chattmodellregistret omfattar **237 leverantörer / 3 009 unika par av leverantör och modell / 1 443 råa modell-ID:n**; den separata katalogen över kostnadsfria budgetar har **491 rader per modell**, **35 återkommande pooler** och **54 återkommande/nyckellösa leverantörer som är kostnadsfria för alltid**. Dessa har avsiktligt olika nämnare; definitioner och pooldeduplicerade beräkningar finns i [Leverantörsreferensen](docs/reference/PROVIDER_REFERENCE.md) och [Kostnadsfria nivåer](docs/reference/FREE_TIERS.md).

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

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

_{…och fler än 330 andra — varje ikon hämtas direkt från instrumentpanelens leverantörskatalog. 📖 [Leverantörsreferens](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Kostnadsfritt för alltid — $0, inget kort krävs

OpenCode Zen _{DeepSeek V4, Nemotron 3 Ingen tokengräns}	Kilo Code _{Automatisk dirigering, 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 _{50+ modeller 10 000 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 — överallt

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

Plattform	Installation	Höjdpunkter
📦 npm (globalt)	`npm install -g omniroute`	Ett kommando, valfritt operativsystem
🐳 Docker	`docker run … diegosouzapw/omniroute`	Flera arkitekturer: AMD64 + ARM64
🖥️ Skrivbord (Electron)	`npm run electron:build`	Inbyggt fönster + systemfält — Windows / macOS / Linux
🎩 Menyrad (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Övervakar och uppdaterar servern automatiskt — macOS
💪 ARM	inbyggt `arm64`	Raspberry Pi, ARM-servrar, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Körs på din telefon, dygnet runt, utan root
📲 PWA	"Lägg till på startskärmen"	Helskärm, offline, kan installeras från webbläsaren
🧩 OpenCode-plugin	`@omniroute/opencode-provider`	Inbyggd OpenCode-integrering
🤖 VS Code Copilot Chat	installera tillägget OmniCopilot	Alla OmniRoute-modeller i Copilot Chats inbyggda modellväljare — stabila versionen och Insiders
🛠️ Från källkod	`npm install && npm run dev`	Modifiera det, bidra

_{📖 [Docker-guide](docs/guides/DOCKER_GUIDE.md) · [Skrivbord](electron/README.md) · [Menyradsapp](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 i VS Codes inbyggda Copilot Chat

> Inget nytt sidofält, inget nytt chattgränssnitt — varje modell som OmniRoute tillhandahåller visas direkt i > **Copilot Chats modellväljare som du redan använder**. Sedan VS Code 1.122 fungerar leverantörsmodeller > utan GitHub-inloggning eller Copilot-prenumeration — agentläge, verktygsanrop och bildstöd, > kostnadsfritt. Installera tillägget **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, rikta det mot din OmniRoute-server (standard är `localhost:20128`) och öppna sedan Copilot Chat → modellväljaren → **Hantera modeller…** → **OmniRoute**.

Butik	Länk	Fungerar med
🧩 VS Code Marketplace	Installera →	VS Code — stabila versionen och Insiders
🔓 Open VSX Registry	Installera →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Inifrån redigeraren: öppna vyn **Tillägg**, sök efter **"OmniRoute"** och klicka på **Installera** — det fungerar på samma sätt i båda butikerna. Källkod, ärenden och publiceringsinstruktioner finns på [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Guide för VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — konfiguration, vad väljaren visar, instrumentpanel i en flik, felsökning}

### 🎩 Nytt: OmniRouteTray — din gateway, direkt i menyraden

> `omniroute serve` trivs bäst när den alltid är igång. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > gör den till en menyradsapp för macOS som du kan konfigurera och sedan glömma: den startar servern, håller den igång > mellan omstarter, uppdaterar den på plats och gör din aktuella tokenbudget tillgänglig med ett klick — **inget > terminalfönster behöver lämnas öppet och ingen `npm install -g omniroute` behöver övervakas.** Den är byggd med [Tauri v2](https://v2.tauri.app/) (en Rust-kärna lika liten som ett avrundningsfel) och levereras med en egen signerad Node 24-körmiljö samt hanterar en appägd OmniRoute-installation, så den krockar aldrig med din globala `node`/`bun`. Den **delar din befintliga konfiguration och databas i `~/.omniroute/`** — så det är samma OmniRoute som du redan kör, bara med en hatt på. 🎩

Vad den gör	Hur
🟢 Övervakar servern	Startar `omniroute serve` och tar över en instans som redan körs i stället för att duplicera den
📊 Aktuell användning i korthet	Kvotindikatorer för leverantörer, Claude-gränser per session/vecka med nedräkning till återställning samt kostnadsöversikt för 30 dagar
🔄 Uppdateras automatiskt på plats	Stegvis installation, atomärt byte och återställning vid fel — alltid den senaste versionen
🚀 Starta vid inloggning	Valfri start vid inloggning; endast menyraden, ingen Dock-ikon
🩺 Diagnostik och loggar	Diagnostik och åtkomst till serverloggar med ett klick

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Föredrar du en nedladdning? Hämta den senaste .dmg-filen från
Releases. Källkod, ärenden och byggdokumentation
finns på zoispag/omniroute-tray.

💛 Ett communityprojekt av @zoispag — inte en officiell OmniRoute-version.}

## 🔒 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ändig CLI + A2A och 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**. ### ⌨️ En riktig CLI (inte bara `start`) ```bash omniroute # starta gateway + kontrollpanel (port 20128) omniroute chat # interaktiv TUI-chattklient (snedstreck: /model /combo /skill /memory) omniroute setup # guidad konfiguration vid första körningen omniroute doctor # diagnostisera leverantörer, portar och inbyggda beroenden ``` ### 🛰️ Fjärrläge — kör CLI:n 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 begränsad behörighet; därefter riktas varje kommando mot fjärrservern. ```bash omniroute connect 192.168.0.15 # lösenord → token med begränsad behörighet, sparad som en kontext omniroute models list # ← 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 86 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 en **fjärr-CLI** — valfri kapabel agent (eller din egen kod) får nycklarna till hela gatewayen: dirigering, leverantörer, kombinationer, cache, komprimering och minne — autonomt. HTTP-slutpunkterna nedan tillhandahålls under `http://localhost:20128`.

Gränssnitt	Slutpunkt/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örighetsområden (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
🛰️ Fjärr-CLI	`omniroute connect`	Styr en fjärrinstans med åtkomsttoken som har begränsad behörighet

```bash # Ge Claude Code tillgång till OmniRoutes fullständiga 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 besparingsberäkning

OmniRoutes komprimeringspipeline: en illustrativ klientbegäran med 10 000 tokens passerar genom 12 kombinerbara 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 bevarandekontroller och kvalitetsspärrar för varje steg; uttryckligen destruktiva eller experimentella lägen kan omvandla lämpligt innehåll.

Den staplade standardkombinationen kör `RTK → Caveman`. När båda bearbetar 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 skyddas **alltid** 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 behövs. Det är nu en **stack med 12 kombinerbara motorer** som körs i ordning och kan kombineras fritt per routningskombination — baserat på 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/inaktiveras och konfigureras oberoende för varje 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 och hämtar dem på begäran
3	Lite	Beskärning av blanksteg och bild-URL:er (grundnivå med låg latens)
4	RTK	Smart filtrering, deduplicering och trunkering av verktygsresultat (kommandomedveten)
5	Responses Tool Output	I första hand förlustfri JSON samt begränsad diagnostisk komprimering för utdata från skal/patchning/sökning/byggen (Responses API)
6	Headroom	Förlustfri tabellkomprimering av JSON-matriser (~30 %) via en inkluderad GCF-kodek
7	Relevance	Extraktiv meningspoängsättning mot den senaste användarfrågan
8	Caveman	Regelbaserad prosakomprimering (~65–75 % av utdata)
9	Aggressive	Sammanfattning och progressiv åldring av gamla turer
10	LLMLingua-2	Semantisk ML-gallring via MobileBERT ONNX — kodsäker, asynkron
11	Ultra	Heuristisk tokengallring med en valfri nivå för små modeller (SLM)
12	OmniGlyph	Experimentell kodning av kontext som bild för uppmätta Claude Fable 5 via den direkta Anthropic-anslutningen; GPT 5.6-transformatorer fortsätter att stoppa bearbetningen i väntan på leverantörskvitton. Fyra komprimeringsprofiler (aggressiv standard, balanserad, kodsäker, direktöverföring) (mest aggressiv; måste aktiveras uttryckligen)

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

Läge	Besparing	Bäst för
🪶 Lite	~15 %	Säker standard som alltid är aktiv
🪨 Standard (Caveman)	~30 %	Daglig kodning
⚡ Aggressive	~50 %	Långa sessioner med många verktyg
🔥 Ultra	~75 %	Maximal besparing
🧰 RTK	60–90 %	Utdata från skal/tester/byggen/git
🔗 Staplat (RTK → Caveman)	78–95 %	Blandade prompter och verktygsloggar

**Verkligt exempel — standardläge:** > **Före (69 tokens):** _"Anledningen till att din React-komponent renderas om är sannolikt att du skapar en ny objektreferens vid varje renderingscykel. När du skickar ett infogat objekt som en 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. Infogat objekt som prop = ny referens = omrendering. Omslut med useMemo."_ > > **Samma svar. 72 % färre tokens. Ingen noggrannhetsförlust.** ✅ **PT-BR-exempel — läget [Troglodita](https://github.com/leninejunior/troglodita):** > **Före (42 token):** _"Problemet är att komponenten renderas om eftersom en ny objektreferens skapas i varje renderingscykel. Jag skulle rekommendera att använda useMemo."_ > > **Efter (12 token):** _"Omrendering: ny ref varje cykel (inline-objekt återskapas). Använd `useMemo`."_ > > **Samma svar. ~70 % färre token. Den tekniska precisionen är intakt.** ✅
### 🎚️ Bortom motorerna — utdatastilar, det adaptiva reglaget och styrning 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**: - **🪄 Utdatastilar** _(styrning längs utdataaxeln)_ — injicerar deterministiska, cachesäkra instruktioner för att forma svar; kan kombineras, var och en med intensiteten `lite` / `full` / `ultra`. Att lägga till en stil kräver en enda rad i registret: - **Kortfattad prosa** — ta bort utfyllnad / artiklar / garderingar; behåll det tekniska innehållet exakt. - **Mindre kod** — ”lat seniorutvecklare”-YAGNI: minsta fungerande ändring, ingen byggnadsställning som inte efterfrågats. - **Ponytail (lat seniorutvecklare)** — klättra på YAGNI-stegen, åtgärda grundorsaken, minsta fungerande diff. - **Jag har ADHD (åtgärd först)** — börja med nästa åtgärd, numrerade steg, ett konkret nästa steg, ingen inledning. - **Kortfattad CJK (文言)** — ultrakortfattad stil på klassisk kinesiska (begränsad till språkvarianten `zh`). - **🎯 Adaptiv kontextbudget** _(reglaget)_ — i stället för ett enda på/av-tröskelvärde för token eskaleras de billigaste motorerna med minst informationsförlust bara så långt som behövs för att **rymmas i modellens kontextfönster**. Policy: `reserve-output` (standard, modellanpassad) · `percentage` · `absolute`. Läge: `floor` (garanterar att det ryms) · `replace-autotrigger` (ditt uttryckliga val gäller) · `off` (äldre tröskelvärde). - **🎛️ Var komprimeringen avgörs** _(prioritetsordning, hög → låg)_ — `x-omniroute-compression`-header per begäran › åsidosättning för routingkombination › aktiv namngiven profil › adaptiv / automatisk utlösare › panelstandard › av. Den tillämpade planen återges i svarsheadern `X-OmniRoute-Compression: ; source=`. Utlös automatiskt via ett tröskelvärde för token, slå på det adaptiva reglaget, lås en namngiven profil, ange ett engångsval per begäran eller tilldela en pipeline per routingkombination — välj det som passar arbetsbelastningen. Ett valfritt offlinebaserat **utvärderingsverktyg** (`npm run eval:compression`) bedömer återgivningstrohet kontra besparing på en låst korpus innan du produktionssätter 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 är tillåtna. OmniRoutes `postinstall` (`node scripts/build/postinstall.mjs`) krävs för att förbereda dess systemspecifika körningsfiler. Tillåt paketen som anges i npm:s varning när du installerar globalt. För paketuppsättningen som rapporteras av OmniRoute 3.8.51: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Om du vill återanvända den här tillåtelselistan för framtida globala installationer konfigurerar du den en gång och installerar sedan som vanligt: > > ```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. När du tillåter ett paket får dess installationsskript köras. > **Använder du Gemini Web eller någon annan leverantör som använder webbcookies?** npm-paketet inkluderar > Playwright, men inte dess Chromium-binärfil. Läs 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 webbleverantören. Kontrollpanelen finns på `http://localhost:20128` · API:et finns på `http://localhost:20128/v1`. **2) Anslut en berättigad leverantör med ditt eget konto** Kontrollpanelen → **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. Kostnadsfria nivåer kan kräva registrering, godkännande eller en betalningsmetod. Läs [Guiden till kostnadsfria nivåer](docs/getting-started/FREE-TIERS-GUIDE.md); nyckelfri tillgänglighet garanteras inte, och leverantörer märkta med `tos: avoid` utesluts som standard från `auto`. **3) Anslut ditt kodningsverktyg** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Kontrollera att det fungerar** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Du bör se en lista över dina anslutna modeller. 🎉 Klart — börja koda, så dirigerar OmniRoute automatiskt och använder reservlösningar åt dig. Om din klient inte kan skicka anpassade headers erbjuder OmniRoute även tokeniserade kompatibilitetsalias: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Använd dessa endast för klienter som inte kan bifoga `Authorization: Bearer ...`. Autentisering via header är fortfarande det föredragna 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 instrumentpanelen den 2026-08-24 · Råkatalog: YT 809 | TT 137 | IG 124 · Aktualitet (dagar): YT 1 | TT 21 | IG 22}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 visningar}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 visningar}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 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** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | Kanoniska mätvärden den 2026-08-24: **1.029 unika videor** · **11.132.922 kända visningar** (`v > 0`) · **639 kanaler/profiler per nätverk**. Den råa instrumentpanelen innehåller 1.070 rader; 41 dubbletter från Instagram normaliserades utifrån den kanoniska URL:en, varvid det högsta antalet per video behölls. > 🎬 **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.

# 📧 Gemenskap och hjälp > Allt på ett ställe — följ underhållaren, chatta med gemenskapen 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 versioner 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** | [öppna ett ärende](https://github.com/diegosouzapw/OmniRoute/issues) — bifoga utdata från `npm run system-info` | | 🤝 **Bidra** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Förgrenings- och versionsmodell](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/` (inga `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-format) — 137 domänmoduler, 202 migreringar
Minne	SQLite FTS5-fulltextsökning + int8-kvantiserade vektorinbäddningar, typad avklingning
Scheman	Zod 4 — validering av in- och utdata för MCP-verktyg + 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 + omfångsbegränsad MCP-autentisering · AES-256-GCM för lagrade data · DOMPurify
Kamouflering	wreq-js — imitation av JA3-/JA4-TLS-fingeravtryck, proxy i tre nivåer
Robusthet	Kretsbrytare, exponentiell återgång, skydd mot samtidiga belastningstoppar, självläkande automatisk kombination
Loggning	pino — strukturerade JSON-loggar med kontext för begäranden
Testning	Node.js test runner + Vitest — över 39 000 statiska testdeklarationer i över 5 100 spårade testfiler (enhets-, integrations-, E2E-, säkerhets- och ekosystemtester)
Plattformar	Skrivbord (Electron) · Android (Termux) · PWA (valfri webbläsare)
CI/CD	GitHub Actions — automatisk publicering till npm + Docker Hub vid lansering
Länkar	Webbplats · npm · Docker Hub

## 📖 Dokumentation

### 📘 Kom igång

Dokument	Beskrivning
Användarhandbok	Leverantörer, kombinationer, CLI-integration, driftsättning
Installationsguide	Fullständiga installationsmetoder, konfigurationer för 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 CLI:n på din bärbara dator via åtkomsttoken med begränsad behörighet
Claude Code-konfiguration	Anslut Claude Code till OmniRoute (lokalt/fjärranslutet) med `launch` + profiler per modell
Snabbstart	Installation i 3 steg → anslut → konfigurera

### 🔧 Drift och driftsättning

Dokument	Beskrivning
Docker-guide	Docker run, Compose-profiler, Caddy HTTPS, tunnlar, avbildningstaggar
Podman-guide	Quadlet systemd-integration, podman-compose, SELinux
VM-driftsättning	Komplett guide: konfiguration av VM + nginx + Cloudflare
Fly.io-driftsättning	Driftsätt på Fly.io med beständig lagring
Termux-guide	Kör OmniRoute på Android via Termux
PWA-guide	Installation, cachelagring och arkitektur för progressiva webbappar
Avinstallationsguide	Ren borttagning för alla installationsmetoder
Miljökonfiguration	Kompletta variabler och referenser för `.env`

### 🧠 Funktioner och arkitektur

Dokument	Beskrivning
Arkitektur	Systemarkitektur, dataflöde och intern funktion
Komprimeringsguide	Pipeline med 7 alternativ: av / lätt / standard / aggressiv / ultra / RTK / staplad
RTK-komprimering	Komprimering av kommandoutdata, filter, betrodda källor, verifiering, återställning av rådata
Komprimeringsmotorer	Caveman, RTK, staplade pipelines, gränssnitt för instrumentpanel/API/MCP
Format för komprimeringsregler	Scheman för JSON-regelpaket till Caveman- och RTK-filter
Språkpaket för komprimering	Språkidentifiering och framtagning av Caveman-regelpaket
Guide för feltålighet	Kretsbrytare, väntetider, kö, skydd mot samtidiga anropsstormar, TLS-förfalskning
Auto-Combo-motor	Poängsättning med 16 faktorer, lägespaket, självläkning
Proxyguide	Proxysystem med 3 nivåer, 1proxy-marknadsplats, CRUD för register
Kostnadsfria nivåer	Samlad katalog: 35 dokumenterade återkommande pooler / 489 katalogiserade poster på kostnadsfri nivå
Funktionsgalleri	Visuell rundtur i instrumentpanelen med skärmbilder
Dokumentation av kodbasen	Nybö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, transporter och verktygsreferens
A2A-server	JSON-RPC 2.0-protokoll, färdigheter, strömning, uppgiftshantering
Guide för A2A-server	A2A-agentkort, uppgifter, färdigheter och strömning

### 📋 Projekt och kvalitet

Dokument	Beskrivning
Bidra	Utvecklingsmiljö och riktlinjer
Gren- och utgivningsmodell	Vilka grenar PR:er riktas mot (`release/*`) samt vad `main` och taggar innebär
Ändringslogg	Fullständig utgivningshistorik per version
Säkerhetspolicy	Rapportering av sårbarheter och säkerhetsrutiner
i18n-guide	Stöd för 42 språk, arbetsflöde för översättning och RTL
Checklista för utgivning	Valideringssteg före utgivning
Plan för testtäckning	Strategi för testtäckning av fler än 39 000 statiska testdeklarationer i fler än 5 100 spårade testfiler

# ⭐ Främsta bidragsgivare > OmniRoute formas av en engagerad öppen källkodsgemenskap. Dessa personer har gjort exceptionella insatser som direkt påverkar projektets kvalitet, stabilitet och räckvidd. **Tack.** ### Externa bidragsgivare efter antal sammanslagna pull requests

Placering	Bidragsgivare	Sammanslagna PR:er	~Ändrade rader
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{Fryst vid den aktuella spetsen dafb4ae808 för release/v3.8.50, med sammanslagningar till och med 2026-08-24 05:26:03 UTC. Den sidindelade kartläggningen via GitHub GraphQL omfattar 5 911 sammanslagna PR:er: 2 707 av lagrets ägare, 179 av Dependabot och 3 025 externa PR:er från 535 unika bidragsgivare. ”Ändrade rader” är summan av tillägg och borttagningar på GitHub och inkluderar genererade filer, låsfiler, kataloger, översättningar och dokumentation; det är kodomsättning, inte författade kodrader. Delade placeringar vid gränsen behålls.} ### Commits tillskrivna av GitHub

backryun _{🥇 220 GitHub-tillskrivna commits}	Paijo _{🥈 219 GitHub-tillskrivna commits}	Randi _{🥉 108 GitHub-tillskrivna commits}	Ravi Tharuma _{🏅 81 GitHub-tillskrivna commits}	Chris _{🏅 70 GitHub-tillskrivna commits}	Markus Hartung _{🏅 69 GitHub-tillskrivna commits · delad plats 6}
Dizzle _{🏅 69 GitHub-tillskrivna commits · delad plats 6}	Jan Leon _{🏅 64 GitHub-tillskrivna commits}	zenobit _{🏅 62 GitHub-tillskrivna commits}	Bob.Hou _{🏅 51 GitHub-tillskrivna commits · delad plats 10}	Xiangzhe _{🏅 51 GitHub-tillskrivna commits · delad plats 10}

_{Kontrollerades på nytt 2026-08-24 06:14:31 UTC: GitHub-tillskrivna commits som rapporterats av datalagrets Contributors API för standardgrenen release/v3.8.50. API:et returnerade 525 identiteter (415 användare, 2 botar, 108 anonyma); den här tabellen exkluderar underhållaren, botar och anonyma identiteter samt behåller delade placeringar. Den skiljer sig både från rankningen över sammanslagna PR:er ovan och inventeringen av Git-metadata för 639 personer nedan.} > 🙏 Dessa bidragsgivares funktioner, felrättningar och förbättringar av infrastrukturen ä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 de personer 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}

Paco Cartones
_{💛 Aktiv engångssponsor}

Prof. Igor Morais
_{💛 Tidigare engångssupporter}

longtao
_{💛 Tidigare engångssupporter}

_{… och andra som föredrar att förbli privata 💛} _{Offentliga GitHub Sponsors verifierades på nytt 2026-08-24. GitHubs activeOnly-status avgör de aktiva etiketterna ovan. Tidigare offentliggjorda offentliga engångssupporter fortsätter att uppmärksammas, medan privata sponsorer förblir anonyma.} 💖 Bli sponsor → — varje dollar hjälper OmniRoute att förbli kostnadsfritt och oberoende.

## 👥 Fler än 600 bidragsgivare

[![Bidragsgivare](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Granskad 2026-08-24 vid den frysta basen ac02c5b42f och kontrollerad på nytt vid den aktuella spetsen dafb4ae808 för release/v3.8.50: 639 normaliserade mänskliga Git-identiteter — 407 förekommer som commit-författare (inklusive underhållaren) och 232 förekommer endast i uttryckliga Co-authored-by-trailers. Inventeringen normaliserar GitHub-noreply-handtag, utesluter 26 bot-, agent-, tjänste- eller platshållaridentiteter och slår inte samman vanliga e-postadresser enbart för att deras visningsnamn överensstämmer.} ### Så bidrar du 1. Forka kodförrådet 2. Skapa grenen från spetsen för den **aktiva** `release/vX.Y.Z`-grenen (inte `main`) — se [Gren- och versionsmodellen](docs/ops/BRANCHING_MODEL.md) 3. Skapa din funktionsgren (`git checkout -b feat/amazing-feature`) 4. Checka in dina ändringar (`git commit -m 'feat: add amazing feature'`) 5. Pusha till grenen (`git push origin feat/amazing-feature`) 6. Öppna en pull-begäran med **base = den `release/vX.Y.Z`-grenen** Se [CONTRIBUTING.md](CONTRIBUTING.md) för detaljerade riktlinjer. ### Publicera en ny version ```bash # Skapa en release — 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-portning av Go-projektet **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — och därefter inspirerades varje delsystem nedan av ett projekt med öppen källkod som var först med att lösa uppgiften. Vart och ett av dem formade en konkret del av OmniRoute. Detta är vårt sätt att tacka dem alla. 🙏 > ⭐ antalet stjärnor verifierades via GitHubs REST API den 24 augusti 2026 — ge gärna dessa projekt en stjärna. Antalen är en exakt ögonblicksbild från det datumet och kommer naturligtvis att förändras. ### 🧬 Ursprung och gateway

Projekt	⭐	Hur det inspirerade OmniRoute
9router	26,161	Det ursprungliga projekt som denna fork bygger på – här utökat med multimodala API:er och en fullständig omskrivning i TypeScript.
CLIProxyAPI	48,497	Go-implementeringen som inspirerade denna portning till JavaScript / TypeScript.
LiteLLM	57,100	AI-gatewayen vars offentliga prisdata används av vår synkronisering av kostnadsspårning och vars modell för leverantörsnormalisering låg till grund för vår routning.
codex-chatgpt-web	1,410	MIT-källkod som anpassats till den inkluderade bryggan ChatGPT Web → Codex Responses, inklusive adaptrar för webbläsarsessioner, svarsramning, användning och webbsökning.
free-claude-code	48,112	Mönster som portats till strömåterställning, alias utan tänkande, reservlösning för webbsökning, gränser med glidande fönster, maskning av loggar och härdade startflöden.
composer-api	322	Mönster för verktygsval, utmatningsbegränsningar och verktygsbekräftelse i Cursor Composer som anpassats till den inbyggda Cursor-exekveraren.
codex-multi-auth	457	Mönster för ny inloggning och rotation av uppdateringstoken som portats till återautentisering med Codex OAuth.
opencode-anthropic-auth	510	Claude Code-kompatibla standardvärden för transformering och beteenden för faktureringshuvuden som generaliserats i OmniRoutes konfigurationsdrivna brygga.
grok2api-merged	2	Projektets Grok-modellmappningar, Statsig-generator med simulerad TypeError, standardvärden för förfrågningar och enheter samt NDJSON-svarsprocessor har i väsentlig grad anpassats till OmniRoutes Grok Web-exekverare.
TQZHR/grok2api	705	Den huvudsakliga transitiva kodkällan bakom grok2api-merged; dess implementeringar av modeller, huvuden, nyttolaster, Statsig och processorer är bevarade i Grok Web-härstamningen.
chenyme/grok2api	7,520	Den underliggande MIT-källkoden för Groks nyttolast- och enhetsstandardvärden, Statsig-generatorn och `result.response`-processorn som förts vidare via TQZHR och grok2api-merged.
grok2api-pro	27	En transitiv källa som grok2api-merged hänvisar till för sitt proxypoolslager; OmniRoute bevarar hänvisningen till denna härstamning men gör inte anspråk på någon portning av en proxypool i sin avgränsade Grok Web-exekverare.
GrokProxy	50	Projektets cookie-autentiserade Grok-proxy och strömningsmönster med `result.response.token` låg till grund för OmniRoutes Grok Web-transport.
GrokBridge	5	Den ursprungliga Grok Web-implementeringen konsulterade projektets uppströmsdesign för HTTP/webbläsare; dess direkta HTTP-sökväg härrör från GrokProxy, så ingen oberoende kodportning görs gällande.
grok-web-api	14	Projektets Rust-scheman för `ChatOptions` och svarskuvert låg till grund för OmniRoutes TypeScript-typer för Grok-förfrågningar och strömmande svar.

### 🗜️ Kontext- och tokenkomprimering – motorer

Projekt	⭐	Hur det inspirerade OmniRoute
Caveman	100,538	Det virala projektet ”varför använda många token när få token gör jobbet” — dess grottmänniskofilosofi driver vårt standardläge för komprimering och över 30 regler för utfyllnadsborttagning och kondensering.
RTK – Rust Token Killer	77,185	Högpresterande komprimering av kommandoutdata — inspirerade vår RTK-motor, vårt JSON-filter-DSL, vår återställning av råutdata och den staplade pipelinen RTK → Caveman.
headroom	67,310	Reversibel kontextkomprimering (SmartCrusher) — inspirerade vår `headroom`-motor och mönstret med `ccr`-hämtningsmarkörer.
LLMLingua	6,598	Forskning om promptkomprimering (LLMLingua / LLMLingua-2) — inspirerade vår asynkrona, kodsäkra `llmlingua`-motor med öppen felhantering.
llmlingua-2-js	31	JS/ONNX-portningen (MobileBERT / XLM-RoBERTa) som används som worker thread-backend för vår LLMLingua-motor.
Troglodita	40	Tokenkomprimering för brasiliansk portugisiska — driver vårt pt-BR-språkpaket: reducering av pleonasmer och borttagning av utfyllnadsord, finjusterat för brasiliansk-portugisisk grammatik.
ponytail	108,957	Den virala YAGNI-kodningsfärdigheten ”lat seniorutvecklare” — inspirerade vår utdatastil less-code: styrning mot minsta fungerande ändring som minskar _genererad_ kod (motsvarigheten på utdataaxeln till Cavemans korthuggna prosa).
i-have-adhd	23,526	Dess handlingsinriktade, ADHD-vänliga svarsstil anpassades till OmniRoutes koncisa utdatastil på fem språk.

### 🧩 Kompakta format, tokenforskning och kodmedvetna verktyg

Projekt	⭐	Hur det inspirerade OmniRoute
TOON	25,233	Tokenorienterad objektnotation — dess kolumnära modell med rubrik och rader formade vårt steg för tabellkomprimering.
GCF – Graph Compact Format	41	Dess kompakta grafformat och utformning med generiska profiler låg till grund för OmniRoutes tabellkomprimering och Headrooms kodekformat.
gcf-typescript	4	MIT-implementeringen i TypeScript som direkt inkluderades och utökades som Headrooms kodek för generiska profiler.
token-optimizer-mcp	494	Brotli/SQLite-cache + kontextdelta per session — inspirerade vår `session-dedup`-motor.
token-savior	1,122	Komprimering av Bash-utdata + MCP-profiler — inspirerade vår disciplin för att avbryta komprimering och vår reducering av MCP-verktygsmanifest.
token-saver	138	Innehållsmedveten utdatakomprimering per filtyp med felmedveten avbrytning — bekräftade vår dirigering per typ och överhoppning vid otillräcklig vinst.
token-optimizer	1,951	”Hitta spöktokenen” — dess mönster för avlastning + återställningsbara handtag låg till grund för vårt tänkande kring CCR-avlastning.
TokenMizer	28	En ritning för sessionsgrafer + radavduplicering över flera turer som låg till grund för vår utformning av sessionsavduplicering.
OmniCompress	3	Kolumnär JSON i Rust + innehållsadresserad hämtning + avduplicering över flera meddelanden — bekräftade utformningen av våra `headroom`/`ccr`/`session-dedup`-motorer och den cachestabila invarianten ”den komprimerade formen är positionsoberoende”.
mcp-compressor	113	Komprimering av MCP-verktygsscheman/-beskrivningar — låg till grund för vår kardinalitetsreducering av MCP-verktygsmanifest.
RepoMapper	197	Rangordning av repo-kartor i Aider-stil — låg till grund för vår utforskning av repo-kartor/hämtningsrangordning.
quiet-shell-mcp	4	Deklarativ reducering av shell-utdata via MCP — bekräftade vår deklarativa komprimering av Bash-utdata.
ts-morph	6,162	Verktygslåda för TypeScript Compiler API — inspirerade vår parserbaserade kommentarsborttagning som bevarar sträng-, mall- och regex-litteraler.

### 🧠 Minne och RAG

Projekt	⭐	Hur det inspirerade OmniRoute
Mem0	63,902	Universellt minneslager — dess proxybaserade modell för skriv-/läsgränser formade vår minnesarkitektur.
Letta (MemGPT)	24,382	Tillståndsbevarande agenter med nivåindelat minne — inspirerade vår nivåindelade modell för Context Control & Recovery (CCR).
WFGY	1,781	ProblemMap-taxonomin över 16 återkommande fellägen för RAG/LLM — den gemensamma terminologin i vår felsökningsguide.

### 🛰️ Trafikinspektion, MITM och transparent proxy

Projekt	⭐	Hur det inspirerade OmniRoute
llm-interceptor	66	MITM-avlyssning och analys av trafik mellan kodningsassistenter och LLM:er 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 huvuden — har ersatts av oberoende clean-room-implementationer baserade på offentliga protokollstandarder. De två ytorna för vidarebefordran till värdar (`passthrough.ts` och `_internal/bypass.cjs`) förblir interna OmniRoute-implementationer som klassificeras separat; de skrevs inte om som en del av denna ersättning.
ProxyBridge	5,995	Transparent proxy-routing per process — inspirerade vår kraschsäkra nedstängning av MITM, inaktivitetstimeouter för socketar, processtillskrivning via `/proc` och TPROXY-infångning.

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

Projekt	⭐	Hur det inspirerade OmniRoute
models.dev	6,555	Öppen databas med specifikationer, priser och funktioner för AI-modeller — synkroniseras inbyggt med vår modellkatalog.
React Flow / xyflow	38,108	Det nodbaserade grafbiblioteket som driver våra realtidsverktyg Compression Studio och Combo/Routing Studio.
LangGraph	40,314	LangGraph Studios direkta visualisering av arbetsflödesgrafer inspirerade realtidsvyn över kaskader i våra Studios.
Langfuse	33,592	Dess observerbarhetsmodell spårning → spann → generering formade vattenfallsvyn i vårt Compression Studio.
Kiali	3,631	Observerbarhet för Istio-tjänstenät — inspirerade våra märken för kretsbrytare och visuella felkanter i Routing/Combo Studio.
lobe-icons	2,428	AI-/LLM-varumärkeslogotyper som återger leverantörsikonerna i hela vår instrumentpanel.
flag-icons	12,354	Tillhandahåller de MIT-licensierade SVG-flaggorna som används av språkväxlaren i README-filen.

### 🛡️ Säkerhet

Projekt	⭐	Hur det inspirerade OmniRoute
awesome-secure-defaults	721	En kurerad lista över bibliotek med säkra standardinställningar 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,564	Inspirerade deduplicering av förfrågningar, kostnadsfri reservlösning för nödsituationer, utbytbara Auto-Combo-strategier och flerspråkig avsiktsklassificering.
Antigravity-Manager	30,652	Dess kontomedvetna ommappning av modeller, validering av sökvägar till körbara filer och beteende för abonnemangsetiketter låg till grund för OmniRoutes Antigravity-körmiljö.
vscode-antigravity-cockpit	4,817	Dess kompakta nedräkningsformat för kvotåterställning inspirerade motsvarande visning av leverantörsgränser i OmniRoute.
AionUi	32,230	Dess ACP-integrationer inspirerade OmniRoutes automatiska identifiering av installerade CLI-agenter.
CodexBar	20,507	Identifierade kvotgränssnittet för Grok Build; OmniRoute verifierade och korrigerade sedan det aktiva dataformatet oberoende.

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

**[⬆ Tillbaka till toppen](#-omniroute)** · Byggd med ❤️ för AI-communityn kring öppen källkod. _{OmniRoute v3.8.52 · Node ≥22.22.2 · MIT-licens · omniroute.online}