OmniRoute/README.hu.md

🚀 OmniRoute – Az ingyenes mesterséges intelligencia átjáró

Soha ne hagyd abba a kódolást. Intelligens útválasztás INGYENES és alacsony költségű mesterséges intelligencia modellekhez automatikus visszaállítással.

Az univerzális API-proxy – egy végpont, 36+ szolgáltató, nulla állásidő.

Csevegés befejezése • Beágyazások • Képgenerálás • Hang • Újrarangsorolás • 100% TypeScript

---

🤖 Ingyenes mesterséges intelligencia szolgáltató kedvenc kódoló ügynökei számára

Csatlakoztasson bármilyen mesterséges intelligencia-alapú IDE-t vagy CLI-eszközt az OmniRoute-on keresztül – ingyenes API-átjáró a korlátlan kódoláshoz.

OpenClaw ⭐ 205K	NanoBot ⭐ 20.9K	PicoClaw ⭐ 14.6K	ZeroClaw ⭐ 9.9K	IronClaw ⭐ 2.1K
OpenCode ⭐ 106K	Codex CLI ⭐ 60.8K	Claude Code ⭐ 67.3K	Gemini CLI ⭐ 94.7K	Kilo Code ⭐ 15.5K

_{📡 Minden ügyintéző a http://localhost:20128/v1 vagy http://cloud.omni_TOKEN_244__http://cloud.omniroute_EN_2NI4/v_1_TO_2.online-on keresztül csatlakozik konfiguráció, korlátlan modellek és kvóta}

---

🌐 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

---

🤔 Miért az OmniRoute?

Ne pazarolja a pénzt, és ne lépje túl a limiteket:

• Az előfizetési kvóta minden hónapban fel nem használt
• A sebességkorlátok megakadályozzák a közbenső kódolást
• Drága API-k (20-50 USD/hó szolgáltatónként)
• Manuális váltás a szolgáltatók között

Az OmniRoute ezt megoldja:

• ✅ Az előfizetések maximalizálása - Kövesse nyomon a kvótát, használjon fel minden bitet a visszaállítás előtt
• ✅ Automatikus tartalék - Előfizetés → API-kulcs → Olcsó → Ingyenes, nulla állásidő
• ✅ Több fiók - Kör-robin a fiókok között szolgáltatónként
• ✅ Univerzális - Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, bármilyen CLI eszközzel működik

---

🔄 Hogyan működik

┌─────────────┐
│  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 <think> 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

⚡ Gyors kezdés

1. Globális telepítés:

npm install -g omniroute
omniroute

🎉 Az irányítópult ekkor nyílik meg: http://localhost:20128

Parancs	Leírás
omniroute	Szerver indítása (alapértelmezett port 20128)
omniroute --port 3000	Egyéni port használata
omniroute --no-open	Ne nyissa meg automatikusan a böngészőt
omniroute --help	Segítség megjelenítése

2. Csatlakozzon egy INGYENES szolgáltatóhoz:

Irányítópult → Szolgáltatók → Csatlakozás Claude Code vagy Antigravity → OAuth bejelentkezés → Kész!

3. Használja a CLI eszközben:

Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
  Endpoint: http://localhost:20128/v1
  API Key: [copy from dashboard]
  Model: if/kimi-k2-thinking

Ennyi! Kezdje el a kódolást az INGYENES AI modellekkel.

Alternatív – forrásból fut:

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

---

🐳 Docker

Az OmniRoute nyilvános Docker-képként érhető el a Docker Hub webhelyen.

Gyors futás:

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

Környezetfájllal:

# 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

A Docker Compose használata:

# 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

Kép	Címke	Méret	Leírás
diegosouzapw/omniroute	latest	~250 MB	Legújabb stabil kiadás
diegosouzapw/omniroute	1.0.3	~250 MB	Jelenlegi verzió

---

---

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

---

💰 Árazás egy pillantásra

Tier	Szolgáltató	Költség	Kvóta visszaállítása	Legjobb a
💳 ELŐFIZETÉS	Claude Code (Pro)	20 USD/hó	5 óra + heti	Már előfizetett
	Codex (Plus/Pro)	20-200 USD/hó	5 óra + heti	OpenAI felhasználók
	Gemini CLI	INGYENES	180 000/hó + 1 000/nap	Mindenki!
	GitHub másodpilóta	10-19 USD/hó	Havi	GitHub felhasználók
🔑 API KULCS	NVIDIA NIM	INGYENES (1000 kredit)	Egyszeri	Ingyenes szintű tesztelés
	DeepSeek	Felhasználásonkénti fizetés	Nincs	Legjobb ár/minőség
	Groq	Ingyenes szint + fizetett	Ár korlátozott	Ultragyors következtetés
	xAI (Grok)	Felhasználásonkénti fizetés	Nincs	Grok modellek
	Mistral	Ingyenes szint + fizetett	Ár korlátozott	Európai AI
	OpenRouter	Felhasználásonkénti fizetés	Nincs	100+ modell
💰 OLCSÓ	GLM-4.7	0,6 USD/1M	Naponta 10:00	Költségvetési biztonsági mentés
	MiniMax M2.1	0,2 USD/1M	5 órás gurulás	Legolcsóbb lehetőség
	Kimi K2	9 USD/hó lakás	10 millió token/hó	Előrelátható költség
🆓 INGYENES	iFlow	$0	Korlátlan	8 modell ingyenes
	Qwen	$0	Korlátlan	3 modell ingyenes
	Kiro	$0	Korlátlan	Claude ingyen

💡 Pro tipp: Kezdje a Gemini CLI-vel (180 000 ingyenes/hónap) + iFlow (korlátlan ingyenes) kombináció = 0 USD költség!

---

💡 Főbb jellemzők

🧠 Core Routing & Intelligence

Funkció	Mit csinál
🎯 Intelligens 4-szintű tartalék	Automatikus útvonal: Előfizetés → API-kulcs → Olcsó → Ingyenes
📊 Valós idejű kvótakövetés	Élő tokenszám + visszaszámlálás visszaállítása szolgáltatónként
🔄 Formátum fordítás	OpenAI ↔ Claude ↔ Gemini ↔ Kurzor ↔ Kiro zökkenőmentes + válaszfertőtlenítés
👥 Többfiókos támogatás	Több fiók szolgáltatónként intelligens kiválasztással
🔄 Automatikus token frissítés	Az OAuth-tokenek automatikusan frissülnek
🎨 Egyéni kombók	6 stratégia: fill-first, round-robin, p2c, random, legkevésbé használt, költségoptimalizált
🧩 Egyedi modellek	Adjon hozzá bármilyen modellazonosítót bármely szolgáltatóhoz
🌐 Wildcard Router	provider/* minták továbbítása bármely szolgáltatóhoz dinamikusan
🧠 Átgondolt költségvetés	Átjárási, automatikus, egyéni és adaptív módok érvelési modellekhez
🔀 Model Aliases	Auto-forward deprecated model IDs to current replacements (built-in + custom)
⚡ Background Degradation	Auto-route background tasks (titles, summaries) to cheaper models
💬 Rendszer azonnali befecskendezés	Globális rendszerkérdés minden kérelemre érvényes
📄 Responses API	Teljes OpenAI Responses API (/v1/responses) támogatás a Codexhez

🎵 Multimodális API-k

Funkció	Mit csinál
🖼️ Képgenerálás	/v1/images/generations — 4 szolgáltató, 9+ modell
📐 Beágyazás	/v1/embeddings — 6 szolgáltató, 9+ modell
🎤 Audio átírás	/v1/audio/transcriptions — Suttogás-kompatibilis
🔊 Szövegfelolvasó	/v1/audio/speech — Hangszintézis több szolgáltatónál
🛡️ Moderálás	/v1/moderations — Tartalombiztonsági ellenőrzések
🔀 Átsorolás	/v1/rerank — A dokumentumok relevancia szerinti átsorolása

🛡️ Rugalmasság és biztonság

Funkció	Mit csinál
🔌 Megszakító	Automatikus megnyitás/bezárás szolgáltatónként konfigurálható küszöbértékekkel
🛡️ Menydörgésellenes csorda	Mutex + szemafor sebességkorlátozás API-kulcs-szolgáltatók számára
🧠 Szemantikus gyorsítótár	A kétszintű gyorsítótár (aláírás + szemantikai) csökkenti a költségeket és a késleltetést
⚡ Idempotencia kérése	5s dedup ablak ismétlődő kérésekhez
🔒 TLS ujjlenyomat-hamisítás	A TLS-alapú botészlelés megkerülése a wreq-js segítségével
🌐 IP-szűrés	Allowlist/blokkolista API hozzáférés-vezérléshez
📊 Szerkeszthető díjkorlátok	Konfigurálható fordulatszám, minimális rés és maximális egyidejű rendszerszinten
💾 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 kapuzás + szolgáltató blokkolása a /models végponthoz
🔒 Proxy láthatósága	Színkódolt jelvények: 🟢 globális, 🟡 szolgáltató, 🔵 kapcsolatonként IP kijelzővel
🌐 3-szintű proxykonfiguráció	Proxyk konfigurálása globális, szolgáltatónkénti vagy kapcsolatonkénti szinten

📊 Megfigyelhetőség és elemzés

Funkció	Mit csinál
📝 Naplózás kérése	Hibakeresési mód teljes kérés/válasz naplókkal
💾 SQLite proxynaplók	Az állandó proxynaplók túlélik a szerver újraindítását
📊 Analytics Dashboard	Újragrafikusok: statisztikai kártyák, modellhasználati táblázat, szolgáltatói táblázat
📈 Haladáskövetés	SSE előrehaladási események engedélyezése streaming
🧪 LLM értékelések	Aranykészlet tesztelése 4 meccsstratégiával
🔍 Telemetria kérése	p50/p95/p99 késleltetési összesítés + X-Request-Id nyomkövetés
📋 Logs Dashboard	Egységes 4 lapos oldal: Kérelemnaplók, Proxynaplók, Auditnaplók, Konzol
🖥️ Console Log Viewer	Valós idejű terminál stílusú megjelenítő szintszűrővel, kereséssel, automatikus görgetéssel
📑 Fájlalapú naplózás	A konzolelfogó az összes kimenetet JSON-naplófájlba rögzíti	forgatással
🏥 Egészségügyi irányítópult	A rendszer üzemideje, az áramkör megszakítói állapotai, a zárolások, a gyorsítótár statisztikái
💰 Költségkövetés	Költségvetés-kezelés + modellenkénti árképzés

☁️ Telepítés és szinkronizálás

Funkció	Mit csinál
💾 Cloud Sync	Szinkronizálja a konfigurációt az eszközök között a Cloudflare Workers	segítségével
🌐 Deploy Anywhere	Localhost, VPS, Docker, Cloudflare Workers
🔑 API-kulcskezelés	API-kulcsok generálása, forgatása és hatóköre szolgáltatónként
🧙 Bevezető varázsló	4 lépésben irányított beállítás első felhasználók számára
🔧 CLI Tools Dashboard	Egy kattintással konfigurálja a Claude, Codex, Cline, OpenClaw, Kilo, Antigravity
🔄 DB biztonsági mentések	Automatikus biztonsági mentés, visszaállítás, exportálás és importálás az összes beállításhoz
🌐 Nemzetközivé válás	Teljes i18n next-intl-vel – angol + portugál (Brazília) támogatás
🌍 Nyelvválasztó	Globe ikon a fejlécben a valós idejű nyelvváltáshoz (🇺🇸/🇧🇷)
📂 Egyéni adattár	DATA_DIR env var felülírja az alapértelmezett ~/.omniroute tárolási útvonalat

📖 Funkció részletei

🎯 Intelligens 4 szintes tartalék

Hozzon létre kombókat automatikus visszaállítással:

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

📊 Valós idejű kvótakövetés

• Token fogyasztás szolgáltatónként
• Visszaszámlálás visszaállítása (5 órás, napi, heti)
• Költségbecslés a fizetett szintekre
• Havi kiadási jelentések

🔄 Formátum fordítás

Zökkenőmentes fordítás a formátumok között:

• OpenAI ↔ Claude ↔ Gemini ↔ OpenAI válaszok
• A CLI eszköz OpenAI formátumot küld → OmniRoute lefordítja → szolgáltató natív formátumot kap
• Minden olyan eszközzel működik, amely támogatja az egyéni OpenAI végpontokat
• Válaszfertőtlenítés - Törli a nem szabványos mezőket a szigorú OpenAI SDK-kompatibilitás érdekében
• Szerepnormalizálás — developer → system nem OpenAI esetén; system → user GLM/ERNIE modellekhez
• Gondolkodó címke kivonatolás — <think> blokkok → reasoning_content gondolkodó modellekhez
• Strukturált kimenet — json_schema → Gemini's responseMimeType/responseSchema

👥 Többfiókos támogatás

• Több fiók hozzáadása szolgáltatónként
• Automatikus körbefutó vagy prioritás alapú útvonalválasztás
• Visszatérés a következő fiókhoz, ha valamelyik eléri a kvótát

🔄 Token automatikus frissítése

• Az OAuth-tokenek a lejárat előtt automatikusan frissülnek
• Nincs szükség manuális újrahitelesítésre
• Zökkenőmentes tapasztalat az összes szolgáltatónál

🎨 Egyéni kombók

• Korlátlan számú modellkombináció létrehozása
• 6 stratégia: töltsd ki először, körbefutó, kettős választási lehetőség, véletlenszerű, legkevésbé használt, költségoptimalizált
• Oszd meg a kombinációkat az eszközök között a Cloud Sync segítségével

🏥 Egészségügyi irányítópult

• Rendszerállapot (üzemidő, verzió, memóriahasználat)
• A megszakítók állapotai szolgáltatónként (zárt/nyitott/félig nyitva)
• Díjkorlát állapot és aktív zárolások
• Az aláírás gyorsítótár statisztikái
• Késési telemetria (p50/p95/p99) + gyorsítótár
• Állítsa vissza az egészségi állapotot egyetlen kattintással

🔧 Fordítói Játszótér

Az OmniRoute egy erőteljes beépített fordítói játszóteret tartalmaz 4 móddal az API-fordítások hibakereséséhez, teszteléséhez és figyeléséhez:

mód	Leírás
💻 Játszótér	Közvetlen formátumfordítás – illessze be az API kérés törzsét, és azonnal megtudhatja, hogyan fordítja le az OmniRoute azt a szolgáltatói formátumok között (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Példa sablonokat és formátum automatikus felismerést tartalmaz.
💬 Chat Tester	Küldjön valódi csevegési kérelmeket az OmniRoute-on keresztül, és tekintse meg a teljes körutazást: a bemenetet, a lefordított kérést, a szolgáltatói választ és a visszafordított választ. Felbecsülhetetlen a kombinált útválasztás érvényesítéséhez.
🧪 Tesztpad	Kötegelt tesztelési mód — határozzon meg több tesztesetet különböző bemenetekkel és várható kimenetekkel, futtassa le egyszerre, és hasonlítsa össze a szolgáltatók és modellek eredményeit.
📱 Élő monitor	Valós idejű kérések figyelése – figyelje a bejövő kéréseket, ahogy azok az OmniRoute-on keresztül áramlanak, nézze meg a formátumfordításokat élőben, és azonnal azonosítsa a problémákat.

Hozzáférés: Irányítópult → Fordító (oldalsáv)

💾 Cloud Sync

• Szinkronizálja a szolgáltatókat, kombinációkat és beállításokat az eszközök között
• Automatikus háttérszinkronizálás
• Biztonságos titkosított tárhely

---

🎯 Használati esetek

1. eset: "Claude Pro előfizetésem van"

Probléma: A kvóta lejár, kihasználatlanul, sebességkorlátozások erős kódolás közben

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

2. eset: "Nulla költséget akarok"

Probléma: Nem engedheti meg magának az előfizetést, megbízható mesterséges intelligencia kódolásra van szüksége

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

3. eset: "24 órás kódolásra van szükségem, megszakítás nélkül"

Probléma: Határidők, nem engedheti meg magának az állásidőt

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

4. eset: "INGYENES AI-t akarok az OpenClawban"

Probléma: AI-asszisztens szükséges az üzenetküldő alkalmazásokhoz, teljesen ingyenes

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

---

📖 Beállítási útmutató

💳 Előfizetési szolgáltatók

Claude Code (Pro/Max)

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

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

Profi tipp: Használja az Opust összetett feladatokhoz, a Sonnet pedig a sebességhez. Az OmniRoute nyomkövetési kvóta modellenként!

OpenAI Codex (Plus/Pro)

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

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

Gemini CLI (INGYENES 180 000/hó!)

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

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

Legjobb érték: Hatalmas ingyenes szint! Használja ezt a fizetett szintek előtt.

GitHub másodpilóta

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

🔑 API kulcs szolgáltatók

NVIDIA NIM (INGYENES 1000 kredit!)

1. Regisztráljon: build.nvidia.com
2. Ingyenes API-kulcs beszerzése (1000 következtetési kredit)
3. Irányítópult → Szolgáltató hozzáadása → NVIDIA NIM:
   • API-kulcs: nvapi-your-key

Modellek: nvidia/llama-3.3-70b-instruct, nvidia/mistral-7b-instruct és több mint 50

Profi tipp: OpenAI-kompatibilis API – zökkenőmentesen működik az OmniRoute formátumfordításával!

DeepSeek

1. Regisztráljon: platform.deepseek.com
2. Szerezze be az API-kulcsot
3. Irányítópult → Szolgáltató hozzáadása → DeepSeek

Modellek: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (ingyenes szint elérhető!)

1. Regisztráljon: console.groq.com
2. API-kulcs beszerzése (ingyenes szint tartalmazza)
3. Irányítópult → Szolgáltató hozzáadása → Groq

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

Profi tipp: Ultragyors következtetés – a legjobb valós idejű kódoláshoz!

OpenRouter (100+ modell)

1. Regisztráljon: openrouter.ai
2. Szerezze be az API-kulcsot
3. Irányítópult → Szolgáltató hozzáadása → OpenRouter

Modellek: Hozzáférés több mint 100 modellhez az összes főbb szolgáltatótól egyetlen API-kulccsal.

💰 Olcsó szolgáltatók (tartalék)

GLM-4.7 (napi visszaállítás, 0,6 USD/1 millió)

1. Regisztráljon: Zhipu AI
2. Szerezze be az API-kulcsot a Coding Plan-ból
3. Irányítópult → API-kulcs hozzáadása:
   • Szolgáltató: glm
   • API-kulcs: your-key

Használd: glm/glm-4.7

Profi tipp: A kódolási terv 3-szoros kvótát kínál 1/7 költséggel! Visszaállítás naponta 10:00.

MiniMax M2.1 (5 óra visszaállítás, 0,20 USD/1 millió)

1. Regisztráljon: MiniMax
2. Szerezze be az API-kulcsot
3. Irányítópult → API-kulcs hozzáadása

Használd: minimax/MiniMax-M2.1

Profi tipp: A legolcsóbb lehetőség hosszú kontextushoz (1 millió token)!

Kimi K2 (9 USD/hó lakás)

1. Feliratkozás: Moonshot AI
2. Szerezze be az API-kulcsot
3. Irányítópult → API-kulcs hozzáadása

Használat: kimi/kimi-latest

Profi tipp: Fix 9 USD/hó 10 millió token esetén = 0,90 USD/1 millió tényleges költség!

🆓 INGYENES szolgáltatók (vészhelyzeti biztonsági mentés)

iFlow (8 INGYENES modell)

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 INGYENES modell)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

Kiro (Claude INGYENES)

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

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

🎨 Kombók létrehozása

1. példa: Előfizetés maximalizálása → Olcsó biztonsági mentés

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

2. példa: Csak ingyenes (nulla költség)

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-integráció

Kurzor IDE

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

Claude Code

Használja az irányítópult CLI Tools oldalát az egykattintásos konfiguráláshoz, vagy szerkessze manuálisan a ~/.claude/settings.json fájlt.

Codex CLI

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

codex "your prompt"

OpenClaw

1. lehetőség – Irányítópult (ajánlott):

Dashboard → CLI Tools → OpenClaw → Select Model → Apply

2. lehetőség – Kézi: Szerkesztés ~/.openclaw/openclaw.json:

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

Megjegyzés: Az OpenClaw csak a helyi OmniRoute-tal működik. Használja az 127.0.0.1 localhost helyett az IPv6-feloldási problémák elkerülése érdekében.

Cline / Folytatás / RooCode

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

---

🧪 Értékelések (Evals)

Az OmniRoute egy beépített értékelési keretrendszert tartalmaz az LLM-válasz minőségének tesztelésére egy aranykészlettel összehasonlítva. Az irányítópult Analytics → Evals menüpontjában érheti el.

Beépített arany készlet

Az előre feltöltött "OmniRoute Golden Set" 10 tesztesetet tartalmaz, amelyek lefedik:

• Üdvözlet, matematika, földrajz, kódgenerálás
• JSON formátum megfelelés, fordítás, leértékelés
• Biztonsági elutasítás (káros tartalom), számlálás, logikai logika

Értékelési stratégiák

Stratégia	Leírás	Példa
exact	A kimenetnek pontosan meg kell egyeznie	"4"
contains	A kimenetnek tartalmaznia kell részkarakterláncot (a kis- és nagybetűk nem különböznek egymástól)	"Paris"
regex	A kimenetnek meg kell egyeznie a regex mintával	"1.*2.*3"
custom	Az egyéni JS függvény igaz/hamis	(output) => output.length > 10

---

🐛 Hibaelhárítás

Kattintson a hibaelhárítási útmutató kibontásához

"A nyelvi modell nem adott üzenetet"

• A szolgáltatói kvóta kimerült → Ellenőrizze az irányítópult kvótakövetőjét
• Megoldás: Használjon kombinált tartalékot, vagy váltson olcsóbb szintre

Drátakorlát

• Előfizetési kvóta lejárt → Tartalék a GLM/MiniMax-hoz
• Kombinó hozzáadása: cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking

OAuth token lejárt

• Az OmniRoute automatikusan frissíti
• Ha a problémák továbbra is fennállnak: Irányítópult → Szolgáltató → Újracsatlakozás

Magas költségek

• Ellenőrizze a használati statisztikákat az Irányítópult → Költségek menüpontban
• Állítsa át az elsődleges modellt GLM/MiniMax-ra
• Használjon ingyenes réteget (Gemini CLI, iFlow) a nem kritikus feladatokhoz

A műszerfal rossz porton nyílik meg

• PORT=20128 és NEXT_PUBLIC_BASE_URL=http://localhost:20128 beállítása

Felhő szinkronizálási hibák

• Ellenőrizze, hogy BASE_URL mutat a futó példányra
• Ellenőrizzen CLOUD_URL pontot a várható felhő-végponthoz
• Tartsa az NEXT_PUBLIC_* értékeket a szerveroldali értékekkel összhangban

Az első bejelentkezés nem működik

• Ellenőrizze a INITIAL_PASSWORD-t itt: .env
• Ha nincs beállítva, a tartalék jelszó: 123456

Nincs kérésnapló

• Állítsa be ENABLE_REQUEST_LOGS=true a .env-ban

A csatlakozási teszt „Érvénytelen” üzenetet mutat az OpenAI-kompatibilis szolgáltatók esetében

• Sok szolgáltató nem tesz közzé /models végpontot
• Az OmniRoute v1.0.6+ tartalmazza a tartalék érvényesítést a csevegés befejezésén keresztül
• Győződjön meg arról, hogy az alap URL tartalmazza a /v1 utótagot

🔐 OAuth em Servidor Remoto (távoli OAuth beállítás)

⚠️ FONTOS az OmniRoute em VPS/Docker/servidor Remoto használatához

Az OAuth do Antigravity / Gemini CLI falha em servidores remotos?

Az Antigravitáció és a Gemini CLI usam Google OAuth 2.0 hitelesítése. A Google exige que a redirect_uri nincs fluxo OAuth seja exatamente uma das URI-k pre-cadastradas no Google Cloud Console do aplicativo.

As credenciais OAuth embutidas no OmniRoute estão cadastradas apenas para localhost. Quando você acessa o OmniRoute em um servidor Remoto (pl.: https://omniroute.meuservidor.com), o Google rejeita a autenticação com:

Error 400: redirect_uri_mismatch

Megoldás: A suas próprias credenciais OAuth konfigurálása

Você precisa criar um OAuth 2.0 ügyfél-azonosító nincs Google Cloud Console com egy URI do seu servidor.

Passo a passo

1. Acesse o Google Cloud Console

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

2. Crie um novo OAuth 2.0 ügyfél-azonosító

• Kattintson a gombra "+ Hitelesítési adatok létrehozása" → "OAuth-kliens-azonosító"
• Tipo de Aplicativo: "Web alkalmazás"
• Név: escolha qualquer nome (pl.: OmniRoute Remote)

3. Adicione mint engedélyezett átirányítási URI

No campo "Engedélyezett átirányítási URI-k", kiegészítés:

https://seu-servidor.com/callback

Helyettesítő seu-servidor.com pelo domínio vagy IP do seu servidor (beleértve a porta se necessário-t is, pl.: http://45.33.32.156:20128/callback).

4. Másolat mentése hitelesítésként

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

5. Konfigurálás variáveis de ambienteként

No seu .env (ou 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 o OmniRoute

# Se usando npm:
npm run dev

# Se usando Docker:
docker restart omniroute

7. Tente conectar novamente

Irányítópult → Szolgáltatók → Antigravity (vagy Gemini CLI) → OAuth

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

---

Kerülő megoldás temporário (sem configurar credenciais próprias)

Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo manual de URL:

1. OmniRoute abrirá a Google autorização URL-jét
2. Após você autorizar, o Google tentará redirecionar para localhost (que falha no servidor remoto)
3. ** Teljes URL másolása** da barra de endereço do seu browser (mesmo que a página não carregue)
4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
5. Kattintson a "Connect" gombra

Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.

---

🛠️ Tech Stack

• Futtatási idejű: Node.js 18–22 LTS (⚠️ A Node.js 24+ nem támogatott - A better-sqlite3 natív binárisok nem kompatibilisek)
• Nyelv: TypeScript 5.9 – 100% TypeScript src/ és open-sse/ (v1.0.6) között
• Keretrendszer: Next.js 16 + React 19 + Tailwind CSS 4
• Adatbázis: LowDB (JSON) + SQLite (tartomány állapota + proxynaplók)
• Streaming: Szerver által küldött események (SSE)
• Auth: OAuth 2.0 (PKCE) + JWT + API kulcsok
• Tesztelés: Node.js tesztfutó (368+ egységteszt)
• CI/CD: GitHub Actions (automatikus npm közzététel + Docker Hub kiadáskor)
• Webhely: omniroute.online
• Csomag: npmjs.com/package/omniroute
• Dokker: hub.docker.com/r/diegosouzapw/omniroute
• Rugalmasság: megszakító, exponenciális visszakapcsolás, mennydörgés elleni csorda, TLS-hamisítás

---

📖 Dokumentáció

dokumentum	Leírás
User Guide	Szolgáltatók, kombók, CLI-integráció, telepítés
API Reference	Minden végpont példákkal
Troubleshooting	Gyakori problémák és megoldások
Architecture	Rendszerarchitektúra és belső elemek
Contributing	Fejlesztési beállítások és irányelvek
OpenAPI Spec	OpenAPI 3.0 specifikáció
Security Policy	Sebezhetőségi jelentések és biztonsági gyakorlatok
VM Deployment	Teljes útmutató: VM + nginx + Cloudflare beállítás
Features Gallery	Vizuális irányítópult bemutató képernyőképekkel

📸 Irányítópult előnézete

Kattintson az irányítópult képernyőképeinek megtekintéséhez

Oldal	Képernyőkép
Szolgáltatók
Combos
Analytics
Egészség
Fordító
Beállítások
CLI eszközök
Használati naplók
Végpont

---

🗺️ Útiterv

Az OmniRoute 210+ funkciót tervez több fejlesztési fázisban. Íme a legfontosabb területek:

Kategória	Tervezett funkciók	Kiemelések
🧠 Útválasztás és intelligencia	25+	Legkisebb késleltetésű útválasztás, címke alapú útválasztás, kvóta elővizsgálat, P2C-fiók kiválasztása
🔒 Biztonság és megfelelőség	20+	SSRF keményítés, hitelesítő adatok álcázása, végpontonkénti sebességkorlát, felügyeleti kulcs hatóköre
📊 Megfigyelhetőség	15+	OpenTelemetry integráció, valós idejű kvótafigyelés, modellenkénti költségkövetés
🔄 ** Szolgáltatói integrációk**	20+	Dinamikus modellnyilvántartás, szolgáltatói leállások, többfiókos Codex, másodpilóta kvótaelemzés
⚡ Teljesítmény	15+	Kettős gyorsítótárréteg, gyorsítótár, válaszgyorsítótár, folyamatos adatfolyam, kötegelt API
🌐 Ökoszisztéma	10+	WebSocket API, config hot-reload, elosztott konfigurációs tároló, kereskedelmi mód

🔜 Hamarosan

• 🔗 OpenCode integráció - Natív szolgáltatói támogatás az OpenCode AI kódoló IDE-hez
• 🔗 TRAE integráció — A TRAE AI fejlesztési keret teljes támogatása
• 📦 Batch API - Aszinkron kötegelt feldolgozás tömeges kérésekhez
• 🎯 Címke alapú útválasztás - Egyéni címkéken és metaadatokon alapuló útvonalkérések
• 💰 Legalacsonyabb költségű stratégia - Automatikusan válassza ki a legolcsóbb elérhető szolgáltatót

📝 A teljes funkció specifikációi a link címen érhetők el (217 részletes specifikáció)

---

📧 Támogatás

💬 Csatlakozzon közösségünkhöz! WhatsApp Group — Kérjen segítséget, ossza meg tippjeit, és naprakész legyen.

• Webhely: omniroute.online
• GitHub: github.com/diegosouzapw/OmniRoute
• Problémák: github.com/diegosouzapw/OmniRoute/issues
• WhatsApp: Community Group
• Eredeti projekt: 9router by decolua

---

👥 Közreműködők

Hogyan járuljunk hozzá

1. Fork a tároló
2. Hozza létre saját jellemző ágát (git checkout -b feature/amazing-feature)
3. Végezze el módosításait (git commit -m 'Add amazing feature')
4. Nyomja az ágra (git push origin feature/amazing-feature)
5. Nyisson meg egy lehívási kérelmet

A részletes útmutatásért lásd: CONTRIBUTING.md.

Új verzió kiadása

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

---

📊 Csillagtörténet

---

🙏 Köszönetnyilvánítás

Külön köszönet 9router, decolua – az eredeti projekt, amely ezt a villát inspirálta. Az OmniRoute erre a hihetetlen alapra épít további funkciókkal, multimodális API-kkal és teljes TypeScript-újraírással.

Külön köszönet CLIProxyAPI – az eredeti Go implementációnak, amely ihlette ezt a JavaScript-portot.

---

📄 Licenc

MIT-licenc – a részletekért lásd: LICENSE.

---

_{A ❤️ segítségével készült a 24/7 kódoló fejlesztőknek
omniroute.online}