OmniRoute/docs/i18n/cs

🚀 OmniRoute — The Free AI Gateway (Čeština)

🌐 Languages: 🇺🇸 English · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇮🇹 it · 🇷🇺 ru · 🇨🇳 zh-CN · 🇯🇵 ja · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi · 🇮🇳 in · 🇹🇭 th · 🇻🇳 vi · 🇮🇩 id · 🇲🇾 ms · 🇳🇱 nl · 🇵🇱 pl · 🇸🇪 sv · 🇳🇴 no · 🇩🇰 da · 🇫🇮 fi · 🇵🇹 pt · 🇷🇴 ro · 🇭🇺 hu · 🇧🇬 bg · 🇸🇰 sk · 🇺🇦 uk-UA · 🇮🇱 he · 🇵🇭 phi · 🇧🇷 pt-BR · 🇨🇿 cs · 🇹🇷 tr

---

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

Váš univerzální API proxy – jeden koncový bod, 60+ poskytovatelů, nulové prostoje. Nyní sMCP Server (25 nástrojů),Protokol A2A,Paměť/Skills SystemsaElectron Desktop App.

Dokončení chatu • Vložení • Generování obrázků • Video • Hudba • Zvuk • Změna pořadí •Vyhledávání na webu• Server MCP • Protokol A2A • 100% TypeScript---

🌐 Web • [🚀 Rychlý start](#-rychlý start) • 💡 Funkce • 📖 Dokumenty • [💰 Cena](#-cena-na první pohled) • 🬒 WhatsApp

🌐Dostupné v:🇺🇸 anglicky | 🇧🇷 Português (Brazílie) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 Deutsch | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dánsk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Maďarština | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugalsko) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino | 🇨🇿 Čeština---

🖼️ Main Dashboard

---

📸 Dashboard Preview

Kliknutím zobrazíte snímky obrazovky řídicího panelu

Strana	Snímek obrazovky
Poskytovatelé
Komba
Analytika
Zdraví
Překladatel
Nastavení
Nástroje CLI
Protokoly použití
Koncové body

---

🤖 Free AI Provider for your favorite coding agents

Připojte jakýkoli nástroj IDE nebo CLI s umělou inteligencí prostřednictvím OmniRoute – bezplatné brány API pro neomezené kódování.

OpenClaw
_{⭐ 205 000}
NanoBot
_{⭐ 20,9 000}
PicoClaw
_{⭐ 14,6 000}
ZeroClaw
_{⭐ 9,9 000}
IronClaw
_{⭐ 2,1 000}
OpenCode
_{⭐ 106 000}
Codex CLI
_{⭐ 60,8 000}
Claude Code
_{⭐ 67,3 000}
Gemini CLI
_{⭐ 94,7 000}
Kilový kód
_{⭐ 15,5 000}

_{📡 Všichni agenti se připojují přes http://localhost:20128/v1 nebo http://cloud.omniroute.online/v1 — jedna konfigurace, neomezené modely a kvóta}---

🤔 Why OmniRoute?

Přestaňte plýtvat penězi a narážet na limity:

– Kvóta předplatného vyprší nevyužita každý měsíc – Omezení sazby vám brání uprostřed kódování – Drahá rozhraní API (20–50 $ měsíčně na poskytovatele)

• Ruční přepínání mezi poskytovateli

OmniRoute to řeší:

• ✅Maximalizujte odběry- Sledujte kvótu, před resetováním použijte každý bit
• ✅Automatická záloha- Předplatné → Klíč API → Levné → Zdarma, nulové prostoje
• ✅Více účtů- Round-robin mezi účty na poskytovatele
• ✅Universal- Funguje s Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, jakýmkoliv nástrojem CLI---

📧 Support

💬Připojte se k naší komunitě!Skupina WhatsApp — Získejte nápovědu, sdílejte tipy a buďte v obraze.

-Web: omniroute.online -GitHub: github.com/diegosouzapw/OmniRoute -Problémy: github.com/diegosouzapw/OmniRoute/issues -WhatsApp: Skupina komunity -Přispívání: Podívejte se na CONTRIBUTING.md, otevřete PR nebo si vyberte „dobré první číslo“ -Původní projekt: 9router by decolua### 🐛 Reporting a Bug?

Při otevírání problému spusťte příkaz system-info a připojte vygenerovaný soubor:```bash npm run system-info

Tím se vygeneruje soubor `system-info.txt` s vaší verzí Node.js, verzí OmniRoute, podrobnostmi OS, nainstalovanými nástroji CLI (qoder, gemini, claude, codex, antigravity, droid atd.), stavem Docker/PM2 a systémovými balíčky – vše, co potřebujeme k rychlé reprodukci vašeho problému. Připojte soubor přímo k vašemu problému na GitHubu.---

## 🔄 How It Works

┌─────────────┐ │ Your CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) │ Tool │ └──────┬──────┘ │ http://localhost:20128/v1 ↓ ┌─────────────────────────────────────────┐ │ OmniRoute (Smart Router) │ │ • Format translation (OpenAI ↔ Claude) │ │ • Quota tracking + Embeddings + Images │ │ • Auto token refresh │ └──────┬──────────────────────────────────┘ │ ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI │ ↓ quota exhausted ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc. │ ↓ budget limit ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) │ ↓ budget limit └─→ [Tier 4: FREE] Qoder, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost

---

## 🎯 What OmniRoute Solves — 30 Real Pain Points & Use Cases

>**Každý vývojář používající nástroje AI čelí těmto problémům denně.**OmniRoute byl vytvořen tak, aby je vyřešil všechny – od překročení nákladů po regionální bloky, od přerušených toků OAuth po operace protokolů a podniková pozorovatelnost.

<podrobnosti>
<summary><b>💸 1. „Platím za drahé předplatné, ale stále mě vyrušují limity“</b></summary>

Vývojáři platí 20–200 $ měsíčně za Claude Pro, Codex Pro nebo GitHub Copilot. I při placení má kvóta strop – 5 hodin používání, týdenní limity nebo limity sazby za minutu. Uprostřed relace kódování poskytovatel přestane reagovat a vývojář ztrácí tok a produktivitu.

**Jak to řeší OmniRoute:**

-**Chytrý 4-úrovňový záložní zdroj**– Pokud dojde k vyčerpání kvóty předplatného, automaticky se přesměruje na klíč API → Levné → Zdarma s nulovým ručním zásahem
-**Sledování limitů poskytovatele**– Snímky kvót v mezipaměti se obnovují podle plánu na straně serveru (výchozí `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70`) s možností ručního obnovení v uživatelském rozhraní
–**Podpora více účtů**– Více účtů na poskytovatele s automatickým opakováním – když jeden dojde, přepne se na další
-**Vlastní komba**– Přizpůsobitelné záložní řetězce s 9 strategiemi vyvažování (prioritní, vážená, na prvním místě, s cyklem, P2C, náhodná, nejméně používaná, nákladově optimalizovaná, striktně náhodná)
-**Codex Business Quotas**— Sledování kvót Business/Tým pracovního prostoru přímo na řídicím panelu</details>

<podrobnosti>
<summary><b>🔌 2. „Potřebuji používat více poskytovatelů, ale každý má jiné API“</b></summary>

OpenAI používá jeden formát, Claude (Anthropic) jiný a Gemini ještě jiný. Pokud chce vývojář testovat modely od různých poskytovatelů nebo mezi nimi couvnout, musí překonfigurovat sady SDK, změnit koncové body, vypořádat se s nekompatibilními formáty. Vlastní poskytovatelé (FriendLI, NIM) mají nestandardní koncové body modelu.

**Jak to řeší OmniRoute:**

-**Unified Endpoint**– Jediný `http://localhost:20128/v1` slouží jako proxy pro všech 60+ poskytovatelů
-**Formátový překlad**— Automatický a transparentní: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
-**Response Sanitization**– Odstraňuje nestandardní pole (`x_groq`, `usage_breakdown`, `service_tier`), která porušují OpenAI SDK v1.83+
-**Normalizace rolí**— Převádí `vývojář` → `systém` pro poskytovatele, kteří nejsou OpenAI; `systém` → `uživatel` pro GLM/ERNIE
–**Think Tag Extraction**– Extrahuje bloky „<think>“ z modelů jako DeepSeek R1 do standardizovaného „reasoning_content“
-**Strukturovaný výstup pro Gemini**— `json_schema` → automatický převod `responseMimeType`/`responseSchema`
-**`stream` má výchozí hodnotu `false`**— Vyhovuje specifikaci OpenAI a zabraňuje neočekávanému SSE v sadách Python/Rust/Go SDK</details>

<podrobnosti>
<summary><b>🌐 3. „Můj poskytovatel umělé inteligence blokuje můj region/země“</b></summary>

Poskytovatelé jako OpenAI/Codex blokují přístup z určitých geografických oblastí. Během připojení OAuth a rozhraní API se uživatelům zobrazují chyby jako „unsupported_country_region_territory“. To je frustrující zejména pro vývojáře z rozvojových zemí.

**Jak to řeší OmniRoute:**

–**3úrovňová konfigurace proxy**– konfigurovatelný proxy na 3 úrovních: globální (veškerý provoz), podle poskytovatele (pouze jeden poskytovatel) a podle připojení/klíče
-**Barevně kódované odznaky proxy**— Vizuální indikátory: 🢢 globální proxy, 🟡 proxy poskytovatele, 🔵 proxy připojení, vždy zobrazující IP
-**Výměna tokenů OAuth přes proxy**– tok OAuth prochází také přes proxy a řeší se `unsupported_country_region_territory`
-**Testy připojení přes proxy**— Testy připojení používají nakonfigurovaný proxy (už žádné přímé obcházení)
-**Podpora SOCKS5**— Plná podpora proxy SOCKS5 pro odchozí směrování
-**TLS Fingerprint Spoofing**– TLS otisk prstu podobný prohlížeči přes `wreq-js` k obejití detekce botů
-**🔏 CLI Fingerprint Matching**– Změní pořadí hlaviček a polí těla tak, aby odpovídaly nativním binárním podpisům CLI, čímž se výrazně sníží riziko označení účtu. IP proxy serveru je zachována – získáte současně maskování IP maskování**a**utajení</details>

<podrobnosti>
<summary><b>🆓 4. „Chci používat AI pro kódování, ale nemám peníze“</b></summary>

Ne každý může platit 20–200 $ měsíčně za předplatné AI. Studenti, vývojáři z rozvíjejících se zemí, fandové a nezávislí pracovníci potřebují přístup ke kvalitním modelům za nulové náklady.

**Jak to řeší OmniRoute:**

-**Vestavění poskytovatelé bezplatných úrovní**— Nativní podpora pro 100% bezplatné poskytovatele: Qoder (5 neomezených modelů prostřednictvím OAuth: kimi-k2-thinking, qwen3-coder-plus, deepseek-r1, minimax-m2, kimi-k2), Qwen (4 neomezené modely: qwen3-qwender-lash, qwen3-coder-next, vision-model), Kiro (Claude + AWS Builder ID zdarma), Gemini CLI (180 000 tokenů/měsíc zdarma)
-**Ollama Cloud**– modely Ollama hostované v cloudu na `api.ollama.com` s bezplatnou úrovní „Light use“; použijte předponu `ollamacloud/<model>`
–**komba pouze zdarma**– řetězec `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = 0 $/měsíc s nulovými prostoji
-**Volný přístup NVIDIA NIM**— ~40 RPM pro vývojáře - navždy bezplatný přístup k více než 70 modelům na build.nvidia.com (přechod z kreditů na limity čisté sazby)
-**Cost Optimized Strategy**– Strategie směrování, která automaticky vybírá nejlevnějšího dostupného poskytovatele</details>

<podrobnosti>
<summary><b>🔒 5. „Potřebuji chránit svou bránu AI před neoprávněným přístupem“</b></summary>

Při vystavení brány AI do sítě (LAN, VPS, Docker) může kdokoli s adresou spotřebovat tokeny/kvótu vývojáře. Bez ochrany jsou rozhraní API zranitelná vůči zneužití, rychlému vložení a zneužití.

**Jak to řeší OmniRoute:**

-**Správa klíčů API**– Generování, rotace a rozsah podle poskytovatele pomocí vyhrazené stránky `/dashboard/api-manager`
-**Oprávnění na úrovni modelu**– Omezte klíče API na konkrétní modely (`openai/*`, vzory zástupných znaků) pomocí přepínače Povolit vše/Omezit
-**API Endpoint Protection**– Vyžadovat klíč pro `/v1/models` a blokovat konkrétní poskytovatele ze seznamu
-**Auth Guard + ochrana CSRF**– Všechny cesty řídicího panelu chráněny middlewarem „withAuth“ + tokeny CSRF
-**Rate Limiter**— omezení rychlosti na IP pomocí konfigurovatelných oken
-**IP Filtering**— Seznam povolených/blokovaných pro řízení přístupu
-**Prompt Injection Guard**– Dezinfekce proti škodlivým vzorům výzev
-**Šifrování AES-256-GCM**— Přihlašovací údaje jsou v klidu zašifrovány</details>

<podrobnosti>
<summary><b>🛑 6. "Můj poskytovatel selhal a ztratil jsem tok kódování"</b></summary>

Poskytovatelé umělé inteligence se mohou stát nestabilními, vracet chyby 5xx nebo narazit na dočasné limity sazeb. Pokud vývojář závisí na jediném poskytovateli, je přerušen. Bez jističů mohou opakované pokusy způsobit selhání aplikace.

**Jak to řeší OmniRoute:**

-**Jistič pro každý model**— Automatické otevírání/zavírání s konfigurovatelnými prahovými hodnotami a ochlazením (zavřeno/otevřeno/polootevřeno), s rozsahem pro každý model, aby se zabránilo kaskádovým blokům
-**Exponential Backoff**— Progresivní zpoždění opakování
-**Anti-Thundering Herd**— Mutex + semaforová ochrana proti souběžným opakovaným bouřím
-**Combo Fallback Chains**— Pokud primární poskytovatel selže, automaticky projde řetězcem bez zásahu
-**Combo Circuit Breaker**– Automaticky deaktivuje selhávající poskytovatele v rámci kombinovaného řetězce
–**Health Dashboard**– Monitorování provozuschopnosti, stavy jističů, uzamčení, statistiky mezipaměti, latence p50/p95/p99</details>

<podrobnosti>
<summary><b>🔧 7. „Konfigurace každého nástroje umělé inteligence je únavná a opakující se“</b></summary>

Vývojáři používají Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Každý nástroj potřebuje jinou konfiguraci (API endpoint, klíč, model). Překonfigurování při změně poskytovatele nebo modelu je ztráta času.

**Jak to řeší OmniRoute:**

-**CLI Tools Dashboard**– Vyhrazená stránka s nastavením jedním kliknutím pro Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline
–**GitHub Copilot Config Generator**– Generuje `chatLanguageModels.json` pro kód VS s hromadným výběrem modelu
-**Průvodce přihlášením**– Průvodce nastavením ve 4 krocích pro začínající uživatele
–**Jeden koncový bod, všechny modely**– Jednou nakonfigurujte `http://localhost:20128/v1`, získáte přístup k více než 60 poskytovatelům</details>

<podrobnosti>
<summary><b>🔑 8. „Správa tokenů OAuth od více poskytovatelů je peklo“</b></summary>

Claude Code, Codex, Gemini CLI, Copilot – všechny používají OAuth 2.0 s končícími tokeny. Vývojáři se musí neustále znovu autentizovat, řešit `client_secret is missing`, `redirect_uri_mismatch` a selhání na vzdálených serverech. Zvláště problematické je OAuth na LAN/VPS.

**Jak to řeší OmniRoute:**

-**Automatické obnovení tokenu**– Tokeny OAuth se před vypršením platnosti obnovují na pozadí
-**Vestavěný OAuth 2.0 (PKCE)**— Automatický tok pro Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, Qoder
–**Multi-Account OAuth**– Více účtů na poskytovatele prostřednictvím extrakce tokenů JWT/ID
-**OAuth LAN/Remote Fix**— Detekce privátní IP adresy pro `redirect_uri` + ruční režim URL pro vzdálené servery
-**OAuth Behind Nginx**– Používá `window.location.origin` pro zpětnou kompatibilitu proxy
–**Průvodce vzdáleným OAuth**– Podrobný průvodce pro přihlašovací údaje Google Cloud na VPS/Docker</details>

<podrobnosti>
<summary><b>📊 9. "Nevím, kolik a kde utrácím"</b></summary>

Vývojáři využívají více placených poskytovatelů, ale nemají jednotný pohled na výdaje. Každý poskytovatel má svůj vlastní panel fakturace, ale neexistuje žádné konsolidované zobrazení. Neočekávané náklady se mohou nahromadit.

**Jak to řeší OmniRoute:**

-**Cost Analytics Dashboard**– Sledování nákladů na token a správa rozpočtu na poskytovatele
-**Rozpočtové limity na úroveň**– Strop útraty na úroveň, který spouští automatickou rezervu
-**Konfigurace cen za model**– Konfigurovatelné ceny za model
-**Statistika využití na klíč API**— Počet požadavků a naposledy použité časové razítko na klíč
–**Panel Analytics**– Statistické karty, graf využití modelu, tabulka poskytovatelů s mírou úspěšnosti a latencí</details>

<podrobnosti>
<summary><b>🐛 10. „Nemohu diagnostikovat chyby a problémy ve voláních AI“</b></summary>

Když se volání nezdaří, vývojář neví, zda to byl limit sazby, vypršela platnost tokenu, nesprávný formát nebo chyba poskytovatele. Fragmentované protokoly napříč různými terminály. Bez pozorovatelnosti je ladění metodou pokus-omyl.

**Jak to řeší OmniRoute:**

-**Sjednocený panel protokolů**– 4 karty: Protokoly požadavků, Protokoly proxy, Protokoly auditu, Konzole
-**Console Log Viewer**— Prohlížeč ve stylu terminálu v reálném čase s barevně odlišenými úrovněmi, automatickým posouváním, vyhledáváním, filtrem
-**Protokoly SQLite Proxy**— Trvalé protokoly, které vydrží restartování serveru
-**Translator Playground**— 4 režimy ladění: Playground (překlad formátu), Tester chatu (zpáteční), Test Bench (dávka), Live Monitor (v reálném čase)
–**Požadavek na telemetrii**– latence p50/p95/p99 + sledování X-Request-Id
-**Protokolování založené na souborech s rotací**– Protokoly aplikací se střídají podle velikosti, dnů uchování a počtu archivů; Artefakty protokolu hovorů rotují podle dnů uchování a počtu souborů
-**System Info Report**— `npm run system-info` vygeneruje `system-info.txt` s vaším úplným prostředím (verze uzlu, verze OmniRoute, OS, nástroje CLI, stav Docker/PM2). Připojte jej při hlášení problémů pro okamžité třídění.</details>

<podrobnosti>
<summary><b>🏗️ 11. „Nasazení a údržba brány je složitá“</b></summary>

Instalace, konfigurace a údržba AI proxy v různých prostředích (místní, VPS, Docker, cloud) je náročná na práci. Problémy jako pevně zakódované cesty, „EACCES“ v adresářích, konflikty portů a sestavení napříč platformami zvyšují tření.

**Jak to řeší OmniRoute:**

-**Globální instalace npm**– `npm install -g omniroute && omniroute` – hotovo
-**Docker Multi-Platform**– nativní AMD64 + ARM64 (Apple Silicon, AWS Graviton, Raspberry Pi)
-**Docker Compose Profiles**– `base` (žádné nástroje CLI) a `cli` (s Claude Code, Codex, OpenClaw)
-**Electron Desktop App**– nativní aplikace pro Windows/macOS/Linux se systémovou lištou, automatickým spuštěním, offline režimem
-**Split-Port Mode**– API a Dashboard na samostatných portech pro pokročilé scénáře (reverzní proxy, kontejnerová síť)
-**Cloud Sync**— Konfigurace synchronizace mezi zařízeními pomocí Cloudflare Workers
-**DB Backups**— Automatické zálohování, obnova, export a import všech nastavení s `DISABLE_SQLITE_AUTO_BACKUP` pro externě spravované zálohy</details>

<podrobnosti>
<summary><b>🌍 12. "Rozhraní je pouze v angličtině a můj tým nemluví anglicky"</b></summary>

Týmy v neanglicky mluvících zemích, zejména v Latinské Americe, Asii a Evropě, se potýkají s rozhraním pouze v angličtině. Jazykové bariéry snižují přijetí a zvyšují chyby konfigurace.

**Jak to řeší OmniRoute:**

-**Dashboard i18n — 30 jazyků**— Všech 500+ kláves přeloženo včetně arabštiny, bulharštiny, dánštiny, němčiny, španělštiny, finštiny, francouzštiny, hebrejštiny, hindštiny, maďarštiny, indonéštiny, italštiny, japonštiny, korejštiny, malajštiny, holandštiny, norštiny, polštiny, portugalštiny (PT/BR), rumunštiny, ruštiny, slovenštiny, švédštiny, thajštiny, filipínštiny, vietnamštiny, angličtiny
-**Podpora RTL**— Podpora zprava doleva pro arabštinu a hebrejštinu
-**Vícejazyčné README**— 30 kompletních překladů dokumentace
-**Language Selector**— Ikona zeměkoule v záhlaví pro přepínání v reálném čase</details>

<podrobnosti>
<summary><b>🔄 13. „Potřebuji víc než jen chat – potřebuji vložení, obrázky, zvuk“</b></summary>

AI není jen dokončení chatu. Vývojáři potřebují generovat obrázky, přepisovat zvuk, vytvářet vložení pro RAG, měnit hodnocení dokumentů a moderovat obsah. Každé API má jiný koncový bod a formát.

**Jak to řeší OmniRoute:**

-**Vložení**— `/v1/embeddings` se 6 poskytovateli a 9+ modely
-**Generace obrázků**— `/v1/images/generations` s 10 poskytovateli a 20+ modely (OpenAI, xAI, Together, Fireworks, Nebius, Hyperbolic, NanoBanana, Antigravity, SD WebUI, ComfyUI)
-**Text-to-Video**— `/v1/videos/generations` — ComfyUI (AnimateDiff, SVD) a SD WebUI
-**Text-to-Music**— `/v1/music/generations` — ComfyUI (Stable Audio Open, MusicGen)
-**Audio Transscription**— `/v1/audio/transscriptions` — Whisper + Nvidia NIM, HuggingFace, Qwen3
-**Text-to-Speech**— `/v1/audio/speech` — ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3,**Inworld**,**Cartesia**,**PlayHT**, + stávající poskytovatelé
-**Moderations**— `/v1/moderations` — Kontroly bezpečnosti obsahu
-**Přehodnocení**— `/v1/rerank` — Změna pořadí podle relevance dokumentu
-**Responses API**— Plná podpora `/v1/responses` pro Codex</details>

<podrobnosti>
<summary><b>🧪 14. „Nemám způsob, jak testovat a porovnávat kvalitu napříč modely“</b></summary>

Vývojáři chtějí vědět, který model je pro jejich případ použití nejlepší – kód, překlad, uvažování – ale ruční porovnávání je pomalé. Neexistují žádné integrované nástroje eval.

**Jak to řeší OmniRoute:**

-**Hodnocení LLM**– Testování zlaté sady s 10 předem nahranými případy zahrnujícími pozdravy, matematiku, geografii, generování kódu, soulad s JSON, překlad, markdown, bezpečnostní odmítnutí
-**4 strategie shody**– `přesné`, `obsahuje`, `regulární výraz`, `vlastní` (funkce JS)
-**Testovací stolice pro překladatelské hřiště**– Dávkové testování s více vstupy a očekávanými výstupy, porovnání mezi poskytovateli
-**Chat Tester**– Kompletní zpáteční cesta s vykreslováním vizuální odezvy
-**Live Monitor**— Tok všech požadavků procházejících přes proxy v reálném čase</details>

<podrobnosti>
<summary><b>📈 15. „Potřebuji škálovat bez ztráty výkonu“</b></summary>

Jak roste objem požadavků, bez ukládání stejných otázek do mezipaměti vznikají duplicitní náklady. Bez idempotence duplikát požaduje zpracování odpadu. Musí být dodrženy limity sazeb na poskytovatele.

**Jak to řeší OmniRoute:**

-**Sémantická mezipaměť**– Dvouvrstvá mezipaměť (podpis + sémantická) snižuje náklady a latenci
-**Idempotency požadavku**— 5s deduplikační okno pro identické požadavky
–**Detekce limitu rychlosti**– RPM na poskytovatele, minimální mezera a maximální souběžné sledování
-**Upravitelné limity rychlosti**– Konfigurovatelné výchozí hodnoty v Nastavení → Odolnost s perzistencí
-**API Key Validation Cache**– 3vrstvá mezipaměť pro produkční výkon
–**Health Dashboard s telemetrií**– latence p50/p95/p99, statistiky mezipaměti, doba provozu</details>

<podrobnosti>
<summary><b>🤖 16. „Chci globálně ovládat chování modelu“</b></summary>

Vývojáři, kteří chtějí všechny odpovědi v konkrétním jazyce, s konkrétním tónem nebo chtějí omezit tokeny uvažování. Konfigurace tohoto v každém nástroji/požadavku je nepraktická.

**Jak to řeší OmniRoute:**

-**System Prompt Injection**– Globální výzva aplikovaná na všechny požadavky
-**Thinking Budget Validation**— Řízení alokace tokenů na základě požadavku (průchozí, automatické, vlastní, adaptivní)
-**9 směrovacích strategií**— Globální strategie, které určují způsob distribuce požadavků
-**Wildcard Router**– vzory `poskytovatel/*` se dynamicky směrují k libovolnému poskytovateli
-**Povolit/zakázat přepínání komba**— Přepínejte komba přímo z řídicího panelu
-**Přepnutí poskytovatele**— Povolí/zakáže všechna připojení pro poskytovatele jedním kliknutím
–**Blokovaní poskytovatelé**– vyloučení konkrétních poskytovatelů ze seznamu `/v1/models`</details>

<podrobnosti>
<summary><b>🧰 17. „Potřebuji nástroje MCP jako prvotřídní možnosti produktu“</b></summary>

Mnoho bran AI odhaluje MCP pouze jako skrytý detail implementace. Týmy potřebují viditelnou a spravovatelnou provozní vrstvu.

**Jak to řeší OmniRoute:**

- MCP se objeví na navigačním panelu a na kartě protokolu koncového bodu
- Vyhrazená stránka správy MCP s procesem, nástroji, rozsahy a auditem
- Vestavěný rychlý start pro `omniroute --mcp` a přihlášení klienta</details>

<podrobnosti>
<summary><b>🧠 18. „Potřebuji orchestraci A2A s cestami synchronizace + streamování“</b></summary>

Pracovní postupy agentů vyžadují jak přímé odpovědi, tak dlouhotrvající streamované spouštění s řízením životního cyklu.

**Jak to řeší OmniRoute:**

– Koncový bod A2A JSON-RPC (`POST /a2a`) s `zprávou/odeslat` a `zprávou/streamem`
- SSE streamování s šířením koncového stavu
- Rozhraní API životního cyklu úloh pro `tasks/get` a `tasks/cancel`</details>

<podrobnosti>
<summary><b>🛰️ 19. „Potřebuji skutečný stav procesu MCP, nikoli odhadovaný stav“</b></summary>

Operační týmy potřebují vědět, zda je MCP skutečně naživu, nejen zda je API dosažitelné.

**Jak to řeší OmniRoute:**

- Soubor srdečního tepu za běhu s PID, časovými razítky, transportem, počtem nástrojů a režimem rozsahu
- Stavové API MCP kombinující srdeční tep + nedávnou aktivitu
- Stavové karty uživatelského rozhraní pro aktuálnost procesu / provozuschopnosti / srdečního tepu</details>

<podrobnosti>
<summary><b>📋 20. „Potřebuji provádění auditovatelného nástroje MCP“</b></summary>

Když nástroje mutují konfiguraci nebo spouštějí operace operací, týmy potřebují forenzní sledovatelnost.

**Jak to řeší OmniRoute:**

- Protokolování auditu podporované SQLite pro volání nástrojů MCP
- Filtry podle nástroje, úspěchu/neúspěchu, klíče API a stránkování
- Tabulka auditu řídicího panelu + statistiky koncových bodů pro automatizaci</details>

<podrobnosti>
<summary><b>🔐 21. „Potřebuji omezená oprávnění MCP na integraci“</b></summary>

Různí klienti by měli mít nejméně privilegovaný přístup ke kategoriím nástrojů.

**Jak to řeší OmniRoute:**

- 10 granulárních rozsahů MCP pro řízený přístup k nástrojům
- Vynucení rozsahu a viditelnost v uživatelském rozhraní správy MCP
- Bezpečná výchozí poloha pro provozní nástroje</details>

<podrobnosti>
<summary><b>⚙️ 22. „Potřebuji provozní kontroly bez přerozdělování“</b></summary>

Týmy potřebují rychlé změny běhového prostředí během incidentů nebo nákladových událostí.

**Jak to řeší OmniRoute:**

- Aktivace kombinace přepínačů přímo z řídicího panelu MCP
- Použijte profily odolnosti z předdefinovaných balíčků zásad
- Resetujte stav jističe ze stejného ovládacího panelu</details>

<podrobnosti>
<summary><b>🔄 23. „Potřebuji živou viditelnost a zrušení životního cyklu úkolu A2A“</b></summary>

Bez viditelnosti životního cyklu je obtížné třídit incidenty úkolů.

**Jak to řeší OmniRoute:**

- Seznam úkolů / filtrování podle stavu / dovedností se stránkováním
- Podrobnější informace o metadatech úkolů, událostech a artefaktech
- Koncový bod zrušení úlohy a akce uživatelského rozhraní s potvrzením</details>

<podrobnosti>
<summary><b>🌊 24. „Potřebuji aktivní metriky streamu pro zatížení A2A“</b></summary>

Streamovací pracovní postupy vyžadují provozní přehled o souběžných a živých připojeních.

**Jak to řeší OmniRoute:**

- Aktivní čítače toku integrované do stavu A2A
- Časové razítko posledního úkolu a počty za stav
- Karty palubní desky A2A pro monitorování operací v reálném čase</details>

<podrobnosti>
<summary><b>🪪 25. „Potřebuji pro klienty zjišťování standardních agentů“</b></summary>

Externí klienti a orchestrátoři potřebují strojově čitelná metadata pro integraci.

**Jak to řeší OmniRoute:**

- Karta agenta vystavena na adrese `/.well-known/agent.json`
- Schopnosti a dovednosti zobrazené v uživatelském rozhraní pro správu
- A2A status API obsahuje metadata zjišťování pro automatizaci</details>

<podrobnosti>
<summary><b>🧭 26. „Potřebuji zjistitelnost protokolu v uživatelském rozhraní produktu“</b></summary>

Pokud uživatelé nemohou objevit protokolové povrchy, kvalita přijetí a podpory klesá.

**Jak to řeší OmniRoute:**

– Konsolidovaná stránka**Koncové body**s kartami pro koncové body proxy, MCP, A2A a API
- Přepínání stavu inline služby (Online/Offline) pro MCP a A2A
- Odkazy z přehledu na vyhrazené karty správy</details>

<podrobnosti>
<summary><b>🧪 27. „Potřebuji komplexní ověření protokolu se skutečnými klienty“</b></summary>

Falešné testy nestačí k ověření kompatibility protokolu před vydáním.

**Jak to řeší OmniRoute:**

- Sada E2E, která spouští aplikaci a používá skutečný přenos klienta MCP SDK
- Klient A2A testuje toky zjišťování, odesílání, streamování, získávání a rušení
- Křížová kontrola tvrzení proti auditu MCP a API úloh A2A</details>

<podrobnosti>
<summary><b>📡 28. „Potřebuji jednotnou pozorovatelnost napříč všemi rozhraními“</b></summary>

Rozdělení pozorovatelnosti protokolem vytváří slepá místa a delší MTTR.

**Jak to řeší OmniRoute:**

- Sjednocené dashboardy/logy/analýzy v jednom produktu
- Zdraví + audit + telemetrie požadavků napříč vrstvami OpenAI, MCP a A2A
- Provozní API pro stav a automatizaci</details>

<podrobnosti>
<summary><b>💼 29. "Potřebuji jeden runtime pro proxy + nástroje + orchestraci agenta"</b></summary>

Provozování mnoha samostatných služeb zvyšuje provozní náklady a způsoby selhání.

**Jak to řeší OmniRoute:**

- Proxy, MCP server a A2A server v jednom zásobníku kompatibilní s OpenAI
- Sdílená autentizace, odolnost, úložiště dat a pozorovatelnost
- Konzistentní model politiky na všech interakčních plochách</details>

<podrobnosti>
<summary><b>🚀 30. „Potřebuji odeslat agentské pracovní postupy bez rozšiřování kódu lepidla“</b></summary>

Týmy ztrácejí rychlost při spojování více ad-hoc služeb a skriptů.

**Jak to řeší OmniRoute:**

- Jednotná strategie koncových bodů pro klienty a agenty
- Vestavěná uživatelská rozhraní pro správu protokolů a cesty ověřování kouře
- Základy připravené na výrobu (zabezpečení, protokolování, odolnost, zálohování)</details>

### Example Playbooks (Integrated Use Cases)

**Příručka A: Maximalizujte placené předplatné + levné zálohování**```txt
Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

Monthly cost: $20 + small backup spend
Outcome: higher quality, near-zero interruption

Příručka B: Sada kódování s nulovými náklady```txt Combo: "free-forever"

1. gc/gemini-3-flash
2. if/kimi-k2-thinking
3. qw/qwen3-coder-plus

Monthly cost: $0 Outcome: stable free coding workflow

**Příručka C: 24/7 vždy zapnutý záložní řetězec**```txt
Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads

Příručka D: Operace agenta s MCP + A2A```txt

1. Start MCP transport (omniroute --mcp) for tool-driven operations
2. Run A2A tasks via message/send and message/stream
3. Observe via /dashboard/endpoint (MCP and A2A tabs)
4. Toggle services via inline status controls

---

## 🆓 Start Free — Zero Configuration Cost

> Nastavení kódování AI během několika minut za**$0/měsíc**. Propojte tyto bezplatné účty a použijte vestavěnou kombinaci**Free Stack**.

| Krok | Akce | Poskytovatelé odemčeni |
| ---- | --------------------------------------------------- | ------------------------------------------------------------------- |
| 1 | Connect**Kiro**(AWS Builder ID OAuth) | Claude Sonnet 4.5, Haiku 4.5 —**neomezeno**|
| 2 | Připojte**Qoder**(Google OAuth) | kimi-k2-thinking, qwen3-coder-plus, deepseek-r1... —**bez omezení**|
| 3 | Připojte**Qwen**(kód zařízení) | qwen3-coder-plus, qwen3-coder-flash... —**bez omezení**|
| 4 | Připojte**Gemini CLI**(Google OAuth) | gemini-3-flash, gemini-2.5-pro —**180 000/měsíc zdarma**|
| 5 | `/dashboard/combos` → Šablona**Free Stack (0 $)**| Round-robin všechny bezplatné poskytovatele automaticky |

**Nasměrujte libovolné IDE/CLI na:**`http://localhost:20128/v1` · Klíč API: `any-string` · Hotovo.

>**Volitelné dodatečné pokrytí (také zdarma):**Klíč Groq API (30 RPM zdarma), NVIDIA NIM (40 RPM zdarma, 70+ modelů), Cerebras (1 M token/den), LongCat API klíč (50 M tokenů/den!), Cloudflare Workers AI (10 000 neuronů/den, 50+ modelů).## Rychlý start

### 1) Install and run

```bash
npm install -g omniroute
omniroute

**Uživatelé pnpm:**Po instalaci spusťte příkaz pnpm accept-builds -g, abyste povolili nativní skripty sestavení vyžadované better-sqlite3 a @swc/core:

pnpm install -g omniroute
pnpm schválit-builds -g # Vybrat všechny balíčky → schválit
omniroute

Dashboard se otevře na adrese http://localhost:20128 a základní adresa URL API je http://localhost:20128/v1.

Příkaz	Popis
"všestranná cesta"	Spustit server (PORT=20128, API a řídicí panel na stejném portu)
omniroute --port 3000	Nastavte kanonický/API port na 3000
omniroute --mcp	Spustit MCP server (stdio transport)
omniroute --no-open	Neotevírat automaticky prohlížeč
omniroute --help	Zobrazit nápovědu

Volitelný režim rozděleného portu:```bash PORT=20128 DASHBOARD_PORT=20129 omniroute

API: http://localhost:20128/v1

Dashboard: http://localhost:20129

### Long-Running Streaming Timeouts

Pro většinu nasazení potřebujete pouze:

| Proměnná | Výchozí | Účel |
| ------------------------- | ------------------------------ | ------------------------------------------------------------- -------------------------------------------------------------- |
| `REQUEST_TIMEOUT_MS` | "600 000" | Sdílená základní linie pro upstream načítání, skryté časové limity Undici, požadavky otisků prstů TLS a časové limity požadavků/proxy mostu API |
| `STREAM_IDLE_TIMEOUT_MS` | zdědí `REQUEST_TIMEOUT_MS` | Maximální mezera mezi streamovanými bloky, než OmniRoute přeruší stream SSE |

Zpětná kompatibilita je zachována: stávající `FETCH_TIMEOUT_MS`, `API_BRIDGE_PROXY_TIMEOUT_MS` a další proměnná časového limitu pro jednotlivé vrstvy stále fungují a přepisují sdílenou základní linii.

Pokud potřebujete jemnější ovládání, jsou k dispozici pokročilé přepisy:| Proměnná | Výchozí | Účel |
| ----------------------------------------- | ------------------------------------------- | --------------------------------------------------------------------- |
| `FETCH_TIMEOUT_MS` | zdědí `REQUEST_TIMEOUT_MS` | Celkový časový limit upstream požadavku použitý signálem přerušení hlavního načítání |
| `FETCH_HEADERS_TIMEOUT_MS` | zdědí `FETCH_TIMEOUT_MS` | Undici časový limit pro příjem upstream hlaviček odpovědí |
| `FETCH_BODY_TIMEOUT_MS` | zdědí `FETCH_TIMEOUT_MS` | Undici časový limit mezi upstream body těla (`0` to zakáže) |
| `FETCH_CONNECT_TIMEOUT_MS` | "30 000" | Vypršel časový limit připojení Undici TCP |
| `FETCH_KEEPALIVE_TIMEOUT_MS` | "4000" | Undici nečinný keep-alive socket timeout |
| `TLS_CLIENT_TIMEOUT_MS` | zdědí `FETCH_TIMEOUT_MS` | Vypršel časový limit pro požadavky otisku TLS provedené prostřednictvím `wreq-js` |
| `API_BRIDGE_PROXY_TIMEOUT_MS` | zdědí `REQUEST_TIMEOUT_MS` nebo `30000` | Časový limit pro přesměrování proxy `/v1` z portu API na port řídicího panelu |
| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `max(API_BRIDGE_PROXY_TIMEOUT_MS, 300000)` | Časový limit příchozího požadavku na serveru API mostu |
| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | "60 000" | Časový limit příchozí hlavičky na serveru API mostu |
| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | "5000" | Udržovací časový limit na serveru API mostu |
| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | "0" | Časový limit nečinnosti soketu na serveru API mostu (`0` jej zakáže) |

Pokud spouštíte OmniRoute za Nginx, Caddy, Cloudflare nebo jiným reverzním proxy, ujistěte se, že proxy
časové limity jsou také vyšší než časové limity streamu/načtení OmniRoute.### 2) Connect providers and create your API key

1. Otevřete Dashboard → `Providers` a připojte alespoň jednoho poskytovatele (OAuth nebo API klíč).
2. Otevřete Dashboard → `Koncové body` a vytvořte klíč API.
3. (Volitelné) Otevřete Dashboard → `Komba` a nastavte svůj záložní řetězec.### 3) Point your coding tool to OmniRoute

```txt
Base URL: http://localhost:20128/v1
API Key:  [copy from Endpoint page]
Model:    if/kimi-k2-thinking (or any provider/model prefix)

Pracuje s Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, OpenClaw, OpenCode a SDK kompatibilní s OpenAI.### 4) Enable and validate protocols (v2.0)

MCP (pro operace řízené nástrojem):```bash omniroute --mcp

Poté připojte svého MCP klienta přes `stdio` a otestujte nástroje jako:

- `omniroute_get_health`
- `combos_omniroute_list_combos`

**A2A (pro pracovní postupy mezi agenty):**```bash
curl http://localhost:20128/.well-known/agent.json

curl -X POST http://localhost:20128/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}'

5) Validate everything end-to-end (recommended)

npm run test:protocols:e2e

Tato sada ověřuje skutečné klientské toky MCP a A2A proti běžící aplikaci.### Alternative: run from source

cp .env.example .env
npm install
PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev

Void Linux (šablona `xbps-src`)

Pro uživatele Void Linuxu můžete vytvořit nativní balíček pomocí xbps-src. Uložte tento blok jako srcpkgs/omniroute/template:```bash

Template file for 'omniroute'

pkgname=omniroute version=3.4.1 revision=1 hostmakedepends="nodejs python3 make" depends="openssl" short_desc="Universal AI gateway with smart routing for multiple LLM providers" maintainer="zenobit zenobit@disroot.org" license="MIT" homepage="https://github.com/diegosouzapw/OmniRoute" distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz" checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b system_accounts="_omniroute" omniroute_homedir="/var/lib/omniroute" export NODE_ENV=production export npm_config_engine_strict=false export npm_config_loglevel=error export npm_config_fund=false export npm_config_audit=false

do_build() { # Determine target CPU arch for node-gyp local _gyp_arch case "$XBPS_TARGET_MACHINE" in aarch64*) _gyp_arch=arm64 ;; armv7*|armv6*) _gyp_arch=arm ;; i686*) _gyp_arch=ia32 ;; *) _gyp_arch=x64 ;; esac

# 1) Install all deps – skip scripts (no network in do_build, native modules
#    compiled separately below; better-sqlite3 is serverExternalPackage so
#    Next.js does not execute it during next build)
NODE_ENV=development npm ci --ignore-scripts

# 2) Build the Next.js standalone bundle
npm run build

# 3) Copy static assets into standalone
cp -r .next/static .next/standalone/.next/static
[ -d public ] && cp -r public .next/standalone/public || true

# 4) Compile better-sqlite3 native binding for the target architecture.
#    Use node-gyp directly so CC/CXX from xbps-src cross-toolchain are used
#    without npm altering them.
local _node_gyp=/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js
(cd node_modules/better-sqlite3 && node "$_node_gyp" rebuild --arch="$_gyp_arch")

# 5) Place the compiled binding into the standalone bundle
local _bs3_release=.next/standalone/node_modules/better-sqlite3/build/Release
mkdir -p "$_bs3_release"
cp node_modules/better-sqlite3/build/Release/better_sqlite3.node "$_bs3_release/"

# 6) Remove arch-specific sharp bundles – upstream sets images.unoptimized=true
#    so sharp is not used at runtime; x64 .so files would break aarch64 strip
rm -rf .next/standalone/node_modules/@img

# 7) Copy pino runtime deps omitted by Next.js static analysis:
#    pino-abstract-transport – required by pino's worker thread
#    split2 – dep of pino-abstract-transport
#    process-warning – dep of pino itself
for _mod in pino-abstract-transport split2 process-warning; do
	cp -r "node_modules/$_mod" .next/standalone/node_modules/
done

}

do_check() { npm run test:unit }

do_install() { vmkdir usr/lib/omniroute/.next

vcopy .next/standalone/. usr/lib/omniroute/.next/standalone

# Prevent removal of empty Next.js app router dirs by the post-install hook
for _d in \
	.next/standalone/.next/server/app/dashboard \
	.next/standalone/.next/server/app/dashboard/settings \
	.next/standalone/.next/server/app/dashboard/providers; do
	touch "${DESTDIR}/usr/lib/omniroute/${_d}/.keep"
done

cat > "${WRKDIR}/omniroute" <<'EOF'

#!/bin/sh export PORT="${PORT:-20128}" export DATA_DIR="${DATA_DIR:-${XDG_DATA_HOME:-${HOME}/.local/share}/omniroute}" export LOG_TO_FILE="${LOG_TO_FILE:-false}" mkdir -p "${DATA_DIR}" exec node /usr/lib/omniroute/.next/standalone/server.js "$@" EOF vbin "${WRKDIR}/omniroute" }

post_install() { vlicense LICENSE }

</details>

---

## 🐳 Docker

OmniRoute je k dispozici jako veřejný obrázek Dockeru na [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).

**Rychlý běh:**```bash
docker run -d \
  --name omniroute \
  --restart unless-stopped \
  --stop-timeout 40 \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Se souborem prostředí:```bash

Copy and edit .env first

cp .env.example .env

docker run -d
--name omniroute
--restart unless-stopped
--stop-timeout 40
--env-file .env
-p 20128:20128
-v omniroute-data:/app/data
diegosouzapw/omniroute:latest

**Použití Docker Compose:**```bash
# Base profile (no CLI tools)
docker compose --profile base up -d

# CLI profile (Claude Code, Codex, OpenClaw built-in)
docker compose --profile cli up -d

Podpora řídicího panelu pro nasazení Dockeru nyní zahrnujeCloudflare Quick Tunnelna jedno kliknutí na Dashboard → Endpoints. První povolí stahování cloudflared pouze v případě potřeby, spustí dočasný tunel k vašemu aktuálnímu koncovému bodu /v1 a zobrazí vygenerovanou URL https://*.trycloudflare.com/v1 přímo pod vaší normální veřejnou adresou URL.

Poznámky:

• URL Quick Tunnel jsou dočasné a mění se po každém restartu.
• Rychlé tunely se po restartu OmniRoute nebo kontejneru automaticky neobnoví. V případě potřeby je znovu povolte z řídicího panelu.
• Spravovaná instalace aktuálně podporuje Linux, macOS a Windows na x64 / arm64.
• Spravované rychlé tunely jsou výchozí pro přenos HTTP/2, aby se zabránilo hlučným varováním vyrovnávací paměti QUIC UDP v prostředí s omezenými kontejnery. Pokud chcete jiný přenos, nastavte CLOUDFLARED_PROTOCOL=quic nebo auto.
• Obrazy Dockeru svazují kořeny systémové CA a předávají je spravovanému cloudflared, což zabraňuje selhání důvěryhodnosti TLS při zavádění tunelu uvnitř kontejneru.
• SQLite běží v režimu WAL. Docker stop by mělo být povoleno dokončit, aby OmniRoute mohl zkontrolovat nejnovější změny zpět do storage.sqlite.
• V přiložených souborech Compose je již nastavena doba odkladu 40 s. Pokud spouštíte obraz přímo, ponechte hodnotu --stop-timeout 40 (nebo podobnou), aby ruční zastavení nepřerušilo čištění při vypnutí.
• Nastavte CLOUDFLARED_BIN=/absolutní/cesta/k/cloudflared, pokud chcete, aby OmniRoute místo stahování používal existující binární soubor.

Použití Docker Compose s Caddy (HTTPS Auto-TLS):

OmniRoute lze bezpečně zpřístupnit pomocí automatického zřizování SSL Caddy. Ujistěte se, že záznam DNS A vaší domény ukazuje na IP adresu vašeho serveru.```yaml services: omniroute: image: diegosouzapw/omniroute:latest container_name: omniroute restart: unless-stopped volumes: - omniroute-data:/app/data environment: - PORT=20128 - NEXT_PUBLIC_BASE_URL=https://your-domain.com

caddy: image: caddy:latest container_name: caddy restart: unless-stopped ports: - "80:80" - "443:443" command: caddy reverse-proxy --from https://your-domain.com --to http://omniroute:20128

volumes: omniroute-data:

| Obrázek | Štítek | Velikost | Popis |
| ------------------------- | -------- | ------ | ---------------------- |
| `diegosouzapw/omniroute` | "nejnovější" | ~250 MB | Poslední stabilní verze |
| `diegosouzapw/omniroute` | "1.0.3" | ~250 MB | Aktuální verze |---

## 🖥️ Desktop App — Offline & Always-On

> 🆕**NOVINKA!**OmniRoute je nyní k dispozici jako**nativní desktopová aplikace**pro Windows, macOS a Linux.

Spusťte OmniRoute jako samostatnou desktopovou aplikaci – pro místní modely není potřeba žádný terminál, žádný prohlížeč ani internet. Aplikace založená na Electronu zahrnuje:

- 🖥️**Nativní okno**— Vyhrazené okno aplikace s integrací na systémové liště
- 🔄**Auto-Start**– Spusťte OmniRoute při přihlášení do systému
- 🔔**Nativní oznámení**– Získejte upozornění na vyčerpání kvóty nebo problémy s poskytovatelem
- ⚡**Instalace jedním kliknutím**— NSIS (Windows), DMG (macOS), AppImage (Linux)
- 🌐**Režim offline**– Funguje plně offline s přibaleným serverem### Rychlý start

```bash
# Development mode
npm run electron:dev

# Build for your platform
npm run electron:build         # Current platform
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg) — x64 & arm64
npm run electron:build:linux   # Linux (.AppImage)

System Tray

Když je minimalizován, OmniRoute žije v systémové liště s rychlými akcemi:

• Otevřete palubní desku
• Změňte port serveru
• Ukončete aplikaci

📖 Úplná dokumentace: electron/README.md---

💰 Pricing at a Glance

Úroveň	Poskytovatel	Cena	Obnovení kvóty	Nejlepší pro
💳 PŘEDPLATNÉ	Claude Code (Pro)	20 $/měsíc	5h + týdně	Již přihlášeno
	Codex (Plus/Pro)	20–200 USD/měsíc	5h + týdně	Uživatelé OpenAI
	Gemini CLI	ZDARMA	180 tis./měsíc + 1 tis./den	Každý!
	GitHub Copilot	10–19 USD/měsíc	Měsíčně	Uživatelé GitHubu
🔑 API KEY	NVIDIA NIM	ZDARMA(dev forever)	~40 RPM	70+ otevřených modelů
	Cerebras	ZDARMA(1 milion toku/den)	60 000 TPM / 30 RPM	Nejrychlejší na světě
	Groq	ZDARMA(30 RPM)	14,4K RPD	Ultra rychlá lama/gemma
	DeepSeek V3.2	0,27 / 1,10 za 1 milion	Žádné	Nejlepší zdůvodnění cena/kvalita
	xAI Grok-4 Fast	0,20 /0,50 za 1M🆕	Žádné	Nejrychlejší + volání nástroje, ultranízké
	xAI Grok-4 (standardní)	0,20 /1,50 za 1M 🆕	Žádné	Reasoning vlajková loď od xAI
	Mistral	Vyzkoušení zdarma + placené	Omezená sazba	Evropská umělá inteligence
	OpenRouter	Platba za použití	Žádné	100+ modelů agr.
💰 LEVNĚ	GLM-5 (přes Z.AI) 🆕	0,5 $/1 mil.	Denně 10:00	128K výstup, nejnovější vlajková loď
	GLM-4.7	0,6 $/1 mil.	Denně 10:00	Záloha rozpočtu
	MiniMax M2,5 🆕	Vstup 0,3 $/1 milion	5hodinové válcování	Úvahy + agentské úkoly
	MiniMax M2.1	0,2 $/1 milion	5hodinové válcování	Nejlevnější varianta
	Kimi K2.5 (Moonshot API) 🆕	Platba za použití	Žádné	Přímý přístup Moonshot API
	Kimi K2	9 $/měsíc byt	10 milionů tokenů/měsíc	Předvídatelné náklady
🆓 ZDARMA	Qoder	$0	Neomezené	5 modelů neomezeně
	Qwen	$0	Neomezené	4 modely neomezeně
	Kiro	$0	Neomezené	Claude Sonnet/Haiku (stavitel AWS)
	LongCat Flash-Lite 🆕	$0(50 milionů toku/den 🔥)	1 RPS	Největší bezplatná kvóta na Zemi
	Opylování AI 🆕	$0(není potřeba žádný klíč)	1 požadavek/15s	GPT-5, Claude, DeepSeek, Llama 4
	Cloudflare Workers AI 🆕	$0(10 000 neuronů/den)	~150 resp./den	50+ modelů, globální náskok
	Scaleway AI 🆕	$0(celkem 1 milion tokenů)	Omezená sazba	EU/GDPR, Qwen3 235B, Lama 70B	> 🆕**Přidané nové modely (březen 2026):**Rodina Grok-4 Fast za 0,20 $/0,50 $/M (porovnávací rychlost 1143 ms – o 30 % rychlejší než Gemini 2.5 Flash), GLM-5 přes Z.AI s výstupem 128K, aktualizovaná cena MiniMax M2.5 V5, přímé zdůvodnění Kimi K2.2 Moon.

💡 Combo Stack 0 $ — Kompletní bezplatné nastavení:```

🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever

Kiro (kr/) → Claude Sonnet/Haiku UNLIMITED Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED LongCat Lite (lc/) → LongCat-Flash-Lite — 50M tokens/day 🔥 Pollinations (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — no key needed Qwen (qw/) → qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next UNLIMITED Gemini (gemini/) → Gemini 2.5 Flash — 1,500 req/day free API key Cloudflare AI (cf/) → Llama 70B, Gemma 3, Mistral — 10K Neurons/day Scaleway (scw/) → Qwen3 235B, Llama 70B — 1M free tokens (EU) Groq (groq/) → Llama/Gemma ultra-fast — 14.4K req/day NVIDIA NIM (nvidia/) → 70+ open models — 40 RPM forever Cerebras (cerebras/) → Llama/Qwen world-fastest — 1M tok/day

**Nulové náklady. Nikdy nepřestane kódovat.**Nakonfigurujte si to jako jednu kombinaci OmniRoute a všechna nouzová řešení se stanou automaticky – žádné ruční přepínání.---

---

## 🆓 Free Models — What You Actually Get

> Všechny níže uvedené modely jsou**100% zdarma bez nutnosti použití kreditní karty**. OmniRoute mezi nimi automaticky směruje, když dojde jedna kvóta – zkombinujte je všechny a získáte nerozbitnou kombinaci 0 $.### 🔵 CLAUDE MODELS (via Kiro — AWS Builder ID)

| Model | Předpona | Limit | Limit sazby |
| -------------------- | ------ | ------------- | ---------------------- |
| `claude-sonnet-4.5` | `kr/` |**Neomezeno**| Žádný hlášený denní limit |
| `claude-haiku-4,5` | `kr/` |**Neomezeno**| Žádný hlášený denní limit |
| `claude-opus-4.6` | `kr/` |**Neomezeno**| Nejnovější Opus přes Kiro |### 🟢 QODER MODELS (Free PAT via qodercli)

| Model | Předpona | Limit | Limit sazby |
| ------------------- | ------ | ------------- | ---------------- |
| "kimi-k2-myšlení" | `jestli/` |**Neomezeno**| Žádný nahlášený strop |
| `qwen3-coder-plus` | `jestli/` |**Neomezeno**| Žádný nahlášený strop |
| `deepseek-r1` | `jestli/` |**Neomezeno**| Žádný nahlášený strop |
| `minimax-m2.1` | `jestli/` |**Neomezeno**| Žádný nahlášený strop |
| "kimi-k2" | `jestli/` |**Neomezeno**| Žádný nahlášený strop |

> Doporučený způsob připojení:**Personal Access Token + `qodercli`**. OAuth prohlížeče je
> experimentální a ve výchozím nastavení zakázáno, pokud nejsou nakonfigurovány proměnné prostředí `QODER_OAUTH_*`.### 🟡 QWEN MODELS (Device Code Auth)

| Model | Předpona | Limit | Limit sazby |
| -------------------- | ------ | ------------- | -------------------- |
| `qwen3-coder-plus` | `qw/` |**Neomezeno**| Žádný nahlášený strop |
| `qwen3-coder-flash` | `qw/` |**Neomezeno**| Žádný nahlášený strop |
| `qwen3-coder-next` | `qw/` |**Neomezeno**| Žádný nahlášený strop |
| "model vidění" | `qw/` |**Neomezeno**| Multimodální (obrázky) |### 🟣 GEMINI CLI (Google OAuth)

| Model | Předpona | Limit | Limit sazby |
| ------------------------- | ------ | ---------------------------- | ------------- |
| `gemini-3-flash-preview` | `gc/` |**180 tis./měsíc**+ 1 tis./den | Měsíční reset |
| `gemini-2.5-pro` | `gc/` | 180 tis./měsíc (sdílený bazén) | Vysoká kvalita |### ⚫ NVIDIA NIM (Free API Key — build.nvidia.com)

| Úroveň | Denní limit | Limit sazby | Poznámky |
| ---------- | ------------ | ----------- | ------------------------------------------------------- |
| Zdarma (Dev) | Žádný token cap |**~40 RPM**| 70+ modelů; přechod na limity čisté sazby v polovině roku 2025 |

Popular free models: `moonshotai/kimi-k2.5` (Kimi K2.5), `z-ai/glm4.7` (GLM 4.7), `deepseek-ai/deepseek-v3.2` (DeepSeek V3.2), `nvidia/llama-3.3-70b-instruct`, `deepseek/deepseek-r1`### ⚪ CEREBRAS (Free API Key — inference.cerebras.ai)

| Úroveň | Denní limit | Limit sazby | Poznámky |
| ---- | ------------------ | ----------------- | -------------------------------------------- |
| Zdarma |**1 mil. tokenů/den**| 60 000 TPM / 30 RPM | Světově nejrychlejší odvození LLM; resetuje denně |

Dostupné zdarma: `lama-3.3-70b`, `lama-3.1-8b`, `deepseek-r1-distill-lama-70b`### 🔴 GROQ (Free API Key — console.groq.com)

| Úroveň | Denní limit | Limit sazby | Poznámky |
| ---- | ------------- | ----------------- | ------------------------------------------ |
| Zdarma |**14,4K RPD**| 30 ot./min na model | Žádná kreditní karta; 429 na limit, neúčtuje se |

Dostupné zdarma: `llama-3.3-70b-versatile`, `gemma2-9b-it`, `mixtral-8x7b`, `whisper-large-v3`### 🔴 LONGCAT AI (Free API Key — longcat.chat) 🆕

| Model | Předpona | Denní kvóta zdarma | Poznámky |
| ------------------------------ | ------ | ------------------ | ------------------------ |
| "LongCat-Flash-Lite" | `lc/` |**50 milionů tokenů**💥 | Největší bezplatná kvóta všech dob |
| "LongCat-Flash-Chat" | `lc/` | 500 000 tokenů | Víceotáčkový chat |
| "LongCat-Flash-Thinking" | `lc/` | 500 000 tokenů | Zdůvodnění / CoT |
| "LongCat-Flash-Thinking-2601" | `lc/` | 500 000 tokenů | Verze z ledna 2026 |
| "LongCat-Flash-Omni-2603" | `lc/` | 500 000 tokenů | Multimodální |

> 100 % zdarma ve veřejné beta verzi. Zaregistrujte se na [longcat.chat](https://longcat.chat) pomocí e-mailu nebo telefonu. Resetuje se denně v 00:00 UTC.### 🟢 POLLINATIONS AI (No API Key Required) 🆕

| Model | Předpona | Limit sazby | Poskytovatel za |
| ---------- | ------ | ---------- | ------------------- |
| "openai" | `pol/` | 1 požadavek/15s | GPT-5 |
| "claude" | `pol/` | 1 požadavek/15s | Antropický Claude |
| "blíženci" | `pol/` | 1 požadavek/15s | Google Gemini |
| "hluboké vyhledávání" | `pol/` | 1 požadavek/15s | DeepSeek V3 |
| "lama" | `pol/` | 1 požadavek/15s | Meta Llama 4 Scout |
| "mistrál" | `pol/` | 1 požadavek/15s | Mistral AI |

> ✨**Nulové tření:**Žádná registrace, žádný klíč API. Přidejte poskytovatele Pollinations s prázdným polem klíče a funguje to okamžitě.### 🟠 CLOUDFLARE WORKERS AI (Free API Key — cloudflare.com) 🆕

| Úroveň | Denní neurony | Ekvivalentní použití | Poznámky |
| ---- | ------------- | ---------------------------------------- | ------------------------ |
| Zdarma |**10 000**| ~150 LLM resp / 500s audio / 15K vložení | Global edge, 50+ modelů |

Oblíbené bezplatné modely: `@cf/meta/llama-3.3-70b-instruct`, `@cf/google/gemma-3-12b-it`, `@cf/openai/whisper-large-v3-turbo` (zvuk zdarma!), `@cf/qwen/qwen2.5-coder-`1

> Vyžaduje API Token + ID účtu z [dash.cloudflare.com](https://dash.cloudflare.com). Uložte ID účtu v nastavení poskytovatele.### 🟣 SCALEWAY AI (1M Free Tokens — scaleway.com) 🆕

| Úroveň | Kvóta zdarma | Umístění | Poznámky |
| ---- | ------------- | ------------ | ------------------------------------ |
| Zdarma |**1 milion tokenů**| 🇫🇷 Paříž, EU | V rámci limitů není potřeba žádná kreditní karta |

Dostupné zdarma: `qwen3-235b-a22b-instruct-2507` (Qwen3 235B!), `llama-3.1-70b-instruct`, `mistral-small-3.2-24b-instruct-2506`, `deepseek-v3-0324`

> V souladu s EU/GDPR. Získejte API klíč na [console.scaleway.com](https://console.scaleway.com).

>**💡 The Ultimate Free Stack (11 poskytovatelů, 0 $ navždy):**
>
> ```
> Kiro (kr/) → Claude Sonnet/Haiku NEOMEZENO
> Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED
> LongCat Lite (lc/) → LongCat-Flash-Lite – 50 milionů tokenů/den 🔥
> Pollinations (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — není potřeba žádný klíč
> Qwen (qw/) → modely qwen3-kodér NEOMEZENÉ
> Gemini (gemini/) → Gemini 2.5 Flash — 1 500 req/den zdarma
> Cloudflare AI (cf/) → 50+ modelů — 10 000 neuronů/den
> Scaleway (scw/) → Qwen3 235B, Llama 70B – 1M bezplatných tokenů (EU)
> Groq (groq/) → Llama/Gemma – ultrarychlé 14,4 000 požadavků/den
> NVIDIA NIM (nvidia/) → 70+ otevřených modelů — 40 RPM navždy
> Cerebras (cerebras/) → Nejrychlejší lama/Qwen na světě – 1 milion toku/den
> ```## 🎙️ Free Transcription Combo

> Přepis jakéhokoli zvuku/videa za**$0**— Deepgram vede s 200 $ zdarma, AssemblyAI 50 $ nouzové zálohy, Groq Whisper jako neomezené nouzové zálohování.

| Poskytovatel | Kredity zdarma | Nejlepší modelka | Limit sazby |
| ------------------ | ----------------------- | --------------------------------------------- | ----------------------------- |
| 🢢**Deepgram**|**200 $ zdarma**(registrace) | `nova-3` — nejlepší přesnost, více než 30 jazyků | Žádný limit RPM na bezplatné kredity |
| 🔵**SestaveníAI**|**50 $ zdarma**(registrace) | `universal-3-pro` — kapitoly, sentiment, PII | Žádný limit RPM na bezplatné kredity |
| 🔴**Groq**|**Navždy zdarma**| `whisper-large-v3` — OpenAI Whisper | 30 RPM (rychlost omezená) |

**Doporučená kombinace v `/dashboard/combos`:**```
Name: free-transcription
Strategy: Priority
Nodes:
  [1] deepgram/nova-3          → uses $200 free first
  [2] assemblyai/universal-3-pro → fallback when Deepgram credits run out
  [3] groq/whisper-large-v3    → free forever, emergency fallback

Poté v /dashboard/media → kartaPřepis: nahrajte jakýkoli zvukový nebo video soubor → vyberte svůj kombinovaný koncový bod → získejte přepis v podporovaných formátech.## 💡 Key Features

OmniRoute v2.0 je postaven jako operační platforma, nikoli pouze jako přenosová proxy.### 🆕 New — ClawRouter-Inspired Improvements (Mar 2026)

Funkce	Co to dělá
⚡Grok-4 Fast Family	xAI modely za 0,20 $/0,50 $/M – srovnávací 1143 ms (o 30 % rychlejší než Gemini 2.5 Flash)
🧠GLM-5 přes Z.AI	128 000 výstupní kontext, 0,5 $/1 milion – nejnovější vlajková loď z rodiny GLM
🔮MiniMax M2.5	Úvahy + agentní úkoly za 0,30 $/1 milion – významný upgrade z M2,1
🎯toolCalling Flag na model	„ToolCalling: true/false“ pro model v registru – AutoCombo přeskočí modely, které nepodporují nástroje
🌍Multilingual Intent Detection	Klíčová slova PT/ZH/ES/AR v hodnocení AutoCombo – lepší výběr modelu pro neanglický obsah
📊Zástupy založené na benchmarku	Skutečná latence p95 z kombinovaného bodování zdrojů živých požadavků – AutoCombo se učí ze skutečných dat
🔁Požádat o deduplikaci	Okno pro odstranění duplicitního obsahu založené na hašování obsahu – bezpečné pro více agentů, zabraňuje duplicitním poplatkům
🔌Strategie připojitelného směrovače	Rozšiřitelné rozhraní RouterStrategy — přidejte vlastní logiku směrování jako zásuvné moduly	### 🚀 Previous v2.0.9+ — Playground, CLI Fingerprints & ACP

Funkce	Co to dělá
🎮Modelové hřiště	Stránka řídicího panelu pro přímé testování jakéhokoli modelu — voliče poskytovatele/modelu/koncového bodu, editor Monaco, streamování, přerušení, načasování
🔏CLI Fingerprint Matching	Uspořádání záhlaví/těla podle poskytovatele tak, aby odpovídalo nativním signaturám CLI – přepněte podle poskytovatele v Nastavení > Zabezpečení.Vaše IP adresa proxy je zachována
🤝Podpora ACP (Protokol klienta agenta)	Objevování agentů CLI (Codex, Claude, Goose, Gemini CLI, OpenClaw + 9 dalších), proces spawner, koncový bod /api/acp/agents
🤖Hlavní panel agentů AKT	Debug › Stránka Agenti — mřížka 14 agentů se stavem instalace, verzí, uživatelským formulářem agenta pro libovolný nástroj CLI. UživateléOpenCodezískají tlačítko „Stáhnout opencode.json“, které automaticky vygeneruje konfiguraci připravenou k použití se všemi dostupnými modely.
🔧Směrování vlastního modelu apiFormat	Vlastní modely s apiFormat: "responses" nyní správně směrují do překladače Responses API
🏢Codex Workspace Isolation	Více pracovních prostorů Codex na e-mail — OAuth správně odděluje připojení podle ID pracovního prostoru
🔄Elektronová automatická aktualizace	Desktopová aplikace kontroluje aktualizace + automatická instalace při restartu	### 🤖 Agent & Protocol Operations (v2.0)

Funkce	Co to dělá
🔧MCP Server (25 nástrojů)	Nástroje IDE/agenta prostřednictvím 3 přenosů: stdio, SSE (/api/mcp/sse), Streamable HTTP (/api/mcp/stream). 18 jader + 3 paměti + 4 nástroje pro dovednosti
🤝Server A2A (JSON-RPC + SSE)	Provádění úlohy agent-agent se synchronizací a streamováním
🧭Stránka konsolidovaných koncových bodů	Stránka správy s kartami s kartami Endpoint Proxy, MCP, A2A a API Endpoints
🎚️Přepínače aktivace/deaktivace služby	Spínače ON/OFF pro MCP a A2A s trvalým nastavením (výchozí: OFF)
🛰️MCP Runtime Heartbeat	Skutečný stav procesu (pid, doba provozu, doba srdečního tepu, transport, režim rozsahu)
📋MCP Audit Trail	Filtrovatelné protokoly auditu s úspěchem/neúspěchem a přiřazením klíče
🔐Vymáhání rozsahu MCP	10 podrobných oprávnění k rozsahu pro řízený přístup k nástrojům
📡A2A Task Lifecycle Management	Vypsat/filtrovat úlohy, zkontrolovat události/artefakty, zrušit běžící úlohy
📋Zjištění karty agenta	/.well-known/agent.json pro automatické zjišťování klienta
🧪Protokol E2E Test Harness	Skutečný MCP SDK + klient A2A toky v test:protocols:e2e
⚙️Provozní ovládací prvky	Kombinace přepínačů, použití profilů odolnosti, resetování jističů z jedné ovládací plochy	### 🧠 Routing & Intelligence

Funkce	Co to dělá
🎯Chytrý 4úrovňový záložní zdroj	Automatická trasa: Předplatné → Klíč API → Levné → Zdarma
📊Sledování kvót v reálném čase	Živý počet tokenů + reset odpočítávání na poskytovatele
🔄Formátový překlad	OpenAI ↔ Claude ↔ Gemini ↔ Odpovědi s převody bezpečnými pro schéma
👥Podpora více účtů	Více účtů na poskytovatele s inteligentním výběrem
🔄Automatické obnovení tokenu	Tokeny OAuth se automaticky obnovují s opakováním
🎨Vlastní kombinace	9 vyvažovacích strategií + řízení záložního řetězce
🌐Wildcard Router	poskytovatel/* dynamické směrování
🧠Přemýšlení o kontrolách rozpočtu	Limity průchozího, automatického, vlastního a adaptivního uvažování
🔀Aliasy modelů	Vestavěný + vlastní model aliasing a bezpečnost migrace
⚡Degradace pozadí	Směrujte úlohy s nízkou prioritou na pozadí na levnější modely
🧪Inteligentní směrování s ohledem na úkoly	Automatický výběr modelu podle typu obsahu (kódování/vize/analýza/souhrn)
🔄Pracovní postupy agentů A2A	Deterministický orchestrátor FSM pro stavové spouštění agentů ve více krocích
🔀Adaptivní směrování	Dynamické přepisování strategie založené na objemu tokenů a složitosti výzvy
🎲Rozmanitost poskytovatelů	Shannon entropie bodování vyvažování auto-kombo rozložení provozu
💬System Prompt Injection	Globální ovládací prvky chování používané konzistentně
📄Kompatibilita rozhraní Responses API	Plná podpora /v1/responses pro Codex a pokročilé agentní pracovní postupy	### 🎵 Multi-Modal APIs

Funkce	Co to dělá
🖼️Generování obrázků	/v1/images/generations s cloudem a místními backendy
📐Vložení	/v1/embeddings pro vyhledávání a potrubí RAG
🎤Přepis zvuku	/v1/audio/transscriptions — 7 poskytovatelů (Deepgram Nova 3, AssemblyAI, Groq Whisper, HuggingFace, ElevenLabs, OpenAI, Azure), automatická detekce jazyka, podpora MP4/MP3/WAV
🔊Převod textu na řeč	/v1/audio/speech — 10 poskytovatelů (ElevenLabs, OpenAI, Deepgram, Cartesia, PlayHT, HuggingFace, Nvidia NIM, Inworld, Coqui, Tortoise) se správnými chybovými zprávami
🎬Generace videa	/v1/videos/generations (pracovní postupy ComfyUI + SD WebUI)
🎵Music Generation	/v1/music/generations (pracovní postupy ComfyUI)
🛡️Moderování	/v1/moderations bezpečnostní kontroly
🔀Reranking	/v1/rerank pro hodnocení relevance
🔍Vyhledávání na webu🆕	/v1/search — 5 poskytovatelů (Serper, Brave, Perplexity, Exa, Tavily), 6 500+ zdarma/měsíc, automatické přepnutí při selhání, mezipaměť	### 🛡️ Resilience, Security & Governance

Funkce	Co to dělá
🔌Jističe	Vypnutí/obnovení pro každý model s ovládáním prahu
🎯Koncové modely	Vlastní modely deklarují podporované koncové body + formát API
🛡️Stádo proti hromům	Mutex + semaforové ochrany při opakování/rychlosti událostí
🧠Sémantická + mezipaměť podpisů	Snížení nákladů/latence se dvěma vrstvami mezipaměti
⚡Žádost o idempotenci	Duplicitní ochranné okno
🔒TLS Fingerprint Spoofing	Otisk TLS jako v prohlížeči —snižuje detekci robotů a nahlašování účtu
🔏CLI Fingerprint Matching	Odpovídá nativním podpisům požadavku CLI —snižuje riziko zákazu při zachování proxy IP
🌐Filtrování IP	Kontrola seznamu povolených/blokovaných pro vystavená nasazení
📊Upravitelné limity sazeb	Konfigurovatelné globální limity/limity na úrovni poskytovatele s perzistencí
📉Půvabná degradace	Záložní funkce vícevrstvé ochrany chránící operace hlavní brány
📜Config Audit Trail	Sledování změn založené na rozdílech zabraňující provoznímu posunu s jednoduchým vrácením zpět
⏳Provider Health Sync	Proaktivní monitorování vypršení platnosti tokenu spouštějící výstrahy před selháním autorizace
🚪Automaticky zakázat zakázané účty	Provozní jistič automaticky zaplombuje trvale zablokované tokenové účty
🔑Správa klíčů API + rozsah	Bezpečné vydávání/otočení klíčů a ovládání modelu/poskytovatele
👁️Scoped API Key Reveal🆕	Přihlaste se k obnově klíčů API prostřednictvím ALLOW_API_KEY_REVEAL
🛡️Chráněno /modely	Volitelné ověřování a skrytí poskytovatele pro katalog modelů	### 📊 Observability & Analytics

Funkce	Co to dělá
📝Požadavek + protokolování proxy	Úplný požadavek/odpověď a protokolování proxy
📉Streamované podrobné protokoly🆕	Čistě rekonstruuje datové proudy SSE do uživatelského rozhraní
📋Sjednocený panel protokolů	Požadavek, proxy, audit a zobrazení konzoly na jedné stránce
🔍Požádejte o telemetrii	p50/p95/p99 latence a sledování požadavků
🏥Health Dashboard	Doba provozuschopnosti, stavy jističe, uzamčení, statistiky mezipaměti
💰Sledování nákladů	Kontroly rozpočtu a viditelnost cen podle modelu
📈Analytické vizualizace	Statistiky využití modelu/poskytovatele a zobrazení trendů
🧪Rámec hodnocení	Testování zlaté sady s konfigurovatelnými strategiemi shody
📡Live Diagnostics🆕	Sémantické vynechání mezipaměti pro přesné kombinované živé testování	### ☁️ Deployment & Platform

Funkce	Co to dělá
🌐Nasadit kdekoli	Localhost, VPS, Docker, cloudová prostředí
🚇Tunel Cloudflare🆕	Integrace rychlého tunelu jedním kliknutím z řídicího panelu
🔑Filtrování modelu klíče API	Nativní odpověď /v1/models filtrovaná přes přiřazené kontextové role nosiče
⚡Smart Cache Bypass	Konfigurovatelná heuristika TTL a ovládací prvky nuceného opětovného načtení
🔄Zálohování/Obnova	Export/import a toky obnovy po havárii
🧙Průvodce onboardingem	První spuštění průvodce nastavením
🔧CLI Tools Dashboard	Nastavení jedním kliknutím pro oblíbené kódovací nástroje
🎮Modelové hřiště	Otestujte libovolného poskytovatele/model/koncový bod z řídicího panelu
🔏CLI Fingerprint Toggle	Shoda otisků prstů jednotlivých poskytovatelů v Nastavení > Zabezpečení
🌐i18n (30 jazyků)	Plná podpora řídicího panelu + docs s pokrytím RTL
🧹Vymazat všechny modely	Vymazání seznamu modelů jedním kliknutím v detailech poskytovatele
👁️Ovládací prvky postranního panelu🆕	Skrýt komponenty a integrace z Nastavení vzhledu
📋Šablony vydání	Standardizované šablony GitHub pro chyby a funkce
📂Custom Data Directory	Přepsání DATA_DIR pro umístění úložiště	### Feature Deep Dive

Smart fallback with practical cost control

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6
  2. nvidia/llama-3.3-70b
  3. glm/glm-4.7
  4. if/kimi-k2-thinking

Když kvóta, rychlost nebo stav selžou, OmniRoute automaticky přejde na dalšího kandidáta bez ručního přepínání.#### Protocol management that is visible and operable

• MCP + A2A jsou zjistitelné v uživatelském rozhraní a dokumentech (nejsou skryté)
• Rozhraní API stavu protokolu zpřístupňují živá provozní data (/api/mcp/*, /api/a2a/*)
• Panely obsahují akce pro operace 2. dne (přepínání kombinací, resetování jističe, zrušení úkolu)#### Translator + validation workflow

Oblast překladatele zahrnuje:

-Hřiště: Vyžádejte si kontroly transformace -Chat Tester: kompletní zpáteční cesta na žádost/odpověď -Testovací stolice: více případů v jednom běhu -Live Monitor: zobrazení dopravy v reálném čase

Plus ověření protokolu se skutečnými klienty pomocí npm run test:protocols:e2e.

📖MCP Server README— Reference nástrojů, konfigurace IDE a příklady klientů

📖A2A Server README— Dovednosti, metody JSON-RPC, streamování a životní cyklus úloh## 🧪 Evaluations (Evals)

OmniRoute obsahuje vestavěný hodnotící rámec pro testování kvality odezvy LLM oproti zlaté sadě. Přistupte k němu přesAnalytics → Evalsna hlavním panelu.### Built-in Golden Set

Předinstalovaná sada „OmniRoute Golden Set“ obsahuje testovací případy pro:

• Pozdravy, matematika, zeměpis, generování kódu
• Kompatibilita formátu JSON, překlad, generování markdown
• Bezpečnostní odmítnutí (škodlivý obsah), počítání, booleovská logika### Evaluation Strategies

Strategie	Popis	Příklad
"přesný"	Výstup se musí přesně shodovat	"4""
"obsahuje"	Výstup musí obsahovat podřetězec (nerozlišují se malá a velká písmena)	"Paříž"
"regulární výraz"	Výstup musí odpovídat vzoru regulárního výrazu	"1.*2.*3"
"vlastní"	Vlastní funkce JS vrací true/false	(výstup) => výstup.délka > 10	---

📖 Setup Guide

Protocol Setup (MCP + A2A)

🧩 Nastavení MCP (Model Context Protocol)

Spusťte přenos MCP v režimu stdio:```bash omniroute --mcp

Doporučený postup ověření:

1. Připojte svého MCP klienta přes stdio.
2. Spusťte `omniroute_get_health`.
3. Spusťte `omniroute_list_combos`.
4. Otevřete `/dashboard/mcp` pro potvrzení prezenčního signálu, aktivity a auditu.

Užitečná rozhraní API pro automatizaci:

- `GET /api/mcp/status`
- `GET /api/mcp/tools`
- `GET /api/mcp/audit`
- `GET /api/mcp/audit/stats`</details>

<podrobnosti>
<summary><b>🤝 Nastavení A2A (Agent2Agent)</b></summary>

Objevte agenta:```bash
curl http://localhost:20128/.well-known/agent.json

Odeslat úkol:```bash curl -X POST http://localhost:20128/a2a
-H 'content-type: application/json'
-d '{"jsonrpc":"2.0","id":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'

Správa životního cyklu:

- `GET /api/a2a/status`
- `GET /api/a2a/tasks`
- `GET /api/a2a/tasks/:id`
- `POST /api/a2a/tasks/:id/cancel`

Provozní uživatelské rozhraní:

- `/dashboard/a2a` pro pozorování úkolu/stavu/toku a akce kouře</details>

<podrobnosti>
<summary><b>🧪 End-to-end validace protokolu</b></summary>

Ověřte oba protokoly se skutečnými klienty:```bash
npm run test:protocols:e2e

Tím se ověřuje:

• Připojení/seznam/volání klienta MCP SDK
• A2A objev/odeslat/streamovat/získat/zrušit
• Křížová kontrola dat v MCP auditu a API pro správu úloh A2A

💳 Poskytovatelé předplatného

### Claude Code (Pro/Max)

Dashboard → Providers → Connect Claude Code
→ OAuth login → Auto token refresh
→ 5-hour + weekly quota tracking

Models:
  cc/claude-opus-4-6
  cc/claude-sonnet-4-5-20250929
  cc/claude-haiku-4-5-20251001

**Tip pro profesionály:**Používejte Opus pro složité úkoly, Sonnet pro rychlost. OmniRoute sleduje kvótu na model!### OpenAI Codex (Plus/Pro)

Dashboard → Providers → Connect Codex
→ OAuth login (port 1455)
→ 5-hour + weekly reset

Models:
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

Codex Account Limit Management (5h + Weekly)

Každý účet Codexu má nyní přepínače zásad v Dashboard -> Providers:

• 5h (ZAP/VYP): vynutit zásadu prahu 5hodinového okna.
• Týdně (ON/OFF): vynutit zásadu týdenního prahu okna.
• Prahové chování: když povolené okno dosáhne využití >=90 %, daný účet je přeskočen.
• Rotační chování: OmniRoute automaticky směruje na další způsobilý účet Codex.
• Resetovat chování: po uplynutí času resetAt poskytovatele se účet automaticky znovu stane způsobilým.

Scénáře:

• 5h ON + Weekly ON: účet je přeskočen, když kterékoli okno dosáhne prahové hodnoty.
• 5h VYP + Týdně ZAP: účet může zablokovat pouze používání týdně.
• 5h ON + Týdenní OFF: účet může zablokovat pouze 5 hodin používání.
• resetAt prošlo: účet automaticky znovu vstoupí do rotace (bez ručního opětovného povolení).### Gemini CLI (FREE 180K/month!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

**Nejlepší hodnota:**Obrovská bezplatná úroveň! Použijte to před placenými úrovněmi.### GitHub Copilot

Dashboard → Providers → Connect GitHub
→ OAuth via GitHub
→ Monthly reset (1st of month)

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3.1-pro-preview

🔑 Poskytovatelé klíčů API

### NVIDIA NIM (FREE developer access — 70+ models)

1. Zaregistrujte se: build.nvidia.com
2. Získejte bezplatný klíč API (včetně 1000 kreditů pro odvození)
3. Ovládací panel → Přidat poskytovatele → NVIDIA NIM:
   • Klíč API: nvapi-your-key

Modely:nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct a 50+ dalších

**Tip pro profesionály:**API kompatibilní s OpenAI – bezproblémově funguje s překladem formátu OmniRoute!### DeepSeek

1. Zaregistrujte se: platform.deepseek.com
2. Získejte API klíč
3. Ovládací panel → Přidat poskytovatele → DeepSeek

Modely:deepseek/deepseek-chat, deepseek/deepseek-coder### Groq (Free Tier Available!)

1. Zaregistrujte se: console.groq.com
2. Získejte klíč API (včetně bezplatné úrovně)
3. Ovládací panel → Přidat poskytovatele → Groq

Modely:groq/lama-3.3-70b, groq/mixtral-8x7b

**Tip pro profesionály:**Ultra rychlé vyvozování – nejlepší pro kódování v reálném čase!### OpenRouter (100+ Models)

1. Zaregistrujte se: openrouter.ai
2. Získejte API klíč
3. Ovládací panel → Přidat poskytovatele → OpenRouter

**Modely:**Získejte přístup k více než 100 modelům od všech hlavních poskytovatelů prostřednictvím jediného klíče API.

Chování řídicího panelu:Modely OpenRouter jsou spravovány zDostupných modelů. Ruční přidání, import a automatická synchronizace aktualizují stejný seznam.

💰 Levní poskytovatelé (záložní)

### GLM-4.7 (Daily reset, $0.6/1M)

1. Zaregistrujte se: Zhipu AI
2. Získejte API klíč z Coding Plan
3. Ovládací panel → Přidat klíč API:
   • Poskytovatel: glm
   • Klíč API: váš klíč

Použití:glm/glm-4.7

**Tip pro profesionály:**Kódovací plán nabízí 3× kvótu za 1/7 cenu! Resetovat denně v 10:00.### MiniMax M2.1 (5h reset, $0.20/1M)

1. Zaregistrujte se: MiniMax
2. Získejte API klíč
3. Ovládací panel → Přidat klíč API

Použití:minimax/MiniMax-M2.1

**Tip pro profesionály:**Nejlevnější možnost pro dlouhý kontext (1 milion tokenů)!### Kimi K2 ($9/month flat)

1. Přihlaste se k odběru: Moonshot AI
2. Získejte API klíč
3. Ovládací panel → Přidat klíč API

Použijte:kimi/kimi-latest

**Tip pro profesionály:**Pevná cena 9 měsíčně za 10 milionů tokenů = 0,90 / 1 milion efektivních nákladů!

🆓 ZDARMA poskytovatelé (nouzové zálohování)

### Qoder (5 FREE models via OAuth)

Dashboard → Connect Qoder
→ Qoder OAuth login
→ Unlimited usage

Models:
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

Qwen (4 FREE models via Device Code)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

Kiro (Claude FREE)

Dashboard → Connect Kiro
→ AWS Builder ID or Google/GitHub
→ Unlimited usage

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

🎨 Vytvořit komba

### Example 1: Maximize Subscription → Cheap Backup

Dashboard → Combos → Create New

Name: premium-coding
Models:
  1. cc/claude-opus-4-6 (Subscription primary)
  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)

Use in CLI: premium-coding

Example 2: Free-Only (Zero Cost)

Name: free-combo
Models:
  1. gc/gemini-3-flash-preview (180K free/month)
  2. if/kimi-k2-thinking (unlimited)
  3. qw/qwen3-coder-plus (unlimited)

Cost: $0 forever!

🔧 Integrace CLI

### Cursor IDE

Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [from OmniRoute dashboard]
  Model: cc/claude-opus-4-6

Claude Code

Použijte stránkuCLI Toolsna řídicím panelu pro konfiguraci jedním kliknutím nebo upravte ~/.claude/settings.json ručně.### Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"

codex "your prompt"

OpenClaw

Možnost 1 – Hlavní panel (doporučeno):``` Dashboard → CLI Tools → OpenClaw → Select Model → Apply

**Možnost 2 — Ručně:**Upravit `~/.openclaw/openclaw.json`:```json
{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

**Poznámka:**OpenClaw funguje pouze s místní OmniRoute. Použijte 127.0.0.1 místo localhost, abyste se vyhnuli problémům s rozlišením IPv6.### Cline / Continue / RooCode

Settings → API Configuration:
  Provider: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [from OmniRoute dashboard]
  Model: if/kimi-k2-thinking

OpenCode

**Krok 1:**Přidejte OmniRoute jako vlastního poskytovatele:```bash opencode /connect

Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key

**Krok 2:**Vytvořte/upravte soubor `opencode.json` v kořenovém adresáři projektu:```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1"
      },
      "models": {
        "cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
      }
    }
  }
}

**Krok 3:**Vyberte model v OpenCode:```bash /models

Select any OmniRoute model from the list

>**Tip:**Přidejte jakýkoli model dostupný v koncovém bodu vašeho OmniRoute `/v1/models` do sekce `models`. Použijte formát `provider/model-id` z řídicího panelu OmniRoute.</details>

---

## Řešení problémů

<podrobnosti>
<summary><b>Kliknutím rozbalíte průvodce odstraňováním problémů</b></summary>

**"Jazykový model neposkytoval zprávy"**

- Kvóta poskytovatele je vyčerpána → Zkontrolujte sledování kvót na řídicím panelu
- Řešení: Použijte nouzovou kombinaci nebo přejděte na levnější úroveň

**Omezení sazby**

- Vyčerpaná kvóta předplatného → Záložní režim GLM/MiniMax
- Přidejte kombinaci: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`

**Platnost tokenu OAuth vypršela**

- Automaticky obnovováno OmniRoute
- Pokud problémy přetrvávají: Řídicí panel → Poskytovatel → Znovu připojit

**Vysoké náklady**

- Zkontrolujte statistiky využití v Dashboard → Náklady
- Přepněte primární model na GLM/MiniMax
- Používejte bezplatnou vrstvu (Gemini CLI, Qoder) pro nekritické úkoly

**Porty řídicího panelu/API jsou chybné**

- `PORT` je kanonický základní port (a port API ve výchozím nastavení)
- `API_PORT` přepíše pouze posluchače API kompatibilní s OpenAI
- `DASHBOARD_PORT` přepíše pouze posluchače dashboard/Next.js
– Nastavte „NEXT_PUBLIC_BASE_URL“ na svůj řídicí panel/veřejnou adresu URL (pro zpětná volání OAuth)

**Chyby synchronizace cloudu**

- Ověřte, že `BASE_URL` odkazuje na vaši spuštěnou instanci
- Ověřte, že `CLOUD_URL` odkazuje na očekávaný koncový bod cloudu
- Udržujte hodnoty `NEXT_PUBLIC_*` zarovnané s hodnotami na straně serveru

**První přihlášení nefunguje**

- Zkontrolujte `INITIAL_PASSWORD` v `.env`
- Pokud není nastaveno, záložní heslo je `123456`

**Žádné protokoly požadavků**

- Artefakty požadavku se zapisují do `DATA_DIR/call_logs/` jako jeden soubor JSON na požadavek
- Povolte zachycení potrubí z řídicího panelu → Protokoly → Protokoly žádostí, pokud potřebujete podrobné užitečné zatížení pro jednotlivé fáze
- Nastavte `APP_LOG_TO_FILE=true`, pokud chcete také protokoly konzoly aplikace v `logs/application/app.log`
– Podle potřeby upravte `APP_LOG_MAX_FILE_SIZE`, `APP_LOG_RETENTION_DAYS`, `APP_LOG_MAX_FILES` a `CALL_LOG_MAX_ENTRIES`

**Test připojení ukazuje „Neplatné“ pro poskytovatele kompatibilní s OpenAI**

- Mnoho poskytovatelů nevystavuje koncový bod `/models`
- OmniRoute v1.0.6+ zahrnuje nouzové ověření prostřednictvím dokončení chatu
- Zajistěte, aby základní adresa URL obsahovala příponu `/v1`### 🔐 OAuth on a Remote Server

<a name="oauth-on-a-remote-server"></a>
<a name="oauth-em-servidor-remoto"></a>

>**⚠️ Důležité pro uživatele provozující OmniRoute na VPS, Dockeru nebo jakémkoli vzdáleném serveru**#### Why does Antigravity / Gemini CLI OAuth fail on remote servers?

Poskytovatelé**Antigravity**a**Gemini CLI**používají**Google OAuth 2.0**. Google vyžaduje, aby parametr `redirect_uri` v toku OAuth přesně odpovídal jednomu z předem registrovaných URI v Google Cloud Console aplikace.

Přihlašovací údaje OAuth dodávané v OmniRoute jsou registrovány**pouze pro `localhost`**. Když přistupujete k OmniRoute na vzdáleném serveru (např. `https://omniroute.myserver.com`), Google odmítne ověření pomocí:```
Error 400: redirect_uri_mismatch

Solution: Configure your own OAuth credentials

Ve službě Google Cloud Console musíte vytvořitOAuth 2.0 Client IDs identifikátorem URI vašeho serveru.#### Step-by-step

1. Otevřít Google Cloud Console

Přejděte na: https://console.cloud.google.com/apis/credentials

2. Vytvořit nové ID klienta OAuth 2.0

– Klikněte na**"+ Vytvořit přihlašovací údaje"→"ID klienta OAuth"**

• Typ aplikace:"Webová aplikace"
• Název: cokoliv se vám líbí (např. OmniRoute Remote)

3. Přidat identifikátory URI autorizovaného přesměrování

Do pole**"URI autorizovaného přesměrování"**přidejte:``` https://your-server.com/callback

> Nahraďte `vas-server.com` doménou nebo IP svého serveru (v případě potřeby uveďte port, např. `http://45.33.32.156:20128/callback`).

**4. Uložte a zkopírujte přihlašovací údaje**

Po vytvoření Google zobrazí**Client ID**a**Client Secret**.

**5. Nastavit proměnné prostředí**

Ve vašem `.env` (nebo proměnných prostředí Docker):```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

# For Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

6. Restartujte OmniRoute```bash

npm:

npm run dev

Docker:

docker restart omniroute

**7. Zkuste se připojit znovu**

Ovládací panel → Poskytovatelé → Antigravitace (nebo Gemini CLI) → OAuth

Google se nyní správně přesměruje na `https://vas-server.com/callback`.---

#### Temporary workaround (without custom credentials)

Pokud si nyní nechcete nastavovat vlastní přihlašovací údaje, můžete stále použít**ruční postup URL**:

1. OmniRoute otevře autorizační URL Google
2. Po autorizaci se Google pokusí přesměrovat na `localhost` (který selže na vzdáleném serveru)
3.**Zkopírujte celou adresu URL**z adresního řádku prohlížeče (i když se stránka nenačte)
4. Vložte tuto adresu URL do pole zobrazeného v modálu připojení OmniRoute
5. Klikněte na**"Připojit"**

> Funguje to, protože autorizační kód v adrese URL je platný bez ohledu na to, zda se stránka přesměrování načetla.---

<podrobnosti>
<summary><b>🇧🇷 Versão em Português</b></summary>#### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?

Osvedčuje**Antigravity**a**Gemini CLI**používáme**Google OAuth 2.0**pro autenticitu. O Google exige que a `redirect_uri` usada no fluxo OAuth seja**exatamente**uma das URIs pré-cadastradas no Google Cloud Console to use.

Jako credenciais OAuth embutidas no OmniRoute estão cadastradas**apenas para `localhost`**. Quando você acessa o OmniRoute um um servidor remote (ex: `https://omniroute.meuservidor.com`), nebo Google rejeita a autenticação com:```
Error 400: redirect_uri_mismatch

Solução: Configure suas próprias credenciais OAuth

Você precisa criar umOAuth 2.0 Client IDno Google Cloud Console com a URI do seu server.#### Passo a passo

1. Přístup ke službě Google Cloud Console

Abra: https://console.cloud.google.com/apis/credentials

2. Crie um novo OAuth 2.0 Client ID

• Klikněte na**"+ Vytvořit přihlašovací údaje"→"ID klienta OAuth"**
• Tipo de aplicativo:"Webová aplikace"
• Nome: escolha qualquer nome (např.: OmniRoute Remote)

3. Adicione jako Authorized Redirect URI

Žádné pole**"URI autorizovaného přesměrování"**, adicione:``` https://seu-servidor.com/callback

> Substitua `seu-servidor.com` pelo domínio nebo IP do seu servidor (včetně portu se necessário, např.: `http://45.33.32.156:20128/callback`).

**4. Uložit a zkopírovat jako credenciais**

Após criar, o Google mostrará o**Client ID**e o**Client Secret**.

**5. Konfigurovat jako variáveis de ambiente**

No seu `.env` (ou nas variáveis de ambiente do Docker):```bash
# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

6. Reinicie nebo OmniRoute```bash

Se usando npm:

npm run dev

Se usando Docker:

docker restart omniroute

**7. Tente conectar novamente**

Dashboard → Poskytovatelé → Antigravitace (nebo Gemini CLI) → OAuth

Agora nebo Google redirecionamente corretamente para `https://seu-servidor.com/callback` a autenticação funcionará.---

#### Workaround temporário (sem configurar credenciais próprias)

Zjistěte, jaké jsou údaje o vaší kreditní kartě, a je možné, že použijete fluxo**příručku URL**:

1. O OmniRoute abrirá a URL autorização Google
2. Após você autorizar, o Google tentará redirecionar para `localhost` (que falha no servidor remoto)
3.**Zkopírujte úplnou adresu URL**da barra de endereço do seu browser (mesmo que a pagina não carregue)
4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
5. Klikněte na**"Připojit"**

> Toto řešení funguje pomocí autorizačního kódu na URL a nezávislého přesměrování.</details>

---

</details>

## 🛠️ Tech Stack

<podrobnosti>
<summary><b>Kliknutím rozbalíte podrobnosti o technologickém zásobníku</b></summary>

-**Runtime**: Node.js 18–22 LTS (⚠️ Node.js 24+ není**podporován**– nativní binární soubory `better-sqlite3` jsou nekompatibilní)
-**Jazyk**: TypeScript 5.9 —**100% TypeScript**napříč `src/` a `open-sse/` (nula `any` v základních modulech od verze 2.0)
-**Framework**: Next.js 16 + React 19 + Tailwind CSS 4
-**Databáze**: LowDB (JSON) + SQLite (stav domény + protokoly proxy + audit MCP + rozhodnutí o směrování)
-**Schémata**: Zod (ověření I/O nástroje MCP, smlouvy API)
-**Protokoly**: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
-**Streamování**: Server-Sent Events (SSE)
-**Auth**: OAuth 2.0 (PKCE) + JWT + API klíče + MCP Scoped Authorization
-**Testování**: Testovací program Node.js + Vitest (více než 900 testů včetně jednotky, integrace, E2E)
-**CI/CD**: Akce GitHub (automatické publikování npm + Docker Hub při vydání)
-**Web**: [omniroute.online](https://omniroute.online)
-**Balík**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
-**Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
-**Odolnost**: Jistič, exponenciální ústup, stádo proti hromům, TLS spoofing, auto-kombo samoléčení</details>

---

## Dokumentace

| Dokument | Popis |
| ---------------------------------------------- | ---------------------------------------------------- |
| [Uživatelská příručka](docs/USER_GUIDE.md) | Poskytovatelé, komba, integrace CLI, nasazení |
| [Reference API](docs/API_REFERENCE.md) | Všechny koncové body s příklady |
| [Server MCP](open-sse/mcp-server/README.md) | 16 MCP nástroje, konfigurace IDE, klienti Python/TS/Go |
| [Server A2A](src/lib/a2a/README.md) | Protokol JSON-RPC 2.0, dovednosti, streamování, správa úloh |
| [Auto-Combo Engine](docs/auto-combo.md) | 6faktorové bodování, balíčky režimů, samoléčení |
| [Odstraňování problémů](docs/TROUBLESHOOTING.md) | Běžné problémy a řešení |
| [Architektura](docs/ARCHITECTURE.md) | Architektura systému a vnitřní části |
| [Přispívá](CONTRIBUTING.md) | Vývojové nastavení a pokyny |
| [Specifikace OpenAPI](docs/openapi.yaml) | Specifikace OpenAPI 3.0 |
| [Bezpečnostní zásady](SECURITY.md) | Hlášení zranitelnosti a bezpečnostní postupy |
| [Deployment VM](docs/VM_DEPLOYMENT_GUIDE.md) | Kompletní průvodce: Nastavení VM + nginx + Cloudflare |
| [Galerie funkcí](docs/FEATURES.md) | Vizuální prohlídka řídicího panelu se snímky obrazovky |
| [Kontrolní seznam vydání](docs/RELEASE_CHECKLIST.md) | Kroky ověření před vydáním |---

## 🗺️ Roadmap

OmniRoute má naplánováno**210+ funkcí**v několika fázích vývoje. Zde jsou klíčové oblasti:

| Kategorie | Plánované funkce | Hlavní body |
| ------------------------------ | ----------------- | -------------------------------------------------------------------------------------- |
| 🧠**Směrování a inteligence**| 25+ | Směrování s nejnižší latencí, směrování založené na značkách, předběžná kontrola kvót, výběr účtu P2C |
| 🔒**Zabezpečení a dodržování předpisů**| 20+ | Zpevnění SSRF, maskování pověření, rychlostní limit na koncový bod, stanovení rozsahu klíče managementu |
| 📊**Pozorovatelnost**| 15+ | Integrace OpenTelemetry, sledování kvót v reálném čase, sledování nákladů na model |
| 🔄**Integrace poskytovatelů**| 20+ | Registr dynamického modelu, cooldowny poskytovatelů, kodex pro více účtů, analýza kvót Copilota |
| ⚡**Výkon**| 15+ | Dual cache layer, prompt cache, response cache, streaming keepalive, batch API |
| 🌐**Ekosystém**| 10+ | WebSocket API, konfigurace hot-reload, distribuované úložiště konfigurace, komerční režim |### 🔜 Coming Soon

- 🔗**Integrace OpenCode**– Podpora nativního poskytovatele pro IDE kódování OpenCode AI
- 🔗**Integrace TRAE**— Plná podpora pro vývojový rámec TRAE AI
- 📦**Batch API**— Asynchronní dávkové zpracování pro hromadné požadavky
- 🎯**Směrování založené na značkách**– Směrování požadavků na základě vlastních značek a metadat
- 💰**Strategie nejnižších nákladů**— Automaticky vyberte nejlevnějšího dostupného poskytovatele

> 📝 Úplné specifikace funkcí dostupné v [`docs/new-features/`](docs/new-features/) (217 podrobných specifikací)---

## 👥 Contributors

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)

### How to Contribute

1. Rozdělte úložiště
2. Vytvořte si větev funkcí (`git checkout -b feature/amazing-feature`)
3. Potvrďte změny (`git commit -m 'Přidat úžasnou funkci'`)
4. Push do větve (`git Push origin feature/amazing-feature`)
5. Otevřete žádost o stažení

Podrobné pokyny najdete na [CONTRIBUTING.md](CONTRIBUTING.md).### Releasing a New Version

```bash
# Create a release — npm publish happens automatically
gh release create v2.0.0 --title "v2.0.0" --generate-notes

---

📊 Star History

Stargazers over time

🙏 Acknowledgments

Zvláštní poděkování patří**9routeroddecolua**— původnímu projektu, který inspiroval tento fork. OmniRoute staví na tomto neuvěřitelném základu s dalšími funkcemi, multimodálními API a úplným přepsáním TypeScriptu.

Zvláštní poděkování patří**CLIProxyAPI**– původní implementaci Go, která inspirovala tento port JavaScriptu.---

Licence

Licence MIT – podrobnosti viz LICENCE.---

_{Built with ❤️ for developers who code 24/7
omniroute.online}