# README (Slovenčina) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇮 [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 — Bezplatná AI brána **Vytvoril [Diego Souza](https://github.com/diegosouzapw)**

OmniRoute — Nikdy neprestaňte programovať. Každý nástroj AI → 388 poskytovateľov — 150+ bezplatných — cez jeden endpoint. Claude Code, Codex, Cursor, Cline, Copilot a Antigravity do BEZPLATNÉHO Claude / GPT / Gemini s automatickým záložným riešením. Kompresia RTK + Caveman v niekoľkých vrstvách šetrí 15–95 % tokenov (~89 % v priemere) — nikdy nenarazíte na limity. 388 poskytovateľov AI · 150+ bezplatných úrovní · ~1,62 miliardy bezplatných tokenov/mes. · 20 stratégií smerovania · začnite za $0.

## 💰 ~1,62 mld. tokenov / mesiac naprieč bezplatnými úrovňami poskytovateľov tretích strán

> **Použite vlastné účty u poskytovateľov.** Ide o odhadovaný súhrn naprieč samostatne oprávnenými bezplatnými úrovňami tretích strán, nie o pridelené tokeny od OmniRoute. Zaregistrujte sa, v prípade potreby získajte prihlasovacie údaje a pripojte poskytovateľov, ktorých môžete používať; každý poskytovateľ určuje svoje limity, dostupnosť a podmienky. > > Ručné kombinovanie bezplatných úrovní je nepraktické — desiatky SDK, desiatky rýchlostných limitov a žiadna predstava o tom, koľko toho v skutočnosti máte. OmniRoute eviduje **465 položiek bezplatných úrovní naprieč 34 opakujúcimi sa kľúčmi poolov** a vypočítava hlavný údaj o počte tokenov zo **17 poolov s publikovaným kladným mesačným rozpočtom plus piatich limitov Groq pre jednotlivé modely**, pričom ich deduplikuje podľa zdieľaného poolu. Kvóty, ktoré sa sprístupnia až po regionálnom overení identity (dnes: ModelScope), sa zobrazujú samostatne, +~6 mil. po regionálnom overení identity, a nikdy sa nezapočítavajú do hlavného údaja. Výsledok zostáva viditeľný na dashboarde (`/dashboard/free-tiers`).

Karta rozpočtu bezplatných úrovní OmniRoute: ~1,62 mld. bezplatných tokenov mesačne stabilne, až ~2,22 mld. v prvom mesiaci s registračnými kreditmi, z 34 zdokumentovaných opakujúcich sa kľúčov poolov pokrývajúcich 465 evidovaných položiek bezplatných úrovní za jedným endpointom. Poctivý výpočet s deduplikáciou poolov — každý zdieľaný pool sa započítava raz vrátane 17 opakujúcich sa poolov s publikovaným kladným mesačným rozpočtom tokenov plus piatich limitov Groq pre jednotlivé modely; 12 poskytovateľov je v katalógu rizík podmienok označených ako poskytovatelia, ktorým sa treba vyhnúť, takže rozhodnutie je na vás. Lišta rozpočtu zahŕňa Mistral 1 mld., Nara 210 mil., LLM7 150 mil., xKiro 150 mil., Groq 30 mil. (päť limitov pre jednotlivé modely) a menšie pooly, plus registračné kredity za prvý mesiac a poskytovateľov, ktorí sú trvalo bezplatní a nemajú tokenový limit, zobrazených samostatne, aby nikdy nenavyšovali hlavný údaj. Aktuálne využitie/zostávajúce množstvo na /dashboard/free-tiers.

> Animované zhrnutie aktuálnej stránky `/dashboard/free-tiers`. Úplná metodika (deduplikácia poolov, kreditové úrovne, podmienky poskytovateľov): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Údaje sa opätovne kontrolujú každé dva týždne voči aktuálnemu katalógu a **menia sa oboma smermi** — poskytovateľ ukončí bezplatnú úroveň a číslo klesne; pribudne nový a číslo stúpne. Publikujeme to, čo katalóg skutočne vypočítava, nikdy nie zaokrúhlený optimistický scenár.}

⭐ Ak vám OMNIROUTE pomohol ušetriť peniaze a zjednodušiť prácu, označte repozitár hviezdičkou.

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

[![Poradie v histórii hviezdičiek](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) ### 💬 Pridajte sa ku komunite **👋 Sledujte autora — nové služby, vydania a tipy sa dozviete ako prví:** [![Sledujte Diega na 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/) [![Sledujte @diegosouzapw na GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Webová stránka](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Otázky, tipy pre poskytovateľov, plán ďalšieho vývoja a podpora → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portál](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Brána sa naďalej rozrastá

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | ----------------------------------- | :------------------------: | :---------: | :-------------------: | | 🌐 Poskytovatelia | 352 | **358** | 388 | | 🧠 Jedinečné ID chatovacích modelov | 1320 | **1374** | 1491 | | 🖼️ Most modalít | 🆕 obraz + zvuk + video | ✓ | ✓ | | 📡 Bezplatný katalóg Radar | 🆕 s možnosťou prihlásenia | ✓ | ✓ | | ⚖️ Plánovanie s ohľadom na kvóty | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetria kvót | 🆕 naživo | ✓ | ✓ | | 🧰 Bezhlavý režim | — | — | 🆕 `serve --headless` | | 🛤️ Infraštruktúra LTS kanála | — | — | 🆕 kanály vydaní | | 🔎 API na zisťovanie modelov | — | — | 🆕 `/v1/models/query` | **→ [Plán](ROADMAP.md) — po koľajnici k `v3.9.0 LTS`**

## 🧩 Dostupné [![verzia npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM mesačne](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Licencia: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Stiahnutia z Docker Hub](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Stiahnutia Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Začíname	🚀 Rýchly začiatok	📦 Inštalácia	🆓 Pripojenie poskytovateľa
💡 Spoznajte	💥 Prísľub	🤔 Prečo OmniRoute	🏆 Čím vyniká
⚙️ Funkcie	🎯 Kombá	🌐 Poskytovatelia	🔌 CLI a MCP
	🗜️ Kompresia	🖥️ Kde funguje	🔒 Súkromie
👀 Pozrite si	🎬 V akcii	✨ Čo je nové	🤖 Kompatibilné CLI
💚 Podporte	💚 Podpora / Darovanie	💬 Komunita	💖 Sponzori
📦 Projekt	🛠️ Technologický zásobník	📖 Dokumentácia	👥 Prispievatelia

🌐 V 67 jazykoch

## 🆓 Nainštalujte, pripojte poskytovateľa a potom smerujte cez jeden endpoint

Tri kroky: nainštalujte a spustite OmniRoute, pripojte vhodného poskytovateľa pomocou vlastného účtu alebo kľúča API a potom nasmerujte svoj nástroj na localhost:20128/v1 pomocou kľúča API OmniRoute a modelu auto. Smerovanie závisí od dostupných vhodných pripojení a limitov poskytovateľa.

```bash # Po pripojení poskytovateľa skopírujte svoj kľúč OmniRoute z Dashboard → Endpoints: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` potrebuje vhodnú trasu. Nová inštalácia nemusí mať žiadne vhodné ciele bez kľúča a poskytovateľ bez kľúča môže odmietnuť klientov tretích strán. Poskytovatelia označení `tos: avoid`, vrátane Kiro, sú predvolene vylúčení z automatického smerovania; pripojenie účtu toto nastavenie neprepíše. Pred výberom poskytovateľa si pozrite [Sprievodcu bezplatnými úrovňami](docs/getting-started/FREE-TIERS-GUIDE.md).} _{📦 Skripty rýchleho štartu na skopírovanie a vloženie pre **Python, Node.js, PHP a cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Prísľub

# 🤔 Prečo OmniRoute?

Tok požiadavky OmniRoute: vaše IDE alebo CLI (Claude Code, Cursor, Cline…) volá jeden lokálny endpoint (http://localhost:20128/v1); inteligentný smerovač OmniRoute (kompresia RTK + Caveman, 20 stratégií smerovania, ističe, TLS stealth, MCP, A2A, ochranné mechanizmy) môže prepnúť medzi 4 úrovňami poskytovateľov, kým zostáva k dispozícii vhodný funkčný cieľ — Úroveň 1 Predplatné, Úroveň 2 Kľúč API, Úroveň 3 Lacné a Úroveň 4 Bezplatné.

## 🤝 Podporované našimi priateľmi z Open Source

> **Chcete sa pridať ako priateľ Open Source?** Toto sú spoločnosti, ktoré podporujú open source a pomáhajú udržiavať OmniRoute v chode – a my verejne uvádzame, kam ide každý token, ktorý nám dajú. Kontaktujte nás: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Ďakujeme spoločnosti Kimi (Moonshot AI), nášmu zakladajúcemu priateľovi Open Source, za podporu tohto projektu! Kimi je AI laboratórium, ktoré stojí za rodinami modelov K2 a K3 s otvorenou váhou – Kimi K3 poskytuje kontextové okno s 1M tokenmi, natívne videnie a kódovanie na úrovni hraníc za zlomok cien uzavretých modelov a funguje ihneď po vybalení s Claude Code, Codex a každým nástrojom na kódovanie, ktorý OmniRoute poskytuje.

Čo poháňa podpora Kimi: Kredity API Kimi poháňajú potrubie vydania OmniRoute overené AI – fázu overenia zlúčenia poháňanú Kimi K3, ktorá kontroluje každú žiadosť o stiahnutie pred jej odoslaním – plus každodenný vývoj funkcií. Prvotriedna podpora Kimi sa dodáva na oboch koľajniciach: priame Kimi API (kimi-k3) a plán kódovania Kimi Code (OAuth a API kľúč). OmniRoute je tiež prvým brazílskym open-source projektom v programe podpory Kimi. Získajte Kimi API kľúč s 15% extra kreditmi →

Cheaper Inference
_{cheaperinference.com} Ďakujeme spoločnosti Cheaper Inference, priateľovi OmniRoute Open Source, za podporu tohto projektu! Cheaper Inference je cenovo ohodnotená brána, ktorá predáva 42 hraničných modelov – Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok a MiniMax – za jedným koncovým bodom kompatibilným s OpenAI, smerujúc každú požiadavku k najlacnejšiemu oprávnenému poskytovateľovi bez toho, aby kedy účtovala viac ako cenníková cena výrobcu modelu.

Prvotriedna podpora v OmniRoute: Chat Completions, natívny koncový bod /v1/responses, videnie, volanie nástrojov a 3 obrazové modely (grok-imagine, nano-banana-pro, nano-banana-2, dostupné ako cheaperinference/<model>). Získajte API kľúč →

_{Odkazy označené aff=omniroute sú partnerské odkazy. Financujú projekt bez dodatočných nákladov pre vás.}

_{🎟️ Propagácia partnerov — bezplatné kupóny na registráciu od poskytovateľov, ktorých nesponzorujeme (kliknutím rozbalíte)}

_{Táto sekcia je určená len pre referenčné/kupónové kódy. Sponzorované partnerstvá sú uvedené v sekcii 🤝 Podporované našimi priateľmi z Open Source vyššie. OmniRoute nemá žiadne sponzorstvo ani partnerstvo s poskytovateľmi uvedenými tu – ide o verejné kupóny, ktoré môže použiť ktokoľvek.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — partnerská registrácia · $100 bezplatných kreditov pri registrácii (bezplatný server, očakávajte vyššiu latenciu – najlepšie na testovanie, nie na produkciu). Prvotriedna podpora v OmniRoute od v3.8.50: Chat Completions, formát wire kompatibilný s Anthropic a cesta kompatibilná s OpenAI. Dostupné modely zahŕňajú claude-opus-4-8, claude-opus-5, gpt-5.6-sol a ďalšie. Získajte svojich $100 →}

_{⚠️ Partnerský odkaz — OmniRoute nemá žiadne sponzorstvo ani partnerstvo s týmto poskytovateľom.}

_{Poznáte iného poskytovateľa s veľkorysým bezplatným kupónom na registráciu, ktorý prospieva používateľom OmniRoute? Otvorte problém a my ho sem pridáme.}

## 🎯 Kombá — Vlajková funkcia

Animované príklady 18 z 20 stratégií smerovania komb — jedna dlaždica pre každú stratégiu: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. Stratégie cache-optimized a quota-weighted nie sú animované; tabuľka nižšie opisuje všetkých 20.

> **Kombo** je reťazec modelov, medzi ktorými OmniRoute smeruje požiadavky **automaticky**. Ak sa vyčerpá kvóta, poskytovateľ zlyhá alebo prudko stúpnu náklady, kombo môže prejsť na ďalší vhodný a funkčný model. 🛡️ ### ⚡ Bez konfigurácie — jednoducho použite `auto` Nemusíte vytvárať žiadne kombo. Nastavte svoj model na `auto` (alebo niektorý variant) a OmniRoute vytvorí virtuálne kombo z vašich pripojených poskytovateľov, ktoré vyhodnocuje v reálnom čase:

ID modelu	Čo optimalizuje
`auto`	🎯 Vyvážené predvolené nastavenie (LKGP — drží sa vášho posledného úspešného poskytovateľa)
`auto/coding`	🧑💻 Váhy uprednostňujúce kvalitu pri generovaní kódu
`auto/fast`	⚡ Najprv najnižšia latencia
`auto/cheap`	💰 Najprv najnižšia cena za token
`auto/subscription`	🎟️ Iba kvóta predplatného, za ktoré už platíte — pri zlyhaní sa uzavrie a nikdy neprejde na spoplatnenú záložnú možnosť (príručka)
`auto/thrifty`	🪜 Najprv kvóta plánu, potom postupne po jednom stupni k najlacnejším plateným možnostiam — po obnovení plánu sa k nemu vráti (príručka)
`auto/offline`	🔋 Najprv najväčšia rezerva kvóty / limitu požiadaviek
`auto/smart`	🔭 Uprednostnenie kvality + 10 % prieskumu na objavenie lepších modelov
`auto/lkgp`	📌 Explicitné zotrvanie pri poslednom úspešnom poskytovateľovi
`auto/chaos`	🧪 Paralelné rozoslanie panelu modelov (jeden na poskytovateľa, predvolene 5), ktoré vráti jednu odpoveď; jedno volanie nadradenej služby na každý model v paneli, nejde o vkladanie porúch

## ### 🔀 Alebo si vytvorte vlastné — 20 stratégií smerovania Všetkých **20** stratégií — kombinujte ich podľa potreby v jednotlivých krokoch komba:

#	Stratégia	Čo robí
1	`priority`	Usporiadaný zoznam s prvým cieľom — každý sa vyčerpá pred prechodom na ďalší 🥇
2	`fill-first`	Pred prechodom na ďalší cieľ úplne vyčerpá kvótu aktuálneho cieľa
3	`weighted`	Vážený náhodný výber podľa váhy jednotlivých cieľov
4	`round-robin`	Cyklicky prechádza cieľmi v poradí
5	`p2c`	Náhodné vyvažovanie záťaže metódou výberu z dvoch možností
6	`least-used`	Vyberie cieľ s najnižšou aktuálnou záťažou
7	`random`	Rovnomerný náhodný výber (bez duplicít)
8	`strict-random`	Náhodný výber bez odstraňovania opakovaní 🎲
9	`cost-optimized`	Minimalizuje cenu v $ za požiadavku podľa aktuálnych cien v katalógu 💸
10	`headroom`	Vyberie cieľ s najväčšou zostávajúcou kvótou
11	`quota-weighted`	Preskočí účty s vyčerpanou kvótou a potom vyberá v pomere zostávajúcej kvóty ÷ priebežnej záťaže — existujúce konverzácie zostávajú pripnuté ⚖️
12	`reset-window`	Uprednostní cieľ, ktorého okno kvóty sa obnoví najskôr
13	`reset-aware`	Zoraďuje podľa času obnovenia kvóty — najprv krátke okná 📊
14	`context-relay`	Odovzdáva kontext medzi cieľmi pri dlhých konverzáciách 🧠
15	`context-optimized`	Vyberie najvhodnejší cieľ pre aktuálnu veľkosť kontextu
16	`cache-optimized`	Pripne každý opakovane použiteľný prefix promptu k rovnakému účtu — maximalizuje zásahy do vyrovnávacej pamäte promptov 🎯
17	`lkgp`	Posledná známa funkčná cesta — pripne sa k poslednému úspešnému poskytovateľovi a potom použije záložné pravidlá
18	`auto`	Priebežné vyhodnocovanie 16 faktorov naprieč všetkými pripojeniami 🤖
19	`fusion`	Rozošle požiadavku panelu modelov a hodnotiaci model syntetizuje jednu odpoveď 🧬
20	`pipeline`	Reťazí kroky — výstup každého cieľa vstupuje do nasledujúceho 🔗

_{Mechanizmus Auto-Combo hodnotí každého kandidáta podľa **16 faktorov** (stav, kvóta, náklady, latencia, vhodnosť pre úlohu, kvalita, dostupnosť relácie…) — pozrite si [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Odolnosť je zabudovaná (3 nezávislé vrstvy)

Odolnosť OmniRoute — 3 nezávislé samoopravné vrstvy, správna vrstva pre správne zlyhanie. Vrstva 1: istič poskytovateľa (celý poskytovateľ): aktivuje sa iba pri 408/5xx, prahové hodnoty OAuth 8× / API kľúč 12× / lokálny poskytovateľ 2×, po 60s/30s/15s sa prepne na skúšobný stav HALF-OPEN, zotavenie podľa potreby; kým je stav OPEN, kombinácia presmeruje požiadavky na ďalšieho poskytovateľa. Vrstva 2: doba čakania pripojenia (jeden kľúč/účet): základ 5s pre OAuth / 3s pre API kľúč, exponenciálne odkladanie ×2 s ochranou proti nárazovému súbehu požiadaviek, pri 429 sa rešpektuje Retry-After, úspech vymaže celý chybový stav; jeden kľúč v stave čakania sa preskočí, zatiaľ čo ostatné kľúče naďalej obsluhujú požiadavky. Vrstva 3: zablokovanie modelu (jeden model): 429 pre konkrétny model, lokálne 404 alebo zamietnutia režimu zablokujú iba daný model — nikdy nie celé pripojenie. Koncové stavy (zablokovaný, expirovaný, vyčerpané kredity) sú určené na zásah operátora, nie na dočasné čakanie.

_{📖 [Mechanizmus Auto-Combo](docs/routing/AUTO-COMBO.md) · [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Čím sa OmniRoute odlišuje

_{📊 Kompletná metodika a podrobnosti o jednotlivých funkciách v porovnaní s nástrojmi 9router, OpenRouter, CLIProxyAPI a LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Podporte OmniRoute OmniRoute je licencovaný pod licenciou MIT a vyvíjaný otvorene. Ak vám šetrí čas alebo peniaze, tu sú možnosti, ako mu pomôcť zachovať nezávislosť — vyberte si tú, ktorá vám vyhovuje. Sponzorstvo nikdy neovplyvňuje prioritu smerovania; kupuje viditeľnosť, nie poradie.

⭐ Označte repozitár hviezdičkou	Zadarmo — skutočne pomáha viditeľnosti	Označiť OmniRoute hviezdičkou
🐙 GitHub Sponsors	Jednorazovo alebo mesačne · nulový poplatok platforme	github.com/sponsors/diegosouzapw
☕ Ko-fi	Rýchly jednorazový príspevok, darca sa nemusí registrovať	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Malé, neformálne gesto	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Opakovane · neziskovo · open source	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazília)	Okamžite, bez poplatkov	kľúč & QR nižšie
₿ Kryptomeny	BTC · ETH · USDT-TRC20 · USDC-Solana	adresy nižšie

**🇧🇷 PIX** — okamžite, bez poplatkov (Brazília) QR kód OmniRoute PIX

Kľúč (náhodný): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia-e-cola: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Kryptomeny — BTC · ETH · USDT-TRC20 · USDC-Solana (kliknutím rozbalíte)

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

_{⚠️ Každú kryptomenu posielajte iba cez uvedenú sieť — odoslanie cez nesprávnu sieť môže viesť k strate prostriedkov.}

🐛 Našli ste chybu alebo máte spätnú väzbu? Otvorte [diskusiu](https://github.com/diegosouzapw/OmniRoute/discussions).

Poznámky pre vývojárov: Projekt môže počas npm install/postinstall pre pohodlie vývojárov vygenerovať lokálny súbor .env. Tento súbor je zámerne ignorovaný prostredníctvom .gitignore (pozrite si .gitignore) a nikdy nesmie byť commitnutý — ak bol commitnutý omylom, zmeňte všetky odhalené tajné údaje a odstráňte súbor z histórie. Pokyny na správu lokálnych súborov prostredia a tajných údajov nájdete v dokumente docs/DEVELOPER-ENVIRONMENT.md.

## 📡 OmniRoute Radar Hlavným údajom pre bezplatnú úroveň zostáva **~1,62 mld. tokenov/mesiac** z vyššie uvedeného zdokumentovaného katalógu s odstránenými duplicitami medzi fondmi. Dočasné kredity poskytovateľov za registráciu môžu v prvom mesiaci tento objem samostatne zvýšiť na **~2,22 mld.** Radar je voliteľná, podpísaná nadstavba katalógu určená ľuďom, ktorí chcú aktuálnejšie informácie o dostupnosti bezplatných modelov medzi vydaniami OmniRoute; komunitný katalóg aj všetky existujúce bezplatné funkcie zostávajú bezplatné. Podporovatelia môžu získavať živý katalóg a ďalšie možnosti od poskytovateľov. Jeho samostatný, premenlivý strop je **najviac približne 3 mld. tokenov/mesiac** v závislosti od dostupnosti poskytovateľov. Tento strop nie je zárukou: poskytovatelia môžu kedykoľvek zmeniť kvóty, podmienky oprávnenosti, modely alebo regióny. Radar je voliteľný a používa iba požiadavky GET. Klient OmniRoute neodosiela prompty, prenosy, konfiguráciu poskytovateľov, telemetriu používania ani lokálny stav zatvorenia oznámení. Informácie o podmienkach oprávnenosti a aktuálnom katalógu nájdete na stránke **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Čo je nové

> Najnovšie zmeny od **v3.8.20 → v3.8.54**. Kompletná história je v [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ Smerovanie `quota-weighted`** — 20. kombinovaná stratégia vynechá vyčerpané účty a potom vyberá zo zostávajúcich účtov v pomere k zostávajúcej kvóte ÷ záťaži prebiehajúcich požiadaviek, pričom existujúce konverzácie zostávajú pripnuté. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Bezhlavý režim** — `omniroute serve --headless` (alebo `OMNIROUTE_HEADLESS=1`) spustí iba proxy engine `/v1/*`, pričom dashboard a subsystémy určené iba pre dashboard zostanú vypnuté. → [Bezhlavý režim](docs/guides/HEADLESS.md) - **🔎 Objavovanie modelov** — `/v1/models` filtruje podľa schopností, kontextu, typu a textu a `POST /v1/models/query` vracia krátky deterministický zoznam kandidátov s rovnakou viditeľnosťou pre jednotlivé kľúče. → [Referencia API](docs/reference/API_REFERENCE.md) - **🔑 Riadenie smerovania podľa kľúča** — pripnite API kľúč k jednému modelu alebo kombinácii pomocou `forcedModel` a atomicky pridávajte alebo odoberajte modely a kombinácie kľúča (`/api/keys/{id}/access`). → [Referencia API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Jemnejšie ovládanie PII** — výber podľa typu, až 20 overených vlastných vzorov maskovania a počítadlá detekcií podľa typu; samotné maskovanie zostáva voliteľné. → [Ochranné mechanizmy](docs/security/GUARDRAILS.md) - **🌍 67 jazykov** — dashboard, zrkadlá dokumentácie a CLI, pričom `npm run i18n:add-locale` pridá jazyk všade jediným príkazom. → [Sprievodca i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — prichádzajúca delegácia A2A do vašej flotily agentov, schopnosti Conductor na Agent Card a panel dashboardu s hlasovým chatom Faro push-to-talk. → [Server A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptívne prijímanie a ochrana pred preťažením** — náročné chatové požiadavky sa zaradia do frontu namiesto návratu chyby 503, s atomickými posuvnými prenájmami RPM pre každé pripojenie. → [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonické usporiadanie `/v1/models`** — jeden súvislý blok zoskupený podľa poskytovateľa pre každého poskytovateľa (kombinácie sú pripnuté ako prvé), stabilný vo všetkých zdrojoch katalógu. → [Referencia API](docs/reference/API_REFERENCE.md) - **🗜️ Spevnenie kompresie** — predvolene zapnutá ochrana pred nafúknutím, balíky Caveman pre DE / FR / JA + čínštinu (wényán), filtre RTK pre Gradle a .NET. → [Kompresia](docs/compression/COMPRESSION_ENGINES.md) - **💸 Poctivé náklady s paušálnou sadzbou** — poskytovatelia predplatného / coding-planov sa v analytike nákladov zobrazujú ako **$0**; rozpočet, kvóta a smerovanie naďalej používajú odhady. → [Referencia API](docs/reference/API_REFERENCE.md) - **⚖️ Smerovanie Quota-Share** — spravodlivé rozdelenie kvóty zdieľaného účtu medzi združené kľúče, s využitím celej kapacity, takže nečinné časti sa požičiavajú. → [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Nastavenie CLI/agentov jediným príkazom** — 15 registrovaných príkazov `setup-*`; `omniroute run` spúšťa 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podporuje 11 cieľov s interaktívnym výberom poskytovateľa a modelu a obľúbenými položkami podľa kontextu. → [Integrácie CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Vzdialený režim** — ovládajte vzdialený OmniRoute pomocou tokenov s obmedzeným rozsahom (`connect` / `contexts` / `tokens`) + pomocník OAuth `antigravity` pre inštalácie na VPS. → [Vzdialený režim](docs/guides/REMOTE-MODE.md) - **🧭 Inteligentnejšie automatické smerovanie** — kombinácie `auto/:`, **Fusion** (panel modelov + posudzovateľ), smerovanie podľa úlohy, prepísania modelu / režimu / rozpočtu v USD pre jednotlivé požiadavky. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Modulárna kompresia** — 12 kombinovateľných engineov + Compression Studios: LLMLingua-2, dvojúrovňový Ultra, omniglyph, brána vernosti pre jednotlivé kroky, GCF v3.2, editor s presúvaním. → [Kompresia](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparentné dešifrovanie MITM (TPROXY)** — CLI nástroje na zachytávanie, ktoré ignorujú proxy premenné prostredia, s inštalátorom CA pre jednotlivé SNI + úložiska dôveryhodnosti. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetria nákladov všade** — hlavičky nákladov/využitia `X-OmniRoute-*` na každom endpointe, hlavička úspor pri ZÁSAHU vyrovnávacej pamäte, kvóty výdavkov jednotlivých kľúčov v USD. → [Referencia API](docs/reference/API_REFERENCE.md) - **🧠 Pamäť pod vašou kontrolou** — predvolene vypnutá, voliteľná vektorová kvantizácia int8 + typovaný útlm, `x-omniroute-no-memory` pre jednotlivé požiadavky. → [Pamäť](docs/frameworks/MEMORY.md) - **🛡️ Bezpečnosť** — ochrana pred injektážou promptov na každej trase LLM (sada red-team testov), voliteľný ochranný mechanizmus maskovania prihlasovacích údajov (rediguje uniknuté API kľúče/tajomstvá v oboch smeroch), bezplatné webové vyhľadávanie DuckDuckGo ako posledná možnosť a voliteľná prihlasovacia brána OIDC pre dashboard (prihlásenie heslom zostáva vždy dostupné). → [Ochranné mechanizmy](docs/security/GUARDRAILS.md) - **🖼️ Nové endpointy** — `/v1/ocr` (Mistral OCR) a `/v1/audio/translations` (v štýle Whisper) dopĺňajú mediálne rozhranie. → [Referencia API](docs/reference/API_REFERENCE.md) - **🎨 Generovanie obrázkov / videí / zvuku** — jedno API pre médiá: xAI Grok Imagine a video Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind a poskytovatelia reči, ako napríklad ElevenLabs. → [Referencia API](docs/reference/API_REFERENCE.md) - **🌍 Nasadenie a prevádzka** — `basePath` reverzného proxy, automatická detekcia jazyka prehliadača, sledovanie zariadení podľa kľúča, dôvera MITM bez oprávnení root, lokalizácia zh-TW. → [Prostredie](docs/reference/ENVIRONMENT.md) - **🤝 Viac poskytovateľov a agentov** — cloudoví agenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) s prihlásením cez prehliadač + OAuth, plnohodnotná karta Ollama, Claude Opus 5 a Sonnet 5, oficiálne partnerstvo Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… a obnovený **katalóg 388 poskytovateľov**. → [Poskytovatelia](docs/reference/PROVIDER_REFERENCE.md) - **📡 Transparentnosť smerovania** — každá odpoveď obsahuje hlavičku `X-OmniRoute-Decision` s názvom stratégie/poskytovateľa a latenciou, ktoré ju obslúžili; nová kombinovaná stratégia `cache-optimized` + faktor Auto-Combo `cacheAffinity` smerujú opakované požiadavky späť na pripojenie, ktoré obsahuje uložený prefix, a koncový bod iba na čítanie `/v1/auto-combo/{channel}/candidates` sprístupňuje aktuálny fond kandidátov kanála `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Lokálny výkon a infraštruktúra** — lokálny Redis na jedno kliknutie, deployery relayov pre Cloudflare Workers / Deno Deploy, Bifrost a Mux ako spravované vstavané služby. → [Vstavané služby](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Aj toto je súčasťou balenia** — framework doplnkov a marketplace, frameworky zručností Omni/Agent/GitHub, integrácia trezoru Obsidian (22 nástrojov MCP), API Batch a Files kompatibilné s OpenAI, sémantická cache odpovedí, gamifikácia s rebríčkami, zisťovanie agentov ACP (15 vstavaných agentov), plánovaný export logov do BigQuery, paralelné rozosielanie medzi viacerými modelmi `auto/chaos`, mostík pre bota Telegram, správca verzií v aplikácii a rebríčky bezplatných poskytovateľov LMArena-ELO. → [Dokumentácia](docs/README.md)

## 🤖 Kompatibilné CLI a kódovacie agenti > Jedna konfigurácia — `http://localhost:20128/v1` — a **každé** AI IDE alebo CLI beží na bezplatných a nízkonákladových modeloch.

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

＋ funguje aj s · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · akýmkoľvek OpenAI-kompatibilným nástrojom

_{📖 Nastavenie pre každý nástroj zvlášť pre všetkých 39 nástrojov (28 CLI Code's + 11 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plugin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Spustite akýkoľvek podporovaný CLI cez OmniRoute jedným príkazom** — žiadne konfiguračné súbory, prihlasovacie údaje sú vkladané pre každý proces zvlášť, Qwen/Gemini dostanú dočasný izolovaný domov: ```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" # Alebo si vyberte poskytovateľa+model interaktívne a zapíšte vlastnú konfiguráciu nástroja: omniroute configure codex # tiež: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Každý príkaz rešpektuje aktívny vzdialený kontext (`omniroute connect `), `--dry-run` zobrazí presné prostredie/argumenty bez vykonania a `--api-key-env NAME` udrží tajomstvá mimo histórie vášho shellu. → [CLI Integrácie](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 poskytovateľov AI — 153 označených katalógom ako bezplatní

> **388 registrovaných poskytovateľov** v kanonických kolekciách chatu, médií, vyhľadávania, lokálnych, cloud-agentových a systémových kolekciách vrátane **153 s metadátami na objavovanie `hasFree: true`**. Register chatových modelov zahŕňa **239 poskytovateľov / 3 059 jedinečných dvojíc poskytovateľ–model / 1 475 nespracovaných ID modelov**; samostatný katalóg bezplatného rozpočtu obsahuje **471 riadkov pre jednotlivé modely**, **34 opakujúcich sa fondov** a **52 poskytovateľov s opakujúcim sa alebo bezkľúčovým bezplatným využívaním navždy**. Ide zámerne o rôzne menovatele; definície a výpočty deduplikované podľa fondov nájdete v [Referencii poskytovateľov](docs/reference/PROVIDER_REFERENCE.md) a v [Bezplatných úrovniach](docs/reference/FREE_TIERS.md).

### 🏢 Každé významné laboratórium — cez jediný endpoint

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

_{…a ďalších viac než 350 — každá ikona sa načítava naživo z katalógu poskytovateľov dashboardu. 📖 [Referencia poskytovateľov](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Navždy bezplatné — $0, bez karty

OpenCode Zen _{DeepSeek V4, Nemotron 3 Bez limitu tokenov}	Kilo Code _{Automatický router, Tencent Hy3 Navždy zadarmo}	Requesty _{GPT-OSS 120B, Nemotron Navždy zadarmo}	SiliconFlow _{DeepSeek V3.2 / R1 Bezplatná úroveň}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Navždy zadarmo}	Baidu ERNIE _{ERNIE 4.0 Navždy zadarmo}
Qoder AI _{Qwen3-Max, Kimi-K2 Neobmedzene ZADARMO}	Pollinations _{GPT, Llama, Claude Kľúč nie je potrebný}	Cloudflare AI _{Viac ako 50 modelov 10K neurónov denne}	NVIDIA NIM _{GLM, MiniMax ~40 RPM zadarmo}	Cerebras _{GLM 4.7, GPT-OSS Jednorazový kredit 5 $; vyžaduje sa karta}	OpenRouter _{:free models +10 $ → vyššie RPM}

📖 Úplný strojovo čitateľný katalóg → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Kde OmniRoute beží — kdekoľvek

> Rovnaká aplikácia, váš stroj, vaše pravidlá. Od globálnej inštalácie npm po** váš telefón** cez Termux.

Platforma	Inštalovať	Hlavné prvky
📦 npm (globálne)	`npm inštalácia -g omniroute`	Jeden príkaz, ľubovoľný OS
⚡ Bun (globálne)	`bun add -g omniroute`	Rovnaký tarball registra, rýchlejšie inštalácie
🐳 Docker	`dokovací beh … diegosouzapw/omniroute`	Viacoblúkový AMD64 + ARM64
🖥️ Desktop (Electron)	`npm spustiť electron:build`	Natívne okno + systémová lišta — Windows / macOS / Linux
🎩 Panel ponuky (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Dohliada na & automatické aktualizácie servera — macOS
💪 ARM	natívne `arm64`	Raspberry Pi, servery ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Spustí na vašom telefóne , 24/7, no root
📲 PWA	"Pridať na domovskú obrazovku"	Celá obrazovka, offline, inštalovateľné z prehliadača
🧩 OpenCode plugin	`@omniroute/opencode-provider`	OpenCode integrácia
🤖 VS Kód Copilot Chat	inštalácia OmniCopilot rozšírenie	Každý model OmniRoute v natívnom výbere chatu Copilot — stabilný & Insiders
🛠️ Zo zdroja	`npm install && npm run dev`	Hacknite to, prispejte

_{📖 [Docker Sprievodca](docs/guides/DOCKER_GUIDE.md) · [Pracovná plocha](electron/README.md) · [Panel s ponukami](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Novinka: OmniRoute v natívnom Copilot VS zqc

> Žiadny nový bočný panel, žiadny nový chat UI – každý model OmniRoute ponúka, sa zobrazí priamo v**Copilot nástroj na výber modelu chatu, ktorý už používate** . Od VS Code 1.122 fungujú modely poskytovateľov bez prihlásenia GitHub alebo predplatného Copilot – režim agenta, volanie nástrojov a vízia zadarmo. Nainštalujte** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** rozšírenie, nasmerujte ho na váš server OmniRoute (predvolené je `localhost:20128`), potom otvorte Copilot Chat → výber modelu →** Spravovať modely…** →**OmniRoute** . < td zarovnanie ="doľava">VS Kód — stabilný & Insiders < td zarovnanie ="doľava">Cursor, Windsurf, VSCodium, Theia, kódový server Gitpod, Antigravity, Kiro

Store	Link	Funguje s
🧩 VS Kód Trhovisko	Inštalácia →
🔓 Otvorenie registra VSX	Inštalácia →

Z vnútra editora: otvorte** Rozšírenia** zobraziť, vyhľadať** "OmniRoute"** , kliknite** Inštalovať** — funguje rovnako v oboch obchodoch. Zdroj, čísla a publikovaná príručka sú zverejnené na [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Code Copilot Sprievodca rozhovorom](docs/guides/VSCODE-COPILOT.md) – nastavenie, to, čo zobrazuje nástroj na výber, informačný panel na karte, riešenie problémov}

### 🎩 Novinka: OmniRouteTray — vaša brána v paneli s ponukami

> `omniroute serve` je najšťastnejšia, keď je stále zapnutá.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** premení to na aplikáciu s panelom s ponukami pre macOS: spustí server, udrží ho pri živote počas reštartov, aktualizuje ho na svojom mieste a na jedno kliknutie odloží váš rozpočet na token –** žiadne okno terminálu nezostalo otvorené, žiadne `npm install -g omniroute` na stráženie detí.** Postavený s [Tauri v2](https://v2.tauri.app/) (jadro Rust veľkosti chyby zaokrúhľovania), dodáva svoj vlastný podpísaný runtime Node 24 a spravuje inštaláciu OmniRoute vo vlastníctve aplikácie, takže nikdy nebude bojovať s vaším globálnym `node`/`bun`. to** zdieľa vašu existujúcu konfiguráciu a databázu `~/.omniroute/`** — tak to je to isté OmniRoute, čo už beháš, len s klobúkom. 🎩

Čo to robí	Ako
🟢 Dohliada na server	Vytvára `omniroute serve` , prijíma už spustenú inštanciu namiesto jej duplikovania
📊 Živé využitie na prvý pohľad	Lišty kvót poskytovateľa, Claude limity session/weekly s resetovanými odpočítavami, 30-dňový rozpis nákladov
🔄 Zavedenie automatických aktualizácií	Postupná inštalácia, atómová výmena, vrátenie pri zlyhaní — vždy v najnovšom vydaní
🚀 Spustiť pri prihlásení	Voliteľné spustenie pri prihlásení; iba zásobník, žiadna ikona doku
🩺 Lekár & protokoly	Diagnostika jedným kliknutím a prístup k protokolu servera

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Preferujete sťahovanie? Získajte najnovšie .dmg z
Uvoľňuje . Zdroj, problémy a zostava
dokumenty žijú na zoispag/omniroute-tray.

💛 Komunitný projekt od @zoispag — nie je oficiálnym vydaním OmniRoute.}

## 🔒 Súkromné a primárne lokálne

_{📖 [Autorizácia](docs/architecture/AUTHZ_GUIDE.md) · [Ochranné mechanizmy](docs/security/GUARDRAILS.md) · [Súlad s predpismi](docs/security/COMPLIANCE.md)}

## 🔌 Plnohodnotné CLI + A2A a MCP

> Okrem servera je OmniRoute **plnohodnotným ovládacím centrom príkazového riadka** s **viac ako 80 príkazmi** a otvorenými protokolmi agentov, vďaka ktorým ho môže AI agent ovládať **samostatne**. ### ⌨️ Skutočné CLI (nielen `start`) ```bash omniroute # spustí bránu + ovládací panel (port 20128) omniroute chat # interaktívny chatovací klient TUI (lomkové príkazy: /model /combo /skill /memory) omniroute setup # sprievodca prvotným nastavením omniroute doctor # diagnostikuje poskytovateľov, porty a natívne závislosti ``` ### 🛰️ Vzdialený režim — spustite CLI tu a OmniRoute na VPS Máte OmniRoute na serveri? Ovládajte ho zo svojho notebooku pomocou **rovnakého CLI**. Stačí sa raz prihlásiť pomocou prístupového tokenu s obmedzeným rozsahom; každý príkaz sa potom vykoná na vzdialenom serveri. ```bash omniroute connect 192.168.0.15 # heslo → token s obmedzeným rozsahom, uložený ako kontext omniroute models # ← spustí sa na VZDIALENOM serveri omniroute configure codex # ← vyberie vzdialený model a zapíše lokálny profil Codex omniroute tokens create --name ci --scope read # vytvorí užšie obmedzené tokeny pre ďalšie zariadenia omniroute contexts use default # ← prepne späť na lokálny server ``` Tokeny majú rozsahy `read` / `write` / `admin`; trasy spúšťajúce procesy zostávajú dostupné iba cez loopback. _{📖 [Vzdialený režim](docs/guides/REMOTE-MODE.md)}

Animovaná ukážka terminálu s CLI OmniRoute — omniroute providers list, omniroute combo list a omniroute health — cyklicky prechádzajúca 89 príkazmi najvyššej úrovne: 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 …

### 🤝 Pripojte agenta — a ten bude ovládať samotný OmniRoute Sprístupnite OmniRoute cez **MCP**, **A2A**, **REST API**, **webhooky** alebo **vzdialené CLI** — každý schopný agent (alebo váš vlastný kód) získa prístup k celej bráne: smerovaniu, poskytovateľom, kombináciám, vyrovnávacej pamäti, kompresii a pamäti — autonómne. Nižšie uvedené koncové body HTTP sú dostupné na adrese `http://localhost:20128`.

Rozhranie	Koncový bod / príkaz	Použitie
🧰 MCP (stdio)	`omniroute --mcp`	Pripojenie ku Claude Desktop, Cursor alebo ľubovoľnému klientovi MCP
🌊 MCP (HTTP)	`/api/mcp/stream`	Vzdialené MCP — 110 nástrojov, 33 rozsahov (vynucovanie je voliteľné), úplný auditný záznam
📡 MCP (SSE)	`/api/mcp/sse`	Streamovací prenos MCP
🤝 A2A	`/.well-known/agent.json`	Komunikácia medzi agentmi, JSON-RPC 2.0 + SSE, 6 zručností
🌐 REST API	`/v1/*`	Kompatibilné s OpenAI — chat, vnorenia, obrázky, zvuk, OCR
🔔 Webhooky	`/api/webhooks`	Odosielanie udalostí požiadaviek / kvót do služieb Slack, Discord, Telegram alebo na ľubovoľnú URL adresu
🛰️ Vzdialené CLI	`omniroute connect`	Ovládanie vzdialenej inštancie pomocou prístupových tokenov s obmedzeným rozsahom

```bash # Sprístupní Claude Code kompletnú súpravu nástrojov OmniRoute cez MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [Server MCP](docs/frameworks/MCP-SERVER.md) · [Server A2A](docs/frameworks/A2A-SERVER.md) · [Protokoly agentov](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Automaticky ušetrite 15 – 95 % tokenov

### 📖 Ako to funguje — pipeline, architektúra a výpočet úspor

Pipeline kompresie OmniRoute: ilustračná požiadavka klienta s 10 000 tokenmi prechádza cez 12 skladateľných mechanizmov — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra a OmniGlyph — a v zdokumentovanom skladanom príklade môže k poskytovateľovi doraziť s približne 1 080 tokenmi. Štruktúrovaný obsah je chránený ochrannými mechanizmami a kontrolami vernosti pre jednotlivé kroky; explicitne stratové alebo experimentálne režimy môžu transformovať oprávnený obsah.

Predvolene sa používa skladaná kombinácia `RTK → Caveman`. Keď oba mechanizmy pôsobia na rovnaké užitočné zaťaženie nástroja/kontextu, úspory sa násobia: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Bloky kódu, URL, JSON a štruktúrované údaje sú **vždy chránené** mechanizmom zachovania. > **Prečo používať veľa tokenov, keď na to stačí zopár?** Každá požiadavka prechádza pipeline kompresie OmniRoute **transparentne** — bez zmien na strane klienta. Teraz ide o **zásobník 12 skladateľných mechanizmov**, ktoré sa spúšťajú v poradí a kombinujú podľa jednotlivých kombinácií smerovania — pričom vychádzajú z myšlienok projektov [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) a [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Zásobník 12 mechanizmov Mechanizmy sa spúšťajú v poradí pipeline; každý z nich možno nezávisle zapnúť alebo vypnúť a konfigurovať podľa kombinácie:

#	Mechanizmus	Čo robí
1	Session-Dedup	Odstraňuje obsah opakovaný naprieč jednotlivými kolami (adresovaný podľa obsahu, naprieč kolami)
2	CCR	Archivuje veľké bloky za značky načítania, ktoré sa načítajú na požiadanie
3	Lite	Orezávanie prázdnych znakov a obrázkových URL (základ s nízkou latenciou)
4	RTK	Inteligentné filtrovanie výsledkov nástrojov, odstraňovanie duplicít a skracovanie (so znalosťou príkazov)
5	Responses Tool Output	Najprv bezstratová kompresia JSON + ohraničená diagnostická kompresia výstupov shellu/patchov/vyhľadávania/zostavovania (Responses API)
6	Headroom	Bezstratová tabuľková kompakcia polí JSON (~30 %) prostredníctvom pribaleného kodeku GCF
7	Relevance	Extraktívne bodovanie viet podľa poslednej používateľskej požiadavky
8	Caveman	Kompresia prózy založená na pravidlách (~65 – 75 % pri výstupe)
9	Aggressive	Sumarizácia + postupné zastarávanie starých kôl
10	LLMLingua-2	Sémantické prerezávanie pomocou ML cez MobileBERT ONNX — bezpečné pre kód, asynchrónne
11	Ultra	Heuristické prerezávanie tokenov s voliteľnou úrovňou malého modelu (SLM)
12	OmniGlyph	Experimentálne kódovanie kontextu ako obrázka pre nameraný Claude Fable 5 na priamom vedení Anthropic; transformácie GPT 5.6 zostávajú uzavreté pri zlyhaní, kým nebudú k dispozícii potvrdenia od poskytovateľa. Štyri profily kompresie (predvolene agresívny, vyvážený, bezpečný pre kód, passthrough) (najagresívnejší; voliteľný)

Bloky kódu, URL a štruktúrované údaje sa **vždy zachovávajú** s presnosťou na úrovni bajtov. **Predvoľby na jedno kliknutie** kombinujú tieto mechanizmy:

Režim	Úspora	Najvhodnejšie na
🪶 Lite	~15 %	Bezpečné predvolené nastavenie vždy zapnuté
🪨 Standard (Caveman)	~30 %	Každodenné programovanie
⚡ Aggressive	~50 %	Dlhé relácie s množstvom nástrojov
🔥 Ultra	~75 %	Maximálna úspora
🧰 RTK	60 – 90 %	Výstup shellu/testov/zostavovania/git
🔗 Stacked (RTK → Caveman)	78 – 95 %	Kombinované prompty + protokoly nástrojov

**Skutočný príklad — režim Standard:** > **Predtým (69 tokenov):** _„Dôvodom, prečo sa váš komponent React znova vykresľuje, je pravdepodobne vytváranie novej referencie objektu pri každom cykle vykresľovania. Keď odovzdáte vložený objekt ako prop, plytké porovnanie Reactu ho zakaždým považuje za iný objekt, čo spustí opätovné vykreslenie. Odporúčam použiť useMemo na zapamätanie objektu.“_ > > **Potom (19 tokenov):** _„Nová referencia objektu pri každom vykreslení. Vložený objekt ako prop = nová referencia = opätovné vykreslenie. Obaľte ho do useMemo.“_ > > **Rovnaká odpoveď. O 72 % menej tokenov. Bez straty presnosti.** ✅ **Príklad PT-BR — režim [Troglodita](https://github.com/leninejunior/troglodita):** > **Predtým (42 tokenov):** _„Problém je v tom, že komponent sa znova vykresľuje, pretože pri každom cykle vykresľovania sa vytvára nová referencia na objekt. Odporúčal by som použiť useMemo.“_ > > **Potom (12 tokenov):** _„Opätovné vykreslenie: nová referencia pri každom cykle (inline objekt sa vytvára znova). Použiť `useMemo`.“_ > > **Rovnaká odpoveď. Približne o 70 % menej tokenov. Technická presnosť zachovaná.** ✅
### 🎚️ Beyond the engines — štýly výstupu, adaptívny ovládač a riadenie pre jednotlivé požiadavky 12 vyššie uvedených mechanizmov zmenšuje to, čo ide **dnu**. Ďalšie tri vrstvy určujú **ako**, **kedy** a čo ide **von**: - **🪄 Štýly výstupu** _(riadenie osi výstupu)_ — vkladajú deterministické pokyny na formovanie odpovede bezpečné pre cache; možno ich kombinovať, pričom každý má intenzitu `lite` / `full` / `ultra`. Pridanie štýlu predstavuje jednu položku v registri: - **Stručná próza** — odstrániť výplňové slová / členy / váhanie; zachovať technický obsah bez zmien. - **Menej kódu** — YAGNI v štýle „lenivého seniorného vývojára“: najmenšia funkčná zmena, bez nevyžiadaného scaffolding-u. - **Cop (lenivý seniorný vývojár)** — vystúpiť po rebríku YAGNI, opraviť koreňovú príčinu, najmenší funkčný diff. - **Mám ADHD (najprv akcia)** — najprv uviesť ďalšiu akciu, kroky očíslovať, uviesť jeden konkrétny ďalší krok, bez úvodu. - **Stručné CJK (文言)** — ultra stručný štýl klasickej čínštiny (lokalizácia obmedzená na `zh`). - **🎯 Adaptívny rozpočet kontextu** _(ovládač)_ — namiesto jediného prahu tokenov zapnuté/vypnuté postupne aktivuje najlacnejšie mechanizmy s najmenšou stratou, iba do miery potrebnej na **zmestienie sa do kontextového okna modelu**. Politika: `reserve-output` (predvolené, s ohľadom na model) · `percentage` · `absolute`. Režim: `floor` (zaručí zmestenie) · `replace-autotrigger` (víťazí explicitná voľba) · `off` (starší prah). - **🎛️ Kde sa rozhoduje o kompresii** _(priorita, od najvyššej po najnižšiu)_ — hlavička požiadavky `x-omniroute-compression` › prepísanie kombinácie routovania › aktívny pomenovaný profil › adaptívne / automatické spúšťanie › predvolené nastavenie panela › vypnuté. Použitý plán sa vracia v hlavičke odpovede `X-OmniRoute-Compression: ; source=`. Automaticky spúšťajte kompresiu podľa prahu tokenov, zapnite adaptívny ovládač, pripnite pomenovaný profil, nastavte jednorazovú voľbu pre konkrétnu požiadavku alebo priraďte pipeline ku kombinácii routovania — podľa toho, čo najlepšie vyhovuje pracovnej záťaži. Voliteľný offline **eval harness** (`npm run eval:compression`) vyhodnotí vernosť oproti úsporám na pevne určenej kolekcii ešte pred publikovaním zmeny. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Rýchly začiatok

**1) Nainštalujte a spustite** ```bash npm install -g omniroute omniroute ``` > 💡 Zobrazujú sa upozornenia `npm warn ERESOLVE` alebo upozornenia na peer dependencies? [Sú neškodné](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Používate npm 11 alebo novší?** npm môže blokovať skripty životného cyklu balíkov, pokiaľ nie sú povolené. `postinstall` balíka OmniRoute (`node scripts/build/postinstall.mjs`) je potrebný na prípravu natívnych súborov runtime. Pri globálnej inštalácii povoľte balíky uvedené v upozornení npm. Pre súpravu balíkov nahlásenú OmniRoute 3.8.54: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Ak chcete tento zoznam povolených balíkov používať pri budúcich globálnych inštaláciách, nakonfigurujte ho raz a potom inštalujte bežným spôsobom: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Zoznam závislostí sa medzi vydaniami môže meniť; ak npm nahlási iný zoznam, použite názvy balíkov z daného upozornenia. Povolenie balíka umožňuje spustenie jeho inštalačných skriptov. > **Používate Gemini Web alebo iného poskytovateľa založeného na webových cookies?** Balík npm obsahuje > Playwright, ale nie jeho binárny súbor Chromium. Pred prvou požiadavkou na webového poskytovateľa si pozrite > poznámku o [nastavení Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium). Panel nájdete na `http://localhost:20128` · API na `http://localhost:20128/v1`. **2) Pripojte oprávneného poskytovateľa pomocou vlastného účtu** Panel → **Poskytovatelia** → vyberte poskytovateľa, ktorého aktuálne podmienky a kvóta zodpovedajú vášmu prípadu použitia → pridajte jeho kľúč API alebo dokončite proces účtu. Bezplatné tarify môžu vyžadovať registráciu, schválenie alebo spôsob platby. Pozrite si [Sprievodcu bezplatnými tarifami](docs/getting-started/FREE-TIERS-GUIDE.md); dostupnosť bez kľúča nie je zaručená a poskytovatelia označení `tos: avoid` sú predvolene vylúčení z `auto`. **3) Nasmerujte svoj nástroj na programovanie** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Overte, že všetko funguje** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Mali by sa zobraziť vaše pripojené modely. 🎉 To je všetko — začnite programovať a OmniRoute sa za vás postará o automatické smerovanie a záložné riešenia. Ak váš klient nedokáže odosielať vlastné hlavičky, OmniRoute sprístupňuje aj tokenizované aliasy kompatibility: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Používajte ich iba pre klientov, ktorí nedokážu pripojiť `Authorization: Bearer ...`. Autentifikácia prostredníctvom hlavičky zostáva preferovaným režimom.
## 📦 Ďalšie spôsoby inštalácie — Docker, zdrojový kód, 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` sleduje najvyššiu **publikovanú** stabilnú verziu SemVer. Nesleduje vetvu git `main`. Pre GitOps pripnite verziu `:X.Y.Z`. Pozrite si [Kanály vydaní Docker](docs/guides/DOCKER_GUIDE.md#release-channels). Obraz má pevne nastavenú hodnotu **`OMNIROUTE_MEMORY_MB=1024`**. To postačuje pre ovládací panel a nenáročný chat. **Programovacie agenty** (`POST /v1/responses` z Claude Code, Codex, Grok, …) potrebujú oveľa väčšiu haldu V8, inak proces skončí s chybou `FATAL ERROR` pri približne 12 GiB počas dvoch prekrývajúcich sa dlhých kontextov. Veľkosť kontajnera nastavte nad veľkosť haldy (natívne vyrovnávacie pamäte sa nachádzajú mimo V8): | Pracovné zaťaženie | Halda (`-e OMNIROUTE_MEMORY_MB`) | Kontajner (`--memory`) | | -------------------------------- | -------------------------------- | ---------------------- | | Ovládací panel / nenáročný chat | `1024` (predvolené v obraze) | ≥2 g | | Jeden programovací agent | `8192` | ≥10 g | | Dve súbežné dlhé `/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 ``` Úplná tabuľka: [Sprievodca Dockerom — RAM počas behu](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Kanál predbežných vydaní Docker:** `diegosouzapw/omniroute:next` a > `diegosouzapw/omniroute:next-web` sledujú aktuálnu predvolenú vetvu `release/v*`. > Tieto premenlivé značky sú určené iba na testovanie zatiaľ nevydaných opráv a > **nie sú podporované v produkčnom prostredí**. Pozrite si > [Kanály vydaní Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Štandardné `bun install` a globálna inštalácia (`bun install -g omniroute`) sú podporované prostredníctvom detekcie runtime prostredia Bun: - **Vstavaný `bun:sqlite`**: Pri spustení v prostredí Bun používa OmniRoute vstavaný ovládač `bun:sqlite`; v Node.js použije ako náhradné riešenie `better-sqlite3` alebo `sql.js`. - **Automatický výber bundlera Webpack pri vývoji**: Vývojové prostredie (`bun run dev`) automaticky rozpozná Bun a vypne Turbopack v prospech Webpacku, aby sa predišlo nekompatibilite natívnych väzieb V8. Produkčné zostavenia (`bun run build`) sa riadia premennou `OMNIROUTE_USE_TURBOPACK` presne tak ako v Node: predvolene používajú Turbopack; na zostavenie pomocou Webpacku použite `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` ju sprístupňuje ako `--build-arg`). - **Samostatný Dockerfile pre Bun**: Viacfázový `Dockerfile.bun` pre natívne produkčné nasadenia Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Inštalácia a spustenie pomocou Bun bun install bun run dev ``` **🛠️ Zo zdrojového kódu** ```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 # Použitie Nix flakes nix develop npm run dev # Alebo použitie devbox devbox run npm run dev ``` 📖 [Sprievodca Dockerom](docs/guides/DOCKER_GUIDE.md) — profily Compose, Caddy HTTPS, tunely Cloudflare. **🦭 Podman** ```bash # 1. Pripravte dátový adresár pripojený pomocou bind mount mkdir -p data # 2. Iba Linux + lokálny rootless Podman (nikdy nie vzdialený klient Podman Machine): podman unshare chown 1000:1000 ./data # 3. Nastavte informáciu o runtime prostredí, zostavte lokálny obraz Compose a spustite ho echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` V systéme macOS alebo Windows používa Podman vzdialený Podman Machine: vynechajte `podman unshare` a postupujte podľa [pokynov pre dátový adresár špecifických pre danú topológiu](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Sprievodca Podmanom](contrib/podman/README.md) — zostavenia Compose, Podman Machine a nastavenie Quadlet pre Linux/systemd. **⚡ Rýchlejšia / úspornejšia inštalácia (preskočenie natívneho zostavenia)** Natívny engine SQLite (`better-sqlite3`) je **voliteľná** závislosť, takže globálna inštalácia sa nikdy nezablokuje pri kompilácii zo zdrojového kódu: použije vopred zostavený binárny súbor, ak je dostupný pre vašu platformu/Node, a v opačnom prípade transparentne prejde na engine v čistom JS (`node:sqlite` v Node 22+, inak pribalený `sql.js` WASM) — bez potreby nástrojov na zostavenie. Ak chcete úplne preskočiť natívnu inicializáciu po inštalácii (CI, prostredia bez grafického rozhrania alebo pomalé počítače): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 ju tiež preskočí ``` Pre najrýchlejšie inštalácie uprednostnite **pnpm** (úložisko adresované obsahom + pevné odkazy — pozrite vyššie). Pre runtime prostredie bez ovládacieho panela a grafického rozhrania použite profil Docker `base` (vyššie) alebo [sprievodcu Termuxom](docs/guides/TERMUX_GUIDE.md). CLI a webový ovládací panel obsluhuje rovnaký proces na jednom porte, takže v súčasnosti neexistuje samostatný balík iba pre CLI.

# 🎬 OmniRoute v akcii

## 📹 Videonávody

_{Snímka panela z 2026-10-18 · Nespracovaný katalóg: YT 1.352 | TT 334 | IG 290 · Aktuálnosť (dni): YT 5 | TT 48 | IG 49}

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

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

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

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

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

**Kompletné poradie (deduplikované kanonické URL, `v > 0`, najväčší dosah):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Kanonické metriky k 2026-10-18: **1.976 jedinečných videí** · **20.220.289 známych zobrazení** (`v > 0`) · **1.210 kanálov/profilov podľa siete**. Nespracovaný panel obsahuje 1.976 riadkov (YouTube 1.352 = 740 dlhých videí + 612 Shorts · TikTok 334 · Instagram 290); po normalizácii podľa kanonickej URL, ktorá zachováva najvyšší počet pre každé video, nezostali žiadne duplikáty. Zber údajov z YouTube je zmrazený k 2026-10-13 (kvóta API bola vyčerpaná od 14. do 18. 10.) a z TikToku/Instagramu od 2026-09-02 (bez kreditov na zber údajov); 76 videí stále nemá uvedený počet zobrazení. > 🎬 **Vytvorili ste video o OmniRoute?** Otvorte [problém](https://github.com/diegosouzapw/OmniRoute/issues/new) alebo [diskusiu](https://github.com/diegosouzapw/OmniRoute/discussions) s odkazom — zaradíme ho sem.

# 📧 Komunita a pomoc > Všetko na jednom mieste — sledujte správcu, chatujte s komunitou alebo otvorte problém. | Kanál | Kde / ako | | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | 💼 **LinkedIn** — sledujte správcu | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — sledujte vydania a tipy | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 globálna skupina** | [pripojiť sa ku skupine](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazília** | [pripojiť sa ku skupine](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Webová lokalita** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍 Komunita StHub OmniRoute (zdarma)** | [portál StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Zdrojový kód** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Nahlásiť chybu** | [otvoriť hlásenie](https://github.com/diegosouzapw/OmniRoute/issues) — priložte výstup príkazu `npm run system-info` | | 🤝 **Prispieť** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Model vetvenia a vydávania](docs/ops/BRANCHING_MODEL.md) · vyberte si `good first issue` | | 💚 **Podporiť projekt** | [Možnosti podpory ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Technologický zásobník

Vrstva	Technológia
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Jazyk	TypeScript 6.0 — 100 % TypeScript v `src/` a `open-sse/` (v jadre od v2.0 žiadne `any`)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Databáza	better-sqlite3 (SQLite, žurnálovanie WAL) + LowDB (starší JSON) — 147 doménových modulov, 233 migrácií
Pamäť	fulltextové vyhľadávanie SQLite FTS5 + vektorové embeddingy kvantizované na int8, typovaný úpadok
Schémy	Zod 4 — validácia I/O nástrojov MCP + kontrakty API
Protokoly	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streamovanie	Server-Sent Events (SSE) + most WebSocket (`/v1/ws`)
Kompresia	12-strojový reťazec — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentifikácia a bezpečnosť	OAuth 2.0 (PKCE) + JWT + kľúče API + obmedzená autentifikácia MCP · AES-256-GCM v pokoji · DOMPurify
Utajenie	wreq-js — imitácia odtlačkov TLS JA3 / JA4, 3-úrovňový proxy
Odolnosť	istič okruhu, exponenciálne oneskorenie, ochrana pred náporom požiadaviek, automatické kombinované samoopravovanie
Protokolovanie	pino — štruktúrované JSON protokoly s kontextom požiadavky
Testovanie	testovací runner Node.js + Vitest — 60 000+ statických deklarácií testov vo viac než 8 400 sledovaných súboroch s testami (jednotkové, integračné, E2E, bezpečnostné, ekosystémové)
Platformy	Desktop (Electron) · Android (Termux) · PWA (ľubovoľný prehliadač)
CI/CD	GitHub Actions — automatické publikovanie do npm + Docker Hub pri vydaní
Odkazy	Webová lokalita · npm · Docker Hub

## 📖 Dokumentácia

### 📘 Začíname

Dokument	Popis
Používateľská príručka	Poskytovatelia, kombinácie, integrácia s CLI, nasadenie
Príručka nastavenia	Kompletné metódy inštalácie, konfigurácie nástrojov CLI, nastavenie protokolov, ladenie časových limitov
Príručka nástrojov CLI	Nastavenie jednotlivých nástrojov pre Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Vzdialený režim	Ovládanie vzdialeného OmniRoute (VPS) z laptopového CLI pomocou prístupových tokenov s obmedzeným rozsahom
Konfigurácia Claude Code	Nasmerovanie Claude Code na OmniRoute (lokálne/vzdialené) pomocou `launch` + profilov pre jednotlivé modely
Rýchly štart	Inštalácia → pripojenie → konfigurácia v 3 krokoch

### 🔧 Prevádzka a nasadenie

Dokument	Popis
Príručka Docker	Spustenie Docker, profily Compose, Caddy HTTPS, tunely, značky obrazov
Príručka Podman	Integrácia Quadlet so systemd, podman-compose, SELinux
Nasadenie na VM	Kompletná príručka: nastavenie VM + nginx + Cloudflare
Nasadenie na Fly.io	Nasadenie na Fly.io s trvalým úložiskom
Príručka Termux	Spustenie OmniRoute v systéme Android pomocou Termux
Príručka PWA	Inštalácia progresívnej webovej aplikácie, ukladanie do vyrovnávacej pamäte, architektúra
Príručka odinštalovania	Čisté odstránenie pre všetky metódy inštalácie
Konfigurácia prostredia	Kompletný prehľad premenných a odkazov `.env`

### 🧠 Funkcie a architektúra

Dokument	Popis
Architektúra	Architektúra systému, tok údajov a interné mechanizmy
Príručka kompresie	Pipeline so 7 možnosťami: off / lite / standard / aggressive / ultra / RTK / stacked
Kompresia RTK	Kompresia výstupu príkazov, filtre, dôveryhodnosť, overovanie, obnova nespracovaného výstupu
Kompresné mechanizmy	Caveman, RTK, pipeline stacked, rozhrania dashboardu/API/MCP
Formát pravidiel kompresie	Schémy balíkov pravidiel JSON pre filtre Caveman a RTK
Jazykové balíky kompresie	Detekcia jazyka a tvorba balíkov pravidiel Caveman
Príručka odolnosti	Ističe, časové odstávky, fronta, ochrana pred náporom požiadaviek, spoofing TLS
Mechanizmus Auto-Combo	Bodovanie podľa 16 faktorov, balíky režimov, samooprava
Príručka proxy	Proxy systém s 3 úrovňami, marketplace 1proxy, CRUD registra
Bezplatné úrovne	Konsolidovaný katalóg: 34 zdokumentovaných opakujúcich sa skupín / 465 katalogizovaných položiek bezplatných úrovní
Galéria funkcií	Prehliadka vizuálneho dashboardu so snímkami obrazovky
Dokumentácia kódu	Prehľad kódovej základne vhodný pre začiatočníkov

### 🤖 Protokoly a API

Dokument	Popis
Referencia API	Všetky endpointy s príkladmi
Špecifikácia OpenAPI	Špecifikácia OpenAPI 3.0
Server MCP	110 nástrojov MCP, konfigurácie IDE, klienti v jazykoch Python/TS/Go
Príručka servera MCP	Inštalácia MCP, prenosy a referencia nástrojov
Server A2A	Protokol JSON-RPC 2.0, schopnosti, streamovanie, správa úloh
Príručka servera A2A	Karta agenta A2A, úlohy, schopnosti a streamovanie

### 📋 Projekt a kvalita

Dokument	Popis
Prispievanie	Nastavenie vývoja a pokyny
Model vetvenia a vydávania	Kam smerujú PR (`release/*`), čo znamenajú `main` a tagy
Zoznam zmien	Úplná história vydaní podľa verzií
Bezpečnostná politika	Nahlasovanie zraniteľností a bezpečnostné postupy
Sprievodca i18n	Podpora 67 jazykov, pracovný postup prekladov, RTL
Kontrolný zoznam vydania	Overovacie kroky pred vydaním
Plán pokrytia	Stratégia pokrytia testami pre viac ako 60 000 statických deklarácií testov v rámci viac ako 8 400 sledovaných testovacích súborov

# ⭐ Najlepší prispievatelia > OmniRoute formuje zanietená open-source komunita. Títo jednotlivci významne prispeli ku kvalite, stabilite a dosahu projektu. **Ďakujeme.** ### Externí prispievatelia podľa zlúčených pull requestov

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

_{Sčítanie vykonané 2026-11-03 03:01:19 UTC s aktuálnym stavom release/v3.8.53 05bc048d6c. Stránkované sčítanie GitHub GraphQL obsahuje 9 947 zlúčených PR: 4 130 od vlastníka repozitára, 240 od Dependabotu, 6 od ostatných botov/aplikácií a 5 571 externých PR od 883 jedinečných prispievateľov. „Zmenené riadky“ predstavujú súčet pridaní + odstránení podľa GitHubu a zahŕňajú generované súbory, lockfile súbory, katalógy, preklady a dokumentáciu; ide o objem zmien, nie o autorské LOC. 53 PR uvádza rozdiely GitHubu s viac ako 500 000 riadkami (napríklad #13399, jediné pridanie poskytovateľa, uvádza 2 347 zmenených súborov), čo nadhodnocuje niekoľko vyššie uvedených súčtov. Pri rovnosti sú prispievatelia zoradení spoločne.} ### Komity pripísané GitHubu

Dizzle _{🥇 418 príspevkov pripísaných službou GitHub}	Bob.Hou _{🥈 294 príspevkov pripísaných službou GitHub}	Paijo _{🥉 229 príspevkov pripísaných službou GitHub}	Paco Cartones _{🏅 222 príspevkov pripísaných službou GitHub}	backryun _{🏅 202 príspevkov pripísaných službou GitHub}	Jan Leon _{🏅 134 príspevkov pripísaných službou GitHub}
Ravi Tharuma _{🏅 126 príspevkov pripísaných službou GitHub}	Markus Hartung _{🏅 115 príspevkov pripísaných službou GitHub}	Randi _{🏅 108 príspevkov pripísaných službou GitHub}	Chris _{🏅 70 príspevkov pripísaných službou GitHub}	WebPerson _{🏅 68 príspevkov pripísaných službou GitHub}	Koosha Paridehpour _{🏅 68 príspevkov pripísaných službou GitHub}

_{Naposledy overené 2026-11-03 02:09:16 UTC: príspevky pripísané službou GitHub, ktoré nahlásilo Contributors API úložiska pre predvolenú vetvu release/v3.8.53. API vrátilo 903 identít (429 používateľov, 2 roboty, 472 anonymných); táto tabuľka vylučuje správcu, roboty a anonymné identity a zachováva remízy v poradí. Líši sa od poradia zlúčených PR uvedeného vyššie aj od sčítania metadát Gitu uvedeného nižšie.} > 🙏 Funkcie, opravy chýb a vylepšenia infraštruktúry týchto prispievateľov sú **neoddeliteľnou súčasťou** toho, vďaka čomu je OmniRoute spoľahlivý a bohatý na funkcie. Každý pull request, každý testovací prípad a každý prekladový súbor i18n má význam. Open source tvoria ľudia ako oni.

---
## 💖 Sponzori

Úprimne ďakujeme ľuďom, ktorí financujú OmniRoute z vlastného vrecka — každý príspevok pomáha udržať projekt bezplatný, nezávislý a v pohybe.

Andrew _{💛 Aktívny mesačný sponzor}	Vlad I _{💛 Aktívny mesačný sponzor}	小妍儿 _{💛 Aktívny mesačný sponzor}	Guilherme Costa _{💛 Aktívny jednorazový sponzor}	Henrique Iurkiv _{💛 Aktívny jednorazový sponzor}	Somesh Ghaturle _{💛 Aktívny jednorazový sponzor}
Kolonie AI _{💛 Bývalý jednorazový podporovateľ}	Prof. Igor Morais _{💛 Bývalý jednorazový podporovateľ}	Pixma _{💛 Bývalý jednorazový podporovateľ}	Paco Cartones _{💛 Bývalý jednorazový podporovateľ}	longtao _{💛 Bývalý jednorazový podporovateľ}

_{… a ďalší, ktorí si želajú zostať v súkromí 💛} _{Verejní sponzori GitHub Sponsors boli opätovne overení 2026-10-18 prostredníctvom GitHub Sponsors GraphQL API: 11 verejných sponzorstiev (6 aktívnych, 5 bývalých) z celkového počtu 14. Stav isActive na GitHube určuje vyššie uvedené označenia aktívnych sponzorov; bývalým verejným jednorazovým podporovateľom naďalej ďakujeme a súkromní sponzori zostávajú anonymní. Dary cez Ko-fi, Buy Me a Coffee, Liberapay, PIX a kryptomeny nie sú uvedené, pretože k nim neexistuje žiadny verejný záznam o sponzorovi.} 💖 Staňte sa sponzorom → — každý dolár pomáha udržať OmniRoute bezplatný a nezávislý.

## 👥 Viac než 1 000 prispievateľov

[![Prispievatelia](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Audit vykonaný 2. 11. 2026 na aktuálnom commite release/v3.8.53 vo vetve 1c7135e0fb (7 972 commitov): 1 074 normalizovaných ľudských identít Git — 759 sa objavuje ako autori commitov (vrátane správcu) a 315 iba v explicitných dodatkoch Co-authored-by. Sčítanie uplatňuje .mailmap, porovnáva e-mailové adresy bez ohľadu na veľkosť písmen, spája numerické a bežné adresy GitHub noreply iba vtedy, keď kódujú rovnaký identifikátor, vylučuje 29 identít botov, agentov, služieb a zástupných identít a nespája bežné e-mailové adresy iba preto, že sa zhodujú ich zobrazované mená. Audit z 24. 8. 2026 uvádzal 639; opätovné spustenie tejto metódy nad základom daného auditu ac02c5b42f dáva 619, takže nárast pochádza od nových prispievateľov, nie z voľnejšej metodiky.} ### Ako prispieť 1. Vytvorte fork repozitára 2. Vytvorte vetvu z **aktívneho** bodu `release/vX.Y.Z` (nie z `main`) — pozrite si [Model vetvenia a vydávania](docs/ops/BRANCHING_MODEL.md) 3. Vytvorte svoju vetvu funkcie (`git checkout -b feat/amazing-feature`) 4. Commitnite zmeny (`git commit -m 'feat: add amazing feature'`) 5. Pushnite vetvu (`git push origin feat/amazing-feature`) 6. Otvorte žiadosť o začlenenie s **cieľovou vetvou = daná vetva** `release/vX.Y.Z` Podrobné pokyny nájdete v [CONTRIBUTING.md](CONTRIBUTING.md). ### Vydanie novej verzie ```bash # Vytvorte vydanie — npm publish sa vykoná automaticky VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Hviezdičky

## 🌍 StarMapper

## 🙏 Poďakovanie

OmniRoute stojí na pleciach gigantov. Začal ako fork projektu **[9router](https://github.com/decolua/9router)** a port projektu v TypeScripte **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** napísaného v Go — a odtiaľ bol každý nižšie uvedený subsystém inšpirovaný open-source projektom, ktorý to zvládol ako prvý. Každý z nich formoval konkrétnu časť OmniRoute. Toto je naše poďakovanie všetkým. 🙏 > ⭐ počty hviezdičiek overené pomocou REST API GitHubu 3. novembra 2026 — choďte týmto projektom dať hviezdičku. Počty predstavujú presnú snímku k danému dátumu a prirodzene sa budú meniť. ### 🧬 Pôvod a brána

Projekt	⭐	Ako inšpiroval OmniRoute
9router	31,861	Pôvodný projekt, na ktorom je tento fork postavený — tu rozšírený o multimodálne API a kompletný prepis do TypeScriptu.
CLIProxyAPI	57,329	Implementácia v Go, ktorá inšpirovala tento port do JavaScriptu / TypeScriptu.
LiteLLM	62,580	AI brána, ktorej verejný dataset cien napája našu synchronizáciu sledovania nákladov a ktorej model normalizácie poskytovateľov ovplyvnil naše smerovanie.
codex-chatgpt-web	15,435	Zdroj pod licenciou MIT upravený do vendored mosta ChatGPT Web → Codex Responses vrátane adaptérov pre reláciu prehliadača, rámcovanie odpovedí, využitie a webové vyhľadávanie.
free-claude-code	65,966	Vzory prenesené do obnovy streamu, aliasov bez premýšľania, záložného webového vyhľadávania, limitov posuvného okna, redakcie logov a spevnených tokov spúšťača.
composer-api	347	Vzory voľby nástrojov Cursor Composer, obmedzení výstupu a potvrdzovania nástrojov prispôsobené natívnemu exekútoru Cursor.
codex-multi-auth	561	Vzory nového prihlásenia a rotácie obnovovacích tokenov prenesené do opätovnej autentifikácie OAuth v Codexe.
opencode-anthropic-auth	562	Predvolené transformácie kompatibilné s Claude Code a správanie fakturačných hlavičiek zovšeobecnené do mosta OmniRoute riadeného konfiguráciou.
grok2api-merged	2	Jeho mapovania modelov Grok, generátor Statsig s falošným TypeError, predvolené požiadavky a zariadenia a procesor odpovedí NDJSON boli významne prispôsobené do exekútora Grok Web v OmniRoute.
TQZHR/grok2api	707	Hlavný tranzitívny zdroj kódu stojaci za grok2api-merged; jeho implementácie modelov, hlavičiek, payloadov, Statsig a procesora sú zachované v línii Grok Web.
chenyme/grok2api	7,874	Základný zdroj pod licenciou MIT pre predvolené hodnoty payloadu a zariadenia Grok, generátor Statsig a procesor `result.response` prenesený cez TQZHR a grok2api-merged.
grok2api-pro	27	Tranzitívny zdroj, ktorému grok2api-merged pripisuje vrstvu proxy poolu; OmniRoute toto upozornenie o pôvode zachováva, ale netvrdí, že do svojho ohraničeného exekútora Grok Web preniesol proxy pool.
GrokProxy	52	Jeho proxy Grok autentifikovaná pomocou cookie a vzor streamovania `result.response.token` ovplyvnili transport Grok Web v OmniRoute.
GrokBridge	5	Jeho návrh HTTP/browserového upstreamu pôvodnej implementácie Grok Web bol konzultovaný; jeho priama HTTP cesta vychádza z GrokProxy, preto sa netvrdí žiadny nezávislý port kódu.

### 🗜️ Kompresia kontextu a tokenov — enginy

Projekt	⭐	Ako inšpiroval OmniRoute
Caveman	116,957	Viralný projekt „prečo používať veľa tokenov, keď stačí pár tokenov“ — jeho filozofia jazyka caveman poháňa náš štandardný režim kompresie a viac než 30 pravidiel na odstraňovanie výplňových slov a kondenzáciu.
RTK – Rust Token Killer	85,350	Vysokovýkonná kompresia výstupu príkazov — inšpirovala náš engine RTK, DSL pre filtrovanie JSON, obnovu nespracovaného výstupu a zreťazený pipeline RTK → Caveman.
headroom	78,672	Reverzibilná kompresia kontextu (SmartCrusher) — inšpirovala náš engine `headroom` a vzor značiek na obnovenie `ccr`.
LLMLingua	6,797	Výskum kompresie promptov (LLMLingua / LLMLingua-2) — inšpiroval náš asynchrónny engine `llmlingua`, bezpečný pre kód a s režimom fail-open.
llmlingua-2-js	33	Port pre JS/ONNX (MobileBERT / XLM-RoBERTa) používaný ako backend vo worker vlákne pre náš engine LLMLingua.
Troglodita	50	Kompresia tokenov pre PT-BR — poháňa náš jazykový balík pt-BR: redukciu pleonazmov a odstraňovanie výplňových slov prispôsobené gramatike brazílskej portugalčiny.
ponytail	182,929	Viralná zručnosť „lenivého seniorného vývojára“ YAGNI-coder — inšpirovala náš štýl výstupu less-code: riadenie najmenšej funkčnej zmeny, ktoré obmedzuje _generovaný_ kód (súrodenec Cavemanovho stručného textu na osi výstupu).
i-have-adhd	59,838	Jeho štýl odpovedí orientovaný na akciu a prispôsobený ľuďom s ADHD bol upravený do stručného štýlu výstupu OmniRoute v piatich jazykoch.

### 🧩 Kompaktné formáty, výskum tokenov a nástroje zohľadňujúce kód

Projekt	⭐	Ako inšpiroval OmniRoute
TOON	25,602	Token-Oriented Object Notation — jeho stĺpcový model s hlavičkou a riadkami ovplyvnil našu fázu tabuľkovej kompakcie.
GCF – Graph Compact Format	61	Jeho kompaktný grafový formát a návrh generického profilu ovplyvnili tabuľkovú kompakciu OmniRoute a formát kodeku Headroom.
gcf-typescript	4	Implementácia v TypeScripte s licenciou MIT, priamo zahrnutá a rozšírená ako kodek generického profilu Headroom.
token-optimizer-mcp	566	Vyrovnávacia pamäť Brotli/SQLite + kontextový rozdiel pre jednotlivé relácie — inšpirovali náš engine `session-dedup`.
token-savior	1,203	Kompakcia výstupu Bashu + profily MCP — inšpirovali našu disciplínu pri ukončení kompresie a redukciu manifestu nástrojov MCP.
token-saver	162	Kompresia výstupu podľa obsahu a typu súboru s ukončením pri zlyhaní — overila naše smerovanie podľa typu a preskočenie pri minimálnom zisku.
token-optimizer	2,853	„Nájdite skryté tokeny“ — jeho vzor odloženia a obnoviteľného identifikátora ovplyvnil naše uvažovanie o odkladaní CCR.
TokenMizer	34	Návrh grafu relácie a deduplikácie riadkov naprieč kolami, ktorý ovplyvnil náš návrh session-dedup.
OmniCompress	3	Stĺpcový JSON v Ruste + načítanie podľa obsahu + deduplikácia naprieč správami — overili návrh našich enginov `headroom`/`ccr`/`session-dedup` a invariant stabilný pre vyrovnávaciu pamäť, podľa ktorého je „komprimovaná forma nezávislá od pozície“.
mcp-compressor	140	Kompresia schém a opisov nástrojov MCP — ovplyvnila našu redukciu kardinality manifestu nástrojov MCP.
RepoMapper	218	Hodnotenie mapy repozitára v štýle Aider — ovplyvnilo naše skúmanie mapy repozitára a hodnotenia načítania.
quiet-shell-mcp	4	Deklaratívna redukcia výstupu shellu cez MCP — overila našu deklaratívnu kompakciu výstupu Bashu.
ts-morph	6,222	Súprava nástrojov pre Compiler API TypeScriptu — inšpirovala naše odstraňovanie komentárov založené na parseri, ktoré zachováva reťazcové, šablónové a regulárne literály.

### 🧠 Pamäť a RAG

Projekt	⭐	Ako inšpiroval OmniRoute
Mem0	68,294	Univerzálna pamäťová vrstva — jej model proxy ako hranice zápisu/čítania formoval našu architektúru pamäte.
Letta (MemGPT)	25,321	Stavové agenty s viacúrovňovou pamäťou — inšpirovali náš viacúrovňový model Context Control & Recovery (CCR).
WFGY	1,804	Taxonómia ProblemMap so 16 opakujúcimi sa režimami zlyhania RAG/LLM — spoločný slovník v našej príručke na riešenie problémov.

### 🛰️ Kontrola prevádzky, MITM a transparentná proxy

Projekt	⭐	Ako inšpiroval OmniRoute
llm-interceptor	81	MITM zachytávanie a analýza prevádzky medzi kódovacím asistentom a LLM ovplyvnili počiatočné požiadavky na Traffic Inspector. Štyri predtým odvodené moduly — zlučovanie SSE, normalizácia konverzácií, maskovanie tajomstiev a sanitizácia hlavičiek — boli nahradené nezávislými implementáciami vytvorenými v čistom prostredí na základe verejných protokolových štandardov. Dve rozhrania na passthrough hostiteľov (`passthrough.ts` a `_internal/bypass.cjs`) zostávajú internými implementáciami OmniRoute, klasifikovanými nezávisle; v rámci tejto náhrady neboli prepísané.
ProxyBridge	6,978	Transparentné smerovanie proxy pre jednotlivé procesy — inšpirovalo naše bezpečné ukončenie MITM po páde, časové limity nečinnosti soketov, priraďovanie procesov pomocou `/proc` a zachytávanie TPROXY.

### 📚 Údaje o modeloch, observabilita a používateľské rozhranie

Projekt	⭐	Ako inšpiroval OmniRoute
models.dev	7,486	Otvorená databáza špecifikácií, cien a schopností modelov AI — natívne synchronizovaná s naším katalógom modelov.
React Flow / xyflow	38,874	Knižnica grafov založených na uzloch, ktorá poháňa naše Compression Studio a Combo/Routing Studio v reálnom čase.
LangGraph	44,349	Živá vizualizácia grafu pracovného postupu v LangGraph Studio inšpirovala zobrazenie kaskády v reálnom čase v našich Studios.
Langfuse	36,907	Jeho model observability trace → span → generation formoval waterfall v našom Compression Studio.
Kiali	3,647	Observabilita servisnej siete Istio — inšpirovala naše odznaky circuit breakera a vizualizácie chybových hrán v Routing/Combo Studio.
lobe-icons	2,666	Logá značiek AI/LLM, ktoré vykresľujú ikony poskytovateľov na našom dashboarde.
flag-icons	12,499	Poskytuje vlajky SVG s licenciou MIT používané výberom jazyka v README.

### 🛡️ Bezpečnosť

Projekt	⭐	Ako inšpiroval OmniRoute
awesome-secure-defaults	723	Kurátorovaný zoznam knižníc s bezpečnými predvolenými nastaveniami, ktorý usmerňuje naše bezpečnostné voľby (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Doplnkové nástroje

Projekt	⭐	Ako inšpiroval OmniRoute
ClawRouter	6,649	Inšpiroval deduplikáciu požiadaviek, núdzový fallback s nulovými nákladmi, zásuvné stratégie Auto-Combo a viacjazyčnú klasifikáciu zámerov.
Antigravity-Manager	32,785	Jeho mapovanie modelov s ohľadom na účty, overovanie ciest k spustiteľným súborom a správanie označení plánu ovplyvnili runtime Antigravity v OmniRoute.
vscode-antigravity-cockpit	4,852	Jeho kompaktný formát odpočítavania do resetovania kvóty inšpiroval príslušné zobrazenie limitu poskytovateľa v OmniRoute.
AionUi	33,996	Jeho integrácie ACP inšpirovali automatickú detekciu nainštalovaných agentov CLI v OmniRoute.
CodexBar	22,955	Identifikoval kvótové rozhranie Grok Build; OmniRoute následne nezávisle overil a opravil aktuálny wire formát.

## 📄 Licencia Licencia MIT – podrobnosti nájdete v [LICENSE](LICENSE). ---

**[⬆ Späť na začiatok](#-omniroute)** · Vytvorené s ❤️ pre komunitu open source AI. _{Vytvoril Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Licencia MIT · omniroute.online}