Skip to content

Latest commit

 

History

History
1372 lines (984 loc) · 65.2 KB

File metadata and controls

1372 lines (984 loc) · 65.2 KB
OmniRoute Dashboard

🚀 OmniRoute — darmowa bramka AI

Nigdy nie przestawaj kodować. Inteligentne przekierowywanie do BEZPŁATNYCH i tanich modeli AI z automatycznym powrotem.

Twój uniwersalny serwer proxy API — jeden punkt końcowy, ponad 36 dostawców, zero przestojów.

Uzupełnienia czatu • Osadzania • Generowanie obrazu • Dźwięk • Zmiana rankingu • 100% TypeScript


🤖 Bezpłatny dostawca AI dla Twoich ulubionych agentów kodujących

Połącz dowolne narzędzie IDE lub CLI oparte na sztucznej inteligencji poprzez OmniRoute — bezpłatną bramę API dla nieograniczonego kodowania.

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

📡 Wszyscy agenci łączą się przez http://localhost:20128/v1 lub http://cloud.omniroute.online/v1 — jedna konfiguracja, nieograniczona liczba modeli i limit


npm version Docker Hub License Website WhatsApp

🌐 Website🚀 Quick Start💡 Features📖 Docs💰 Pricing💬 WhatsApp

🌐 Available in: 🇺🇸 English | 🇧🇷 Português (Brasil) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 Deutsch | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino


🤔 Dlaczego OmniRoute?

Przestań marnować pieniądze i przekraczać limity:

  • Limit subskrypcji wygasa niewykorzystany co miesiąc
  • Limity szybkości zatrzymują Cię w połowie kodowania
  • Drogie interfejsy API (20-50 USD miesięcznie na dostawcę)
  • Ręczne przełączanie pomiędzy dostawcami

OmniRoute rozwiązuje ten problem:

  • Maksymalizuj liczbę subskrypcji - Śledź limit, wykorzystaj każdy bit przed zresetowaniem
  • Automatyczny powrót - Subskrypcja → Klucz API → Tani → Bezpłatny, zero przestojów
  • Wiele kont - Praca okrężna pomiędzy kontami każdego dostawcy
  • Uniwersalny - Działa z Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw i dowolnym narzędziem CLI

🔄 Jak to działa

┌─────────────┐
│  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 developersystem for non-OpenAI providers; systemuser for GLM/ERNIE
  • Think Tag Extraction — Extracts <think> blocks from models like DeepSeek R1 into standardized reasoning_content
  • Structured Output for Geminijson_schemaresponseMimeType/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 installnpm install -g omniroute && omniroute — done
  • Docker Multi-Platform — AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi)
  • Docker Compose Profilesbase (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 Strategiesexact, 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 Routerprovider/* 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

⚡ Szybki start

1. Zainstaluj globalnie:

npm install -g omniroute
omniroute

🎉 Panel otwiera się o http://localhost:20128

Polecenie Opis
omniroute Uruchom serwer (domyślny port 20128)
omniroute --port 3000 Użyj niestandardowego portu
omniroute --no-open Nie otwieraj automatycznie przeglądarki
omniroute --help Pokaż pomoc

2. Połącz się z DARMOWYM dostawcą:

Panel kontrolny → Dostawcy → Połącz Kod Claude lub Antygrawitacja → Logowanie OAuth → Gotowe!

3. Użyj w swoim narzędziu 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 wszystko! Zacznij kodować za pomocą DARMOWYCH modeli AI.

Alternatywa — uruchamiana ze źródła:

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

🐳 Doker

OmniRoute jest dostępny jako publiczny obraz Dockera na Docker Hub.

Szybki bieg:

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Z plikiem środowiska:

# 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

Korzystanie z funkcji Docker Compose:

# 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
Obraz Oznacz Rozmiar Opis
diegosouzapw/omniroute latest ~250 MB Najnowsza stabilna wersja
diegosouzapw/omniroute 1.0.3 ~250 MB Aktualna wersja


🖥️ 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
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


💰 Ceny w skrócie

Poziom Dostawca Koszt Reset przydziału Najlepsze dla
💳 SUBSKRYPCJA Claude Code (Pro) 20 USD/mies. 5h + tygodniowo Już subskrybujesz
Kodeks (Plus/Pro) 20-200 $/mies. 5h + tygodniowo Użytkownicy OpenAI
Bliźnięta CLI BEZPŁATNE 180 tys./mies. + 1 tys./dzień Wszyscy!
Drugi pilot GitHuba 10–19 USD/mies. Miesięczne Użytkownicy GitHuba
🔑 KLUCZ API NVIDIA NIM BEZPŁATNE (1000 kredytów) Jednorazowe Bezpłatne testowanie poziomów
DeepSeek Płatność za użycie Brak Najlepsza cena/jakość
Groq Poziom bezpłatny + płatny Stawka ograniczona Ultraszybkie wnioskowanie
xAI (Grok) Płatność za użycie Brak Modele Groka
Mistral Poziom bezpłatny + płatny Stawka ograniczona Europejska sztuczna inteligencja
OtwórzRouter Płatność za użycie Brak Ponad 100 modeli
💰 TANIO GLM-4.7 0,6 USD/1 mln Codziennie 10:00 Kopia zapasowa budżetu
MiniMax M2.1 0,2 USD/1 mln 5-godzinne toczenie Najtańsza opcja
Kimi K2 9 USD miesięcznie 10 mln tokenów/mies. Przewidywalny koszt
🆓 DARMOWE iFlow 0 dolarów Nieograniczony 8 modeli za darmo
Qwen 0 dolarów Nieograniczony 3 modele za darmo
Kiro 0 dolarów Nieograniczony Claude wolny

💡 Wskazówka dla profesjonalistów: Zacznij od zestawu Gemini CLI (180 tys. za darmo/miesiąc) + iFlow (bez ograniczeń za darmo) = koszt 0 USD!


💡 Kluczowe funkcje

🧠 Routing i inteligencja rdzenia

Funkcja Co to robi
🎯 Inteligentny 4-poziomowy powrót Auto-trasa: Subskrypcja → Klucz API → Tanie → Bezpłatne
📊 Śledzenie limitów w czasie rzeczywistym Liczba tokenów na żywo + odliczanie resetowania dla każdego dostawcy
🔄 Tłumaczenie formatu OpenAI ↔ Claude ↔ Bliźnięta ↔ Kursor ↔ Kiro bezproblemowo + oczyszczanie odpowiedzi
👥 Obsługa wielu kont Wiele kont na dostawcę z inteligentnym wyborem
🔄 Automatyczne odświeżanie tokena Tokeny OAuth odświeżają się automatycznie przy ponownej próbie
🎨 Niestandardowe kombinacje 6 strategii: najpierw wypełnij, okrężnie, p2c, losowa, najrzadziej używana, zoptymalizowana pod względem kosztów
🧩 Modele niestandardowe Dodaj dowolny identyfikator modelu do dowolnego dostawcy
🌐 Router z dziką kartą Dynamicznie kieruj provider/* wzorce do dowolnego dostawcy
🧠 Myślący budżet Tryby przekazywania, automatyczne, niestandardowe i adaptacyjne dla modeli wnioskowania
🔀 Model Aliases Auto-forward deprecated model IDs to current replacements (built-in + custom)
Background Degradation Auto-route background tasks (titles, summaries) to cheaper models
💬 Wstrzyknięcie monitu systemowego Globalny monit systemowy stosowany do wszystkich żądań
📄 API odpowiedzi Pełna obsługa OpenAI Responses API (/v1/responses) dla Codexu

🎵 Wielomodalne interfejsy API

Funkcja Co to robi
🖼️ Generowanie obrazu /v1/images/generations — 4 dostawców, ponad 9 modeli
📐 Osadzenia /v1/embeddings — 6 dostawców, ponad 9 modeli
🎤 Transkrypcja audio /v1/audio/transcriptions — Kompatybilny z szeptem
🔊 Zamiana tekstu na mowę /v1/audio/speech — Synteza dźwięku wielu dostawców
🛡️ Moderacje /v1/moderations — Kontrola bezpieczeństwa treści
🔀 Ponowna pozycja /v1/rerank — Zmiana rankingu trafności dokumentu

🛡️ Odporność i bezpieczeństwo

Funkcja Co to robi
🔌 Wyłącznik Automatyczne otwieranie/zamykanie dla każdego dostawcy z konfigurowalnymi progami
🛡️ Stado Przeciw Gromom Mutex + limit szybkości semaforów dla dostawców kluczy API
🧠 Pamięć podręczna semantyczna Dwuwarstwowa pamięć podręczna (podpis + semantyka) zmniejsza koszty i opóźnienia
Poproś o idempotencję Okno deduplikacji 5s dla zduplikowanych żądań
🔒 Podrabianie odcisków palców TLS Pomiń wykrywanie botów opartych na TLS poprzez wreq-js
🌐 Filtrowanie IP Lista dozwolonych/blokowanych dla kontroli dostępu API
📊 Edytowalne limity stawek Konfigurowalne obroty, minimalna przerwa i maksymalna równowaga na poziomie systemu
💾 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
🛡 Ochrona punktu końcowego API Bramkowanie uwierzytelniania + blokowanie dostawcy dla punktu końcowego /models
🔒 Widoczność proxy Oznaczone kolorami plakietki: 🟢 globalny, 🟡 dostawca, 🔵 na połączenie z wyświetlaczem IP
🌐 3-poziomowa konfiguracja serwera proxy Skonfiguruj serwery proxy na poziomie globalnym, dla dostawcy lub dla połączenia

📊 Obserwacja i analityka

Funkcja Co to robi
📝 Poproś o zalogowanie Tryb debugowania z pełnymi dziennikami żądań/odpowiedzi
💾 Dzienniki proxy SQLite Trwałe dzienniki proxy przetrwają ponowne uruchomienie serwera
📊 Panel analityczny Oparte na Recharts: karty statystyk, wykres wykorzystania modelu, tabela dostawców
📈 Śledzenie postępów Zapisz się na wydarzenia postępu SSE dla transmisji strumieniowej
🧪 Oceny LLM Testowanie złotego seta z 4 strategiami meczowymi
🔍 Poproś o telemetrię Agregacja opóźnień p50/p95/p99 + śledzenie X-Request-Id
📋 Panel logów Ujednolicona strona z czterema zakładkami: Dzienniki żądań, Dzienniki proxy, Dzienniki audytu, Konsola
🖥️ Przeglądarka logów konsoli Przeglądarka przypominająca terminal w czasie rzeczywistym z filtrem poziomów, wyszukiwaniem i automatycznym przewijaniem
📑 Rejestrowanie oparte na plikach Przechwytywacz konsoli przechwytuje wszystkie dane wyjściowe do pliku dziennika JSON z rotacją
🏥 Panel zdrowia Czas pracy systemu, stany wyłączników, blokady, statystyki pamięci podręcznej
💰 Śledzenie kosztów Zarządzanie budżetem + konfiguracja cen dla poszczególnych modeli

☁️ Wdrożenie i synchronizacja

Funkcja Co to robi
💾 Synchronizacja z chmurą Synchronizuj konfigurację między urządzeniami za pośrednictwem Cloudflare Workers
🌐 Wdrażaj gdziekolwiek Localhost, VPS, Docker, Pracownicy Cloudflare
🔑 Zarządzanie kluczami API Generuj, obracaj i ustalaj zakres kluczy API dla każdego dostawcy
🧙 Kreator wdrażania Konfiguracja z przewodnikiem w 4 krokach dla początkujących użytkowników
🔧 Panel narzędzi CLI Jednym kliknięciem skonfiguruj Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 Kopie zapasowe DB Automatyczne tworzenie kopii zapasowych, przywracanie, eksportowanie i importowanie wszystkich ustawień
🌐 Internacjonalizacja Pełny i18n z next-intl — obsługa języka angielskiego i portugalskiego (Brazylia)
🌍 Wybór języka Ikona kuli ziemskiej w nagłówku umożliwiająca zmianę języka w czasie rzeczywistym (🇺🇸/🇧🇷)
📂 Niestandardowy katalog danych DATA_DIR env var, aby zastąpić domyślną ścieżkę przechowywania ~/.omniroute
📖 Szczegóły funkcji

🎯 Inteligentny 4-poziomowy powrót awaryjny

Twórz kombinacje z automatycznym cofaniem:

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

📊 Śledzenie limitów w czasie rzeczywistym

  • Zużycie tokenów na dostawcę
  • Zresetuj odliczanie (5-godzinne, dzienne, tygodniowe)
  • Szacowanie kosztów dla płatnych poziomów
  • Miesięczne raporty wydatków

🔄 Tłumaczenie formatu

Płynne tłumaczenie pomiędzy formatami:

  • OpenAIClaudeBliźniętaOdpowiedzi OpenAI
  • Twoje narzędzie CLI wysyła format OpenAI → OmniRoute tłumaczy → Dostawca otrzymuje format natywny
  • Działa z każdym narzędziem obsługującym niestandardowe punkty końcowe OpenAI
  • Oczyszczanie odpowiedzi — Usuwa niestandardowe pola w celu zapewnienia ścisłej zgodności z OpenAI SDK
  • Normalizacja róldevelopersystem dla innych niż OpenAI; systemuser dla modeli GLM/ERNIE
  • Pomyśl o ekstrakcji tagów<think> bloki → reasoning_content dla modeli myślących
  • Ustrukturyzowane dane wyjściowejson_schema → Gemini responseMimeType/responseSchema

👥 Obsługa wielu kont

  • Dodaj wiele kont na dostawcę
  • Automatyczne routing okrężny lub oparty na priorytetach
  • Powrót do następnego konta, gdy jedno osiągnie limit

🔄 Automatyczne odświeżanie tokena

  • Tokeny OAuth są automatycznie odświeżane przed wygaśnięciem
  • Nie ma potrzeby ręcznego ponownego uwierzytelniania
  • Jednolite doświadczenie u wszystkich dostawców

🎨 Niestandardowe kombinacje

  • Twórz nieograniczone kombinacje modeli
  • 6 strategii: najpierw wypełnij, okrężnie, siła dwóch wyborów, losowa, najrzadziej używana, zoptymalizowana pod względem kosztów
  • Udostępniaj kombinacje na różnych urządzeniach dzięki Cloud Sync

🏥 Panel zdrowia

  • Stan systemu (czas działania, wersja, wykorzystanie pamięci)
  • Stany wyłączników według dostawcy (zamknięty/otwarty/półotwarty)
  • Stan limitu szybkości i aktywne blokady
  • Statystyki pamięci podręcznej podpisów
  • Telemetria opóźnień (p50/p95/p99) + pamięć podręczna podpowiedzi
  • Zresetuj stan zdrowia jednym kliknięciem

🔧 Plac zabaw dla tłumaczy

OmniRoute zawiera potężny, wbudowany plac zabaw dla tłumaczy z 4 trybami do debugowania, testowania i monitorowania tłumaczeń API:

Tryb Opis
💻 Plac zabaw Bezpośrednie tłumaczenie formatu — wklej dowolną treść żądania API i od razu zobacz, jak OmniRoute tłumaczy ją pomiędzy formatami dostawców (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Zawiera przykładowe szablony i automatyczne wykrywanie formatu.
💬 Tester czatu Wysyłaj prawdziwe prośby o czat za pośrednictwem OmniRoute i zobacz pełny przebieg: Twoje dane wejściowe, przetłumaczone żądanie, odpowiedź dostawcy i przetłumaczona odpowiedź z powrotem. Nieocenione przy sprawdzaniu routingu combo.
🧪 Stanowisko testowe Tryb testowania wsadowego — zdefiniuj wiele przypadków testowych z różnymi danymi wejściowymi i oczekiwanymi wynikami, uruchom je wszystkie na raz i porównaj wyniki u różnych dostawców i modeli.
📱 Monitorowanie na żywo Monitorowanie żądań w czasie rzeczywistym — obserwuj przychodzące żądania przepływające przez OmniRoute, obserwuj na żywo tłumaczenia formatów i natychmiast identyfikuj problemy.

Dostęp: Panel → Tłumacz (pasek boczny)

💾 Synchronizacja z chmurą

  • Synchronizuj dostawców, kombinacje i ustawienia na różnych urządzeniach
  • Automatyczna synchronizacja w tle
  • Bezpieczne szyfrowane przechowywanie

🎯 Przypadki użycia

Przypadek 1: „Mam subskrypcję Claude Pro”

Problem: Limit wygasa niewykorzystany, limity szybkości podczas intensywnego kodowania

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

Przypadek 2: „Chcę zerowych kosztów”

Problem: Nie stać Cię na subskrypcje, potrzebujesz niezawodnego kodowania 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

Przypadek 3: „Potrzebuję kodowania 24 godziny na dobę, 7 dni w tygodniu, bez przerw”

Problem: Terminy, nie mogę sobie pozwolić na przestoje

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

Przypadek 4: „Chcę DARMOWEJ sztucznej inteligencji w OpenClaw”

Problem: Potrzebujesz asystenta AI w aplikacjach do przesyłania wiadomości, całkowicie za darmo

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...

📖 Przewodnik konfiguracji

💳 Dostawcy subskrypcji

Kod Claude’a (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

Wskazówka dla profesjonalistów: używaj Opus do skomplikowanych zadań, a Sonnet do szybkości. OmniRoute śledzi limit na model!

Kodeks OpenAI (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

Gemini CLI (DARMOWE 180 tys./miesiąc!)

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

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

Najlepsza wartość: Ogromny darmowy poziom! Użyj tego przed płatnymi poziomami.

Drugi pilot GitHuba

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
🔑 Dostawcy kluczy API

NVIDIA NIM (DARMOWE 1000 kredytów!)

  1. Zarejestruj się: build.nvidia.com
  2. Uzyskaj bezpłatny klucz API (w cenie 1000 kredytów)
  3. Panel kontrolny → Dodaj dostawcę → NVIDIA NIM:
    • Klucz API: nvapi-your-key

Modele: nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct i ponad 50 innych

Wskazówka dla profesjonalistów: API zgodne z OpenAI — działa bezproblemowo z tłumaczeniem formatu OmniRoute!

DeepSeek

  1. Zarejestruj się: platform.deepseek.com
  2. Zdobądź klucz API
  3. Panel kontrolny → Dodaj dostawcę → DeepSeek

Modele: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (dostępny bezpłatny poziom!)

  1. Zarejestruj się: console.groq.com
  2. Uzyskaj klucz API (w cenie bezpłatna warstwa)
  3. Panel kontrolny → Dodaj dostawcę → Groq

Modele: groq/llama-3.3-70b, groq/mixtral-8x7b

Wskazówka dla profesjonalistów: Ultraszybkie wnioskowanie — najlepsze do kodowania w czasie rzeczywistym!

OpenRouter (ponad 100 modeli)

  1. Zarejestruj się: openrouter.ai
  2. Zdobądź klucz API
  3. Panel kontrolny → Dodaj dostawcę → OpenRouter

Modele: Uzyskaj dostęp do ponad 100 modeli wszystkich głównych dostawców za pomocą jednego klucza API.

💰 Tani dostawcy (kopia zapasowa)

GLM-4.7 (reset dzienny, 0,6 USD/1 mln)

  1. Zarejestruj się: Zhipu AI
  2. Uzyskaj klucz API z planu kodowania
  3. Panel → Dodaj klucz API:
    • Dostawca: glm
    • Klucz API: your-key

Użyj: glm/glm-4.7

Wskazówka dla profesjonalistów: Plan kodowania oferuje 3× limit przy cenie 1/7! Resetuj codziennie o 10:00.

MiniMax M2.1 (reset 5 godz., 0,20 USD/1 mln)

  1. Zarejestruj się: MiniMax
  2. Zdobądź klucz API
  3. Panel → Dodaj klucz API

Użyj: minimax/MiniMax-M2.1

Wskazówka dla profesjonalistów: Najtańsza opcja dla długiego kontekstu (1 milion tokenów)!

Kimi K2 (9 USD miesięcznie)

  1. Subskrybuj: Moonshot AI
  2. Zdobądź klucz API
  3. Panel → Dodaj klucz API

Użyj: kimi/kimi-latest

Wskazówka dla profesjonalistów: Naprawiono 9 USD miesięcznie za 10 mln tokenów = efektywny koszt 0,90 USD/1 mln!

🆓 BEZPŁATNI dostawcy (awaryjna kopia zapasowa)

iFlow (8 DARMOWYCH modeli)

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 DARMOWE modele)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

Kiro (Claude ZA DARMO)

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

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5
🎨 Utwórz kombinacje

Przykład 1: Maksymalizuj subskrypcję → Tania kopia zapasowa

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

Przykład 2: Tylko bezpłatny (zero kosztów)

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!
🔧 Integracja z CLI

IDE kursora

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

Kod Claude’a

Użyj strony Narzędzia CLI w panelu kontrolnym, aby dokonać konfiguracji jednym kliknięciem, lub edytuj ręcznie ~/.claude/settings.json.

Interfejs wiersza polecenia Kodeksu

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

codex "your prompt"

OpenClaw

Opcja 1 — Panel kontrolny (zalecany):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

Opcja 2 — Ręcznie: Edytuj ~/.openclaw/openclaw.json:

{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

Uwaga: OpenClaw działa tylko z lokalnym OmniRoute. Użyj 127.0.0.1 zamiast localhost, aby uniknąć problemów z rozdzielczością IPv6.

Kliknij / Kontynuuj / RooCode

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

🧪 Oceny (Ewaluacje)

OmniRoute zawiera wbudowaną platformę ewaluacyjną do testowania jakości odpowiedzi LLM na podstawie złotego zestawu. Uzyskaj do niego dostęp poprzez Analytics → Evals na pulpicie nawigacyjnym.

Wbudowany złoty zestaw

Fabrycznie załadowany „Złoty zestaw OmniRoute” zawiera 10 przypadków testowych obejmujących:

  • Pozdrowienia, matematyka, geografia, generowanie kodu
  • Zgodność z formatem JSON, tłumaczenie, przecena
  • Odmowa bezpieczeństwa (szkodliwa treść), liczenie, logika boolowska

Strategie oceny

Strategia Opis Przykład
exact Dane wyjściowe muszą dokładnie odpowiadać "4"
contains Dane wyjściowe muszą zawierać podciąg (wielkość liter nie ma znaczenia) "Paris"
regex Dane wyjściowe muszą pasować do wzorca wyrażenia regularnego "1.*2.*3"
custom Niestandardowa funkcja JS zwraca wartość prawda/fałsz (output) => output.length > 10

🐛 Rozwiązywanie problemów

Kliknij, aby rozwinąć przewodnik rozwiązywania problemów

„Model językowy nie dostarczał komunikatów”

  • Wyczerpany limit dostawcy → Sprawdź moduł śledzenia limitów na pulpicie nawigacyjnym
  • Rozwiązanie: użyj kombinacji zastępczej lub przejdź na tańszy poziom

Ograniczenie szybkości

  • Limit subskrypcji wyczerpany → Powrót do GLM/MiniMax
  • Dodaj kombinację: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

Token OAuth wygasł

  • Automatyczne odświeżanie przez OmniRoute
  • Jeśli problemy nadal występują: Panel kontrolny → Dostawca → Połącz ponownie

Wysokie koszty

  • Sprawdź statystyki użytkowania w Panelu → Koszty
  • Zmień model podstawowy na GLM/MiniMax
  • Korzystaj z bezpłatnej warstwy (Gemini CLI, iFlow) do zadań niekrytycznych

** Panel otwiera się na złym porcie **

  • Ustaw PORT=20128 i NEXT_PUBLIC_BASE_URL=http://localhost:20128

Błędy synchronizacji z chmurą

  • Sprawdź, czy BASE_URL wskazuje na działającą instancję
  • Sprawdź, czy CLOUD_URL wskazuje na oczekiwany punkt końcowy w chmurze
  • Zachowaj wyrównanie wartości NEXT_PUBLIC_* z wartościami po stronie serwera

Pierwsze logowanie nie działa

  • Sprawdź INITIAL_PASSWORD w .env
  • Jeśli nieustawione, hasło zastępcze to 123456

Brak dzienników żądań

  • Ustaw ENABLE_REQUEST_LOGS=true w .env

Test połączenia pokazuje „Nieprawidłowy” dla dostawców kompatybilnych z OpenAI

  • Wielu dostawców nie udostępnia punktu końcowego /models
  • OmniRoute v1.0.6+ zawiera weryfikację awaryjną poprzez uzupełnianie czatu
  • Upewnij się, że podstawowy adres URL zawiera przyrostek /v1

🔐 OAuth na serwerze zdalnym (zdalna konfiguracja OAuth)

⚠️ WAŻNE dla zwykłych usług OmniRoute w VPS/Docker/serwidor zdalny

Por que o OAuth do Antigravity / Gemini CLI falha na zdalnych serwerach?

Sprawdzone Antigravity i Gemini CLI używane Google OAuth 2.0 dla autentyczności. O Google, jeśli potrzebujesz redirect_uri, aby nie zmieniać protokołu OAuth seja exatamente uma das URI pre-cadastradas no Google Cloud Console to aplicativo.

Jako uwierzytelnienie OAuth zostało wydane przez OmniRoute w cadastradas apenas dla localhost. Możesz uzyskać dostęp do OmniRoute na serwerze zdalnym (np.: https://omniroute.meuservidor.com), lub Google rejeita a autenticação com:

Error 400: redirect_uri_mismatch

Rozwiązanie: Skonfiguruj suas próprias credenciais OAuth

Precyzyjne żądanie Identyfikator klienta OAuth 2.0 nie Google Cloud Console poprzez URI do tego serwera.

Passo za passo

1. Dostęp do konsoli Google Cloud

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

2. Wezwij nowy identyfikator klienta OAuth 2.0

  • Kliknij "+ Utwórz dane uwierzytelniające""Identyfikator klienta OAuth"
  • Typ aplikacji: "Aplikacja internetowa"
  • Nazwa: escolha qualquer nom (np.: OmniRoute Remote)

3. Adicione jako autoryzowane identyfikatory URI przekierowań

Bez komentarza „Autoryzowane identyfikatory URI przekierowań”, rada:

https://seu-servidor.com/callback

Substitua seu-servidor.com pelo domínio lub IP do seu servidor (w tym porta se necessário, np.: http://45.33.32.156:20128/callback).

4. Zapisz i skopiuj jako poświadczenie

Após criar, o Google mostrará o Identyfikator klienta i o Tajemnica klienta.

5. Skonfiguruj jako variáveis de ambiente

Nie seu .env (lub nas variáveis de ambiente do Docker):

# 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 lub OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7. Tente conectar novamente

Panel kontrolny → Dostawcy → Antygrawitacja (lub Gemini CLI) → OAuth

Agora o Google redirecionará corretamente dla https://seu-servidor.com/callback i autentyczna funkcja.


Obejście tymczasowe (sem configurar credenciais prróprias)

Jeśli chcesz uzyskać dostęp do podręcznika URL:

  1. OmniRoute abrirá adres URL autoryzacji w Google
  2. Após você autorizar, o Google tentará redirecionar para localhost (que falha no servidor remoto)
  3. Skopiuj kompletny adres URL da barra de endereço do seu przeglądarki (wiadomość que a página não carregue)
  4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
  5. Kliknij je „Połącz”

To obejście funkcji porque o kodigo de autorização na URL é válido niezależny do przekierowania ter carregado ou não.


🛠️ Stos technologii

  • Środowisko wykonawcze: Node.js 18–22 LTS (⚠️ Node.js 24+ jest nieobsługiwanybetter-sqlite3 natywne pliki binarne są niekompatybilne)
  • Język: TypeScript 5.9 — 100% TypeScript w src/ i open-sse/ (v1.0.6)
  • Framework: Next.js 16 + React 19 + Tailwind CSS 4
  • Baza danych: LowDB (JSON) + SQLite (stan domeny + logi proxy)
  • Streaming: zdarzenia wysyłane przez serwer (SSE)
  • Auth: OAuth 2.0 (PKCE) + JWT + klucze API
  • Testowanie: Uruchomienie testu Node.js (ponad 368 testów jednostkowych)
  • CI/CD: Akcje GitHub (automatyczne publikowanie npm + Docker Hub w momencie wydania)
  • Strona internetowa: omniroute.online
  • Pakiet: npmjs.com/package/omniroute
  • Doker: hub.docker.com/r/diegosouzapw/omniroute
  • Odporność: wyłącznik automatyczny, wykładnicze wycofywanie, stado przeciwgrzmotowe, fałszowanie TLS

📖 Dokumentacja

Dokument Opis
User Guide Dostawcy, kombinacje, integracja CLI, wdrożenie
API Reference Wszystkie punkty końcowe z przykładami
Troubleshooting Typowe problemy i rozwiązania
Architecture Architektura systemu i elementy wewnętrzne
Contributing Konfiguracja i wytyczne dotyczące programowania
OpenAPI Spec Specyfikacja OpenAPI 3.0
Security Policy Zgłaszanie luk w zabezpieczeniach i praktyki bezpieczeństwa
VM Deployment Kompletny przewodnik: konfiguracja VM + nginx + Cloudflare
Features Gallery Wizualna wycieczka po panelu ze zrzutami ekranu

📸 Podgląd panelu

Kliknij, aby zobaczyć zrzuty ekranu panelu kontrolnego
Strona Zrzut ekranu
Dostawcy Providers
Kombinacje Combos
Analiza Analytics
Zdrowie Health
Tłumacz Translator
Ustawienia Settings
Narzędzia CLI CLI Tools
Dzienniki użytkowania Usage
Punkt końcowy Endpoint

🗺️ Plan działania

OmniRoute ma ponad 210 funkcji zaplanowanych w wielu fazach rozwoju. Oto kluczowe obszary:

Kategoria Planowane funkcje Najważniejsze
🧠 Routing i inteligencja 25+ Routing z najmniejszym opóźnieniem, routing oparty na tagach, wstępna inspekcja przydziału, wybór konta P2C
🔒 Bezpieczeństwo i zgodność 20+ Wzmocnienie SSRF, maskowanie poświadczeń, limit szybkości na punkt końcowy, zakres kluczy zarządzania
📊 Obserwowalność 15+ Integracja OpenTelemetry, monitorowanie kwot w czasie rzeczywistym, śledzenie kosztów według modelu
🔄 Integracja dostawców 20+ Rejestr modeli dynamicznych, czasy odnowienia dostawcy, Kodeks dla wielu kont, analiza przydziału Copilot
Wydajność 15+ Podwójna warstwa pamięci podręcznej, pamięć podręczna podpowiedzi, pamięć podręczna odpowiedzi, utrzymywanie transmisji strumieniowej, wsadowe API
🌐 Ekosystem 10+ WebSocket API, ładowanie konfiguracji na gorąco, rozproszony magazyn konfiguracji, tryb komercyjny

🔜 Już wkrótce

  • 🔗 Integracja OpenCode — natywna obsługa dostawców dla IDE kodowania OpenCode AI
  • 🔗 Integracja z TRAE — Pełne wsparcie dla platformy rozwojowej TRAE AI
  • 📦 Batch API — Asynchroniczne przetwarzanie wsadowe dla żądań masowych
  • 🎯 Routing oparty na tagach — Kieruj żądania na podstawie niestandardowych tagów i metadanych
  • 💰 Strategia najniższych kosztów — Automatycznie wybierz najtańszego dostępnego dostawcę

📝 Pełna specyfikacja funkcji dostępna w link (217 szczegółowych specyfikacji)


📧 Wsparcie

💬 Dołącz do naszej społeczności! WhatsApp Group — Uzyskaj pomoc, dziel się wskazówkami i bądź na bieżąco.


👥 Współtwórcy

Contributors

Jak wnieść swój wkład

  1. Forkuj repozytorium
  2. Utwórz gałąź funkcji (git checkout -b feature/amazing-feature)
  3. Zatwierdź zmiany (git commit -m 'Add amazing feature')
  4. Wciśnij do oddziału (git push origin feature/amazing-feature)
  5. Otwórz żądanie ściągnięcia

Szczegółowe wytyczne można znaleźć w CONTRIBUTING.md.

Wydanie nowej wersji

# Create a release — npm publish happens automatically
gh release create v1.0.6 --title "v1.0.6" --generate-notes

📊 Historia gwiazd

Star History Chart

🙏 Podziękowania

Specjalne podziękowania dla 9router autorstwa decolua — oryginalnego projektu, który zainspirował ten widelec. OmniRoute opiera się na tym niesamowitym fundamencie dzięki dodatkowym funkcjom, wielomodalnym interfejsom API i pełnemu przepisaniu TypeScriptu.

Specjalne podziękowania dla CLIProxyAPI — oryginalnej implementacji Go, która zainspirowała ten port JavaScript.


📄 Licencja

Licencja MIT — szczegółowe informacje można znaleźć w LICENSE.


Zbudowany z ❤️ dla programistów, którzy kodują 24 godziny na dobę, 7 dni w tygodniu
omniroute.online