## 💰 ~1,62 mld. tokenov / mesiac naprieč bezplatnými vrstvami tretích strán
> **Prineste si vlastné účty poskytovateľov.** Ide o odhadovaný súčet naprieč samostatne oprávnenými bezplatnými vrstvami tretích strán, nie o grant tokenov od OmniRoute. Zaregistrujte sa, získajte prihlasovacie údaje tam, kde sú potrebné, a pripojte poskytovateľov, ktorých môžete používať; každý poskytovateľ si riadi svoje limity, dostupnosť a podmienky.
>
> Ručné vrstvenie bezplatných vrstiev je otrava — desiatky SDK, desiatky rate limitov a žiadna predstava o tom, koľko toho vlastne máte. OmniRoute katalogizuje **467 záznamov bezplatných vrstiev naprieč 34 opakujúcimi sa kľúčmi poolov** a tokenový titulok počíta z **17 poolov so zverejneným kladným mesačným rozpočtom plus piatich per-model limitov Groq**, s deduplikáciou podľa zdieľaného poolu. Kvóty, ktoré sa otvárajú až po regionálnej kontrole identity (dnes: ModelScope), sú zobrazené oddelene, +~6M za regionálnym overením identity, a nikdy sa nezapočítavajú do titulku. Výsledok zostáva viditeľný na dashboarde (`/dashboard/free-tiers`).
> Animovaný súhrn živej stránky `/dashboard/free-tiers`. Úplná metodika (deduplikácia poolov, úrovne kreditov, podmienky poskytovateľov): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Tieto čísla sa každé dva týždne preverujú voči živému katalógu a **menia sa oboma smermi** — poskytovateľ ukončí bezplatnú vrstvu a číslo klesne; pribudne nový a číslo stúpne. Zverejňujeme to, čo katalóg skutočne vypočíta, nikdy nie zaokrúhlený najlepší scenár.
⭐ Dajte repozitáru hviezdičku, ak vám OMNIROUTE pomohol ušetriť peniaze a uľahčiť prácu.
[](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 — nových poskytovateľov, vydania a tipy dostanete 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, roadmapa 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 neustále rozrastá
## 🆓 Nainštalujte, pripojte poskytovateľa a potom smerujte cez jeden koncový bod
```bash
# Po pripojení poskytovateľa skopírujte svoj kľúč OmniRoute z časti 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` vyžaduje podporovanú trasu. Čerstvá inštalácia nemusí mať žiadne podporované ciele bez kľúča a poskytovateľ bez kľúča môže odmietnuť klientov tretích strán. Poskytovatelia označení ako `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 pre rýchly štart pripravené na skopírovanie a vloženie 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.
## 🎯 Kombá — Vlajková funkcia
> **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)
📖 [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é
> Nedávne highlights z **v3.8.20 → v3.8.53**. Celá história v [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Smerovanie `quota-weighted`** — dvadsať stratégia comba preskakuje vyčerpané účty a potom ťahá medzi ostatnými v pomere k zostávajúcej kvóte ÷ zaťaženiu v behu, pričom existujúce konverzácie zostávajú pripnuté. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless režim** — `omniroute serve --headless` (alebo `OMNIROUTE_HEADLESS=1`) spúšťa iba proxy engine `/v1/*`, s vypnutým dashboardom a subsystémami určenými len pre dashboard. → [Headless režim](docs/guides/HEADLESS.md)
- **🔎 Objavovanie modelov** — `/v1/models` filtruje podľa schopnosti, kontextu, druhu a textu a `POST /v1/models/query` vracia krátky deterministický shortlist s rovnakou viditeľnosťou pre každý kľúč. → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 Smerovanie podľa kľúča** — pripnite API kľúč k jednému modelu alebo combu pomocou `forcedModel` a pridávajte alebo odoberajte modely a combá kľúča atómovo (`/api/keys/{id}/access`). → [API Reference](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 maskovacích vzorov a počítadlá detekcie podľa typu; samotné maskovanie zostáva opt-in. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 jazykov** — dashboard, zrkadlá dokumentácie a CLI, pričom `npm run i18n:add-locale` pridá jazyk všade jedným príkazom. → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — prichádzajúca delegácia A2A na vašu flotilu agentov, Conductor skills na Agent Card a panel dashboardu s Faro push-to-talk hlasovým chatom. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptívne prijímanie a ochrana proti preťaženiu** — ťažké chatové požiadavky sa zaraďujú do frontu namiesto 503, s atómovými RPM rolling leases pre každé pripojenie. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonické poradie `/v1/models`** — jeden súvislý blok zoskupený podľa poskytovateľa pre každého poskytovateľa (combá pripnuté ako prvé), stabilný naprieč všetkými zdrojmi katalógu. → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ Zpevnenie kompresie** — predvolene zapnutá inflation guard, Caveman packs pre DE / FR / JA + čínštinu (wényán), RTK filtre pre Gradle a .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Poctivé náklady pri paušálnych sadzbách** — poskytovatelia predplatného / kódovacích plánov čítajú v analýze nákladov **$0**; rozpočet, kvóta a smerovanie naďalej odhadujú. → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Smerovanie Quota-Share** — rozdeľte kvótu zdieľaného účtu spravodlivo medzi združené kľúče, work-conserving, takže nečinné podiely sa požičiavajú. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Nastavenie CLI/agentov jedný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 + modelu a obľúbenými položkami podľa kontextu. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Vzdialený režim** — ovládajte vzdialený OmniRoute pomocou scoped tokenov (`connect` / `contexts` / `tokens`) + pomocník `antigravity` OAuth pre inštalácie na VPS. → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 Inteligentnejšie automatické smerovanie** — combá `auto/:`, **Fusion** (model panel + judge), smerovanie podľa úlohy, prepisy modelu / režimu / USD rozpočtu pre jednotlivé požiadavky. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Zásuvná kompresia** — 12 komponovateľných engineov + Compression Studios: LLMLingua-2, dvojúrovňový Ultra, omniglyph, fidelity gate pre každý krok, GCF v3.2, editor s preťahovaním na zmenu poradia. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transparentné MITM dešifrovanie (TPROXY)** — zachyťte CLI, ktoré ignorujú proxy env premenné, s CA pre každé SNI + inštalátorom trust store. → [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 cache-HIT, USD kvóty výdavkov podľa kľúča. → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 Pamäť pod vašou kontrolou** — predvolene vypnutá, opt-in int8 vektorová kvantizácia + typovaný decay, `x-omniroute-no-memory` pre jednotlivé požiadavky. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ Bezpečnosť** — ochrana proti prompt-injection na každej LLM trase (red-team suite), opt-in guardrail na maskovanie poverení (rediguje uniknuté API kľúče/tajné údaje v oboch smeroch), bezplatné webové vyhľadávanie DuckDuckGo ako posledná možnosť a voliteľná OIDC prihlasovacia brána pre dashboard (prihlásenie heslom zostáva vždy dostupné). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ Nové endpointy** — `/v1/ocr` (Mistral OCR) a `/v1/audio/translations` (v štýle Whisper) dopĺňajú mediálne rozhranie. → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 Generovanie obrázkov / videa / zvuku** — jedno API pre médiá: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind a rečoví poskytovatelia ako ElevenLabs. → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 Nasadenie a prevádzka** — reverse-proxy `basePath`, automatická detekcia jazyka prehliadača, sledovanie zariadení podľa kľúča, root-less MITM trust, lokalizácia zh-TW. → [Environment](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, prvotriedna karta Ollama, Claude Opus 5 & Sonnet 5, oficiálne partnerstvo s Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… a obnovený **katalóg 375 poskytovateľov**. → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Transparentnosť smerovania** — každá odpoveď nesie hlavičku `X-OmniRoute-Decision` s názvom stratégie/poskytovateľa/latencie, ktorá ju obslúžila, nová stratégia comba `cache-optimized` + faktor `cacheAffinity` v Auto-Combo smeruje opakované požiadavky späť na pripojenie, ktoré drží cached prefix, a read-only endpoint `/v1/auto-combo/{channel}/candidates` sprístupňuje živý fond kandidátov kanála `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Lokálny výkon a infraštruktúra** — jednoklikový lokálny Redis, deployery relay pre Cloudflare Workers / Deno Deploy, Bifrost a Mux ako supervidované vstavané služby. → [Vstavané služby](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Tiež v balení** — rámec pluginov + marketplace, rámce zručností Omni/Agent/GitHub, integrácia s Obsidian vault (22 MCP nástrojov), OpenAI-kompatibilné Batch & Files API, sémantická cache odpovedí, gamifikácia s rebríčkami, ACP agent discovery (15 vstavaných agentov), plánovaný export logov do BigQuery, paralelné multi-model fan-out `auto/chaos`, Telegram bot bridge, správca verzií priamo v aplikácii a rebríčky poskytovateľov zdarma podľa 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 37 nástrojov (27 CLI Code + 10 CLI agentov) → [`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 samostatne pre každý proces a Qwen/Gemini získajú 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 5dive
```
Každý príkaz rešpektuje aktívny vzdialený kontext (`omniroute connect `), `--dry-run`
zobrazí presné premenné prostredia a argumenty bez vykonania a `--api-key-env NAME` zabráni uloženiu tajných údajov
do histórie vášho shellu. → [Integrácie CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 AI poskytovateľov — 153 označených v katalógu ako bezplatné
> **375 registrovaných poskytovateľov** v kanonických kolekciách chat, média, vyhľadávanie, lokálne, cloud-agent a systém, vrátane **153 s metadátami objavovania `hasFree: true`**. Register chatových modelov pokrýva **239 poskytovateľov / 3 059 jedinečných dvojíc poskytovateľ–model / 1 475 surových ID modelov**; samostatný katalóg bezplatných rozpočtov má **467 riadkov na model**, **34 opakujúcich sa poolov** a **51 opakujúcich sa/bez kľúča navždy bezplatných poskytovateľov**. Ide zámerne o odlišné menovatele; definície a výpočty s deduplikáciou poolov nájdete v [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) a [Free Tiers](docs/reference/FREE_TIERS.md).
### 🏢 Každé významné laboratórium — cez jeden endpoint
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…a ďalších 350+ — každá ikona sa načítava naživo z katalógu poskytovateľov na dashboarde. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Navždy zadarmo — 0 $, bez karty
OpenCode Zen DeepSeek V4, Nemotron 3 Bez limitu tokenov
Kilo Code Auto-router, Tencent Hy3 Navždy zadarmo
Requesty GPT-OSS 120B, Nemotron Navždy zadarmo
SiliconFlow DeepSeek V3.2 / R1 Bezplatný plán
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 Netreba kľúč
Cloudflare AI 50+ modelov 10K 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 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)
### 🤝 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
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)
## 🗜️ Ušetrite 15–95 % tokenov — automaticky
### 📖 Ako to funguje — pipeline, architektúra a matematika úspor
Predvolená skladaná kombinácia spúšťa `RTK → Caveman`. Keď obe pôsobia na ten istý tool/context payload, úspory sa kumulujú:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Kódové bloky, URL, JSON a štruktúrované dáta sú **vždy chránené** zachovávacím enginom.
> **Prečo používať veľa tokenov, keď málo tokenov stačí?** Každá požiadavka prechádza kompresným pipeline OmniRoute **transparentne** — bez zmien na strane klienta. Teraz je to **stack 12 skladateľných engineov**, ktoré sa spúšťajú v poradí a kombinujú sa podľa routing comba — postavený na myšlienkach z [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).
### 🧱 Stack 12 engineov
Enginy sa spúšťajú v poradí pipeline; každý je samostatne prepínateľný a konfigurovateľný pre jednotlivé combo:
#
Engine
Čo robí
1
Session-Dedup
Odstraňuje obsah opakovaný naprieč turnami (content-addressed, cross-turn)
2
CCR
Archivuje veľké bloky za retrieve markery, načítavané na vyžiadanie
3
Lite
Orezávanie bielych znakov + image-URL (latency-light základ)
4
RTK
Inteligentné filtrovanie tool-resultov, dedup a truncation (command-aware)
Extrakčné skórovanie viet voči poslednej používateľskej požiadavke
8
Caveman
Pravidlový kompresia prózy (~65–75 % na výstupe)
9
Aggressive
Sumarizácia + progresívne starnutie starých turnov
10
LLMLingua-2
ML sémantické prerezávanie cez MobileBERT ONNX — code-safe, asynchrónne
11
Ultra
Heuristické prerezávanie tokenov s voliteľnou small-model (SLM) vrstvou
12
OmniGlyph
Experimentálne kódovanie kontextu ako obrázka pre nameraný Claude Fable 5 na priamom Anthropic wire; GPT 5.6 transformers zostávajú fail-closed do doručenia provider receipts. Štyri kompresné profily (aggressive default, balanced, coding-safe, passthrough) (najagresívnejší; opt-in)
Kódové bloky, URL a štruktúrované dáta sú **vždy zachované** byte-perfect. **One-click presety** kombinujú enginy:
Režim
Úspory
Najlepšie na
🪶 Lite
~15 %
Always-on bezpečný default
🪨 Standard (Caveman)
~30 %
Každodenné kódovanie
⚡ Aggressive
~50 %
Dlhé sedenia s veľa nástrojmi
🔥 Ultra
~75 %
Maximálne úspory
🧰 RTK
60–90 %
Shell/test/build/git výstupy
🔗 Stacked (RTK → Caveman)
78–95 %
Zmiešané prompty + tool logy
**Reálny príklad — režim Standard:**
> **Pred (69 tokenov):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_
>
> **Po (19 tokenov):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_
>
> **Rovnaká odpoveď. O 72 % menej tokenov. Nulová strata presnosti.** ✅
**PT-BR príklad — režim [Troglodita](https://github.com/leninejunior/troglodita):**
> **Predtým (42 tokenov):** _„Problém je 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účam 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 regulátor a ovládanie pre jednotlivé požiadavky
Vyššie uvedených 12 enginov zmenšuje to, čo ide **dovnútra**. Ďalšie tri vrstvy určujú, **ako**, **kedy** a čo vyjde **von**:
- **🪄 Štýly výstupu** _(riadenie výstupnej osi)_ — vkladajú deterministické pokyny na formovanie odpovede, ktoré sú bezpečné pre vyrovnávaciu pamäť; možno ich kombinovať a každý má intenzitu `lite` / `full` / `ultra`. Pridanie štýlu predstavuje jednoriadkový záznam v registri:
- **Stručná próza** — odstráni výplňové slová, členy a zmierňujúce formulácie; technický obsah zachová presne.
- **Menej kódu** — YAGNI „lenivého seniorného vývojára“: najmenšia funkčná zmena, bez nevyžiadanej podpornej infraštruktúry.
- **Cop (lenivý seniorný vývojár)** — postupuje po rebríčku YAGNI, opraví základnú príčinu a vytvorí najmenší funkčný rozdiel.
- **Mám ADHD (najprv akcia)** — začína nasledujúcou akciou, kroky sú očíslované, obsahuje jeden konkrétny ďalší krok a žiadny úvod.
- **Stručná CJK (文言)** — ultr stručný štýl klasickej čínštiny (obmedzený na miestne nastavenie `zh`).
- **🎯 Adaptívny rozpočet kontextu** _(regulátor)_ — namiesto jedného prahu tokenov typu zapnuté/vypnuté aktivuje najlacnejšie enginy s najmenšími stratami len do takej miery, aká je potrebná na **zmestnenie do kontextového okna modelu**. Zásady: `reserve-output` (predvolené, s ohľadom na model) · `percentage` · `absolute`. Režim: `floor` (zaručí zmestnenie) · `replace-autotrigger` (vaša explicitná voľba má prednosť) · `off` (starší prah).
- **🎛️ Kde sa rozhoduje o kompresii** _(priorita, od najvyššej po najnižšiu)_ — hlavička `x-omniroute-compression` pre jednotlivú požiadavku › prepísanie kombinácie smerovania › aktívny pomenovaný profil › adaptívne/automatické spustenie › predvolené nastavenie panela › vypnuté. Použitý plán sa vráti v hlavičke odpovede `X-OmniRoute-Compression: ; source=`.
Nastavte automatické spustenie podľa prahu tokenov, zapnite adaptívny regulátor, pripnite pomenovaný profil, zvoľte jednorazové nastavenie pre konkrétnu požiadavku alebo priraďte pipeline ku kombinácii smerovania — podľa toho, čo vyhovuje danej pracovnej záťaži. Voliteľná offline **testovacia sada** (`npm run eval:compression`) pred nasadením zmeny vyhodnotí vernosť v porovnaní s úsporou na pripnutom korpuse.
📖 [`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 upozornenie na partnerské závislosti? [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íkov, ak nie sú povolené. Skript `postinstall` (`node scripts/build/postinstall.mjs`) nástroja OmniRoute 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ú nástrojom OmniRoute 3.8.53:
>
> ```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ť aj 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. Povolením balíka umožníte spúšťanie jeho inštalačných skriptov.
> **Používate Gemini Web alebo iného poskytovateľa založeného na webových súboroch cookie?** 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 [Nastavenie Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium).
Ovládací panel je na adrese `http://localhost:20128` · API na adrese `http://localhost:20128/v1`.
**2) Pripojte oprávneného poskytovateľa pomocou vlastného účtu**
Ovládací panel → **Poskytovatelia** → vyberte poskytovateľa, ktorého aktuálne podmienky a kvóty vyhovujú vášmu prípadu použitia → pridajte jeho API kľúč 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
Base URL: http://localhost:20128/v1
API Key: [skopírujte z Ovládací panel → Koncové body]
Model: auto (smeruje medzi oprávnený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ť vaše pripojené modely. 🎉 To je všetko — začnite programovať a OmniRoute bude za vás automaticky smerovať požiadavky a prepínať na záložné možnosti.
Ak váš klient nedokáže odosielať vlastné hlavičky, OmniRoute poskytuje 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 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.
Stratégia pokrytia testami pre 56 000+ statických testovacích deklarácií v 7 800+ sledovaných testovacích súboroch
# ⭐ Najlepší prispievatelia
> OmniRoute formuje vášnivá open-source komunita. Títo jednotlivci priniesli výnimočné príspevky, ktoré majú priamy vplyv na kvalitu, stabilitu a dosah projektu. **Ďakujeme.**
### Externí prispievatelia podľa zlúčených pull requestov
Sčítanie vykonané 2026-10-18 15:09:09 UTC s aktuálnym vrcholom release/v3.8.52656f01cb43. Stránkované sčítanie GitHub GraphQL obsahuje 9 191 zlúčených PR: 3 834 od vlastníka repozitára, 229 od Dependabotu, 6 od iných botov/aplikácií a 5 122 externých PR od 835 rôznych prispievateľov. „Zmenené riadky“ predstavujú sčítanie pridaných a odstránených riadkov na GitHube a zahŕňajú generované súbory, lockfiles, katalógy, preklady a dokumentáciu; ide o fluktuáciu, nie o autorsky vytvorené LOC. 49 PR vykazuje rozdiely na GitHube nad 500 000 riadkov (napríklad #13399, pridanie jediného poskytovateľa, uvádza 2 347 zmenených súborov), čo nafukuje niektoré vyššie uvedené súčty. Zhody sú zoradené spolu.
### Commity pripísané na GitHube
Opätovne overené 2026-10-18 14:44:45 UTC: commity priradené GitHubu podľa Contributors API repozitára pre predvolenú vetvu release/v3.8.52. API vrátilo 849 identít (429 používateľov, 2 boti, 418 anonymných); táto tabuľka nezahŕňa správcu, botov ani anonymné identity a zachováva poradie pri rovnosti. Odlišuje sa od vyššie uvedeného rebríčka zlúčených PR aj od nižšie uvedeného sčítania z Git metadát.
> 🙏 Funkcie, opravy chýb a vylepšenia infraštruktúry od týchto prispievateľov sú **podstatnou súčasťou** toho, prečo 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.
… 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 ako 900 prispievateľov
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Audit vykonaný 2026-10-18 na aktuálnej špičke release/v3.8.52 s identifikátorom ad160ab2d1 (6 826 commitov): 993 normalizovaných ľudských identít Git — 707 sa objavuje ako autori commitov (vrátane správcu) a 286 iba v explicitných záznamoch Co-authored-by. Súpis používa .mailmap, porovnáva e-mailové adresy bez ohľadu na veľkosť písmen, spája číselné a bežné adresy GitHub noreply iba vtedy, keď kódujú rovnakú používateľskú prezývku, vylučuje 26 identít botov, agentov, služieb a zástupných identít a nezlučuje bežné e-mailové adresy iba preto, že sa zhodujú ich zobrazované mená. Audit z 2026-08-24 uvádzal 639; opätovné použitie tejto metódy na základ tohto auditu ac02c5b42f dáva výsledok 619, takže nárast pochádza od nových prispievateľov, nie z voľnejšej metódy.
### Ako prispieť
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 vetvu pre funkcionalitu (`git checkout -b feat/amazing-feature`)
4. Potvrďte 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
# 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 **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** z jazyka Go do TypeScriptu — a odvtedy bol každý z nižšie uvedených subsystémov 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 18. októbra 2026 — udeľte týmto projektom hviezdičku. 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ý a zahrnutý do premostenia ChatGPT Web → Codex Responses vrátane adaptérov relácií prehliadača, rámcovania odpovedí, využitia a webového vyhľadávania.
Predvolené nastavenia transformácií kompatibilné s Claude Code a správanie fakturačných hlavičiek zovšeobecnené v konfiguračne riadenom premostení OmniRoute.
Jeho mapovania modelov Grok, generátor Statsig s falošným TypeError, predvolené nastavenia požiadaviek a zariadení a procesor odpovedí NDJSON boli významne prispôsobené vo vykonávacom module Grok Web systému OmniRoute.
Hlavný tranzitívny zdroj kódu, z ktorého vychádza grok2api-merged; jeho implementácie modelov, hlavičiek, užitočných údajov, Statsig a procesora sú zachované v rodokmeni Grok Web.
Základný zdrojový kód s licenciou MIT pre užitočné údaje Grok a predvolené nastavenia zariadení, generátor Statsig a procesor result.response, prenesený prostredníctvom TQZHR a grok2api-merged.
Tranzitívny zdroj, ktorý grok2api-merged uvádza pri svojej vrstve 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.
Jeho proxy server Grok overovaný pomocou súborov cookie a vzor streamovania result.response.token ovplyvnili prenosovú vrstvu Grok Web systému OmniRoute.
Pôvodná implementácia Grok Web využila jeho návrh nadradeného systému HTTP/prehliadača; jej priama cesta HTTP vychádza z GrokProxy, preto sa neuvádza žiadny samostatný port kódu.
Virálny projekt „prečo používať veľa tokenov, keď pár tokenov stačí“ — jeho jaskyniarska filozofia je základom nášho štandardného režimu kompresie a viac ako 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 engine llmlingua, ktorý bezpečne pracuje s kódom a pri zlyhaní pokračuje bez kompresie.
Virálna zručnosť programátora „lenivý senior“ založená na princípe YAGNI — inšpirovala náš štýl výstupu less-code: smerovanie k najmenšej funkčnej zmene, ktoré obmedzuje _generovaný_ kód (náprotivok stručnej prózy Cavemanu na osi výstupu).
Kompresia výstupu zohľadňujúca obsah a typ jednotlivých súborov s ukončením pri zlyhaní — potvrdila správnosť nášho smerovania podľa typu a preskočenia pri nedosiahnutí minimálnej úspory.
Stĺpcový JSON v Ruste + načítanie podľa adresy obsahu + deduplikácia naprieč správami — potvrdili správnosť návrhu našich enginov headroom/ccr/session-dedup a invariant stabilnej vyrovnávacej pamäte „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 programovacími asistentmi a 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ákladov na základe verejných protokolových štandardov. Dve plochy na priame prepúšťanie hostiteľov (passthrough.ts a _internal/bypass.cjs) zostávajú internými implementáciami OmniRoute, ktoré sú klasifikované nezávisle; v rámci tejto náhrady neboli prepísané.
Transparentné smerovanie proxy pre jednotlivé procesy — inšpirovalo naše bezpečné ukončenie MITM pri zlyhaní, časové limity nečinnosti socketov, priraďovanie procesov prostredníctvom /proc a zachytávanie TPROXY.
### 📚 Údaje o modeloch, pozorovateľnosť a používateľské rozhranie
Kurátorský zoznam knižníc s predvoleným bezpečným nastavením, ktorý usmerňuje 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 prostredie Antigravity v OmniRoute.
Identifikoval rozhranie kvóty Grok Build; OmniRoute následne nezávisle overil a opravil aktuálny formát údajov prenášaných po linke.
## 📄 Licencia
Licencia MIT – podrobnosti nájdete v [LICENSE](LICENSE).
---
**[⬆ Späť na začiatok](#-omniroute)** · Vytvorené s ❤️ pre open-source AI komunitu.
OmniRoute v3.8.53 · Node ≥22.22.2 · Licencia MIT · omniroute.online