OmniRoute Dashboard # 🚀 OmniRoute — bezplatná brána AI ### Nikdy neprestávajte kódovať. Inteligentné smerovanie na **BEZPLATNÉ a nízkonákladové modely AI** s automatickým vrátením. _Váš univerzálny proxy server API – jeden koncový bod, 36+ poskytovateľov, nulové prestoje._ **Dokončenia četov • Vkladanie • Generovanie obrázkov • Zvuk • Zmena hodnotenia • 100 % TypeScript** --- ### 🤖 Bezplatný poskytovateľ AI pre vašich obľúbených kódovacích agentov _Pripojte akýkoľvek nástroj IDE alebo CLI poháňaný AI cez OmniRoute – bezplatnú bránu API pre neobmedzené kódovanie._
OpenClaw
OpenClaw
⭐ 205K 		NanoBot
NanoBot
⭐ 20.9K 		PicoClaw
PicoClaw
⭐ 14.6K 		ZeroClaw
ZeroClaw
⭐ 9.9K 		IronClaw
IronClaw
⭐ 2.1K
OpenCode
OpenCode
⭐ 106K 		Codex CLI
Codex CLI
⭐ 60.8K 		Claude Code
Claude Code
⭐ 67.3K 		Gemini CLI
Gemini CLI
⭐ 94.7K 		Kilo Code
Kilo Code
⭐ 15.5K
📡 Všetci agenti sa pripájajú cez http://localhost:20128/v1 alebo http://cloud.omniroute one/v1 modely a kvóta --- [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) [![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) [🌐 Website](https://omniroute.online) • [🚀 Quick Start](#-quick-start) • [💡 Features](#-key-features) • [📖 Docs](#-documentation) • [💰 Pricing](#-pricing-at-a-glance) • [💬 WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) 🌐 **Available in:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md) | 🇪🇸 [Español](README.es.md) | 🇫🇷 [Français](README.fr.md) | 🇮🇹 [Italiano](README.it.md) | 🇷🇺 [Русский](README.ru.md) | 🇨🇳 [中文 (简体)](README.zh-CN.md) | 🇩🇪 [Deutsch](README.de.md) | 🇮🇳 [हिन्दी](README.in.md) | 🇹🇭 [ไทย](README.th.md) | 🇺🇦 [Українська](README.uk-UA.md) | 🇸🇦 [العربية](README.ar.md) | 🇯🇵 [日本語](README.ja.md) | 🇻🇳 [Tiếng Việt](README.vi.md) | 🇧🇬 [Български](README.bg.md) | 🇩🇰 [Dansk](README.da.md) | 🇫🇮 [Suomi](README.fi.md) | 🇮🇱 [עברית](README.he.md) | 🇭🇺 [Magyar](README.hu.md) | 🇮🇩 [Bahasa Indonesia](README.id.md) | 🇰🇷 [한국어](README.ko.md) | 🇲🇾 [Bahasa Melayu](README.ms.md) | 🇳🇱 [Nederlands](README.nl.md) | 🇳🇴 [Norsk](README.no.md) | 🇵🇹 [Português (Portugal)](README.pt.md) | 🇷🇴 [Română](README.ro.md) | 🇵🇱 [Polski](README.pl.md) | 🇸🇰 [Slovenčina](README.sk.md) | 🇸🇪 [Svenska](README.sv.md) | 🇵🇭 [Filipino](README.phi.md)
--- ## 🤔 Prečo OmniRoute? **Prestaňte plytvať peniazmi a dosahovať limity:** - Kvóta odberu vyprší nevyužitá každý mesiac - Obmedzenia sadzieb vás zastavia uprostred kódovania - drahé rozhrania API (20 – 50 USD mesačne na poskytovateľa) - Manuálne prepínanie medzi poskytovateľmi **OmniRoute to rieši:** - ✅ **Maximalizujte odbery** - Sledujte kvótu, pred resetovaním použite každý bit - ✅ **Automatická záloha** - Predplatné → Kľúč API → Lacné → Bezplatne, nulové prestoje - ✅ **Viaceré účty** - Obojstranne medzi účtami na poskytovateľa - ✅ **Universal** - Funguje s Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, akýmkoľvek nástrojom CLI --- ## 🔄 Ako to funguje ``` ┌─────────────┐ │ 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] iFlow, Qwen, Kiro (unlimited) Result: Never stop coding, minimal cost ``` --- ## 🎯 What OmniRoute Solves — 16 Real Pain Points > **Every developer using AI tools faces these problems daily.** OmniRoute was built to solve them all — from cost overruns to regional blocks, from broken OAuth flows to zero observability.
💸 1. "I pay for an expensive subscription but still get interrupted by limits" Developers pay $20–200/month for Claude Pro, Codex Pro, or GitHub Copilot. Even paying, quota has a ceiling — 5h of usage, weekly limits, or per-minute rate limits. Mid-coding session, the provider stops responding and the developer loses flow and productivity. **How OmniRoute solves it:** - **Smart 4-Tier Fallback** — If subscription quota runs out, automatically redirects to API Key → Cheap → Free with zero manual intervention - **Real-Time Quota Tracking** — Shows token consumption in real-time with reset countdown (5h, daily, weekly) - **Multi-Account Support** — Multiple accounts per provider with auto round-robin — when one runs out, switches to the next - **Custom Combos** — Customizable fallback chains with 6 balancing strategies (fill-first, round-robin, P2C, random, least-used, cost-optimized) - **Codex Business Quotas** — Business/Team workspace quota monitoring directly in the dashboard
🔌 2. "I need to use multiple providers but each has a different API" OpenAI uses one format, Claude (Anthropic) uses another, Gemini yet another. If a dev wants to test models from different providers or fallback between them, they need to reconfigure SDKs, change endpoints, deal with incompatible formats. Custom providers (FriendLI, NIM) have non-standard model endpoints. **How OmniRoute solves it:** - **Unified Endpoint** — A single `http://localhost:20128/v1` serves as proxy for all 36+ providers - **Format Translation** — Automatic and transparent: OpenAI ↔ Claude ↔ Gemini ↔ Responses API - **Response Sanitization** — Strips non-standard fields (`x_groq`, `usage_breakdown`, `service_tier`) that break OpenAI SDK v1.83+ - **Role Normalization** — Converts `developer` → `system` for non-OpenAI providers; `system` → `user` for GLM/ERNIE - **Think Tag Extraction** — Extracts `` blocks from models like DeepSeek R1 into standardized `reasoning_content` - **Structured Output for Gemini** — `json_schema` → `responseMimeType`/`responseSchema` automatic conversion - **`stream` defaults to `false`** — Aligns with OpenAI spec, avoiding unexpected SSE in Python/Rust/Go SDKs
🌐 3. "My AI provider blocks my region/country" Providers like OpenAI/Codex block access from certain geographic regions. Users get errors like `unsupported_country_region_territory` during OAuth and API connections. This is especially frustrating for developers from developing countries. **How OmniRoute solves it:** - **3-Level Proxy Config** — Configurable proxy at 3 levels: global (all traffic), per-provider (one provider only), and per-connection/key - **Color-Coded Proxy Badges** — Visual indicators: 🟢 global proxy, 🟡 provider proxy, 🔵 connection proxy, always showing the IP - **OAuth Token Exchange Through Proxy** — OAuth flow also goes through the proxy, solving `unsupported_country_region_territory` - **Connection Tests via Proxy** — Connection tests use the configured proxy (no more direct bypass) - **SOCKS5 Support** — Full SOCKS5 proxy support for outbound routing - **TLS Fingerprint Spoofing** — Browser-like TLS fingerprint via `wreq-js` to bypass bot detection
🆓 4. "I want to use AI for coding but I have no money" Not everyone can pay $20–200/month for AI subscriptions. Students, devs from emerging countries, hobbyists, and freelancers need access to quality models at zero cost. **How OmniRoute solves it:** - **Free Tier Providers Built-in** — Native support for 100% free providers: iFlow (8 unlimited models), Qwen (3 unlimited models), Kiro (Claude for free), Gemini CLI (180K/month free) - **Free-Only Combos** — Chain `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = $0/month with zero downtime - **NVIDIA NIM Free Credits** — 1000 free credits integrated - **Cost Optimized Strategy** — Routing strategy that automatically chooses the cheapest available provider
🔒 5. "I need to protect my AI gateway from unauthorized access" When exposing an AI gateway to the network (LAN, VPS, Docker), anyone with the address can consume the developer's tokens/quota. Without protection, APIs are vulnerable to misuse, prompt injection, and abuse. **How OmniRoute solves it:** - **API Key Management** — Generation, rotation, and scoping per provider with a dedicated `/dashboard/api-manager` page - **Model-Level Permissions** — Restrict API keys to specific models (`openai/*`, wildcard patterns), with Allow All/Restrict toggle - **API Endpoint Protection** — Require a key for `/v1/models` and block specific providers from the listing - **Auth Guard + CSRF Protection** — All dashboard routes protected with `withAuth` middleware + CSRF tokens - **Rate Limiter** — Per-IP rate limiting with configurable windows - **IP Filtering** — Allowlist/blocklist for access control - **Prompt Injection Guard** — Sanitization against malicious prompt patterns - **AES-256-GCM Encryption** — Credentials encrypted at rest
🛑 6. "My provider went down and I lost my coding flow" AI providers can become unstable, return 5xx errors, or hit temporary rate limits. If a dev depends on a single provider, they're interrupted. Without circuit breakers, repeated retries can crash the application. **How OmniRoute solves it:** - **Circuit Breaker per-provider** — Auto-open/close with configurable thresholds and cooldown (Closed/Open/Half-Open) - **Exponential Backoff** — Progressive retry delays - **Anti-Thundering Herd** — Mutex + semaphore protection against concurrent retry storms - **Combo Fallback Chains** — If the primary provider fails, automatically falls through the chain with no intervention - **Combo Circuit Breaker** — Auto-disables failing providers within a combo chain - **Health Dashboard** — Uptime monitoring, circuit breaker states, lockouts, cache stats, p50/p95/p99 latency
🔧 7. "Configuring each AI tool is tedious and repetitive" Developers use Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Each tool needs a different config (API endpoint, key, model). Reconfiguring when switching providers or models is a waste of time. **How OmniRoute solves it:** - **CLI Tools Dashboard** — Dedicated page with one-click setup for Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline - **GitHub Copilot Config Generator** — Generates `chatLanguageModels.json` for VS Code with bulk model selection - **Onboarding Wizard** — Guided 4-step setup for first-time users - **One endpoint, all models** — Configure `http://localhost:20128/v1` once, access 36+ providers
🔑 8. "Managing OAuth tokens from multiple providers is hell" Claude Code, Codex, Gemini CLI, Copilot — all use OAuth 2.0 with expiring tokens. Developers need to re-authenticate constantly, deal with `client_secret is missing`, `redirect_uri_mismatch`, and failures on remote servers. OAuth on LAN/VPS is particularly problematic. **How OmniRoute solves it:** - **Auto Token Refresh** — OAuth tokens refresh in background before expiration - **OAuth 2.0 (PKCE) Built-in** — Automatic flow for Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow - **Multi-Account OAuth** — Multiple accounts per provider via JWT/ID token extraction - **OAuth LAN/Remote Fix** — Private IP detection for `redirect_uri` + manual URL mode for remote servers - **OAuth Behind Nginx** — Uses `window.location.origin` for reverse proxy compatibility - **Remote OAuth Guide** — Step-by-step guide for Google Cloud credentials on VPS/Docker
📊 9. "I don't know how much I'm spending or where" Developers use multiple paid providers but have no unified view of spending. Each provider has its own billing dashboard, but there's no consolidated view. Unexpected costs can pile up. **How OmniRoute solves it:** - **Cost Analytics Dashboard** — Per-token cost tracking and budget management per provider - **Budget Limits per Tier** — Spending ceiling per tier that triggers automatic fallback - **Per-Model Pricing Configuration** — Configurable prices per model - **Usage Statistics Per API Key** — Request count and last-used timestamp per key - **Analytics Dashboard** — Stat cards, model usage chart, provider table with success rates and latency
🐛 10. "I can't diagnose errors and problems in AI calls" When a call fails, the dev doesn't know if it was a rate limit, expired token, wrong format, or provider error. Fragmented logs across different terminals. Without observability, debugging is trial-and-error. **How OmniRoute solves it:** - **Unified Logs Dashboard** — 4 tabs: Request Logs, Proxy Logs, Audit Logs, Console - **Console Log Viewer** — Real-time terminal-style viewer with color-coded levels, auto-scroll, search, filter - **SQLite Proxy Logs** — Persistent logs that survive server restarts - **Translator Playground** — 4 debugging modes: Playground (format translation), Chat Tester (round-trip), Test Bench (batch), Live Monitor (real-time) - **Request Telemetry** — p50/p95/p99 latency + X-Request-Id tracing - **File-Based Logging with Rotation** — Console interceptor captures everything to JSON log with size-based rotation
🏗️ 11. "Deploying and maintaining the gateway is complex" Installing, configuring, and maintaining an AI proxy across different environments (local, VPS, Docker, cloud) is labor-intensive. Problems like hardcoded paths, `EACCES` on directories, port conflicts, and cross-platform builds add friction. **How OmniRoute solves it:** - **npm global install** — `npm install -g omniroute && omniroute` — done - **Docker Multi-Platform** — AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi) - **Docker Compose Profiles** — `base` (no CLI tools) and `cli` (with Claude Code, Codex, OpenClaw) - **Electron Desktop App** — Native app for Windows/macOS/Linux with system tray, auto-start, offline mode - **Split-Port Mode** — API and Dashboard on separate ports for advanced scenarios (reverse proxy, container networking) - **Cloud Sync** — Config synchronization across devices via Cloudflare Workers - **DB Backups** — Automatic backup, restore, export and import of all settings
🌍 12. "The interface is English-only and my team doesn't speak English" Teams in non-English-speaking countries, especially in Latin America, Asia, and Europe, struggle with English-only interfaces. Language barriers reduce adoption and increase configuration errors. **How OmniRoute solves it:** - **Dashboard i18n — 30 Languages** — All 500+ keys translated including Arabic, Bulgarian, Danish, German, Spanish, Finnish, French, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Dutch, Norwegian, Polish, Portuguese (PT/BR), Romanian, Russian, Slovak, Swedish, Thai, Ukrainian, Vietnamese, Chinese, Filipino, English - **RTL Support** — Right-to-left support for Arabic and Hebrew - **Multi-Language READMEs** — 30 complete documentation translations - **Language Selector** — Globe icon in header for real-time switching
🔄 13. "I need more than chat — I need embeddings, images, audio" AI isn't just chat completion. Devs need to generate images, transcribe audio, create embeddings for RAG, rerank documents, and moderate content. Each API has a different endpoint and format. **How OmniRoute solves it:** - **Embeddings** — `/v1/embeddings` with 6 providers and 9+ models - **Image Generation** — `/v1/images/generations` with 4 providers and 9+ models - **Audio Transcription** — `/v1/audio/transcriptions` — Whisper-compatible - **Text-to-Speech** — `/v1/audio/speech` — Multi-provider audio synthesis - **Moderations** — `/v1/moderations` — Content safety checks - **Reranking** — `/v1/rerank` — Document relevance reranking - **Responses API** — Full `/v1/responses` support for Codex
🧪 14. "I have no way to test and compare quality across models" Developers want to know which model is best for their use case — code, translation, reasoning — but comparing manually is slow. No integrated eval tools exist. **How OmniRoute solves it:** - **LLM Evaluations** — Golden set testing with 10 pre-loaded cases covering greetings, math, geography, code generation, JSON compliance, translation, markdown, safety refusal - **4 Match Strategies** — `exact`, `contains`, `regex`, `custom` (JS function) - **Translator Playground Test Bench** — Batch testing with multiple inputs and expected outputs, cross-provider comparison - **Chat Tester** — Full round-trip with visual response rendering - **Live Monitor** — Real-time stream of all requests flowing through the proxy
📈 15. "I need to scale without losing performance" As request volume grows, without caching the same questions generate duplicate costs. Without idempotency, duplicate requests waste processing. Per-provider rate limits must be respected. **How OmniRoute solves it:** - **Semantic Cache** — Two-tier cache (signature + semantic) reduces cost and latency - **Request Idempotency** — 5s deduplication window for identical requests - **Rate Limit Detection** — Per-provider RPM, min gap, and max concurrent tracking - **Editable Rate Limits** — Configurable defaults in Settings → Resilience with persistence - **API Key Validation Cache** — 3-tier cache for production performance - **Health Dashboard with Telemetry** — p50/p95/p99 latency, cache stats, uptime
🤖 16. "I want to control model behavior globally" Developers who want all responses in a specific language, with a specific tone, or want to limit reasoning tokens. Configuring this in every tool/request is impractical. **How OmniRoute solves it:** - **System Prompt Injection** — Global prompt applied to all requests - **Thinking Budget Validation** — Reasoning token allocation control per request (passthrough, auto, custom, adaptive) - **6 Routing Strategies** — Global strategies that determine how requests are distributed - **Wildcard Router** — `provider/*` patterns route dynamically to any provider - **Combo Enable/Disable Toggle** — Toggle combos directly from the dashboard - **Provider Toggle** — Enable/disable all connections for a provider with one click - **Blocked Providers** — Exclude specific providers from `/v1/models` listing
## ⚡ Rýchly štart **1. Inštalovať globálne:** ```bash npm install -g omniroute omniroute ``` 🎉 Dashboard sa otvára o `http://localhost:20128` | Príkaz | Popis | | ----------------------- | -------------------------------------- | | `omniroute` | Spustiť server (predvolený port 20128) | | `omniroute --port 3000` | Použiť vlastný port | | `omniroute --no-open` | Neotvárať automaticky prehliadač | | `omniroute --help` | Zobraziť pomoc | **2. Pripojte BEZPLATNÉHO poskytovateľa:** Dashboard → Poskytovatelia → Pripojiť **Claude Code** alebo **Antigravity** → Prihlásenie OAuth → Hotovo! **3. Použitie v nástroji CLI:** ``` Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings: Endpoint: http://localhost:20128/v1 API Key: [copy from dashboard] Model: if/kimi-k2-thinking ``` **To je všetko!** Začnite kódovať s modelmi AI ZDARMA. **Alternatíva – spustiť zo zdroja:** ```bash cp .env.example .env npm install PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev ``` --- ## 🐳 Docker OmniRoute je k dispozícii ako verejný obrázok Docker na [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute). **Rýchly beh:** ```bash docker run -d \ --name omniroute \ --restart unless-stopped \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **So súborom prostredia:** ```bash # Copy and edit .env first cp .env.example .env docker run -d \ --name omniroute \ --restart unless-stopped \ --env-file .env \ -p 20128:20128 \ -v omniroute-data:/app/data \ diegosouzapw/omniroute:latest ``` **Pomocou 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 ``` | Obrázok | Tag | Veľkosť | Popis | | ------------------------ | -------- | ------- | -------------------------- | | `diegosouzapw/omniroute` | `latest` | ~250 MB | Najnovšie stabilné vydanie | | `diegosouzapw/omniroute` | `1.0.3` | ~250 MB | Aktuálna verzia | --- --- ## 🖥️ Desktop App — Offline & Always-On > 🆕 **NEW!** OmniRoute is now available as a **native desktop application** for Windows, macOS, and Linux. - 🖥️ **Native Window** — Dedicated app window with system tray integration - 🔄 **Auto-Start** — Launch OmniRoute on system login - 🔔 **Native Notifications** — Get alerts for quota exhaustion or provider issues - ⚡ **One-Click Install** — NSIS (Windows), DMG (macOS), AppImage (Linux) - 🌐 **Offline Mode** — Works fully offline with bundled server ```bash npm run electron:dev # Development mode npm run electron:build # Current platform npm run electron:build:win # Windows (.exe) npm run electron:build:mac # macOS (.dmg) npm run electron:build:linux # Linux (.AppImage) ``` 📖 Full documentation: [`electron/README.md`](electron/README.md) --- ## 💰 Prehľad cien | Úroveň | Poskytovateľ | Náklady | Obnovenie kvóty | Najlepšie pre | | ----------------- | ----------------- | --------------------------- | ---------------------------- | --------------------------- | | **💳 PREDPLATNÉ** | Claude Code (Pro) | 20 USD/mesiac | 5h + týždenne | Už prihlásené | | | Codex (Plus/Pro) | 20 – 200 USD/mesiac | 5h + týždenne | Používatelia OpenAI | | | Gemini CLI | **ZADARMO** | 180 tis./mesiac + 1 tis./deň | Všetci! | | | GitHub Copilot | 10 – 19 USD/mes. | Mesačne | Používatelia GitHubu | | **🔑 API KEY** | NVIDIA NIM | **ZADARMO** (1000 kreditov) | Jednorazovo | Bezplatné testovanie úrovní | | | DeepSeek | Platba za použitie | Žiadne | Najlepšia cena/kvalita | | | Groq | Voľná ​​úroveň + platené | Obmedzená sadzba | Ultra-rýchle odvodenie | | | xAI (Grok) | Platba za použitie | Žiadne | Modely Grok | | | Mistral | Voľná ​​úroveň + platené | Obmedzená sadzba | Európska AI | | | OpenRouter | Platba za použitie | Žiadne | 100+ modelov | | **💰 LACNO** | GLM-4,7 | 0,6 USD/1 milión | Denne 10:00 | Záloha rozpočtu | | | MiniMax M2.1 | 0,2 USD/1 milión | 5-hodinové valcovanie | Najlacnejšia možnosť | | | Kimi K2 | 9 USD/mesiac byt | 10 miliónov tokenov/mesiac | Predvídateľné náklady | | **🆓 ZDARMA** | iFlow | 0 USD | Neobmedzené | 8 modelov zadarmo | | | Qwen | 0 USD | Neobmedzené | 3 modely zadarmo | | | Kiro | 0 USD | Neobmedzené | Claude zadarmo | **💡 Tip pre profesionálov:** Začnite s kombináciou Gemini CLI (180 000 zadarmo/mesiac) + iFlow (neobmedzene zadarmo) = cena 0 $! --- ## 💡 Kľúčové vlastnosti ### 🧠 Základné smerovanie a inteligencia | Funkcia | Čo to robí | | --------------------------------------------- | ----------------------------------------------------------------------------------------------- | | 🎯 **Inteligentná 4-úrovňová núdzová záloha** | Automatická trasa: Predplatné → Kľúč API → Lacné → Zadarmo | | 📊 **Sledovanie kvóty v reálnom čase** | Živý počet tokenov + reset odpočítavania na poskytovateľa | | 🔄 **Formátový preklad** | OpenAI ↔ Claude ↔ Gemini ↔ Kurzor ↔ Kiro bezšvové + dezinfekcia | | 👥 **Podpora viacerých účtov** | Viac účtov na poskytovateľa s inteligentným výberom | | 🔄 **Automatická obnova tokenov** | Tokeny OAuth sa automaticky obnovia s opätovným pokusom | | 🎨 **Vlastné kombá** | 6 stratégií: fill-first, round-robin, p2c, random, najmenej používané, nákladovo optimalizované | | 🧩 **Vlastné modely** | Pridajte akékoľvek ID modelu k akémukoľvek poskytovateľovi | | 🌐 **Wildcard Router** | Dynamicky smerujte vzory `provider/*` k akémukoľvek poskytovateľovi | | 🧠 **Premýšľajúci rozpočet** | Priechodný, automatický, vlastný a adaptívny režim pre modely uvažovania | | 🔀 **Model Aliases** | Auto-forward deprecated model IDs to current replacements (built-in + custom) | | ⚡ **Background Degradation** | Auto-route background tasks (titles, summaries) to cheaper models | | 💬 **Promptné vstrekovanie systému** | Globálna systémová výzva aplikovaná na všetky požiadavky | | 📄 **Responses API** | Plná podpora OpenAI Responses API (`/v1/responses`) pre Codex | ### 🎵 Multimodálne API | Funkcia | Čo to robí | | --------------------------- | ---------------------------------------------------------------- | | 🖼️ **Generovanie obrázkov** | `/v1/images/generations` — 4 poskytovatelia, 9+ modelov | | 📐 **Vloženie** | `/v1/embeddings` — 6 poskytovateľov, 9+ modelov | | 🎤 **Prepis zvuku** | `/v1/audio/transcriptions` — Kompatibilné so šepotom | | 🔊 **Prevod textu na reč** | `/v1/audio/speech` — Zvuková syntéza od viacerých poskytovateľov | | 🛡️ **Moderovania** | `/v1/moderations` — Kontroly bezpečnosti obsahu | | 🔀 **Reranking** | `/v1/rerank` — Zmena poradia relevantnosti dokumentu | ### 🛡️ Odolnosť a bezpečnosť | Funkcia | Čo to robí | | ------------------------------------- | ---------------------------------------------------------------------------------------------------------- | | 🔌 **Istič** | Automatické otváranie/zatváranie podľa poskytovateľa s konfigurovateľnými prahmi | | 🛡️ **Anti-hromové stádo** | Mutex + limit rýchlosti semaforu pre poskytovateľov kľúčov API | | 🧠 **Sémantická vyrovnávacia pamäť** | Dvojvrstvová vyrovnávacia pamäť (podpis + sémantika) znižuje náklady a latenciu | | ⚡ **Požiadajte o idempotenciu** | 5-sekundové okno na odstránenie duplicitných požiadaviek | | 🔒 ** Spoofing odtlačkov prstov TLS** | Obíďte detekciu botov na báze TLS cez wreq-js | | 🌐 **Filtrovanie IP** | Zoznam povolených/blokovaných pre riadenie prístupu API | | 📊 **Upraviteľné limity sadzieb** | Konfigurovateľné otáčky za minútu, minimálna medzera a maximálna súbežná rýchlosť na systémovej úrovni | | 💾 **Rate Limit Persistence** | Learned limits survive restarts via SQLite with 60s debounce + 24h staleness | | 🔄 **Token Refresh Resilience** | Per-provider circuit breaker (5 fails→30min) + 30s timeout per attempt | | 🛡 **API Endpoint Protection** | Auth gating + blokovanie poskytovateľa pre koncový bod `/models` | | 🔒 **Viditeľnosť proxy** | Farebne rozlíšené odznaky: 🟢 globálne, 🟡 poskytovateľ, 🔵 na pripojenie s IP displejom | | 🌐 **3-úrovňová konfigurácia proxy** | Nakonfigurujte proxy na globálnej úrovni, na úrovni jednotlivých poskytovateľov alebo na úrovni pripojenia | ### 📊 Pozorovateľnosť a analytika | Funkcia | Čo to robí | | ------------------------------------------ | ----------------------------------------------------------------------------------------------------- | | 📝 **Požiadať o prihlásenie** | Režim ladenia s úplnými protokolmi požiadaviek/odpovedí | | 💾 **Proxy protokoly SQLite** | Trvalé protokoly proxy prežijú reštart servera | | 📊 **Hlavný panel služby Analytics** | Poháňané recharts: štatistické karty, graf používania modelu, tabuľka poskytovateľov | | 📈 **Sledovanie pokroku** | Prihlásiť udalosti priebehu SSE pre streamovanie | | 🧪 **Hodnotenia LLM** | Testovanie zlatého setu so 4 stratégiami zápasu | | 🔍 **Požiadať o telemetriu** | p50/p95/p99 agregácia latencie + sledovanie X-request-Id | | 📋 **Hlavný panel denníkov** | Jednotná 4-kartová stránka: Protokoly požiadaviek, Protokoly proxy, Protokoly auditu, Konzola | | 🖥️ **Prehliadač denníka konzoly** | Prehliadač v terminálovom štýle v reálnom čase s filtrom úrovní, vyhľadávaním, automatickým posúvaním | | 📑 **Protokolovanie založené na súboroch** | Konzolový zachytávač zachytáva všetok výstup do súboru protokolu JSON s rotáciou | | 🏥 **Panel zdravia** | Doba prevádzky systému, stavy ističov, uzamknutia, štatistiky vyrovnávacej pamäte | | 💰 **Sledovanie nákladov** | Správa rozpočtu + konfigurácia cien podľa modelu | ### ☁️ Nasadenie a synchronizácia | Funkcia | Čo to robí | | ------------------------------ | ------------------------------------------------------------------------------- | | 💾 **Cloud Sync** | Synchronizujte konfiguráciu medzi zariadeniami cez Cloudflare Workers | | 🌐 **Nasadenie kdekoľvek** | Localhost, VPS, Docker, Cloudflare Workers | | 🔑 **Správa kľúčov API** | Generovanie, rotácia a rozsah kľúčov API podľa poskytovateľa | | 🧙 **Sprievodca onboardingom** | 4-krokové vedené nastavenie pre začínajúcich používateľov | | 🔧 **CLI Tools Dashboard** | Konfigurácia Claude, Codex, Cline, OpenClaw, Kilo, Antigravity jedným kliknutím | | 🔄 **Zálohy DB** | Automatické zálohovanie, obnovenie, export a import všetkých nastavení | | 🌐 **Internacionalizácia** | Plný i18n s next-intl — podpora angličtiny + portugalčiny (Brazília) | | 🌍 **Výber jazyka** | Ikona zemegule v hlavičke na prepínanie jazyka v reálnom čase (🇺🇸/🇧🇷) | | 📂 **Custom Data Directory** | `DATA_DIR` env var na prepísanie predvolenej cesty úložiska `~/.omniroute` |
📖 Podrobnosti funkcie ### 🎯 Inteligentná 4-úrovňová núdzová záloha Vytvorte kombá s automatickým núdzovým nastavením: ``` Combo: "my-coding-stack" 1. cc/claude-opus-4-6 (your subscription) 2. nvidia/llama-3.3-70b (free NVIDIA API) 3. glm/glm-4.7 (cheap backup, $0.6/1M) 4. if/kimi-k2-thinking (free fallback) → Auto switches when quota runs out or errors occur ``` ### 📊 Sledovanie kvóty v reálnom čase - Spotreba tokenov na poskytovateľa - Vynulovať odpočítavanie (5 hodín, denne, týždenne) - Odhad nákladov pre platené úrovne - Mesačné správy o výdavkoch ### 🔄 Preklad formátu Bezproblémový preklad medzi formátmi: – **OpenAI** ↔ **Claude** ↔ **Blíženci** ↔ **Odpovede OpenAI** - Váš nástroj CLI odošle formát OpenAI → OmniRoute preloží → Poskytovateľ dostane natívny formát - Funguje s akýmkoľvek nástrojom, ktorý podporuje vlastné koncové body OpenAI - **Dezinfekcia odozvy** – Odstráni neštandardné polia pre prísnu kompatibilitu OpenAI SDK - **Normalizácia rolí** — `developer` → `system` pre iné ako OpenAI; `system` → `user` pre modely GLM/ERNIE - **Extrahovanie značiek myslenia** — `` bloky → `reasoning_content` pre modely myslenia - **Štruktúrovaný výstup** — `json_schema` → Gemini's `responseMimeType`/`responseSchema` ### 👥 Podpora viacerých účtov - Pridajte viac účtov na poskytovateľa - Automatické cyklické alebo prioritné smerovanie - Návrat k ďalšiemu účtu, keď jeden dosiahne kvótu ### 🔄 Automatické obnovenie tokenu - Tokeny OAuth sa pred vypršaním platnosti automaticky obnovujú - Nie je potrebné manuálne opätovné overenie - Bezproblémové skúsenosti u všetkých poskytovateľov ### 🎨 Vlastné kombinácie - Vytvárajte neobmedzené kombinácie modelov - 6 stratégií: vyplňte najskôr, cyklicky, sila dvoch možností, náhodné, najmenej používané, nákladovo optimalizované - Zdieľajte kombinácie medzi zariadeniami pomocou synchronizácie cloudu ### 🏥 Panel zdravia - Stav systému (čas prevádzky, verzia, využitie pamäte) - Stavy ističov podľa poskytovateľa (zatvorené/otvorené/polootvorené) - Stav limitu sadzby a aktívne blokovania - Štatistika vyrovnávacej pamäte podpisov - Telemetria latencie (p50/p95/p99) + prompt cache - Obnovte zdravotný stav jedným kliknutím ### 🔧 Ihrisko pre prekladateľov OmniRoute obsahuje výkonné vstavané ihrisko pre prekladateľov so **4 režimami** na ladenie, testovanie a monitorovanie prekladov API: | Režim | Popis | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **💻 Ihrisko** | Priamy preklad formátu — vložte ľubovoľné telo požiadavky API a okamžite uvidíte, ako ju OmniRoute preloží medzi formátmi poskytovateľov (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Zahŕňa vzorové šablóny a automatickú detekciu formátu. | | **💬 Tester chatu** | Pošlite skutočné žiadosti o rozhovor cez OmniRoute a pozrite si celý spiatočný výlet: svoj vstup, preloženú žiadosť, odpoveď poskytovateľa a preloženú odpoveď späť. Neoceniteľné pre overenie kombinovaného smerovania. | | **🧪 Testovacia lavica** | Režim dávkového testovania – definujte viacero testovacích prípadov s rôznymi vstupmi a očakávanými výstupmi, spustite ich všetky naraz a porovnajte výsledky medzi poskytovateľmi a modelmi. | | **📱 Živý monitor** | Monitorovanie požiadaviek v reálnom čase – sledujte prichádzajúce požiadavky, ako prechádzajú cez OmniRoute, sledujte, ako prebiehajú preklady formátu naživo, a okamžite identifikujte problémy. | **Prístup:** Hlavný panel → Prekladač (bočný panel) ### 💾 Cloud Sync - Synchronizujte poskytovateľov, kombinácie a nastavenia medzi zariadeniami - Automatická synchronizácia na pozadí - Bezpečné šifrované úložisko
--- ## 🎯 Prípady použitia ### Prípad 1: „Mám predplatné Claude Pro“ **Problém:** Platnosť kvóty vyprší nevyužitá, obmedzenia sadzieb počas náročného kódovania ``` Combo: "maximize-claude" 1. cc/claude-opus-4-6 (use subscription fully) 2. glm/glm-4.7 (cheap backup when quota out) 3. if/kimi-k2-thinking (free emergency fallback) Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total vs. $20 + hitting limits = frustration ``` ### Prípad 2: „Chcem nulové náklady“ **Problém:** Nemôžem si dovoliť predplatné, potrebujem spoľahlivé kódovanie AI ``` Combo: "free-forever" 1. gc/gemini-3-flash (180K free/month) 2. if/kimi-k2-thinking (unlimited free) 3. qw/qwen3-coder-plus (unlimited free) Monthly cost: $0 Quality: Production-ready models ``` ### Prípad 3: „Potrebujem kódovanie 24/7, žiadne prerušenia“ **Problém:** Termíny, nemôžem si dovoliť prestoje ``` Combo: "always-on" 1. cc/claude-opus-4-6 (best quality) 2. cx/gpt-5.2-codex (second subscription) 3. glm/glm-4.7 (cheap, resets daily) 4. minimax/MiniMax-M2.1 (cheapest, 5h reset) 5. if/kimi-k2-thinking (free unlimited) Result: 5 layers of fallback = zero downtime ``` ### Prípad 4: „Chcem AI ZDARMA v OpenClaw“ **Problém:** Potrebujete asistenta AI v aplikáciách na odosielanie správ, úplne zadarmo ``` Combo: "openclaw-free" 1. if/glm-4.7 (unlimited free) 2. if/minimax-m2.1 (unlimited free) 3. if/kimi-k2-thinking (unlimited free) Monthly cost: $0 Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal... ``` --- ## 📖 Sprievodca nastavením
💳 Poskytovatelia predplatného ### Claude Code (Pro/Max) ```bash 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 pre profesionálov:** Používajte Opus na zložité úlohy, Sonnet na rýchlosť. OmniRoute sleduje kvótu na model! ### OpenAI Codex (Plus/Pro) ```bash Dashboard → Providers → Connect Codex → OAuth login (port 1455) → 5-hour + weekly reset Models: cx/gpt-5.2-codex cx/gpt-5.1-codex-max ``` ### Gemini CLI (ZADARMO 180 000/mesiac!) ```bash Dashboard → Providers → Connect Gemini CLI → Google OAuth → 180K completions/month + 1K/day Models: gc/gemini-3-flash-preview gc/gemini-2.5-pro ``` **Najlepšia hodnota:** Obrovská bezplatná úroveň! Použite to pred platenými úrovňami. ### Kopilot GitHub ```bash Dashboard → Providers → Connect GitHub → OAuth via GitHub → Monthly reset (1st of month) Models: gh/gpt-5 gh/claude-4.5-sonnet gh/gemini-3-pro ```
🔑 Kľúčoví poskytovatelia API ### NVIDIA NIM (1 000 kreditov ZDARMA!) 1. Zaregistrujte sa: [build.nvidia.com](https://build.nvidia.com) 2. Získajte bezplatný kľúč API (vrátane 1 000 kreditov na odvodenie) 3. Ovládací panel → Pridať poskytovateľa → NVIDIA NIM: - Kľúč API: `nvapi-your-key` **Modely:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` a 50+ ďalších **Tip pre profesionálov:** API kompatibilné s OpenAI – bezproblémovo funguje s prekladom formátu OmniRoute! ### DeepSeek 1. Zaregistrujte sa: [platform.deepseek.com](https://platform.deepseek.com) 2. Získajte kľúč API 3. Dashboard → Pridať poskytovateľa → DeepSeek **Modely:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder` ### Groq (dostupná bezplatná úroveň!) 1. Zaregistrujte sa: [console.groq.com](https://console.groq.com) 2. Získajte kľúč API (vrátane bezplatnej úrovne) 3. Dashboard → Pridať poskytovateľa → Groq **Modely:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b` **Tip pre profesionálov:** Ultra rýchle odvodenie – najlepšie pre kódovanie v reálnom čase! ### OpenRouter (100+ modelov) 1. Zaregistrujte sa: [openrouter.ai](https://openrouter.ai) 2. Získajte kľúč API 3. Dashboard → Pridať poskytovateľa → OpenRouter **Modely:** Získajte prístup k viac ako 100 modelom od všetkých hlavných poskytovateľov prostredníctvom jediného kľúča API.
💰 Lacní poskytovatelia (záložné) ### GLM-4,7 (denný reset, 0,6 $/1 milión) 1. Zaregistrujte sa: [Zhipu AI](https://open.bigmodel.cn/) 2. Získajte kľúč API z plánu kódovania 3. Panel → Pridať kľúč API: – Poskytovateľ: `glm` - API kľúč: `your-key` **Použitie:** `glm/glm-4.7` **Tip pre profesionálov:** Kódovací plán ponúka 3× kvótu za 1/7 cenu! Resetovať denne o 10:00. ### MiniMax M2.1 (5h reset, $0.20/1M) 1. Zaregistrujte sa: [MiniMax](https://www.minimax.io/) 2. Získajte kľúč API 3. Panel → Pridať kľúč API **Použitie:** `minimax/MiniMax-M2.1` **Tip pre profesionálov:** Najlacnejšia možnosť pre dlhý kontext (1 milión tokenov)! ### Kimi K2 (9 USD/mesiac) 1. Prihlásiť sa na odber: [Moonshot AI](https://platform.moonshot.ai/) 2. Získajte kľúč API 3. Panel → Pridať kľúč API **Použitie:** `kimi/kimi-latest` **Tip pre profesionálov:** Pevné 9 $/mesiac za 10 miliónov tokenov = 0,90 $/1 milión efektívnych nákladov!
🆓 BEZPLATNÍ poskytovatelia (núdzové zálohovanie) ### iFlow (8 modelov ZDARMA) ```bash Dashboard → Connect iFlow → iFlow OAuth login → Unlimited usage Models: if/kimi-k2-thinking if/qwen3-coder-plus if/glm-4.7 if/minimax-m2 if/deepseek-r1 ``` ### Qwen (3 modely ZDARMA) ```bash Dashboard → Connect Qwen → Device code authorization → Unlimited usage Models: qw/qwen3-coder-plus qw/qwen3-coder-flash ``` ### Kiro (Claude FREE) ```bash Dashboard → Connect Kiro → AWS Builder ID or Google/GitHub → Unlimited usage Models: kr/claude-sonnet-4.5 kr/claude-haiku-4.5 ```
🎨 Vytvoriť kombá ### Príklad 1: Maximalizujte predplatné → Lacné zálohovanie ``` 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 ``` ### Príklad 2: Iba zadarmo (nulové náklady) ``` 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! ```
🔧 CLI Integration ### IDE kurzora ``` 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 Na konfiguráciu jedným kliknutím použite stránku **CLI Tools** na informačnom paneli alebo upravte `~/.claude/settings.json` manuálne. ### Kódex CLI ```bash export OPENAI_BASE_URL="http://localhost:20128" export OPENAI_API_KEY="your-omniroute-api-key" codex "your prompt" ``` ### OpenClaw **Možnosť 1 – Dashboard (odporúčané):** ``` Dashboard → CLI Tools → OpenClaw → Select Model → Apply ``` **Možnosť 2 – Manuálne:** Upraviť `~/.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 iba s lokálnou OmniRoute. Použite `127.0.0.1` namiesto `localhost`, aby ste sa vyhli problémom s rozlíšením IPv6. ### Cline / Pokračovať / RooCode ``` Settings → API Configuration: Provider: OpenAI Compatible Base URL: http://localhost:20128/v1 API Key: [from OmniRoute dashboard] Model: if/kimi-k2-thinking ```
--- ## 🧪 Hodnotenia (Evals) OmniRoute obsahuje vstavaný hodnotiaci rámec na testovanie kvality odozvy LLM oproti zlatému súboru. Prístup k nej získate cez **Analytics → Evals** na hlavnom paneli. ### Vstavaná zlatá súprava Predinštalovaná sada „OmniRoute Golden Set“ obsahuje 10 testovacích prípadov, ktoré zahŕňajú: - Pozdravy, matematika, geografia, generovanie kódu - Súlad s formátom JSON, preklad, zníženie - Bezpečnostné odmietnutie (škodlivý obsah), počítanie, booleovská logika ### Stratégie hodnotenia | Stratégia | Popis | Príklad | | ---------- | ---------------------------------------------------------------------- | -------------------------------- | | `exact` | Výstup sa musí presne zhodovať | `"4"` | | `contains` | Výstup musí obsahovať podreťazec (nerozlišujú sa malé a veľké písmená) | `"Paris"` | | `regex` | Výstup musí zodpovedať vzoru regulárneho výrazu | `"1.*2.*3"` | | `custom` | Vlastná funkcia JS vracia true/false | `(output) => output.length > 10` | --- ## 🐛 Riešenie problémov
Kliknutím rozbalíte sprievodcu riešením problémov **„Jazykový model neposkytol správy“** - Kvóta poskytovateľa je vyčerpaná → Skontrolujte sledovanie kvót na paneli - Riešenie: Použite záložnú kombináciu alebo prejdite na lacnejšiu úroveň **Obmedzenie sadzby** - Vyčerpaná kvóta predplatného → Návrat na GLM/MiniMax - Pridať kombináciu: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking` **Platnosť tokenu OAuth vypršala** - Automaticky obnovuje OmniRoute - Ak problémy pretrvávajú: Dashboard → Provider → Reconnect **Vysoké náklady** - Skontrolujte štatistiky používania v hlavnom paneli → Náklady - Prepnite primárny model na GLM/MiniMax - Používajte bezplatnú vrstvu (Gemini CLI, iFlow) pre nekritické úlohy **Palubná doska sa otvára na nesprávnom porte** - Nastavte `PORT=20128` a `NEXT_PUBLIC_BASE_URL=http://localhost:20128` **Chyby synchronizácie v cloude** - Overte `BASE_URL` body na vašu spustenú inštanciu – Overte `CLOUD_URL` bodov k očakávanému koncovému bodu cloudu - Ponechajte hodnoty `NEXT_PUBLIC_*` zarovnané s hodnotami na strane servera **Prvé prihlásenie nefunguje** - Skontrolujte `INITIAL_PASSWORD` v `.env` – Ak nie je nastavené, záložné heslo je `123456` **Žiadne záznamy žiadostí** - Nastaviť `ENABLE_REQUEST_LOGS=true` v `.env` **Test pripojenia ukazuje „Neplatné“ pre poskytovateľov kompatibilných s OpenAI** - Mnohí poskytovatelia nevystavujú koncový bod `/models` - OmniRoute v1.0.6+ zahŕňa záložné overenie prostredníctvom dokončenia chatu - Uistite sa, že základná adresa URL obsahuje príponu `/v1` ### 🔐 OAuth em Servidor Remoto (Vzdialené nastavenie OAuth) > **⚠️ DÔLEŽITÉ pre používateľov s OmniRoute a diaľkovým ovládaním VPS/Docker/servidor** ### Od OAuth do Antigravity / Gemini CLI falha em servidores remotos? Osvedčuje **Antigravity** a **Gemini CLI** používame **Google OAuth 2.0** ako autentifikáciu. O Google exige que a `redirect_uri` usada no fluxo OAuth saja **exatamente** uma das URI pre-kadastradas no Google Cloud Console to use. Ako credenciais OAuth embutidas no OmniRoute estão cadastradas **apenas para `localhost`**. K dispozícii máte prístup k OmniRoute k vzdialenému servisu (napr.: `https://omniroute.meuservidor.com`), alebo k autenticite spoločnosti Google: ``` Error 400: redirect_uri_mismatch ``` ### Riešenie: Konfigurácia proprias poverenia OAuth Presný kód je **OAuth 2.0 Client ID** bez služby Google Cloud Console s identifikátorom URI. #### Passo a passo **1. Prístup k službe Google Cloud Console** Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials) **2. Crie um novo OAuth 2.0 Client ID** - Kliknite na **"+ Vytvoriť poverenia"** → **"ID klienta OAuth"** - Tipo de aplicativo: **"Webová aplikácia"** – Nome: escolha qualquer nome (napr.: `OmniRoute Remote`) **3. Adicione ako Authorized Redirect URI** Žiadne pole **"URI autorizovaného presmerovania"**, adicione: ``` https://seu-servidor.com/callback ``` > Substitua `seu-servidor.com` pelo domínio ou IP do seu servidor (inclua a porta se necessário, napr.: `http://45.33.32.156:20128/callback`). **4. Uložiť a kópiu ako poverenie** Após criar, o Google mostrará o **Client ID** e o **Client Secret**. **5. Konfigurovať ako 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 alebo OmniRoute** ```bash # Se usando npm: npm run dev # Se usando Docker: docker restart omniroute ``` **7. Tente conectar novamente** Dashboard → Poskytovatelia → Antigravitácia (alebo Gemini CLI) → OAuth Agora alebo Google presmerovaný korretamente pre `https://seu-servidor.com/callback` a autentické funkcie. --- ### Alternatívne dočasné riešenie (sem configurar credenciais próprias) Ak chcete získať prístup k dôvere, môžete použiť **prí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. **Skopírujte úplnú webovú adresu** 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. Kliknite na **"Pripojiť"** > Toto riešenie funguje pomocou autorizačného kódu na adrese URL a nezávislého presmerovania.
--- ## 🛠️ Tech Stack - **Runtime**: Node.js 18–22 LTS (⚠️ Node.js 24+ nie je **podporovaný** — `better-sqlite3` natívne binárne súbory sú nekompatibilné) – **Jazyk**: TypeScript 5.9 — **100 % TypeScript** v `src/` a `open-sse/` (v1.0.6) – **Framework**: Next.js 16 + React 19 + Tailwind CSS 4 - **Databáza**: LowDB (JSON) + SQLite (stav domény + protokoly proxy) - **Streamovanie**: Server-Sent Events (SSE) - **Auth**: OAuth 2.0 (PKCE) + JWT + kľúče API - **Testovanie**: Testovací program Node.js (viac ako 368 testov jednotiek) - **CI/CD**: Akcie GitHub (automatické zverejňovanie npm + Docker Hub pri vydaní) - **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) - **Odolnosť**: Istič, exponenciálny ústup, stádo proti hromu, spoofing TLS --- ## 📖 Dokumentácia | Dokument | Popis | | -------------------------------------------- | -------------------------------------------------------------- | | [User Guide](docs/USER_GUIDE.md) | Poskytovatelia, kombá, integrácia CLI, nasadenie | | [API Reference](docs/API_REFERENCE.md) | Všetky koncové body s príkladmi | | [Troubleshooting](docs/TROUBLESHOOTING.md) | Bežné problémy a riešenia | | [Architecture](docs/ARCHITECTURE.md) | Architektúra systému a vnútorné vybavenie | | [Contributing](CONTRIBUTING.md) | Nastavenie vývoja a usmernenia | | [OpenAPI Spec](docs/openapi.yaml) | Špecifikácia OpenAPI 3.0 | | [Security Policy](SECURITY.md) | Nahlasovanie zraniteľnosti a bezpečnostné postupy | | [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Kompletný sprievodca: nastavenie VM + nginx + Cloudflare | | [Features Gallery](docs/FEATURES.md) | Vizuálna prehliadka prístrojového panela so snímkami obrazovky | ### 📸 Ukážka hlavného panela
Kliknutím zobrazíte snímky obrazovky hlavného panela | Strana | Snímka obrazovky | | ---------------------- | ------------------------------------------------- | | **Poskytovatelia** | ![Providers](docs/screenshots/01-providers.png) | | **Kombá** | ![Combos](docs/screenshots/02-combos.png) | | **Analytika** | ![Analytics](docs/screenshots/03-analytics.png) | | **Zdravie** | ![Health](docs/screenshots/04-health.png) | | **Prekladateľ** | ![Translator](docs/screenshots/05-translator.png) | | **Nastavenia** | ![Settings](docs/screenshots/06-settings.png) | | **Nástroje CLI** | ![CLI Tools](docs/screenshots/07-cli-tools.png) | | **Denníky používania** | ![Usage](docs/screenshots/08-usage.png) | | **Koncový bod** | ![Endpoint](docs/screenshots/09-endpoint.png) |
--- ## 🗺️ Cestovná mapa OmniRoute má naplánovaných **210+ funkcií** vo viacerých fázach vývoja. Tu sú kľúčové oblasti: | Kategória | Plánované funkcie | Najdôležitejšie | | ------------------------------------------ | ----------------- | ------------------------------------------------------------------------------------------------------------------- | | 🧠 **Routovanie a inteligencia** | 25+ | Smerovanie s najnižšou latenciou, smerovanie založené na značkách, predbežná kontrola kvóty, výber účtu P2C | | 🔒 **Bezpečnosť a dodržiavanie predpisov** | 20+ | Spevnenie SSRF, maskovanie poverení, limit rýchlosti na koncový bod, rozsah kľúča riadenia | | 📊 **Pozorovateľnosť** | 15+ | Integrácia OpenTelemetry, monitorovanie kvót v reálnom čase, sledovanie nákladov na model | | 🔄 **Integrácie poskytovateľov** | 20+ | Register dynamických modelov, cooldowny poskytovateľov, kódex pre viacero účtov, analýza kvót Copilota | | ⚡ **Výkon** | 15+ | Dual cache layer, prompt cache, response cache, streaming keepalive, batch API | | 🌐 **Ekosystém** | 10+ | WebSocket API, rýchle opätovné načítanie konfigurácie, distribuovaný ukladací priestor konfigurácií, komerčný režim | ### 🔜 Už čoskoro - 🔗 **Integrácia OpenCode** – podpora natívneho poskytovateľa pre IDE kódovania OpenCode AI - 🔗 **Integrácia TRAE** – Úplná podpora vývojového rámca TRAE AI - 📦 **Batch API** – Asynchrónne dávkové spracovanie pre hromadné požiadavky - 🎯 ** Smerovanie založené na značkách** – Smerujte požiadavky na základe vlastných značiek a metadát - 💰 **Stratégia najnižšej ceny** — Automaticky vyberte najlacnejšieho dostupného poskytovateľa > 📝 Úplné špecifikácie funkcií sú k dispozícii v [link](docs/new-features/) (217 podrobných špecifikácií) --- ## 📧 Podpora > 💬 **Pripojte sa k našej komunite!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Získajte pomoc, zdieľajte tipy a buďte informovaní. - **Web**: [omniroute.online](https://omniroute.online) - **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) - **Problémy**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues) - **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - **Pôvodný projekt**: [9router by decolua](https://github.com/decolua/9router) --- ## 👥 Prispievatelia [![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) ### Ako prispieť 1. Fork úložisko 2. Vytvorte si pobočku funkcií (`git checkout -b feature/amazing-feature`) 3. Potvrďte zmeny (`git commit -m 'Add amazing feature'`) 4. Zatlačte na pobočku (`git push origin feature/amazing-feature`) 5. Otvorte požiadavku na stiahnutie Podrobné pokyny nájdete na stránke [CONTRIBUTING.md](CONTRIBUTING.md). ### Vydanie novej verzie ```bash # Create a release — npm publish happens automatically gh release create v1.0.6 --title "v1.0.6" --generate-notes ``` --- ## 📊 História hviezd Star History Chart --- ## 🙏 Poďakovanie Špeciálne poďakovanie patrí **[9router](https://github.com/decolua/9router)** od **[decolua](https://github.com/decolua)** – pôvodnému projektu, ktorý inšpiroval túto vidličku. OmniRoute stavia na tomto neuveriteľnom základe s ďalšími funkciami, multimodálnymi API a úplným prepísaním TypeScript. Špeciálne poďakovanie patrí **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** – pôvodnej implementácii Go, ktorá inšpirovala tento port JavaScript. --- ## 📄 Licencia Licencia MIT – podrobnosti nájdete na stránke [LICENSE](LICENSE). ---
Vytvorené pomocou ❤️ pre vývojárov, ktorí kódujú 24/7
omniroute.online