# README (Nederlands) 🌐 **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) · 🇳🇴 [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) · 🇸🇪 [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 — De Gratis AI Gateway

OmniRoute — Blijf altijd coderen. Elke AI-tool → 358 providers — 150+ gratis — via één eindpunt. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity naar GRATIS Claude / GPT / Gemini met automatische terugval. RTK + Caveman gestapelde compressie bespaart 15–95% tokens (~89% gemiddeld) — bereik nooit limieten. 358 AI-providers · 150+ gratis lagen · ~1,62 miljard gratis tokens/maand · 19 routeringsstrategieën · $0 om te beginnen.

## 💰 ~1.62B gratis tokens / maand

> Het handmatig combineren van gratis niveaus is frustrerend — tientallen SDK's, tientallen snelheidslimieten en geen idee hoeveel je daadwerkelijk hebt. OmniRoute catalogiseert **489 vermeldingen van gratis niveaus verdeeld over 35 terugkerende poolsleutels** en berekent het totale aantal tokens op basis van de **17 pools met een gepubliceerd positief maandelijks budget plus vijf Groq-limieten per model**, waarbij gedeelde pools worden gededupliceerd. Quota die pas beschikbaar worden na een regionale identiteitscontrole (momenteel: ModelScope), worden afzonderlijk weergegeven als +~6M achter regionale identiteitsverificatie en worden nooit bij het totaal opgeteld. Het resultaat blijft zichtbaar op het dashboard (`/dashboard/free-tiers`).

OmniRoute-budgetkaart voor gratis niveaus: structureel ~1.62B gratis tokens per maand, oplopend tot ~2.22B in de eerste maand dankzij aanmeldtegoeden, afkomstig van 35 gedocumenteerde terugkerende poolsleutels die 489 gecatalogiseerde vermeldingen van gratis niveaus achter één endpoint omvatten. Eerlijke berekening met gededupliceerde pools — elke gedeelde pool wordt één keer meegeteld, inclusief 17 terugkerende pools met een gepubliceerd positief maandelijks tokenbudget plus vijf Groq-limieten per model; 13 providers zijn in de catalogus met voorwaardenrisico's gemarkeerd als te vermijden, zodat jij beslist. De budgetbalk omvat Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (vijf limieten per model) en kleinere pools, plus aanmeldtegoeden voor de eerste maand en permanent gratis providers zonder tokenlimiet die afzonderlijk worden weergegeven, zodat ze het totaal nooit kunstmatig verhogen. Live verbruik/resterend op /dashboard/free-tiers.

> Geanimeerde samenvatting van de livepagina `/dashboard/free-tiers`. Volledige methodologie (pooldeduplicatie, tegoedniveaus, providervoorwaarden): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Deze cijfers worden elke twee weken opnieuw gecontroleerd aan de hand van de livecatalogus en **kunnen beide kanten op bewegen** — beëindigt een provider een gratis niveau, dan daalt het aantal; komt er een nieuw niveau bij, dan stijgt het. We publiceren wat de catalogus daadwerkelijk berekent, nooit een naar boven afgerond bestcasescenario.}

⭐ Geef de repo een ster als OMNIROUTE je heeft geholpen geld te besparen en je werk eenvoudiger te maken.

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

[![Rangschikking sterrengeschiedenis](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) ### 💬 Word lid van de community **👋 Volg de beheerder — ontvang als eerste nieuwe providers, releases en tips:** [![Volg Diego op 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/) [![Volg @diegosouzapw op 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 wereldwijd](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 Brazilië](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) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Vragen, tips over providers, roadmap en ondersteuning → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Wereldwijd](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazilië](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portaal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 De Gateway Blijft Groeien

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | ------------------------- | :-----: | :----------------------: | :-----------------: | | 🌐 Providers | 290 | **357** | meer in de wachtrij | | 🧠 Unieke chatmodel-ID's | 1185 | **1312** | — | | 🖼️ Modaliteitsbrug | — | 🆕 beeld + audio + video | — | | 📡 Gratis Radar-catalogus | — | 🆕 optioneel | — | | ⚖️ Quotabewuste planning | — | 🆕 Quota-Share | — | | 📊 Quotatelemetrie | — | 🆕 live | — | **→ [Roadmap](ROADMAP.md) — op weg naar `v3.9.0 LTS`**

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

🚀 Aan de slag	🚀 Snel aan de slag	📦 Installeren	🆓 Geen configuratie
💡 Ontdekken	💥 De belofte	🤔 Waarom OmniRoute	🏆 Wat OmniRoute onderscheidt
⚙️ Functies	🎯 Combinaties	🌐 Aanbieders	🔌 CLI & MCP
	🗜️ Compressie	🖥️ Waar het draait	🔒 Privé
👀 Bekijken	🎬 In actie	✨ Wat is er nieuw?	🤖 Compatibele CLI's
💚 Ondersteuning	💚 Ondersteunen/doneren	💬 Community	💖 Sponsors
📦 Project	🛠️ Technologiestack	📖 Documentatie	👥 Bijdragers

🌐 In 66 talen

## 🆓 Werkt zodra je het installeert — geen sleutels, geen configuratie

Werkt zodra je het installeert — nul configuratie. Drie stappen: 1. Installeren — npm i -g omniroute, server start op localhost:20128. 2. Richt je tool op http://localhost:20128/v1 — elke OpenAI-compatibele tool (Claude Code, Cursor, Cline). 3. Het antwoordt — roep model auto aan voor een direct antwoord, zonder API-sleutel, zonder aanmelding, zonder configuratie. Sleutelloze provider OpenCode Free is vooraf bedraad in de auto-combinatie, dus een verse installatie reageert direct.

```bash # Verse installatie, nul referenties — `auto` werkt al: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{Liever een specifieke gratis backend? Roep `oc/…` (OpenCode Free) direct aan. Stap dan over op `auto` en laat OmniRoute kiezen.} _{📦 Kopieer-plak quickstart scripts voor **Python, Node.js, PHP, en cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 De Belofte

# 🤔 Waarom OmniRoute?

OmniRoute verzoekstroom: je IDE of CLI (Claude Code, Cursor, Cline…) roept één lokaal endpoint aan (http://localhost:20128/v1); de OmniRoute Smart Router (RTK + Caveman compressie, 19 routeringsstrategieën, circuit breakers, TLS stealth, MCP, A2A, guardrails) kan terugvallen over 4 providerlagen zolang er een geschikt gezond doel overblijft — Laag 1 Abonnement, Laag 2 API-sleutel, Laag 3 Goedkoop en Laag 4 Gratis.

## 🤝 Ondersteund door onze Open Source Vrienden

> **Wil je meedoen als Open Source Vriend?** Dit zijn de bedrijven die open source ondersteunen en OmniRoute draaiende houden — en we vermelden publiekelijk waar elke token die ze ons geven naartoe gaat. Neem contact op: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Dank aan Kimi (Moonshot AI), onze oprichtende Open Source Vriend, voor het ondersteunen van dit project! Kimi is het AI-lab achter de open-weight K2 en K3 modelfamilies — Kimi K3 levert een 1M-token contextvenster, native visie en grensverleggende codering tegen een fractie van de prijzen van gesloten modellen, en werkt direct met Claude Code, Codex en elke coderingstool die OmniRoute ondersteunt.

Wat Kimi's ondersteuning mogelijk maakt: Kimi's API-credits voeden OmniRoute's AI-gevalideerde release-pijplijn — de samenvoegvalidatie aangedreven door Kimi K3-fase die elke pull request beoordeelt voordat deze wordt verzonden — plus dagelijkse functieontwikkeling. Eersteklas Kimi-ondersteuning wordt op beide manieren geleverd: de directe Kimi API (kimi-k3) en het Kimi Code coderingsplan (OAuth en API-sleutel). OmniRoute is ook het eerste Braziliaanse open-source project in Kimi's ondersteuningsprogramma. Ontvang een Kimi API-sleutel met 15% extra credits →

Cheaper Inference
_{cheaperinference.com} Dank aan Cheaper Inference, een OmniRoute Open Source Vriend, voor het ondersteunen van dit project! Cheaper Inference is een op kosten gerangschikte gateway die 42 grensverleggende modellen — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok en MiniMax — doorverkoopt via één OpenAI-compatibel eindpunt, waarbij elke aanvraag naar de goedkoopste in aanmerking komende provider wordt gerouteerd zonder ooit meer te rekenen dan de catalogusprijs van de modelmaker.

Eersteklas ondersteuning in OmniRoute: Chat Completions, het native /v1/responses eindpunt, visie, tool calling en 3 afbeeldingsmodellen (grok-imagine, nano-banana-pro, nano-banana-2, bereikbaar als cheaperinference/<model>). Ontvang een API-sleutel →

_{Links getagd met aff=omniroute zijn partnerlinks. Ze financieren het project zonder extra kosten voor jou.}

_{🎟️ Affiliates Promo — gratis aanmeldingscoupons van providers die we niet sponsoren (klik om uit te vouwen)}

_{Deze sectie is alleen voor verwijzings-/couponcodes. Gesponsorde partnerschappen staan hierboven in 🤝 Ondersteund door onze Open Source Vrienden. OmniRoute heeft geen sponsoring of partnerschap met de hier vermelde providers — dit zijn openbare coupons die iedereen kan gebruiken.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — affiliate aanmelding · $100 gratis credits bij aanmelding (gratis server, verwacht hogere latentie — het beste voor testen, niet voor productie). Eersteklas ondersteuning in OmniRoute sinds v3.8.50: Chat Completions, het Anthropic-compatibele wire format en het OpenAI-compatibele pad. Beschikbare modellen zijn onder andere claude-opus-4-8, claude-opus-5, gpt-5.6-sol en meer. Pak je $100 →}

_{⚠️ Affiliate link — OmniRoute heeft geen sponsoring of partnerschap met deze provider.}

_{Ken je een andere provider met een royale gratis aanmeldingscoupon die OmniRoute-gebruikers ten goede komt? Open een issue en we voegen het hier toe.}

## 🎯 Combo's — Het vlaggenschip

Alle 19 strategieën voor combo-routering geanimeerd — één tegel per strategie: 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. Zie de bovenstaande tabel voor wat elke strategie doet.

> Een **combo** is een keten van modellen waartussen OmniRoute **automatisch** routeert. Als het quotum opraakt, een provider uitvalt of de kosten sterk stijgen, kan de combo doorgaan naar het volgende geschikte, gezonde model. 🛡️ ### ⚡ Configuratievrij — gebruik gewoon `auto` Je hoeft geen combo te maken. Stel je model in op `auto` (of een variant) en OmniRoute bouwt een virtuele combo op basis van je verbonden providers, die live worden beoordeeld:

Model-ID	Waarvoor het optimaliseert
`auto`	🎯 Gebalanceerde standaardinstelling (LKGP — blijft bij je laatst goed werkende provider)
`auto/coding`	🧑💻 Kwaliteitsgerichte wegingen voor codegeneratie
`auto/fast`	⚡ Laagste latentie eerst
`auto/cheap`	💰 Goedkoopste per token eerst
`auto/offline`	🔋 Meeste ruimte in quotum/snelheidslimiet eerst
`auto/smart`	🔭 Kwaliteit eerst + 10% verkenning om betere modellen te ontdekken
`auto/lkgp`	📌 Blijft expliciet bij de laatst goed werkende provider
`auto/chaos`	🧪 Wegingen voor foutinjectie om veerkracht te testen (chaos-engineering)

## ### 🔀 Of bouw je eigen combo — 19 routeringsstrategieën Alle **19** strategieën — per combostap naar wens te combineren:

#	Strategie	Wat deze doet
1	`priority`	Geordende lijst met het eerste doel voorop — put elk doel uit voordat het volgende wordt gebruikt 🥇
2	`fill-first`	Benut het quotum van elk doel volledig voordat wordt doorgegaan
3	`weighted`	Gewogen willekeurige keuze op basis van het gewicht per doel
4	`round-robin`	Doorloop de doelen op volgorde
5	`p2c`	Willekeurige taakverdeling volgens het principe ‘power of two choices’
6	`least-used`	Kies het doel met de laagste huidige belasting
7	`random`	Uniforme willekeurige keuze (ontdubbeld)
8	`strict-random`	Willekeurige keuze zonder herhalingen te ontdubbelen 🎲
9	`cost-optimized`	Minimaliseer de kosten per aanvraag op basis van live catalogusprijzen 💸
10	`headroom`	Kies het doel met het grootste resterende quotum
11	`reset-window`	Geef de voorkeur aan het doel waarvan het quotumvenster het snelst wordt gereset
12	`reset-aware`	Rangschik op het tijdstip waarop het quotum wordt gereset — korte vensters eerst 📊
13	`context-relay`	Geef context door tussen doelen voor lange gesprekken 🧠
14	`context-optimized`	Kies de beste match voor de huidige contextgrootte
15	`cache-optimized`	Koppel elk herbruikbaar promptvoorvoegsel aan hetzelfde account — maximaliseer treffers in de promptcache 🎯
16	`lkgp`	Laatst bekende goede route — blijft bij de laatst succesvolle provider en valt vervolgens terug op regels
17	`auto`	Live beoordeling op basis van 16 factoren voor elke verbinding 🤖
18	`fusion`	Stuurt de aanvraag naar een panel van modellen + een beoordelaar voegt de resultaten samen tot één antwoord 🧬
19	`pipeline`	Keten van stappen — de uitvoer van elk doel wordt doorgegeven aan het volgende 🔗

_{De Auto-Combo-engine beoordeelt elke kandidaat op basis van **16 factoren** (status, quotum, kosten, latentie, geschiktheid voor de taak, kwaliteit, sessiebeschikbaarheid…) — zie [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Veerkracht is ingebouwd (3 onafhankelijke lagen)

OmniRoute-veerkracht — 3 onafhankelijke zelfherstellende lagen, de juiste laag voor de juiste storing. Laag 1: circuitbreaker voor providers (volledige provider): wordt alleen geactiveerd bij 408/5xx, drempelwaarden OAuth 8× / API-sleutel 12× / lokaal 2×, wordt na 60s/30s/15s teruggezet naar een HALF-OPEN-test, passief herstel; zolang deze OPEN is, leidt de combinatie het verkeer om naar de volgende provider. Laag 2: afkoelperiode voor verbindingen (één sleutel/account): basisduur 5s voor OAuth / 3s voor API-sleutel, exponentiële ×2-back-off met bescherming tegen een gelijktijdige aanvraagpiek, 429 respecteert Retry-After, bij succes wordt alle foutstatus gewist; één afkoelende sleutel wordt overgeslagen terwijl verwante sleutels verzoeken blijven verwerken. Laag 3: modelblokkering (één model): 429 per model, lokale 404-fouten of modusweigeringen blokkeren alleen dat model — nooit de volledige verbinding. Eindstatussen (verbannen, verlopen, tegoed uitgeput) zijn bestemd voor de beheerder, niet voor afkoelperioden.

_{📖 [Automatische combinatie-engine](docs/routing/AUTO-COMBO.md) · [Veerkrachthandleiding](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Wat OmniRoute Onderscheidt

_{📊 Volledige methodologie & detail per functie versus 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Steun OmniRoute OmniRoute heeft een MIT-licentie en wordt openbaar onderhouden. Als het je tijd of geld bespaart, kun je het zo onafhankelijk helpen houden — kies wat bij je past. Sponsoring heeft nooit invloed op de routeringsprioriteit; het zorgt voor zichtbaarheid, niet voor een hogere positie.

⭐ Geef de repository een ster	Gratis — helpt echt met de zichtbaarheid	Geef OmniRoute een ster
🐙 GitHub Sponsors	Eenmalig of maandelijks · geen platformkosten	github.com/sponsors/diegosouzapw
☕ Ko-fi	Snelle eenmalige fooi, geen registratie voor de donateur nodig	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Klein, informeel gebaar	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Periodiek · non-profit · open source	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazilië)	Direct, zonder kosten	sleutel & QR-code hieronder
₿ Crypto	BTC · ETH · USDT-TRC20 · USDC-Solana	adressen hieronder

**🇧🇷 PIX** — direct, zonder kosten (Brazilië) QR-code voor OmniRoute PIX

Sleutel (willekeurig): `5d865059-bc44-483a-962d-43ceb80126eb` Pix kopiëren en plakken: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Crypto — BTC · ETH · USDT-TRC20 · USDC-Solana (klik om uit te vouwen)

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

_{⚠️ Verzend elke munt alleen via het aangegeven netwerk — verzending via het verkeerde netwerk kan leiden tot verlies van het geld.}

🐛 Een bug gevonden of heb je feedback? Open een [Discussie](https://github.com/diegosouzapw/OmniRoute/discussions).

Opmerkingen voor ontwikkelaars: Het project kan tijdens npm install/postinstall voor het gemak van ontwikkelaars een lokaal .env-bestand genereren. Dit bestand wordt bewust genegeerd via .gitignore (zie .gitignore) en mag nooit worden gecommit — als het per ongeluk toch is gecommit, roteer dan alle blootgestelde geheimen en verwijder het bestand uit de geschiedenis. Zie docs/DEVELOPER-ENVIRONMENT.md voor richtlijnen over het beheren van lokale omgevingsbestanden en geheimen.

## 📡 OmniRoute Radar De belangrijkste claim voor de gratis laag blijft **~1,62 mld. tokens/maand** uit de hierboven gedocumenteerde catalogus, waarbij dubbele vermeldingen in gedeelde pools zijn verwijderd. Tijdelijke aanmeldtegoeden van providers kunnen de eerste maand afzonderlijk verhogen tot **~2,22 mld.** Radar is een optionele, ondertekende catalogusoverlay voor mensen die tussen OmniRoute-releases door actuelere beschikbaarheidsinformatie over gratis modellen willen; de communitycatalogus en alle bestaande gratis functies blijven gratis. Supporters kunnen de livecatalogus en aanvullende mogelijkheden van providers ontvangen. Het afzonderlijke, veranderlijke maximum bedraagt **hooguit ongeveer 3 mld. tokens/maand**, afhankelijk van de beschikbaarheid bij providers. Dat maximum is geen garantie: providers kunnen quota, deelnamevoorwaarden, modellen of regio's op elk moment wijzigen. Radar is opt-in en gebruikt alleen GET. De OmniRoute-client uploadt geen prompts, verkeer, providerconfiguratie, gebruikstelemetrie of de lokaal opgeslagen status van weggeklikte meldingen. Lees meer over de deelnamevoorwaarden en de huidige catalogus op **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Wat is er nieuw?

> Recente hoogtepunten van **v3.8.20 → v3.8.50**. De volledige geschiedenis staat in [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — inkomende A2A-delegatie naar je agentvloot, Conductor-skills op de Agent Card en een dashboardpaneel met Faro-spraakchat via push-to-talk. → [A2A-server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptieve toelating en overbelastingsbeveiliging** — zware chatverzoeken worden in een wachtrij geplaatst in plaats van een 503-fout te retourneren, met atomische voortschrijdende RPM-leases per verbinding. → [Handleiding voor veerkracht](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Canonieke volgorde van `/v1/models`** — één aaneengesloten, per provider gegroepeerd blok voor elke provider (combo's eerst vastgezet), consistent voor elke catalogusbron. → [API-referentie](docs/reference/API_REFERENCE.md) - **🗜️ Robuustere compressie** — standaard ingeschakelde beveiliging tegen inflatie, Caveman-pakketten voor DE / FR / JA + Chinees (wényán), RTK-filters voor Gradle en .NET. → [Compressie](docs/compression/COMPRESSION_ENGINES.md) - **💸 Eerlijke vaste kosten** — providers met een abonnement / programmeerplan worden in kostenanalyses als **$0** weergegeven; budget, quota en routering blijven ramingen maken. → [API-referentie](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share-routering** — verdeel het quotum van een gedeeld account eerlijk over samengevoegde sleutels, met werkbehoud zodat ongebruikte delen worden uitgeleend. → [Handleiding voor veerkracht](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 CLI-/agentconfiguratie met één opdracht** — 13 geregistreerde `setup-*`-opdrachten; `omniroute run` start 7 CLI's (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` ondersteunt 10 doelen met een interactieve provider- en modelkiezer en favorieten per context. → [CLI-integraties](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Externe modus** — bestuur een externe OmniRoute met tokens met een beperkt bereik (`connect` / `contexts` / `tokens`) + een `antigravity` OAuth-helper voor VPS-installaties. → [Externe modus](docs/guides/REMOTE-MODE.md) - **🧭 Slimmere automatische routering** — `auto/:`-combo's, **Fusion** (modelpanel + beoordelaar), taakbewuste routering, overschrijvingen per verzoek voor model / modus / USD-budget. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Inplugbare compressie** — 12 combineerbare engines + Compression Studios: LLMLingua-2, Ultra met twee niveaus, omniglyph, getrouwheidspoort per stap, GCF v3.2, editor voor herschikking via slepen. → [Compressie](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparante MITM-ontsleuteling (TPROXY)** — onderschep CLI's die proxy-omgevingsvariabelen negeren, met een CA per SNI + installatieprogramma voor de vertrouwensopslag. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Kostentelemetrie overal** — `X-OmniRoute-*`-headers voor kosten/gebruik op elk eindpunt, besparingsheader voor cache-HIT's, USD-uitgavenquota per sleutel. → [API-referentie](docs/reference/API_REFERENCE.md) - **🧠 Geheugen waarover jij de controle hebt** — standaard uitgeschakeld, optionele int8-vectorkwantisatie + getypeerd verval, `x-omniroute-no-memory` per verzoek. → [Geheugen](docs/frameworks/MEMORY.md) - **🛡️ Beveiliging** — bescherming tegen promptinjectie op elke LLM-route (red-team-testsuite), optionele beveiliging voor het maskeren van inloggegevens (redigeert gelekte API-sleutels/geheimen in beide richtingen), gratis DuckDuckGo-webzoekfunctie als laatste redmiddel en een optionele OIDC-inlogpoort voor het dashboard (inloggen met een wachtwoord blijft altijd beschikbaar). → [Beveiligingsrails](docs/security/GUARDRAILS.md) - **🖼️ Nieuwe eindpunten** — `/v1/ocr` (Mistral OCR) en `/v1/audio/translations` (in Whisper-stijl) maken het media-aanbod compleet. → [API-referentie](docs/reference/API_REFERENCE.md) - **🎨 Generatie van afbeeldingen / video / audio** — één API voor media: xAI Grok Imagine en Novita AI-video, ComfyUI, Magnific, Adobe Firefly, Segmind en spraakproviders zoals ElevenLabs. → [API-referentie](docs/reference/API_REFERENCE.md) - **🌍 Implementatie en beheer** — reverse-proxy-`basePath`, automatische detectie van de browsertaal, apparaattracking per sleutel, rootloze MITM-vertrouwensconfiguratie, zh-TW-lokalisatie. → [Omgeving](docs/reference/ENVIRONMENT.md) - **🤝 Meer providers en agents** — cloudagents (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) met browser- + OAuth-login, volwaardige Ollama-kaart, Claude Opus 5 en Sonnet 5, officieel partnerschap met Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… en een vernieuwde **catalogus met 352 providers**. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparante routering** — elk antwoord bevat een `X-OmniRoute-Decision`-header met de strategie/provider/latentie waarmee het is afgehandeld, een nieuwe `cache-optimized`-combostrategie + de Auto-Combo-factor `cacheAffinity` routeren herhaalde verzoeken terug naar de verbinding die het gecachete voorvoegsel bevat, en een alleen-lezen eindpunt `/v1/auto-combo/{channel}/candidates` toont de actuele kandidatenpool van een `auto/*`-kanaal. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokale prestaties en infrastructuur** — lokale Redis met één klik, implementatieprogramma's voor Cloudflare Workers / Deno Deploy-relays, Bifrost en Mux als bewaakte ingebedde services. → [Ingebedde services](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Ook inbegrepen** — pluginframework + marktplaats, frameworks voor Omni-/Agent-/GitHub-skills, integratie met Obsidian-kluizen (22 MCP-tools), OpenAI-compatibele Batch- en Files-API's, semantische responscache, gamificatie met ranglijsten, ACP-agentdetectie (15 ingebouwde agents), geplande logexport naar BigQuery, `auto/chaos`-foutinjectie, een Telegram-botbridge, een ingebouwde versiebeheerder en ranglijsten voor gratis providers op basis van LMArena-ELO. → [Documentatie](docs/README.md)

## 🤖 Compatibele CLI's en programmeeragents > Eén configuratie — `http://localhost:20128/v1` — en **elke** AI-IDE of CLI draait op gratis en voordelige modellen.

_{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

＋ werkt ook met · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · elke OpenAI-compatibele tool

_{📖 Configuratie per tool voor alle 36 tools (26 CLI-codetools + 10 CLI-agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode-plug-in → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Start elke ondersteunde CLI met één opdracht via OmniRoute** — er worden geen configuratiebestanden geschreven, referenties worden per proces geïnjecteerd en Qwen/Gemini krijgen een tijdelijke, geïsoleerde thuismap: ```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" # Of kies interactief een provider en model en schrijf de eigen configuratie van de tool: omniroute configure codex # ook: claude opencode qwen aider goose gemini cline continue kilo ``` Elke opdracht respecteert de actieve externe context (`omniroute connect `), `--dry-run` toont vooraf de exacte omgevingsvariabelen/argumenten zonder iets uit te voeren, en `--api-key-env NAME` houdt geheimen buiten de geschiedenis van je shell. → [CLI-integraties](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 357 AI-providers — 152 in de catalogus als gratis gemarkeerd

> **357 geregistreerde providers** verspreid over de canonieke collecties voor chat, media, zoeken, lokaal, cloudagents en systemen, waaronder **152 met de detectiemetadata `hasFree: true`**. Het register met chatmodellen omvat **229 providers / 2.554 unieke provider-modelparen / 1.283 onbewerkte model-ID's**; de afzonderlijke catalogus met gratis budgetten bevat **491 rijen per model**, **35 terugkerende pools** en **54 terugkerende/sleutelloze providers die voor altijd gratis zijn**. Dit zijn bewust verschillende noemers; definities en berekeningen waarbij pools zijn ontdubbeld, staan in de [Providerreferentie](docs/reference/PROVIDER_REFERENCE.md) en [Gratis abonnementen](docs/reference/FREE_TIERS.md).

### 🏢 Elk groot lab — via één endpoint

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

_{…en nog 330+ andere — elk pictogram wordt live geladen uit de providercatalogus van het dashboard. 📖 [Providerreferentie](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Voor altijd gratis — $0, geen kaart nodig

OpenCode Zen _{DeepSeek V4, Nemotron 3 Geen tokenlimiet}	Kilo Code _{Automatische router, Tencent Hy3 Altijd gratis}	Requesty _{GPT-OSS 120B, Nemotron Altijd gratis}	SiliconFlow _{DeepSeek V3.2 / R1 Gratis abonnement}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Altijd gratis}	Baidu ERNIE _{ERNIE 4.0 Altijd gratis}
Qoder AI _{Qwen3-Max, Kimi-K2 Onbeperkt GRATIS}	Pollinations _{GPT, Llama, Claude Geen sleutel nodig}	Cloudflare AI _{Meer dan 50 modellen 10K neuronen/dag}	NVIDIA NIM _{GLM, MiniMax ~40 RPM gratis}	Cerebras _{GLM 4.7, GPT-OSS 1M tokens/dag}	OpenRouter _{:free-modellen +$10 → hogere RPM}

📖 Volledige machineleesbare catalogus → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Waar OmniRoute draait — overal

> Dezelfde app, jouw machine, jouw regels. Van een globale npm-installatie tot **jouw telefoon** via Termux.

Platform	Installatie	Hoogtepunten
📦 npm (globaal)	`npm install -g omniroute`	Eén opdracht, elk besturingssysteem
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Native vensters + systeemvak — Windows / macOS / Linux
🎩 Menubalk (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Bewaakt en werkt de server automatisch bij — macOS
💪 ARM	native `arm64`	Raspberry Pi, ARM-servers, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Draait op je telefoon, 24/7, zonder root
📲 PWA	"Toevoegen aan startscherm"	Schermvullend, offline, installeerbaar vanuit de browser
🧩 OpenCode-plug-in	`@omniroute/opencode-provider`	Native OpenCode-integratie
🤖 VS Code Copilot Chat	installeer de extensie OmniCopilot	Elk OmniRoute-model in de native Copilot Chat-kiezer — stabiel & Insiders
🛠️ Vanuit de broncode	`npm install && npm run dev`	Pas het aan, draag bij

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

### 🧩 Nieuw: OmniRoute in de native Copilot Chat van VS Code

> Geen nieuwe zijbalk, geen nieuwe chatinterface — elk model dat OmniRoute aanbiedt, verschijnt direct in de > **Copilot Chat-modelkiezer die je al gebruikt**. Sinds VS Code 1.122 werken providermodellen > zonder aanmelding bij GitHub of Copilot-abonnement — agentmodus, het aanroepen van tools en beeldverwerking, > gratis. Installeer de extensie **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, verbind deze met je OmniRoute-server (standaard `localhost:20128`) en open vervolgens Copilot Chat → modelkiezer → **Modellen beheren…** → **OmniRoute**.

Store	Link	Werkt met
🧩 VS Code Marketplace	Installeren →	VS Code — stabiel & Insiders
🔓 Open VSX Registry	Installeren →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Vanuit de editor: open de weergave **Extensies**, zoek naar **"OmniRoute"** en klik op **Installeren** — werkt op dezelfde manier in beide stores. De broncode, issues en het publicatiedraaiboek zijn te vinden op [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Handleiding voor VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — installatie, wat de kiezer toont, dashboard in een tabblad, probleemoplossing}

### 🎩 Nieuw: OmniRouteTray — jouw gateway in de menubalk

> `omniroute serve` werkt het best wanneer het altijd actief is. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > maakt er een eenmalig in te stellen menubalk-app voor macOS van: de app start de server, houdt deze actief > na herstarts, werkt deze ter plekke bij en maakt je actuele tokenbudget met één klik toegankelijk — **geen > terminalvenster dat open hoeft te blijven en geen `npm install -g omniroute` om voortdurend in de gaten te houden.** Gebouwd met [Tauri v2](https://v2.tauri.app/) (een Rust-kern die nauwelijks ruimte inneemt), wordt het geleverd met een eigen ondertekende Node 24-runtime en beheert het een OmniRoute-installatie die eigendom is van de app, zodat deze nooit botst met je globale `node`/`bun`. Het **deelt je bestaande configuratie en database in `~/.omniroute/`** — het is dus dezelfde OmniRoute die je al gebruikt, maar dan met een hoed op. 🎩

Wat het doet	Hoe
🟢 Bewaakt de server	Start `omniroute serve` en neemt een reeds actieve instantie over in plaats van deze te dupliceren
📊 Actueel gebruik in één oogopslag	Quotabalken per provider, sessie- en weeklimieten van Claude met aftellers tot de reset, kostenoverzicht over 30 dagen
🔄 Automatische updates ter plekke	Gefaseerde installatie, atomische omwisseling, terugdraaien bij fouten — altijd de nieuwste release
🚀 Starten bij aanmelden	Optioneel starten bij aanmelden; alleen in het systeemvak, zonder Dock-pictogram
🩺 Diagnose & logboeken	Diagnostiek met één klik en toegang tot serverlogboeken

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Liever downloaden? Haal de nieuwste .dmg op via
Releases. Broncode, issues en builddocumentatie
zijn te vinden op zoispag/omniroute-tray.

💛 Een communityproject van @zoispag — geen officiële OmniRoute-release.}

## 🔒 Privé & lokaal-eerst

Privé en lokaal-eerst — de gateway en het beheervlak van OmniRoute draaien op je eigen machine. Prompts worden verzonden naar de upstreamprovider die voor elke aanvraag is geselecteerd; OmniRoute voegt geen gehoste tussenstap voor promptverwerking toe en telemetrie is standaard uitgeschakeld. Inloggegevens worden in rust versleuteld met AES-256-GCM; beveiligingsmaatregelen omvatten beperking van API-sleutels, IP-filtering, frequentielimieten, bescherming tegen promptinjectie, opschoning van upstreamheaders, optionele redactie van persoonsgegevens, opgeschoonde fouten en een lokaal SQLite-auditlogboek. OmniRoute heeft een MIT-licentie en kan zelf worden gehost.

_{📖 [Autorisatie](docs/architecture/AUTHZ_GUIDE.md) · [Beveiligingsmaatregelen](docs/security/GUARDRAILS.md) · [Naleving](docs/security/COMPLIANCE.md)}

## 🔌 Volledige CLI + A2A & MCP

> Naast de server is OmniRoute een **volledige opdrachtregelcockpit** met **meer dan 80 commando's**, plus open agentprotocollen, zodat een AI-agent deze **zelfstandig** kan bedienen. ### ⌨️ Een echte CLI (niet alleen `start`) ```bash omniroute # start gateway + dashboard (poort 20128) omniroute chat # interactieve TUI-chatclient (slashcommando's: /model /combo /skill /memory) omniroute setup # begeleide wizard voor de eerste configuratie omniroute doctor # diagnosticeer providers, poorten en systeemeigen afhankelijkheden ``` ### 🛰️ Externe modus — voer de CLI hier uit en OmniRoute op een VPS Draait OmniRoute op een server? Bedien het vanaf je laptop met **dezelfde CLI**. Meld je één keer aan met een toegangstoken met een beperkt bereik; elk commando wordt daarna op de externe server uitgevoerd. ```bash omniroute connect 192.168.0.15 # wachtwoord → token met beperkt bereik, opgeslagen als context omniroute models list # ← wordt uitgevoerd op de EXTERNE server omniroute configure codex # ← kiest een extern model en schrijft een lokaal Codex-profiel omniroute tokens create --name ci --scope read # maak tokens met een beperkter bereik voor andere machines omniroute contexts use default # ← schakel terug naar de lokale server ``` Tokens hebben het bereik `read` / `write` / `admin`; routes die processen starten, blijven uitsluitend toegankelijk via loopback. _{📖 [Externe modus](docs/guides/REMOTE-MODE.md)}

Geanimeerde terminaldemo van de OmniRoute-CLI — omniroute providers list, omniroute combo list en omniroute health — die de 86 commando's op het hoogste niveau doorloopt: 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 …

### 🤝 Verbind een agent — en deze bestuurt OmniRoute zelf Stel OmniRoute beschikbaar via **MCP**, **A2A**, een **REST API**, **webhooks** of een **externe CLI** — elke geschikte agent (of je eigen code) krijgt toegang tot de volledige gateway: routering, providers, combo's, cache, compressie en geheugen — volledig autonoom. De onderstaande HTTP-eindpunten zijn beschikbaar onder `http://localhost:20128`.

Interface	Eindpunt / commando	Gebruik het voor
🧰 MCP (stdio)	`omniroute --mcp`	Integreer met Claude Desktop, Cursor of elke andere MCP-client
🌊 MCP (HTTP)	`/api/mcp/stream`	Externe MCP — 110 tools, 33 bereiken (handhaving optioneel), volledig auditlogboek
📡 MCP (SSE)	`/api/mcp/sse`	Streamingtransport voor MCP
🤝 A2A	`/.well-known/agent.json`	Van agent naar agent, JSON-RPC 2.0 + SSE, 6 vaardigheden
🌐 REST API	`/v1/*`	OpenAI-compatibel — chat, embeddings, afbeeldingen, audio, OCR
🔔 Webhooks	`/api/webhooks`	Stuur aanvraag- en quota-events naar Slack, Discord, Telegram of een willekeurige URL
🛰️ Externe CLI	`omniroute connect`	Bedien een externe instantie met toegangstokens met een beperkt bereik

```bash # Geef Claude Code via MCP toegang tot de volledige OmniRoute-toolset: 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) · [Agentprotocollen](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Bespaar automatisch 15–95% tokens

### 📖 Hoe het werkt — pipeline, architectuur en berekening van de besparing

OmniRoute-compressiepipeline: een illustratief clientverzoek van 10.000 tokens doorloopt 12 combineerbare engines — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra en OmniGlyph — en kan in het gedocumenteerde gestapelde voorbeeld de provider bereiken met ongeveer 1.080 tokens. Gestructureerde inhoud wordt beschermd door behoudscontroles en getrouwheidspoorten per stap; expliciete verlieslatende of experimentele modi kunnen geschikte inhoud transformeren.

De standaard gestapelde combinatie voert `RTK → Caveman` uit. Wanneer beide op dezelfde tool-/contextpayload worden toegepast, stapelen de besparingen zich op: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Codeblokken, URL's, JSON en gestructureerde gegevens worden **altijd beschermd** door de behoudsengine. > **Waarom veel tokens gebruiken als weinig tokens volstaan?** Elk verzoek doorloopt OmniRoute's compressiepipeline **transparant** — zonder aanpassingen aan de client. Het is nu een **stack van 12 combineerbare engines** die op volgorde worden uitgevoerd en per routeringscombinatie vrij kunnen worden gecombineerd — voortbouwend op ideeën van [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) en [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 De stack met 12 engines Engines worden in pipelinevolgorde uitgevoerd; elke engine kan afzonderlijk per combinatie worden in- of uitgeschakeld en geconfigureerd:

#	Engine	Wat deze doet
1	Session-Dedup	Verwijdert inhoud die in meerdere beurten wordt herhaald (inhoudsgeadresseerd, beurtoverschrijdend)
2	CCR	Archiveert grote blokken achter ophaalmarkeringen, die op aanvraag worden opgehaald
3	Lite	Verwijdert overtollige witruimte en delen van afbeeldings-URL's (basisoptie met lage latentie)
4	RTK	Slim filteren, dedupliceren en afkappen van toolresultaten (opdrachtbewust)
5	Responses Tool Output	Primair verliesloze JSON-compressie plus begrensde diagnostische compressie voor shell-/patch-/zoek-/builduitvoer (Responses API)
6	Headroom	Verliesloze tabellarische compactie van JSON-arrays (~30%) via een meegeleverde GCF-codec
7	Relevance	Extractieve scorebepaling van zinnen ten opzichte van de laatste gebruikersvraag
8	Caveman	Regelgebaseerde compressie van proza (~65–75% van de uitvoer)
9	Aggressive	Samenvatting en progressieve veroudering van oude beurten
10	LLMLingua-2	Semantische ML-snoeiing via MobileBERT ONNX — veilig voor code, asynchroon
11	Ultra	Heuristische tokensnoeiing met een optionele laag voor kleine modellen (SLM)
12	OmniGlyph	Experimentele codering van context als afbeelding voor gemeten Claude Fable 5 via de directe Anthropic-verbinding; GPT 5.6-transformers blijven standaard geblokkeerd in afwachting van providerbevestigingen. Vier compressieprofielen (standaard agressief, gebalanceerd, veilig voor programmeren, ongewijzigde doorgifte) (meest agressief; opt-in)

Codeblokken, URL's en gestructureerde gegevens blijven **altijd** byte voor byte behouden. **Voorinstellingen met één klik** combineren de engines:

Modus	Besparing	Ideaal voor
🪶 Lite	~15%	Veilige standaardoptie die altijd actief is
🪨 Standaard (Caveman)	~30%	Dagelijks programmeren
⚡ Aggressive	~50%	Lange sessies met intensief toolgebruik
🔥 Ultra	~75%	Maximale besparing
🧰 RTK	60–90%	Shell-/test-/build-/git-uitvoer
🔗 Gestapeld (RTK → Caveman)	78–95%	Gemengde prompts en toollogboeken

**Praktijkvoorbeeld — Standaardmodus:** > **Vóór (69 tokens):** _"De reden dat je React-component opnieuw wordt gerenderd, is waarschijnlijk dat je tijdens elke rendercyclus een nieuwe objectreferentie maakt. Wanneer je een inline object als prop doorgeeft, ziet Reacts oppervlakkige vergelijking dit telkens als een ander object, waardoor een nieuwe render wordt geactiveerd. Ik raad aan om useMemo te gebruiken om het object te memoïseren."_ > > **Na (19 tokens):** _"Nieuwe objectreferentie bij elke render. Inline objectprop = nieuwe referentie = opnieuw renderen. Verpak in useMemo."_ > > **Hetzelfde antwoord. 72% minder tokens. Geen verlies van nauwkeurigheid.** ✅ **PT-BR-voorbeeld — [Troglodita](https://github.com/leninejunior/troglodita)-modus:** > **Voorheen (42 tokens):** _"Het probleem is dat de component opnieuw wordt gerenderd omdat er bij elke rendercyclus een nieuwe objectreferentie wordt aangemaakt. Ik zou aanraden om useMemo te gebruiken."_ > > **Daarna (12 tokens):** _"Opnieuw renderen: elke cyclus nieuwe ref (inline object opnieuw aangemaakt). Gebruik `useMemo`."_ > > **Zelfde antwoord. ~70% minder tokens. Technische nauwkeurigheid intact.** ✅
### 🎚️ Meer dan alleen de engines — uitvoerstijlen, de adaptieve regelaar en controle per aanvraag De 12 bovenstaande engines verkleinen wat er **binnenkomt**. Drie extra lagen bepalen **hoe**, **wanneer** en wat er **uitkomt**: - **🪄 Uitvoerstijlen** _(sturing van de uitvoeras)_ — voegen deterministische, cacheveilige instructies voor de vormgeving van antwoorden toe; combineerbaar, elk met de intensiteit `lite` / `full` / `ultra`. Een stijl toevoegen vereist slechts één regel in het register: - **Beknopt proza** — verwijder opvulling / lidwoorden / voorbehouden; behoud de technische inhoud exact. - **Minder code** — YAGNI volgens een "luie senior developer": de kleinste werkende wijziging, zonder ongevraagde basisstructuur. - **Ponytail (luie senior developer)** — beklim de YAGNI-ladder, verhelp de hoofdoorzaak, maak de kleinste werkende diff. - **Ik heb ADHD (actie eerst)** — begin met de volgende actie, nummer de stappen, geef één concrete volgende stap, zonder inleiding. - **Beknopt CJK (文言)** — ultrabeknopte klassiek-Chinese stijl (op basis van locale beperkt tot `zh`). - **🎯 Adaptief contextbudget** _(de regelaar)_ — in plaats van één aan/uit-tokendrempel worden alleen de goedkoopste engines met het minste informatieverlies stapsgewijs ingezet, en uitsluitend voor zover nodig om **binnen het contextvenster van het model te passen**. Beleid: `reserve-output` (standaard, modelbewust) · `percentage` · `absolute`. Modus: `floor` (garandeert dat het past) · `replace-autotrigger` (jouw expliciete keuze wint) · `off` (verouderde drempelwaarde). - **🎛️ Waar over compressie wordt beslist** _(prioriteit, hoog → laag)_ — `x-omniroute-compression`-header per aanvraag › override voor routeringscombinatie › actief benoemd profiel › adaptieve / automatische activering › standaardinstelling van het paneel › uit. Het toegepaste plan wordt teruggestuurd in de responsheader `X-OmniRoute-Compression: ; source=`. Activeer automatisch op basis van een tokendrempel, schakel de adaptieve regelaar in, zet een benoemd profiel vast, stel een eenmalige waarde per aanvraag in of wijs een pipeline toe aan een routeringscombinatie — wat het beste bij de workload past. Een optionele offline **eval-harness** (`npm run eval:compression`) beoordeelt betrouwbaarheid tegenover besparingen op een vastgezette corpus voordat je een wijziging promoveert. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Snel aan de slag

**1) Installeren en uitvoeren** ```bash npm install -g omniroute omniroute ``` > 💡 Zie je `npm warn ERESOLVE` of peer-dep-waarschuwingen? [Die zijn onschadelijk](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). Dashboard op `http://localhost:20128` · API op `http://localhost:20128/v1`. **2) Verbind een GRATIS provider (geen registratie nodig)** Dashboard → **Providers** → verbind **Kiro AI** (gratis Claude, ~50 credits/maand per account) of **OpenCode Free** (geen authenticatie) → klaar. **3) Stel je programmeertool in** ```txt Basis-URL: http://localhost:20128/v1 API-sleutel: [kopieer vanuit Dashboard → Endpoints] Model: auto (slimme routering zonder configuratie — of een willekeurige provider/model) ``` **4) Controleer of het werkt** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Je zou een lijst met je verbonden modellen moeten zien. 🎉 Dat is alles — begin met programmeren; OmniRoute routeert automatisch en schakelt indien nodig voor je over op een alternatief. Als je client geen aangepaste headers kan verzenden, biedt OmniRoute ook getokeniseerde compatibiliteitsaliassen: ```txt OpenAI-catalogus: http://localhost:20128/vscode/YOUR_KEY/ OpenAI-modellen: 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 ``` Gebruik deze alleen voor clients die geen `Authorization: Bearer ...` kunnen toevoegen. Authenticatie via headers blijft de voorkeursmethode.
## 📦 Meer installatiemethoden — Docker, broncode, 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` volgt de hoogste **gepubliceerde** stabiele SemVer. Deze tag volgt niet de git-branch `main`. Zet de versie voor GitOps vast op `:X.Y.Z`. Zie [Docker-releasekanalen](docs/guides/DOCKER_GUIDE.md#release-channels).De image stelt **`OMNIROUTE_MEMORY_MB=1024`** in. Dat is voldoende voor het dashboard en lichte chats. **Codeeragents** (`POST /v1/responses` vanuit Claude Code, Codex, Grok, …) hebben een veel grotere V8-heap nodig, anders treedt bij ongeveer 12 GiB een `FATAL ERROR` op wanneer twee lange contexten elkaar overlappen. Maak de container groter dan de heap (native buffers bevinden zich buiten V8): | Werklast | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) | | ---------------------------------------- | ------------------------------- | ---------------------- | | Dashboard / lichte chats | `1024` (standaard van de image) | ≥2 g | | Eén codeeragent | `8192` | ≥10 g | | Twee gelijktijdige 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 ``` Volledige tabel: [Docker-handleiding — RAM tijdens runtime](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Docker-kanaal voor prereleases:** `diegosouzapw/omniroute:next` en > `diegosouzapw/omniroute:next-web` volgen de huidige standaardbranch `release/v*`. > Deze veranderlijke tags zijn uitsluitend bedoeld voor het testen van nog niet uitgebrachte > oplossingen en worden **niet ondersteund voor productie**. Zie > [Docker-releasekanalen](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** De standaardopdracht `bun install` en globale installatie (`bun install -g omniroute`) worden ondersteund via detectie van de Bun-runtime: - **Ingebouwde `bun:sqlite`**: OmniRoute gebruikt het ingebouwde `bun:sqlite`-stuurprogramma van Bun wanneer het onder Bun wordt uitgevoerd en valt bij Node.js terug op `better-sqlite3` of `sql.js`. - **Automatische selectie van de Webpack-bundler tijdens ontwikkeling**: De ontwikkelmodus (`bun run dev`) detecteert Bun automatisch en schakelt Turbopack uit ten gunste van Webpack om incompatibiliteit met native V8-bindings te voorkomen. Productiebuilds (`bun run build`) volgen `OMNIROUTE_USE_TURBOPACK` precies zoals bij Node: standaard Turbopack, of `OMNIROUTE_USE_TURBOPACK=0` om met Webpack te bouwen (`Dockerfile.bun` stelt dit beschikbaar als een `--build-arg`). - **Specifieke Bun-Dockerfile**: `Dockerfile.bun` met meerdere fasen voor native Bun-productie-implementaties (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Installeren en uitvoeren met Bun bun install bun run dev ``` **🛠️ Vanuit de broncode** ```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 # Nix-flakes gebruiken nix develop npm run dev # Of devbox gebruiken devbox run npm run dev ``` 📖 [Docker-handleiding](docs/guides/DOCKER_GUIDE.md) — Compose-profielen, Caddy HTTPS, Cloudflare-tunnels. **🦭 Podman** ```bash # 1. De als bind-mount gekoppelde gegevensmap voorbereiden mkdir -p data # 2. Alleen voor Linux + lokale rootless Podman (nooit voor een externe Podman Machine-client): podman unshare chown 1000:1000 ./data # 3. De runtime-hint instellen, de lokale Compose-image bouwen en starten echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` Op macOS of Windows gebruikt Podman een externe Podman Machine: sla `podman unshare` over en volg de [topologiespecifieke richtlijnen voor de gegevensmap](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Podman-handleiding](contrib/podman/README.md) — Compose-builds, Podman Machine en Quadlet-configuratie voor Linux/systemd. **⚡ Snellere / lichtere installatie (sla de native build over)** De native SQLite-engine (`better-sqlite3`) is een **optionele** afhankelijkheid, zodat een globale installatie nooit wordt geblokkeerd door compilatie vanuit de broncode: er wordt een vooraf gecompileerd binair bestand gebruikt wanneer dat overeenkomt met uw platform/Node-versie, en anders wordt transparant teruggevallen op een pure JavaScript-engine (`node:sqlite` op Node 22+, anders de meegeleverde `sql.js`-WASM) — geen buildtools vereist. Om de native opwarming na installatie volledig over te slaan (CI, headless- of trage machines): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 slaat dit ook over ``` Gebruik voor de snelste installaties bij voorkeur **pnpm** (content-addressed opslag + hardlinks — zie hierboven). Gebruik voor een headless runtime zonder dashboard het Docker-profiel `base` (hierboven) of de [Termux-handleiding](docs/guides/TERMUX_GUIDE.md). De CLI en het webdashboard worden door hetzelfde proces op één poort aangeboden, dus er is momenteel geen afzonderlijk pakket met alleen de CLI.

# 🎬 OmniRoute in actie

## 📹 Videohandleidingen

_{Momentopname van het dashboard op 2026-08-24 · Ruwe catalogus: YT 809 | TT 137 | IG 124 · Actualiteit (dagen): YT 1 | TT 21 | IG 22}

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

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

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

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

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

**Volledige ranglijst (ontdubbelde canonieke URL's, `v > 0`, grootste bereik):** | #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** | Canonieke statistieken op 2026-08-24: **1.029 unieke video's** · **11.132.922 bekende weergaven** (`v > 0`) · **639 kanalen/profielen per netwerk**. Het ruwe dashboard bevat 1.070 regels; 41 Instagram-duplicaten zijn genormaliseerd op basis van de canonieke URL, waarbij het hoogste aantal per video is behouden. > 🎬 **Een video over OmniRoute gemaakt?** Open een [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) of [discussie](https://github.com/diegosouzapw/OmniRoute/discussions) met de link — dan nemen we deze hier op.

# 📧 Community en hulp > Alles op één plek — volg de beheerder, chat met de community of open een issue. | Kanaal | Waar / hoe | | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — volg de beheerder | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — volg voor releases en tips | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Wereldwijd** | [word lid van de groep](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazilië** | [word lid van de groep](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Website** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute-community (gratis)** | [StHub-portaal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Broncode** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Een bug melden** | [open een issue](https://github.com/diegosouzapw/OmniRoute/issues) — voeg de uitvoer van `npm run system-info` toe | | 🤝 **Bijdragen** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Branch- en releasemodel](docs/ops/BRANCHING_MODEL.md) · kies een `good first issue` | | 💚 **Het project steunen** | [Manieren om bij te dragen ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Tech Stack

Laag	Technologie
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Taal	TypeScript 6.0 — 100% TypeScript over `src/` en `open-sse/` (geen `any` in de kern sinds v2.0)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Database	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 122 domeinmodules, 183 migraties
Geheugen	SQLite FTS5 volledige tekst + int8-gekwantiseerde vector embeddings, getypeerd verval
Schema's	Zod 4 — MCP tool I/O-validatie + API-contracten
Protocollen	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + WebSocket-brug (`/v1/ws`)
Compressie	12-engine pijplijn — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Authenticatie & beveiliging	OAuth 2.0 (PKCE) + JWT + API Keys + MCP scoped authenticatie · AES-256-GCM in rust · DOMPurify
Stealth	wreq-js — JA3 / JA4 TLS vingerafdruk-imitatie, 3-laags proxy
Veerkracht	Circuitonderbreker, exponentiële terugval, anti-thundering-herd, auto-combo zelfherstel
Logging	pino — gestructureerde JSON-logs met verzoekcontext
Testen	Node.js test runner + Vitest — 39.000+ statische testdeclaraties over 5.100+ bijgehouden testbestanden (unit, integratie, E2E, beveiliging, ecosysteem)
Platformen	Desktop (Electron) · Android (Termux) · PWA (elke browser)
CI/CD	GitHub Actions — automatische npm-publicatie + Docker Hub bij release
Links	Website · npm · Docker Hub

## 📖 Documentatie

### 📘 Aan de slag

Document	Beschrijving
Gebruikershandleiding	Providers, combinaties, CLI-integratie, implementatie
Installatiehandleiding	Alle installatiemethoden, configuraties van CLI-tools, protocolconfiguratie, afstemming van time-outs
Handleiding voor CLI-tools	Configuratie per tool voor Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Externe modus	Bestuur een externe OmniRoute (VPS) vanaf de CLI op uw laptop via toegangstokens met een beperkt bereik
Claude Code-configuratie	Verbind Claude Code met OmniRoute (lokaal/extern) via `launch` en profielen per model
Snel aan de slag	Installeren → verbinden → configureren in 3 stappen

### 🔧 Beheer en implementatie

Document	Beschrijving
Docker-handleiding	Docker run, Compose-profielen, Caddy HTTPS, tunnels, image-tags
Podman-handleiding	Quadlet-systemd-integratie, podman-compose, SELinux
VM-implementatie	Volledige handleiding: configuratie van VM + nginx + Cloudflare
Fly.io-implementatie	Implementeren op Fly.io met permanente opslag
Termux-handleiding	Voer OmniRoute uit op Android via Termux
PWA-handleiding	Installatie, caching en architectuur van Progressive Web Apps
De-installatiehandleiding	Schone verwijdering voor alle installatiemethoden
Omgevingsconfiguratie	Volledig overzicht van `.env`-variabelen en referenties

### 🧠 Functies en architectuur

Document	Beschrijving
Architectuur	Systeemarchitectuur, gegevensstroom en interne werking
Compressiehandleiding	Pipeline met 7 opties: uit / licht / standaard / agressief / ultra / RTK / gestapeld
RTK-compressie	Compressie van opdrachtuitvoer, filters, vertrouwen, verificatie, herstel van onbewerkte uitvoer
Compressie-engines	Caveman, RTK, gestapelde pipelines, dashboard-/API-/MCP-interfaces
Indeling van compressieregels	JSON-schema's voor regelpakketten voor Caveman- en RTK-filters
Taalpakketten voor compressie	Taaldetectie en samenstelling van Caveman-regelpakketten
Handleiding voor veerkracht	Stroomonderbrekers, afkoelperiodes, wachtrij, bescherming tegen thundering-herd-problemen, TLS-spoofing
Auto-Combo-engine	Scoring met 16 factoren, moduspakketten, zelfherstel
Proxyhandleiding	Proxysysteem met 3 niveaus, 1proxy-marktplaats, register-CRUD
Gratis niveaus	Geconsolideerd overzicht: 35 gedocumenteerde terugkerende pools / 489 gecatalogiseerde gratis items
Functiegalerij	Visuele rondleiding door het dashboard met schermafbeeldingen
Codebase-documentatie	Beginnersvriendelijke rondleiding door de codebase

### 🤖 Protocollen en API's

Document	Beschrijving
API-referentie	Alle eindpunten met voorbeelden
OpenAPI-specificatie	OpenAPI 3.0-specificatie
MCP-server	110 MCP-tools, IDE-configuraties, Python-/TS-/Go-clients
MCP-serverhandleiding	MCP-installatie, transporten en toolreferentie
A2A-server	JSON-RPC 2.0-protocol, vaardigheden, streaming, taakbeheer
A2A-serverhandleiding	A2A-agentkaart, taken, vaardigheden en streaming

### 📋 Project en kwaliteit

Document	Beschrijving
Bijdragen	Ontwikkelomgeving en richtlijnen
Branch- en releasemodel	Op welke branches PR's zijn gericht (`release/*`) en wat `main` en tags betekenen
Wijzigingslogboek	Volledige releasegeschiedenis per versie
Beveiligingsbeleid	Melden van kwetsbaarheden en beveiligingspraktijken
i18n-handleiding	Ondersteuning voor 42 talen, vertaalworkflow, RTL
Releasechecklist	Validatiestappen vóór een release
Dekkingsplan	Testdekkingsstrategie voor meer dan 39.000 statische testdeclaraties in meer dan 5.100 bijgehouden testbestanden

# ⭐ Topbijdragers > OmniRoute wordt gevormd door een gepassioneerde opensourcecommunity. Deze personen hebben uitzonderlijke bijdragen geleverd die rechtstreeks van invloed zijn op de kwaliteit, stabiliteit en reikwijdte van het project. **Dank jullie wel.** ### Externe bijdragers op basis van samengevoegde pull requests

Rang	Bijdrager	Samengevoegde PR's	~Gewijzigde regels
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

_{Vastgelegd op de actuele tip dafb4ae808 van release/v3.8.50, met samenvoegingen tot en met 2026-08-24 05:26:03 UTC. De gepagineerde GitHub GraphQL-inventarisatie bevat 5.911 samengevoegde PR's: 2.707 van de repository-eigenaar, 179 van Dependabot en 3.025 externe PR's van 535 verschillende bijdragers. “Gewijzigde regels” is de som van toevoegingen en verwijderingen volgens GitHub en omvat gegenereerde bestanden, lockfiles, catalogi, vertalingen en documentatie; het betreft wijzigingen, niet zelfgeschreven LOC. Gelijke standen rond de grens zijn behouden.} ### Aan GitHub toegeschreven commits

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

_{Opnieuw gecontroleerd op 2026-08-24 06:14:31 UTC: aan GitHub toegeschreven commits zoals gerapporteerd door de Contributors API van de repository voor de standaardbranch release/v3.8.50. De API retourneerde 525 identiteiten (415 gebruikers, 2 bots, 108 anonieme identiteiten); deze tabel sluit de beheerder, bots en anonieme identiteiten uit en behoudt gedeelde plaatsen. Deze wijkt zowel af van de rangschikking van samengevoegde PR's hierboven als van de inventarisatie van 639 personen op basis van Git-metadata hieronder.} > 🙏 De functies, bugfixes en infrastructuurverbeteringen van deze bijdragers vormen een **essentieel onderdeel** van wat OmniRoute betrouwbaar en functierijk maakt. Elke pull request, elke testcase en elk i18n-vertaalbestand is belangrijk. Open source wordt gebouwd door mensen zoals zij.

---
## 💖 Sponsors

Een welgemeend dankjewel aan de mensen die OmniRoute uit eigen zak financieren — elke bijdrage houdt het project gratis, onafhankelijk en in beweging.

Andrew
_{💛 Actieve maandelijkse sponsor}

Vlad I
_{💛 Actieve maandelijkse sponsor}

Paco Cartones
_{💛 Actieve eenmalige sponsor}

Prof. Igor Morais
_{💛 Voormalige eenmalige supporter}

longtao
_{💛 Voormalige eenmalige supporter}

_{… en anderen die liever privé blijven 💛} _{Openbare GitHub Sponsors opnieuw gevalideerd op 2026-08-24. De status activeOnly van GitHub bepaalt de bovenstaande actieve labels; eerder openbaar gemaakte eenmalige supporters blijven vermeld als dank, en privésponsors blijven anoniem.} 💖 Word sponsor → — elke dollar houdt OmniRoute gratis en onafhankelijk.

## 👥 600+ bijdragers

[![Bijdragers](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Gecontroleerd op 2026-08-24 met de bevroren basis ac02c5b42f en opnieuw gecontroleerd bij de actuele tip dafb4ae808 van release/v3.8.50: 639 genormaliseerde menselijke Git-identiteiten — 407 komen voor als auteurs van commits (inclusief de beheerder) en 232 uitsluitend in expliciete Co-authored-by-trailers. De telling normaliseert noreply-handles van GitHub, sluit 26 identiteiten van bots/agents/services/placeholders uit en voegt gewone e-mailadressen niet samen enkel omdat hun weergavenamen overeenkomen.} ### Bijdragen 1. Fork de repository 2. Maak een branch vanaf de **actieve** tip van `release/vX.Y.Z` (niet vanaf `main`) — zie [Branch- en releasemodel](docs/ops/BRANCHING_MODEL.md) 3. Maak je featurebranch (`git checkout -b feat/amazing-feature`) 4. Commit je wijzigingen (`git commit -m 'feat: add amazing feature'`) 5. Push naar de branch (`git push origin feat/amazing-feature`) 6. Open een Pull Request met **base = die `release/vX.Y.Z`-branch** Zie [CONTRIBUTING.md](CONTRIBUTING.md) voor gedetailleerde richtlijnen. ### Een nieuwe versie uitbrengen ```bash # Maak een release — npm publish gebeurt automatisch VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Sterren

## 🌍 StarMapper

## 🙏 Dankbetuigingen

OmniRoute staat op de schouders van reuzen. Het begon als een fork van **[9router](https://github.com/decolua/9router)** en een TypeScript-port van het Go-project **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — en van daaruit werd elk onderstaand subsysteem geïnspireerd door een opensourceproject dat ons voorging. Elk project gaf vorm aan een concreet onderdeel van OmniRoute. Hiermee willen we ze allemaal bedanken. 🙏 > ⭐ aantallen sterren geverifieerd via de REST API van GitHub op 24 augustus 2026 — geef deze projecten ook een ster. De aantallen zijn een exacte momentopname van die datum en zullen uiteraard veranderen. ### 🧬 Afstamming en gateway

Project	⭐	Hoe het OmniRoute inspireerde
9router	26,161	Het oorspronkelijke project waarop deze fork is gebaseerd — hier uitgebreid met multimodale API's en volledig herschreven in TypeScript.
CLIProxyAPI	48,497	De Go-implementatie die als inspiratie diende voor deze JavaScript-/TypeScript-port.
LiteLLM	57,100	De AI-gateway waarvan de openbare prijsdataset onze synchronisatie voor kostentracering voedt en waarvan het model voor providernormalisatie als uitgangspunt diende voor onze routering.
codex-chatgpt-web	1,410	MIT-broncode die is aangepast voor de meegeleverde ChatGPT Web → Codex Responses-bridge, inclusief adapters voor browsersessies, responseframing, gebruik en zoeken op het web.
free-claude-code	48,112	Patronen die zijn overgenomen voor streamherstel, aliassen zonder denkmodus, terugvalopties voor zoeken op het web, schuivende vensterlimieten, redactie van logboeken en versterkte opstartflows.
composer-api	322	Patronen voor toolkeuze, uitvoerbeperkingen en toolvastlegging van Cursor Composer die zijn aangepast voor de systeemeigen Cursor-executor.
codex-multi-auth	457	Patronen voor opnieuw aanmelden en refresh-tokenrotatie die zijn overgenomen in de OAuth-herauthenticatie van Codex.
opencode-anthropic-auth	510	Met Claude Code compatibele standaardinstellingen voor transformaties en gedrag van factureringsheaders, gegeneraliseerd in de configuratiegestuurde bridge van OmniRoute.
grok2api-merged	2	De Grok-modeltoewijzingen, fake-TypeError Statsig-generator, standaardinstellingen voor verzoeken en apparaten en NDJSON-responseprocessor ervan zijn substantieel aangepast voor de Grok Web-executor van OmniRoute.
TQZHR/grok2api	705	De voornaamste indirecte broncode achter grok2api-merged; de implementaties voor modellen, headers, payloads, Statsig en verwerking ervan zijn behouden in de ontwikkelingslijn van Grok Web.
chenyme/grok2api	7,520	De onderliggende MIT-broncode voor standaardinstellingen van Grok-payloads en -apparaten, de Statsig-generator en de `result.response`-processor, overgenomen via TQZHR en grok2api-merged.
grok2api-pro	27	Een indirecte bron die door grok2api-merged wordt vermeld voor de proxy-poollaag; OmniRoute behoudt die vermelding van de ontwikkelingslijn, maar claimt geen port van een proxy-pool in zijn afgebakende Grok Web-executor.
GrokProxy	50	De via cookies geauthenticeerde Grok-proxy en het streamingpatroon `result.response.token` ervan dienden als inspiratie voor het Grok Web-transport van OmniRoute.
GrokBridge	5	Voor de oorspronkelijke Grok Web-implementatie is het upstreamontwerp voor HTTP en browsers geraadpleegd; het directe HTTP-pad ervan is afgeleid van GrokProxy, dus er wordt geen onafhankelijke codeport geclaimd.
grok-web-api	14	De Rust-schema's voor `ChatOptions` en response-enveloppen ervan dienden als uitgangspunt voor de TypeScript-typen van OmniRoute voor Grok-verzoeken en streamingresponses.

### 🗜️ Context- en tokencompressie — engines

Project	⭐	Hoe het OmniRoute inspireerde
Caveman	100,538	Het virale project "waarom veel token gebruiken als weinig token werken" — de holbewonertaalfilosofie ervan vormt de basis van onze standaardcompressiemodus en meer dan 30 regels voor stopwoordverwijdering en tekstverdichting.
RTK – Rust Token Killer	77,185	Krachtige compressie van opdrachtuitvoer — inspireerde onze RTK-engine, JSON-filter-DSL, herstel van onbewerkte uitvoer en de gestapelde RTK → Caveman-pijplijn.
headroom	67,310	Omkeerbare contextcompressie (SmartCrusher) — inspireerde onze `headroom`-engine en het patroon met `ccr`-ophaalmarkeringen.
LLMLingua	6,598	Onderzoek naar promptcompressie (LLMLingua / LLMLingua-2) — inspireerde onze asynchrone, codeveilige, fail-open `llmlingua`-engine.
llmlingua-2-js	31	De JS/ONNX-port (MobileBERT / XLM-RoBERTa) die als worker-thread-backend voor onze LLMLingua-engine wordt gebruikt.
Troglodita	40	PT-BR-tokencompressie — vormt de basis van ons pt-BR-taalpakket: vermindering van pleonasmen en verwijdering van stopwoorden, afgestemd op de Braziliaans-Portugese grammatica.
ponytail	108,957	De virale "luie senior ontwikkelaar"-YAGNI-codeervaardigheid — inspireerde onze less-code-uitvoerstijl: aansturing op de kleinst werkende wijziging, waardoor _gegenereerde_ code wordt beperkt (de tegenhanger op de uitvoeras van Cavemans beknopte proza).
i-have-adhd	23,526	De actiegerichte, ADHD-vriendelijke antwoordstijl ervan werd aangepast tot OmniRoutes beknopte uitvoerstijl in vijf talen.

### 🧩 Compacte formaten, tokenonderzoek & codebewuste hulpmiddelen

Project	⭐	Hoe het OmniRoute inspireerde
TOON	25,233	Token-Oriented Object Notation — het kolomgebaseerde model met koptekst en rijen gaf vorm aan onze fase voor tabelcompressie.
GCF – Graph Compact Format	41	Het compacte graafformaat en ontwerp met generieke profielen vormden de basis voor OmniRoutes tabelcompressie en het codecformaat van Headroom.
gcf-typescript	4	De MIT TypeScript-implementatie die rechtstreeks werd opgenomen en uitgebreid als de codec met generiek profiel van Headroom.
token-optimizer-mcp	494	Brotli/SQLite-cache + contextdelta per sessie — inspireerde onze `session-dedup`-engine.
token-savior	1,122	Compressie van Bash-uitvoer + MCP-profielen — inspireerde onze discipline om compressie tijdig af te breken en onze reductie van MCP-toolmanifesten.
token-saver	138	Inhoudsbewuste uitvoercompressie per bestandstype met foutbewuste afbreking — bevestigde onze routering per type en het overslaan bij onvoldoende winst.
token-optimizer	1,951	"Vind de spooktokens" — het patroon voor uitbesteding + herstelbare handles vormde de basis voor onze benadering van CCR-uitbesteding.
TokenMizer	28	Een blauwdruk met een sessiegraaf + regeldeduplicatie over meerdere beurten die de basis vormde voor ons session-dedup-ontwerp.
OmniCompress	3	Kolomgebaseerde JSON in Rust + inhoudsgeadresseerd ophalen + deduplicatie tussen berichten — bevestigde het ontwerp van onze `headroom`/`ccr`/`session-dedup`-engines en de cachebestendige invariant "de gecomprimeerde vorm is positieonafhankelijk".
mcp-compressor	113	Compressie van MCP-toolschema's/-beschrijvingen — vormde de basis voor onze cardinaliteitsreductie van MCP-toolmanifesten.
RepoMapper	197	Repo-map-rangschikking in Aider-stijl — vormde de basis voor onze verkenning van repo-maps / rangschikking voor ophalen.
quiet-shell-mcp	4	Declaratieve reductie van shell-uitvoer via MCP — bevestigde onze declaratieve compressie van Bash-uitvoer.
ts-morph	6,162	Toolkit voor de TypeScript Compiler API — inspireerde onze parsergebaseerde verwijdering van commentaar waarbij tekenreeks-, template- en regex-literalen behouden blijven.

### 🧠 Geheugen & RAG

Project	⭐	Hoe het OmniRoute inspireerde
Mem0	63,902	Universele geheugenlaag — het proxy-als-schrijf-/leesgrensmodel vormde de basis voor onze geheugenarchitectuur.
Letta (MemGPT)	24,382	Agents met status en gelaagd geheugen — inspireerde ons gelaagde model voor Context Control & Recovery (CCR).
WFGY	1,781	De ProblemMap-taxonomie van 16 terugkerende RAG/LLM-foutmodi — de gedeelde terminologie in onze probleemoplossingsgids.

### 🛰️ Verkeersinspectie, MITM & transparante proxy

Project	⭐	Hoe het OmniRoute inspireerde
llm-interceptor	66	MITM-onderschepping/-analyse van verkeer tussen codeerassistenten ↔ LLM's vormde de basis voor de eerste vereisten voor Traffic Inspector. Vier eerder afgeleide modules — SSE-samenvoeging, gespreksnormalisatie, geheimenmaskering en headeropschoning — zijn vervangen door onafhankelijke cleanroomimplementaties op basis van openbare protocolstandaarden. De twee oppervlakken voor host-passthrough (`passthrough.ts` en `_internal/bypass.cjs`) blijven interne OmniRoute-implementaties die onafhankelijk zijn geclassificeerd; ze zijn niet herschreven als onderdeel van die vervanging.
ProxyBridge	5,995	Transparante proxyroutering per proces — inspireerde onze crashbestendige MITM-afbouw, time-outs voor inactieve sockets, `/proc`-procestoewijzing en TPROXY-registratie.

### 📚 Modelgegevens, observability & UI

Project	⭐	Hoe het OmniRoute inspireerde
models.dev	6,555	Open database met specificaties, prijzen en mogelijkheden van AI-modellen — wordt rechtstreeks gesynchroniseerd met onze modelcatalogus.
React Flow / xyflow	38,108	De knooppuntgebaseerde grafiekbibliotheek waarop onze realtime Compression Studio en Combo/Routing Studio draaien.
LangGraph	40,314	De livevisualisatie van workflowgrafieken in LangGraph Studio inspireerde de realtime cascadeweergave van onze Studio's.
Langfuse	33,592	Het observabilitymodel trace → span → generatie vormde de basis voor de watervalweergave van onze Compression Studio.
Kiali	3,631	Observability voor de Istio-servicemesh — inspireerde onze circuitbreakerbadges en visuele foutverbindingen in de Routing/Combo Studio.
lobe-icons	2,428	AI/LLM-merklogo's waarmee de providerpictogrammen in ons dashboard worden weergegeven.
flag-icons	12,354	Levert de SVG-vlaggen met MIT-licentie die worden gebruikt door de taalselector in de README.

### 🛡️ Beveiliging

Project	⭐	Hoe het OmniRoute inspireerde
awesome-secure-defaults	721	Een samengestelde lijst met standaard veilige bibliotheken die onze beveiligingskeuzes stuurt (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Aanvullende tools

Project	⭐	Hoe het OmniRoute inspireerde
ClawRouter	6,564	Inspireerde verzoekdeduplicatie, een kosteloos noodterugvalmechanisme, inplugbare Auto-Combo-strategieën en meertalige intentieclassificatie.
Antigravity-Manager	30,652	De accountbewuste modelhertoewijzing, validatie van uitvoerbare bestandspaden en het gedrag van planlabels vormden de basis voor OmniRoute's Antigravity-runtime.
vscode-antigravity-cockpit	4,817	De compacte aftelnotatie voor quotaresets inspireerde de overeenkomstige weergave van providerlimieten in OmniRoute.
AionUi	32,230	De ACP-integraties inspireerden OmniRoute's automatische detectie van geïnstalleerde CLI-agents.
CodexBar	20,507	Identificeerde het Grok Build-quotaoppervlak; OmniRoute heeft vervolgens zelfstandig het actuele wire-format geverifieerd en gecorrigeerd.

## 📄 Licentie MIT-licentie - zie [LICENSE](LICENSE) voor details. ---

**[⬆ Terug naar boven](#-omniroute)** · Met ❤️ gebouwd voor de opensource-AI-community. _{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT-licentie · omniroute.online}