## 💰 ~1,62 mld. tokenů / měsíc napříč bezplatnými tarify třetích stran
> **Použijte vlastní účty u poskytovatelů.** Jde o odhadovaný souhrn samostatně dostupných bezplatných tarifů třetích stran, nikoli o příděl tokenů od OmniRoute. Zaregistrujte se, v případě potřeby získejte přihlašovací údaje a připojte poskytovatele, které můžete používat; každý poskytovatel si určuje vlastní limity, dostupnost a podmínky.
>
> Ruční kombinování bezplatných tarifů je náročné — desítky SDK, desítky limitů požadavků a žádný přehled o tom, kolik kapacity skutečně máte. OmniRoute katalogizuje **489 položek bezplatných tarifů v rámci 35 opakujících se klíčů fondů** a vypočítává celkový počet tokenů ze **17 fondů se zveřejněným kladným měsíčním rozpočtem a pěti limitů Groq pro jednotlivé modely**, přičemž odstraňuje duplicity podle sdíleného fondu. Kvóty, které se zpřístupní až po regionálním ověření identity (aktuálně: ModelScope), jsou uvedeny samostatně jako +~6M za regionálním ověřením identity a nikdy se nezapočítávají do hlavního údaje. Výsledek zůstává viditelný na řídicím panelu (`/dashboard/free-tiers`).
> Animovaný souhrn živé stránky `/dashboard/free-tiers`. Úplná metodika (odstraňování duplicit fondů, úrovně kreditů, podmínky poskytovatelů): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Tyto údaje každé dva týdny znovu ověřujeme podle aktuálního katalogu a **mohou se měnit oběma směry** — když poskytovatel ukončí bezplatný tarif, číslo klesne; když přibude nový, vzroste. Zveřejňujeme to, co katalog skutečně vypočítá, nikdy nikoli zaokrouhlený nejlepší možný scénář.
⭐ Pokud vám OMNIROUTE pomohl ušetřit peníze a usnadnil práci, označte repozitář hvězdičkou.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Připojte se ke komunitě
**👋 Sledujte správce projektu — získejte informace o nových poskytovatelích, vydáních a tipech jako první:**
[](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)
**Dotazy, tipy na poskytovatele, plán vývoje a podpora → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globální](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazílie](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 se stále rozrůstá
## 🆓 Nainstalujte, připojte poskytovatele a poté směrujte přes jeden koncový bod
```bash
# Po připojení poskytovatele zkopírujte svůj klíč OmniRoute z Dashboard → Endpoints:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` vyžaduje podporovanou trasu. Nová instalace nemusí mít žádné podporované cíle bez klíče a poskytovatel bez klíče může odmítnout klienty třetích stran. Poskytovatelé označení `tos: avoid`, včetně OpenCode Free a Kiro, jsou ve výchozím nastavení z automatického směrování vyloučeni; připojení účtu toto nastavení nemění. Před výběrem poskytovatele si přečtěte [Průvodce bezplatnými úrovněmi](docs/getting-started/FREE-TIERS-GUIDE.md).📦 Zkopírovatelné skripty pro rychlý start v jazycích **Python, Node.js, PHP a cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Příslib
# 🤔 Proč OmniRoute?
## 🤝 Podporováno našimi přáteli open source
> **Chcete se přidat jako přítel open source?** Toto jsou společnosti, které podporují open source a pomáhají udržovat OmniRoute v chodu — a my veřejně uvádíme, na co je použit každý token, který nám poskytnou. Ozvěte se nám: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Děkujeme společnosti Kimi (Moonshot AI), našemu zakládajícímu příteli open source, za podporu tohoto projektu! Kimi je laboratoř AI stojící za rodinami modelů s otevřenými váhami K2 a K3 — Kimi K3 nabízí kontextové okno o 1 milionu tokenů, nativní zpracování obrazu a špičkové schopnosti programování za zlomek ceny uzavřených modelů a ihned funguje s Claude Code, Codex a všemi programovacími nástroji, které OmniRoute obsluhuje.
Co umožňuje podpora od Kimi: Kredity API od Kimi pohánějí vydávací proces OmniRoute ověřovaný umělou inteligencí — fázi ověření sloučení využívající Kimi K3, která kontroluje každý požadavek na začlenění změn před jeho vydáním — a také každodenní vývoj funkcí. Plnohodnotná podpora Kimi je dostupná oběma způsoby: přes přímé Kimi API (kimi-k3) i přes programovací tarif Kimi Code (OAuth a klíč API). OmniRoute je také prvním brazilským open-source projektem v programu podpory Kimi. Získejte klíč Kimi API s 15 % kreditů navíc →
Cheaper Inference cheaperinference.com
Děkujeme společnosti Cheaper Inference, příteli open source projektu OmniRoute, za podporu tohoto projektu! Cheaper Inference je brána řazená podle nákladů, která prostřednictvím jediného koncového bodu kompatibilního s OpenAI přeprodává 42 špičkových modelů — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok a MiniMax — a každý požadavek směruje k nejlevnějšímu vyhovujícímu poskytovateli, aniž by kdy účtovala více než katalogovou cenu tvůrce modelu.
Plnohodnotná podpora v OmniRoute: Chat Completions, nativní koncový bod /v1/responses, zpracování obrazu, volání nástrojů a 3 obrazové modely (grok-imagine, nano-banana-pro, nano-banana-2, dostupné jako cheaperinference/<model>). Získejte klíč API →
Odkazy označené parametrem aff=omniroute jsou partnerské odkazy. Financují projekt bez jakýchkoli dodatečných nákladů pro vás. 🎟️ Partnerské nabídky — bezplatné registrační kupóny od poskytovatelů, které nesponzorujeme (kliknutím rozbalíte)Tato část je určena pouze pro doporučující a kupónové kódy. Sponzorovaná partnerství jsou uvedena výše v části 🤝 Podporováno našimi přáteli open source. OmniRoute nemá s poskytovateli uvedenými zde žádný sponzorský ani partnerský vztah — jedná se o veřejné kupóny, které může využít kdokoli.
AgentRouter agentrouter.org
AgentRouter — partnerská registrace · bezplatné kredity v hodnotě $100 při registraci (bezplatný server, počítejte s vyšší latencí — nejvhodnější pro testování, nikoli pro produkční prostředí). Plnohodnotná podpora v OmniRoute od verze v3.8.50: Chat Completions, formát přenosu kompatibilní s Anthropic a cesta kompatibilní s OpenAI. Mezi dostupné modely patří claude-opus-4-8, claude-opus-5, gpt-5.6-sol a další. Získejte svých $100 →
⚠️ Partnerský odkaz — OmniRoute nemá s tímto poskytovatelem žádný sponzorský ani partnerský vztah.
Znáte jiného poskytovatele se štědrým bezplatným registračním kupónem, který by byl přínosem pro uživatele OmniRoute? Otevřete issue a my ho sem přidáme.
## 🎯 Kombinace — vlajková funkce
> **Kombinace** je řetězec modelů, mezi kterými OmniRoute směruje požadavky **automaticky**. Pokud dojde kvóta, poskytovatel selže nebo prudce vzrostou náklady, kombinace může přejít na další vhodný a funkční model. 🛡️
### ⚡ Bez konfigurace — stačí použít `auto`
Není třeba vytvářet žádnou kombinaci. Nastavte model na `auto` (nebo některou z jeho variant) a OmniRoute vytvoří virtuální kombinaci z vašich připojených poskytovatelů, které průběžně vyhodnocuje:
ID modelu
Co optimalizuje
auto
🎯 Vyvážené výchozí nastavení (LKGP — zůstává u posledního funkčního poskytovatele)
auto/coding
🧑💻 Váhy upřednostňující kvalitu při generování kódu
auto/fast
⚡ Nejprve nejnižší latence
auto/cheap
💰 Nejprve nejnižší cena za token
auto/offline
🔋 Nejprve největší rezerva kvóty / limitu požadavků
auto/smart
🔭 Upřednostnění kvality + 10% průzkum pro objevování lepších modelů
auto/lkgp
📌 Výslovné zachování posledního známého funkčního poskytovatele
auto/chaos
🧪 Paralelní rozeslání panelu modelů (jeden na poskytovatele, ve výchozím nastavení 5), které vrátí jednu odpověď; jedno upstreamové volání pro každý model v panelu, nikoli vkládání chyb
##
### 🔀 Nebo si vytvořte vlastní — 19 strategií směrování
Všech **19** strategií — libovolně je kombinujte v jednotlivých krocích kombinace:
#
Strategie
Co dělá
1
priority
Seřazený seznam s prvním cílem jako prioritou — každý se vyčerpá před přechodem na další 🥇
2
fill-first
Před přechodem na další cíl plně vyčerpá kvótu aktuálního cíle
3
weighted
Vážený náhodný výběr podle váhy jednotlivých cílů
4
round-robin
Postupně cykluje mezi cíli v daném pořadí
5
p2c
Náhodné vyvažování zátěže metodou výběru ze dvou možností
6
least-used
Vybere cíl s nejnižší aktuální zátěží
7
random
Rovnoměrný náhodný výběr (bez duplicit)
8
strict-random
Náhodný výběr bez odstraňování opakování 🎲
9
cost-optimized
Minimalizuje cenu v $ za požadavek podle aktuálních cen z katalogu 💸
10
headroom
Vybere cíl s největší zbývající kvótou
11
reset-window
Upřednostní cíl, jehož okno kvóty se obnoví nejdříve
12
reset-aware
Seřadí cíle podle času obnovení kvóty — nejprve krátká okna 📊
13
context-relay
Předává kontext mezi cíli při dlouhých konverzacích 🧠
14
context-optimized
Vybere cíl, který nejlépe odpovídá aktuální velikosti kontextu
15
cache-optimized
Přiřadí každý opakovaně použitelný prefix promptu ke stejnému účtu — maximalizuje zásahy do mezipaměti promptů 🎯
16
lkgp
Poslední známá funkční cesta — zůstává u posledního úspěšného poskytovatele a poté přechází na záložní pravidla
17
auto
Průběžné hodnocení každého připojení podle 16 faktorů 🤖
18
fusion
Rozešle požadavek panelu modelů a hodnoticí model sloučí výsledky do jedné odpovědi 🧬
19
pipeline
Řetězí kroky — výstup každého cíle se předává následujícímu 🔗
Modul Auto-Combo hodnotí každého kandidáta podle **16 faktorů** (stav, kvóta, náklady, latence, vhodnost pro úlohu, kvalita, dostupnost relace…) — viz [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Odolnost je integrovaná (3 nezávislé vrstvy)
📖 [Modul automatických kombinací](docs/routing/AUTO-COMBO.md) · [Průvodce odolností](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Čím OmniRoute vyniká
📊 Kompletní metodika & podrobnosti o jednotlivých funkcích v porovnání s 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Podpořte OmniRoute
OmniRoute je licencován pod licencí MIT a vyvíjen otevřeně. Pokud vám šetří čas nebo peníze, zde jsou možnosti, jak mu pomoci zachovat nezávislost — vyberte si, co vám vyhovuje. Sponzorství nikdy neovlivňuje prioritu směrování; kupuje viditelnost, nikoli pořadí.
⚠️ Každou měnu posílejte pouze prostřednictvím uvedené sítě — při odeslání přes nesprávnou síť můžete o prostředky přijít.
🐛 Našli jste chybu nebo máte zpětnou vazbu? Otevřete [diskusi](https://github.com/diegosouzapw/OmniRoute/discussions).
Poznámky pro vývojáře: Projekt může během npm install/postinstall pro pohodlí vývojářů vygenerovat místní soubor .env. Tento soubor je záměrně ignorován prostřednictvím .gitignore (viz .gitignore) a nikdy nesmí být zahrnut do commitu — pokud k tomu dojde omylem, změňte všechny odhalené tajné údaje a odstraňte soubor z historie. Pokyny ke správě místních souborů prostředí a tajných údajů naleznete v docs/DEVELOPER-ENVIRONMENT.md.
## 📡 OmniRoute Radar
Hlavním údajem pro bezplatnou úroveň zůstává **~1.62B tokenů/měsíc** z výše uvedeného zdokumentovaného katalogu
s odstraněnými duplicitami mezi fondy. Dočasné kredity za registraci u poskytovatelů mohou objem v prvním
měsíci samostatně zvýšit na **~2.22B**. Radar je volitelná podepsaná překryvná vrstva katalogu pro uživatele, kteří chtějí
aktuálnější informace o dostupnosti bezplatných modelů mezi jednotlivými vydáními OmniRoute; komunitní katalog i všechny stávající bezplatné
funkce zůstávají zdarma.
Podporovatelé mohou získat živý katalog a další možnosti od poskytovatelů. Jeho samostatný,
proměnlivý strop činí **nanejvýš přibližně 3B tokenů/měsíc** v závislosti na dostupnosti poskytovatelů.
Tento strop není zaručen: poskytovatelé mohou kdykoli změnit kvóty, podmínky způsobilosti, modely nebo regiony.
Radar je volitelný a používá pouze požadavky GET. Klient OmniRoute nenahrává prompty, provoz, konfiguraci
poskytovatelů, telemetrii využití ani místní stav skrytí oznámení. Informace o podmínkách způsobilosti a
aktuálním katalogu najdete na **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Co je nového
> Přehled nejnovějších změn od **v3.8.20 → v3.8.50**. Úplnou historii najdete v souboru [`CHANGELOG.md`](CHANGELOG.md).
- **🎛️ OmniConductor** — příchozí delegování A2A do vaší flotily agentů, dovednosti Conductor na kartě agenta a panel řídicího centra s hlasovým chatem Faro typu push-to-talk. → [Server A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptivní řízení příjmu a ochrana proti přetížení** — výpočetně náročné chatovací požadavky se namísto vrácení chyby 503 zařadí do fronty, s atomickými průběžnými pronájmy RPM pro jednotlivá připojení. → [Průvodce odolností](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonické řazení `/v1/models`** — jeden souvislý blok seskupený podle poskytovatele pro každého poskytovatele (kombinace jsou připnuté jako první), stabilní napříč všemi zdroji katalogu. → [Referenční příručka API](docs/reference/API_REFERENCE.md)
- **🗜️ Posílení komprese** — ve výchozím nastavení zapnutá ochrana proti nadměrné dekompresi, balíčky Caveman pro DE / FR / JA + čínštinu (wényán), filtry RTK pro Gradle a .NET. → [Komprese](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Poctivé náklady s pevnou sazbou** — poskytovatelé s předplatným / tarifem pro programování vykazují v analýze nákladů **$0**; odhady rozpočtu, kvót a směrování zůstávají zachovány. → [Referenční příručka API](docs/reference/API_REFERENCE.md)
- **⚖️ Směrování Quota-Share** — spravedlivě rozděluje kvótu sdíleného účtu mezi sdružené klíče a díky efektivnímu využití kapacity propůjčuje nevyužité podíly ostatním. → [Průvodce odolností](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Nastavení CLI/agentů jediným příkazem** — 13 registrovaných příkazů `setup-*`; `omniroute run` spouští 7 rozhraní CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podporuje 10 cílů s interaktivním výběrem poskytovatele a modelu a oblíbenými položkami pro jednotlivé kontexty. → [Integrace CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Vzdálený režim** — ovládejte vzdálenou instanci OmniRoute pomocí tokenů s omezeným rozsahem (`connect` / `contexts` / `tokens`) a pomocníka OAuth `antigravity` pro instalace na VPS. → [Vzdálený režim](docs/guides/REMOTE-MODE.md)
- **🧭 Chytřejší automatické směrování** — kombinace `auto/:`, **Fusion** (panel modelů + hodnotitel), směrování zohledňující úlohu a přepsání modelu / režimu / rozpočtu v USD pro jednotlivé požadavky. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Modulární komprese** — 12 kombinovatelných modulů + Compression Studios: LLMLingua-2, dvouúrovňový režim Ultra, omniglyph, kontrola věrnosti v každém kroku, GCF v3.2 a editor s přeskupováním přetažením. → [Komprese](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transparentní dešifrování MITM (TPROXY)** — zachytává provoz rozhraní CLI, která ignorují proměnné prostředí proxy, s certifikační autoritou pro jednotlivé SNI a instalačním nástrojem úložiště důvěryhodných certifikátů. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Telemetrie nákladů všude** — hlavičky nákladů/využití `X-OmniRoute-*` na každém koncovém bodu, hlavička úspor při zásahu do mezipaměti a kvóty výdajů v USD pro jednotlivé klíče. → [Referenční příručka API](docs/reference/API_REFERENCE.md)
- **🧠 Paměť pod vaší kontrolou** — ve výchozím nastavení vypnutá, volitelná kvantizace vektorů int8 + typovaný útlum, `x-omniroute-no-memory` pro jednotlivé požadavky. → [Paměť](docs/frameworks/MEMORY.md)
- **🛡️ Zabezpečení** — ochrana proti vkládání instrukcí do promptů na každé trase LLM (sada testů red-team), volitelná ochrana maskující přihlašovací údaje (rediguje uniklé klíče API/tajné údaje v obou směrech), bezplatné webové vyhledávání DuckDuckGo jako poslední možnost a volitelná přihlašovací brána OIDC pro řídicí centrum (přihlášení heslem zůstává vždy dostupné). → [Ochranná opatření](docs/security/GUARDRAILS.md)
- **🖼️ Nové koncové body** — `/v1/ocr` (Mistral OCR) a `/v1/audio/translations` (ve stylu Whisper) doplňují podporu médií. → [Referenční příručka API](docs/reference/API_REFERENCE.md)
- **🎨 Generování obrázků / videa / zvuku** — jedno API pro média: xAI Grok Imagine a video Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind a poskytovatelé řeči, jako je ElevenLabs. → [Referenční příručka API](docs/reference/API_REFERENCE.md)
- **🌍 Nasazení a provoz** — `basePath` reverzní proxy, automatická detekce jazyka prohlížeče, sledování zařízení pro jednotlivé klíče, důvěryhodnost MITM bez oprávnění roota, lokalizace zh-TW. → [Prostředí](docs/reference/ENVIRONMENT.md)
- **🤝 Více poskytovatelů a agentů** — cloudoví agenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) s prohlížečem + přihlášením OAuth, plnohodnotná karta Ollama, Claude Opus 5 a Sonnet 5, oficiální partnerství s Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… a aktualizovaný **katalog 352 poskytovatelů**. → [Poskytovatelé](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Transparentnost směrování** — každá odpověď obsahuje hlavičku `X-OmniRoute-Decision` uvádějící strategii/poskytovatele/latenci, které ji obsloužily; nová kombinovaná strategie `cache-optimized` + faktor Auto-Combo `cacheAffinity` směrují opakované požadavky zpět k připojení, které uchovává prefix v mezipaměti, a koncový bod pouze pro čtení `/v1/auto-combo/{channel}/candidates` zpřístupňuje aktuální fond kandidátů kanálu `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Lokální výkon a infrastruktura** — lokální Redis na jedno kliknutí, nástroje pro nasazení přenosových služeb Cloudflare Workers / Deno Deploy, Bifrost a Mux jako řízené vestavěné služby. → [Vestavěné služby](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Součástí balení je také** — framework zásuvných modulů + tržiště, frameworky dovedností Omni/Agent/GitHub, integrace trezoru Obsidian (22 nástrojů MCP), rozhraní API Batch a Files kompatibilní s OpenAI, sémantická mezipaměť odpovědí, gamifikace s žebříčky, vyhledávání agentů ACP (15 integrovaných agentů), plánovaný export protokolů do BigQuery, paralelní rozesílání do více modelů `auto/chaos`, propojení s botem Telegram, správce verzí v aplikaci a žebříčky bezplatných poskytovatelů LMArena-ELO. → [Dokumentace](docs/README.md)
## 🤖 Kompatibilní nástroje CLI a programovací agenti
> Jedna konfigurace — `http://localhost:20128/v1` — a **každé** AI IDE či CLI běží na bezplatných a nízkonákladových modelech.
＋ funguje také s · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · jakýmkoli nástrojem kompatibilním s OpenAI
📖 Nastavení jednotlivých nástrojů pro všech 36 nástrojů (26 nástrojů CLI Code + 10 agentů CLI) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Spusťte libovolné podporované CLI prostřednictvím OmniRoute jediným příkazem** — bez zápisu konfiguračních souborů,
přihlašovací údaje se předají pouze danému procesu a Qwen/Gemini získají dočasný izolovaný domovský adresář:
```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"
# Nebo interaktivně vyberte poskytovatele a model a zapište vlastní konfiguraci nástroje:
omniroute configure codex # také: claude opencode qwen aider goose gemini cline continue kilo
```
Každý příkaz respektuje aktivní vzdálený kontext (`omniroute connect `), `--dry-run`
zobrazí náhled přesného prostředí a argumentů bez spuštění a `--api-key-env NAME` zabrání
uložení tajných údajů do historie shellu. → [Integrace CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 poskytovatelů AI — 154 označených v katalogu jako bezplatní
> **372 registrovaných poskytovatelů** napříč kanonickými kolekcemi pro chat, média, vyhledávání, lokální prostředí, cloudové agenty a systémové služby, včetně **154 poskytovatelů s metadaty pro vyhledávání `hasFree: true`**. Registr chatovacích modelů zahrnuje **237 poskytovatelů / 3 009 jedinečných dvojic poskytovatel–model / 1 443 nezpracovaných ID modelů**; samostatný katalog bezplatných rozpočtů obsahuje **491 řádků pro jednotlivé modely**, **35 opakovaně doplňovaných fondů** a **54 trvale bezplatných poskytovatelů s opakovaným přídělem nebo bez nutnosti klíče**. Tyto jmenovatele se záměrně liší; definice a výpočty s odstraněním duplicit mezi fondy najdete v dokumentech [Přehled poskytovatelů](docs/reference/PROVIDER_REFERENCE.md) a [Bezplatné úrovně](docs/reference/FREE_TIERS.md).
### 🏢 Všechny významné laboratoře — prostřednictvím jediné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 více než 330 dalších — každá ikona se načítá živě z katalogu poskytovatelů na řídicím panelu. 📖 [Přehled poskytovatelů](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Navždy zdarma — $0, bez karty
OpenCode Zen DeepSeek V4, Nemotron 3 Bez omezení tokenů
Kilo Code Automatický směrovač, Tencent Hy3 Navždy zdarma
Requesty GPT-OSS 120B, Nemotron Navždy zdarma
SiliconFlow DeepSeek V3.2 / R1 Bezplatná úroveň
Z.AI GLM GLM-4.7 / 4.5-Flash Navždy zdarma
Baidu ERNIE ERNIE 4.0 Navždy zdarma
Qoder AI Qwen3-Max, Kimi-K2 ZDARMA bez omezení
Pollinations GPT, Llama, Claude Klíč není potřeba
Cloudflare AI Více než 50 modelů 10 tis. neuronů/den
NVIDIA NIM GLM, MiniMax ~40 RPM zdarma
Cerebras GLM 4.7, GPT-OSS Jednorázový kredit 5 $; vyžadována karta
### 🧩 Novinka: OmniRoute přímo v nativním Copilot Chatu ve VS Code
> Žádný nový postranní panel, žádné nové chatovací rozhraní — každý model poskytovaný OmniRoute se zobrazí přímo ve
> **výběru modelu Copilot Chat, který už používáte**. Od VS Code 1.122 fungují modely poskytovatelů
> bez přihlášení ke GitHubu i bez předplatného Copilot — režim agenta, volání nástrojů a zpracování obrazu,
> zdarma.
Nainstalujte rozšíření **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, nasměrujte jej
na svůj server OmniRoute (ve výchozím nastavení `localhost:20128`) a poté otevřete Copilot Chat → výběr modelu
→ **Spravovat modely…** → **OmniRoute**.
Přímo v editoru otevřete zobrazení **Rozšíření**, vyhledejte **„OmniRoute“** a klikněte na **Nainstalovat**
— v obou obchodech vše funguje stejně. Zdrojový kód, hlášení problémů a postup publikování najdete na
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [Průvodce VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — nastavení, obsah výběru modelu, řídicí panel na kartě, řešení problémů
### 🎩 Novinka: OmniRouteTray — vaše brána přímo v řádku nabídek
> `omniroute serve` funguje nejlépe, když je neustále spuštěný. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> z něj dělá bezúdržbovou aplikaci pro řádek nabídek systému macOS: spouští server, udržuje jej v chodu
> i po restartu, aktualizuje jej na místě a zpřístupňuje váš aktuální rozpočet tokenů jediným kliknutím — **bez
> otevřeného okna terminálu a bez nutnosti dohlížet na `npm install -g omniroute`.**
Je vytvořen pomocí [Tauri v2](https://v2.tauri.app/) (jádro v Rustu zanedbatelné velikosti), obsahuje
vlastní podepsané běhové prostředí Node 24 a spravuje instalaci OmniRoute vlastněnou aplikací, takže se nikdy nedostane do konfliktu s vaším
globálním `node`/`bun`. **Sdílí vaši stávající konfiguraci a databázi v `~/.omniroute/`** — jde tedy o
stejný OmniRoute, který už používáte, jen s kloboukem. 🎩
Co dělá
Jak
🟢 Dohlíží na server
Spouští omniroute serve a převezme již spuštěnou instanci, místo aby ji duplikoval
📊 Aktuální využití na první pohled
Ukazatele kvót poskytovatelů, limity relace a týdenní limity Claude s odpočtem do obnovení, přehled nákladů za 30 dní
🔄 Automaticky se aktualizuje na místě
Přípravná instalace, atomická výměna, návrat zpět při selhání — vždy používá nejnovější vydání
🚀 Spouští se při přihlášení
Volitelné spuštění při přihlášení; pouze v řádku nabídek, bez ikony v Docku
🩺 Diagnostika a protokoly
Diagnostika jedním kliknutím a přístup k protokolům serveru
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Dáváte přednost stažení? Získejte nejnovější soubor .dmg ze stránky
Vydání. Zdrojový kód, hlášení problémů a dokumentace
k sestavení jsou k dispozici v repozitáři zoispag/omniroute-tray.
💛 Komunitní projekt od @zoispag — nejde o oficiální vydání OmniRoute.
## 🔒 Soukromé a lokální především
📖 [Autorizace](docs/architecture/AUTHZ_GUIDE.md) · [Ochranná opatření](docs/security/GUARDRAILS.md) · [Soulad s předpisy](docs/security/COMPLIANCE.md)
## 🔌 Kompletní CLI + A2A a MCP
> Kromě serveru je OmniRoute **plnohodnotným ovládacím centrem pro příkazovou řádku** s **více než 80 příkazy** a otevřenými protokoly pro agenty, takže jej může AI agent ovládat **zcela samostatně**.
### ⌨️ Skutečné CLI (nejen `start`)
```bash
omniroute # spuštění brány + ovládacího panelu (port 20128)
omniroute chat # interaktivní chatovací klient TUI (lomítkové příkazy: /model /combo /skill /memory)
omniroute setup # průvodce prvním spuštěním
omniroute doctor # diagnostika poskytovatelů, portů a nativních závislostí
```
### 🛰️ Vzdálený režim — spusťte CLI zde a OmniRoute na VPS
Máte OmniRoute na serveru? Ovládejte jej z notebooku pomocí **stejného CLI**. Stačí se jednou přihlásit
pomocí přístupového tokenu s omezeným rozsahem; každý příkaz pak bude cílit na vzdálený server.
```bash
omniroute connect 192.168.0.15 # heslo → token s omezeným rozsahem, uložený jako kontext
omniroute models list # ← spustí se vůči VZDÁLENÉMU serveru
omniroute configure codex # ← vybere vzdálený model a zapíše lokální profil Codex
omniroute tokens create --name ci --scope read # vytvoří tokeny s užším rozsahem pro další počítače
omniroute contexts use default # ← přepne zpět na lokální server
```
Tokeny mají rozsah `read` / `write` / `admin`; trasy spouštějící procesy zůstávají dostupné pouze přes loopback.
📖 [Vzdálený režim](docs/guides/REMOTE-MODE.md)
### 🤝 Připojte agenta — a ten bude ovládat samotný OmniRoute
Zpřístupněte OmniRoute přes **MCP**, **A2A**, **REST API**, **webhooky** nebo **vzdálené CLI** — každý schopný agent (nebo váš vlastní kód) získá přístup k celé bráně: směrování, poskytovatelům, kombinacím, mezipaměti, kompresi i paměti — autonomně. Níže uvedené HTTP endpointy jsou dostupné pod adresou `http://localhost:20128`.
Rozhraní
Endpoint / příkaz
Použití
🧰 MCP (stdio)
omniroute --mcp
Připojení ke Claude Desktop, Cursoru nebo libovolnému klientovi MCP
Komunikace mezi agenty, JSON-RPC 2.0 + SSE, 6 dovedností
🌐 REST API
/v1/*
Kompatibilní s OpenAI — chat, embeddingy, obrázky, zvuk, OCR
🔔 Webhooky
/api/webhooks
Odesílání událostí požadavků / kvót do Slacku, Discordu, Telegramu nebo na libovolnou URL
🛰️ Vzdálené CLI
omniroute connect
Ovládání vzdálené instance pomocí přístupových tokenů s omezeným rozsahem
```bash
# Poskytněte Claude Code kompletní sadu nástrojů OmniRoute přes 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 pro agenty](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Ušetřete automaticky 15–95 % tokenů
### 📖 Jak to funguje — pipeline, architektura a výpočet úspor
Výchozí skládaná kombinace spouští `RTK → Caveman`. Když oba enginy zpracovávají stejný payload nástroje nebo kontextu, úspory se násobí:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Bloky kódu, URL, JSON a strukturovaná data jsou enginem pro zachování obsahu **vždy chráněny**.
> **Proč používat mnoho tokenů, když stačí jen několik?** Každý požadavek prochází kompresní pipeline OmniRoute **transparentně** — bez jakýchkoli změn na straně klienta. Nyní jde o **sadu 12 kombinovatelných enginů**, které se spouštějí v daném pořadí a lze je libovolně kombinovat pro jednotlivé směrovací kombinace — na základě myšlenek z projektů [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).
### 🧱 Sada 12 enginů
Enginy se spouštějí v pořadí pipeline; každý lze nezávisle zapnout či vypnout a nakonfigurovat pro jednotlivé kombinace:
#
Engine
Co dělá
1
Session-Dedup
Odstraňuje obsah opakovaný napříč interakcemi (adresovaný podle obsahu, napříč interakcemi)
2
CCR
Archivuje velké bloky za značkami pro načtení, odkud se načítají na vyžádání
3
Lite
Ořezávání bílých znaků a URL obrázků (základní varianta s nízkou latencí)
4
RTK
Inteligentní filtrování, deduplikace a zkracování výsledků nástrojů (s ohledem na příkazy)
5
Responses Tool Output
Primárně bezeztrátová komprese JSON a omezená diagnostická komprese výstupů shellu, patchů, vyhledávání a sestavení (Responses API)
Extrakční hodnocení vět podle posledního dotazu uživatele
8
Caveman
Komprese prózy založená na pravidlech (~65–75 % na výstupu)
9
Aggressive
Shrnutí a postupné stárnutí starých interakcí
10
LLMLingua-2
Sémantické prořezávání pomocí ML přes MobileBERT ONNX — bezpečné pro kód, asynchronní
11
Ultra
Heuristické prořezávání tokenů s volitelnou úrovní malého modelu (SLM)
12
OmniGlyph
Experimentální kódování kontextu jako obrázku pro měřený Claude Fable 5 při přímé komunikaci s Anthropic; transformery GPT 5.6 zůstávají bezpečně deaktivované do obdržení potvrzení od poskytovatele. Čtyři profily komprese (agresivní jako výchozí, vyvážený, bezpečný pro kód, bez úprav) (nejagresivnější; vyžaduje výslovné zapnutí)
Bloky kódu, URL a strukturovaná data jsou **vždy zachována** přesně na úrovni bajtů. **Předvolby na jedno kliknutí** kombinují jednotlivé enginy:
Režim
Úspora
Nejvhodnější pro
🪶 Lite
~15 %
Bezpečné výchozí nastavení pro trvalé použití
🪨 Standard (Caveman)
~30 %
Každodenní programování
⚡ Aggressive
~50 %
Dlouhé relace intenzivně využívající nástroje
🔥 Ultra
~75 %
Maximální úspora
🧰 RTK
60–90 %
Výstupy shellu, testů, sestavení a gitu
🔗 Stacked (RTK → Caveman)
78–95 %
Kombinované prompty a protokoly nástrojů
**Reálný příklad — režim Standard:**
> **Před kompresí (69 tokenů):** _„Důvodem, proč se vaše komponenta React znovu vykresluje, je pravděpodobně to, že při každém vykreslovacím cyklu vytváříte nový odkaz na objekt. Když předáte vložený objekt jako prop, mělké porovnání v Reactu jej pokaždé považuje za jiný objekt, což spustí nové vykreslení. Doporučuji použít useMemo k memoizaci objektu.“_
>
> **Po kompresi (19 tokenů):** _„Při každém vykreslení nový odkaz na objekt. Vložený objekt jako prop = nový odkaz = nové vykreslení. Obalte pomocí useMemo.“_
>
> **Stejná odpověď. O 72 % méně tokenů. Bez ztráty přesnosti.** ✅
**Příklad v PT-BR — režim [Troglodita](https://github.com/leninejunior/troglodita):**
> **Předtím (42 tokenů):** _„Problém je v tom, že se komponenta znovu vykresluje, protože se v každém vykreslovacím cyklu vytváří nová reference na objekt. Doporučil bych použít useMemo.“_
>
> **Potom (12 tokenů):** _„Nové vykreslení: nová reference v každém cyklu (inline objekt vytvořen znovu). Použít `useMemo`.“_
>
> **Stejná odpověď. O ~70 % méně tokenů. Technická přesnost zachována.** ✅
### 🎚️ Více než jen enginy — výstupní styly, adaptivní volič a řízení jednotlivých požadavků
Výše uvedených 12 enginů zmenšuje to, co jde **dovnitř**. Další tři vrstvy určují, **jak**, **kdy** a co jde **ven**:
- **🪄 Výstupní styly** _(řízení výstupní osy)_ — vkládají deterministické instrukce pro formování odpovědí, které jsou bezpečné pro mezipaměť; lze je kombinovat a každý má intenzitu `lite` / `full` / `ultra`. Přidání stylu je jednořádkový záznam v registru:
- **Stručná próza** — odstraňuje vatu / členy / váhavé formulace; zachovává přesný technický obsah.
- **Méně kódu** — YAGNI ve stylu „líného seniorního vývojáře“: nejmenší funkční změna, žádná nevyžádaná podpůrná struktura.
- **Culík (líný seniorní vývojář)** — postupuje po žebříčku YAGNI, opravuje základní příčinu, vytváří nejmenší funkční diff.
- **Mám ADHD (nejdřív akce)** — začíná další akcí, čísluje kroky, uvádí jeden konkrétní následující krok, bez úvodu.
- **Stručná CJK (文言)** — ultrast stručný styl klasické čínštiny (omezený na locale `zh`).
- **🎯 Adaptivní rozpočet kontextu** _(volič)_ — namísto jediné hranice tokenů typu zapnuto/vypnuto postupně aktivuje nejlevnější enginy s nejmenšími ztrátami pouze do míry potřebné k tomu, aby se obsah **vešel do kontextového okna modelu**. Zásada: `reserve-output` (výchozí, zohledňuje model) · `percentage` · `absolute`. Režim: `floor` (zaručí, že se obsah vejde) · `replace-autotrigger` (vaše explicitní volba má přednost) · `off` (starší prahová hodnota).
- **🎛️ Kde se rozhoduje o kompresi** _(priorita, vysoká → nízká)_ — hlavička `x-omniroute-compression` pro jednotlivý požadavek › přepsání kombinací směrování › aktivní pojmenovaný profil › adaptivní / automatické spuštění › výchozí nastavení panelu › vypnuto. Použitý plán se vrací v hlavičce odpovědi `X-OmniRoute-Compression: ; source=`.
Nastavte automatické spuštění podle prahové hodnoty tokenů, zapněte adaptivní volič, připněte pojmenovaný profil, použijte jednorázové nastavení pro konkrétní požadavek nebo přiřaďte pipeline jednotlivým kombinacím směrování — podle toho, co vyhovuje dané pracovní zátěži. Volitelný offline **evaluační nástroj** (`npm run eval:compression`) před nasazením změny vyhodnotí věrnost vůči úspoře na pevně stanoveném korpusu.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Rychlý start
**1) Instalace a spuštění**
```bash
npm install -g omniroute
omniroute
```
> 💡 Zobrazuje se `npm warn ERESOLVE` nebo upozornění na peer dependencies? [Jsou neškodná](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Používáte npm 11 nebo novější?** npm může blokovat skripty životního cyklu balíčků, pokud nejsou povoleny. `postinstall` OmniRoute (`node scripts/build/postinstall.mjs`) je nutný k přípravě jeho nativních runtime souborů. Při globální instalaci povolte balíčky uvedené v upozornění npm. Pro sadu balíčků hlášenou verzí OmniRoute 3.8.51:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Chcete-li tento seznam povolených balíčků znovu použít při budoucích globálních instalacích, jednou jej nakonfigurujte a poté instalujte běžným způsobem:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Seznam závislostí se může mezi vydáními měnit; pokud npm nahlásí jiný seznam, použijte názvy balíčků z daného upozornění. Povolením balíčku umožníte spuštění jeho instalačních skriptů.
> **Používáte Gemini Web nebo jiného poskytovatele založeného na webových cookies?** Balíček npm obsahuje
> Playwright, ale nikoli jeho binární soubor Chromium. Před odesláním prvního požadavku webovému poskytovateli si přečtěte
> poznámku k [nastavení Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium).
Řídicí panel je na adrese `http://localhost:20128` · API na adrese `http://localhost:20128/v1`.
**2) Připojte vyhovujícího poskytovatele pomocí vlastního účtu**
Řídicí panel → **Poskytovatelé** → vyberte poskytovatele, jehož aktuální podmínky a kvóty odpovídají vašemu případu použití → přidejte jeho klíč API nebo dokončete proces připojení účtu. Bezplatné tarify mohou vyžadovat registraci, schválení nebo platební metodu. Projděte si [průvodce bezplatnými tarify](docs/getting-started/FREE-TIERS-GUIDE.md); dostupnost bez klíče není zaručena a poskytovatelé označení `tos: avoid` jsou ve výchozím nastavení vyloučeni z `auto`.
**3) Nasměrujte svůj programovací nástroj**
```txt
Základní URL: http://localhost:20128/v1
Klíč API: [zkopírujte z Řídicí panel → Koncové body]
Model: auto (směruje mezi vyhovujícími připojeními — nebo zvolte poskytovatele/model)
```
**4) Ověřte funkčnost**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Měl by se zobrazit seznam vašich připojených modelů. 🎉 To je vše — začněte programovat a OmniRoute za vás bude automaticky směrovat požadavky a přepínat na záložní možnosti.
Pokud váš klient nemůže odesílat vlastní hlavičky, OmniRoute nabízí také kompatibilní aliasy s tokeny:
```txt
Katalog 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
Odpovědi OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses
Chat Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat
Tagy Ollama: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Používejte je pouze u klientů, kteří nemohou připojit `Authorization: Bearer ...`. Preferovaným režimem zůstává ověřování pomocí hlavičky.
## 📦 Další způsoby instalace — 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` odkazuje na nejvyšší **publikovanou** stabilní verzi SemVer. Nesleduje větev git `main`. Pro GitOps použijte pevnou verzi `:X.Y.Z`. Viz [Kanály vydání Dockeru](docs/guides/DOCKER_GUIDE.md#release-channels). Image nastavuje **`OMNIROUTE_MEMORY_MB=1024`**. To stačí pro ovládací panel a nenáročný chat. **Programovací agenti** (`POST /v1/responses` z Claude Code, Codex, Grok, …) potřebují mnohem větší haldu V8, jinak proces skončí s chybou `FATAL ERROR` při přibližně 12 GiB a dvou překrývajících se dlouhých kontextech. Nastavte velikost kontejneru nad velikost haldy (nativní buffery se nacházejí mimo V8):
| Pracovní zátěž | Halda (`-e OMNIROUTE_MEMORY_MB`) | Kontejner (`--memory`) |
| ----------------------------------- | -------------------------------- | ---------------------- |
| Ovládací panel / nenáročný chat | `1024` (výchozí hodnota image) | ≥2 g |
| Jeden programovací agent | `8192` | ≥10 g |
| Dvě souběžné dlouhé `/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á tabulka: [Průvodce Dockerem — operační paměť za běhu](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Kanál předběžných vydání Dockeru:** `diegosouzapw/omniroute:next` a
> `diegosouzapw/omniroute:next-web` sledují aktuální výchozí větev `release/v*`.
> Tyto proměnlivé tagy jsou určeny pouze k testování dosud nevydaných oprav a
> **nejsou podporovány pro produkční prostředí**. Viz
> [Kanály vydání Dockeru](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
Standardní `bun install` a globální instalace (`bun install -g omniroute`) jsou podporovány prostřednictvím detekce běhového prostředí Bun:
- **Vestavěný `bun:sqlite`**: Při spuštění pod Bun používá OmniRoute vestavěný ovladač `bun:sqlite`; v Node.js případně použije `better-sqlite3` nebo `sql.js`.
- **Automatický výběr bundleru Webpack při vývoji**: Vývojové prostředí (`bun run dev`) automaticky detekuje Bun a zakáže Turbopack ve prospěch Webpacku, aby zabránilo nekompatibilitě s nativními vazbami V8. Produkční sestavení (`bun run build`) se řídí proměnnou `OMNIROUTE_USE_TURBOPACK` přesně stejně jako v Node: ve výchozím nastavení používá Turbopack, zatímco `OMNIROUTE_USE_TURBOPACK=0` sestaví aplikaci pomocí Webpacku (`Dockerfile.bun` tuto možnost zpřístupňuje jako `--build-arg`).
- **Samostatný Dockerfile pro Bun**: Vícefázový `Dockerfile.bun` pro nativní produkční nasazení Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Instalace a spuštění pomocí Bun
bun install
bun run dev
```
**🛠️ Ze 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žití flakes systému Nix
nix develop
npm run dev
# Nebo pomocí devbox
devbox run npm run dev
```
📖 [Průvodce Dockerem](docs/guides/DOCKER_GUIDE.md) — Profily Compose, HTTPS přes Caddy, tunely Cloudflare.
**🦭 Podman**
```bash
# 1. Připravte datový adresář připojený pomocí bind mount
mkdir -p data
# 2. Pouze pro Linux + místní rootless Podman (nikdy pro vzdáleného klienta Podman Machine):
podman unshare chown 1000:1000 ./data
# 3. Nastavte údaj o běhovém prostředí, sestavte místní image Compose a spusťte jej
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
V macOS nebo Windows používá Podman vzdálený Podman Machine: vynechte `podman unshare` a
postupujte podle [pokynů k datovému adresáři pro konkrétní topologii](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Průvodce Podmanem](contrib/podman/README.md) — Sestavení pomocí Compose, Podman Machine a
nastavení Quadlet se systémem Linux/systemd.
**⚡ Rychlejší / úspornější instalace (bez nativního sestavení)**
Nativní databázový engine SQLite (`better-sqlite3`) je **volitelná** závislost, takže globální
instalace nikdy nečeká na kompilaci ze zdrojového kódu: použije předem sestavený binární soubor, pokud odpovídá
vaší platformě/Node, a v opačném případě automaticky přejde na engine implementovaný čistě v JS
(`node:sqlite` v Node 22+, jinak přibalený WASM modul `sql.js`) — bez nutnosti nástrojů pro sestavení.
Chcete-li zcela přeskočit nativní inicializaci po instalaci (CI, bezobslužné nebo pomalé počítače):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 ji také přeskočí
```
Pro nejrychlejší instalace upřednostněte **pnpm** (úložiště adresované podle obsahu + pevné odkazy — viz výše).
Pro bezobslužné běhové prostředí bez ovládacího panelu použijte profil Dockeru `base` (výše) nebo
[průvodce pro Termux](docs/guides/TERMUX_GUIDE.md). CLI a webový ovládací panel obsluhuje
stejný proces na jednom portu, takže v současnosti neexistuje samostatný balíček pouze pro CLI.
# 🎬 OmniRoute v akci
## 📹 Videoprůvodci
Stav panelu k 2026-08-24 · Nezpracovaný katalog: YT 809 | TT 137 | IG 124 · Aktuálnost (ve dnech): YT 1 | TT 21 | IG 22
pino — strukturované protokoly JSON s kontextem požadavku
Testování
Testovací nástroj Node.js + Vitest — více než 39 000 statických deklarací testů ve více než 5 100 sledovaných testovacích souborech (jednotkové, integrační, E2E, bezpečnostní, ekosystémové)
Strategie pokrytí testy pro více než 39 000 statických deklarací testů ve více než 5 100 sledovaných testovacích souborech
# ⭐ Nejvýznamnější přispěvatelé
> OmniRoute utváří nadšená open-source komunita. Tito lidé mimořádně přispěli k projektu a jejich práce má přímý dopad na jeho kvalitu, stabilitu a dosah. **Děkujeme.**
### Externí přispěvatelé podle počtu sloučených pull requestů
Stav zmrazen na aktuální špičce větve release/v3.8.50, revize dafb4ae808, se sloučeními do 2026-08-24 05:26:03 UTC. Stránkovaný přehled GitHub GraphQL obsahuje 5 911 sloučených PR: 2 707 od vlastníka repozitáře, 179 od Dependabotu a 3 025 externích PR od 535 různých přispěvatelů. „Změněné řádky“ představují součet přidaných a odstraněných řádků podle GitHubu a zahrnují generované soubory, soubory zámků, katalogy, překlady a dokumentaci; jde o objem změn, nikoli o počet autorsky vytvořených řádků kódu. Shodná umístění na hranici výběru jsou zachována.
### Commity přiřazené GitHubem
Znovu ověřeno 2026-08-24 06:14:31 UTC: commity přiřazené službou GitHub, které rozhraní Contributors API repozitáře vykázalo pro výchozí větev release/v3.8.50. Rozhraní API vrátilo 525 identit (415 uživatelů, 2 boty, 108 anonymních); tato tabulka nezahrnuje správce, boty ani anonymní identity a zachovává dělená umístění. Liší se jak od výše uvedeného žebříčku sloučených PR, tak od níže uvedeného přehledu 639 osob založeného na metadatech Gitu.
> 🙏 Funkce, opravy chyb a vylepšení infrastruktury od těchto přispěvatelů jsou **klíčovou součástí** toho, co činí OmniRoute spolehlivým a bohatým na funkce. Záleží na každém pull requestu, každém testovacím případu a každém překladovém souboru i18n. Open source tvoří lidé jako oni.
---
## 💖 Sponzoři
Srdečně děkujeme lidem, kteří financují OmniRoute z vlastní kapsy — každý příspěvek pomáhá udržet projekt bezplatný, nezávislý a v pohybu.
… a dalším, kteří si přejí zůstat v soukromí 💛Veřejní sponzoři na GitHub Sponsors byli znovu ověřeni dne 2026-08-24. Stav activeOnly na GitHubu určuje výše uvedená označení aktivních sponzorů; dříve zveřejněným jednorázovým podporovatelům nadále děkujeme a soukromí sponzoři zůstávají anonymní.💖 Staňte se sponzorem → — každý dolar pomáhá udržet OmniRoute bezplatný a nezávislý.
## 👥 Více než 600 přispěvatelů
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Auditováno dne 2026-08-24 na neměnném základu ac02c5b42f a znovu zkontrolováno na aktuální špičce release/v3.8.50dafb4ae808: 639 normalizovaných lidských identit Gitu — 407 se objevuje jako autoři commitů (včetně správce projektu) a 232 pouze ve výslovných záznamech Co-authored-by. Tento soupis normalizuje identifikátory GitHub noreply, vylučuje 26 identit botů, agentů, služeb a zástupných identit a neslučuje běžné e-mailové adresy pouze proto, že se shodují jejich zobrazovaná jména.
### Jak přispívat
1. Vytvořte fork repozitáře
2. Vytvořte větev z aktuální špičky **aktivní** větve `release/vX.Y.Z` (nikoli z `main`) — viz [Model větvení a vydávání](docs/ops/BRANCHING_MODEL.md)
3. Vytvořte svou větev pro novou funkci (`git checkout -b feat/amazing-feature`)
4. Commitněte své změny (`git commit -m 'feat: add amazing feature'`)
5. Odešlete větev (`git push origin feat/amazing-feature`)
6. Otevřete Pull Request s nastavením **base = příslušná větev `release/vX.Y.Z`**
Podrobné pokyny naleznete v souboru [CONTRIBUTING.md](CONTRIBUTING.md).
### Vydání nové verze
```bash
# Vytvoření vydání — npm publish proběhne automaticky
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Hvězdičky
## 🌍 StarMapper
## 🙏 Poděkování
OmniRoute stojí na ramenou obrů. Začal jako fork projektu **[9router](https://github.com/decolua/9router)** a TypeScriptový port projektu **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** napsaného v Go — a od té doby byl každý níže uvedený subsystém inspirován open-source projektem, který s daným řešením přišel jako první. Každý z nich ovlivnil konkrétní část OmniRoute. Tímto jim všem děkujeme. 🙏
> ⭐ počty hvězdiček byly ověřeny prostřednictvím GitHub REST API dne 24. srpna 2026 — nezapomeňte dát těmto projektům hvězdičku. Uvedené počty představují přesný snímek k danému datu a budou se přirozeně měnit.
### 🧬 Původ a brána
AI brána, jejíž veřejná datová sada cen slouží k synchronizaci našeho sledování nákladů a jejíž model normalizace poskytovatelů ovlivnil naše směrování.
Zdrojový kód pod licencí MIT upravený a začleněný do můstku ChatGPT Web → Codex Responses, včetně adaptérů pro relace prohlížeče, rámcování odpovědí, využití a webové vyhledávání.
Jeho mapování modelů Grok, generátor Statsig s falešným TypeError, výchozí nastavení požadavků a zařízení a procesor odpovědí NDJSON byly ve významné míře upraveny a začleněny do executoru Grok Web v OmniRoute.
Hlavní nepřímý zdroj kódu, na němž je založen grok2api-merged; jeho implementace modelů, hlaviček, datových částí požadavků, Statsig a procesorů jsou zachovány v rodové linii Grok Web.
Výchozí zdroj pod licencí MIT pro datové části požadavků Grok a výchozí nastavení zařízení, generátor Statsig a procesor result.response, převzatý prostřednictvím TQZHR a grok2api-merged.
Nepřímý zdroj, který grok2api-merged uvádí u své vrstvy fondu proxy serverů; OmniRoute zachovává zmínku o této rodové linii, ale netvrdí, že do jeho omezeného executoru Grok Web byl přenesen fond proxy serverů.
Původní implementace Grok Web vycházela z jeho návrhu komunikace s upstreamem přes HTTP/prohlížeč; její přímá cesta HTTP je odvozena z GrokProxy, proto není deklarován žádný nezávislý přenos kódu.
Virální projekt „proč používat mnoho tokenů, když stačí málo tokenů“ — jeho filozofie jeskynní mluvy pohání náš standardní režim komprese a více než 30 pravidel pro odstraňování výplňových slov a kondenzaci.
Výzkum komprese promptů (LLMLingua / LLMLingua-2) — inspiroval náš asynchronní engine llmlingua, který je bezpečný pro kód a při selhání ponechá vstup beze změny.
Virální dovednost YAGNI programátora ve stylu „líného seniorního vývojáře“ — inspirovala náš výstupní styl less-code: směřování k nejmenší funkční změně, které omezuje _generovaný_ kód (protějšek stručné prózy Cavemanu na ose výstupu).
Komprese výstupu zohledňující obsah a typ jednotlivých souborů s ukončením při riziku selhání — potvrdila správnost našeho směrování podle typu a přeskočení komprese při nedosažení minimální úspory.
Sloupcový JSON v Rustu + načítání adresované obsahem + deduplikace napříč zprávami — potvrdily návrh našich enginů headroom/ccr/session-dedup a invariant stability mezipaměti „komprimovaná podoba je nezávislá na pozici“.
Sada nástrojů pro TypeScript Compiler API — inspirovala naše odstraňování komentářů založené na parseru, které zachovává řetězcové, šablonové a regulární literály.
MITM zachytávání a analýza provozu mezi programovacím asistentem a LLM ovlivnily počáteční požadavky na Traffic Inspector. Čtyři dříve odvozené moduly — slučování SSE, normalizace konverzací, maskování tajných údajů a sanitizace hlaviček — byly nahrazeny nezávislými implementacemi vytvořenými metodou clean-room na základě veřejných protokolových standardů. Dvě komponenty pro přímý průchod k hostiteli (passthrough.ts a _internal/bypass.cjs) zůstávají interními implementacemi OmniRoute klasifikovanými nezávisle; v rámci této náhrady nebyly přepsány.
Transparentní směrování proxy pro jednotlivé procesy — inspirovalo naše bezpečné ukončení MITM při pádu, časové limity nečinnosti soketů, přiřazování procesů pomocí /proc a zachytávání TPROXY.
### 📚 Data modelů, pozorovatelnost a uživatelské rozhraní
Kurátorovaný seznam knihoven s bezpečným výchozím nastavením, kterým se řídí naše bezpečnostní volby (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Jeho přemapování modelů zohledňující účty, ověřování cest ke spustitelným souborům a chování štítků plánů ovlivnily běhové prostředí Antigravity v OmniRoute.
> Animovaný souhrn živé stránky `/dashboard/free-tiers`. Úplná metodika (odstraňování duplicit fondů, úrovně kreditů, podmínky poskytovatelů): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Tyto údaje každé dva týdny znovu ověřujeme podle aktuálního katalogu a **mohou se měnit oběma směry** — když poskytovatel ukončí bezplatný tarif, číslo klesne; když přibude nový, vzroste. Zveřejňujeme to, co katalog skutečně vypočítá, nikdy nikoli zaokrouhlený nejlepší možný scénář.
```bash
# Po připojení poskytovatele zkopírujte svůj klíč OmniRoute z Dashboard → Endpoints:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` vyžaduje podporovanou trasu. Nová instalace nemusí mít žádné podporované cíle bez klíče a poskytovatel bez klíče může odmítnout klienty třetích stran. Poskytovatelé označení `tos: avoid`, včetně OpenCode Free a Kiro, jsou ve výchozím nastavení z automatického směrování vyloučeni; připojení účtu toto nastavení nemění. Před výběrem poskytovatele si přečtěte [Průvodce bezplatnými úrovněmi](docs/getting-started/FREE-TIERS-GUIDE.md).
📦 Zkopírovatelné skripty pro rychlý start v jazycích **Python, Node.js, PHP a cURL** → [`examples/quickstart/`](examples/quickstart/)
> **Kombinace** je řetězec modelů, mezi kterými OmniRoute směruje požadavky **automaticky**. Pokud dojde kvóta, poskytovatel selže nebo prudce vzrostou náklady, kombinace může přejít na další vhodný a funkční model. 🛡️
### ⚡ Bez konfigurace — stačí použít `auto`
Není třeba vytvářet žádnou kombinaci. Nastavte model na `auto` (nebo některou z jeho variant) a OmniRoute vytvoří virtuální kombinaci z vašich připojených poskytovatelů, které průběžně vyhodnocuje:
📖 [Modul automatických kombinací](docs/routing/AUTO-COMBO.md) · [Průvodce odolností](docs/architecture/RESILIENCE_GUIDE.md)
📊 Kompletní metodika & podrobnosti o jednotlivých funkcích v porovnání s 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Klíč (náhodný): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix copia-e-cola:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Autorizace](docs/architecture/AUTHZ_GUIDE.md) · [Ochranná opatření](docs/security/GUARDRAILS.md) · [Soulad s předpisy](docs/security/COMPLIANCE.md)
Výchozí skládaná kombinace spouští `RTK → Caveman`. Když oba enginy zpracovávají stejný payload nástroje nebo kontextu, úspory se násobí:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Bloky kódu, URL, JSON a strukturovaná data jsou enginem pro zachování obsahu **vždy chráněny**.
> **Proč používat mnoho tokenů, když stačí jen několik?** Každý požadavek prochází kompresní pipeline OmniRoute **transparentně** — bez jakýchkoli změn na straně klienta. Nyní jde o **sadu 12 kombinovatelných enginů**, které se spouštějí v daném pořadí a lze je libovolně kombinovat pro jednotlivé směrovací kombinace — na základě myšlenek z projektů [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).
### 🧱 Sada 12 enginů
Enginy se spouštějí v pořadí pipeline; každý lze nezávisle zapnout či vypnout a nakonfigurovat pro jednotlivé kombinace:
