mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-18 04:42:30 +03:00

Files

Diego Rodrigues de Sa e Souza c3e966eeb9 docs(changelog): reconcile the v3.8.51 living section — round 2 (2026-09-15) (#13731 )

Second `npm run release:reconcile` pass on `release/v3.8.50..release/v3.8.51`
(091589089c..c0f92ec98a, 916 non-merge commits, 877 merged PRs):

- fold the 173 changelog.d fragments accumulated since #12971 under
  `## [3.8.51]` and delete them
- generate bullets for the 58 cycle commits that had no fragment
  (4 features / 42 fixes / 12 maintenance), each with the merged PR link and
  `— thanks @author`
- link 137 fragment bullets to the PR of the commit that added them and
  credit the author; two prefix/origin mismatches reviewed (#12945→#13392,
  #13001→#13379, both maintainer rebaselines of other people's PRs)
- refresh "Release by the numbers" + Top-25 and regenerate the
  `### 🙌 Contributors` hall (112 external contributors + maintainer; every
  non-bot author of the 877 merged PRs present)
- closed-PR credit audit for the window: nothing to add (#13215→#13361 and
  #13059→#13690 are still open, #12998 was independently fixed earlier by
  #12853); no human co-author trailers, no commits without a PR
- resync the 58 i18n CHANGELOG mirrors

Gates: check:changelog-integrity OK, check:docs-sync PASS.

2026-09-17 10:47:11 -03:00

docs

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CHANGELOG.md

docs(changelog): reconcile the v3.8.51 living section — round 2 (2026-09-15) (#13731 )

2026-09-17 10:47:11 -03:00

CLAUDE.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CODE_OF_CONDUCT.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CONTRIBUTING.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

GEMINI.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

llm.txt

fix(db): bound health scans and isolate native diagnostics (#13717 )

2026-09-16 12:59:45 -03:00

README.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

SECURITY.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

README.md

README (Nederlands)

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

🚀 OmniRoute — De gratis AI-gateway

OmniRoute — Stop nooit met programmeren. Elke AI-tool → 359 providers — 150+ gratis — via één endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity naar GRATIS Claude / GPT / Gemini met automatische fallback. Gestapelde compressie met RTK + Caveman bespaart 15–95% tokens (~89% gemiddeld) — bereik nooit meer limieten. 359 AI-providers · 150+ gratis niveaus · ~1,47 mld. gratis tokens/mnd. · 19 routeringsstrategieën · $0 om te beginnen.

💰 ~1,47 mld. gratis tokens / maand

Het handmatig combineren van gratis abonnementen is omslachtig — tientallen SDK's, tientallen snelheidslimieten en geen idee hoeveel je daadwerkelijk hebt. OmniRoute catalogiseert 452 gratis vermeldingen verspreid over 34 terugkerende poolsleutels en berekent het tokenaantal op basis van de 16 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, +~6 mln. na regionale identiteitsverificatie, en worden nooit bij het totaal opgeteld. Het resultaat blijft zichtbaar op het dashboard (/dashboard/free-tiers).

OmniRoute-budgetkaart voor gratis abonnementen: structureel ~1,47 mld. gratis tokens per maand, oplopend tot ~2,07 mld. in de eerste maand met registratiecredits, afkomstig van 34 gedocumenteerde terugkerende poolsleutels die 452 gecatalogiseerde gratis vermeldingen achter één endpoint omvatten. Eerlijke, per pool gededupliceerde berekening — elke gedeelde pool wordt één keer meegeteld, inclusief 16 terugkerende pools met een gepubliceerd positief maandelijks tokenbudget plus vijf Groq-limieten per model; 13 providers zijn in de catalogus voor voorwaardenrisico's gemarkeerd als te vermijden, zodat je zelf kunt beslissen. De budgetbalk omvat Mistral 1 mld., Nara 210 mln., LLM7 150 mln., Groq 30 mln. (vijf limieten per model) en kleinere pools, plus registratiecredits voor de eerste maand en permanent gratis providers zonder tokenlimiet die afzonderlijk worden weergegeven, zodat ze het hoofdtotaal nooit kunstmatig verhogen. Live verbruik/resterend op /dashboard/free-tiers.

Geanimeerde samenvatting van de livepagina /dashboard/free-tiers. Volledige methodologie (pooldeduplicatie, creditniveaus, providervoorwaarden): 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 — als een provider een gratis abonnement beëindigt, daalt het aantal; komt er een nieuwe bij, dan stijgt het. We publiceren wat de catalogus daadwerkelijk berekent, nooit een naar boven afgerond gunstigste scenario.}

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

💬 Word lid van de community

👋 Volg de beheerder — ontvang als eerste nieuwe providers, releases en tips:

Vragen, providertips, roadmap en ondersteuning → Discord · Telegram · WhatsApp 🌍 Wereldwijd / 🇧🇷 Brazilië / Portaal

📈 De gateway blijft groeien

	v3.8.49	v3.8.50	`v3.8.51+`
🌐 Providers	290	352	meer gepland
🧠 Unieke chatmodel-ID's	1185	1312	—
🖼️ Modaliteitsbrug	—	🆕 beeld + audio + video	—
📡 Gratis radarcatalogus	—	🆕 optioneel	—
⚖️ Quotabewuste planning	—	🆕 Quota-Share	—
📊 Quotatelemetrie	—	🆕 live	—

→ Roadmap — op weg naar v3.9.0 LTS

🧩 Beschikbaar

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

🌐 In 66 talen

🆓 Werkt direct na installatie — geen sleutels, geen configuratie

Werkt direct na installatie — geen configuratie. Drie stappen: 1. Installeren — npm i -g omniroute, de server start op localhost:20128. 2. Richt je tool op http://localhost:20128/v1 — elke OpenAI-compatibele tool (Claude Code, Cursor, Cline). 3. Je krijgt antwoord — roep model auto aan voor direct antwoord, zonder API-sleutel, registratie of configuratie. De sleutelloze provider OpenCode Free is vooraf gekoppeld aan de auto-combinatie, zodat een nieuwe installatie meteen werkt.

# Nieuwe installatie, geen inloggegevens — `auto` werkt meteen:
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) rechtstreeks aan. Stap daarna over op auto en laat OmniRoute kiezen.}

_{📦 Direct te kopiëren quickstart-scripts voor Python, Node.js, PHP en cURL → examples/quickstart/}

💥 De belofte

🤔 Waarom OmniRoute?

OmniRoute-aanvraagstroom: 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, circuitbreakers, TLS-stealth, MCP, A2A, beveiligingsregels) kan terugvallen op 4 providerniveaus zolang er een geschikt en gezond doel beschikbaar blijft — Niveau 1 Abonnement, Niveau 2 API-sleutel, Niveau 3 Goedkoop en Niveau 4 Gratis.

🤝 Ondersteund door onze Open Source-vrienden

Wil je je aansluiten als Open Source-vriend? Dit zijn de bedrijven die open source ondersteunen en OmniRoute vooruithelpen — en we maken openbaar waar elke token die ze ons geven naartoe gaat. Neem contact op: diegosouza.pw@outlook.com

Kimi
_{Moonshot AI} Dank aan Kimi (Moonshot AI), onze oprichtende Open Source-vriend, voor de ondersteuning van dit project! Kimi is het AI-lab achter de open-weight-modelfamilies K2 en K3 — Kimi K3 biedt een contextvenster van 1 miljoen tokens, native beeldverwerking en programmeermogelijkheden van grensverleggend niveau voor een fractie van de prijzen van gesloten modellen, en werkt direct met Claude Code, Codex en elke programmeertool die OmniRoute ondersteunt.

Wat de ondersteuning van Kimi mogelijk maakt: De API-tegoeden van Kimi ondersteunen de door AI gevalideerde release-pijplijn van OmniRoute — de fase samenvoegvalidatie, mogelijk gemaakt door Kimi K3, die elke pull request beoordeelt voordat deze wordt uitgebracht — en de dagelijkse ontwikkeling van functies. Volwaardige ondersteuning voor Kimi wordt via beide kanalen geleverd: de directe Kimi API (kimi-k3) en het Kimi Code-programmeerabonnement (OAuth en API-sleutel). OmniRoute is tevens het eerste Braziliaanse opensourceproject in het ondersteuningsprogramma van Kimi. Ontvang een Kimi API-sleutel met 15% extra tegoed →

Cheaper Inference
_{cheaperinference.com} Dank aan Cheaper Inference, een Open Source-vriend van OmniRoute, voor de ondersteuning van dit project! Cheaper Inference is een op kosten gerangschikte gateway die 42 grensverleggende modellen doorverkoopt — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok en MiniMax — via één OpenAI-compatibel endpoint. Elk verzoek wordt doorgestuurd naar de goedkoopste geschikte provider, zonder ooit meer in rekening te brengen dan de catalogusprijs van de modelmaker.

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

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

_{🎟️ Affiliatepromoties — gratis aanmeldcoupons van providers die ons niet sponsoren (klik om uit te vouwen)}

_{Deze sectie is uitsluitend bedoeld voor verwijzings- en couponcodes. Gesponsorde samenwerkingen staan hierboven onder 🤝 Ondersteund door onze Open Source-vrienden. OmniRoute heeft geen sponsor- of partnerrelatie met de hier vermelde providers — dit zijn openbare coupons die iedereen kan gebruiken.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — aanmelding via affiliate · $100 gratis tegoed bij aanmelding (gratis server, houd rekening met een hogere latentie — het meest geschikt voor tests, niet voor productie). Volwaardige 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 →}

_{⚠️ Affiliatelink — OmniRoute heeft geen sponsor- of partnerrelatie met deze provider.}

_{Ken je een andere provider met een royale gratis aanmeldcoupon waar OmniRoute-gebruikers van profiteren? Open een issue, dan voegen we die 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.}

🧱 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 · Veerkrachthandleiding}

🏆 Wat OmniRoute onderscheidt

_{📊 Volledige methodologie & details per functie versus 9router, OpenRouter, CLIProxyAPI & LiteLLM → 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ë)

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.

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 gratislimiet blijft ~1,47 miljard tokens/maand uit de hierboven gedocumenteerde, op poolniveau gededupliceerde catalogus. Tijdelijke registratiecredits van providers kunnen de eerste maand afzonderlijk verhogen tot ~2,07 miljard. Radar is een optionele, ondertekende catalogusoverlay voor mensen die tussen OmniRoute-releases door actuelere beschikbaarheid van gratis modellen willen; de communitycatalogus en alle bestaande gratis functies blijven gratis.

Supporters kunnen de livecatalogus en aanvullende mogelijkheden bij providers ontvangen. Het afzonderlijke, variabele maximum bedraagt hooguit ongeveer 3 miljard tokens/maand, afhankelijk van de beschikbaarheid bij providers. Dat maximum is geen garantie: providers kunnen quota, toelatingsvoorwaarden, modellen of regio's op elk moment wijzigen.

Radar is opt-in en uitsluitend voor GET-verzoeken. De OmniRoute-client uploadt geen prompts, verkeer, providerconfiguratie, gebruikstelemetrie of de lokale status voor het negeren van aankondigingen. Lees meer over de toelatingsvoorwaarden en de huidige catalogus op radar.omniroute.online/planos.

✨ Wat is er nieuw?

Recente hoogtepunten van v3.8.20 → v3.8.50. De volledige geschiedenis staat in 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
🛂 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
🗂️ Canonieke volgorde van /v1/models — één aaneengesloten, per provider gegroepeerd blok voor elke provider (combo's eerst vastgezet), consistent voor elke catalogusbron. → API-referentie
🗜️ Robuustere compressie — standaard ingeschakelde beveiliging tegen inflatie, Caveman-pakketten voor DE / FR / JA + Chinees (wényán), RTK-filters voor Gradle en .NET. → Compressie
💸 Eerlijke vaste kosten — providers met een abonnement / programmeerplan worden in kostenanalyses als $0 weergegeven; budget, quota en routering blijven ramingen maken. → API-referentie
⚖️ Quota-Share-routering — verdeel het quotum van een gedeeld account eerlijk over samengevoegde sleutels, met werkbehoud zodat ongebruikte delen worden uitgeleend. → Handleiding voor veerkracht
🤖 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
🛰️ Externe modus — bestuur een externe OmniRoute met tokens met een beperkt bereik (connect / contexts / tokens) + een antigravity OAuth-helper voor VPS-installaties. → Externe modus
🧭 Slimmere automatische routering — auto/<category>:<tier>-combo's, Fusion (modelpanel + beoordelaar), taakbewuste routering, overschrijvingen per verzoek voor model / modus / USD-budget. → Auto-Combo
🗜️ 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
🕵️ Transparante MITM-ontsleuteling (TPROXY) — onderschep CLI's die proxy-omgevingsvariabelen negeren, met een CA per SNI + installatieprogramma voor de vertrouwensopslag. → MITM/TPROXY
💸 Kostentelemetrie overal — X-OmniRoute-*-headers voor kosten/gebruik op elk eindpunt, besparingsheader voor cache-HIT's, USD-uitgavenquota per sleutel. → API-referentie
🧠 Geheugen waarover jij de controle hebt — standaard uitgeschakeld, optionele int8-vectorkwantisatie + getypeerd verval, x-omniroute-no-memory per verzoek. → Geheugen
🛡️ 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
🖼️ Nieuwe eindpunten — /v1/ocr (Mistral OCR) en /v1/audio/translations (in Whisper-stijl) maken het media-aanbod compleet. → API-referentie
🎨 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
🌍 Implementatie en beheer — reverse-proxy-basePath, automatische detectie van de browsertaal, apparaattracking per sleutel, rootloze MITM-vertrouwensconfiguratie, zh-TW-lokalisatie. → Omgeving
🤝 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
📡 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
⚡ 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
🧩 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

🤖 Compatibele CLI's en programmeeragents

Eén configuratie — http://localhost:20128/v1 — en elke AI-IDE of CLI werkt met 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}	_{Agent Deck}

＋ werkt ook met · 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 · 🧩 OpenCode-plug-in → @omniroute/opencode-provider}

Start elke ondersteunde CLI via OmniRoute met één opdracht — er worden geen configuratiebestanden geschreven, referenties worden per proces geïnjecteerd en Qwen/Gemini krijgen een tijdelijke, geïsoleerde thuismap:

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 <host>), --dry-run toont vooraf de exacte omgevingsvariabelen/argumenten zonder iets uit te voeren, en --api-key-env NAME houdt geheimen buiten je shellgeschiedenis. → CLI-integraties

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

352 geregistreerde providers verdeeld over de canonieke collecties voor chat, media, zoeken, lokaal gebruik, 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 voor gratis budgetten bevat 443 rijen per model, 34 terugkerende pools en 53 terugkerende/sleutelloze providers die altijd gratis zijn. Deze noemers verschillen bewust; definities en berekeningen waarbij dubbele pools zijn verwijderd, staan in de Providerreferentie en Gratis niveaus.

🏢 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 opgehaald uit de providercatalogus van het dashboard. 📖 Providerreferentie}

🆓 Voor altijd gratis — $0, geen kaart nodig

OpenCode Zen _{DeepSeek V4, Nemotron 3 Geen tokenlimiet}	Kilo Code _{Automatische routering, Tencent Hy3 Voor altijd gratis}	Requesty _{GPT-OSS 120B, Nemotron Voor altijd gratis}	SiliconFlow _{DeepSeek V3.2 / R1 Gratis abonnement}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Voor altijd gratis}	Baidu ERNIE _{ERNIE 4.0 Voor 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

🖥️ 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 · Desktop · Menubalk-app · Termux · PWA · OpenCode}

🧩 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, 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.

_{📖 Handleiding voor VS Code Copilot Chat — 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 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 (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

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 · Beveiligingsmaatregelen · Naleving}

🔌 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`)

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.

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}

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

# 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 · A2A-server · Agentprotocollen}

🗜️ 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:

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, Caveman (⭐ 90K+), LLMLingua-2 en 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-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: <mode>; source=<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 · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md

⚡ Snel aan de slag

1) Installeren en uitvoeren

npm install -g omniroute
omniroute

💡 Zie je npm warn ERESOLVE of peer-dep-waarschuwingen? Die zijn onschadelijk.

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

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

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:

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

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.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

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.

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.

🥟 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 .).

# Installeren en uitvoeren met Bun
bun install
bun run dev

🛠️ Vanuit de broncode

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# Nix-flakes gebruiken
nix develop
npm run dev

# Of devbox gebruiken
devbox run npm run dev

📖 Docker-handleiding — Compose-profielen, Caddy HTTPS, Cloudflare-tunnels.

🦭 Podman

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

📖 Podman-handleiding — 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):

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. 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 — 3,042,474	theopenstack — Instagram — 692,419	milesreevesai — TikTok — 620,400	Vaibhav Sisinty — YouTube — 391,109	buildwithai.club — Instagram — 347,652

#6	#7	#8	#9	#10
nivedan.ai — Instagram — 331,973	vaibhavsisinty — Instagram — 263,744	Nick Automates — YouTube Shorts — 218,174	theroshankrishna — Instagram — 186,786	midudev — TikTok — 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 of discussie 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
🐙 GitHub — volg voor releases en tips	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 Wereldwijd	word lid van de groep
🟢 WhatsApp — 🇧🇷 Brazilië	word lid van de groep
🌍 Website	omniroute.online
🌍 🌍StHub OmniRoute-community (gratis)	StHub-portaal
📦 Broncode	github.com/diegosouzapw/OmniRoute
🐛 Een bug melden	open een issue — voeg de uitvoer van `npm run system-info` toe
🤝 Bijdragen	CONTRIBUTING.md · Branch- en releasemodel · kies een `good first issue`
💚 Het project steunen	Manieren om bij te dragen ↑ · GitHub Sponsors

🛠️ Techstack

Laag	Technologie
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Taal	TypeScript 6.0 — 100% TypeScript in `src/` en `open-sse/` (sinds v2.0 geen enkele `any` in de kern)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Database	better-sqlite3 (SQLite, WAL-journaling) + LowDB (verouderde JSON-opslag) — 122 domeinmodules, 176 migraties
Geheugen	SQLite FTS5-volledige-tekstzoekfunctie + int8-gekwantiseerde vectorembeddings, getypeerd verval
Schema's	Zod 4 — validatie van MCP-tool-I/O + API-contracten
Protocollen	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + WebSocket-bridge (`/v1/ws`)
Compressie	Pipeline met 12 engines — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Authenticatie & beveiliging	OAuth 2.0 (PKCE) + JWT + API-sleutels + MCP-authenticatie met scopes · AES-256-GCM voor opgeslagen gegevens · DOMPurify
Onopvallendheid	wreq-js — imitatie van JA3-/JA4-TLS-vingerafdrukken, proxy op 3 niveaus
Veerkracht	Circuitbreaker, exponentiële back-off, bescherming tegen thundering herds, zelfherstel met automatische combinaties
Logging	pino — gestructureerde JSON-logboeken met aanvraagcontext
Testen	Node.js-testrunner + Vitest — meer dan 39.000 statische testdeclaraties verspreid over meer dan 5.100 bijgehouden testbestanden (unit-, integratie-, E2E-, beveiligings- en ecosysteemtests)
Platformen	Desktop (Electron) · Android (Termux) · PWA (elke browser)
CI/CD	GitHub Actions — automatische publicatie naar npm + Docker Hub bij een release
Links	Website · npm · Docker Hub

📖 Documentatie

📘 Aan de slag

Document	Beschrijving
Gebruikershandleiding	Providers, combinaties, CLI-integratie, implementatie
Installatiehandleiding	Alle installatiemethoden, configuraties voor 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 op Android uit via Termux
PWA-handleiding	Installatie, caching en architectuur van de Progressive Web App
Verwijderingshandleiding	Volledige verwijdering voor alle installatiemethoden
Omgevingsconfiguratie	Alle `.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 ruwe 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 het maken van Caveman-regelpakketten
Handleiding voor veerkracht	Circuitbreakers, afkoelperiodes, wachtrij, bescherming tegen thundering herds, TLS-spoofing
Auto-Combo-engine	Beoordeling op basis van 16 factoren, moduspakketten, zelfherstel
Proxyhandleiding	Proxysysteem met 3 niveaus, 1proxy-marktplaats, CRUD voor het register
Gratis niveaus	Geconsolideerd overzicht: 34 gedocumenteerde terugkerende pools / 452 gecatalogiseerde gratis-niveauvermeldingen
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, transportmethoden 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	Strategie voor testdekking van meer dan 39.000 statische testdeclaraties in meer dan 5.100 bijgehouden testbestanden

⭐ Topbijdragers

OmniRoute wordt gevormd door een bevlogen opensourcecommunity. Deze personen hebben uitzonderlijke bijdragen geleverd die rechtstreeks van invloed zijn op de kwaliteit, stabiliteit en het bereik van het project. Bedankt.

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” staat voor toevoegingen + 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, 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. De tabel staat los van zowel de rangschikking van samengevoegde PR's hierboven als de telling van 639 personen op basis van Git-metadata hieronder.}

🙏 De functies, bugfixes en infrastructuurverbeteringen van deze bijdragers vormen een kernonderdeel van wat OmniRoute betrouwbaar en rijk aan functies maakt. Elke pull request, elke testcase en elk i18n-vertaalbestand telt. 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

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

Fork de repository
Maak een branch vanaf de actieve tip van release/vX.Y.Z (niet vanaf main) — zie Branch- en releasemodel
Maak je featurebranch (git checkout -b feat/amazing-feature)
Commit je wijzigingen (git commit -m 'feat: add amazing feature')
Push naar de branch (git push origin feat/amazing-feature)
Open een Pull Request met base = die release/vX.Y.Z-branch

Zie CONTRIBUTING.md voor gedetailleerde richtlijnen.

Een nieuwe versie uitbrengen

# 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 en een TypeScript-port van het Go-project 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 voor details.

⬆ Terug naar boven · Met ❤️ gebouwd voor de opensource-AI-community.

_{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT-licentie · omniroute.online}

README.md Unescape Escape

README (Nederlands)

🚀 OmniRoute — De gratis AI-gateway

💰 ~1,47 mld. gratis tokens / maand

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

💬 Word lid van de community

📈 De gateway blijft groeien

🧩 Beschikbaar

🆓 Werkt direct na installatie — geen sleutels, geen configuratie

💥 De belofte

🤔 Waarom OmniRoute?

🤝 Ondersteund door onze Open Source-vrienden

🎯 Combo's — Het vlaggenschip

⚡ Configuratievrij — gebruik gewoon auto

🔀 Of bouw je eigen combo — 19 routeringsstrategieën

🧱 Veerkracht is ingebouwd (3 onafhankelijke lagen)

🏆 Wat OmniRoute onderscheidt

💚 Steun OmniRoute

📡 OmniRoute Radar

✨ Wat is er nieuw?

🤖 Compatibele CLI's en programmeeragents

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

🏢 Elk groot lab — via één endpoint

🆓 Voor altijd gratis — $0, geen kaart nodig

🖥️ Waar OmniRoute draait — overal

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

🎩 Nieuw: OmniRouteTray — jouw gateway in de menubalk

🔒 Privé & lokaal-eerst

🔌 Volledige CLI + A2A & MCP

⌨️ Een echte CLI (niet alleen start)

🛰️ Externe modus — voer de CLI hier uit en OmniRoute op een VPS

🤝 Verbind een agent — en deze bestuurt OmniRoute zelf

🗜️ Bespaar automatisch 15–95% tokens

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

🧱 De stack met 12 engines

🎚️ Meer dan alleen de engines — uitvoerstijlen, de adaptieve regelaar en controle per aanvraag

⚡ Snel aan de slag

📦 Meer installatiemethoden — Docker, broncode, pnpm, Arch

🎬 OmniRoute in actie

📹 Videohandleidingen

📧 Community en hulp

🛠️ Techstack

📖 Documentatie

📘 Aan de slag

🔧 Beheer en implementatie

🧠 Functies en architectuur

🤖 Protocollen en API's

📋 Project en kwaliteit

⭐ Topbijdragers

Externe bijdragers op basis van samengevoegde pull requests

Aan GitHub toegeschreven commits

💖 Sponsors

👥 600+ bijdragers

Bijdragen

Een nieuwe versie uitbrengen

📊 Sterren

🌍 StarMapper

🙏 Dankbetuigingen

🧬 Afstamming en gateway

🗜️ Context- en tokencompressie — engines

🧩 Compacte formaten, tokenonderzoek & codebewuste hulpmiddelen

🧠 Geheugen & RAG

🛰️ Verkeersinspectie, MITM & transparante proxy

📚 Modelgegevens, observability & UI

🛡️ Beveiliging

🧭 Aanvullende tools

📄 Licentie

README.md

⚡ Configuratievrij — gebruik gewoon `auto`

⌨️ Een echte CLI (niet alleen `start`)