OmniRoute/docs/i18n/hu

🚀 OmniRoute — The Free AI Gateway (Magyar)

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

---

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

Az univerzális API-proxy – egy végpont, több mint 60 szolgáltató, nulla állásidő. MostMCP-kiszolgálóval (25 eszköz),A2A protokollal,memória-/készségrendszerekkelésElectron Desktop alkalmazással.

Csevegés befejezése • Beágyazások • Képgenerálás • Videó • Zene • Hang • Újrarangsorolás •Webes keresés• MCP-szerver • A2A protokoll • 100% TypeScript---

🌐 Webhely • 🚀 Quick Start • 💡 Funkciók • 📖 Dokumentumok • 💰 Árak • 💬 WhatsApp

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

🖼️ Main Dashboard

---

📸 Dashboard Preview

<részletek>

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

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

---

🤖 Free AI Provider for your favorite coding agents

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.

<tábla>

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

_{📡 Minden ügynök a http://localhost:20128/v1 vagy a http://cloud.omniroute.online/v1 segítségével csatlakozik – egy konfiguráció, korlátlan modellek és kvóta}---

🤔 Why 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 díjkorlátok megakadályozzák a középső 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---

📧 Support

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

-Webhely: omniroute.online -GitHub: github.com/diegosouzapw/OmniRoute -Problémák: github.com/diegosouzapw/OmniRoute/issues -WhatsApp: Közösségi csoport -Hozzájárulás: Tekintse meg a CONTRIBUTING.md oldalt, nyisson PR-t, vagy válasszon egy "jó első számot". -Original Project: 9router by decolua### 🐛 Reporting a Bug?

Egy probléma megnyitásakor futtassa a system-info parancsot, és csatolja a generált fájlt:```bash npm run system-info

Ez létrehoz egy "system-info.txt" fájlt a Node.js verziójával, az OmniRoute verziójával, az operációs rendszer részleteivel, a telepített CLI-eszközökkel (qoder, gemini, claude, codex, antigravitáció, droid stb.), Docker/PM2 állapottal és rendszercsomagokkal – mindennel, amire szükségünk van a probléma gyors reprodukálásához. Csatolja a fájlt közvetlenül a GitHub-problémához.---

## 🔄 How It Works

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

Result: Never stop coding, minimal cost

---

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

>**Minden mesterséges intelligencia-eszközöket használó fejlesztő naponta szembesül ezekkel a problémákkal.**Az OmniRoute úgy készült, hogy ezeket mind megoldja – a költségtúllépésektől a regionális blokkokig, a megszakadt OAuth-folyamatoktól a protokollműveletekig és a vállalati megfigyelhetőségig.

<részletek>
<summary><b>💸 1. "Drága előfizetésért fizetek, de még mindig megzavarnak a korlátok"</b></summary>

A fejlesztők havi 20–200 dollárt fizetnek a Claude Pro, Codex Pro vagy GitHub Copilotért. A kvótának még fizetés esetén is van felső határa – 5 óra használat, heti limitek vagy percdíjkorlátok. Mid-coding session, the provider stops responding and the developer loses flow and productivity.

**Hogyan oldja meg az OmniRoute:**

-**Smart 4-Tier Fallback**– Ha az előfizetési kvóta kimerül, automatikusan átirányítja az API-kulcs → Olcsó → Ingyenes, manuális beavatkozás nélkül
-**Szolgáltatói korlátozások követése**– A gyorsítótárazott kvóta pillanatképei szerveroldali ütemezés szerint frissülnek (alapértelmezett `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70`), a felhasználói felületen elérhető kézi frissítéssel
-**Több fiók támogatása**- Több fiók szolgáltatónként automatikus körváltással - ha az egyik elfogy, átvált a következőre
-**Egyéni kombinációk**— Testreszabható tartalék láncok 9 kiegyensúlyozási stratégiával (prioritásos, súlyozott, kitöltési sorrendben, körbefutó, P2C, véletlenszerű, legkevésbé használt, költségoptimalizált, szigorúan véletlenszerű)
-**Codex üzleti kvóták**— Üzleti/csapat munkaterület-kvóta figyelése közvetlenül az irányítópulton</details>

<részletek>
<summary><b>🔌 2. "Több szolgáltatót kell használnom, de mindegyik más API-val rendelkezik"</b></summary>

Az OpenAI egy formátumot használ, a Claude (Anthropic) egy másikat, a Gemini pedig egy másikat. Ha egy fejlesztő különböző szolgáltatók modelljeit szeretné tesztelni, vagy tartalékot szeretne közöttük, akkor újra kell konfigurálnia az SDK-kat, módosítania kell a végpontokat, és kezelnie kell az inkompatibilis formátumokat. Az egyéni szolgáltatók (FriendLI, NIM) nem szabványos modellvégpontokkal rendelkeznek.

**Hogyan oldja meg az OmniRoute:**

-**Egységes végpont**- Egyetlen "http://localhost:20128/v1" proxyként szolgál mind a 60+ szolgáltató számára
-**Formátumfordítás**- Automatikus és átlátható: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
-**Response Sanitization**— Strips non-standard fields (`x_groq`, `usage_breakdown`, `service_tier`) that break OpenAI SDK v1.83+
-**Szerepek normalizálása**— Átalakítja a "fejlesztő" → "rendszert" a nem OpenAI szolgáltatók számára; `rendszer` → `felhasználó` a GLM/ERNIE-hez
-**Think Tag Extraction**– Kivonja a „<think>” blokkokat olyan modellekből, mint a DeepSeek R1 szabványos „reasoning_content” tartalommá
-**Strukturált kimenet a Gemini számára**— `json_schema` → `responseMimeType`/`responseSchema` automatikus átalakítás
- A**„stream” alapértelmezése „false”**– Az OpenAI specifikációhoz igazodik, elkerülve a váratlan SSE-t a Python/Rust/Go SDK-kban</details>

<részletek>
<summary><b>🌐 3. „Az AI-szolgáltatóm blokkolja a régiómat/országomat”</b></summary>

Az olyan szolgáltatók, mint az OpenAI/Codex, blokkolják a hozzáférést bizonyos földrajzi régiókból. A felhasználók OAuth- és API-kapcsolatok során olyan hibákat kapnak, mint a „nem támogatott_ország_régió_területe”. Ez különösen frusztráló a fejlődő országok fejlesztői számára.

**Hogyan oldja meg az OmniRoute:**

-**3-szintű proxykonfiguráció**– 3 szinten konfigurálható proxy: globális (teljes forgalom), szolgáltatónként (csak egy szolgáltató) és kapcsolatonként/kulcsonként
-**Színes proxy jelvények**- Vizuális jelzők: 🟢 globális proxy, 🟡 szolgáltató proxy, 🔵 kapcsolat proxy, mindig az IP-t mutatja
-**OAuth-tokencsere proxyn keresztül**– Az OAuth-folyamat a proxyn is keresztülmegy, megoldva a `nem támogatott_ország_régió_területét'
-**Kapcsolódási tesztek proxyn keresztül**- A csatlakozási tesztek a konfigurált proxyt használják (nincs többé közvetlen kiiktatás)
-**SOCKS5 támogatás**— Teljes SOCKS5 proxy támogatás a kimenő útválasztáshoz
-**TLS-ujjlenyomat-hamisítás**– Böngészőszerű TLS-ujjlenyomat a "wreq-js"-n keresztül a botészlelés megkerüléséhez
-**🔏 CLI Ujjlenyomat Matching**– A fejlécek és törzsmezők átrendezése, hogy megfeleljenek a natív CLI bináris aláírásoknak, drasztikusan csökkentve a fiók megjelölésének kockázatát. A proxy IP-címe megmarad – egyszerre kapja meg a lopakodó**és**IP-maszkolást</details>

<részletek>
<summary><b>🆓 4. "MI-t akarok használni kódoláshoz, de nincs pénzem"</b></summary>

Nem mindenki fizethet havi 20–200 dollárt az AI-előfizetésekért. A feltörekvő országok diákjainak, fejlesztőinek, amatőröknek és szabadúszóknak nulla költséggel kell hozzáférniük a minőségi modellekhez.

**Hogyan oldja meg az OmniRoute:**

-**Beépített ingyenes szolgáltatók**- Natív támogatás 100%-ban ingyenes szolgáltatókhoz: Qoder (5 korlátlan modell OAuth-on keresztül: kimi-k2-thinking, qwen3-coder-plus, deepseek-r1, minimax-m2, kimi-k2), Qwen (4 unlim-limitus3 modell) qwen3-coder-flash, qwen3-coder-next, vision-model), Kiro (Claude + AWS Builder ID ingyen), Gemini CLI (180 000 token/hónap ingyenes)
-**Ollama Cloud**– Felhőben tárolt Ollama-modellek az `api.ollama.com-on, ingyenes "Light usage" szinttel; használja az `ollamacloud/<modell>` előtagot
-**Csak ingyenes kombók**— Lánc `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = 0 USD/hó nulla állásidővel
-**NVIDIA NIM ingyenes hozzáférés**– ~40 RPM fejlesztői örökké ingyenes hozzáférés több mint 70 modellhez a build.nvidia.com oldalon (áttérés a kreditekről a tiszta sebességkorlátokra)
-**Költségoptimalizált stratégia**— Útválasztási stratégia, amely automatikusan a legolcsóbb elérhető szolgáltatót választja</details>

<részletek>
<summary><b>🔒 5. "Meg kell védenem a mesterséges intelligencia átjárómat a jogosulatlan hozzáféréstől"</b></summary>

Ha AI átjárót teszünk ki a hálózatnak (LAN, VPS, Docker), a cím birtokában bárki felhasználhatja a fejlesztő tokenjeit/kvótáját. Védelem nélkül az API-k sebezhetőek a visszaélésekkel, azonnali befecskendezéssel és visszaélésekkel szemben.

**Hogyan oldja meg az OmniRoute:**

-**API-kulcskezelés**– Generálás, rotáció és hatókör szolgáltatónként egy dedikált "/dashboard/api-manager" oldallal
-**Modellszintű engedélyek**– Az API-kulcsok korlátozása adott modellekre ("openai/*", helyettesítő karakteres minták), az Összes engedélyezése/Korlátozása kapcsolóval
-**API Endpoint Protection**– Kulcs szükséges a `/v1/models' számára, és bizonyos szolgáltatók letiltása a listából
-**Auth Guard + CSRF védelem**- Minden műszerfali útvonal "withAuth" köztes szoftverrel + CSRF tokenekkel védett
-**Rate Limiter**— IP-nkénti sebességkorlátozás konfigurálható ablakokkal
-**IP-szűrés**— Engedélyezési lista/blokkolólista a hozzáférés-vezérléshez
-**Prompt Injection Guard**– fertőtlenítés a rosszindulatú felszólítási minták ellen
-**AES-256-GCM titkosítás**- A hitelesítő adatok nyugalmi állapotban titkosítva</details>

<részletek>
<summary><b>🛑 6. "A szolgáltatóm leállt, és elvesztettem a kódolási folyamatomat"</b></summary>

Az AI-szolgáltatók instabillá válhatnak, 5xx-es hibákat adnak vissza, vagy elérhetik az ideiglenes sebességkorlátokat. Ha egy fejlesztő egyetlen szolgáltatótól függ, akkor megszakad. Megszakítók nélkül az ismételt újrapróbálkozások összeomolhatják az alkalmazást.

**Hogyan oldja meg az OmniRoute:**

-**Megszakító típusonként**- Automatikus nyitás/zárás konfigurálható küszöbértékekkel és lehűtéssel (zárt/nyitott/félig nyitott), modellenkénti hatókör a lépcsőzetes blokkok elkerülése érdekében
-**Exponenciális visszalépés**— Progresszív újrapróbálkozási késések
-**Mennydörgés elleni csorda**- Mutex + szemafor védelem az egyidejű újrapróbálkozási viharok ellen
-**Kombinált tartalék láncok**– Ha az elsődleges szolgáltató meghibásodik, automatikusan, beavatkozás nélkül átesik a láncon
-**Combo Circuit Breaker**– Automatikusan letiltja a hibás szolgáltatókat a kombinált láncon belül
-**Egészségügyi irányítópult**— Üzemidő-figyelés, áramkör-megszakító állapotok, zárolások, gyorsítótár-statisztika, p50/p95/p99 késleltetés</details>

<részletek>
<summary><b>🔧 7. "Az egyes AI-eszközök konfigurálása fárasztó és ismétlődő."</b></summary>

A fejlesztők Cursort, Claude Code-ot, Codex CLI-t, OpenClaw-ot, Gemini CLI-t, Kilo Code-ot használnak... Minden eszköznek más konfigurációra van szüksége (API végpont, kulcs, modell). Az újrakonfigurálás szolgáltató- vagy modellváltáskor időpocsékolás.

**Hogyan oldja meg az OmniRoute:**

-**CLI Tools Dashboard**- Dedikált oldal egykattintásos beállítással a Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline számára
-**GitHub Copilot Config Generator**– A "chatLanguageModels.json" fájlt generálja a VS-kódhoz tömeges modellválasztással
-**Bevezető varázsló**– Irányított 4 lépéses beállítás első felhasználók számára
-**Egy végpont, minden modell**- Konfigurálja egyszer a `http://localhost:20128/v1' címet, elérje a 60+ szolgáltatót</details>

<részletek>
<summary><b>🔑 8. „A több szolgáltatótól származó OAuth-tokenek kezelése pokol”</b></summary>

Claude Code, Codex, Gemini CLI, Copilot – mindegyik az OAuth 2.0-t használja lejáró tokenekkel. A fejlesztőknek folyamatosan újra kell hitelesíteniük, kezelniük kell a „kliens_titka hiányzik”, az „átirányítási_uri_mismatch” és a távoli szerverek hibáival. Az OAuth a LAN/VPS-en különösen problémás.

**Hogyan oldja meg az OmniRoute:**

-**Automatikus tokenfrissítés**- Az OAuth-tokenek a háttérben frissülnek a lejárat előtt
-**OAuth 2.0 (PKCE) beépített**- Automatikus áramlás Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, Qoder számára
-**Multi-Account OAuth**- Több fiók szolgáltatónként a JWT/ID token kivonattal
-**OAuth LAN/Távoli javítás**– Privát IP-észlelés az „átirányítási_uri”-hoz + kézi URL mód távoli szerverekhez
-**OAuth Nginx mögött**– A "window.location.origin" fájlt használja a fordított proxy kompatibilitás érdekében
-**Távoli OAuth útmutató**– Lépésről lépésre útmutató a Google Cloud hitelesítő adataihoz VPS/Docker rendszeren</details>

<részletek>
<summary><b>📊 9. "Nem tudom, mennyit költök és hova"</b></summary>

A fejlesztők több fizetős szolgáltatót használnak, de nincs egységes nézetük a kiadásokról. Minden szolgáltató saját számlázási irányítópulttal rendelkezik, de nincs összevont nézet. A váratlan költségek felhalmozódhatnak.

**Hogyan oldja meg az OmniRoute:**

-**Költségelemzési irányítópult**– Tokenenkénti költségkövetés és költségkeret-kezelés szolgáltatónként
-**Költségkeret-korlátok rétegenként**- Költési felső határ szintenként, amely automatikus visszalépést vált ki
-**Modellenkénti árképzés**- Konfigurálható árak modellenként
-**Használati statisztika API-kulcsonként**— A kérések száma és az utoljára használt időbélyeg kulcsonként
-**Analytics Dashboard**— Statisztikai kártyák, modellhasználati diagram, szolgáltatói táblázat sikerarányokkal és késleltetéssel</details>

<részletek>
<summary><b>🐛 10. "Nem tudom diagnosztizálni a hibákat és problémákat az AI-hívásoknál"</b></summary>

Ha egy hívás meghiúsul, a fejlesztő nem tudja, hogy sebességkorlátozás, lejárt token, rossz formátum vagy szolgáltatói hiba volt-e. Töredezett naplók a különböző terminálokon. Megfigyelhetőség nélkül a hibakeresés próba és hiba.

**Hogyan oldja meg az OmniRoute:**

-**Egységes naplók irányítópultja**- 4 lap: Kérelemnaplók, Proxynaplók, Auditnaplók, Konzol
-**Konzolnapló-nézegető**— Valós idejű terminál stílusú megjelenítő színkódolt szintekkel, automatikus görgetés, keresés, szűrés
-**SQLite proxynaplók**– Állandó naplók, amelyek túlélik a szerver újraindítását
-**Translator Playground**– 4 hibakeresési mód: Playground (formátum fordítás), Chat Tester (oda-vissza út), Tesztpad (kötegelt), Élő monitor (valós idejű)
-**Request Telemetria**– p50/p95/p99 késleltetés + X-Request-Id nyomkövetés
-**File-Based Logging with Rotation**— App logs rotate by size, retention days, and archive count; a hívásnapló műtermékei a megőrzési napok és a fájlok száma szerint váltakoznak
-**Rendszerinformációs jelentés**— Az `npm run system-info` létrehozza a `system-info.txt' fájlt a teljes környezettel (Node verzió, OmniRoute verzió, OS, CLI eszközök, Docker/PM2 állapot). Csatolja, amikor az azonnali osztályozással kapcsolatos problémákat jelent be.</details>

<részletek>
<summary><b>🏗️ 11. „Az átjáró telepítése és karbantartása bonyolult”</b></summary>

Az AI-proxy telepítése, konfigurálása és karbantartása különböző környezetekben (helyi, VPS, Docker, felhő) munkaigényes. Az olyan problémák, mint a keménykódolt elérési utak, az „EACCES” a könyvtárakon, a portkonfliktusok és a többplatformos buildek súrlódást okoznak.

**Hogyan oldja meg az OmniRoute:**

-**npm globális telepítés**— `npm install -g omniroute && omniroute` — kész
-**Docker Multi-Platform**– AMD64 + ARM64 natív (Apple Silicon, AWS Graviton, Raspberry Pi)
-**Docker Compose Profiles**– "alap" (nincs CLI-eszközök) és "cli" (Claude Code, Codex, OpenClaw)
-**Electron Desktop App**– Natív alkalmazás Windows/macOS/Linux rendszerhez rendszertálcával, automatikus indítással, offline móddal
-**Split-Port Mode**– API és irányítópult külön portokon haladó forgatókönyvekhez (fordított proxy, konténerhálózat)
-**Cloud Sync**– Szinkronizálás konfigurálása az eszközök között a Cloudflare Workers segítségével
-**DB biztonsági mentések**– Az összes beállítás automatikus biztonsági mentése, visszaállítása, exportálása és importálása, a `DISABLE_SQLITE_AUTO_BACKUP` funkcióval a külsőleg kezelt biztonsági mentésekhez</details>

<részletek>
<summary><b>🌍 12. "A felület csak angol nyelvű, és a csapatom nem beszél angolul"</b></summary>

A nem angol nyelvű országok csapatai, különösen Latin-Amerikában, Ázsiában és Európában, csak angol nyelvű felületekkel küszködnek. A nyelvi akadályok csökkentik az átvételt és növelik a konfigurációs hibákat.

**Hogyan oldja meg az OmniRoute:**

-**Irányítópult i18n – 30 nyelv**– Mind az 500+ billentyű lefordítva, beleértve arab, bolgár, dán, német, spanyol, finn, francia, héber, hindi, magyar, indonéz, olasz, japán, koreai, maláj, holland, norvég, lengyel, portugál (PT/BR), román, thai, orosz, szlovák, svéd, filippínó, angol, thai, orosz, kínai, filippínó
-**RTL támogatás**– Jobbról balra haladó arab és héber nyelv támogatása
-**Többnyelvű README-k**— 30 teljes dokumentáció fordítás
-**Nyelvválasztó**— Globe ikon a fejlécben a valós idejű váltáshoz</details>

<részletek>
<summary><b>🔄 13. "Többre van szükségem, mint csevegésre – beágyazásra, képekre, hanganyagra van szükségem"</b></summary>

Az AI nem csak a csevegés befejezése. A fejlesztőknek képeket kell generálniuk, hangot kell átírniuk, beágyazást kell létrehozniuk a RAG számára, át kell sorolniuk a dokumentumokat, és moderálniuk kell a tartalmat. Minden API más végponttal és formátummal rendelkezik.

**Hogyan oldja meg az OmniRoute:**

-**Beágyazások**– `/v1/beágyazások' 6 szolgáltatóval és 9+ modellel
-**Képgenerálás**– `/v1/images/generations' 10 szolgáltatóval és 20+ modellel (OpenAI, xAI, Together, Fireworks, Nebius, Hyperbolic, NanoBanana, Antigravity, SD WebUI, ComfyUI)
-**Text-to-Video**— `/v1/videos/generations` — ComfyUI (AnimateDiff, SVD) és SD WebUI
-**Text-to-Music**— `/v1/music/generations` — ComfyUI (Stable Audio Open, MusicGen)
-**Audio átírás**— `/v1/audio/transcriptions` — Whisper + Nvidia NIM, HuggingFace, Qwen3
-**Text-to-Speech**— `/v1/audio/speech` — ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3,**Inworld**,**Cartesia**,**PlayHT**, + meglévő szolgáltatók
-**Moderációk**— `/v1/moderations` — Tartalombiztonsági ellenőrzések
-**Reranging**— `/v1/rerank` — Dokumentumreleváns átsorolás
-**Responses API**- Teljes `/v1/responses` támogatás a Codexhez</details>

<részletek>
<summary><b>🧪 14. "Nincs módom tesztelni és összehasonlítani a minőséget a különböző modellek között"</b></summary>

A fejlesztők szeretnék tudni, hogy melyik modell a legjobb az ő használati esetükben – kód, fordítás, érvelés –, de a manuális összehasonlítás lassú. Nincsenek integrált eval eszközök.

**Hogyan oldja meg az OmniRoute:**

-**LLM-értékelések**— Arany készlet tesztelése 10 előre betöltött esettel, beleértve az üdvözlést, a matematikát, a földrajzot, a kódgenerálást, a JSON-megfelelőséget, a fordítást, a leértékelést, a biztonsági megtagadást
-**4 egyezési stratégia**– "pontos", "tartalmazza", "regex", "egyéni" (JS függvény)
-**Translator Playground Test Bench**- Kötegelt tesztelés több bemenettel és várható kimenettel, szolgáltatók közötti összehasonlítás
-**Csevegés tesztelő**- Teljes körút vizuális válaszmegjelenítéssel
-**Élő monitor**– Valós idejű adatfolyam a proxyn keresztül folyó összes kérésről</details>

<részletek>
<summary><b>📈 15. "A teljesítmény elvesztése nélkül kell skáláznom"</b></summary>

A kérelmek mennyiségének növekedésével ugyanazok a kérdések gyorsítótárazás nélkül duplikált költségeket generálnak. Idempotencia nélkül a duplikált hulladékfeldolgozási kérelmek. A szolgáltatónkénti díjkorlátokat be kell tartani.

**Hogyan oldja meg az OmniRoute:**

-**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
-**Idempotency kérése**– 5 másodperces deduplikációs ablak azonos kérések esetén
-**Drátakorlát észlelése**– Szolgáltatónkénti RPM, minimális rés és maximális egyidejű követés
-**Szerkeszthető sebességkorlátok**- Konfigurálható alapértékek a Beállítások → Kitartással ellenálló képesség menüpontban
-**API Key Validation Cache**– 3-szintű gyorsítótár az éles teljesítményhez
-**Egészségügyi irányítópult telemetriával**— p50/p95/p99 késleltetés, gyorsítótár statisztika, üzemidő</details>

<részletek>
<summary><b>🤖 16. "Globálisan szeretném irányítani a modell viselkedését"</b></summary>

Azok a fejlesztők, akik minden választ egy adott nyelven, egy adott hangnemben szeretnének, vagy korlátozni szeretnék az érvelési tokeneket. Ennek konfigurálása minden eszközben/kérelemben nem praktikus.

**Hogyan oldja meg az OmniRoute:**

-**Rendszerprompt Injection**— Globális prompt minden kérelemre vonatkozik
-**A költségkeret átgondolásának ellenőrzése**– Indoklási token-kiosztás ellenőrzése kérésenként (áthaladó, automatikus, egyéni, adaptív)
-**9 Routing Strategies**– Globális stratégiák, amelyek meghatározzák a kérések elosztását
-**Wildcard Router**– a „szolgáltató/*” minták dinamikusan továbbítanak bármely szolgáltatóhoz
-**Kombinációs engedélyezés/letiltás váltás**- A kombók váltása közvetlenül az irányítópultról
-**Provider Toggle**— Egy szolgáltató összes kapcsolatának engedélyezése/letiltása egyetlen kattintással
-**Letiltott szolgáltatók**- Adott szolgáltatók kizárása a `/v1/models' listáról</details>

<részletek>
<summary><b>🧰 17. "Szükségem van az MCP-eszközökre, mint első osztályú termékképességekre"</b></summary>

Sok mesterséges intelligencia-átjáró csak rejtett megvalósítási részletként teszi közzé az MCP-t. A csapatoknak látható, kezelhető műveleti rétegre van szükségük.

**Hogyan oldja meg az OmniRoute:**

- Az MCP megjelenik az irányítópult navigációs és végponti protokoll lapján
- Dedikált MCP-kezelési oldal folyamatokkal, eszközökkel, hatókörökkel és audittal
- Beépített gyorsindítás az "omniroute --mcp" és a kliens beépítéséhez</details>

<részletek>
<summary><b>🧠 18. "A2A hangszerelésre van szükségem szinkronizálással + adatfolyam feladatútvonalak"</b></summary>

Az ügynöki munkafolyamatokhoz közvetlen válaszokra és hosszú távú, streamelt végrehajtásra van szükség életciklus-vezérléssel.

**Hogyan oldja meg az OmniRoute:**

- A2A JSON-RPC végpont ("POST /a2a") "message/send" és "message/stream" paraméterekkel
- SSE streaming terminál állapot terjesztéssel
- Feladatéletciklus API-k a "tasks/get" és a "tasks/cancel" számára</details>

<részletek>
<summary><b>🛰️ 19. "Valódi MCP-folyamat-állapotra van szükségem, nem kitalált állapotra"</b></summary>

Az operatív csapatoknak tudniuk kell, hogy az MCP valóban életben van-e, nem csak azt, hogy egy API elérhető-e.

**Hogyan oldja meg az OmniRoute:**

- Futásidejű szívverés fájl PID-vel, időbélyegekkel, szállítással, szerszámszámmal és hatókör móddal
- MCP állapot API, amely kombinálja a szívverést + a legutóbbi tevékenységet
- UI állapotkártyák a folyamat/üzemidő/szívverés frissességéhez</details>

<részletek>
<summary><b>📋 20. "Kivizsgálható MCP-eszköz-végrehajtásra van szükségem"</b></summary>

Amikor az eszközök módosítják a konfigurációt vagy működési műveleteket indítanak el, a csapatoknak kriminalisztikai nyomon követhetőségre van szükségük.

**Hogyan oldja meg az OmniRoute:**

- SQLite-alapú auditnaplózás MCP-eszközhívásokhoz
- Szűrések eszköz, siker/kudarc, API-kulcs és oldalszámozás szerint
- Irányítópult audit táblázat + statisztikai végpontok az automatizáláshoz</details>

<részletek>
<summary><b>🔐 21. "Integrációnként hatókörű MCP-engedélyekre van szükségem"</b></summary>

A különböző ügyfeleknek a legkevesebb jogosultsággal kell rendelkezniük az eszközkategóriákhoz.

**Hogyan oldja meg az OmniRoute:**

- 10 szemcsés MCP hatókör az ellenőrzött szerszámhozzáféréshez
- Hatályérvényesítés és láthatóság az MCP-kezelő felületen
- Biztonságos alaphelyzet az üzemi szerszámokhoz</details>

<részletek>
<summary><b>⚙️ 22. "Üzemeltetési vezérlőkre van szükségem átcsoportosítás nélkül"</b></summary>

A csapatoknak gyors futásidejű változtatásokra van szükségük incidensek vagy költségesemények során.

**Hogyan oldja meg az OmniRoute:**

- A kombinált aktiválás váltása közvetlenül az MCP műszerfaláról
- Rugalmassági profilok alkalmazása előre meghatározott házirend-csomagokból
- Állítsa vissza a megszakító állapotát ugyanarról a kezelőpanelről</details>

<részletek>
<summary><b>🔄 23. "Szükségem van az élő A2A feladat életciklusának láthatóságára és törlésére"</b></summary>

Az életciklus láthatósága nélkül a feladat-incidensek nehezen osztályozhatók.

**Hogyan oldja meg az OmniRoute:**

- Feladatok listázása/szűrés állapot/készség szerint oldalszámozással
- A feladatok metaadatainak, eseményeinek és műtermékeinek részletezése
- Feladat törlési végpont és felhasználói felület művelet megerősítéssel</details>

<részletek>
<summary><b>🌊 24. "Aktív adatfolyam-metrikákra van szükségem A2A terheléshez"</b></summary>

A streamelési munkafolyamatok működési betekintést igényelnek a párhuzamosság és az élő kapcsolatok terén.

**Hogyan oldja meg az OmniRoute:**

- Az A2A állapotba integrált aktív folyamszámlálók
- Utolsó feladat időbélyegzője és állapotonkénti száma
- A2A műszerfalkártyák a valós idejű műveletek figyeléséhez</details>

<részletek>
<summary><b>🪪 25. "Szabványos ügynökfelderítésre van szükségem az ügyfelek számára"</b></summary>

A külső klienseknek és hangszerelőknek géppel olvasható metaadatokra van szükségük a bevezetéshez.

**Hogyan oldja meg az OmniRoute:**

- Az ügynökkártya elérhető a `/.well-known/agent.json' címen
- A menedzsment felületen látható képességek és készségek
- Az A2A állapot API felfedezési metaadatokat tartalmaz az automatizáláshoz</details>

<részletek>
<summary><b>🧭 26. "Protokoll felfedezhetőségre van szükségem a termék felhasználói élményében"</b></summary>

Ha a felhasználók nem fedezik fel a protokollfelületeket, az elfogadás és a támogatás minősége csökken.

**Hogyan oldja meg az OmniRoute:**

- Összevont**Végpontok**oldal a proxy, MCP, A2A és API végpontok lapjaival
- Inline szolgáltatás állapotát váltja (Online/Offline) MCP és A2A esetén
- Hivatkozások az áttekintésből a dedikált kezelőlapokhoz</details>

<részletek>
<summary><b>🧪 27. "Végponttól végpontig terjedő protokoll-érvényesítésre van szükségem valódi ügyfelekkel"</b></summary>

A próbatesztek nem elegendőek a protokoll-kompatibilitás ellenőrzéséhez a kiadás előtt.

**Hogyan oldja meg az OmniRoute:**

- E2E csomag, amely elindítja az alkalmazást, és valódi MCP SDK kliens szállítást használ
- Az A2A kliens teszteli az áramlások felfedezését, küldését, streamingjét, lekérését és megszakítását
- Az állítások keresztellenőrzése az MCP audit és az A2A feladatok API-jával szemben</details>

<részletek>
<summary><b>📡 28. "Egységes megfigyelhetőségre van szükségem az összes felületen"</b></summary>

A megfigyelhetőség protokoll szerinti felosztása vakfoltokat és hosszabb MTTR-t hoz létre.

**Hogyan oldja meg az OmniRoute:**

- Egységes irányítópultok/naplók/analytics egy termékben
- Egészség + audit + kérés telemetria OpenAI, MCP és A2A rétegeken keresztül
- Működési API-k az állapothoz és az automatizáláshoz</details>

<részletek>
<summary><b>💼 29. "Egy futási időre van szükségem a proxy + eszközök + ügynök hangszereléshez"</b></summary>

Számos külön szolgáltatás futtatása növeli a működési költségeket és a hibamódokat.

**Hogyan oldja meg az OmniRoute:**

- OpenAI-kompatibilis proxy, MCP szerver és A2A szerver egy veremben
- Megosztott hitelesítés, rugalmasság, adattárolás és megfigyelhetőség
- Konzisztens politikai modell az összes interakciós felületen</details>

<részletek>
<summary><b>🚀 30. "Ügynöki munkafolyamatokat ragasztókód szétterülése nélkül kell szállítanom"</b></summary>

A csapatok veszítenek sebességükből, amikor több ad-hoc szolgáltatást és szkriptet illesztenek össze.

**Hogyan oldja meg az OmniRoute:**

- Egységes végpont stratégia az ügyfelek és ügynökök számára
- Beépített protokollkezelő felhasználói felületek és füstellenőrzési útvonalak
- Gyártásra kész alapok (biztonság, naplózás, rugalmasság, biztonsági mentés)</details>

### Example Playbooks (Integrated Use Cases)

**A játékkönyv: Maximalizálja a fizetett előfizetést + olcsó biztonsági mentés**```txt
Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

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

Playbook B: Zéró költségű kódolási verem```txt Combo: "free-forever"

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

Monthly cost: $0 Outcome: stable free coding workflow

**Playbook C: 24/7 mindig bekapcsolt tartalék lánc**```txt
Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads

D játékkönyv: Az ügynök MCP + A2A-val működik```txt

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

---

## 🆓 Start Free — Zero Configuration Cost

> Állítsa be az AI-kódolást percek alatt**0 USD/hó**áron. Csatlakoztassa ezeket az ingyenes fiókokat, és használja a beépített**Free Stack**kombinációt.

| lépés | Akció | Szolgáltatók feloldva |
| ---- | --------------------------------------------------- | ------------------------------------------------------------------ |
| 1 | Csatlakozás**Kiro**(AWS Builder ID OAuth) | Claude Sonnet 4.5, Haiku 4.5 —**korlátlan**|
| 2 | Csatlakozás**Qoder**(Google OAuth) | kimi-k2-gondolkodás, qwen3-coder-plus, deepseek-r1... —**korlátlan**|
| 3 | Csatlakoztassa a**Qwen**(eszközkód) | qwen3-coder-plus, qwen3-coder-flash... —**korlátlan**|
| 4 | Csatlakozás**Gemini CLI**(Google OAuth) | gemini-3-flash, gemini-2.5-pro –**180K/hó ingyenes**|
| 5 | `/dashboard/combos` →**Ingyenes köteg ($0)**sablon | Körbe-körbe minden ingyenes szolgáltató automatikusan |

**Mutasson bármely IDE/CLI-t a következőre:**`http://localhost:20128/v1` · API-kulcs: `any-string` · Kész.

>**Opcionális extra lefedettség (szintén ingyenes):**Groq API kulcs (30 RPM ingyenes), NVIDIA NIM (40 RPM ingyenes, 70+ modell), Cerebras (1 millió tok/nap), LongCat API kulcs (50 millió token/nap!), Cloudflare Workers AI (10 000 neuron/nap, 50+ modell).## Gyors kezdés

### 1) Install and run

```bash
npm install -g omniroute
omniroute

**pnpm felhasználók:**Telepítés után futtassa a pnpm approve-builds -g parancsot, hogy engedélyezze a better-sqlite3 és a @swc/core által igényelt natív build szkripteket:

pnpm install -g omniroute
pnpm approve-builds -g # Válassza ki az összes csomagot → jóváhagyja
omniroute

Az irányítópult a „http://localhost:20128” címen nyílik meg, az API alap URL-címe pedig „http://localhost:20128/v1”.

Parancs	Leírás
omniroute	Szerver indítása (PORT=20128, API és irányítópult ugyanazon a porton)
omniroute --port 3000	A kanonikus/API port beállítása 3000
omniroute --mcp	MCP-kiszolgáló indítása (stdio szállítás)
omniroute --no-open	Ne nyissa meg automatikusan a böngészőt
omniroute --help	Segítség megjelenítése

Opcionális osztott portos mód:```bash PORT=20128 DASHBOARD_PORT=20129 omniroute

API: http://localhost:20128/v1

Dashboard: http://localhost:20129

### Long-Running Streaming Timeouts

A legtöbb telepítéshez csak a következőkre van szüksége:

| Változó | Alapértelmezett | Cél |
| ------------------------- | ------------------------------ | -------------------------------------------------------------- -------------------------------------------------------------- |
| `REQUEST_TIMEOUT_MS` | "600000" | Megosztott alapvonal az upstream lekéréshez, a rejtett Undici-időtúllépésekhez, a TLS-ujjlenyomat-kérésekhez és az API-híd kérés/proxy időtúllépéséhez |
| `STREAM_IDLE_TIMEOUT_MS` | örökli a `REQUEST_TIMEOUT_MS' | Maximális hézag a streaming darabok között, mielőtt az OmniRoute megszakítja az SSE adatfolyamot |

A visszamenőleges kompatibilitás megmarad: a meglévő „FETCH_TIMEOUT_MS”, „API_BRIDGE_PROXY_TIMEOUT_MS” és más rétegenkénti időtúllépési változók továbbra is működnek, és felülírják a megosztott alapvonalat.

Speciális felülírások állnak rendelkezésre, ha finomabb vezérlésre van szüksége:| Változó | Alapértelmezett | Cél |
| ----------------------------------------- | ------------------------------------------- | --------------------------------------------------------------------- |
| `FETCH_TIMEOUT_MS` | örökli a `REQUEST_TIMEOUT_MS' | A fő lekérés megszakítási jele által használt teljes felfelé irányuló kérés időtúllépése |
| `FETCH_HEADERS_TIMEOUT_MS` | örökli a `FETCH_TIMEOUT_MS` | Undici időkorlát az upstream válaszfejlécek fogadására |
| `FETCH_BODY_TIMEOUT_MS` | örökli a `FETCH_TIMEOUT_MS` | Undici time limit between upstream body chunks (`0` disables it)     |
| `FETCH_CONNECT_TIMEOUT_MS` | "30000" | Undici TCP csatlakozási időtúllépés |
| `FETCH_KEEPALIVE_TIMEOUT_MS` | "4000" | Undici tétlen életben tartási aljzat időtúllépése |
| `TLS_CLIENT_TIMEOUT_MS` | örökli a `FETCH_TIMEOUT_MS` | Időtúllépés a `wreq-js` | segítségével küldött TLS-ujjlenyomat-kéréseknél
| `API_BRIDGE_PROXY_TIMEOUT_MS` | örökli a „REQUEST_TIMEOUT_MS” vagy „30000” | Időtúllépés a „/v1” proxy API-portról az irányítópult-portra való továbbítására |
| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | "max(API_BRIDGE_PROXY_TIMEOUT_MS, 300000)" | Bejövő kérés időtúllépése az API-hídszerveren |
| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | "60000" | Bejövő fejléc időtúllépése az API-hídszerveren |
| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | "5000" | Életben tartás időtúllépés az API-hídszerveren |
| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | "0" | Socket inaktivitási időtúllépése az API-hídszerveren ("0" letiltja) |

Ha az OmniRoute alkalmazást az Nginx, Caddy, Cloudflare vagy más fordított proxy mögött futtatja, győződjön meg arról, hogy a proxy
az időtúllépések is magasabbak, mint az OmniRoute adatfolyam/lekérési időkorlátok.### 2) Connect providers and create your API key

1. Nyissa meg az Irányítópult → „Szolgáltatók” menüpontot, és csatlakoztasson legalább egy szolgáltatót (OAuth- vagy API-kulcs).
2. Nyissa meg a Dashboard → `Végpontok` menüpontot, és hozzon létre egy API-kulcsot.
3. (Opcionális) Nyissa meg az Irányítópult → Kombók menüpontot, és állítsa be a tartalék láncot.### 3) Point your coding tool to OmniRoute

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

Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, OpenClaw, OpenCode és OpenAI-kompatibilis SDK-kkal működik.### 4) Enable and validate protocols (v2.0)

MCP (szerszámvezérelt műveletekhez):```bash omniroute --mcp

Ezután csatlakoztassa MCP-kliensét `stdio'-n keresztül, és tesztelje az olyan eszközöket, mint:

- `omniroute_get_health`
- `omniroute_list_combos`

**A2A (ügynök-ügynök munkafolyamatokhoz):**```bash
curl http://localhost:20128/.well-known/agent.json

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

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

npm run test:protocols:e2e

Ez a csomag érvényesíti a valódi MCP- és A2A-kliensfolyamokat egy futó alkalmazással szemben.### Alternative: run from source

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

<részletek>

Érvénytelen Linux (`xbps-src` sablon)

Void Linux felhasználók számára natív csomagot készíthet az xbps-src használatával. Mentse ezt a blokkot `srcpkgs/omniroute/template' néven:```bash

Template file for 'omniroute'

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

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

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

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

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

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

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

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

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

}

do_check() { npm run test:unit }

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

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

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

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

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

post_install() { vlicense LICENSE }

</details>

---

## 🐳 Docker

Az OmniRoute nyilvános Docker-képként érhető el a [Docker Hubon](https://hub.docker.com/r/diegosouzapw/omniroute).

**Gyors futás:**```bash
docker run -d \
  --name omniroute \
  --restart unless-stopped \
  --stop-timeout 40 \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Környezetfájllal:```bash

Copy and edit .env first

cp .env.example .env

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

**A Docker Compose használata:**```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

A Docker-telepítések irányítópult-támogatása mostantól magában foglal egy egykattintásosCloudflare Quick Tunnel-t az "Irányítópult → Végpontok" oldalon. Az első engedélyezés csak szükség esetén tölti le a „cloudflared” funkciót, ideiglenes alagutat indít a jelenlegi „/v1” végponthoz, és megjeleníti a generált „https://*.trycloudflare.com/v1” URL-t közvetlenül a normál nyilvános URL alatt.

Megjegyzések:

• A Quick Tunnel URL-ek ideiglenesek, és minden újraindítás után megváltoznak.
• A gyors alagutak nem állnak vissza automatikusan az OmniRoute vagy a tároló újraindítása után. Ha szükséges, engedélyezze őket újra az irányítópulton.
• A felügyelt telepítés jelenleg támogatja a Linuxot, a macOS-t és a Windowst „x64” / „arm64” rendszeren.
• A felügyelt gyorsalagutak alapértelmezés szerint a HTTP/2 átvitelt használják, hogy elkerüljék a zajos QUIC UDP puffer figyelmeztetéseket a korlátozott tárolókörnyezetekben. Állítsa be a "CLOUDFLARED_PROTOCOL=quic" vagy az "auto" értéket, ha más átvitelt szeretne.
• A Docker képek a rendszer CA-gyökereit csomagolják, és átadják a felügyelt "cloudflared"-nek, amely elkerüli a TLS-megbízhatósági hibákat, amikor az alagút a tárolón belül bootstradik.
• Az SQLite WAL módban fut. Engedélyezni kell a docker stop' befejezését, hogy az OmniRoute vissza tudja irányítani a legutóbbi változtatásokat a storage.sqlite' fájlba.
• A kötegelt Compose-fájlok már beállítottak egy 40 másodperces türelmi időt. Ha közvetlenül futtatja a képet, tartsa be a "--stop-timeout 40" értéket (vagy hasonlót), hogy a kézi leállítások ne szakítsák meg a leállítási tisztítást.
• Állítsa be a `CLOUDFLARED_BIN=/absolute/path/to/cloudflared' értéket, ha azt szeretné, hogy az OmniRoute egy létező binárist használjon a letöltés helyett.

A Docker Compose with Caddy (HTTPS Auto-TLS) használata:

Az OmniRoute biztonságosan elérhető a Caddy automatikus SSL-kiépítésével. Győződjön meg arról, hogy a domain DNS-rekordja a szerver IP-címére mutat.```yaml services: omniroute: image: diegosouzapw/omniroute:latest container_name: omniroute restart: unless-stopped volumes: - omniroute-data:/app/data environment: - PORT=20128 - NEXT_PUBLIC_BASE_URL=https://your-domain.com

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

volumes: omniroute-data:

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

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

> 🆕**ÚJ!**Az OmniRoute már elérhető**natív asztali alkalmazásként**Windows, macOS és Linux rendszeren.

Run OmniRoute as a standalone desktop app — no terminal, no browser, no internet required for local models. Az elektronalapú alkalmazás a következőket tartalmazza:

- 🖥️**Natív ablak**- Dedikált alkalmazásablak rendszertálca-integrációval
- 🔄**Automatikus indítás**- Indítsa el az OmniRoute alkalmazást a rendszerbe való bejelentkezéskor
- 🔔**Natív értesítések**- Értesítést kaphat a kvóta kimerüléséről vagy a szolgáltatói problémákról
- ⚡**Egykattintásos telepítés**- NSIS (Windows), DMG (macOS), AppImage (Linux)
- 🌐**Offline mód**- Teljesen offline módban működik a mellékelt szerverrel### Gyors kezdés

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

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

System Tray

Ha minimalizálja, az OmniRoute a tálcán él, gyors műveletekkel:

• Nyissa meg a műszerfalat
• Szerver port módosítása
• Lépjen ki az alkalmazásból

📖 Teljes dokumentáció: electron/README.md---

💰 Pricing at a Glance

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 KEY	NVIDIA NIM	INGYENES(végre fejlesztő)	~40 RPM	70+ nyitott modell
	Cerebrák	INGYENES(1 millió tok/nap)	60K TPM / 30 RPM	A világ leggyorsabb
	Groq	INGYENES(30 RPM)	14,4K RPD	Ultragyors Llama/Gemma
	DeepSeek V3.2	0,27 USD/1,10 USD/1 millió	Nincs	Legjobb ár/minőség érvelés
	xAI Grok-4 Fast	0,20 USD/0,50 USD/1 millió🆕	Nincs	Leggyorsabb + szerszámhívás, ultralow
	xAI Grok-4 (standard)	0,20 USD/1,50 USD/1M 🆕	Nincs	Oktatás zászlóshajója az xAI-tól
	Mistral	Ingyenes próbaverzió + fizetett	Ár korlátozott	Európai AI
	OpenRouter	Felhasználásonkénti fizetés	Nincs	100+ modell aggr.
💰 OLCSÓ	GLM-5 (a Z.AI-n keresztül) 🆕	0,5 USD/1M	Naponta 10:00	128K teljesítmény, legújabb zászlóshajó
	GLM-4.7	0,6 USD/1M	Naponta 10:00	Költségvetési biztonsági mentés
	MiniMax M2.5 🆕	0,3 USD/1 millió bemenet	5 órás gurulás	Érvelés + ügynöki feladatok
	MiniMax M2.1	0,2 USD/1M	5 órás gurulás	Legolcsóbb lehetőség
	Kimi K2.5 (Moonshot API) 🆕	Felhasználásonkénti fizetés	Nincs	Közvetlen Moonshot API hozzáférés
	Kimi K2	9 USD/hó lakás	10 millió token/hó	Előrelátható költség
🆓 INGYENES	Qoder	0 USD	Korlátlan	5 modell korlátlan
	Qwen	0 USD	Korlátlan	4 modell korlátlan
	Kiro	0 USD	Korlátlan	Claude Sonnet/Haiku (AWS Builder)
	LongCat Flash-Lite 🆕	0 USD(50 millió tok/nap 🔥)	1 RPS	A legnagyobb ingyenes kvóta a Földön
	Beporzások AI 🆕	0 USD(nincs szükség kulcsra)	1 rekv/15mp	GPT-5, Claude, DeepSeek, Llama 4
	Cloudflare Workers AI 🆕	0 USD(10 000 neuron/nap)	~150 ill./nap	50+ modell, globális élvonal
	Scaleway AI 🆕	0 USD(összesen 1 millió token)	Ár korlátozott	EU/GDPR, Qwen3 235B, Llama 70B	> 🆕**Új modellek hozzáadva (2026. március):**Grok-4 Fast család 0,20 USD/0,50 USD/M áron (1143 ms-os benchmark – 30%-kal gyorsabb, mint a Gemini 2.5 Flash), GLM-5 Z.AI-n keresztül 128K kimenettel, MiniMax M2.5 Vc3-on keresztül, KiepSeedk 2.5-ös okfejtéssel. Moonshot közvetlen API.

💡 0 dolláros kombinált halom – a teljes ingyenes beállítás:```

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

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

**Zéró költség. Never stops coding.**Configure this as one OmniRoute combo and all fallbacks happen automatically — no manual switching ever.---

---

## 🆓 Free Models — What You Actually Get

> Az alábbi modellek**100%-ban ingyenesek, hitelkártya nélkül**. Az OmniRoute automatikus útvonalakat indít közöttük, ha egy kvóta kifogy – kombinálja őket egy feltörhetetlen 0 dolláros kombinációért.### 🔵 CLAUDE MODELS (via Kiro — AWS Builder ID)

| Modell | Előtag | Limit | Rate Limit |
| -------------------- | ------ | ------------- | ---------------------- |
| `claude-szonett-4,5` | `kr/` |**Korlátlan**| Nincs bejelentett napi felső határ |
| `claude-haiku-4,5` | `kr/` |**Korlátlan**| Nincs bejelentett napi felső határ |
| `claude-opus-4,6` | `kr/` |**Korlátlan**| Legújabb Opus via Kiro |### 🟢 QODER MODELS (Free PAT via qodercli)

| Modell | Előtag | Limit | Rate Limit |
| ------------------- | ------ | ------------- | ---------------- |
| `kimi-k2-gondolkodás` | "ha/" |**Korlátlan**| Nincs bejelentett felső határ |
| "qwen3-coder-plus" | "ha/" |**Korlátlan**| Nincs bejelentett felső határ |
| `deepseek-r1` | "ha/" |**Korlátlan**| Nincs bejelentett felső határ |
| `minimax-m2,1` | "ha/" |**Korlátlan**| Nincs bejelentett felső határ |
| "kimi-k2" | "ha/" |**Korlátlan**| Nincs bejelentett felső határ |

> Javasolt csatlakozási mód:**Személyes hozzáférési token + `qodercli`**. A böngésző OAuth
> kísérleti és alapértelmezés szerint le van tiltva, hacsak nincsenek beállítva a `QODER_OAUTH_*` környezeti változók.### 🟡 QWEN MODELS (Device Code Auth)

| Modell | Előtag | Limit | Rate Limit |
| -------------------- | ------ | ------------- | -------------------- |
| "qwen3-coder-plus" | `qw/` |**Korlátlan**| Nincs bejelentett felső határ |
| `qwen3-coder-flash` | `qw/` |**Korlátlan**| Nincs bejelentett felső határ |
| `qwen3-coder-next` | `qw/` |**Korlátlan**| Nincs bejelentett felső határ |
| "látás-modell" | `qw/` |**Korlátlan**| Multimodális (képek) |### 🟣 GEMINI CLI (Google OAuth)

| Modell | Előtag | Limit | Rate Limit |
| ------------------------- | ------ | ---------------------------- | ------------- |
| `gemini-3-flash-preview` | `gc/` |**180 000 tok/hó**+ 1 000/nap | Havi visszaállítás |
| "gemini-2.5-pro" | `gc/` | 180 000/hó (megosztott medence) | Kiváló minőségű |### ⚫ NVIDIA NIM (Free API Key — build.nvidia.com)

| Tier | Napi limit | Rate Limit | Megjegyzések |
| ---------- | ------------ | ----------- | ------------------------------------------------------- |
| Ingyenes (fejlesztő) | Nincs token cap |**~40 RPM**| 70+ modell; átállás a tiszta díjhatárokra 2025 közepén |

Népszerű ingyenes modellek: "moonshotai/kimi-k2.5" (Kimi K2.5), "z-ai/glm4.7" (GLM 4.7), "deepseek-ai/deepseek-v3.2" (DeepSeek V3.2), "nvidia/llama-3.3-70b-deepseek"### ⚪ CEREBRAS (Free API Key — inference.cerebras.ai)

| Tier | Napi limit | Rate Limit | Megjegyzések |
| ---- | ------------------ | ----------------- | -------------------------------------------- |
| Ingyenes |**1 millió token/nap**| 60K TPM / 30 RPM | A világ leggyorsabb LLM-következtetése; naponta visszaállítja |

Ingyenesen elérhető: "llama-3.3-70b", "llama-3.1-8b", "deepseek-r1-distill-llama-70b"### 🔴 GROQ (Free API Key — console.groq.com)

| Tier | Napi limit | Rate Limit | Megjegyzések |
| ---- | ------------- | ----------------- | ------------------------------------------ |
| Ingyenes |**14,4K RPD**| 30 ford./perc modellenként | Nincs hitelkártya; 429 limiten, nem terhelik |

Ingyenesen elérhető: "láma-3.3-70b-veratile", "gemma2-9b-it", "mixtral-8x7b", "whisper-large-v3"### 🔴 LONGCAT AI (Free API Key — longcat.chat) 🆕

| Modell | Előtag | Napi ingyenes kvóta | Megjegyzések |
| ------------------------------ | ------ | ------------------ | ------------------------ |
| "LongCat-Flash-Lite" | "lc/" |**50 millió token**💥 | A valaha volt legnagyobb ingyenes kvóta |
| `LongCat-Flash-Chat` | "lc/" | 500 000 token | Többfordulós csevegés |
| "LongCat-Flash-Thinking" | "lc/" | 500 000 token | Érvelés / CoT |
| `LongCat-Flash-Thinking-2601` | "lc/" | 500 000 token | 2026. januári verzió |
| `LongCat-Flash-Omni-2603` | "lc/" | 500 000 token | Multimodális |

> 100%-ban ingyenes nyilvános bétaverzióban. Regisztráljon a [longcat.chat](https://longcat.chat) oldalon e-mailben vagy telefonon. Napi alaphelyzetbe állítás 00:00 UTC.### 🟢 POLLINATIONS AI (No API Key Required) 🆕

| Modell | Előtag | Rate Limit | Szolgáltató mögött |
| ---------- | ------ | ---------- | ------------------- |
| "openai" | `pol/` | 1 rekv/15mp | GPT-5 |
| `claude` | `pol/` | 1 rekv/15mp | Antropikus Claude |
| "gemini" | `pol/` | 1 rekv/15mp | Google Gemini |
| `mélyre törekszik` | `pol/` | 1 rekv/15mp | DeepSeek V3 |
| `láma` | `pol/` | 1 rekv/15mp | Meta Llama 4 Scout |
| "mistral" | `pol/` | 1 rekv/15mp | Mistral AI |

> ✨**Zéró súrlódás:**Nincs regisztráció, nincs API-kulcs. Adja hozzá a Pollinations szolgáltatót egy üres kulcsmezővel, és azonnal működik.### 🟠 CLOUDFLARE WORKERS AI (Free API Key — cloudflare.com) 🆕

| Tier | Napi neuronok | Egyenértékű használat | Megjegyzések |
| ---- | ------------- | ---------------------------------------- | ------------------------ |
| Ingyenes |**10 000**| ~150 LLM ill / 500s hang / 15K beágyazás | Globális élvonal, 50+ modell |

Népszerű ingyenes modellek: `@cf/meta/llama-3.3-70b-instruct`, `@cf/google/gemma-3-12b-it`, `@cf/openai/whisper-large-v3-turbo` (ingyenes hang!), `@cf/qwen/qwen2.5-coder-15b-coder-

> API-token + fiókazonosító szükséges a [dash.cloudflare.com] webhelyről (https://dash.cloudflare.com). Tárolja fiókazonosítóját a szolgáltató beállításaiban.### 🟣 SCALEWAY AI (1M Free Tokens — scaleway.com) 🆕

| Tier | Ingyenes kvóta | Helyszín | Megjegyzések |
| ---- | ------------- | ------------ | ------------------------------------ |
| Ingyenes |**1M token**| 🇫🇷 Párizs, EU | Nincs szükség hitelkártyára a korlátokon belül |

Ingyenesen elérhető: "qwen3-235b-a22b-instruct-2507" (Qwen3 235B!), "llama-3.1-70b-instruct", "mistral-small-3.2-24b-instruct-2506", "deepseek-v3-032"

> EU/GDPR-kompatibilis. Szerezze be az API-kulcsot a [console.scaleway.com](https://console.scaleway.com) címen.

>**💡 The Ultimate Free Stack (11 szolgáltató, 0 USD örökké):**
>
> ```
> Kiro (kr/) → Claude Sonnet/Haiku KORLÁTALAN
> Qoder (if/) → kimi-k2-gondolkodás, qwen3-coder-plus, deepseek-r1 UNLIMITED
> LongCat Lite (lc/) → LongCat-Flash-Lite – 50 millió token/nap 🔥
> Beporzások (pol/) → GPT-5, Claude, DeepSeek, Llama 4 – nincs szükség kulcsra
> Qwen (qw/) → qwen3 kódoló modellek KORLÁTALAN
> Gemini (gemini/) → Gemini 2.5 Flash – 1500 rekv/nap ingyenes
> Cloudflare AI (vö./) → 50+ modell – 10 000 neuron/nap
> Scaleway (scw/) → Qwen3 235B, Llama 70B — 1 millió ingyenes token (EU)
> Groq (groq/) → Llama/Gemma – 14,4 ezer rekv/nap ultragyors
> NVIDIA NIM (nvidia/) → 70+ nyitott modell – 40 RPM örökké
> Cerebrák (cerebras/) → Llama/Qwen a világ leggyorsabb – 1 millió tok/nap
> ```## 🎙️ Free Transcription Combo

> Bármilyen hang/videó átírása**0 USD-ért**– Deepgram vezet 200 USD ingyenes, AssemblyAI 50 USD tartalék, Groq Whisper korlátlan vészhelyzeti tartalékként.

| Szolgáltató | Ingyenes kreditek | Legjobb modell | Rate Limit |
| ------------------ | ----------------------- | --------------------------------------------- | ----------------------------- |
| 🟢**Deepgram**|**200 USD ingyenes**(regisztráció) | `nova-3` — a legjobb pontosság, több mint 30 nyelv | Nincs RPM-korlát az ingyenes krediteknél |
| 🔵**AssemblyAI**|**50 USD ingyenes**(regisztráció) | "univerzális-3-pro" – fejezetek, hangulat, személyazonosításra alkalmas adatok | Nincs RPM-korlát az ingyenes krediteknél |
| 🔴**Groq**|**Örökre ingyenes**| `whisper-large-v3` — OpenAI Whisper | 30 RPM (korlátozott sebesség) |

**Javasolt kombináció a `/dashboard/combos'-ban:**```
Name: free-transcription
Strategy: Priority
Nodes:
  [1] deepgram/nova-3          → uses $200 free first
  [2] assemblyai/universal-3-pro → fallback when Deepgram credits run out
  [3] groq/whisper-large-v3    → free forever, emergency fallback

Ezután a /dashboard/media →Átíráslapon: töltsön fel bármilyen audio- vagy videofájlt → válassza ki a kombinált végpontot → kérje le az átírást a támogatott formátumokban.## 💡 Key Features

Az OmniRoute v2.0 működési platformként készült, nem csak közvetítő proxyként.### 🆕 New — ClawRouter-Inspired Improvements (Mar 2026)

Funkció	Mit csinál
⚡Grok-4 Fast Family	xAI modellek 0,20 USD/0,50 USD/M áron – 1143 ms benchmark (30%-kal gyorsabb, mint a Gemini 2.5 Flash)
🧠GLM-5 a Z.AI-n keresztül	128 000 kimeneti kontextus, 0,5 USD/1 millió – a GLM család legújabb zászlóshajója
🔮MiniMax M2.5	Érvelés + ügynöki feladatok 0,30 USD/1M áron – jelentős fejlesztés az M2.1-hez képest
🎯ToolCalling Flag modellenként	Modellenkénti toolCalling: igaz/hamis a rendszerleíró adatbázisban – Az AutoCombo kihagyja az eszközzel nem rendelkező modelleket
🌍Többnyelvű szándékfelismerés	PT/ZH/ES/AR kulcsszavak az AutoCombo pontozásban – jobb modellválasztás nem angol nyelvű tartalomhoz
📊Benchmark-vezérelt tartalékok	Valódi p95 késés az élő kérések hírcsatornáiból, kombinált pontozásból – Az AutoCombo tanul a tényleges adatokból
🔁Duplikáció visszavonásának kérése	Tartalom-kivonat alapú dedup ablak – többügynök biztonságos, megakadályozza az ismétlődő terheléseket
🔌Pluggable RouterStrategy	Bővíthető "RouterStrategy" interfész – egyéni útválasztási logika hozzáadása pluginként	### 🚀 Previous v2.0.9+ — Playground, CLI Fingerprints & ACP

Funkció	Mit csinál
🎮Játszótér modell	Irányítópult oldal bármely modell közvetlen teszteléséhez – szolgáltató/modell/végpont választó, Monaco Editor, adatfolyam, megszakítás, időzítés
🔏CLI ujjlenyomat-egyeztetés	Szolgáltatónkénti fejléc/törzs rendezés a natív CLI-aláírásoknak megfelelően – váltson szolgáltatónként a Beállítások > Biztonság menüpontban.A proxy IP-címe megmarad
🤝ACP-támogatás (Agent Client Protocol)	CLI ügynök felderítés (Codex, Claude, Goose, Gemini CLI, OpenClaw + 9 további), folyamat spawner, "/api/acp/agents" végpont
🤖ACP Agents Dashboard	Hibakeresés › Ügynökök oldal – 14 ügynökből álló rács telepítési állapottal, verzióval, egyéni ügynök űrlappal bármely CLI-eszközhöz. AzOpenCodefelhasználók egy „Opencode.json letöltése” gombot kapnak, amely automatikusan létrehoz egy használatra kész konfigurációt az összes elérhető modellhez.
🔧Egyéni modell apiFormat Routing	Egyéni modellek apiFormat: "responses" segítségével most már megfelelően irányítják a Responses API fordítóhoz
🏢Codex Workspace Isolation	E-mailenként több Codex-munkaterület – az OAuth megfelelően választja el a kapcsolatokat a munkaterület-azonosító
🔄Elektronikus automatikus frissítés	Az asztali alkalmazás ellenőrzi a frissítéseket + automatikus telepítés újraindításkor	### 🤖 Agent & Protocol Operations (v2.0)

Funkció	Mit csinál
🔧MCP szerver (25 eszköz)	IDE/agent eszközök 3 átvitelen keresztül: stdio, SSE (/api/mcp/sse), Streamable HTTP (/api/mcp/stream). 18 mag + 3 memória + 4 ügyességi eszköz
🤝A2A szerver (JSON-RPC + SSE)	Ügynök-ügynök feladatvégrehajtás szinkronizálási és adatfolyam-folyamokkal
🧭Konszolidált végpontok oldal	Lapos kezelőoldal Endpoint Proxy, MCP, A2A és API Endpoints lapokkal
🎚️Szolgáltatás engedélyezése/letiltása kapcsolók	BE/KI kapcsolók az MCP-hez és az A2A-hoz a beállítások fennmaradásával (alapértelmezett: KI)
🛰️MCP Runtime Heartbeat	Valós folyamatállapot (pid, üzemidő, szívverés kora, szállítás, hatókör mód)
📋MCP Audit Trail	Szűrhető auditnaplók sikerrel/sikertelenséggel és kulcshozzárendeléssel
🔐MCP Scope Enforcement	10 részletes hatókörű engedély az ellenőrzött szerszám-hozzáféréshez
📡A2A Task Lifecycle Management	Feladatok listázása/szűrése, események/műtermékek ellenőrzése, futó feladatok megszakítása
📋Agent Card Discovery	/.well-known/agent.json az ügyfél automatikus felfedezéséhez
🧪E2E protokoll tesztkábel	Valódi MCP SDK + A2A kliens a "test:protocols:e2e"
⚙️Működési vezérlők	Váltókombó, rugalmassági profilok alkalmazása, megszakítók alaphelyzetbe állítása egyetlen vezérlőfelületről	### 🧠 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 ↔ Válaszok sémabiztos konverziókkal
👥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	9 kiegyensúlyozási stratégia + tartalék láncvezérlés
🌐Wildcard Router	szolgáltató/* dinamikus útválasztás
🧠A költségvetési szabályozás átgondolása	Áthaladási, automatikus, egyéni és adaptív érvelési korlátok
🔀Modell álnevek	Beépített + egyedi modell alias és migrációs biztonság
⚡Háttérromlás	Alacsony prioritású háttérfeladatok irányítása olcsóbb modellek felé
🧪Feladattudatos intelligens útválasztás	Modell automatikus kiválasztása tartalomtípus szerint (kódolás/látás/elemzés/összegzés)
🔄A2A ügynök munkafolyamatok	Determinisztikus FSM hangszerelő állapotfüggő többlépcsős ügynök-végrehajtáshoz
🔀Adaptív útválasztás	Dinamikus stratégia felülbírálása a token mennyisége és a prompt bonyolultsága alapján
🎲Szolgáltatói sokszínűség	Shannon entrópia pontozás kiegyenlítő automatikus kombinált forgalomelosztás
💬Rendszer azonnali befecskendezés	Következetesen alkalmazott globális viselkedésszabályozás
📄Responses API-kompatibilitás	Full /v1/responses support for Codex and advanced agentic workflows	### 🎵 Multi-Modal APIs

Funkció	Mit csinál
🖼️Képgenerálás	`/v1/images/generations' felhővel és helyi háttérprogramokkal
📐Beágyazás	`/v1/embeddings' a kereséshez és a RAG-folyamatokhoz
🎤Audio átírás	"/v1/audio/transcriptions" – 7 szolgáltató (Deepgram Nova 3, AssemblyAI, Groq Whisper, HuggingFace, ElevenLabs, OpenAI, Azure), automatikus nyelvérzékelés, MP4/MP3/WAV támogatás
🔊Szövegfelolvasó	"/v1/audio/speech" – 10 szolgáltató (ElevenLabs, OpenAI, Deepgram, Cartesia, PlayHT, HuggingFace, Nvidia NIM, Inworld, Coqui, Tortoise) helyes hibaüzenetekkel
🎬Videogeneráció	/v1/videos/generations (ComfyUI + SD WebUI munkafolyamatok)
🎵Zenegeneráció	`/v1/music/generations' (ComfyUI munkafolyamatok)
🛡️Moderálás	"/v1/moderations" biztonsági ellenőrzések
🔀Átsorolás	"/v1/rerank" a relevanciapontozáshoz
🔍Internetes keresés🆕	"/v1/search" – 5 szolgáltató (Serper, Brave, Perplexity, Exa, Tavily), 6500+ ingyenes/hó, automatikus feladatátvétel, gyorsítótár	### 🛡️ Resilience, Security & Governance

Funkció	Mit csinál
🔌Megszakítók	Modellenkénti kioldás/helyreállítás küszöbérték-vezérlőkkel
🎯Végpont-tudatos modellek	Az egyéni modellek deklarálják a támogatott végpontokat + API formátumot
🛡️Menydörgésellenes csorda	Mutex + szemafor védelem az újrapróbálkozás/rate eseményeknél
🧠Szemantikai + aláírás gyorsítótár	Költség/késleltetés csökkentése két gyorsítótár-réteggel
⚡Idempotencia kérése	Megkettőzött védőablak
🔒TLS ujjlenyomat-hamisítás	Böngészőszerű TLS-ujjlenyomat –csökkenti a botfelismerést és a fiók megjelölését
🔏CLI ujjlenyomat-egyeztetés	Megfelel a natív CLI-kérés aláírásainak —csökkenti a kitiltási kockázatot, miközben megőrzi a proxy IP-címét
🌐IP-szűrés	Engedélyezési lista/blokkolista vezérlés a nyílt telepítésekhez
📊Szerkeszthető díjkorlátok	Konfigurálható globális/szolgáltatói szintű korlátozások tartósan
📉Kecses leépülés	Többrétegű képességek tartalékai az alapvető átjáróműveletek védelmére
📜Config Audit Trail	Diff-alapú változáskövetés, amely megakadályozza a működési eltolódást egyszerű visszaállításokkal
⏳Provider Health Sync	Proaktív jogkivonat lejárati figyelése, amely riasztásokat vált ki az engedélyezési hibák előtt
🚪A kitiltott fiókok automatikus letiltása	A működő megszakító automatikusan lezárja a véglegesen blokkolt tokenszámlákat
🔑API-kulcskezelés + hatókör	A kulcsok biztonságos kiadása/forgatása és a modell/szolgáltató vezérlői
👁️Hatáskörű API-kulcs felfedése🆕	Az API-kulcsok visszaállításának engedélyezése a következőn keresztül: ALLOW_API_KEY_REVEAL
🛡️Védett /modellek	Opcionális hitelesítési kapu és szolgáltatói elrejtés a modellkatalógushoz	### 📊 Observability & Analytics

Funkció	Mit csinál
📝Kérés + proxynaplózás	Teljes kérés/válasz és proxynaplózás
📉Folyamatos részletes naplók🆕	Tisztán rekonstruálja az SSE hasznos adatfolyamokat a felhasználói felületbe
📋Unified Logs Dashboard	Kérelem, proxy, audit és konzolnézet egy oldalon
🔍Telemetria kérése	p50/p95/p99 késleltetés és nyomkövetési kérelem
🏥Egészségügyi irányítópult	Üzemidő, megszakítási állapotok, zárolások, gyorsítótár statisztika
💰Költségkövetés	Költségvetési vezérlők és modellenkénti árképzés láthatósága
📈Analytics vizualizációk	Modell/szolgáltató használati betekintések és trendnézetek
🧪Értékelési keret	Arany készlet tesztelése konfigurálható meccsstratégiákkal
📡Élő diagnosztika🆕	Szemantikus gyorsítótár bypass a pontos kombinált élő teszteléshez	### ☁️ Deployment & Platform

Funkció	Mit csinál
🌐Deploy Anywhere	Localhost, VPS, Docker, Cloud környezetek
🚇Cloudflare Tunnel🆕	Egykattintásos Quick Tunnel integráció az irányítópultról
🔑API kulcsmodell szűrése	Natív /v1/models válasz a hozzárendelt hordozókörnyezeti szerepkörökön keresztül szűrve
⚡Smart Cache Bypass	Konfigurálható TTL-heurisztika és kényszerített visszatöltési vezérlők
🔄Biztonsági mentés/visszaállítás	Export/import és katasztrófa utáni helyreállítási folyamatok
🧙Bevezető varázsló	Első futtatás irányított beállítás
🔧CLI Tools Dashboard	Egykattintásos beállítás a népszerű kódolóeszközökhöz
🎮Játszótér modell	Teszteljen bármely szolgáltatót/modellt/végpontot az irányítópultról
🔏CLI ujjlenyomat kapcsoló	Szolgáltatónkénti ujjlenyomat-egyeztetés a Beállítások > Biztonság
🌐i18n (30 nyelv)	Teljes irányítópult + dokumentumok nyelvi támogatása RTL lefedettséggel
🧹Minden modell törlése	Egykattintásos modelllista törlése a szolgáltató adatai között
👁️Sidebar Controls🆕	Összetevők és integrációk elrejtése a Megjelenés beállításaiból
📋Kiadássablonok	Szabványos GitHub-sablonok hibákhoz és szolgáltatásokhoz
📂Egyéni adattár	DATA_DIR felülírása a tárolási helyhez	### Feature Deep Dive

Smart fallback with practical cost control

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

Ha a kvóta, arány vagy állapot meghiúsul, az OmniRoute kézi váltás nélkül automatikusan a következő jelöltre lép.#### Protocol management that is visible and operable

• Az MCP + A2A felfedezhető a felhasználói felületen és a dokumentumokban (nem rejtett)
• A protokollállapot API-k élő működési adatokat tesznek közzé (/api/mcp/*, /api/a2a/*)
• Az irányítópultok tartalmaznak műveleteket a 2. napi műveletekhez (kombinált kapcsolók, megszakítók alaphelyzetbe állítása, feladat törlése)#### Translator + validation workflow

A Fordító terület a következőket tartalmazza:

-Játszótér: kérjen átalakítási ellenőrzéseket -Csevegés tesztelő: teljes kérés/válasz oda-vissza út -Tesztpad: több eset egy menetben -Élő monitor: valós idejű forgalmi nézet

Plusz a protokoll érvényesítése valós kliensekkel az "npm run test:protocols:e2e" segítségével.

📖MCP Server README— Eszközreferencia, IDE-konfigurációk és példák kliensekre

📖A2A kiszolgáló README– Készségek, JSON-RPC metódusok, adatfolyamok és feladatok életciklusa## 🧪 Evaluations (Evals)

Az OmniRoute egy beépített kiértékelő keretrendszert tartalmaz, amellyel az LLM válaszminőségét egy aranykészlettel összehasonlítva tesztelheti. Az irányítópulton azAnalytics → Evalsmenüpontban érheti el.### Built-in Golden Set

Az előre feltöltött "OmniRoute Golden Set" teszteseteket tartalmaz:

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

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

📖 Setup Guide

Protocol Setup (MCP + A2A)

<részletek>

🧩 MCP beállítása (Model Context Protocol)

Indítsa el az MCP-átvitelt stdio módban:```bash omniroute --mcp

Javasolt érvényesítési folyamat:

1. Csatlakoztassa az MCP-klienst az stdio-n keresztül.
2. Futtassa az „omniroute_get_health” parancsot.
3. Futtassa az `omniroute_list_combos` parancsot.
4. Nyissa meg a „/dashboard/mcp” mappát a szívverés, a tevékenység és az ellenőrzés megerősítéséhez.

Hasznos API-k az automatizáláshoz:

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

<részletek>
<summary><b>🤝 A2A beállítás (Agent2Agent)</b></summary>

Fedezze fel az ügynököt:```bash
curl http://localhost:20128/.well-known/agent.json

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

Életciklus kezelése:

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

Működési UI:

- `/dashboard/a2a` a feladat/állapot/folyam megfigyelhetőségéhez és füstműveletekhez</details>

<részletek>
<summary><b>🧪 Végpontok közötti protokollellenőrzés</b></summary>

Érvényesítse mindkét protokollt valódi ügyfelekkel:```bash
npm run test:protocols:e2e

Ez igazolja:

• MCP SDK kliens csatlakozás/lista/hívás
• A2A felfedezés/küldés/stream/get/cancel
• Az MCP audit és A2A feladatkezelő API-k adatainak keresztellenőrzése

<részletek>

💳 Előfizetéses 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

Codex Account Limit Management (5h + Weekly)

Mostantól minden Codex-fiók rendelkezik házirend-kapcsolókkal az "Irányítópult -> Szolgáltatók" részben:

• "5h" (BE/KI): az 5 órás ablak küszöbszabályának érvényesítése.
• Heti (BE/KI): érvényesíti a heti ablak küszöbértékét.
• Küszöbbeli viselkedés: ha egy engedélyezett ablak eléri a >=90%-os használatot, a fiók kimarad.
• Forgatási viselkedés: Az OmniRoute automatikusan a következő jogosult Codex-fiókhoz irányít.
• Visszaállítási viselkedés: amikor a szolgáltató „resetAt” ideje letelik, a fiók automatikusan újra jogosulttá válik.

Forgatókönyvek:

• 5h ON + Heti BE: a fiók kimarad, ha valamelyik ablak eléri a küszöbértéket.
• 5h OFF + Heti BE: csak heti használat blokkolhatja a fiókot.
• 5h BE + Heti KI: csak 5 órás használat blokkolhatja a fiókot.
• resetAt sikeres: a fiók automatikusan újraindul a forgatásba (nincs kézi újraengedélyezés).### Gemini CLI (FREE 180K/month!)

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

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

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

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

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

<részletek>

🔑 API-kulcsszolgáltatók

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

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

Modelek:"nvidia/llama-3.3-70b-instruct", "nvidia/mistral-7b-instruct" és több mint 50 további

**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 (Free Tier Available!)

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+ Models)

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.

Az irányítópult viselkedése:Az OpenRouter modellek kezelése azElérhető modellekoldalon történik. A kézi hozzáadása, importálása és automatikus szinkronizálása ugyanazt a listát frissíti.

<részletek>

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

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

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: "a-kulcs".

Használja: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 (5h reset, $0.20/1M)

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

Használja:minimax/MiniMax-M2.1

**Profi tipp:**A legolcsóbb lehetőség hosszú kontextushoz (1 millió token)!### Kimi K2 ($9/month flat)

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

Használd:kimi/kimi-latest

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

<részletek>

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

### Qoder (5 FREE models via OAuth)

Dashboard → Connect Qoder
→ Qoder OAuth login
→ Unlimited usage

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

Qwen (4 FREE models via Device Code)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

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

Kiro (Claude FREE)

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

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

<részletek>

🎨 Hozzon létre kombókat

### Example 1: Maximize Subscription → Cheap Backup

Dashboard → Combos → Create New

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

Use in CLI: premium-coding

Example 2: Free-Only (Zero Cost)

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

Cost: $0 forever!

<részletek>

🔧 CLI-integráció

### Cursor IDE

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

Claude Code

Használja az irányítópultCLI Toolsoldalá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:**Az `~/.openclaw/openclaw.json` szerkesztése:```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. Az IPv6-feloldási problémák elkerülése érdekében használja a "127.0.0.1" értéket a "localhost" helyett.### Cline / Continue / RooCode

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

OpenCode

**1. lépés:**Az OmniRoute hozzáadása egyéni szolgáltatóként:```bash opencode /connect

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

**2. lépés:**Hozza létre/szerkesztse az `opencode.json` fájlt a projekt gyökérjében:```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1"
      },
      "models": {
        "cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
      }
    }
  }
}

**3. lépés:**Válassza ki a modellt az OpenCode-ban:```bash /models

Select any OmniRoute model from the list

>**Tipp:**Adjon hozzá bármely, az OmniRoute `/v1/models' végpontjában elérhető modellt a `modellek' szakaszhoz. Használja a „szolgáltató/modellazonosító” formátumot az OmniRoute irányítópultján.</details>

---

## Hibaelhárítás

<részletek>
<summary><b>Kattintson ide a hibaelhárítási útmutató kibontásához</b></summary>

**"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
- Kombó 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, Qoder) a nem kritikus feladatokhoz

**Az irányítópult/API portok hibásak**

- A "PORT" a kanonikus alapport (és alapértelmezés szerint API-port)
- Az „API_PORT” csak az OpenAI-kompatibilis API figyelőt írja felül
- A „DASHBOARD_PORT” csak az irányítópultot/Next.js figyelőt írja felül
- Állítsa be a „NEXT_PUBLIC_BASE_URL” címet irányítópultjára/nyilvános URL-címére (OAuth-visszahívásokhoz)

**Felhő szinkronizálási hibák**

- Ellenőrizze, hogy a "BASE_URL" a futó példányra mutat
- Ellenőrizze, hogy a „CLOUD_URL” a várható felhő-végpontra mutat
- Tartsa a `NEXT_PUBLIC_*` értékeket a szerveroldali értékekkel összhangban

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

- Ellenőrizze az "INITIAL_PASSWORD" értéket a ".env" fájlban
- Ha nincs beállítva, a tartalék jelszó `123456`

**Nincs kérésnapló**

- A kérés melléktermékei kérésenként egy JSON-fájlként íródnak a `DATA_DIR/call_logs/` mappába
- Engedélyezze a folyamat rögzítését az Irányítópult → Naplók → Kérelemnaplók menüpontból, ha részletes, szakaszonkénti hasznos adatokra van szüksége
- Állítsa be az "APP_LOG_TO_FILE=true" értéket, ha az alkalmazáskonzolnaplókat is szeretné a "logs/application/app.log" fájlban
- Szükség szerint állítsa be a `APP_LOG_MAX_FILE_SIZE', 'APP_LOG_RETENTION_DAYS', 'APP_LOG_MAX_FILES' és 'CALL_LOG_MAX_ENTRIES'

**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 on a Remote Server

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

>**⚠️ Fontos az OmniRoute-ot VPS-en, Dockeren vagy bármely távoli szerveren futtató felhasználók számára**#### Why does Antigravity / Gemini CLI OAuth fail on remote servers?

Az**Antigravity**és**Gemini CLI**szolgáltatók a**Google OAuth 2.0**szolgáltatást használják. A Google megköveteli, hogy az OAuth-folyamatban szereplő „redirect_uri” pontosan egyezzen az alkalmazás Google Cloud Console-jában előregisztrált URI-k egyikével.

Az OmniRoute csomagban található OAuth hitelesítő adatok**csak a „localhost” számára vannak regisztrálva**. Amikor egy távoli szerveren éri el az OmniRoute-ot (pl. `https://omniroute.myserver.com`), a Google a következőkkel utasítja el a hitelesítést:```
Error 400: redirect_uri_mismatch

Solution: Configure your own OAuth credentials

Létre kell hoznia egyOAuth 2.0 ügyfél-azonosítóta Google Cloud Console-ban a szerver URI-jával.#### Step-by-step

1. Nyissa meg a Google Cloud Console-t

Keresse fel a következőt: https://console.cloud.google.com/apis/credentials

2. Új OAuth 2.0 ügyfél-azonosító létrehozása

• Kattintson a**„+ Hitelesítési adatok létrehozása”→„OAuth-ügyfélazonosító”**elemre.
• Alkalmazás típusa:"Web alkalmazás"
• Név: bármi, ami tetszik (pl. "OmniRoute Remote")

3. Engedélyezett átirányítási URI-k hozzáadása

Az**"Engedélyezett átirányítási URI-k"**mezőbe írja be:``` https://your-server.com/callback

> Cserélje ki a "your-server.com" címet a szerver domainjére vagy IP-címére (ha szükséges, adja meg a portot, pl. "http://45.33.32.156:20128/callback").

**4. Mentse és másolja a hitelesítő adatokat**

A létrehozás után a Google megjeleníti az**Client ID**és**Client Secret**kódot.

**5. Környezeti változók beállítása**

Az „.env” (vagy a Docker környezeti változókban):```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

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

6. Az OmniRoute újraindítása```bash

npm:

npm run dev

Docker:

docker restart omniroute

**7. Próbáljon újra csatlakozni**

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

A Google most megfelelően átirányítja a `https://your-server.com/callback` címre.---

#### Temporary workaround (without custom credentials)

Ha most nem szeretné beállítani a saját hitelesítő adatait, továbbra is használhatja a**manuális URL-folyamatot**:

1. Az OmniRoute megnyitja a Google engedélyezési URL-címét
2. After authorizing, Google tries to redirect to `localhost` (which fails on the remote server)
3.**Másolja ki a teljes URL-t**a böngésző címsorából (még akkor is, ha az oldal nem töltődik be)
4. Illessze be az URL-t az OmniRoute csatlakozási módban látható mezőbe
5. Kattintson a**"Csatlakozás"**gombra.

> Ez azért működik, mert az URL-ben szereplő engedélyezési kód attól függetlenül érvényes, hogy az átirányítási oldal betöltődött-e.---

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

Az**Antigravitáció**és a**Gemini CLI**usam**Google OAuth 2.0**hitelesítése. O Google exige que a `redirect_uri` usada no 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

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

Você precisa criar umOAuth 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ítse a "seu-servidor.com" pelo domínio vagy IP do seu servidor címet (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):```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 o OmniRoute```bash

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` és autenticação funcionará.---

#### Workaround 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.</details>

---

</details>

## 🛠️ Tech Stack

<részletek>
<summary><b>Kattintson ide a technológiai verem részleteinek kibontásához</b></summary>

-**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**az „src/” és az „open-sse/” protokollokon keresztül (nulla „bármilyen” az alapmodulokban a v2.0 óta)
-**Keretrendszer**: Next.js 16 + React 19 + Tailwind CSS 4
-**Adatbázis**: LowDB (JSON) + SQLite (tartomány állapota + proxynaplók + MCP-audit + útválasztási döntések)
-**Sémák**: Zod (MCP-eszköz I/O-ellenőrzése, API-szerződések)
-**Protokollok**: MCP (stdio/HTTP) + A2A v0.3 (JSON-RPC 2.0 + SSE)
-**Streaming**: Szerver által küldött események (SSE)
-**Auth**: OAuth 2.0 (PKCE) + JWT + API-kulcsok + MCP-hatókörű engedélyezés
-**Tesztelés**: Node.js tesztfutó + Vitest (900+ teszt, beleértve az egységet, az integrációt, az E2E-t)
-**CI/CD**: GitHub Actions (automatikus npm közzététel + Docker Hub kiadáskor)
-**Webhely**: [omniroute.online](https://omniroute.online)
-**Csomag**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
-**Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
-**Rugalmasság**: megszakító, exponenciális visszakapcsolás, mennydörgés elleni csorda, TLS-hamisítás, automatikus kombinált öngyógyítás</details>

---

## Dokumentáció

| dokumentum | Leírás |
| ----------------------------------------------- | ---------------------------------------------------- |
| [Felhasználói útmutató](docs/USER_GUIDE.md) | Szolgáltatók, kombók, CLI-integráció, telepítés |
| [API-referencia](docs/API_REFERENCE.md) | Minden végpont példákkal |
| [MCP-kiszolgáló](open-sse/mcp-server/README.md) | 16 MCP-eszköz, IDE konfigurációk, Python/TS/Go kliensek |
| [A2A szerver](src/lib/a2a/README.md) | JSON-RPC 2.0 protokoll, készségek, adatfolyam, feladat mgmt |
| [Auto-Combo Engine](docs/auto-combo.md) | 6 faktoros pontozás, módcsomagok, öngyógyító |
| [Hibaelhárítás](docs/TROUBLESHOOTING.md) | Gyakori problémák és megoldások |
| [Architektúra](docs/ARCHITECTURE.md) | Rendszerarchitektúra és belső elemek |
| [Hozzájárulás](CONTRIBUTING.md) | Fejlesztési beállítások és irányelvek |
| [OpenAPI Spec](docs/openapi.yaml) | OpenAPI 3.0 specifikáció |
| [Biztonsági politika](SECURITY.md) | Sebezhetőségi jelentések és biztonsági gyakorlatok |
| [VM-telepítés](docs/VM_DEPLOYMENT_GUIDE.md) | Teljes útmutató: VM + nginx + Cloudflare beállítás |
| [Features Gallery](docs/FEATURES.md) | Vizuális irányítópult bemutató képernyőképekkel |
| [Kiadási ellenőrzőlista](docs/RELEASE_CHECKLIST.md) | Kiadás előtti érvényesítési lépések |---

## 🗺️ Roadmap

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 |### 🔜 Coming Soon

- 🔗**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ó elérhető a [`docs/new-features/`](docs/new-features/) oldalon (217 részletes specifikáció)---

## 👥 Contributors

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

### How to Contribute

1. Fork a tároló
2. Hozza létre a szolgáltatási ágat (`git checkout -b feature/amazing-feature`)
3. Végezze el a változtatásokat (`git commit -m 'Elképesztő funkció hozzáadása'`)
4. Nyomja le az ágra (`git push origin funkció/csodálatos szolgáltatás`)
5. Nyisson meg egy lehívási kérelmet

A részletes útmutatásért lásd: [CONTRIBUTING.md](CONTRIBUTING.md).### Releasing a New Version

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

---

📊 Star History

Stargazers over time

🙏 Acknowledgments

Külön köszönet a**decolua****9router**-nak – az eredeti projektnek, 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 a**CLIProxyAPI**-nak – az eredeti Go implementációnak, amely ihlette ezt a JavaScript-portot.---

Licenc

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

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