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égpontok** |  |
 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 |
http://localhost:20128/v1 vagy http://cloud.omni_TOKEN_465\_\_http://cloud.omniroute konfiguráció, korlátlan modellek és kvóta
---
## 🤔 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
---
## 📧 Támogatás
> 💬 **Csatlakozzon közösségünkhöz!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Kérjen segítséget, ossza meg tippjeit, és naprakész legyen.
- **Webhely**: [omniroute.online](https://omniroute.online)
- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
- **Problémák**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
- **Hozzájárulás**: Lásd [CONTRIBUTING.md](CONTRIBUTING.md), nyisson PR-t, vagy válasszon egy `good first issue`
- **Eredeti projekt**: [9router by decolua](https://github.com/decolua/9router)
### 🐛 Hibát jelent?
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`-t 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 (iflow, 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.
---
## 🔄 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
```
---
## 🎯 Mit old meg az OmniRoute – 30 valódi fájdalompont és használati eset
> **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.
💸 1. "Drága előfizetésért fizetek, de még mindig megszakítanak a korlátok"
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. A kódolási munkamenet közepén a szolgáltató leáll, és a fejlesztő elveszíti a folyamatot és a termelékenységet. **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 - **Valós idejű kvótakövetés** – Valós időben mutatja a token felhasználást, visszaszámlálással (5 óra, napi, heti) - **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 kombók** — Testreszabható tartalék láncok 6 kiegyensúlyozási stratégiával (fill-first, round-robin, P2C, véletlenszerű, legkevésbé használt, költségoptimalizált) - **Codex üzleti kvóták** — Üzleti/csapat munkaterület-kvóta figyelése közvetlenül az irányítópulton🔌 2. "Több szolgáltatót kell használnom, de mindegyiknek más az API"
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 67+ szolgáltató számára - **Formátumfordítás** - Automatikus és átlátható: OpenAI ↔ Claude ↔ Gemini ↔ Responses API - **Response Sanitization** – Törli azokat a nem szabványos mezőket (`x_groq`, `usage_breakdown`, `service_tier`), amelyek megsértik az OpenAI SDK v1.83+ verzióját - **Szerepek normalizálása** — `developer` → `system` konvertálása nem OpenAI szolgáltatók számára; `system` → `user` a GLM/ERNIE számára - **Think Tag Extraction** – `🌐 3. "Az AI-szolgáltatóm blokkolja a régiómat/országomat"
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 olyan hibákat kapnak, mint az `unsupported_country_region_territory` az OAuth- és API-kapcsolatok során. 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 keresztül is megy, megoldva a `unsupported_country_region_territory` - **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`-on keresztül a botészlelés megkerüléséhez - **🔏 CLI Fingerprint Matching** – A fejlécek és törzsmezők átrendezése a natív CLI bináris aláírásokhoz igazodva, 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🆓 4. "AI-t akarok használni kódoláshoz, de nincs pénzem"
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 a 100%-ban ingyenes szolgáltatókhoz: iFlow (5 korlátlan modell az OAuth-on keresztül: kimi-k2-thinking, qwen3-coder-plus, deepseek-r1, minimax-m2, kimi-k2), Qwen-modellek: 4 unqlim-plus3 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 a `api.ollama.com` címen ingyenes „Light usage” szinttel; használja az `ollamacloud/🔒 5. "Meg kell védenem a mesterséges intelligencia átjárómat a jogosulatlan hozzáféréstől"
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 - **Modell-szintű engedélyek** – 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áról - **Auth Guard + CSRF védelem** - Minden irányítópult-ú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🛑 6. "A szolgáltatóm leállt, és elvesztettem a kódolási folyamatomat"
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🔧 7. „Az egyes mesterséges intelligencia-eszközök konfigurálása fárasztó és ismétlődő”
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 másodpilóta konfigurációs generátor** – `chatLanguageModels.json` generál 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** - A `http://localhost:20128/v1` egyszeri konfigurálása, 67+ szolgáltató elérése🔑 8. "A több szolgáltatótól származó OAuth-tokenek kezelése pokol"
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 `client_secret is missing`, `redirect_uri_mismatch` és a távoli kiszolgálók hibáit. 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, iFlow 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 a `redirect_uri` számára + kézi URL mód távoli szerverekhez - **OAuth az Nginx mögött** - A `window.location.origin` kódot használja a fordított proxy kompatibilitáshoz - **Távoli OAuth útmutató** – Lépésről lépésre útmutató a Google Cloud hitelesítő adataihoz VPS/Docker rendszeren📊 9. "Nem tudom, mennyit költök és hol"
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 - **Per-Model Pricing Configuration** — Configurable prices per model - **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🐛 10. "Nem tudom diagnosztizálni a hibákat és problémákat az AI-hívásoknál"
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:** - **Unified Logs Dashboard** — 4 tabs: Request Logs, Proxy Logs, Audit Logs, Console - **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 - **Fájlalapú naplózás elforgatással** - A konzolelfogó mindent JSON-naplóba rögzít méretalapú elforgatással - **Rendszerinformációs jelentés** — A `npm run system-info` a teljes környezettel (Node-verzió, OmniRoute-verzió, OS, CLI-eszközök, Docker/PM2 állapot) `system-info.txt`-t generál. Csatolja, amikor az azonnali osztályozással kapcsolatos problémákat jelent be.🏗️ 11. "Az átjáró telepítése és karbantartása összetett"
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, a `EACCES` a könyvtárakon, a portütközések é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** — `base` (nincs CLI-eszközök) és `cli` (Claude Code-al, Codex-szel, OpenClaw-val) - **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🌍 12. "A felület csak angol nyelvű, és a csapatom nem beszél angolul"
A nem angol nyelvű országokban, különösen Latin-Amerikában, Ázsiában és Európában működő csapatok 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:** - **I18n irányítópult – 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🔄 13. "Többre van szükségem, mint csevegésre – beágyazásra, képekre, hangra van szükségem"
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/embeddings` 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 - **Szövegfelolvasó** — `/v1/audio/speech` — ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3, **Inworld**, **Cartesia**, **PlayHT**, + meglévő szolgáltatók - **Moderálás** - `/v1/moderations` - Tartalombiztonsági ellenőrzések - **Újrarangsorolás** - `/v1/rerank` - Dokumentumreleváns átsorolás - **Responses API** - Teljes `/v1/responses` támogatás a Codex számára🧪 14. "Nincs módom tesztelni és összehasonlítani a modellek minőségét"
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ú. Nem léteznek 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** — `exact`, `contains`, `regex`, `custom` (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📈 15. "A teljesítmény elvesztése nélkül kell méreteznem"
A kérelmek mennyiségének növekedésével ugyanazok a kérdések a 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ő🤖 16. "Globálisan szeretném irányítani a modell viselkedését"
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) - **6 Útválasztási stratégia** – Globális stratégiák, amelyek meghatározzák a kérések elosztását - **Wildcard Router** - `provider/*` 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🧰 17. "MCP-eszközökre van szükségem, mint első osztályú termékképességekre"
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 a `omniroute --mcp` és a kliens bevezetéséhez🧠 18. "A2A hangszerelésre van szükségem szinkronizálással + adatfolyam feladatútvonalak"
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` - SSE streaming terminál állapot terjesztéssel - Feladat életciklus API-k a `tasks/get` és `tasks/cancel` számára🛰️ 19. "Valódi MCP folyamatállapotra van szükségem, nem kitalált állapotra"
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📋 20. "Kivizsgálható MCP-eszköz-végrehajtásra van szükségem"
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🔐 21. "Hatókörű MCP-engedélyekre van szükségem integrációnként"
A különböző ügyfeleknek a legkevesebb jogosultsággal kell rendelkezniük az eszközkategóriákhoz. **Hogyan oldja meg az OmniRoute:** - 9 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⚙️ 22. "Üzemeltetési vezérlőkre van szükségem újratelepítés nélkül"
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🔄 23. "Szükségem van élő A2A-feladatok életciklusának láthatóságára és törlésére"
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🌊 24. "Aktív adatfolyam-metrikákra van szükségem A2A terheléshez"
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🪪 25. "Szabványos ügynökfelderítésre van szükségem az ügyfelek számára"
A külső klienseknek és hangszerelőknek géppel olvasható metaadatokra van szükségük a bevezetéshez. **Hogyan oldja meg az OmniRoute:** - Ügynökkártya közzétéve: `/.well-known/agent.json` - 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🧭 26. "Protokoll felfedezhetőségre van szükségem az UX termékben"
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🧪 27. "Végponttól végpontig terjedő protokoll-érvényesítésre van szükségem valódi kliensekkel"
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📡 28. "Egységes megfigyelhetőségre van szükségem minden interfészen"
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💼 29. "Egy futási környezetre van szükségem a proxyhoz + eszközökhöz + ügynök hangszereléshez"
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🚀 30. "Az ügynöki munkafolyamatokat ragasztókód szétszóródása nélkül kell szállítanom"
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)🧩 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 a `omniroute_get_health`. 3. Futtassa a `omniroute_list_combos`. 4. Nyissa meg a `/dashboard/mcp` oldalt 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`🤝 A2A beállítás (Agent2Agent)
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🧪 Végpontok közötti protokoll érvényesítés
É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💳 Előfizetési szolgáltatók
### Claude Code (Pro/Max) ```bash Dashboard → Providers → Connect Claude Code → OAuth login → Auto token refresh → 5-hour + weekly quota tracking Models: cc/claude-opus-4-6 cc/claude-sonnet-4-5-20250929 cc/claude-haiku-4-5-20251001 ``` **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) ```bash Dashboard → Providers → Connect Codex → OAuth login (port 1455) → 5-hour + weekly reset Models: cx/gpt-5.2-codex cx/gpt-5.1-codex-max ``` #### Codex fióklimit-kezelés (5 óra + heti) Minden Codex-fiók rendelkezik házirend-kapcsolókkal a `Dashboard -> Providers`-ban: - `5h` (BE/KI): érvényesítse az 5 órás ablak küszöbszabályát. - `Weekly` (BE/KI): érvényesítse a heti ablak küszöbére vonatkozó szabályzatot. - 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` + `Weekly ON`: a fiók kimarad, ha bármelyik ablak eléri a küszöböt. - `5h OFF` + `Weekly ON`: csak heti használat blokkolhatja a fiókot. - `5h ON` + `Weekly OFF`: csak 5 órás használat blokkolhatja a fiókot. - `resetAt` sikeres: a fiók automatikusan újra rotációba lép (nincs kézi újraengedélyezés). ### Gemini CLI (INGYENES 180 000/hó!) ```bash 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 ```bash Dashboard → Providers → Connect GitHub → OAuth via GitHub → Monthly reset (1st of month) Models: gh/gpt-5 gh/claude-4.5-sonnet gh/gemini-3-pro ```🔑 API kulcs szolgáltatók
### NVIDIA NIM (INGYENES fejlesztői hozzáférés – 70+ modell) 1. Regisztráljon: [build.nvidia.com](https://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](https://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](https://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](https://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](https://open.bigmodel.cn/) 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álat:** `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](https://www.minimax.io/) 2. Szerezze be az API-kulcsot 3. Irányítópult → API-kulcs hozzáadása **Használat:** `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](https://platform.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 (5 INGYENES modell OAuth-on keresztül) ```bash Dashboard → Connect iFlow → iFlow OAuth login → Unlimited usage Models: if/kimi-k2-thinking if/qwen3-coder-plus if/glm-4.7 if/minimax-m2 if/deepseek-r1 ``` ### Qwen (4 INGYENES modell az eszközkódon keresztül) ```bash Dashboard → Connect Qwen → Device code authorization → Unlimited usage Models: qw/qwen3-coder-plus qw/qwen3-coder-flash ``` ### Kiro (Claude INGYENES) ```bash 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 ```bash 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`: ```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 ``` ### 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:** Hozzon létre/szerkesszen `opencode.json` projektjének gyökérkönyvtárában: ```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:** Adja hozzá az OmniRoute `/v1/models` végpontjában elérhető bármely modellt a `models` szakaszhoz. Használja a `provider/model-id` formátumot az OmniRoute irányítópultján.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 **Az irányítópult/API portok hibásak** - `PORT` a kanonikus alapport (és alapértelmezés szerint API-port) - Az `API_PORT` csak az OpenAI-kompatibilis API figyelőt írja felül - Az `DASHBOARD_PORT` csak az irányítópultot/Next.js figyelőt írja felül - Állítsa be a `NEXT_PUBLIC_BASE_URL`-t az irányítópultjára/nyilvános URL-címére (OAuth-visszahívásokhoz) **Felhő szinkronizálási hibák** - Ellenőrizze, hogy `BASE_URL` mutat a futó példányra - Ellenőrizze `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ó** - `ENABLE_REQUEST_LOGS=true` beállítása 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 távoli szerveren > **⚠️ Fontos az OmniRoute-ot VPS-en, Dockeren vagy bármely távoli szerveren futtató felhasználók számára** #### Miért nem működik az Antigravity / Gemini CLI OAuth távoli szervereken? 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 szolgáltatást (pl. `https://omniroute.myserver.com`), a Google a következőkkel utasítja el a hitelesítést: ``` Error 400: redirect_uri_mismatch ``` #### Megoldás: Állítsa be saját OAuth hitelesítő adatait Létre kell hoznia egy **OAuth 2.0 ügyfél-azonosítót** a Google Cloud Console-ban a szerver URI-jával. #### Lépésről lépésre **1. Nyissa meg a Google Cloud Console-t** Ugrás ide: [https://console.cloud.google.com/apis/credentials](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` értéket 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** A `.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 következőre: `https://your-server.com/callback`. --- #### Ideiglenes megoldás (egyéni hitelesítő adatok nélkül) 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. Az engedélyezés után a Google megpróbál átirányítani a `localhost` címre (ami a távoli szerveren meghiúsul) 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. ---🇧🇷 Versão em Português
#### 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](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): ```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` 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.Kattintson a technológiai verem részleteinek kibontásához
- **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** a `src/` és `open-sse/` között (nulla `any` 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) - **Dokker**: [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
A ❤️ segítségével készült a 24/7 kódoló fejlesztőknek
omniroute.online
omniroute.online