# README (Norsk) 🌐 **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) · 🇮🇳 [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) · 🇸🇪 [sv](../sv/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 gratis AI-gatewayen

OmniRoute — Slutt aldri å kode. Alle AI-verktøy → 372 leverandører — 150+ gratis — gjennom ett endepunkt. Claude Code, Codex, Cursor, Cline, Copilot og Antigravity inn i GRATIS Claude / GPT / Gemini med automatisk reservebytte. Stablet RTK- + Caveman-komprimering sparer 15–95 % tokens (~89 % i gjennomsnitt) — nå aldri grensene. 372 AI-leverandører · 150+ gratisnivåer · ~1,62 mrd. gratis tokens/mnd. · 19 rutingsstrategier · $0 for å komme i gang.

## 💰 ~1.62B tokener / måned på tvers av gratisnivåer hos tredjeparter

> **Bruk dine egne leverandørkontoer.** Dette er et estimert samlet antall på tvers av gratisnivåer hos tredjeparter som du må kvalifisere for separat, ikke en tildeling av tokener fra OmniRoute. Registrer deg, skaff påloggingsinformasjon der det kreves, og koble til leverandørene du kan bruke. Hver leverandør bestemmer sine egne grenser, sin egen tilgjengelighet og sine egne vilkår. > > Det er tungvint å kombinere gratisnivåer manuelt — dusinvis av SDK-er, dusinvis av hastighetsgrenser og ingen oversikt over hvor mye du faktisk har. OmniRoute katalogiserer **489 oppføringer for gratisnivåer fordelt på 35 gjentakende poolnøkler** og beregner det oppgitte tokenantallet fra de **17 poolene med et publisert positivt månedsbudsjett samt fem Groq-grenser per modell**, deduplisert etter delt pool. Kvoter som bare blir tilgjengelige etter en regional identitetskontroll (for øyeblikket: ModelScope), vises separat som +~6M bak regional identitetsverifisering og regnes aldri med i hovedtallet. Resultatet forblir synlig i kontrollpanelet (`/dashboard/free-tiers`).

OmniRoute-budsjettkort for gratisnivåer: stabile ~1.62B gratis tokener per måned, opptil ~2.22B den første måneden med registreringskreditter, fra 35 dokumenterte gjentakende poolnøkler som dekker 489 katalogiserte oppføringer for gratisnivåer bak ett endepunkt. Ærlig matematikk deduplisert etter pool — hver delte pool telles én gang, inkludert 17 gjentakende pooler med et publisert positivt månedlig tokenbudsjett samt fem Groq-grenser per modell; 13 leverandører er merket avoid i katalogen over vilkårsrisiko, slik at du kan bestemme selv. Budsjettlinjen inkluderer Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (fem grenser per modell) og mindre pooler, i tillegg til registreringskreditter for den første måneden og permanent gratis leverandører uten tokengrenser som vises separat, slik at de aldri blåser opp hovedtallet. Direktevisning av brukt/gjenstående på /dashboard/free-tiers.

> Animert sammendrag av den aktive siden `/dashboard/free-tiers`. Fullstendig metodikk (pooldeduplisering, kredittnivåer, leverandørvilkår): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Disse tallene revideres på nytt annenhver uke mot den aktive katalogen og **beveger seg begge veier** — avslutter en leverandør et gratisnivå, synker tallet; kommer et nytt til, stiger det. Vi publiserer det katalogen faktisk beregner, aldri et oppjustert bestefall.}

⭐ Gi repoet en stjerne hvis OMNIROUTE har hjulpet deg med å spare penger og gjøre arbeidet enklere.

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

[![Rangering for stjernehistorikk](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) ### 💬 Bli med i fellesskapet **👋 Følg vedlikeholderen — få nye leverandører, utgivelser og tips først:** [![Følg 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ølg @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 Brasil](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) [![Nettsted](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Spørsmål, leverandørtips, veikart og støtte → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globalt](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](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 fortsetter å vokse

| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | ----------------------------- | :--------------------: | :---------: | :-------------------: | | 🌐 Leverandører | 352 | **358** | 372 | | 🧠 Unike chatmodell-ID-er | 1320 | **1374** | 1443 | | 🖼️ Modalitetsbro | 🆕 bilde + lyd + video | ✓ | ✓ | | 📡 Radars gratiskatalog | 🆕 valgfri aktivering | ✓ | ✓ | | ⚖️ Kvoteorientert planlegging | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kvotetelemetri | 🆕 sanntid | ✓ | ✓ | | 🧰 Hodeløs modus | — | — | 🆕 `serve --headless` | | 🛤️ Infrastruktur for LTS-spor | — | — | 🆕 utgivelseskanaler | **→ [Veikart](ROADMAP.md) — følger sporet mot `v3.9.0 LTS`**

## 🧩 Tilgjengelig [![npm-versjon](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM månedlig](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) [![Lisens: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker-nedlastinger](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron-nedlastinger](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Start	🚀 Hurtigstart	📦 Installer	🆓 Ingen konfigurasjon
💡 Lær	💥 Løftet	🤔 Hvorfor OmniRoute	🏆 Det som skiller OmniRoute ut
⚙️ Funksjoner	🎯 Kombinasjoner	🌐 Leverandører	🔌 CLI og MCP
	🗜️ Komprimering	🖥️ Hvor det kjører	🔒 Privat
👀 Se det	🎬 I bruk	✨ Nyheter	🤖 Kompatible CLI-er
💚 Støtte	💚 Støtt / doner	💬 Fellesskap	💖 Sponsorer
📦 Prosjekt	🛠️ Teknologistabel	📖 Dokumentasjon	👥 Bidragsytere

🌐 På 67 språk

## 🆓 Installer, koble til en leverandør, og rut deretter gjennom ett endepunkt

Tre trinn: Installer og start OmniRoute, koble til en kvalifisert leverandør med din egen konto eller API-nøkkel, og pek deretter verktøyet ditt mot localhost:20128/v1 ved hjelp av en OmniRoute API-nøkkel og modellen auto. Ruting avhenger av tilgjengelige kvalifiserte tilkoblinger og leverandørbegrensninger.

```bash # Etter at du har koblet til en leverandør, kopierer du OmniRoute-nøkkelen din fra Kontrollpanel → Endepunkter: 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` krever en kvalifisert rute. En ny installasjon kan mangle kvalifiserte nøkkelfrie mål, og en nøkkelfri leverandør kan avvise tredjepartsklienter. Leverandører merket med `tos: avoid`, inkludert OpenCode Free og Kiro, er som standard ekskludert fra automatisk ruting. Tilkobling av en konto overstyrer ikke denne innstillingen. Se [veiledningen for gratisnivåer](docs/getting-started/FREE-TIERS-GUIDE.md) før du velger en leverandør.} _{📦 Kopier-og-lim-inn-hurtigstartskript for **Python, Node.js, PHP og cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Løftet

# 🤔 Hvorfor OmniRoute?

OmniRoute-forespørselsflyt: IDE-en eller CLI-verktøyet ditt (Claude Code, Cursor, Cline…) kaller ett lokalt endepunkt (http://localhost:20128/v1); OmniRoute Smart Router (RTK + Caveman-komprimering, 19 rutingsstrategier, effektbrytere, TLS-kamuflasje, MCP, A2A, rekkverk) kan bruke reservekobling på tvers av 4 leverandørnivåer så lenge et kvalifisert, friskt mål er tilgjengelig — Nivå 1 Abonnement, Nivå 2 API-nøkkel, Nivå 3 Rimelig og Nivå 4 Gratis.

## 🤝 Støttet av våre åpen kildekode-venner

> **Vil du bli med som en åpen kildekode-venn?** Dette er selskapene som støtter åpen kildekode og hjelper OmniRoute med å holde det gående – og vi sier offentlig hvor hver token de gir oss går. Ta kontakt: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Takk til Kimi (Moonshot AI), vår grunnleggende åpen kildekode-venn, for å støtte dette prosjektet! Kimi er AI-laboratoriet bak de åpen-vektede K2- og K3-modellfamiliene – Kimi K3 leverer et 1M-token kontekstvindu, innebygd syn og grense-nivå koding til en brøkdel av prisen for lukkede modeller, og fungerer ut av boksen med Claude Code, Codex og alle kodingsverktøy OmniRoute tilbyr.

Hva Kimis støtte driver: Kimis API-kreditter driver OmniRoutes AI-validerte utgivelses-pipeline – sammenslåingsvalideringen drevet av Kimi K3-stadiet som gjennomgår hver pull-forespørsel før den sendes – pluss daglig funksjonsutvikling. Førsteklasses Kimi-støtte leveres på begge måter: den direkte Kimi API (kimi-k3) og Kimi Code kodingplanen (OAuth og API-nøkkel). OmniRoute er også det første brasilianske åpen kildekode-prosjektet i Kimis støtteprogram. Få en Kimi API-nøkkel med 15 % ekstra kreditter →

Cheaper Inference
_{cheaperinference.com} Takk til Cheaper Inference, en OmniRoute åpen kildekode-venn, for å støtte dette prosjektet! Cheaper Inference er en kostnadsrangert gateway som videreselger 42 grensemodeller – Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok og MiniMax – bak ett OpenAI-kompatibelt endepunkt, og ruter hver forespørsel til den billigste kvalifiserte leverandøren uten å noensinne ta mer enn modellprodusentens listepris.

Førsteklasses støtte i OmniRoute: Chat Completions, det native /v1/responses-endepunktet, visjon, verktøykall og 3 bildemodeller (grok-imagine, nano-banana-pro, nano-banana-2, tilgjengelig som cheaperinference/<model>). Få en API-nøkkel →

_{Lenker merket aff=omniroute er partnerlenker. De finansierer prosjektet uten ekstra kostnad for deg.}

_{🎟️ Affiliates Promo — gratis registreringskuponger fra leverandører vi ikke sponser (klikk for å utvide)}

_{Denne seksjonen er kun for henvisnings-/kupongkoder. Sponsede partnerskap finnes i 🤝 Støttet av våre åpen kildekode-venner ovenfor. OmniRoute har ingen sponsing eller partnerskap med leverandørene som er oppført her – dette er offentlige kuponger som alle kan bruke.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — affiliate-registrering · $100 gratis kreditter ved registrering (gratis server, forvent høyere latens – best for testing, ikke produksjon). Førsteklasses støtte i OmniRoute siden v3.8.50: Chat Completions, det Anthropic-kompatible trådformatet og den OpenAI-kompatible stien. Tilgjengelige modeller inkluderer claude-opus-4-8, claude-opus-5, gpt-5.6-sol og mer. Hent dine $100 →}

_{⚠️ Affiliate-lenke — OmniRoute har ingen sponsing eller partnerskap med denne leverandøren.}

_{Kjenner du en annen leverandør med en generøs gratis registreringskupong som gagner OmniRoute-brukere? Åpne en sak, så legger vi den til her.}

## 🎯 Kombinasjoner — flaggskipet

Alle de 19 rutingstrategiene for kombinasjoner animert — én rute per strategi: prioritet, fyll først, vektet, rundgang, p2c, minst brukt, tilfeldig, strengt tilfeldig, kostnadsoptimalisert, ledig kapasitet, tilbakestillingsvindu, tilbakestillingsbevisst, kontekstoverføring, kontekstoptimalisert, hurtigbufferoptimalisert, lkgp, automatisk, fusjon, pipeline. Se tabellen ovenfor for hva hver av dem gjør.

> En **kombinasjon** er en kjede av modeller som OmniRoute ruter mellom **automatisk**. Hvis kvoten brukes opp, en leverandør svikter eller kostnadene øker kraftig, kan kombinasjonen gå videre til neste kvalifiserte, friske modell. 🛡️ ### ⚡ Null konfigurasjon — bare bruk `auto` Ingen kombinasjon trenger å opprettes. Sett modellen din til `auto` (eller en variant), så bygger OmniRoute en virtuell kombinasjon fra de tilkoblede leverandørene dine, vurdert i sanntid:

Modell-ID	Hva den optimaliserer for
`auto`	🎯 Balansert standardvalg (LKGP — holder seg til den sist fungerende leverandøren)
`auto/coding`	🧑💻 Kvalitetsprioriterte vekter for kodegenerering
`auto/fast`	⚡ Laveste latenstid først
`auto/cheap`	💰 Laveste kostnad per token først
`auto/offline`	🔋 Mest ledig kapasitet for kvoter/frekvensgrenser først
`auto/smart`	🔭 Kvalitet først + 10 % utforsking for å oppdage bedre modeller
`auto/lkgp`	📌 Eksplisitt tilknytning til sist fungerende leverandør
`auto/chaos`	🧪 Parallell utsending til et panel av modeller (én per leverandør, 5 som standard), returnerer ett svar; ett oppstrømskall per panelmodell, ikke feilinjeksjon

## ### 🔀 Eller bygg din egen — 19 rutingstrategier Alle **19** strategiene — bland og kombiner per kombinasjonstrinn:

#	Strategi	Hva den gjør
1	`priority`	Ordnet liste med første mål prioritert — bruk opp hvert mål før det neste 🥇
2	`fill-first`	Fyll kvoten til hvert mål helt før du går videre
3	`weighted`	Vektet tilfeldig valg basert på vekten til hvert mål
4	`round-robin`	Gå gjennom målene i rekkefølge
5	`p2c`	Tilfeldig lastbalansering med valg mellom to alternativer
6	`least-used`	Velg målet med lavest gjeldende belastning
7	`random`	Ensartet tilfeldig valg (duplikater fjernes)
8	`strict-random`	Tilfeldig uten å fjerne gjentakelser 🎲
9	`cost-optimized`	Minimer $ per forespørsel basert på gjeldende katalogpriser 💸
10	`headroom`	Velg målet med mest gjenværende kvote
11	`reset-window`	Foretrekk målet med kvotevinduet som tilbakestilles først
12	`reset-aware`	Ranger etter tidspunkt for tilbakestilling av kvoten — korte vinduer først 📊
13	`context-relay`	Overfør kontekst mellom mål for lange samtaler 🧠
14	`context-optimized`	Velg det beste alternativet for gjeldende kontekststørrelse
15	`cache-optimized`	Fest hvert gjenbrukbare ledetekstprefiks til samme konto — maksimer treff i ledetekst-hurtigbufferen 🎯
16	`lkgp`	Sist fungerende rute — festes til den sist fungerende leverandøren og går deretter tilbake til reglene ved behov
17	`auto`	Sanntidsvurdering basert på 16 faktorer på tvers av alle tilkoblinger 🤖
18	`fusion`	Sender ut til et panel av modeller + en dommer sammenfatter ett svar 🧬
19	`pipeline`	Kjed sammen trinn — resultatet fra hvert mål mates inn i det neste 🔗

_{Auto-Combo-motoren vurderer hver kandidat ut fra **16 faktorer** (helsetilstand, kvote, kostnad, latenstid, oppgavetilpasning, kvalitet, økttilgjengelighet …) — se [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Robusthet er innebygd (3 uavhengige lag)

OmniRoute-resiliens — 3 uavhengige selvhelende lag, riktig lag for riktig feil. Lag 1: kretsbryter for leverandør (hele leverandøren): utløses bare ved 408/5xx, terskler OAuth 8× / API-nøkkel 12× / lokal 2×, tilbakestilles etter 60s/30s/15s til en HALVÅPEN test, behovsstyrt gjenoppretting; mens den er ÅPEN, omdirigerer kombinasjonen til neste leverandør. Lag 2: nedkjøling av tilkobling (én nøkkel/konto): basis 5s OAuth / 3s API-nøkkel, eksponentiell ×2-tilbakeholding med beskyttelse mot samtidige forespørsler, 429 respekterer Retry-After, en vellykket forespørsel nullstiller all feiltilstand; én nøkkel under nedkjøling hoppes over mens andre nøkler fortsetter å betjene forespørsler. Lag 3: modellsperre (én modell): 429 per modell, lokal 404 eller modusavslag sperrer bare den aktuelle modellen — aldri hele tilkoblingen. Terminaltilstander (utestengt, utløpt, oppbrukte kreditter) må håndteres av operatøren, ikke med nedkjøling.

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

## 🏆 Hva som skiller OmniRoute fra andre

_{📊 Fullstendig metodikk og detaljert sammenligning av hver funksjon med 9router, OpenRouter, CLIProxyAPI og LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Støtt OmniRoute OmniRoute er MIT-lisensiert og vedlikeholdes åpent. Hvis det sparer deg for tid eller penger, kan du bidra til å holde det uavhengig — velg det som passer deg. Sponsing påvirker aldri rutingsprioriteten; det kjøper synlighet, ikke rangering.

⭐ Gi repoet en stjerne	Gratis — bidrar virkelig til synligheten	Gi OmniRoute en stjerne
🐙 GitHub Sponsors	Engangsbeløp eller månedlig · ingen plattformavgift	github.com/sponsors/diegosouzapw
☕ Ko-fi	Raskt engangsbidrag, uten registrering for giveren	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	En liten, uformell gest	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Gjentakende · ideell · åpen kildekode	liberapay.com/diegosouzapw
🇧🇷 PIX (Brasil)	Umiddelbart, uten gebyrer	nøkkel og QR-kode nedenfor
₿ Kryptovaluta	BTC · ETH · USDT-TRC20 · USDC-Solana	adresser nedenfor

**🇧🇷 PIX** — umiddelbart, uten gebyrer (Brasil) QR-kode for OmniRoute PIX

Nøkkel (tilfeldig): `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 (klikk for å utvide)

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

_{⚠️ Send hver valuta kun via nettverket som vises — sending via feil nettverk kan føre til at midlene går tapt.}

🐛 Funnet en feil eller har du tilbakemeldinger? Start en [diskusjon](https://github.com/diegosouzapw/OmniRoute/discussions).

Merknader for utviklere: Prosjektet kan generere en lokal .env-fil under npm install/postinstall for å gjøre det enklere for utviklere. Denne filen ignoreres med hensikt via .gitignore (se .gitignore) og må aldri legges inn i repositoriet — hvis den ved et uhell blir lagt inn, må alle eksponerte hemmeligheter roteres og filen fjernes fra historikken. Se docs/DEVELOPER-ENVIRONMENT.md for veiledning om håndtering av lokale miljøfiler og hemmeligheter.

## 📡 OmniRoute Radar Hovedtallet for gratisnivået er fortsatt **~1,62 mrd. tokens/måned** fra den dokumenterte, utvalgsduplikatfjernede katalogen ovenfor. Midlertidige registreringskreditter fra leverandører kan separat øke den første måneden til **~2,22 mrd.** Radar er et valgfritt, signert katalogoverlegg for dem som ønsker mer oppdatert tilgjengelighet av gratismodeller mellom OmniRoute-utgivelser. Fellesskapskatalogen og alle eksisterende gratisfunksjoner forblir gratis. Støttespillere kan motta den oppdaterte katalogen og flere leverandørmuligheter. Den separate, variable øvre grensen er **maksimalt omtrent 3 mrd. tokens/måned**, avhengig av leverandørtilgjengeligheten. Denne grensen er ingen garanti: Leverandører kan når som helst endre kvoter, kvalifikasjonskrav, modeller eller regioner. Radar er valgfritt og bruker kun GET. OmniRoute-klienten laster ikke opp ledetekster, trafikk, leverandørkonfigurasjon, brukstelemetri eller lokal status for avviste kunngjøringer. Les mer om kvalifikasjonskravene og den gjeldende katalogen på **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Hva er nytt

> Nylige høydepunkter fra **v3.8.20 → v3.8.50**. Full historikk i [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — innkommende A2A-delegering til agentflåten din, Conductor-ferdigheter på agentkortet og et kontrollpanel med Faro-talekommunikasjon via trykk-for-å-snakke. → [A2A-server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptivt inntak og overbelastningsvern** — ressurskrevende chatforespørsler settes i kø i stedet for å returnere 503, med atomiske, rullerende RPM-leieavtaler per tilkobling. → [Veiledning for robusthet](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonisk rekkefølge for `/v1/models`** — én sammenhengende, leverandørgruppert blokk per leverandør (kombinasjoner festet først), stabil på tvers av alle katalogkilder. → [API-referanse](docs/reference/API_REFERENCE.md) - **🗜️ Forsterket komprimering** — inflateringsvern aktivert som standard, Caveman-pakker for DE / FR / JA + kinesisk (wényán), RTK-filtre for Gradle og .NET. → [Komprimering](docs/compression/COMPRESSION_ENGINES.md) - **💸 Ærlige fastpriskostnader** — abonnements-/kodeplanleverandører vises med **$0** i kostnadsanalysen; budsjett, kvoter og ruting fortsetter å estimere. → [API-referanse](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share-ruting** — fordel kvoten til en delt konto rettferdig mellom samlede nøkler, med arbeidsbevarende utlån av ubrukte andeler. → [Veiledning for robusthet](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 CLI-/agentoppsett med én kommando** — 13 registrerte `setup-*`-kommandoer; `omniroute run` starter 7 CLI-er (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` støtter 10 mål med en interaktiv leverandør- og modellvelger samt favoritter per kontekst. → [CLI-integrasjoner](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Ekstern modus** — styr en ekstern OmniRoute med avgrensede tokener (`connect` / `contexts` / `tokens`) + en `antigravity` OAuth-hjelper for VPS-installasjoner. → [Ekstern modus](docs/guides/REMOTE-MODE.md) - **🧭 Smartere automatisk ruting** — `auto/:`-kombinasjoner, **Fusion** (modellpanel + dommer), oppgavebevisst ruting samt overstyringer av modell / modus / USD-budsjett per forespørsel. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Utvidbar komprimering** — 12 kombinerbare motorer + Compression Studios: LLMLingua-2, todelt Ultra, omniglyph, nøyaktighetsport per trinn, GCF v3.2 og dra-og-slipp-redigering av rekkefølgen. → [Komprimering](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparent MITM-dekryptering (TPROXY)** — fang opp CLI-er som ignorerer proxy-miljøvariabler, med en CA per SNI og installasjonsprogram for klareringslageret. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Kostnadstelemetri overalt** — `X-OmniRoute-*`-headere for kostnad/bruk på alle endepunkter, header for besparelser ved cache-HIT og USD-forbrukskvoter per nøkkel. → [API-referanse](docs/reference/API_REFERENCE.md) - **🧠 Minne du kontrollerer** — deaktivert som standard, valgfri int8-vektorkvantisering + typet forringelse, og `x-omniroute-no-memory` per forespørsel. → [Minne](docs/frameworks/MEMORY.md) - **🛡️ Sikkerhet** — vern mot promptinjeksjon på alle LLM-ruter (red-team-testsamling), valgfritt vern for maskering av påloggingsopplysninger (sladder lekkede API-nøkler/hemmeligheter i begge retninger), gratis DuckDuckGo-nettsøk som siste utvei og en valgfri OIDC-påloggingsport for kontrollpanelet (passordpålogging forblir alltid tilgjengelig). → [Sikkerhetsmekanismer](docs/security/GUARDRAILS.md) - **🖼️ Nye endepunkter** — `/v1/ocr` (Mistral OCR) og `/v1/audio/translations` (Whisper-stil) kompletterer medietilbudet. → [API-referanse](docs/reference/API_REFERENCE.md) - **🎨 Bilde-/video-/lydgenerering** — ett API for medier: xAI Grok Imagine og Novita AI-video, ComfyUI, Magnific, Adobe Firefly, Segmind og taleleverandører som ElevenLabs. → [API-referanse](docs/reference/API_REFERENCE.md) - **🌍 Distribusjon og drift** — `basePath` for omvendt proxy, automatisk registrering av nettleserspråk, enhetssporing per nøkkel, rotløs MITM-klarering og zh-TW-lokalisering. → [Miljø](docs/reference/ENVIRONMENT.md) - **🤝 Flere leverandører og agenter** — skyagenter (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) med nettleser- og OAuth-pålogging, førsteklasses Ollama-kort, Claude Opus 5 og Sonnet 5, offisielt Kimi-partnerskap (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI … og en oppdatert **katalog med 352 leverandører**. → [Leverandører](docs/reference/PROVIDER_REFERENCE.md) - **📡 Gjennomsiktig ruting** — alle svar inneholder en `X-OmniRoute-Decision`-header som oppgir strategien/leverandøren/ventetiden som betjente forespørselen, en ny `cache-optimized`-kombinasjonsstrategi + Auto-Combo-faktoren `cacheAffinity` ruter gjentatte forespørsler tilbake til tilkoblingen som har det bufrede prefikset, og et skrivebeskyttet `/v1/auto-combo/{channel}/candidates`-endepunkt viser den aktive kandidatpoolen til en `auto/*`-kanal. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokal ytelse og infrastruktur** — lokal Redis med ett klikk, distribusjonsverktøy for Cloudflare Workers / Deno Deploy-reléer samt Bifrost og Mux som overvåkede, innebygde tjenester. → [Innebygde tjenester](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Også inkludert** — programtilleggsrammeverk + markedsplass, rammeverk for Omni-/Agent-/GitHub-ferdigheter, Obsidian-hvelvintegrasjon (22 MCP-verktøy), OpenAI-kompatible Batch- og Files-API-er, semantisk svarbuffer, spillifisering med resultatlister, ACP-agentoppdagelse (15 innebygde agenter), planlagt loggeksport til BigQuery, parallell utsending til flere modeller med `auto/chaos`, en Telegram-brobot, en versjonsbehandler i appen og LMArena-ELO-rangeringer av gratisleverandører. → [Dokumentasjon](docs/README.md)

## 🤖 Kompatible CLI-er og kodeagenter > Én konfigurasjon — `http://localhost:20128/v1` — og **alle** AI-IDE-er eller CLI-er kjører på gratis og rimelige 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

＋ fungerer også med · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · alle OpenAI-kompatible verktøy

_{📖 Verktøyspesifikt oppsett for alle de 36 verktøyene (26 CLI-kodeverktøy + 10 CLI-agenter) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode-programtillegg → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Start et hvilket som helst støttet CLI-verktøy gjennom OmniRoute med én kommando** — ingen konfigurasjonsfiler skrives, legitimasjon injiseres per prosess, og Qwen/Gemini får en midlertidig, isolert hjemmekatalog: ```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 velg leverandør og modell interaktivt, og skriv verktøyets egen konfigurasjon: omniroute configure codex # også: claude opencode qwen aider goose gemini cline continue kilo ``` Alle kommandoer respekterer den aktive eksterne konteksten (`omniroute connect `), `--dry-run` forhåndsviser nøyaktige miljøvariabler og argumenter uten å kjøre noe, og `--api-key-env NAME` holder hemmeligheter ute av skallhistorikken din. → [CLI-integrasjoner](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 372 KI-leverandører — 154 gratismerket i katalogen

> **372 registrerte leverandører** på tvers av de kanoniske samlingene for chat, medier, søk, lokale modeller, skyagenter og systemer, inkludert **154 med søkemetadataene `hasFree: true`**. Registeret over chatmodeller dekker **237 leverandører / 3 009 unike leverandør–modell-par / 1 443 rå modell-ID-er**; den separate gratiskvote-katalogen har **491 rader per modell**, **35 gjentakende kvotepuljer** og **54 gjentakende/nøkkelfrie leverandører som er gratis for alltid**. Disse nevnerne er ulike med hensikt; definisjoner og beregninger der kvotepuljer er deduplisert, finnes i [Leverandørreferansen](docs/reference/PROVIDER_REFERENCE.md) og [Gratisnivåer](docs/reference/FREE_TIERS.md).

### 🏢 Alle store laboratorier — gjennom ett endepunkt

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

_{…og over 330 flere — hvert ikon hentes direkte fra kontrollpanelets leverandørkatalog. 📖 [Leverandørreferanse](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Gratis for alltid — $0, uten kort

OpenCode Zen _{DeepSeek V4, Nemotron 3 Ingen tokenbegrensning}	Kilo Code _{Automatisk ruter, Tencent Hy3 Gratis for alltid}	Requesty _{GPT-OSS 120B, Nemotron Gratis for alltid}	SiliconFlow _{DeepSeek V3.2 / R1 Gratisnivå}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Gratis for alltid}	Baidu ERNIE _{ERNIE 4.0 Gratis for alltid}
Qoder AI _{Qwen3-Max, Kimi-K2 Ubegrenset og GRATIS}	Pollinations _{GPT, Llama, Claude Ingen nøkkel nødvendig}	Cloudflare AI _{50+ modeller 10K nevroner/dag}	NVIDIA NIM _{GLM, MiniMax ~40 RPM gratis}	Cerebras _{GLM 4.7, GPT-OSS Engangskreditt på $5; kort kreves}	OpenRouter _{:free-modeller +$10 → høyere RPM}

📖 Fullstendig maskinlesbar katalog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Hvor OmniRoute kjører — hvor som helst

> Samme app, din maskin, dine regler. Fra en global npm-installasjon til **telefonen din** via Termux.

Plattform	Installasjon	Høydepunkter
📦 npm (globalt)	`npm install -g omniroute`	Én kommando, alle operativsystemer
🐳 Docker	`docker run … diegosouzapw/omniroute`	Flerarkitektur: AMD64 + ARM64
🖥️ Skrivebord (Electron)	`npm run electron:build`	Integrert vindu + systemstatusfelt — Windows / macOS / Linux
🎩 Menylinje (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Overvåker og autooppdaterer serveren — macOS
💪 ARM	integrert `arm64`	Raspberry Pi, ARM-servere, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Kjører på telefonen din, døgnet rundt, uten root
📲 PWA	«Legg til på startskjermen»	Fullskjerm, frakoblet, kan installeres fra nettleseren
🧩 OpenCode-programtillegg	`@omniroute/opencode-provider`	Integrert OpenCode-integrasjon
🤖 VS Code Copilot Chat	installer OmniCopilot-utvidelsen	Alle OmniRoute-modeller i den integrerte modellvelgeren i Copilot Chat — stabilversjon og Insiders
🛠️ Fra kildekode	`npm install && npm run dev`	Tilpass den, bidra

_{📖 [Docker-veiledning](docs/guides/DOCKER_GUIDE.md) · [Skrivebord](electron/README.md) · [Menylinjeapp](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 integrerte Copilot Chat

> Ingen ny sidestolpe, ikke noe nytt chatgrensesnitt — alle modellene OmniRoute leverer, vises direkte i > **modellvelgeren i Copilot Chat som du allerede bruker**. Fra og med VS Code 1.122 fungerer leverandørmodeller > uten GitHub-innlogging eller Copilot-abonnement — agentmodus, verktøykall og bildeanalyse, > helt gratis. Installer utvidelsen **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, koble den til OmniRoute-serveren din (standard er `localhost:20128`), og åpne deretter Copilot Chat → modellvelger → **Administrer modeller…** → **OmniRoute**.

Butikk	Lenke	Fungerer med
🧩 VS Code Marketplace	Installer →	VS Code — stabilversjon og Insiders
🔓 Open VSX Registry	Installer →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Fra redigeringsprogrammet: åpne visningen **Utvidelser**, søk etter **«OmniRoute»**, og klikk på **Installer** — fungerer på samme måte i begge butikkene. Kildekode, saker og publiseringshåndboken finnes på [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Veiledning for VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — oppsett, hva modellvelgeren viser, kontrollpanel i en fane, feilsøking}

### 🎩 Nytt: OmniRouteTray — gatewayen din, rett i menylinjen

> `omniroute serve` trives best når den alltid er på. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > gjør dette til en menylinjeapp for macOS som du kan sette opp og glemme: Den starter serveren, holder den i gang > på tvers av omstarter, oppdaterer den på stedet og gir deg direkte tilgang til gjeldende tokenbudsjett med ett klikk — **uten > et terminalvindu som står åpent, og uten en `npm install -g omniroute`-installasjon som må passes på.** Den er bygget med [Tauri v2](https://v2.tauri.app/) (en Rust-kjerne på størrelse med en avrundingsfeil) og leveres med sin egen signerte Node 24-kjøretid. Den administrerer en appeid OmniRoute-installasjon, slik at den aldri kommer i konflikt med din globale `node`/`bun`. Den **deler den eksisterende konfigurasjonen og databasen din i `~/.omniroute/`** — så det er den samme OmniRoute du allerede kjører, bare med hatt på. 🎩

Hva den gjør	Hvordan
🟢 Overvåker serveren	Starter `omniroute serve` og overtar en instans som allerede kjører, i stedet for å duplisere den
📊 Direkte bruksoversikt	Kvotelinjer for leverandører, økt- og ukesgrenser for Claude med nedtelling til tilbakestilling, kostnadsfordeling for 30 dager
🔄 Autooppdaterer på stedet	Trinnvis installasjon, atomisk bytte, tilbakerulling ved feil — alltid på den nyeste utgivelsen
🚀 Start ved innlogging	Valgfri oppstart ved innlogging; kun systemstatusfelt, uten Dock-ikon
🩺 Diagnostikk og logger	Diagnostikk med ett klikk og tilgang til serverlogger

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Foretrekker du en nedlasting? Hent den nyeste .dmg-filen fra
Utgivelser. Kildekode, feilrapporter og byggedokumentasjon
finner du på zoispag/omniroute-tray.

💛 Et fellesskapsprosjekt av @zoispag — ikke en offisiell OmniRoute-utgivelse.}

## 🔒 Privat og lokal-først

_{📖 [Autorisasjon](docs/architecture/AUTHZ_GUIDE.md) · [Beskyttelsesmekanismer](docs/security/GUARDRAILS.md) · [Samsvar](docs/security/COMPLIANCE.md)}

## 🔌 Komplett CLI + A2A og MCP

> I tillegg til serveren er OmniRoute et **komplett kommandolinjekontrollsenter** med **over 80 kommandoer**, samt åpne agentprotokoller slik at en KI-agent kan styre det **på egen hånd**. ### ⌨️ Et ekte CLI (ikke bare `start`) ```bash omniroute # kjør gateway + kontrollpanel (port 20128) omniroute chat # interaktiv TUI-chatklient (skråstrek: /model /combo /skill /memory) omniroute setup # veiledet oppstartsveiviser omniroute doctor # diagnostiser leverandører, porter og plattformspesifikke avhengigheter ``` ### 🛰️ Ekstern modus — kjør CLI-et her og OmniRoute på en VPS Kjører OmniRoute på en server? Styr det fra den bærbare datamaskinen din med **samme CLI**. Logg inn én gang med et avgrenset tilgangstoken; deretter retter hver kommando seg mot den eksterne serveren. ```bash omniroute connect 192.168.0.15 # passord → avgrenset token, lagret som en kontekst omniroute models list # ← kjører mot den EKSTERNE serveren omniroute configure codex # ← velger en ekstern modell og skriver en lokal Codex-profil omniroute tokens create --name ci --scope read # opprett mer begrensede tokener for andre maskiner omniroute contexts use default # ← bytt tilbake til den lokale serveren ``` Tokener er avgrenset til `read` / `write` / `admin`; ruter som starter prosesser, forblir begrenset til loopback. _{📖 [Ekstern modus](docs/guides/REMOTE-MODE.md)}

Animert terminaldemonstrasjon av OmniRoute CLI — omniroute providers list, omniroute combo list og omniroute health — som går gjennom toppnivågrensesnittets 86 kommandoer: 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 …

### 🤝 Koble til en agent — så styrer den OmniRoute selv Gjør OmniRoute tilgjengelig via **MCP**, **A2A**, et **REST API**, **webhooks** eller et **eksternt CLI** — enhver agent med nødvendig funksjonalitet (eller din egen kode) får nøklene til hele gatewayen: ruting, leverandører, kombinasjoner, hurtigbuffer, komprimering og minne — autonomt. HTTP-endepunktene nedenfor er tilgjengelige under `http://localhost:20128`.

Grensesnitt	Endepunkt / kommando	Bruk det til
🧰 MCP (stdio)	`omniroute --mcp`	Koble til Claude Desktop, Cursor eller en hvilken som helst MCP-klient
🌊 MCP (HTTP)	`/api/mcp/stream`	Ekstern MCP — 110 verktøy, 33 omfang (håndheving er valgfritt), komplett revisjonsspor
📡 MCP (SSE)	`/api/mcp/sse`	Strømmende MCP-transport
🤝 A2A	`/.well-known/agent.json`	Agent-til-agent, JSON-RPC 2.0 + SSE, 6 ferdigheter
🌐 REST API	`/v1/*`	OpenAI-kompatibelt — chat, innebygginger, bilder, lyd, OCR
🔔 Webhooks	`/api/webhooks`	Send forespørsels-/kvotehendelser til Slack, Discord, Telegram eller en hvilken som helst URL
🛰️ Eksternt CLI	`omniroute connect`	Styr en ekstern instans med avgrensede tilgangstokener

```bash # Gi Claude Code hele OmniRoute-verktøysettet 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) · [Agentprotokoller](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Spar 15–95 % tokens — automatisk

### 📖 Slik fungerer det — pipeline, arkitektur og beregning av besparelser

OmniRoute-komprimeringspipeline: En illustrativ klientforespørsel på 10 000 tokens går gjennom 12 kombinerbare motorer — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra og OmniGlyph — og kan nå leverandøren med omtrent 1 080 tokens i det dokumenterte stablede eksempelet. Strukturert innhold beskyttes av bevaringsmekanismer og kvalitetssperrer for hvert trinn. Eksplisitte moduser med tap eller eksperimentelle moduser kan transformere egnet innhold.

Den stablede standardkombinasjonen kjører `RTK → Caveman`. Når begge behandler den samme verktøy-/kontekstnyttelasten, forsterkes besparelsene: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Kodeblokker, URL-er, JSON og strukturerte data er **alltid beskyttet** av bevaringsmotoren. > **Hvorfor bruke mange tokens når noen få gjør jobben?** Hver forespørsel går **transparent** gjennom OmniRoutes komprimeringspipeline — uten endringer på klientsiden. Den er nå en **stabel med 12 kombinerbare motorer** som kjøres i rekkefølge og kan kombineres fritt for hver rutingskombinasjon — basert på ideer fra [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) og [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Stabelen med 12 motorer Motorene kjøres i pipeline-rekkefølge. Hver av dem kan slås av eller på og konfigureres uavhengig for hver kombinasjon:

#	Motor	Hva den gjør
1	Session-Dedup	Fjerner innhold som gjentas på tvers av turer (innholdsadressert, på tvers av turer)
2	CCR	Arkiverer store blokker bak hentemarkører og henter dem ved behov
3	Lite	Reduserer blanktegn og bilde-URL-er (grunnnivå med lav latens)
4	RTK	Smart filtrering, deduplisering og avkorting av verktøyresultater (kommandobevisst)
5	Responses Tool Output	Primært tapsfri JSON-komprimering samt begrenset diagnostisk komprimering av utdata fra skall, patcher, søk og bygging (Responses API)
6	Headroom	Tapsfri tabellkomprimering av JSON-matriser (~30 %) via en medfølgende GCF-kodek
7	Relevance	Ekstraktiv poengsetting av setninger mot den siste brukerforespørselen
8	Caveman	Regelbasert komprimering av prosa (~65–75 % av utdataene)
9	Aggressive	Oppsummering og gradvis aldring av gamle turer
10	LLMLingua-2	ML-basert semantisk beskjæring via MobileBERT ONNX — trygg for kode, asynkron
11	Ultra	Heuristisk tokenbeskjæring med et valgfritt lite modellnivå (SLM)
12	OmniGlyph	Eksperimentell koding av kontekst som bilde for målte Claude Fable 5 direkte over Anthropic-forbindelsen. GPT 5.6-transformatorer forblir lukket ved feil i påvente av kvitteringer fra leverandøren. Fire komprimeringsprofiler (aggressiv som standard, balansert, trygg for koding, passthrough) (mest aggressiv, må aktiveres eksplisitt)

Kodeblokker, URL-er og strukturerte data bevares **alltid** byteperfekt. **Forhåndsinnstillinger med ett klikk** kombinerer motorene:

Modus	Besparelse	Passer best til
🪶 Lite	~15 %	Trygg standard som alltid er aktiv
🪨 Standard (Caveman)	~30 %	Daglig koding
⚡ Aggressive	~50 %	Lange økter med mye verktøybruk
🔥 Ultra	~75 %	Maksimal besparelse
🧰 RTK	60–90 %	Utdata fra skall, tester, bygging og git
🔗 Stablet (RTK → Caveman)	78–95 %	Blandede ledetekster og verktøylogger

**Reelt eksempel — Standard-modus:** > **Før (69 tokens):** _«Årsaken til at React-komponenten din gjengis på nytt, er sannsynligvis at du oppretter en ny objektreferanse i hver gjengivelsessyklus. Når du sender et innebygd objekt som en prop, oppfatter Reacts overfladiske sammenligning det som et annet objekt hver gang, noe som utløser en ny gjengivelse. Jeg anbefaler å bruke useMemo til å mellomlagre objektet.»_ > > **Etter (19 tokens):** _«Ny objektreferanse ved hver gjengivelse. Innebygd objekt-prop = ny referanse = ny gjengivelse. Pakk inn i useMemo.»_ > > **Samme svar. 72 % færre tokens. Ingen tap av nøyaktighet.** ✅ **PT-BR-eksempel — [Troglodita](https://github.com/leninejunior/troglodita)-modus:** > **Før (42 tokener):** _«Problemet er at komponenten gjengis på nytt fordi en ny objektreferanse opprettes i hver gjengivelsessyklus. Jeg vil anbefale å bruke useMemo.»_ > > **Etter (12 tokener):** _«Ny gjengivelse: ny ref. hver syklus (innebygd objekt opprettes på nytt). Bruk `useMemo`.»_ > > **Samme svar. ~70 % færre tokener. Teknisk presisjon intakt.** ✅
### 🎚️ Utover motorene — utdatastiler, den adaptive bryteren og kontroll per forespørsel De 12 motorene ovenfor reduserer det som går **inn**. Tre ytterligere lag former **hvordan**, **når** og hva som kommer **ut**: - **🪄 Utdatastiler** _(styring langs utdataaksen)_ — injiser deterministiske, hurtigbuffersikre instruksjoner for utforming av svar; kan kombineres, hver med intensiteten `lite` / `full` / `ultra`. En stil legges til med én enkelt oppføring i registeret: - **Konsis prosa** — fjern fyllord / artikler / forbehold; behold det tekniske innholdet nøyaktig. - **Mindre kode** — «lat seniorutvikler»-YAGNI: minste fungerende endring, ingen struktur som ikke er etterspurt. - **Hestehale (lat seniorutvikler)** — klatre opp YAGNI-stigen, løs rotårsaken, minste fungerende diff. - **Jeg har ADHD (handling først)** — start med neste handling, nummererte trinn, ett konkret neste trinn, ingen innledning. - **Konsis CJK (文言)** — ultrakonsis stil på klassisk kinesisk (begrenset til nasjonal innstilling `zh`). - **🎯 Adaptivt kontekstbudsjett** _(bryteren)_ — i stedet for én av/på-terskel for tokener eskaleres bare de rimeligste motorene med minst tap så langt som nødvendig for å **passe innenfor modellens kontekstvindu**. Policy: `reserve-output` (standard, modellbevisst) · `percentage` · `absolute`. Modus: `floor` (garantert plass) · `replace-autotrigger` (det eksplisitte valget ditt vinner) · `off` (eldre terskel). - **🎛️ Hvor komprimering avgjøres** _(prioritet, høy → lav)_ — `x-omniroute-compression`-header per forespørsel › overstyring for rutekombinasjon › aktiv navngitt profil › adaptiv / automatisk utløsing › standardinnstilling i panelet › av. Den anvendte planen gjengis i responsheaderen `X-OmniRoute-Compression: ; source=`. Utløs automatisk basert på tokenterskel, slå på den adaptive bryteren, lås en navngitt profil, angi en engangsinnstilling per forespørsel eller tilordne en prosesseringskjede per rutekombinasjon — velg det som passer arbeidsbelastningen. Et valgfritt frakoblet **evalueringsverktøy** (`npm run eval:compression`) vurderer nøyaktighet mot besparelser på et fast datasett før du tar en endring i bruk. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Hurtigstart

**1) Installer og kjør** ```bash npm install -g omniroute omniroute ``` > 💡 Ser du `npm warn ERESOLVE` eller advarsler om peer-avhengigheter? [De er harmløse](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Bruker du npm 11 eller nyere?** npm kan blokkere livssyklusskript for pakker med mindre de er tillatt. OmniRoutes `postinstall` (`node scripts/build/postinstall.mjs`) er nødvendig for å klargjøre de systemspesifikke kjøretidsfilene. Tillat pakkene som er nevnt i npm-advarselen når du installerer globalt. For pakkesettet rapportert av OmniRoute 3.8.51: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > For å bruke denne tillatelseslisten på nytt ved fremtidige globale installasjoner kan du konfigurere den én gang og deretter installere som normalt: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Listen over avhengigheter kan endres mellom utgivelser. Hvis npm rapporterer en annen liste, bruker du pakkenavnene fra den advarselen. Når en pakke tillates, kan installasjonsskriptene dens kjøres. > **Bruker du Gemini Web eller en annen leverandør basert på nettinformasjonskapsler?** npm-pakken inkluderer > Playwright, men ikke Chromium-binærfilen. Se merknaden om > [oppsett av Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > før du sender den første forespørselen til nettleverandøren. Kontrollpanel på `http://localhost:20128` · API på `http://localhost:20128/v1`. **2) Koble til en kvalifisert leverandør med din egen konto** Kontrollpanel → **Leverandører** → velg en leverandør der gjeldende vilkår og kvote passer bruksområdet ditt → legg til API-nøkkelen eller fullfør kontoprosessen. Gratisnivåer kan kreve registrering, godkjenning eller en betalingsmåte. Les [veiledningen for gratisnivåer](docs/getting-started/FREE-TIERS-GUIDE.md). Tilgjengelighet uten nøkkel er ikke garantert, og leverandører merket med `tos: avoid` ekskluderes som standard fra `auto`. **3) Pek kodeverktøyet ditt mot tjenesten** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Kontroller at det fungerer** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Du skal se en liste over de tilkoblede modellene dine. 🎉 Det var alt — begynn å kode, så ruter OmniRoute automatisk og bruker reserveløsninger for deg. Hvis klienten din ikke kan sende egendefinerte headere, tilbyr OmniRoute også tokeniserte kompatibilitetsaliaser: ```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 ``` Bruk disse bare for klienter som ikke kan legge ved `Authorization: Bearer ...`. Autentisering med header er fortsatt den foretrukne metoden.
## 📦 Flere installasjonsmetoder — Docker, kildekode, 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ølger den høyeste **publiserte** stabile SemVer-versjonen. Den følger ikke git `main`. Fest til `:X.Y.Z` for GitOps. Se [Docker-utgivelseskanaler](docs/guides/DOCKER_GUIDE.md#release-channels).Avbildningen angir **`OMNIROUTE_MEMORY_MB=1024`**. Det er nok for kontrollpanelet og lett bruk av chat. **Kodeagenter** (`POST /v1/responses` fra Claude Code, Codex, Grok, …) trenger en mye større V8-heap, ellers får prosessen `FATAL ERROR` ved ~12 GiB med to overlappende lange kontekster. Dimensjoner containeren større enn heapen (interne buffere ligger utenfor V8): | Arbeidsbelastning | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) | | ---------------------------------- | ---------------------------------- | ---------------------- | | Kontrollpanel / lett bruk av chat | `1024` (standard for avbildningen) | ≥2 g | | Én kodeagent | `8192` | ≥10 g | | To samtidige lange `/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 ``` Fullstendig tabell: [Docker-veiledning — RAM under kjøring](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Docker-kanal for forhåndsutgivelser:** `diegosouzapw/omniroute:next` og > `diegosouzapw/omniroute:next-web` følger den gjeldende standardgrenen `release/v*`. > Disse foranderlige taggene er kun beregnet på testing av rettelser som ennå ikke er utgitt, og > **støttes ikke i produksjon**. Se > [Docker-utgivelseskanaler](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standard `bun install` og global installasjon (`bun install -g omniroute`) støttes gjennom registrering av Bun-kjøremiljøet: - **Innebygd `bun:sqlite`**: OmniRoute bruker Buns innebygde `bun:sqlite`-driver når det kjøres under Bun, og faller tilbake til `better-sqlite3` på Node.js eller `sql.js`. - **Automatisk valg av Webpack-pakker i utviklingsmiljøet**: Utviklingsmiljøet (`bun run dev`) registrerer automatisk Bun og deaktiverer Turbopack til fordel for Webpack for å unngå inkompatibilitet med native V8-bindinger. Produksjonsbygg (`bun run build`) følger `OMNIROUTE_USE_TURBOPACK` på nøyaktig samme måte som på Node: Turbopack som standard, `OMNIROUTE_USE_TURBOPACK=0` for å bygge med Webpack (`Dockerfile.bun` eksponerer den som et `--build-arg`). - **Dedikert Dockerfile for Bun**: Flertrinns `Dockerfile.bun` for native Bun-produksjonsdistribusjoner (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Installer og kjør med Bun bun install bun run dev ``` **🛠️ Fra kildekode** ```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 # Bruk av Nix-flakes nix develop npm run dev # Eller bruk av devbox devbox run npm run dev ``` 📖 [Docker-veiledning](docs/guides/DOCKER_GUIDE.md) — Compose-profiler, Caddy HTTPS, Cloudflare-tunneler. **🦭 Podman** ```bash # 1. Klargjør den bind-monterte datakatalogen mkdir -p data # 2. Kun Linux + lokal rotløs Podman (aldri en ekstern Podman Machine-klient): podman unshare chown 1000:1000 ./data # 3. Angi kjøretidshintet, bygg det lokale Compose-avbildningen og start echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` På macOS eller Windows bruker Podman en ekstern Podman Machine: hopp over `podman unshare` og følg [den topologispesifikke veiledningen for datakatalogen](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Podman-veiledning](contrib/podman/README.md) — Compose-bygg, Podman Machine og oppsett av Linux/systemd Quadlet. **⚡ Raskere / slankere installasjon (hopp over native-byggingen)** Den native SQLite-motoren (`better-sqlite3`) er en **valgfri** avhengighet, så en global installasjon blokkeres aldri av kompilering fra kildekode: Den bruker en forhåndsbygd binærfil når en samsvarer med plattformen/Node-versjonen din, og faller ellers transparent tilbake til en ren JS-motor (`node:sqlite` på Node 22+, ellers den medfølgende `sql.js` WASM) — ingen byggeverktøy kreves. Slik hopper du helt over den native oppvarmingen etter installasjon (CI, uten grafisk grensesnitt eller trege maskiner): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 hopper også over den ``` For de raskeste installasjonene bør du foretrekke **pnpm** (innholdsadressert lager + harde lenker — se ovenfor). For et kjøremiljø uten kontrollpanel og grafisk grensesnitt bruker du Docker-profilen `base` (ovenfor) eller [Termux-veiledningen](docs/guides/TERMUX_GUIDE.md). CLI-verktøyet og nettkontrollpanelet betjenes av den samme prosessen på én port, så det finnes foreløpig ingen separat pakke kun for CLI-verktøyet.

# 🎬 OmniRoute i bruk

## 📹 Videoguider

_{Øyeblikksbilde av dashbordet 2026-08-24 · Råkatalog: YT 809 | TT 137 | IG 124 · Aktualitet (dager): YT 1 | TT 21 | IG 22}

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

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

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

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

🎬 #5 — Instagram
_{buildwithai.club — 347,652 visninger}

**Fullstendig rangering (dedupliserte kanoniske URL-er, `v > 0`, størst rekkevidde):** | #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** | Kanoniske målinger per 2026-08-24: **1.029 unike videoer** · **11.132.922 kjente visninger** (`v > 0`) · **639 kanaler/profiler fordelt på nettverk**. Rådashbordet inneholder 1.070 rader; 41 duplikater fra Instagram ble normalisert etter kanonisk URL, og det høyeste antallet per video ble beholdt. > 🎬 **Har du laget en video om OmniRoute?** Opprett en [sak](https://github.com/diegosouzapw/OmniRoute/issues/new) eller [diskusjon](https://github.com/diegosouzapw/OmniRoute/discussions) med lenken — så fremhever vi den her.

# 📧 Fellesskap og hjelp > Alt på ett sted — følg vedlikeholderen, snakk med fellesskapet eller opprett en sak. | Kanal | Hvor / hvordan | | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — følg vedlikeholderen | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — følg for utgivelser og tips | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Globalt** | [bli med i gruppen](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brasil** | [bli med i gruppen](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Nettsted** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute-fellesskap (gratis)** | [StHub-portalen](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Kildekode** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Rapporter en feil** | [opprett en sak](https://github.com/diegosouzapw/OmniRoute/issues) — legg ved utdataene fra `npm run system-info` | | 🤝 **Bidra** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Forgrenings- og utgivelsesmodell](docs/ops/BRANCHING_MODEL.md) · velg en `good first issue` | | 💚 **Støtt prosjektet** | [Måter å støtte på ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Teknologistakk

Lag	Teknologi
Kjøremiljø	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Språk	TypeScript 6.0 — 100 % TypeScript på tvers av `src/` og `open-sse/` (ingen `any` i kjernen siden v2.0)
Rammeverk	Next.js 16 + React 19 + Tailwind CSS 4
Database	better-sqlite3 (SQLite, WAL-journalføring) + LowDB (eldre JSON-format) — 137 domenemoduler, 202 migreringer
Minne	SQLite FTS5-fulltekstsøk + int8-kvantiserte vektorrepresentasjoner, typet forvitring
Skjemaer	Zod 4 — validering av inn- og utdata for MCP-verktøy + API-kontrakter
Protokoller	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Strømming	Server-Sent Events (SSE) + WebSocket-bro (`/v1/ws`)
Komprimering	12-motors behandlingskjede — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentisering og sikkerhet	OAuth 2.0 (PKCE) + JWT + API-nøkler + omfangsbasert MCP-autentisering · AES-256-GCM ved lagring · DOMPurify
Skjuling	wreq-js — etterligning av JA3- / JA4-TLS-fingeravtrykk, proxy på tre nivåer
Robusthet	Effektbryter, eksponentiell tilbakeventing, beskyttelse mot «thundering herd», selvreparerende automatisk kombinasjon
Logging	pino — strukturerte JSON-logger med forespørselskontekst
Testing	Node.js-testkjører + Vitest — over 39 000 statiske testdeklarasjoner fordelt på over 5 100 sporede testfiler (enhets-, integrasjons-, E2E-, sikkerhets- og økosystemtester)
Plattformer	Skrivebord (Electron) · Android (Termux) · PWA (alle nettlesere)
CI/CD	GitHub Actions — automatisk publisering til npm + Docker Hub ved utgivelse
Lenker	Nettsted · npm · Docker Hub

## 📖 Dokumentasjon

### 📘 Kom i gang

Dokument	Beskrivelse
Brukerveiledning	Leverandører, kombinasjoner, CLI-integrasjon, utrulling
Oppsettsveiledning	Alle installasjonsmetoder, konfigurasjon av CLI-verktøy, protokolloppsett, justering av tidsavbrudd
Veiledning for CLI-verktøy	Verktøyspesifikt oppsett for Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Ekstern modus	Styr en ekstern OmniRoute (VPS) fra CLI-en på den bærbare datamaskinen din via tilgangstokener med begrenset omfang
Claude Code-konfigurasjon	Koble Claude Code til OmniRoute (lokalt/eksternt) med `launch` + profiler per modell
Hurtigstart	Tre trinn: installer → koble til → konfigurer

### 🔧 Drift og utrulling

Dokument	Beskrivelse
Docker-veiledning	Docker-kjøring, Compose-profiler, Caddy HTTPS, tunneler, avbildningsetiketter
Podman-veiledning	Quadlet-systemd-integrasjon, podman-compose, SELinux
Utrulling på virtuell maskin	Komplett veiledning: virtuell maskin + nginx + Cloudflare-oppsett
Fly.io-utrulling	Rull ut til Fly.io med vedvarende lagring
Termux-veiledning	Kjør OmniRoute på Android via Termux
PWA-veiledning	Installasjon, hurtigbufring og arkitektur for progressive nettapper
Avinstalleringsveiledning	Fullstendig fjerning for alle installasjonsmetoder
Miljøkonfigurasjon	Komplett oversikt og referanser for variabler i `.env`

### 🧠 Funksjoner og arkitektur

Dokument	Beskrivelse
Arkitektur	Systemarkitektur, dataflyt og interne funksjoner
Komprimeringsveiledning	Pipeline med sju alternativer: av / lett / standard / aggressiv / ultra / RTK / stablet
RTK-komprimering	Komprimering av kommandoutdata, filtre, klarering, verifisering, gjenoppretting av råutdata
Komprimeringsmotorer	Caveman, RTK, stablede pipelines, grensesnitt for kontrollpanel/API/MCP
Format for komprimeringsregler	JSON-skjemaer for regelpakker til Caveman- og RTK-filtre
Språkpakker for komprimering	Språkgjenkjenning og oppretting av Caveman-regelpakker
Robusthetsveiledning	Strømbrytere, nedkjølingsperioder, kø, beskyttelse mot samtidige forespørselsstormer, TLS-forfalskning
Auto-Combo-motor	Poengberegning med 16 faktorer, moduspakker, selvreparasjon
Proxy-veiledning	Proxy-system med tre nivåer, 1proxy-markedsplass, CRUD for registeret
Gratisnivåer	Samlet katalog: 35 dokumenterte gjentakende reserver / 489 katalogiserte oppføringer på gratisnivå
Funksjonsgalleri	Visuell omvisning i kontrollpanelet med skjermbilder
Dokumentasjon av kodebasen	Nybegynnervennlig gjennomgang av kodebasen

### 🤖 Protokoller og API-er

Dokument	Beskrivelse
API-referanse	Alle endepunkter med eksempler
OpenAPI-spesifikasjon	OpenAPI 3.0-spesifikasjon
MCP-server	110 MCP-verktøy, IDE-konfigurasjoner, Python/TS/Go-klienter
Veiledning for MCP-server	MCP-installasjon, transportmetoder og verktøyreferanse
A2A-server	JSON-RPC 2.0-protokoll, ferdigheter, strømming, oppgaveadministrasjon
Veiledning for A2A-server	A2A-agentkort, oppgaver, ferdigheter og strømming

### 📋 Prosjekt og kvalitet

Dokument	Beskrivelse
Bidrag	Utviklingsoppsett og retningslinjer
Forgrenings- og utgivelsesmodell	Hvilke grener PR-er rettes mot (`release/*`), og hva `main` og tagger betyr
Endringslogg	Fullstendig utgivelseshistorikk for hver versjon
Sikkerhetspolicy	Rapportering av sårbarheter og sikkerhetspraksis
i18n-veiledning	Støtte for 42 språk, arbeidsflyt for oversettelse, RTL
Sjekkliste for utgivelse	Valideringstrinn før utgivelse
Dekningsplan	Strategi for testdekning av over 39 000 statiske testerklæringer fordelt på over 5 100 sporede testfiler

# ⭐ Viktigste bidragsytere > OmniRoute formes av et lidenskapelig fellesskap basert på åpen kildekode. Disse personene har gitt eksepsjonelle bidrag som har direkte innvirkning på prosjektets kvalitet, stabilitet og rekkevidde. **Tusen takk.** ### Eksterne bidragsytere etter innlemmede pull requests

Plassering	Bidragsyter	Innlemmede PR-er	~Endrede linjer
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 ved spissen av den aktive grenen release/v3.8.50, dafb4ae808, med innlemminger til og med 2026-08-24 05:26:03 UTC. Den paginerte GitHub GraphQL-opptellingen inneholder 5 911 innlemmede PR-er: 2 707 fra eieren av repositoriet, 179 fra Dependabot og 3 025 eksterne PR-er fra 535 unike bidragsytere. «Endrede linjer» er tillegg + slettinger på GitHub og omfatter genererte filer, låsefiler, kataloger, oversettelser og dokumentasjon; det måler endringsmengde, ikke egenproduserte kodelinjer. Delte plasseringer ved grensen er beholdt.} ### Commits tilskrevet av GitHub

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

_{Kontrollert på nytt 2026-08-24 06:14:31 UTC: GitHub-tilskrevne commits rapportert av repositoriets Contributors API for standardgrenen release/v3.8.50. API-et returnerte 525 identiteter (415 brukere, 2 boter, 108 anonyme); denne tabellen utelater vedlikeholderen, boter og anonyme identiteter og beholder delte plasseringer. Den er forskjellig fra både rangeringen etter sammenslåtte pull requests ovenfor og opptellingen av 639 personer basert på Git-metadata nedenfor.} > 🙏 Disse bidragsyternes funksjoner, feilrettinger og forbedringer av infrastrukturen er en **sentral del** av det som gjør OmniRoute pålitelig og funksjonsrikt. Hver pull request, hvert testtilfelle og hver i18n-oversettelsesfil teller. Åpen kildekode bygges av mennesker som dem.

---
## 💖 Sponsorer

En hjertelig takk til dem som finansierer OmniRoute av egen lomme — hvert bidrag holder prosjektet gratis, uavhengig og i utvikling.

Andrew
_{💛 Aktiv månedlig sponsor}

Vlad I
_{💛 Aktiv månedlig sponsor}

Paco Cartones
_{💛 Aktiv engangssponsor}

Prof. Igor Morais
_{💛 Tidligere engangsbidragsyter}

longtao
_{💛 Tidligere engangsbidragsyter}

_{… og andre som foretrekker å forbli private 💛} _{Offentlige GitHub-sponsorer ble kontrollert på nytt 2026-08-24. GitHubs activeOnly-status bestemmer de aktive merkelappene ovenfor. Tidligere offentliggjorte engangsbidragsytere blir fortsatt takket, mens private sponsorer forblir anonyme.} 💖 Bli sponsor → — hver dollar bidrar til å holde OmniRoute gratis og uavhengig.

## 👥 Over 600 bidragsytere

[![Bidragsytere](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Revidert 2026-08-24 ved den frosne basen ac02c5b42f og kontrollert på nytt ved det gjeldende release/v3.8.50-endepunktet dafb4ae808: 639 normaliserte menneskelige Git-identiteter — 407 forekommer som commit-forfattere (inkludert vedlikeholderen), og 232 forekommer bare i eksplisitte Co-authored-by-trailere. Opptellingen normaliserer GitHub-noreply-brukernavn, utelukker 26 bot-/agent-/tjeneste-/plassholderidentiteter og slår ikke sammen vanlige e-postadresser bare fordi visningsnavnene deres er like.} ### Slik bidrar du 1. Fork repositoriet 2. Opprett en gren fra det **aktive** `release/vX.Y.Z`-endepunktet (ikke `main`) — se [Gren- og utgivelsesmodell](docs/ops/BRANCHING_MODEL.md) 3. Opprett funksjonsgrenen din (`git checkout -b feat/amazing-feature`) 4. Commit endringene dine (`git commit -m 'feat: add amazing feature'`) 5. Push til grenen (`git push origin feat/amazing-feature`) 6. Åpne en Pull Request med **base = den aktuelle `release/vX.Y.Z`-grenen** Se [CONTRIBUTING.md](CONTRIBUTING.md) for detaljerte retningslinjer. ### Utgivelse av en ny versjon ```bash # Opprett en utgivelse — npm publish skjer automatisk VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Stjerner

## 🌍 StarMapper

## 🙏 Takk

OmniRoute står på skuldrene til kjemper. Det startet som en forgrening av **[9router](https://github.com/decolua/9router)** og en TypeScript-portering av Go-prosjektet **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — og derfra ble hvert undersystem nedenfor inspirert av et åpen kildekode-prosjekt som var først ute. Hvert av dem formet en konkret del av OmniRoute. Dette er vår takk til dem alle. 🙏 > ⭐ antall stjerner ble verifisert via GitHubs REST API 24. august 2026 — gi gjerne disse prosjektene en stjerne. Antallene er et nøyaktig øyeblikksbilde fra denne datoen og vil naturligvis endre seg. ### 🧬 Opphav og gateway

Prosjekt	⭐	Hvordan det inspirerte OmniRoute
9router	26,161	Det opprinnelige prosjektet som denne forken bygger på – her utvidet med multimodale API-er og en fullstendig omskriving i TypeScript.
CLIProxyAPI	48,497	Go-implementasjonen som inspirerte denne porteringen til JavaScript / TypeScript.
LiteLLM	57,100	AI-gatewayen der det offentlige prisdatasettet forsyner synkroniseringen av kostnadssporingen vår, og der modellen for leverandørnormalisering dannet grunnlaget for rutingen vår.
codex-chatgpt-web	1,410	MIT-kildekode tilpasset til den inkluderte broen ChatGPT Web → Codex Responses, inkludert adaptere for nettleserøkter, responsinnramming, bruk og nettsøk.
free-claude-code	48,112	Mønstre portert til gjenoppretting av strømmer, aliaser uten tenking, reservebasert nettsøk, grenser med glidende vindu, sladding av logger og sikrede oppstartsforløp.
composer-api	322	Mønstre for verktøyvalg, utdatabegrensninger og verktøybekreftelse i Cursor Composer, tilpasset den innebygde Cursor-eksekveringsmotoren.
codex-multi-auth	457	Mønstre for ny innlogging og rotering av oppdateringstokener, portert til Codex OAuth-reauthentisering.
opencode-anthropic-auth	510	Claude Code-kompatible standardinnstillinger for transformasjon og oppførsel for faktureringshoder, generalisert i OmniRoutes konfigurasjonsstyrte bro.
grok2api-merged	2	Prosjektets Grok-modelltilordninger, Statsig-generator med falsk TypeError, standardinnstillinger for forespørsler og enheter samt NDJSON-responsbehandler ble i vesentlig grad tilpasset til OmniRoutes Grok Web-eksekveringsmotor.
TQZHR/grok2api	705	Den viktigste indirekte kodekilden bak grok2api-merged; implementasjonene av modeller, hoder, nyttelast, Statsig og behandlere er bevart i Grok Web-opphavslinjen.
chenyme/grok2api	7,520	Den underliggende MIT-kilden for Grok-nyttelast og standardinnstillinger for enheter, Statsig-generatoren og `result.response`-behandleren som er videreført gjennom TQZHR og grok2api-merged.
grok2api-pro	27	En indirekte kilde kreditert av grok2api-merged for proxy-pool-laget; OmniRoute bevarer henvisningen til dette opphavet, men hevder ikke å ha portert en proxy-pool i sin avgrensede Grok Web-eksekveringsmotor.
GrokProxy	50	Prosjektets informasjonskapselautentiserte Grok-proxy og strømmemønsteret `result.response.token` dannet grunnlaget for OmniRoutes Grok Web-transport.
GrokBridge	5	Den opprinnelige Grok Web-implementasjonen konsulterte prosjektets oppstrømsdesign for HTTP/nettleser; den direkte HTTP-banen stammer fra GrokProxy, så det hevdes ikke at noen uavhengig kodeportering har funnet sted.
grok-web-api	14	Prosjektets Rust-baserte `ChatOptions`- og responskonvoluttskjemaer dannet grunnlaget for OmniRoutes TypeScript-typer for Grok-forespørsler og strømmesvar.

### 🗜️ Kontekst- og tokenkomprimering — motorer

Prosjekt	⭐	Hvordan det inspirerte OmniRoute
Caveman	100,538	Det virale «hvorfor bruke mange token når få token gjør susen»-prosjektet — filosofien om huleboerspråk driver standardmodusen vår for komprimering og over 30 regler for fyllord og kondensering.
RTK – Rust Token Killer	77,185	Høyytelses komprimering av kommandoutdata — inspirerte RTK-motoren vår, JSON-filter-DSL-en, gjenoppretting av rådata og den stablede RTK → Caveman-pipelinen.
headroom	67,310	Reversibel kontekstkomprimering (SmartCrusher) — inspirerte `headroom`-motoren vår og hentemarkørmønsteret `ccr`.
LLMLingua	6,598	Forskning på promptkomprimering (LLMLingua / LLMLingua-2) — inspirerte den asynkrone, kodesikre og fail-open `llmlingua`-motoren vår.
llmlingua-2-js	31	JS/ONNX-porten (MobileBERT / XLM-RoBERTa) som brukes som worker-tråd-backend for LLMLingua-motoren vår.
Troglodita	40	PT-BR-tokenkomprimering — driver språkpakken vår for pt-BR: reduksjon av pleonasmer og fjerning av fyllord tilpasset brasiliansk-portugisisk grammatikk.
ponytail	108,957	Den virale «late seniorutvikleren»-ferdigheten for YAGNI-koding — inspirerte utdatastilen vår mindre kode: styring mot den minste fungerende endringen som reduserer _generert_ kode (utdataaksens motstykke til Cavemans knappe prosa).
i-have-adhd	23,526	Den handlingsorienterte, ADHD-vennlige svarstilen ble tilpasset til OmniRoutes konsise utdatastil på fem språk.

### 🧩 Kompakte formater, tokenforskning og kodebevisste verktøy

Prosjekt	⭐	Hvordan det inspirerte OmniRoute
TOON	25,233	Tokenorientert objektnotasjon — den kolonnebaserte modellen med overskrift og rader formet fasen vår for tabellkomprimering.
GCF – Graph Compact Format	41	Det kompakte grafformatets og generiske profildesignet ga føringer for OmniRoutes tabellkomprimering og Headroom-kodekformat.
gcf-typescript	4	MIT TypeScript-implementasjonen som ble integrert direkte og utvidet som Headrooms kodek for generiske profiler.
token-optimizer-mcp	494	Brotli/SQLite-hurtigbuffer + kontekstdelta per økt — inspirerte `session-dedup`-motoren vår.
token-savior	1,122	Komprimering av Bash-utdata + MCP-profiler — inspirerte disiplinen vår for å avbryte komprimering og reduksjon av MCP-verktøymanifester.
token-saver	138	Innholdsbevisst komprimering av utdata per filtype med feilbevisst avbrudd — bekreftet rutingen vår per type og muligheten til å hoppe over ved minimal gevinst.
token-optimizer	1,951	«Finn spøkelsestokenene» — mønsteret for avlasting + gjenopprettbart håndtak ga føringer for tenkningen vår rundt CCR-avlasting.
TokenMizer	28	En plan for øktgrafer + linjededuplisering på tvers av runder som ga føringer for utformingen av øktdedupliseringen vår.
OmniCompress	3	Kolonnebasert JSON i Rust + innholdsadressert henting + deduplisering på tvers av meldinger — bekreftet motordesignet vårt for `headroom`/`ccr`/`session-dedup` og den hurtigbufferstabile invarianten «komprimert form er posisjonsuavhengig».
mcp-compressor	113	Komprimering av MCP-verktøyskjemaer og -beskrivelser — ga føringer for reduksjonen vår av kardinaliteten i MCP-verktøymanifester.
RepoMapper	197	Rangering av repo-kart i Aider-stil — ga føringer for utforskningen vår av repo-kart og hentingsrangering.
quiet-shell-mcp	4	Deklarativ reduksjon av shell-utdata via MCP — bekreftet den deklarative komprimeringen vår av Bash-utdata.
ts-morph	6,162	Verktøysett for TypeScript Compiler API — inspirerte den parserbaserte kommentarfjerningen vår som bevarer streng-, mal- og regex-literaler.

### 🧠 Minne og RAG

Prosjekt	⭐	Hvordan det inspirerte OmniRoute
Mem0	63,902	Universelt minnelag — modellen med proxyen som grense for skriving og lesing formet minnearkitekturen vår.
Letta (MemGPT)	24,382	Agenter med tilstand og lagdelt minne — inspirerte den lagdelte modellen vår for Context Control & Recovery (CCR).
WFGY	1,781	ProblemMap-taksonomien med 16 tilbakevendende feilmoduser for RAG/LLM — det felles vokabularet i feilsøkingsveiledningen vår.

### 🛰️ Trafikkinspeksjon, MITM og transparent proxy

Prosjekt	⭐	Hvordan det inspirerte OmniRoute
llm-interceptor	66	MITM-avskjæring og -analyse av trafikk mellom kodeassistenter og LLM-er dannet grunnlaget for de tidlige kravene til Traffic Inspector. Fire tidligere avledede moduler — SSE-sammenslåing, samtalenormalisering, maskering av hemmeligheter og rensing av headere — er erstattet av uavhengige renromsimplementasjoner basert på offentlige protokollstandarder. De to vertsflater for direktegjennomgang (`passthrough.ts` og `_internal/bypass.cjs`) er fortsatt interne OmniRoute-implementasjoner som er klassifisert uavhengig; de ble ikke omskrevet som en del av denne erstatningen.
ProxyBridge	5,995	Transparent proxy-ruting per prosess — inspirerte vår krasjsikre avslutning av MITM, tidsavbrudd for inaktive sokler, prosesstilknytning via `/proc` og TPROXY-registrering.

### 📚 Modelldata, observerbarhet og brukergrensesnitt

Prosjekt	⭐	Hvordan det inspirerte OmniRoute
models.dev	6,555	Åpen database med spesifikasjoner, priser og egenskaper for KI-modeller — synkronisert direkte med modellkatalogen vår.
React Flow / xyflow	38,108	Det nodebaserte grafbiblioteket som driver Compression Studio og Combo/Routing Studio i sanntid.
LangGraph	40,314	LangGraph Studios direktevisualisering av arbeidsflytgrafer inspirerte sanntidsvisningen av kaskader i våre Studios.
Langfuse	33,592	Observerbarhetsmodellen med sporing → spenn → generering formet fossefallsvisningen i Compression Studio.
Kiali	3,631	Observerbarhet for Istio-tjenestenett — inspirerte effektbrytermerkene og visualiseringen av feilkanter i Routing/Combo Studio.
lobe-icons	2,428	Merkevarelogoer for KI/LLM som viser leverandørikonene i hele kontrollpanelet vårt.
flag-icons	12,354	Leverer de MIT-lisensierte SVG-flaggene som brukes av språkvelgeren i README-filen.

### 🛡️ Sikkerhet

Prosjekt	⭐	Hvordan det inspirerte OmniRoute
awesome-secure-defaults	721	En kuratert liste over biblioteker med sikre standardinnstillinger som veileder sikkerhetsvalgene våre (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Komplementære verktøy

Prosjekt	⭐	Hvordan det inspirerte OmniRoute
ClawRouter	6,564	Inspirerte deduplisering av forespørsler, kostnadsfri nødreserve, utskiftbare Auto-Combo-strategier og flerspråklig intensjonsklassifisering.
Antigravity-Manager	30,652	Kontobevisst omtilordning av modeller, validering av kjørbare filbaner og håndtering av abonnementsetiketter dannet grunnlaget for OmniRoutes Antigravity-kjøretid.
vscode-antigravity-cockpit	4,817	Det kompakte nedtellingsformatet for tilbakestilling av kvoter inspirerte den tilsvarende visningen av leverandørgrenser i OmniRoute.
AionUi	32,230	ACP-integrasjonene inspirerte OmniRoutes automatiske oppdagelse av installerte CLI-agenter.
CodexBar	20,507	Identifiserte Grok Build-kvotegrensesnittet; OmniRoute verifiserte og korrigerte deretter det aktive overføringsformatet uavhengig.

## 📄 Lisens MIT-lisens – se [LICENSE](LICENSE) for detaljer. ---

**[⬆ Tilbake til toppen](#-omniroute)** · Bygget med ❤️ for AI-fellesskapet med åpen kildekode. _{OmniRoute v3.8.52 · Node ≥22.22.2 · MIT-lisens · omniroute.online}