> Ručné kombinovanie bezplatných úrovní je náročné — desiatky SDK, desiatky limitov požiadaviek a žiadny prehľad o tom, koľko 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 celkový počet tokenov vypočítava zo **17 fondov so zverejneným kladným mesačným rozpočtom plus piatich limitov Groq pre jednotlivé modely**, pričom zdieľané fondy deduplikuje. Kvóty, ktoré sa sprístupnia až po regionálnom overení identity (v súčasnosti: ModelScope), sa zobrazujú samostatne ako +~6 mil. za regionálnym overením identity a nikdy sa nezapočítavajú do hlavného súčtu. 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 (deduplikácia 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** — ak poskytovateľ ukončí bezplatnú úroveň, číslo klesne; ak 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 uľahčil prácu, označte repozitár hviezdičkou.
[](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 týkajúce sa poskytovateľov, 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 neustále rozrastá
| | v3.8.49 | **v3.8.50** | `v3.8.51+` |
| ---------------------------- | :-----: | :---------------------: | :---------------: |
| 🌐 Poskytovatelia | 290 | **357** | ďalší sú v poradí |
| 🧠 Jedinečné ID modelov četu | 1185 | **1312** | — |
| 🖼️ Most medzi modalitami | — | 🆕 obraz + zvuk + video | — |
| 📡 Bezplatný katalóg Radar | — | 🆕 voliteľná aktivácia | — |
| ⚖️ Plánovanie podľa kvóty | — | 🆕 Quota-Share | — |
| 📊 Telemetria kvót | — | 🆕 v reálnom čase | — |
**→ [Plán vývoja](ROADMAP.md) — po koľajniciach k `v3.9.0 LTS`**
## 🧩 Dostupné
[](https://www.npmjs.com/package/omniroute)
[](https://hub.docker.com/r/diegosouzapw/omniroute)
[](LICENSE)
## 🆓 Funguje hneď po inštalácii — bez kľúčov, bez konfigurácie
```bash
# Čerstvá inštalácia, nulové poverenia — `auto` už funguje:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
Preferujete špecifický bezplatný backend? Zavolajte `oc/…` (OpenCode Free) priamo. Potom prejdite na `auto` a nechajte OmniRoute vybrať.📦 Skripty pre rýchly štart na kopírovanie a vkladanie 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 — stačí použiť `auto`
Nemusíte vytvárať žiadne kombo. Nastavte model na `auto` (alebo niektorý variant) a OmniRoute vytvorí virtuálne kombo z vašich pripojených poskytovateľov, ktoré priebežne vyhodnocuje:
ID modelu
Čo optimalizuje
auto
🎯 Vyvážené predvolené nastavenie (LKGP — zostáva pri poslednom funkčnom 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 / limitu požiadaviek
auto/smart
🔭 Uprednostnenie kvality + 10 % prieskumu na objavovanie lepších modelov
auto/lkgp
📌 Explicitné zotrvanie pri poslednom známom funkčnom poskytovateľovi
auto/chaos
🧪 Váhy vkladania porúch na testovanie odolnosti (chaos engineering)
##
### 🔀 Alebo si vytvorte vlastné — 19 stratégií smerovania
Všetkých **19** stratégií — kombinujte ich podľa potreby v jednotlivých krokoch komba:
#
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 danom poradí
5
p2c
Náhodné vyvažovanie záťaže metódou výberu z dvoch možností
6
least-used
Vyberie cieľ s aktuálne najnižšou 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 — najprv krátke okná 📊
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
Pripne 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 — pripne sa k poslednému úspešnému poskytovateľovi a potom použije záložné pravidlá
17
auto
Priebežné vyhodnocovanie všetkých pripojení podľa 16 faktorov 🤖
18
fusion
Rozošle požiadavku panelu modelov a hodnotiaci model zlúči výsledky do jednej odpovede 🧬
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)
📖 [Automatický kombinovaný mechanizmus](docs/routing/AUTO-COMBO.md) · [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Čím sa OmniRoute odlišuje
📊 Kompletná metodológia & detail funkcií vs 9router, OpenRouter, CLIProxyAPI & 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 zmeny 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 centra s hlasovým chatom Faro typu 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é chatové požiadavky sa namiesto odpovede 503 zaraďujú do frontu, pričom pre každé pripojenie používajú 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 pripnuté ako prvé), stabilný naprieč všetkými zdrojmi katalógu. → [Referenčná príručka 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)
- **💸 Poctivé náklady pri paušálnej sadzbe** — poskytovatelia s predplatným alebo programátorským plánom vykazujú v analytike nákladov **$0**; rozpočet, kvóta a smerovanie naďalej používajú odhady. → [Referenčná príručka API](docs/reference/API_REFERENCE.md)
- **⚖️ Smerovanie podľa podielu kvóty** — spravodlivo rozdeľuje kvótu zdieľaného účtu medzi združené kľúče a zachováva využitie kapacity tým, že nečinné podiely požičiava ostatným. → [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Nastavenie CLI/agenta jediný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 + posudzovateľ), smerovanie zohľadňujúce úlohu, prepísanie modelu / režimu / rozpočtu v USD pre jednotlivé požiadavky. → [Automatické kombinácie](docs/routing/AUTO-COMBO.md)
- **🗜️ Rozšíriteľná kompresia** — 12 kombinovateľných mechanizmov + Compression Studios: LLMLingua-2, dvojúrovňové Ultra, omniglyph, kontrola vernosti pre každý krok, GCF v3.2, editor s presúvaním položiek. → [Kompresia](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transparentné dešifrovanie MITM (TPROXY)** — zachytávajte rozhrania CLI, ktoré ignorujú premenné prostredia proxy, pomocou certifikačnej autority pre jednotlivé SNI a inštalátora úložiska dôveryhodných certifikátov. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Telemetria nákladov všade** — hlavičky nákladov/využitia `X-OmniRoute-*` na každom koncovom bode, hlavička úspor pri zásahu vyrovnávacej pamäte, kvóty výdavkov v USD pre jednotlivé kľúče. → [Referenčná príručka 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 injekciou promptov na každej trase LLM (balík testov red-team), voliteľná ochrana maskovaním prihlasovacích údajov (rediguje uniknuté kľúče API/tajné údaje v oboch smeroch), bezplatné webové vyhľadávanie 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ú ponuku multimediálnych funkcií. → [Referenčná príručka API](docs/reference/API_REFERENCE.md)
- **🎨 Generovanie obrázkov / videa / zvuku** — jedno API pre médiá: xAI Grok Imagine a Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind a poskytovatelia hlasových služieb, ako je ElevenLabs. → [Referenčná príručka API](docs/reference/API_REFERENCE.md)
- **🌍 Nasadzovanie a prevádzka** — `basePath` reverzného proxy, automatická detekcia jazyka prehliadača, sledovanie zariadení pre jednotlivé kľúče, dôveryhodnosť MITM bez oprávnení používateľa root, 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 + 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` s názvom stratégie, poskytovateľa a latenciou, ktoré ju obslúžili; nová kombinovaná stratégia `cache-optimized` + faktor `cacheAffinity` automatických kombinácií smerujú opakované požiadavky späť do pripojenia, ktoré uchováva predponu vo vyrovnávacej pamäti, a koncový bod `/v1/auto-combo/{channel}/candidates` iba na čítanie sprístupňuje aktuálnu množinu kandidátov kanála `auto/*`. → [Automatické kombinácie](docs/routing/AUTO-COMBO.md)
- **⚡ Lokálny výkon a infraštruktúra** — lokálny Redis na jedno kliknutie, nástroje na nasadzovanie relé Cloudflare Workers / Deno Deploy, Bifrost a Mux ako kontrolované vstavané služby. → [Vstavané služby](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Súčasťou balíka je aj** — framework doplnkov + trhovisko, 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 protokolov do BigQuery, vkladanie chýb `auto/chaos`, most k botovi 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)
## 🌐 357 poskytovateľov AI — 152 označených v katalógu ako bezplatné
> **357 registrovaných poskytovateľov** v rámci kanonických kolekcií pre chat, médiá, vyhľadávanie, lokálne služby, cloudových agentov a systém vrátane **152 poskytovateľov s metadátami vyhľadávania `hasFree: true`**. Register chatovacích modelov zahŕňa **229 poskytovateľov / 2 554 jedinečných dvojíc poskytovateľ–model / 1 283 nespracovaných ID modelov**; samostatný katalóg bezplatných rozpočtov obsahuje **491 riadkov jednotlivých modelov**, **35 obnovovaných fondov** a **54 obnovovaných poskytovateľov alebo poskytovateľov navždy zdarma bez potreby kľúča**. Tieto menovatele sa zámerne líšia; definície a výpočty s deduplikovanými fondmi nájdete v dokumentoch [Referenčná príručka poskytovateľov](docs/reference/PROVIDER_REFERENCE.md) a [Bezplatné úrovne](docs/reference/FREE_TIERS.md).
### 🏢 Každé významné laboratórium — 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 naživo z katalógu poskytovateľov na informačnom paneli. 📖 [Referenčná príručka poskytovateľov](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Navždy zdarma — 0 $, bez karty
OpenCode Zen DeepSeek V4, Nemotron 3 Bez limitu tokenov
Kilo Code Automatický smerovač, 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ý žiadny kľúč
Cloudflare AI Viac ako 50 modelov 10K neurónov/deň
> 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 enginy pracujú s rovnakými dátami 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é dáta sú mechanizmom zachovania **vždy chránené**.
> **Prečo používať veľa tokenov, keď ich stačí málo?** Každá požiadavka prechádza kompresným pipeline OmniRoute **transparentne** — bez zmien na strane klienta. Teraz ide o **sadu 12 kombinovateľných enginov**, ktoré sa spúšťajú v poradí a dajú sa ľubovoľne kombinovať pre každú smerovaciu kombináciu — pričom vychádzajú z myšlienok projektov [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90 tis.+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) a [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 Sada 12 enginov
Enginy sa spúšťajú v poradí pipeline; každý možno nezávisle zapnúť alebo vypnúť a nakonfigurovať pre jednotlivé kombinácie:
#
Engine
Čo robí
1
Session-Dedup
Odstraňuje obsah opakujúci sa medzi jednotlivými ťahmi (adresovaný podľa obsahu, naprieč ťahmi)
2
CCR
Archivuje veľké bloky za značkami na načítanie a podľa potreby ich vyvoláva
3
Lite
Odstraňuje nadbytočné medzery a skracuje adresy 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)
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 + postupné skracovanie starších ťahov
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í s Anthropic; transformátory GPT 5.6 zostávajú až do prijatia potvrdení poskytovateľa bezpečne zablokované. Š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é dáta sa **vždy zachovávajú** presne po bajtoch. **Predvoľby na jedno kliknutie** kombinujú jednotlivé enginy:
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 využívaním nástrojov
🔥 Ultra
~75 %
Maximálna úspora
🧰 RTK
60–90 %
Výstupy shellu, testov, zostavení a gitu
🔗 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 opätovne vykresľuje, je pravdepodobne to, že pri každom cykle vykresľovania vytvárate nový odkaz na objekt. Keď ako prop odovzdáte objekt definovaný priamo na mieste, 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. Objekt prop definovaný priamo na mieste = nový odkaz = opätovné vykreslenie. Použite useMemo.“_
>
> **Rovnaká odpoveď. O 72 % menej tokenov. Žiadna strata presnosti.** ✅
**Príklad PT-BR — režim [Troglodita](https://github.com/leninejunior/troglodita):**
> **Predtým (42 tokenov):** _„Problém je v tom, že komponent sa 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 ide **von**:
- **🪄 Štýly výstupu** _(usmerňovanie výstupnej osi)_ — vkladajú deterministické inštrukcie na formovanie odpovedí, ktoré sú bezpečné pre cache; 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ť vatu / členy / vyhýbavé formulácie; zachovať presný technický obsah.
- **Menej kódu** — YAGNI v štýle „lenivého senior vývojára“: najmenšia funkčná zmena, žiadna nevyžiadaná infraštruktúra.
- **Ponytail (lenivý senior vývojár)** — postupovať po rebríčku YAGNI, opraviť základnú príčinu, najmenší funkčný diff.
- **Mám ADHD (najprv akcia)** — začať ďalšou akciou, očíslovať kroky, uviesť jeden konkrétny nasledujúci krok, bez úvodu.
- **Stručná CJK (文言)** — ultr stručný štýl klasickej čínštiny (obmedzený na locale `zh`).
- **🎯 Adaptívny rozpočet kontextu** _(regulátor)_ — namiesto jednej zapínateľnej/vypínateľnej hranice tokenov stupňuje najlacnejšie enginy s najmenšou stratovosťou iba natoľko, aby sa vstup **zmestil do kontextového okna modelu**. Stratégia: `reserve-output` (predvolená, zohľadňuje model) · `percentage` · `absolute`. Režim: `floor` (zaručí, že sa vstup zmestí) · `replace-autotrigger` (vaša explicitná voľba má prednosť) · `off` (staršia hranica).
- **🎛️ Kde sa rozhoduje o kompresii** _(precedencia, vysoká → nízka)_ — hlavička `x-omniroute-compression` konkrétnej požiadavky › prepísanie kombináciou 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=`.
Použite automatické spustenie podľa hranice tokenov, zapnite adaptívny regulátor, 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 danému pracovnému zaťaženiu. Voliteľný offline **evaluačný nástroj** (`npm run eval:compression`) pred nasadením zmeny vyhodnotí na pripnutom korpuse vernosť voči úspore.
📖 [`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) Nainštalujte a spustite**
```bash
npm install -g omniroute
omniroute
```
> 💡 Zobrazuje sa `npm warn ERESOLVE` alebo upozornenie na peer závislosti? [Sú neškodné](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
Ovládací panel je na adrese `http://localhost:20128` · API na adrese `http://localhost:20128/v1`.
**2) Pripojte BEZPLATNÉHO poskytovateľa (bez registrácie)**
Ovládací panel → **Poskytovatelia** → pripojte **Kiro AI** (Claude zdarma, ~50 kreditov mesačne na účet) alebo **OpenCode Free** (bez overovania) → hotovo.
**3) Nasmerujte svoj programátorský nástroj**
```txt
Základná URL: http://localhost:20128/v1
Kľúč API: [skopírujte z Ovládací panel → Koncové body]
Model: auto (inteligentné smerovanie bez konfigurácie — alebo ľubovoľný poskytovateľ/model)
```
**4) Overte funkčnosť**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Mal by sa zobraziť zoznam vašich pripojených modelov. 🎉 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 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 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.51 · Node ≥22.22.2 · Licencia MIT · omniroute.online
> Animovaný súhrn aktuálnej stránky `/dashboard/free-tiers`. Kompletná metodika (deduplikácia 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** — ak poskytovateľ ukončí bezplatnú úroveň, číslo klesne; ak 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
# Čerstvá inštalácia, nulové poverenia — `auto` už funguje:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
Preferujete špecifický bezplatný backend? Zavolajte `oc/…` (OpenCode Free) priamo. Potom prejdite na `auto` a nechajte OmniRoute vybrať.
📦 Skripty pre rýchly štart na kopírovanie a vkladanie pre **Python, Node.js, PHP a cURL** → [`examples/quickstart/`](examples/quickstart/)
> **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 — stačí použiť `auto`
Nemusíte vytvárať žiadne kombo. Nastavte model na `auto` (alebo niektorý variant) a OmniRoute vytvorí virtuálne kombo z vašich pripojených poskytovateľov, ktoré priebežne vyhodnocuje:
📖 [Automatický kombinovaný mechanizmus](docs/routing/AUTO-COMBO.md) · [Sprievodca odolnosťou](docs/architecture/RESILIENCE_GUIDE.md)
📊 Kompletná metodológia & detail funkcií vs 9router, OpenRouter, CLIProxyAPI & 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 enginy pracujú s rovnakými dátami 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é dáta sú mechanizmom zachovania **vždy chránené**.
> **Prečo používať veľa tokenov, keď ich stačí málo?** Každá požiadavka prechádza kompresným pipeline OmniRoute **transparentne** — bez zmien na strane klienta. Teraz ide o **sadu 12 kombinovateľných enginov**, ktoré sa spúšťajú v poradí a dajú sa ľubovoľne kombinovať pre každú smerovaciu kombináciu — pričom vychádzajú z myšlienok projektov [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90 tis.+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) a [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 Sada 12 enginov
Enginy sa spúšťajú v poradí pipeline; každý možno nezávisle zapnúť alebo vypnúť a nakonfigurovať pre jednotlivé kombinácie:
