# 🚀 OmniRoute — Bezplatná brána AI
**Vytvořil [Diego Souza](https://github.com/diegosouzapw)**
## 💰 ~1,62 mld. tokenů / měsíc napříč bezplatnými tarify třetích stran
> **Použijte vlastní účty u poskytovatelů.** Jedná se o odhadovaný souhrn napříč samostatně způsobilými bezplatnými tarify 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 určuje své limity, dostupnost a podmínky.
>
> Ruční skládání bezplatných tarifů je namáhavé — desítky SDK, desítky rychlostních limitů a žádný přehled o tom, kolik toho skutečně máte. OmniRoute katalogizuje **465 položek bezplatných tarifů napříč 34 opakujícími se klíči poolů** a vypočítává hlavní údaj o počtu tokenů ze **17 poolů s publikovaným kladným měsíčním rozpočtem plus pěti limitů Groq pro jednotlivé modely**, přičemž duplicitní sdílené pooly započítává pouze jednou. Kvóty, které se zpřístupní až po regionálním ověření identity (dnes: ModelScope), jsou zobrazeny samostatně, +~6 mil. za regionálním ověřením identity, a do hlavního údaje se nikdy nesčítají. Výsledek zůstává viditelný na dashboardu (`/dashboard/free-tiers`).
> Animované shrnutí aktuální stránky `/dashboard/free-tiers`. Úplná metodika (odstranění duplicit poolů, kreditní úrovně, podmínky poskytovatelů): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Tyto údaje jsou každé dva týdny znovu ověřovány oproti aktuálnímu katalogu a **mění se oběma směry** — poskytovatel ukončí bezplatný tarif a číslo klesne; přibude nový a číslo vzroste. Zveřejňujeme údaje, které katalog skutečně vypočítává, nikdy nadhodnocený nejlepší možný scénář.
⭐ Pokud vám OMNIROUTE pomohl ušetřit peníze a usnadnit práci, dejte repozitáři hvězdičku.
[](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 — jako první získáte nové poskytovatele, vydání a tipy:**
[](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 k poskytovatelům, 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 směrujte přes jeden endpoint
```bash
# Po připojení poskytovatele zkopírujte svůj klíč OmniRoute z nabídky 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 způsobilou trasu. Nová instalace nemusí mít žádné způsobilé 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ě Kiro, jsou ve výchozím nastavení vyloučeni z automatického směrování; připojení účtu toto nastavení nepřepíše. Před výběrem poskytovatele si přečtěte [Průvodce bezplatnými tarify](docs/getting-started/FREE-TIERS-GUIDE.md).📦 Skripty pro rychlý start ke zkopírování a vložení pro **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`
Nemusíte vytvářet žádnou kombinaci. Nastavte model na `auto` (nebo některou z jeho variant) a OmniRoute sestaví virtuální kombinaci z vašich připojených poskytovatelů, kterou průběžně vyhodnocuje:
ID modelu
Co optimalizuje
auto
🎯 Vyvážené výchozí nastavení (LKGP — zůstává u posledního osvědčené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/subscription
🎟️ Pouze kvóta předplatného, za které už platíte — při selhání se ukončí a nikdy nepřejde na zpoplatněnou záložní možnost (průvodce)
auto/thrifty
🪜 Nejprve kvóta tarifu, poté postupně nejlevnější placené možnosti — po obnovení kvóty se vrátí k tarifu (průvodce)
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é setrvání u posledního osvědčeného poskytovatele
auto/chaos
🧪 Paralelní rozeslání panelu modelů (jeden na poskytovatele, ve výchozím nastavení 5), které vrátí jednu odpověď; jedno volání nadřazené služby na každý model v panelu, nikoli vnášení poruch
##
### 🔀 Nebo si vytvořte vlastní — 20 strategií směrování
Všech **20** strategií — libovolně je kombinujte v jednotlivých krocích kombinace:
#
Strategie
Co dělá
1
priority
Seřazený seznam s prvním cílem — každý se vyčerpá před přechodem na další 🥇
2
fill-first
Před přechodem na další cíl plně využije kvótu každého cíle
3
weighted
Vážený náhodný výběr podle váhy jednotlivých cílů
4
round-robin
Postupně prochází cíle 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žším aktuálním zatížením
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 v katalogu 💸
10
headroom
Vybere cíl s největší zbývající kvótou
11
quota-weighted
Přeskočí vyčerpané účty a poté vybírá v poměru zbývající kvóty ÷ aktuálního zatížení — stávající konverzace zůstávají připnuté ⚖️
12
reset-window
Upřednostní cíl, jehož kvótové období se obnoví nejdříve
13
reset-aware
Řadí podle času obnovení kvóty — nejprve krátká období 📊
14
context-relay
Pro dlouhé konverzace předává kontext mezi cíli 🧠
15
context-optimized
Vybere nejvhodnější cíl pro aktuální velikost kontextu
16
cache-optimized
Připne každý opakovaně použitelný prefix výzvy ke stejnému účtu — maximalizuje využití mezipaměti výzev 🎯
17
lkgp
Poslední osvědčená cesta — připne se k poslednímu úspěšnému poskytovateli a poté použije záložní pravidla
18
auto
Průběžné vyhodnocování 16 faktorů napříč všemi připojeními 🤖
19
fusion
Rozešle požadavek panelu modelů a hodnoticí model z jejich výstupů sestaví jednu odpověď 🧬
20
pipeline
Zřetězí kroky — výstup každého cíle slouží jako vstup pro následující 🔗
Engine 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)
📖 [Engine Auto-Combo](docs/routing/AUTO-COMBO.md) · [Průvodce odolností](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 V čem OmniRoute vyniká
📊 Kompletní metodika a podrobnosti o jednotlivých funkcích oproti 9router, OpenRouter, CLIProxyAPI a 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
> Nejnovější zajímavosti z období **v3.8.20 → v3.8.54**. Kompletní historie je v [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Směrování `quota-weighted`** — 20. kombinovaná strategie vynechá účty s vyčerpaným limitem a mezi ostatními vybírá v poměru k volné kvótě ÷ počtu probíhajících požadavků, přičemž existující konverzace zůstávají připnuté. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Bezhlavý režim** — `omniroute serve --headless` (nebo `OMNIROUTE_HEADLESS=1`) spouští pouze proxy engine `/v1/*`, zatímco dashboard a subsystémy určené pouze pro dashboard zůstávají vypnuté. → [Bezhlavý režim](docs/guides/HEADLESS.md)
- **🔎 Zjišťování modelů** — `/v1/models` filtruje podle schopností, kontextu, druhu a textu a `POST /v1/models/query` vrací krátký deterministický seznam kandidátů se stejnou viditelností pro jednotlivé klíče. → [Referenční dokumentace API](docs/reference/API_REFERENCE.md)
- **🔑 Řízení směrování podle klíče** — připněte API klíč k jednomu modelu nebo kombinaci pomocí `forcedModel` a atomicky přidávejte či odebírejte modely a kombinace klíče (`/api/keys/{id}/access`). → [Referenční dokumentace API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Podrobnější řízení PII** — výběr podle typu, až 20 ověřených vlastních vzorů maskování a čítače detekcí podle typu; samotné maskování zůstává volitelné. → [Ochranná opatření](docs/security/GUARDRAILS.md)
- **🌍 67 jazyků** — dashboard, zrcadla dokumentace a CLI, přičemž `npm run i18n:add-locale` přidá jazyk všude jediným příkazem. → [Průvodce i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — příchozí delegování A2A na vaši flotilu agentů, dovednosti Conductor na Agent Card a panel dashboardu s hlasovým chatem Faro push-to-talk. → [Server A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptivní přijímání a ochrana před přetížením** — náročné chatové požadavky se zařadí do fronty místo vrácení chyby 503, s atomickými klouzavými zápůjčkami RPM pro každé připojení. → [Průvodce odolností](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonické řazení `/v1/models`** — jeden souvislý blok poskytovatelů pro každého poskytovatele (kombinace jsou připnuté jako první), stabilní napříč všemi zdroji katalogu. → [Referenční dokumentace API](docs/reference/API_REFERENCE.md)
- **🗜️ Zodolnění komprese** — ve výchozím nastavení aktivní ochrana proti nafouknutí, balíčky Caveman pro DE / FR / JA a čínštinu (wényán), filtry RTK pro Gradle a .NET. → [Komprese](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Poctivé náklady s paušální sazbou** — poskytovatelé předplatného / coding planů vykazují v analýze nákladů **$0**; rozpočet, kvóta a směrování nadále provádějí odhady. → [Referenční dokumentace 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 efektivně využívá kapacitu tím, že nevyužité části půjčuje dál. → [Průvodce odolností](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Nastavení CLI/agentů jediným příkazem** — 15 registrovaných příkazů `setup-*`; `omniroute run` spouští 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` podporuje 11 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álený 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ů + posuzovatel), 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 engine a Compression Studios: LLMLingua-2, dvouvrstvé Ultra, omniglyph, brána věrnosti pro jednotlivé kroky, GCF v3.2, editor s přetahováním pro změnu pořadí. → [Komprese](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transparentní dešifrování MITM (TPROXY)** — zachytávací CLI, která ignorují proměnné prostředí proxy, s instalátorem CA pro jednotlivé SNI a ú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ů a využití `X-OmniRoute-*` na každém endpointu, hlavička úspor při zásahu mezipaměti a kvóty útraty v USD pro jednotlivé klíče. → [Referenční dokumentace API](docs/reference/API_REFERENCE.md)
- **🧠 Paměť pod vaší kontrolou** — ve výchozím nastavení vypnutá, volitelné vektorové kvantování int8 + typovaný útlum, `x-omniroute-no-memory` pro jednotlivé požadavky. → [Paměť](docs/frameworks/MEMORY.md)
- **🛡️ Zabezpečení** — ochrana proti prompt injection na každé trase LLM (red-teamová sada), volitelná ochrana maskování přihlašovacích údajů (rediguje uniklé API klíče a 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 dashboard (přihlášení heslem zůstává vždy dostupné). → [Ochranná opatření](docs/security/GUARDRAILS.md)
- **🖼️ Nové endpointy** — `/v1/ocr` (Mistral OCR) a `/v1/audio/translations` (ve stylu Whisper) doplňují rozhraní pro média. → [Referenční dokumentace API](docs/reference/API_REFERENCE.md)
- **🎨 Generování obrázků / videí / zvuku** — jedno API pro média: xAI Grok Imagine a video od Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind a poskytovatelé řeči, jako je ElevenLabs. → [Referenční dokumentace API](docs/reference/API_REFERENCE.md)
- **🌍 Nasazení a provoz** — `basePath` reverse proxy, automatická detekce jazyka prohlížeče, sledování zařízení podle klíče, důvěryhodnost MITM bez práv root a lokalizace zh-TW. → [Prostředí](docs/reference/ENVIRONMENT.md)
- **🤝 Další poskytovatelé a agenti** — cloudoví agenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) s prohlížečem a 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 388 poskytovatelů**. → [Poskytovatelé](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Transparentnost směrování** — každá odpověď obsahuje hlavičku `X-OmniRoute-Decision` s názvem strategie, poskytovatele a latence, které ji obsloužily; nová kombinovaná strategie `cache-optimized` a faktor `cacheAffinity` v Auto-Combo směrují opakované požadavky zpět na připojení, které obsahuje předponu v mezipaměti; endpoint pouze pro čtení `/v1/auto-combo/{channel}/candidates` zpřístupňuje živý 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í, nasazovače relay pro Cloudflare Workers / Deno Deploy, Bifrost a Mux jako spravované vestavěné služby. → [Vestavěné služby](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Také součástí balení** — framework pro pluginy + marketplace, frameworky dovedností Omni/Agent/GitHub, integrace trezoru Obsidian (22 nástrojů MCP), rozhraní Batch & Files API 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í fan-out více modelů `auto/chaos`, most pro bota Telegram, správce verzí v aplikaci a žebříčky bezplatných poskytovatelů LMArena-ELO. → [Dokumentace](docs/README.md)
## 🤖 Kompatibilní CLI & Kódovací agenti
> Jedna konfigurace — `http://localhost:20128/v1` — a **každé** AI IDE nebo 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í pro jednotlivé nástroje pro všech 39 nástrojů (28 CLI Code + 11 CLI Agentů) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plugin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Spusťte libovolné podporované CLI přes OmniRoute jediným příkazem** — žádné konfigurační soubory,
přihlašovací údaje jsou vkládány pro každý proces zvlášť, Qwen/Gemini dostanou izolovaný dočasný domov:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# Nebo vyberte poskytovatele+model interaktivně a napište vlastní konfiguraci nástroje:
omniroute configure codex # také: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Každý příkaz respektuje aktivní vzdálený kontext (`omniroute connect `), `--dry-run`
zobrazí přesné proměnné prostředí/argumenty bez spuštění a `--api-key-env NAME` udrží tajné klíče
mimo historii vašeho shellu. → [Integrace CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 poskytovatelů AI — 153 označených katalogem jako bezplatní
> **388 registrovaných poskytovatelů** napříč kanonickými kolekcemi chatu, médií, vyhledávání, lokálních, cloudových agentů a systémů, včetně **153 poskytovatelů s metadaty pro objevování `hasFree: true`**. Registr modelů chatu pokrývá **239 poskytovatelů / 3 059 jedinečných dvojic poskytovatel–model / 1 475 nezpracovaných ID modelů**; samostatný katalog bezplatných rozpočtů obsahuje **471 řádků pro jednotlivé modely**, **34 opakujících se fondů** a **52 poskytovatelů s opakovanou či bezklíčovou bezplatnou dostupností navždy**. Jedná se záměrně o různé jmenovatele; definice a výpočty deduplikované podle fondů jsou uvedeny v dokumentech [Reference poskytovatelů](docs/reference/PROVIDER_REFERENCE.md) a [Bezplatné tarify](docs/reference/FREE_TIERS.md).
### 🏢 Každá významná laboratoř — prostřednictvím jediného endpointu
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…a více než 350 dalších — každá ikona se načítá živě z katalogu poskytovatelů řídicího panelu. 📖 [Reference poskytovatelů](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Zdarma navždy — $0, bez karty
OpenCode Zen DeepSeek V4, Nemotron 3 Bez limitu tokenů
Kilo Code Automatický router, Tencent Hy3 Zdarma navždy
Requesty GPT-OSS 120B, Nemotron Zdarma navždy
SiliconFlow DeepSeek V3.2 / R1 Bezplatná úroveň
Z.AI GLM GLM-4.7 / 4.5-Flash Zdarma navždy
Baidu ERNIE ERNIE 4.0 Zdarma navždy
Qoder AI Qwen3-Max, Kimi-K2 Neomezeně ZDARMA
Pollinations GPT, Llama, Claude Klíč není potřeba
Cloudflare AI Více než 50 modelů 10K neuronů denně
NVIDIA NIM GLM, MiniMax ~40 RPM zdarma
Cerebras GLM 4.7, GPT-OSS Jednorázový kredit 5 $; karta je vyžadována
### 🧩 Novinka: OmniRoute v nativním chatu VS kódu Copilot
> Žádný nový postranní panel, žádný nový chat UI – každý model OmniRoute poskytuje, se zobrazí přímo v**Copilot nástroj pro výběr modelu chatu, který již používáte** . Od VS Code 1.122 fungují modely poskytovatelů bez přihlášení GitHub nebo předplatného Copilot – režim agenta, volání nástrojů a vidění zdarma.
Nainstalujte** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** rozšíření, nasměrujte jej na váš server OmniRoute (výchozí `localhost:20128`), poté otevřete Copilot Chat → model picker →** Spravovat modely…** →**OmniRoute** .
Zevnitř editoru: otevřete soubor** Rozšíření** prohlížet, hledat** "OmniRoute"** , klikněte** Instalovat** — funguje stejně v obou obchodech. Zdroj, vydání a publikační sada Runbook žijí na [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Code Copilot Průvodce chatem](docs/guides/VSCODE-COPILOT.md) – nastavení, co ukazuje výběr, panel na kartě, řešení problémů
### 🎩 Novinka: OmniRouteTray — vaše brána, která se nachází v liště nabídek
> `omniroute serve` je nejšťastnější, když je stále zapnutá.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** promění to v aplikaci s panelem nabídek pro macOS: spustí server, udrží ho při životě i po restartu, aktualizuje ho na místě a na jedno kliknutí dá váš rozpočet na token –** žádné okno terminálu nezůstalo otevřené, žádné `npm install -g omniroute` na hlídání dětí.**
Postaven s [Tauri v2](https://v2.tauri.app/) (jádro Rust velikosti chyby zaokrouhlení), dodává vlastní podepsané runtime Node 24 a spravuje instalaci OmniRoute vlastněnou aplikací, takže nikdy nebojuje s vaším globálním `node`/`bun`. To** sdílí vaši stávající konfiguraci a databázi `~/.omniroute/`** — takže je to stejný OmniRoute který už běžíš, jen s kloboukem na hlavě. 🎩
Co to dělá
Jak
🟢 Dohlíží na server
Vytvoří omniroute serve , převezme již běžící instanci místo jejího duplikování
📊 Živé využití na první pohled
Lišty kvót poskytovatele, limity Claude session/weekly s resetovaným odpočítáváním, 30denní rozpis nákladů
🔄 Probíhají automatické aktualizace
Postupná instalace, atomická výměna, vrácení při selhání — vždy na nejnovější verzi
🚀 Start při přihlášení
Volitelné spuštění při přihlášení; pouze zásobník, žádná ikona doku
🩺 Lékař & protokoly
Diagnostika jedním kliknutím a přístup k protokolu serveru
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Preferujete stahování? Získejte nejnovější .dmg z
Uvolňuje . Zdroj, problémy a sestavení
dokumenty žijí na zoispag/omniroute-tray.
💛 Komunitní projekt od @zoispag — není 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 také **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 + řídicího panelu (port 20128)
omniroute chat # interaktivní chatovací klient TUI (příkazy: /model /combo /skill /memory)
omniroute setup # průvodce prvotním nastavení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 oprávnění; každý příkaz se poté provede na vzdáleném serveru.
```bash
omniroute connect 192.168.0.15 # heslo → token s omezeným rozsahem, uložený jako kontext
omniroute models # ← spustí se na VZDÁLENÉM serveru
omniroute configure codex # ← vybere vzdálený model a zapíše místní profil Codex
omniroute tokens create --name ci --scope read # vytvoří tokeny s užšími oprávněními pro jiné počítače
omniroute contexts use default # ← přepne zpět na místní server
```
Tokeny mají rozsah oprávnění `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 OmniRoute ovládat sám
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 — zcela autonomně. Níže uvedené HTTP endpointy jsou dostupné pod adresou `http://localhost:20128`.
Rozhraní
Endpoint / příkaz
Použití
🧰 MCP (stdio)
omniroute --mcp
Propojení s Claude Desktop, Cursor nebo libovolným klientem MCP
Komunikace mezi agenty, JSON-RPC 2.0 + SSE, 6 dovedností
🌐 REST API
/v1/*
Kompatibilní s OpenAI — chat, embeddings, obrázky, zvuk, OCR
🔔 Webhooky
/api/webhooks
Odesílání událostí požadavků / kvót do služeb Slack, Discord, Telegram nebo na libovolnou URL
🛰️ Vzdálené CLI
omniroute connect
Ovládání vzdálené instance pomocí přístupových tokenů s omezeným rozsahem oprávnění
```bash
# Zpřístupnění kompletní sady nástrojů OmniRoute aplikaci Claude Code 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)
## 🗜️ Automaticky ušetřete 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 pracují se stejným payloadem nástroje/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 **vždy chráněny** enginem zachování.
> **Proč používat mnoho tokenů, když stačí několik?** Každý požadavek prochází komprimační pipeline OmniRoute **transparentně** — bez 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 podle jednotlivých routovacích kombinací libovolně kombinovat — vycházejí z myšlenek 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 zapínat a konfigurovat podle kombinace:
#
Engine
Co dělá
1
Session-Dedup
Odstraňuje obsah opakovaný napříč tahy (adresovaný obsahem, napříč tahy)
2
CCR
Archivuje velké bloky za značky pro načtení, které se získávají podle potřeby
3
Lite
Ořezávání mezer a URL obrázků (základní varianta s nízkou latencí)
4
RTK
Chytré filtrování, deduplikace a zkracování výsledků nástrojů (s ohledem na příkazy)
5
Responses Tool Output
Bezeztrátová práce s JSON na prvním místě + omezená diagnostická komprese výstupů shellu/patchů/vyhledávání/sestavení (Responses API)
Extrakční hodnocení vět podle posledního uživatelského dotazu
8
Caveman
Komprese prózy založená na pravidlech (~65–75 % u výstupu)
9
Aggressive
Shrnutí + postupné zastarávání starých tahů
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 naměřený Claude Fable 5 na přímém rozhraní Anthropic; transformery GPT 5.6 zůstávají uzavřené při selhání, dokud nebudou k dispozici potvrzení poskytovatele. Čtyři kompresní profily (ve výchozím nastavení agresivní, vyvážený, bezpečný pro kód, propustný) (nejagresivnější; vyžaduje aktivaci)
Bloky kódu, URL a strukturovaná data jsou **vždy zachována** s přesností na jednotlivé bajty. **Předvolby na jedno kliknutí** kombinují enginy:
Režim
Úspory
Nejvhodnější pro
🪶 Lite
~15 %
Bezpečná výchozí volba pro trvalé použití
🪨 Standard (Caveman)
~30 %
Každodenní programování
⚡ Aggressive
~50 %
Dlouhé relace s mnoha nástroji
🔥 Ultra
~75 %
Maximální úspory
🧰 RTK
60–90 %
Výstup shellu/testů/sestavení/git
🔗 Stacked (RTK → Caveman)
78–95 %
Smíšené prompty + protokoly nástrojů
**Praktický příklad — režim Standard:**
> **Před (69 tokenů):** _„Důvodem, proč se vaše komponenta React znovu vykresluje, je pravděpodobně vytváření nové reference objektu při každém cyklu vykreslení. Když předáte vložený objekt jako prop, mělké porovnání Reactu jej pokaždé vyhodnotí jako jiný objekt, což spustí opětovné vykreslení. Doporučuji použít useMemo k zapamatování objektu.“_
>
> **Po (19 tokenů):** _„Nová reference objektu při každém vykreslení. Vložený objekt jako prop = nová reference = opětovné vykreslení. Zabalte do useMemo.“_
>
> **Stejná odpověď. O 72 % méně tokenů. Bez ztráty přesnosti.** ✅
**Příklad PT-BR — režim [Troglodita](https://github.com/leninejunior/troglodita):**
> **Předtím (42 tokenů):** _"Problém je v tom, že komponenta se znovu vykresluje, protože se v každém cyklu vykreslování vytváří nová reference objektu. Doporučil bych použít useMemo."_
>
> **Potom (12 tokenů):** _"Re-render: nová reference v každém cyklu (inline objekt znovu vytvořen). Použít `useMemo`."_
>
> **Stejná odpověď. O ~70 % méně tokenů. Technická přesnost zachována.** ✅
### 🎚️ Za hranicemi enginů — styly výstupu, adaptivní ovladač a řízení pro jednotlivé požadavky
Výše uvedených 12 enginů zmenšuje to, co **vstupuje**. Další tři vrstvy určují **jak**, **kdy** a co **vystupuje**:
- **🪄 Styly výstupu** _(řízení osy výstupu)_ — vkládají deterministické instrukce pro tvarování odpovědi bezpečné pro cache; lze je kombinovat, každý ve stupni intenzity `lite` / `full` / `ultra`. Přidání stylu je jednorázový zápis v registru:
- **Úsporná próza** — odstraňuje výplňová slova / členy / váhání; zachovává přesný technický obsah.
- **Méně kódu** — YAGNI „líného seniorního vývojáře“: nejmenší funkční změna, bez nevyžádané podpůrné infrastruktury.
- **Cop (líný seniorní vývojář)** — postupuje po žebříčku YAGNI, opravuje kořenovou příčinu, nejmenší funkční diff.
- **Mám ADHD (akce na prvním místě)** — nejprve uvádí další akci, kroky jsou očíslované, jeden konkrétní další krok, bez úvodu.
- **Úsporné CJK (文言)** — ultraúsporný styl klasické čínštiny (locale-gated na `zh`).
- **🎯 Adaptivní rozpočet kontextu** _(ovladač)_ — namísto jediného prahu tokenů zapnuto/vypnuto eskaluje nejlevnější enginy s nejmenšími ztrátami pouze do té míry, která je nutná k **umístění do kontextového okna modelu**. Zásada: `reserve-output` (výchozí, s ohledem na model) · `percentage` · `absolute`. Režim: `floor` (zaručí umístění) · `replace-autotrigger` (vyhrává vaše explicitní volba) · `off` (starší práh).
- **🎛️ Kde se rozhoduje o kompresi** _(priorita, od nejvyšší po nejnižší)_ — hlavička `x-omniroute-compression` pro jednotlivý požadavek › přepsání kombinace routování › aktivní pojmenovaný profil › adaptivní / automatický spouštěč › výchozí nastavení panelu › vypnuto. Použitý plán se vrací v hlavičce odpovědi `X-OmniRoute-Compression: ; source=`.
Automaticky spouštějte kompresi podle prahu tokenů, zapněte adaptivní ovladač, připněte pojmenovaný profil, nastavte jednorázovou volbu pro konkrétní požadavek nebo přiřaďte pipeline ke kombinaci routování — podle toho, co nejlépe odpovídá zátěži. Volitelný offline **eval harness** (`npm run eval:compression`) hodnotí věrnost oproti úsporám na připnutém korpusu ještě před nasazením změny.
📖 [`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
```
> 💡 Vidíte `npm warn ERESOLVE` nebo varování týkající se peer závislostí? [Jsou neškodná](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Používáte npm 11 nebo novější?** npm může zablokovat skripty životního cyklu balíčků, pokud nejsou povoleny. `postinstall` OmniRoute (`node scripts/build/postinstall.mjs`) je nutný k přípravě nativních runtime souborů. Při globální instalaci povolte balíčky uvedené ve varování npm. Pro sadu balíčků hlášenou OmniRoute 3.8.54:
>
> ```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, nakonfigurujte jej jednou 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 mezi vydáními může měnit; pokud npm nahlásí jiný seznam, použijte názvy balíčků z tohoto varování. Povolení balíčku umožňuje spuštění jeho instalačních skriptů.
> **Používáte Gemini Web nebo jiného poskytovatele webových cookies?** Balíček npm obsahuje
> Playwright, nikoli však jeho binární soubor Chromium. Před prvním požadavkem webového poskytovatele si přečtěte
> poznámku [Nastavení Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium).
Panel na `http://localhost:20128` · API na `http://localhost:20128/v1`.
**2) Připojení způsobilého poskytovatele pomocí vlastního účtu**
Panel → **Poskytovatelé** → vyberte poskytovatele, jehož aktuální podmínky a kvóta odpovídají vašemu případu použití → přidejte jeho API klíč nebo dokončete proces úč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) Nastavení vašeho nástroje pro programování**
```txt
Base URL: http://localhost:20128/v1
API Key: [zkopírujte z Panel → Endpoints]
Model: auto (směrování mezi způsobilými připojeními — nebo zvolte poskytovatele/model)
```
**4) Ověření funkčnosti**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Měli byste vidět seznam připojených modelů. 🎉 To je vše — začněte programovat a OmniRoute se za vás postará o automatické směrování a záložní přepínání.
Pokud váš klient nemůže odesílat vlastní hlavičky, OmniRoute poskytuje také tokenizované aliasy kompatibility:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Používejte je pouze pro klienty, kteří nemohou připojit `Authorization: Bearer ...`. Ověřování pomocí hlavičky zůstává preferovaným režimem.
## 📦 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.
Strategie pokrytí testy pro více než 60 000 statických deklarací testů v rámci více než 8 400 sledovaných testovacích souborů
# ⭐ Nejvýznamnější přispěvatelé
> OmniRoute je utvářen nadšenou komunitou open source. Tito jednotlivci významně přispěli ke kvalitě, stabilitě a dosahu projektu. **Děkujeme.**
### Externí přispěvatelé podle sloučených pull requestů
Sčítání proběhlo 2026-11-03 03:01:19 UTC s aktuálním stavem větve release/v3.8.5305bc048d6c. Stránkované sčítání GitHub GraphQL obsahuje 9,947 sloučených PR: 4,130 od vlastníka repozitáře, 240 od Dependabotu, 6 od ostatních botů/aplikací a 5,571 externích PR od 883 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, lockfiles, katalogy, překlady a dokumentaci; jde o objem změn, nikoli o autorské LOC. U 53 PR GitHub uvádí rozdíly větší než 500 000 řádků (například #13399, jediné přidání poskytovatele, uvádí 2 347 změněných souborů), což navyšuje několik výše uvedených součtů. Shodná pořadí jsou uvedena společně.
### Commity přiřazené GitHubem
Znovu ověřeno 2026-11-03 02:09:16 UTC: commity připisované GitHubu nahlášené rozhraním Contributors API repozitáře pro výchozí větev release/v3.8.53. API vrátilo 903 identit (429 uživatelů, 2 roboty, 472 anonymních identit); tato tabulka vylučuje správce, roboty a anonymní identity a zachovává shody v pořadí. Liší se od žebříčku sloučených PR výše i od níže uvedeného sčítání metadat Gitu.
> 🙏 Funkce, opravy chyb a vylepšení infrastruktury těchto přispěvatelů jsou **nedílnou součástí** toho, co dělá OmniRoute spolehlivým a bohatým na funkce. Každý pull request, každý testovací případ a každý překladový soubor i18n mají význam. Open source vzniká díky lidem, jako jsou oni.
---
## 💖 Sponzoři
Upřímné poděkování lidem, kteří financují OmniRoute z vlastní kapsy — každý příspěvek pomáhá projektu zůstat bezplatným, nezávislým a pokračovat v rozvoji.
… a další, kteří si přejí zůstat v soukromí 💛Veřejní sponzoři na GitHubu byli znovu ověřeni dne 2026-10-18 prostřednictvím rozhraní GitHub Sponsors GraphQL API: 11 veřejných sponzorství (6 aktivních, 5 dřívějších) z celkového počtu 14. Stav isActive na GitHubu určuje výše uvedená označení aktivních sponzorů; dřívějším veřejným jednorázovým podporovatelům nadále děkujeme a soukromí sponzoři zůstávají anonymní. Dary prostřednictvím Ko-fi, Buy Me a Coffee, Liberapay, PIX a kryptoměn nejsou uvedeny, protože o nich neexistuje veřejný záznam sponzora.💖 Staňte se sponzorem → — každý dolar pomáhá OmniRoute zůstat bezplatným a nezávislým.
## 👥 1 000+ přispěvatelů
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Auditováno dne 2026-11-02 na aktuálním vrcholu release/v3.8.531c7135e0fb (7 972 commitů): 1 074 normalizovaných lidských identit Git — 759 se objevuje jako autoři commitů (včetně správce) a 315 pouze v explicitních dodatcích Co-authored-by. Sčítání používá .mailmap, porovnává e-mailové adresy bez rozlišení velikosti písmen, spojuje číselné a běžné anonymní adresy GitHubu pouze tehdy, když kódují stejný účet, vylučuje 29 identit botů, agentů, služeb a zástupných identit a neslučuje běžné e-mailové adresy pouze na základě shody zobrazovaných jmen. Audit z 2026-08-24 uváděl 639; opětovné spuštění této metody nad jeho základním commitem ac02c5b42f dává 619, takže nárůst pochází od nových přispěvatelů, nikoli z volnější metody.
### Jak přispívat
1. Vytvořte fork repozitáře
2. Vytvořte větev z **aktivního** vrcholu `release/vX.Y.Z` (nikoli z `main`) — viz [Model větvení a vydávání verzí](docs/ops/BRANCHING_MODEL.md)
3. Vytvořte větev s funkcí (`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 žádost o začlenění se **základní větví = `release/vX.Y.Z`**
Podrobné pokyny najdete v [CONTRIBUTING.md](CONTRIBUTING.md).
### Vydání nové verze
```bash
# Vytvoření vydání — npm publish se provede 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 port projektu **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** z Go do TypeScriptu — a odtud byl každý níže uvedený subsystém inspirován open-source projektem, který s ním přišel jako první. Každý z nich formoval konkrétní část OmniRoute. Toto je naše poděkování všem. 🙏
> ⭐ počty hvězdiček ověřené pomocí REST API GitHubu 3. listopadu 2026 — běžte těmto projektům dát hvězdičku. Počty představují přesný snímek k danému datu a přirozeně se budou měnit.
### 🧬 Linie a brána
AI brána, jejíž veřejný dataset cen poskytuje data pro synchronizaci sledování nákladů a jejíž model normalizace poskytovatelů ovlivnil naše směrování.
Zdrojový kód pod licencí MIT upravený do vendovaného mostu ChatGPT Web → Codex Responses, včetně adaptérů pro relaci 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í hodnoty požadavků a zařízení a procesor odpovědí NDJSON byly podstatně upraveny do executorů Grok Web v OmniRoute.
Hlavní tranzitivní zdroj kódu stojící za grok2api-merged; jeho implementace modelů, hlaviček, payloadů, Statsig a procesoru jsou zachovány v linii Grok Web.
Základní zdroj pod licencí MIT pro payloady Grok a výchozí hodnoty zařízení, generátor Statsig a procesor result.response přenesený přes TQZHR a grok2api-merged.
Tranzitivní zdroj uvedený projektem grok2api-merged pro jeho vrstvu proxy poolu; OmniRoute toto upozornění na linii zachovává, ale netvrdí, že ve svém omezeném executoru Grok Web portuje proxy pool.
Jeho původní implementace Grok Web posloužila jako podklad pro návrh HTTP/browser upstreamu; jeho přímá HTTP cesta vychází z GrokProxy, takže není nárokováno žádné nezávislé portování kódu.
Virální projekt „proč používat mnoho tokenů, když stačí málo“ — 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 zhušťování.
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.
Komprese tokenů pro brazilskou portugalštinu — pohání náš jazykový balíček pt-BR: omezení pleonasmů a odstraňování výplňových slov vyladěné pro gramatiku brazilské portugalštiny.
Virální dovednost programátora ve stylu „líný seniorní vývojář“ podle principu YAGNI — inspirovala náš styl výstupu 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ů se strategií ukončení při selhání — potvrdila správnost našeho směrování podle typu a přeskočení při nedosažení minimální úspory.
Sloupcový JSON v Rustu + načítání podle obsahu + deduplikace napříč zprávami — potvrdily návrh našich enginů headroom/ccr/session-dedup a invariant stabilní pro mezipaměť „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 coding-assistant 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 čistými implementacemi založenými na veřejných protokolových standardech. Dvě plochy pro předávání hostitelů (passthrough.ts a _internal/bypass.cjs) zůstávají interními implementacemi OmniRoute, klasifikovanými samostatně; v rámci této náhrady nebyly přepsány.
Transparentní směrování proxy podle jednotlivých procesů — inspirovalo naše bezpečné ukončení MITM při pádu, časové limity nečinných socketů, přiřazování procesů pomocí /proc a zachytávání TPROXY.
Kurátorovaný seznam knihoven s bezpečnými výchozími nastaveními, který řídí naše bezpečnostní volby (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Identifikoval kvótu Grok Build; OmniRoute následně nezávisle ověřil a opravil aktuální wire formát.
## 📄 Licence
Licence MIT – podrobnosti najdete v [LICENSE](LICENSE).
---
**[⬆ Zpět nahoru](#-omniroute)** · Vytvořeno s ❤️ pro open-source komunitu AI.
Vytvořil Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Licence MIT · omniroute.online