> **Použite vlastné účty u poskytovateľov.** Ide o odhadovaný súhrn samostatne dostupných bezplatných úrovní tretích strán, nie o balík tokenov 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ľ si určuje vlastné limity, dostupnosť a podmienky.
>
> Ručné kombinovanie bezplatných úrovní je náročné — desiatky SDK, desiatky limitov požiadaviek a žiadna predstava o tom, koľko toho máte skutočne k dispozícii. OmniRoute eviduje **489 položiek bezplatných úrovní v rámci 35 opakujúcich sa kľúčov fondov** a vypočítava celkový počet tokenov zo **17 fondov so zverejneným kladným mesačným rozpočtom a piatich limitov Groq pre jednotlivé modely**, pričom odstraňuje duplicity podľa zdieľaného fondu. Kvóty, ktoré sa sprístupnia až po regionálnom overení identity (aktuálne: ModelScope), sa zobrazujú samostatne ako +~6 mil. za regionálnym overením identity a nikdy sa nezapočítavajú do hlavného údaja. Výsledok zostáva viditeľný na ovládacom paneli (`/dashboard/free-tiers`).
> Animovaný súhrn aktuálnej stránky `/dashboard/free-tiers`. Kompletná metodika (odstraňovanie duplicít fondov, úrovne kreditov, podmienky poskytovateľov): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Tieto údaje sa každé dva týždne opätovne kontrolujú podľa aktuálneho katalógu a **menia sa oboma smermi** — keď poskytovateľ ukončí bezplatnú úroveň, číslo klesne; keď pribudne nová, číslo stúpne. Zverejňujeme to, čo katalóg skutočne vypočíta, nikdy nie zaokrúhlený najlepší možný scenár.
⭐ Ak vám OMNIROUTE pomohol ušetriť peniaze a zjednodušiť prácu, udeľte repozitáru hviezdičku.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Pridajte sa ku komunite
**👋 Sledujte správcu — získajte informácie o nových poskytovateľoch, vydaniach a tipoch ako prví:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Otázky, tipy k poskytovateľom, plán vývoja a podpora → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globálne](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazília](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á
## 🆓 Nainštalujte, pripojte poskytovateľa a potom smerujte cez jeden koncový bod
```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. Čerstvá inštalácia nemusí mať žiadne vhodné bezkľúčové ciele a bezkľúčový poskytovateľ môže odmietnuť klientov tretích strán. Poskytovatelia označení ako `tos: avoid`, vrátane OpenCode Free a 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 pre rýchly štart metódou kopírovať a vložiť pre **Python, Node.js, PHP a cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Prísľub
# 🤔 Prečo OmniRoute?
## 🤝 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.
## 🎯 Kombinácie — vlajková funkcia
> **Kombinácia** je reťazec modelov, medzi ktorými OmniRoute smeruje požiadavky **automaticky**. Ak sa vyčerpá kvóta, poskytovateľ zlyhá alebo prudko vzrastú náklady, kombinácia môže prejsť na ďalší vhodný a funkčný model. 🛡️
### ⚡ Bez konfigurácie — stačí použiť `auto`
Nemusíte vytvárať žiadnu kombináciu. Nastavte model na `auto` (alebo jeho variant) a OmniRoute vytvorí virtuálnu kombináciu z vašich pripojených poskytovateľov, ktorých priebežne vyhodnocuje:
ID modelu
Čo optimalizuje
auto
🎯 Vyvážené predvolené nastavenie (LKGP — zostáva pri vašom poslednom spoľahlivom poskytovateľovi)
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/offline
🔋 Najprv najväčšia rezerva kvóty alebo limitu požiadaviek
auto/smart
🔭 Uprednostnenie kvality + 10 % prieskumu na objavenie lepších modelov
auto/lkgp
📌 Explicitné zotrvanie pri poslednom spoľahlivom poskytovateľovi
auto/chaos
🧪 Paralelné rozoslanie panelu modelov (jeden na poskytovateľa, predvolene 5), ktoré vráti jednu odpoveď; jedno nadradené volanie na každý model v paneli, nejde o vkladanie porúch
##
### 🔀 Alebo si vytvorte vlastnú — 19 stratégií smerovania
Všetkých **19** stratégií — ľubovoľne ich kombinujte v jednotlivých krokoch kombinácie:
#
Stratégia
Čo robí
1
priority
Zoradený zoznam s prvým cieľom — každý sa vyčerpá pred prechodom na ďalší 🥇
2
fill-first
Pred prechodom ďalej úplne vyčerpá kvótu každého 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 stanovenom 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 duplikátov)
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
reset-window
Uprednostní cieľ, ktorého okno kvóty sa obnoví najskôr
12
reset-aware
Zoradí podľa času obnovenia kvóty — kratšie okná ako prvé 📊
13
context-relay
Odovzdáva kontext medzi cieľmi pri dlhých konverzáciách 🧠
14
context-optimized
Vyberie najvhodnejší cieľ pre aktuálnu veľkosť kontextu
15
cache-optimized
Priradí každý opakovane použiteľný prefix promptu k rovnakému účtu — maximalizuje zásahy do vyrovnávacej pamäte promptov 🎯
16
lkgp
Posledná známa funkčná cesta — zostáva pri poslednom úspešnom poskytovateľovi a potom použije záložné pravidlá
17
auto
Priebežné vyhodnocovanie každého pripojenia podľa 16 faktorov 🤖
18
fusion
Rozošle požiadavku panelu modelov a hodnotiaci model syntetizuje jednu odpoveď 🧬
19
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)
📖 [Mechanizmus Auto-Combo](docs/routing/AUTO-COMBO.md) · [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Čím OmniRoute vyniká
📊 Úplná metodika a podrobnosti o jednotlivých funkciách v porovnaní s 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.
⚠️ 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 zaujímavosti od verzie **v3.8.20 → v3.8.50**. Úplnú históriu nájdete v súbore [`CHANGELOG.md`](CHANGELOG.md).
- **🎛️ OmniConductor** — prichádzajúce delegovanie A2A do vašej flotily agentov, zručnosti Conductor na karte agenta a panel ovládacieho panela s hlasovým četom Faro s funkciou push-to-talk. → [Server A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptívne prijímanie a ochrana pred preťažením** — výpočtovo náročné požiadavky na čet sa namiesto odpovede 503 zaradia do frontu, pričom každé pripojenie využíva atomické priebežné prenájmy RPM. → [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonické poradie `/v1/models`** — jeden súvislý blok zoskupený podľa poskytovateľa pre každého poskytovateľa (kombinácie sú pripnuté ako prvé), stabilný naprieč všetkými zdrojmi katalógu. → [Referencia API](docs/reference/API_REFERENCE.md)
- **🗜️ Posilnenie 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)
- **💸 Pravdivé náklady pri paušálnych sadzbách** — poskytovatelia s predplatným alebo programátorským plánom vykazujú v analýze nákladov **$0**; rozpočet, kvóty 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 so zachovaním využitia kapacity, takže nevyužité podiely sa požičiavajú ostatným. → [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Nastavenie CLI/agentov jedným príkazom** — 13 registrovaných príkazov `setup-*`; `omniroute run` spúšťa 7 rozhraní CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podporuje 10 cieľov s interaktívnym výberom poskytovateľa a modelu a obľúbenými položkami pre jednotlivé kontexty. → [Integrácie CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Vzdialený režim** — ovládajte vzdialenú inštanciu OmniRoute pomocou tokenov s obmedzeným rozsahom (`connect` / `contexts` / `tokens`) a pomocníka 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 + rozhodca), smerovanie zohľadňujúce úlohu a prepísanie modelu, režimu alebo rozpočtu v USD pre jednotlivé požiadavky. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Rozšíriteľná kompresia** — 12 kombinovateľných enginov + Compression Studios: LLMLingua-2, dvojúrovňové Ultra, omniglyph, kontrola vernosti pre každý krok, GCF v3.2 a editor s meniteľným poradím pomocou presúvania. → [Kompresia](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transparentné dešifrovanie MITM (TPROXY)** — zachytávanie rozhraní CLI, ktoré ignorujú premenné prostredia proxy, s certifikačnou autoritou pre jednotlivé SNI a inštalátorom úložiska dôveryhodných certifikátov. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Telemetria nákladov všade** — hlavičky nákladov a využitia `X-OmniRoute-*` na každom koncovom bode, hlavička úspor pri zásahu do vyrovnávacej pamäte a kvóty výdavkov v USD pre jednotlivé kľúče. → [Referencia API](docs/reference/API_REFERENCE.md)
- **🧠 Pamäť pod vašou kontrolou** — predvolene vypnutá, voliteľná kvantizácia vektorov int8 + typovaný útlm, `x-omniroute-no-memory` pre jednotlivé požiadavky. → [Pamäť](docs/frameworks/MEMORY.md)
- **🛡️ Zabezpečenie** — ochrana pred prompt injection na každej trase LLM (súprava red-team testov), voliteľná ochrana maskujúca prihlasovacie údaje (rediguje uniknuté API kľúče a tajné údaje v oboch smeroch), bezplatné webové vyhľadávanie cez DuckDuckGo ako posledná možnosť a voliteľná prihlasovacia brána OIDC pre ovládací panel (prihlásenie heslom zostáva vždy dostupné). → [Ochranné mechanizmy](docs/security/GUARDRAILS.md)
- **🖼️ Nové koncové body** — `/v1/ocr` (Mistral OCR) a `/v1/audio/translations` (v štýle Whisper) dopĺňajú podporu médií. → [Referencia API](docs/reference/API_REFERENCE.md)
- **🎨 Generovanie obrázkov, videa a zvuku** — jedno API pre médiá: xAI Grok Imagine a video od Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind a poskytovatelia reči, ako je ElevenLabs. → [Referencia API](docs/reference/API_REFERENCE.md)
- **🌍 Nasadenie a prevádzka** — `basePath` reverzného proxy, automatická detekcia jazyka prehliadača, sledovanie zariadení pre jednotlivé kľúče, dôveryhodnosť MITM bez oprávnení root a lokalizácia zh-TW. → [Prostredie](docs/reference/ENVIRONMENT.md)
- **🤝 Ďalší poskytovatelia a agenti** — cloudoví agenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) s prehliadačom a prihlásením OAuth, plnohodnotná karta Ollama, Claude Opus 5 a Sonnet 5, oficiálne partnerstvo s Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… a aktualizovaný **katalóg 352 poskytovateľov**. → [Poskytovatelia](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Transparentnosť smerovania** — každá odpoveď obsahuje hlavičku `X-OmniRoute-Decision`, ktorá uvádza stratégiu, poskytovateľa a latenciu použitú na jej obsluhu; nová kombinovaná stratégia `cache-optimized` a faktor Auto-Combo `cacheAffinity` smerujú opakované požiadavky späť na pripojenie s uloženým prefixom vo vyrovnávacej pamäti a koncový bod iba na čítanie `/v1/auto-combo/{channel}/candidates` sprístupňuje aktuálnu množinu 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, nástroje na nasadenie relay pre Cloudflare Workers / Deno Deploy, Bifrost a Mux ako dohliadané vstavané služby. → [Vstavané služby](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Súčasťou balíka je aj** — framework doplnkov + marketplace, frameworky zručností Omni/Agent/GitHub, integrácia trezoru Obsidian (22 nástrojov MCP), rozhrania API Batch a Files kompatibilné s OpenAI, sémantická vyrovnávacia pamäť odpovedí, gamifikácia s rebríčkami, vyhľadávanie agentov ACP (15 vstavaných agentov), plánovaný export denníkov do BigQuery, paralelné rozdelenie medzi viacero modelov `auto/chaos`, premostenie s botom Telegram, správca verzií priamo v aplikácii a rebríčky bezplatných poskytovateľov LMArena-ELO. → [Dokumentácia](docs/README.md)
## 🤖 Kompatibilné CLI a programovacie agenty
> Jedna konfigurácia — `http://localhost:20128/v1` — a **každé** AI IDE alebo CLI funguje s bezplatnými a nízkonákladovými modelmi.
＋ funguje aj s · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · akýmkoľvek nástrojom kompatibilným s OpenAI
📖 Nastavenie jednotlivých nástrojov pre všetkých 36 nástrojov (26 CLI Code + 10 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Spustite ľubovoľné podporované CLI cez OmniRoute jediným príkazom** — bez zapisovania konfiguračných súborov,
prihlasovacie údaje sa vložia pre každý proces a Qwen/Gemini dostanú dočasný izolovaný domovský adresár:
```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 interaktívne vyberte poskytovateľa a model a zapíšte vlastnú konfiguráciu nástroja:
omniroute configure codex # tiež: claude opencode qwen aider goose gemini cline continue kilo
```
Každý príkaz rešpektuje aktívny vzdialený kontext (`omniroute connect `), `--dry-run`
zobrazí presný náhľad premenných prostredia a argumentov bez vykonania a `--api-key-env NAME` zabráni uloženiu tajných údajov
do histórie shellu. → [Integrácie CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 poskytovateľov AI — 154 označených v katalógu ako bezplatní
> **372 registrovaných poskytovateľov** v rámci kanonických kolekcií četu, médií, vyhľadávania, lokálnych služieb, cloudových agentov a systémov, pričom **154 z nich obsahuje vyhľadávacie metadáta `hasFree: true`**. Register četových modelov zahŕňa **237 poskytovateľov / 3 009 jedinečných dvojíc poskytovateľ–model / 1 443 pôvodných ID modelov**; samostatný katalóg bezplatných kvót obsahuje **491 riadkov pre jednotlivé modely**, **35 obnovovaných fondov** a **54 poskytovateľov s obnovovanou alebo trvalo bezplatnou ponukou bez potreby kľúča**. Tieto menovatele sa zámerne líšia; definície a výpočty s deduplikáciou fondov nájdete v dokumentoch [Referenčné informácie o poskytovateľoch](docs/reference/PROVIDER_REFERENCE.md) a [Bezplatné úrovne](docs/reference/FREE_TIERS.md).
### 🏢 Všetky významné laboratóriá — prostredníctvom jedného koncového bodu
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…a viac než 330 ďalších — každá ikona sa načítava priamo z katalógu poskytovateľov na ovládacom paneli. 📖 [Referenčné informácie o poskytovateľoch](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Navždy zadarmo — $0, bez karty
OpenCode Zen DeepSeek V4, Nemotron 3 Bez obmedzenia 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 Nie je potrebný kľúč
Cloudflare AI Viac než 50 modelov 10 000 neurónov/deň
NVIDIA NIM GLM, MiniMax ~40 RPM zadarmo
Cerebras GLM 4.7, GPT-OSS Jednorazový kredit $5; vyžaduje sa karta
> Rovnaká aplikácia, váš počítač, vaše pravidlá. Od globálnej inštalácie cez npm až po **váš telefón** prostredníctvom Termuxu.
Platforma
Inštalácia
Hlavné výhody
📦 npm (globálne)
npm install -g omniroute
Jeden príkaz, ľubovoľný OS
🐳 Docker
docker run … diegosouzapw/omniroute
Viacero architektúr: AMD64 + ARM64
🖥️ Desktop (Electron)
npm run electron:build
Natívne okno + systémová lišta — Windows / macOS / Linux
🎩 Panel ponuky (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
Dohliada na server a automaticky ho aktualizuje — macOS
💪 ARM
natívne arm64
Raspberry Pi, servery ARM, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
Beží vo vašom telefóne, nepretržite, bez prístupu root
📲 PWA
„Pridať na plochu“
Na celú obrazovku, offline, inštalovateľné z prehliadača
🧩 Doplnok OpenCode
@omniroute/opencode-provider
Natívna integrácia s OpenCode
🤖 VS Code Copilot Chat
nainštalujte rozšírenie OmniCopilot
Každý model OmniRoute v natívnom výbere modelov Copilot Chat — stabilná verzia aj Insiders
🛠️ Zo zdrojového kódu
npm install && npm run dev
Upravujte ho a prispievajte
📖 [Príručka pre Docker](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Ikona na paneli ponuky](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 priamo v natívnom Copilot Chat vo VS Code
> Žiadny nový bočný panel ani nové používateľské rozhranie chatu — každý model poskytovaný službou OmniRoute sa zobrazí priamo vo
> **výbere modelov Copilot Chat, ktorý už používate**. Od verzie VS Code 1.122 fungujú modely poskytovateľov
> bez prihlásenia do GitHubu alebo predplatného Copilot — režim agenta, volanie nástrojov aj obrazové funkcie,
> úplne zadarmo.
Nainštalujte rozšírenie **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, nasmerujte ho
na svoj server OmniRoute (predvolene `localhost:20128`) a potom otvorte Copilot Chat → výber modelu
→ **Spravovať modely…** → **OmniRoute**.
V editore otvorte zobrazenie **Rozšírenia**, vyhľadajte **„OmniRoute“** a kliknite na **Inštalovať**
— v oboch obchodoch to funguje rovnako. Zdrojový kód, hlásenia problémov a postup publikovania nájdete na
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [Príručka pre VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — nastavenie, obsah výberu modelov, ovládací panel na karte, riešenie problémov
### 🎩 Novinka: OmniRouteTray — vaša brána priamo v paneli ponuky
> `omniroute serve` funguje najlepšie, keď je stále spustený. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> z neho pre macOS vytvorí bezúdržbovú aplikáciu v paneli ponuky: spúšťa server, udržiava ho v prevádzke
> aj po reštartoch, priebežne ho aktualizuje a poskytuje váš aktuálny limit tokenov jediným kliknutím — **bez
> otvoreného okna terminálu a bez nutnosti dohliadať na `npm install -g omniroute`.**
Je vytvorený pomocou [Tauri v2](https://v2.tauri.app/) (jadro v jazyku Rust, ktorého veľkosť je prakticky zanedbateľná), dodáva sa
s vlastným podpísaným runtime Node 24 a spravuje vlastnú inštaláciu OmniRoute, takže nikdy nebude v konflikte s vaším
globálnym `node`/`bun`. **Zdieľa vašu existujúcu konfiguráciu a databázu v `~/.omniroute/`** — ide teda o
ten istý OmniRoute, ktorý už používate, iba s klobúkom. 🎩
Čo robí
Ako
🟢 Dohliada na server
Spustí omniroute serve a namiesto vytvorenia duplicity prevezme už spustenú inštanciu
📊 Aktuálne využitie na prvý pohľad
Ukazovatele kvót poskytovateľov, limity relácie a týždenné limity Claude s odpočítavaním do obnovenia, prehľad nákladov za 30 dní
🔄 Automaticky sa aktualizuje na mieste
Fázovaná inštalácia, atomická výmena, návrat pri zlyhaní — vždy na najnovšom vydaní
🚀 Spustenie po prihlásení
Voliteľné spustenie po prihlásení; iba na paneli ponuky, bez ikony v Docku
🩺 Diagnostika a protokoly
Diagnostika jedným kliknutím a prístup k protokolom servera
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Uprednostňujete stiahnutie? Získajte najnovší súbor .dmg zo stránky
Vydania. Zdrojový kód, hlásenia problémov a dokumentácia k zostaveniu
sú k dispozícii v repozitári zoispag/omniroute-tray.
💛 Komunitný projekt od @zoispag — nejde o oficiálne vydanie 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 pre príkazový riadok** s **viac než 80 príkazmi** a otvorenými protokolmi pre agentov, vďaka ktorým ho môže agent AI ovládať **samostatne**.
### ⌨️ Skutočné CLI (nielen `start`)
```bash
omniroute # spustí bránu a 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 z notebooku pomocou **rovnakého CLI**. Stačí sa raz prihlásiť
pomocou prístupového tokenu s obmedzeným rozsahom a každý ďalší príkaz bude smerovať na vzdialený server.
```bash
omniroute connect 192.168.0.15 # heslo → token s obmedzeným rozsahom, uložený ako kontext
omniroute models list # ← 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 iné počítače
omniroute contexts use default # ← prepne späť na lokálny server
```
Tokeny majú rozsah `read` / `write` / `admin`; trasy spúšťajúce procesy zostávajú dostupné iba cez lokálne rozhranie.
📖 [Vzdialený režim](docs/guides/REMOTE-MODE.md)
### 🤝 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 aj pamäti — autonómne. Nižšie uvedené HTTP endpointy sú dostupné pod adresou `http://localhost:20128`.
Rozhranie
Endpoint/príkaz
Použitie
🧰 MCP (stdio)
omniroute --mcp
Pripojenie ku Claude Desktop, Cursor alebo ľubovoľnému klientovi MCP
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
# Poskytne Claude Code úplnú 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)
## 🗜️ Ušetrite 15–95 % tokenov — automaticky
### 📖 Ako to funguje — pipeline, architektúra a výpočet úspor
Predvolená kombinácia spúšťa `RTK → Caveman`. Keď oba mechanizmy spracúvajú rovnaký obsah nástroja alebo 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, adresy URL, JSON a štruktúrované údaje sú mechanizmom zachovania **vždy chránené**.
> **Prečo používať veľa tokenov, keď postačí málo?** Každá požiadavka prechádza kompresným pipeline OmniRoute **transparentne** — bez zmien na strane klienta. Teraz ide o **súbor 12 kombinovateľných mechanizmov**, ktoré sa spúšťajú v danom poradí a možno ich ľubovoľne kombinovať pre každú smerovaciu kombináciu — na základe myšlienok z projektov [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ viac ako 90 tis.), [LLMLingua-2](https://github.com/microsoft/LLMLingua) a [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 Systém 12 mechanizmov
Mechanizmy sa spúšťajú v poradí pipeline; každý možno nezávisle zapnúť či vypnúť a nakonfigurovať pre jednotlivé kombinácie:
#
Mechanizmus
Čo robí
1
Session-Dedup
Odstraňuje obsah opakujúci sa medzi jednotlivými výmenami (adresovaný podľa obsahu, naprieč výmenami)
2
CCR
Archivuje veľké bloky za značkami načítania, ktoré sa načítajú na požiadanie
3
Lite
Orezávanie medzier a adries URL obrázkov (základný režim s nízkou latenciou)
4
RTK
Inteligentné filtrovanie, deduplikácia a skracovanie výsledkov nástrojov (so zohľadnením príkazov)
5
Responses Tool Output
Primárne bezstratový JSON a obmedzená diagnostická kompresia výstupov shellu, záplat, vyhľadávania a zostavenia (Responses API)
Extrakčné hodnotenie viet vzhľadom na poslednú požiadavku používateľa
8
Caveman
Kompresia prózy založená na pravidlách (~65–75 % na výstupe)
9
Aggressive
Sumarizácia a postupné skracovanie starých výmen
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 vrstvou malého modelu (SLM)
12
OmniGlyph
Experimentálne kódovanie kontextu vo forme obrázka pre meraný Claude Fable 5 pri priamom spojení so službou Anthropic; transformátory GPT 5.6 zostávajú uzavreté pri zlyhaní, kým poskytovateľ neposkytne potvrdenia. Štyri profily kompresie (predvolený agresívny, vyvážený, bezpečný pre kód, bez úprav) (najagresívnejší; vyžaduje explicitné zapnutie)
Bloky kódu, adresy URL a štruktúrované údaje sa **vždy zachovávajú** presne na úrovni bajtov. Mechanizmy kombinujú **predvoľby na jedno kliknutie**:
Režim
Úspora
Najvhodnejšie použitie
🪶 Lite
~15 %
Bezpečný predvolený režim na nepretržité používanie
🪨 Standard (Caveman)
~30 %
Každodenné programovanie
⚡ Aggressive
~50 %
Dlhé relácie s intenzívnym používaním nástrojov
🔥 Ultra
~75 %
Maximálna úspora
🧰 RTK
60–90 %
Výstup shellu, testov, zostavenia a systému git
🔗 Stacked (RTK → Caveman)
78–95 %
Kombinované prompty a protokoly nástrojov
**Skutočný príklad — režim Standard:**
> **Predtým (69 tokenov):** _„Dôvodom, prečo sa váš komponent React opakovane vykresľuje, je pravdepodobne to, že pri každom cykle vykreslenia vytvárate nový odkaz na objekt. Keď odovzdáte vnorený objekt ako prop, plytké porovnanie v Reacte ho zakaždým vyhodnotí ako iný objekt, čo spustí opätovné vykreslenie. Odporúčam použiť useMemo na memoizáciu objektu.“_
>
> **Potom (19 tokenov):** _„Pri každom vykreslení nový odkaz na objekt. Vnorený objekt prop = nový odkaz = opätovné vykreslenie. Použite useMemo.“_
>
> **Rovnaká odpoveď. O 72 % menej tokenov. Bez straty presnosti.** ✅
**Príklad v PT-BR — režim [Troglodita](https://github.com/leninejunior/troglodita):**
> **Predtým (42 tokenov):** _„Problém spočíva v tom, že komponent sa opätovne vykresľuje, pretože sa v každom cykle vykresľovania vytvára nová referencia na objekt. Odporúčal by som použiť useMemo.“_
>
> **Potom (12 tokenov):** _„Opätovné vykreslenie: nová referencia v každom cykle (inline objekt sa vytvára znova). Použiť `useMemo`.“_
>
> **Rovnaká odpoveď. O ~70 % menej tokenov. Technická presnosť zachovaná.** ✅
### 🎚️ Viac než len enginy — štýly výstupu, adaptívny ovládač a riadenie pre jednotlivé požiadavky
Vyššie uvedených 12 enginov 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é inštrukcie na formovanie odpovede, ktoré sú bezpečné pre vyrovnávaciu pamäť; možno ich kombinovať, každý s intenzitou `lite` / `full` / `ultra`. Pridanie štýlu je jednoriadkový záznam v registri:
- **Stručná próza** — vynechá vatu / členy / neisté formulácie; zachová presný technický obsah.
- **Menej kódu** — YAGNI v štýle „lenivého seniorného vývojára“: najmenšia funkčná zmena, žiadna nevyžiadaná infraštruktúra.
- **Ponytail (lenivý seniorný vývojár)** — postupuje po rebríku YAGNI, opraví hlavnú príčinu, vytvorí najmenší funkčný rozdiel.
- **Mám ADHD (najprv akcia)** — začína nasledujúcou akciou, kroky sú číslované, jeden konkrétny ďalší krok, bez úvodu.
- **Stručná CJK (文言)** — ultr stručný štýl klasickej čínštiny (obmedzený na miestne nastavenie `zh`).
- **🎯 Adaptívny rozpočet kontextu** _(ovládač)_ — namiesto jednej zapnutej/vypnutej prahovej hodnoty tokenov aktivuje najlacnejšie enginy s najmenšou stratou iba do takej miery, aká je potrebná, aby sa obsah **zmestil do kontextového okna modelu**. Zásady: `reserve-output` (predvolené, s ohľadom na model) · `percentage` · `absolute`. Režim: `floor` (zaručí, že sa obsah zmestí) · `replace-autotrigger` (vaša explicitná voľba má prednosť) · `off` (staršia prahová hodnota).
- **🎛️ Kde sa rozhoduje o kompresii** _(priorita, vysoká → nízka)_ — hlavička `x-omniroute-compression` pre konkrétnu požiadavku › prepísanie kombinácie smerovania › aktívny pomenovaný profil › adaptívne / automatické spustenie › predvolené nastavenie panela › vypnuté. Použitý plán sa odošle späť v hlavičke odpovede `X-OmniRoute-Compression: ; source=`.
Nastavte automatické spustenie podľa prahovej hodnoty 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 smerovania — podľa toho, čo vyhovuje pracovnému zaťaženiu. Voliteľný offline **evaluačný nástroj** (`npm run eval:compression`) pred nasadením zmeny vyhodnotí vernosť oproti úspore na pevne stanovenej množine dát.
📖 [`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 štart
**1) Inštalácia a spustenie**
```bash
npm install -g omniroute
omniroute
```
> 💡 Zobrazuje sa `npm warn ERESOLVE` alebo upozornenia na závislosti typu peer? [Sú neškodné](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Používate npm 11 alebo novšiu verziu?** npm môže blokovať skripty životného cyklu balíka, pokiaľ nie sú povolené. `postinstall` balíka OmniRoute (`node scripts/build/postinstall.mjs`) je potrebný na prípravu jeho natívnych runtime súborov. Pri globálnej inštalácii povoľte balíky uvedené v upozornení npm. Pre množinu balíkov hlásenú verziou OmniRoute 3.8.51:
>
> ```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 opätovne použiť 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 môže medzi vydaniami meniť; ak npm nahlási iný zoznam, použite názvy balíkov z daného upozornenia. Povolenie balíka umožní spustenie jeho inštalačných skriptov.
> **Používate Gemini Web alebo iného poskytovateľa využívajúceho webové cookies?** Balík npm obsahuje
> Playwright, ale nie jeho binárny súbor Chromium. Pred odoslaním prvej požiadavky webovému poskytovateľovi si pozrite
> poznámku o [nastavení Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium).
Ovládací panel je na adrese `http://localhost:20128` · API je na adrese `http://localhost:20128/v1`.
**2) Pripojte podporovaného poskytovateľa pomocou vlastného účtu**
Ovládací panel → **Poskytovatelia** → vyberte poskytovateľa, ktorého aktuálne podmienky a kvóta vyhovujú vášmu prípadu použitia → pridajte jeho kľúč API alebo dokončite postup pripojenia účtu. Bezplatné úrovne môžu vyžadovať registráciu, schválenie alebo platobnú metódu. Prečítajte si [Sprievodcu bezplatnými úrovňami](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 režimu `auto`.
**3) Nastavte svoj programovací nástroj**
```txt
Základná URL: http://localhost:20128/v1
Kľúč API: [skopírujte z Ovládací panel → Koncové body]
Model: auto (smeruje medzi podporovanými pripojeniami — alebo vyberte poskytovateľa/model)
```
**4) Overte funkčnosť**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Mali by sa zobraziť pripojené modely. 🎉 To je všetko — začnite programovať a OmniRoute bude požiadavky automaticky smerovať a v prípade potreby prepínať na záložné možnosti.
Ak váš klient nedokáže odosielať vlastné hlavičky, OmniRoute sprístupňuje aj tokenizované aliasy kompatibility:
```txt
Katalóg OpenAI: http://localhost:20128/vscode/YOUR_KEY/
Modely OpenAI: http://localhost:20128/vscode/YOUR_KEY/models
Chat OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions
Odpovede OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses
Chat Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat
Značky Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Používajte ich iba pre klientov, ktorí nedokážu pripojiť `Authorization: Bearer ...`. Overovanie pomocou hlavičky zostáva uprednostňovaný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.
pino — štruktúrované protokoly JSON s kontextom požiadavky
Testovanie
Testovací nástroj Node.js + Vitest — viac ako 39 000 deklarácií statických testov vo viac ako 5 100 sledovaných testovacích súboroch (jednotkové, integračné, E2E, bezpečnostné, ekosystémové)
Platformy
Počítač (Electron) · Android (Termux) · PWA (ľubovoľný prehliadač)
CI/CD
GitHub Actions — automatické publikovanie na npm a Docker Hub pri vydaní
Stratégia pokrytia testami pre viac než 39 000 statických deklarácií testov vo viac než 5 100 sledovaných testovacích súboroch
# ⭐ Najlepší prispievatelia
> OmniRoute formuje zanietená open-source komunita. Títo jednotlivci mimoriadne prispeli ku kvalite, stabilite a dosahu projektu. **Ďakujeme.**
### Externí prispievatelia podľa zlúčených pull requestov
Stav zmrazený na aktuálnom konci vetvy release/v3.8.50, konkrétne na revízii dafb4ae808, so zlúčeniami do 2026-08-24 05:26:03 UTC. Stránkované sčítanie prostredníctvom GitHub GraphQL obsahuje 5 911 zlúčených PR: 2 707 od vlastníka repozitára, 179 od Dependabota a 3 025 externých PR od 535 rôznych prispievateľov. „Zmenené riadky“ predstavujú súčet pridaní a 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 počet autorsky napísaných riadkov kódu. Zhody na hranici poradia sú zachované.
### Commity priradené službou GitHub
Opätovne skontrolované 2026-08-24 06:14:31 UTC: commity pripísané službou GitHub, ktoré uvádza API Contributors repozitára pre predvolenú vetvu release/v3.8.50. API vrátilo 525 identít (415 používateľov, 2 botov, 108 anonymných); táto tabuľka nezahŕňa správcu, botov ani anonymné identity a zachováva delené umiestnenia. Líši sa od poradia podľa zlúčených PR vyššie aj od súpisu 639 osôb podľa metadát systému Git nižšie.
> 🙏 Funkcie, opravy chýb a vylepšenia infraštruktúry od týchto prispievateľov sú **kľúčovou súčasťou** toho, vďaka čomu je OmniRoute spoľahlivý a funkčne bohatý. Každá požiadavka pull request, každý testovací prípad a každý súbor prekladu i18n sú dôležité. 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žiavať projekt bezplatný, nezávislý a v neustálom vývoji.
… a ďalší, ktorí si želajú zostať v anonymite 💛Verejní sponzori GitHub Sponsors boli opätovne overení 2026-08-24. Stav activeOnly služby GitHub určuje vyššie uvedené označenia aktívnych sponzorov; verejne uvedeným bývalým jednorazovým podporovateľom naďalej ďakujeme a súkromní sponzori zostávajú anonymní.💖 Staňte sa sponzorom → — každý dolár pomáha udržiavať OmniRoute bezplatný a nezávislý.
## 👥 Viac ako 600 prispievateľov
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Audit vykonaný 2026-08-24 pri zmrazenom základe ac02c5b42f a opätovne overený na aktuálnej špičke dafb4ae808 vetvy release/v3.8.50: 639 normalizovaných ľudských identít Git — 407 z nich sa vyskytuje ako autori commitov (vrátane správcu) a 232 iba vo výslovných pätičkách Co-authored-by. Súpis normalizuje identifikátory GitHub noreply, vylučuje 26 identít botov/agentov/služieb/zástupných účtov a nezlučuje bežné e-mailové adresy iba preto, že sa zhodujú ich zobrazované mená.
### Ako prispievať
1. Vytvorte fork repozitára
2. Vytvorte vetvu zo špičky **aktívnej** vetvy `release/vX.Y.Z` (nie z `main`) — pozrite si [Model vetvenia a vydávania](docs/ops/BRANCHING_MODEL.md)
3. Vytvorte svoju funkčnú vetvu (`git checkout -b feat/amazing-feature`)
4. Commitnite svoje zmeny (`git commit -m 'feat: add amazing feature'`)
5. Odošlite ich do vetvy (`git push origin feat/amazing-feature`)
6. Otvorte Pull Request s nastavením **base = príslušná vetva `release/vX.Y.Z`**
Podrobné pokyny nájdete v súbore [CONTRIBUTING.md](CONTRIBUTING.md).
### Vydanie novej verzie
```bash
# Vytvorenie vydania — 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 **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** z jazyka Go do TypeScriptu — a odvtedy bol každý nižšie uvedený subsystém inšpirovaný open-source projektom, ktorý túto cestu prešiel ako prvý. Každý z nich formoval konkrétnu časť OmniRoute. Toto je naše poďakovanie všetkým týmto projektom. 🙏
> ⭐ počty hviezdičiek boli overené prostredníctvom GitHub REST API 24. augusta 2026 — choďte a udeľte týmto projektom hviezdičku. Uvedené počty predstavujú presnú snímku k danému dátumu a prirodzene sa budú meniť.
### 🧬 Pôvod a brána
Brána AI, ktorej verejný súbor údajov o cenách slúži na synchronizáciu nášho sledovania nákladov a ktorej model normalizácie poskytovateľov ovplyvnil naše smerovanie.
Zdrojový kód s licenciou MIT prispôsobený do integrovanej vrstvy ChatGPT Web → Codex Responses vrátane adaptérov relácie prehliadača, rámcovania odpovedí, využitia a webového vyhľadávania.
Predvolené nastavenia transformácie kompatibilné s Claude Code a správanie fakturačných hlavičiek zovšeobecnené do konfiguračne riadenej vrstvy OmniRoute.
Jeho mapovania modelov Grok, generátor Statsig simulujúci TypeError, predvolené nastavenia požiadaviek a zariadení a procesor odpovedí NDJSON boli vo významnej miere prispôsobené do vykonávacieho modulu Grok Web v OmniRoute.
Hlavný nepriamy zdroj kódu pre grok2api-merged; jeho implementácie modelov, hlavičiek, dát požiadaviek, Statsig a procesora sú zachované v pôvode Grok Web.
Základný zdrojový kód s licenciou MIT pre dáta požiadaviek Grok a predvolené nastavenia zariadení, generátor Statsig a procesor result.response, ktoré boli prevzaté prostredníctvom projektov TQZHR a grok2api-merged.
Nepriamy zdroj uvedený projektom grok2api-merged pre jeho vrstvu fondu proxy serverov; OmniRoute zachováva zmienku o tomto pôvode, ale netvrdí, že jeho ohraničený vykonávací modul Grok Web obsahuje port fondu proxy serverov.
Pôvodná implementácia Grok Web vychádzala pri návrhu svojej nadradenej vrstvy HTTP/prehliadača z tohto projektu; jej priama cesta HTTP je odvodená od GrokProxy, preto sa netvrdí, že ide o nezávislý port kódu.
Virálny projekt „prečo používať veľa tokenov, keď stačí málo tokenov“ — jeho jaskyniarska filozofia je základom nášho štandardného režimu kompresie a viac než 30 pravidiel na odstraňovanie výplňových slov a kondenzáciu.
Výskum kompresie promptov (LLMLingua / LLMLingua-2) — inšpiroval náš asynchrónny mechanizmus llmlingua, ktorý bezpečne zachováva kód a pri zlyhaní ponecháva pôvodný obsah.
Kompresia tokenov pre brazílsku portugalčinu — tvorí základ nášho jazykového balíka pt-BR: redukcia pleonazmov a odstraňovanie výplňových slov prispôsobené gramatike brazílskej portugalčiny.
Virálna zručnosť YAGNI programátora typu „lenivý seniorný vývojár“ — inšpirovala náš výstupný štýl less-code: smerovanie k najmenšej funkčnej zmene, ktoré obmedzuje _generovaný_ kód (náprotivok stručnej prózy projektu Caveman na osi výstupu).
Kompresia výstupu zohľadňujúca obsah a typ súboru s ukončením pri možnom zlyhaní — potvrdila správnosť nášho smerovania podľa typu a preskočenia kompresie pri nedostatočnom prínose.
Stĺpcový JSON v Ruste, načítanie adresované obsahom a deduplikácia naprieč správami — potvrdili návrh našich mechanizmov headroom/ccr/session-dedup a invariant vhodný pre stabilnú vyrovnávaciu pamäť: „komprimovaná forma je nezávislá od pozície“.
Súprava nástrojov pre TypeScript Compiler API — inšpirovala naše odstraňovanie komentárov založené na parseri, ktoré zachováva reťazcové, šablónové a regexové literály.
MITM zachytávanie a analýza prevádzky medzi asistentom na programovanie ↔ LLM ovplyvnili prvotné požiadavky na Traffic Inspector. Štyri predtým odvodené moduly — zlučovanie SSE, normalizácia konverzácií, maskovanie tajných údajov a sanitizácia hlavičiek — boli nahradené nezávislými implementáciami vytvorenými od základu na základe verejných protokolových štandardov. Dve plochy na priame odovzdávanie hostiteľovi (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é.
Transparentné smerovanie cez proxy pre jednotlivé procesy — inšpirovalo naše bezpečné ukončenie MITM pri zlyhaní, časové limity nečinnosti socketov, priraďovanie procesov pomocou /proc a zachytávanie TPROXY.
### 📚 Údaje o modeloch, pozorovateľnosť a používateľské rozhranie
Kurátorský zoznam knižníc, ktoré sú predvolene bezpečné a usmerňujú naše bezpečnostné rozhodnutia (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Jeho premapovanie modelov zohľadňujúce účty, overovanie ciest k spustiteľným súborom a správanie označení plánov ovplyvnili runtime Antigravity v OmniRoute.
Identifikoval rozhranie kvóty Grok Build; OmniRoute následne nezávisle overil a opravil aktuálny formát prenášaných údajov.
## 📄 Licencia
Licencia MIT – podrobnosti nájdete v súbore [LICENSE](LICENSE).
---
**[⬆ Späť na začiatok](#-omniroute)** · Vytvorené s ❤️ pre open-source komunitu AI.
OmniRoute v3.8.52 · Node ≥22.22.2 · Licencia MIT · omniroute.online
> Animovaný súhrn aktuálnej stránky `/dashboard/free-tiers`. Kompletná metodika (odstraňovanie duplicít fondov, úrovne kreditov, podmienky poskytovateľov): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Tieto údaje sa každé dva týždne opätovne kontrolujú podľa aktuálneho katalógu a **menia sa oboma smermi** — keď poskytovateľ ukončí bezplatnú úroveň, číslo klesne; keď pribudne nová, číslo stúpne. Zverejňujeme to, čo katalóg skutočne vypočíta, nikdy nie zaokrúhlený najlepší možný scenár.
```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. Čerstvá inštalácia nemusí mať žiadne vhodné bezkľúčové ciele a bezkľúčový poskytovateľ môže odmietnuť klientov tretích strán. Poskytovatelia označení ako `tos: avoid`, vrátane OpenCode Free a 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 pre rýchly štart metódou kopírovať a vložiť pre **Python, Node.js, PHP a cURL** → [`examples/quickstart/`](examples/quickstart/)
> **Kombinácia** je reťazec modelov, medzi ktorými OmniRoute smeruje požiadavky **automaticky**. Ak sa vyčerpá kvóta, poskytovateľ zlyhá alebo prudko vzrastú náklady, kombinácia môže prejsť na ďalší vhodný a funkčný model. 🛡️
### ⚡ Bez konfigurácie — stačí použiť `auto`
Nemusíte vytvárať žiadnu kombináciu. Nastavte model na `auto` (alebo jeho variant) a OmniRoute vytvorí virtuálnu kombináciu z vašich pripojených poskytovateľov, ktorých priebežne vyhodnocuje:
📖 [Mechanizmus Auto-Combo](docs/routing/AUTO-COMBO.md) · [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md)
📊 Úplná metodika a podrobnosti o jednotlivých funkciách v porovnaní s 9router, OpenRouter, CLIProxyAPI a LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Kľúč (náhodný): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix copia-e-cola:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Autorizácia](docs/architecture/AUTHZ_GUIDE.md) · [Ochranné mechanizmy](docs/security/GUARDRAILS.md) · [Súlad s predpismi](docs/security/COMPLIANCE.md)
Predvolená kombinácia spúšťa `RTK → Caveman`. Keď oba mechanizmy spracúvajú rovnaký obsah nástroja alebo 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, adresy URL, JSON a štruktúrované údaje sú mechanizmom zachovania **vždy chránené**.
> **Prečo používať veľa tokenov, keď postačí málo?** Každá požiadavka prechádza kompresným pipeline OmniRoute **transparentne** — bez zmien na strane klienta. Teraz ide o **súbor 12 kombinovateľných mechanizmov**, ktoré sa spúšťajú v danom poradí a možno ich ľubovoľne kombinovať pre každú smerovaciu kombináciu — na základe myšlienok z projektov [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ viac ako 90 tis.), [LLMLingua-2](https://github.com/microsoft/LLMLingua) a [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 Systém 12 mechanizmov
Mechanizmy sa spúšťajú v poradí pipeline; každý možno nezávisle zapnúť či vypnúť a nakonfigurovať pre jednotlivé kombinácie:
