README (Magyar)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

🚀 OmniRoute — Az ingyenes AI-átjáró

OmniRoute — Soha ne hagyd abba a kódolást. Minden AI-eszköz → 380 szolgáltató — több mint 150 ingyenes — egyetlen végponton keresztül. Claude Code, Codex, Cursor, Cline, Copilot és Antigravity INGYENES Claude / GPT / Gemini modellekhez automatikus tartalékra váltással. Az RTK + Caveman rétegzett tömörítése 15–95%-kal csökkenti a tokenhasználatot (átlagosan ~89%) — soha nem éred el a korlátokat. 380 AI-szolgáltató · több mint 150 ingyenes csomag · ~1,62 milliárd ingyenes token/hó · 20 útválasztási stratégia · kezdés $0-ért.

💰 ~1,62 milliárd token / hónap külső szolgáltatók ingyenes csomagjaiból

Használd a saját szolgáltatói fiókjaidat. Ez a külön-külön igénybe vehető, külső szolgáltatók által kínált ingyenes csomagok becsült összesített mennyisége, nem pedig az OmniRoute által biztosított tokenkeret. Regisztrálj, szerezd be a szükséges hitelesítő adatokat, és csatlakoztasd az általad használható szolgáltatókat; minden szolgáltató maga szabályozza a korlátait, az elérhetőségét és a feltételeit.

Az ingyenes csomagok kézi összefűzése körülményes — több tucat SDK, több tucat sebességkorlát, és fogalmad sincs arról, valójában mekkora keret áll rendelkezésedre. Az OmniRoute 484 ingyenes csomagbejegyzést tart nyilván 34 ismétlődő keretkulcshoz, és a kiemelt tokenmennyiséget a 17 közzétett, pozitív havi kerettel rendelkező készletből, valamint öt modellenkénti Groq-korlátból számítja ki, a megosztott készleteket deduplikálva. A csak regionális személyazonosság-ellenőrzés után elérhető kereteket (jelenleg: ModelScope) külön jelenítjük meg: +~6M regionális személyazonosság-ellenőrzés mögött, és ezeket soha nem adjuk hozzá a kiemelt értékhez. Az eredmény mindig látható marad az irányítópulton (/dashboard/free-tiers).

Az élő /dashboard/free-tiers oldal animált összefoglalója. A teljes módszertan (készletek deduplikálása, jóváírási szintek, szolgáltatói feltételek): docs/reference/FREE_TIERS.md.

_{Ezeket az adatokat kéthetente újra ellenőrizzük az élő katalógus alapján, és mindkét irányba változhatnak — ha egy szolgáltató megszüntet egy ingyenes csomagot, a szám csökken; ha megjelenik egy új, növekszik. Mindig azt tesszük közzé, amit a katalógus ténylegesen kiszámít, soha nem egy felfelé kerekített legjobb esetet.}

⭐ Adj csillagot a repónak, ha az OMNIROUTE segített pénzt megtakarítani és megkönnyítette a munkádat.

💬 Csatlakozz a közösséghez

👋 Kövesd a karbantartót — értesülj elsőként az új szolgáltatókról, kiadásokról és tippekről:

Kérdések, szolgáltatói tippek, ütemterv és támogatás → Discord · Telegram · WhatsApp 🌍 Globális / 🇧🇷 Brazília / Portál

📈 Az átjáró folyamatosan növekszik

	v3.8.50	v3.8.51	`v3.8.53+`
🌐 szolgáltatók	352	358	380
🧠 Egyedülálló chat modell IDs	1320	1374	1475
🖼️ Modality Bridge	🆕 vision + audio + videó	✓	✓
📡 Radar ingyenes katalógus	🆕 opt-in	✓	✓
⚖️ Kvóta-tudatos ütemezés	🆕 Quota-Share	✓	✓
📊 Quota telemetria	🆕 élőben	✓	✓
🧰 Fej nélküli mód	—	—	🆕 `serve --headless`
🛤️ LTS rail infra	—	—	🆕 kioldó csatornák
🔎 Modell felfedezés API	—	—	🆕 `/v1/models/query`

→ Útiterv — a v3.9.0 LTS felé vezető vasút

🧩 Elérhető

🚀 Kezdés	🚀 Gyors kezdés	📦 Telepítés	🆓 Szolgáltató csatlakoztatása
💡 Ismerkedés	💥 Az ígéret	🤔 Miért az OmniRoute?	🏆 Mitől különleges?
⚙️ Funkciók	🎯 Kombinációk	🌐 Szolgáltatók	🔌 CLI és MCP
	🗜️ Tömörítés	🖥️ Hol fut?	🔒 Privát
👀 Megtekintés	🎬 Működés közben	✨ Újdonságok	🤖 Kompatibilis CLI-k
💚 Támogatás	💚 Támogatás / Adományozás	💬 Közösség	💖 Szponzorok
📦 Projekt	🛠️ Technológiai rendszer	📖 Dokumentáció	👥 Közreműködők

🌐 67 nyelven

🆓 Telepítés, szolgáltató csatlakoztatása, majd irányítás egyetlen végponton keresztül

# After connecting a provider, copy your OmniRoute key from Dashboard → Endpoints:
curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{Az auto értékhez jogosult útvonal szükséges. Egy friss telepítésnek lehet, hogy nincs jogosult kulcs nélküli célpontja, és egy kulcs nélküli szolgáltató elutasíthatja a harmadik féltől származó klienseket. A tos: avoid jelöléssel ellátott szolgáltatók – köztük a Kiro – alapértelmezés szerint ki vannak zárva az automatikus útvonalválasztásból; egy fiók csatlakoztatása nem írja felül ezt a beállítást. A szolgáltató kiválasztása előtt lásd a Free Tiers Guide dokumentumot.}

_{📦 Másolható-beilleszthető gyorsindító szkriptek Python, Node.js, PHP és cURL nyelvekhez → examples/quickstart/}

💥 Az ígéret

🤔 Miért az OmniRoute?

OmniRoute kérésfolyam: az IDE-d vagy CLI-ed (Claude Code, Cursor, Cline…) egyetlen helyi végpontot hív (http://localhost:20128/v1); az OmniRoute Smart Router (RTK + Caveman tömörítés, 20 útvonalválasztási stratégia, áramköri megszakítók, TLS-stealth, MCP, A2A, guardrail-ek) 4 szolgáltatói szinten keresztül tud visszaállni, amíg egy jogosult, egészséges célpont elérhető — 1. szint Előfizetés, 2. szint API-kulcs, 3. szint Olcsó és 4. szint Ingyenes.

🤝 Támogatnak nyílt forráskódú barátaink

Szeretnél csatlakozni nyílt forráskódú barátként? Ezek azok a cégek, amelyek támogatják a nyílt forráskódot, és segítenek az OmniRoute működésében – és nyilvánosan elmondjuk, hogy minden tőlük kapott token mire megy. Keress minket: diegosouza.pw@outlook.com

Kimi
_{Moonshot AI} Köszönjük a Kimi (Moonshot AI)-nak, alapító nyílt forráskódú barátunknak, hogy támogatja ezt a projektet! A Kimi az AI labor a nyílt súlyú K2 és K3 modellcsaládok mögött — a Kimi K3 1M-token kontextusablakot, natív látást és határszintű kódolást biztosít a zárt modellek árának töredékéért, és azonnal működik a Claude Code, Codex és minden kódoló eszközzel, amit az OmniRoute kiszolgál.

Mire használja a Kimi támogatását: A Kimi API kreditek az OmniRoute AI-val validált kiadási folyamatát táplálják — a Kimi K3 által működtetett egyesítési validálás fázist, amely minden pull requestet áttekint, mielőtt kiadják — plusz a napi funkciófejlesztést. Az első osztályú Kimi támogatás mindkét sínen elérhető: a közvetlen Kimi API (kimi-k3) és a Kimi Code kódolási terv (OAuth és API kulcs). Az OmniRoute az első brazil nyílt forráskódú projekt a Kimi támogatási programjában. Szerezzen Kimi API kulcsot 15% extra kredittel →

Cheaper Inference
_{cheaperinference.com} Köszönjük a Cheaper Inference-nek, az OmniRoute nyílt forráskódú barátjának, hogy támogatja ezt a projektet! A Cheaper Inference egy költség-rangsorolt átjáró, amely 42 határmodellt – Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok és MiniMax – értékesít egy OpenAI-kompatibilis végpont mögött, minden kérést a legolcsóbb jogosult szolgáltatóhoz irányítva anélkül, hogy valaha is többet számolna fel, mint a modellgyártó listaára.

Első osztályú támogatás az OmniRoute-ban: Chat Completions, a natív /v1/responses végpont, látás, eszközhívás és 3 képmodell (grok-imagine, nano-banana-pro, nano-banana-2, elérhető mint cheaperinference/<model>). Szerezzen API kulcsot →

_{Az aff=omniroute címkével ellátott linkek partnerlinkek. Ezek a projektet finanszírozzák Önnek többletköltség nélkül.}

_{🎟️ Partneri promóció — ingyenes regisztrációs kuponok olyan szolgáltatóktól, amelyeket nem szponzorálunk (kattintson a kibontáshoz)}

_{Ez a szakasz csak ajánló/kuponkódokról szól. A szponzorált partnerségek a fenti 🤝 Támogatnak nyílt forráskódú barátaink részben találhatók. Az OmniRoute-nak nincs szponzorálási vagy partnerségi kapcsolata az itt felsorolt szolgáltatókkal – ezek nyilvános kuponok, amelyeket bárki használhat.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — partneri regisztráció · 100 dollár ingyenes kredit regisztrációkor (ingyenes szerver, magasabb késleltetésre számíthat – tesztelésre a legjobb, nem éles környezetbe). Első osztályú támogatás az OmniRoute-ban v3.8.50 óta: Chat Completions, az Anthropic-kompatibilis vezetékes formátum és az OpenAI-kompatibilis útvonal. Elérhető modellek: claude-opus-4-8, claude-opus-5, gpt-5.6-sol és még sok más. Szerezze meg a 100 dollárját →}

_{⚠️ Partneri link – Az OmniRoute-nak nincs szponzorálási vagy partnerségi kapcsolata ezzel a szolgáltatóval.}

_{Ismer más szolgáltatót, amely nagylelkű ingyenes regisztrációs kupont kínál, ami az OmniRoute felhasználóinak előnyére válik? Nyisson egy hibajegyet, és hozzáadjuk ide.}

🎯 Kombók — A zászlóshajó

A kombó olyan modelllánc, amelyen az OmniRoute automatikusan végzi az útválasztást. Ha elfogy a kvóta, meghibásodik egy szolgáltató, vagy megugranak a költségek, a kombó továbbléphet a következő megfelelő és működőképes modellre. 🛡️

⚡ Konfiguráció nélkül — csak használd az `auto` értéket

Nem kell kombót létrehoznod. Állítsd a modelledet auto értékre (vagy valamelyik változatára), és az OmniRoute a csatlakoztatott szolgáltatóidból valós időben pontozott virtuális kombót hoz létre:

Modellazonosító	Mire optimalizál
`auto`	🎯 Kiegyensúlyozott alapértelmezés (LKGP — ragaszkodik a legutóbbi jól működő szolgáltatóhoz)
`auto/coding`	🧑💻 A minőséget előnyben részesítő súlyozás kódgeneráláshoz
`auto/fast`	⚡ Először a legalacsonyabb késleltetés
`auto/cheap`	💰 Először a tokenenként legolcsóbb
`auto/subscription`	🎟️ Csak a már kifizetett előfizetési kvóta — zárt hibakezelés, soha nincs számlázható tartalékmegoldás (útmutató)
`auto/thrifty`	🪜 Először a csomag kvótája, majd fokozatosan a legolcsóbb fizetős lehetőségek — a visszaállítás után ismét a csomagot használja (útmutató)
`auto/offline`	🔋 Először a legnagyobb kvóta- és sebességkorlát-tartalék
`auto/smart`	🔭 A minőséget helyezi előtérbe + 10%-os felderítés a jobb modellek megtalálásához
`auto/lkgp`	📌 Kifejezett ragaszkodás a legutóbbi jól működő szolgáltatóhoz
`auto/chaos`	🧪 Párhuzamos szétosztás egy modellpanelre (szolgáltatónként egy, alapértelmezés szerint 5), és egyetlen választ ad vissza; panelmodellenként egy felsőbb szintű hívás, nem hibabefecskendezés

🔀 Vagy készíts sajátot — 20 útválasztási stratégia

Mind a 20 stratégia — szabadon kombinálhatók a kombó egyes lépéseiben:

#	Stratégia	Működés
1	`priority`	Az első célpontot előnyben részesítő rendezett lista — mindegyiket kimeríti, mielőtt a következőre lép 🥇
2	`fill-first`	Teljesen felhasználja az egyes célpontok kvótáját, mielőtt továbblépne
3	`weighted`	Súlyozott véletlenszerű kiválasztás a célpontonkénti súly alapján
4	`round-robin`	Sorrendben, körkörösen halad végig a célpontokon
5	`p2c`	Véletlenszerű terheléselosztás két lehetőség közötti választással
6	`least-used`	A jelenleg legkisebb terhelésű célpontot választja
7	`random`	Egyenletes véletlenszerű kiválasztás (duplikációk eltávolításával)
8	`strict-random`	Véletlenszerű kiválasztás az ismétlődések eltávolítása nélkül 🎲
9	`cost-optimized`	Minimalizálja a kérésenkénti költséget az élő katalógus árai alapján 💸
10	`headroom`	A legtöbb fennmaradó kvótával rendelkező célpontot választja
11	`quota-weighted`	Kihagyja a kimerített fiókokat, majd a fennmaradó kvóta ÷ folyamatban lévő terhelés arányában választ — a meglévő beszélgetések az eredeti célponthoz rögzítve maradnak ⚖️
12	`reset-window`	Azt a célpontot részesíti előnyben, amelynek kvótaablaka a leghamarabb áll vissza
13	`reset-aware`	A kvóta visszaállítási ideje alapján rangsorol — először a rövid időablakok 📊
14	`context-relay`	Hosszú beszélgetéseknél átadja a kontextust a célpontok között 🧠
15	`context-optimized`	Az aktuális kontextusmérethez legjobban illő célpontot választja
16	`cache-optimized`	Minden újrafelhasználható promptelőtagot ugyanahhoz a fiókhoz rögzít — maximalizálja a promptgyorsítótár találatait 🎯
17	`lkgp`	Legutóbbi ismerten működő útvonal — az utolsó sikeres szolgáltatóhoz rögzít, majd szükség esetén a szabályokra vált
18	`auto`	16 tényezős, valós idejű pontozás minden kapcsolaton 🤖
19	`fusion`	Szétosztja a kérést egy modellpanelre, majd egy bíráló egyetlen választ állít össze 🧬
20	`pipeline`	Lépések láncolata — minden célpont kimenete a következő bemenete lesz 🔗

_{Az Auto-Combo motor minden jelöltet 16 tényező (állapot, kvóta, költség, késleltetés, feladathoz való illeszkedés, minőség, munkamenet elérhetősége…) alapján pontoz — lásd: docs/routing/AUTO-COMBO.md.}

🧱 Beépített ellenálló képesség (3 független réteg)

_{📖 Auto-Combo motor · Ellenálló képességi útmutató}

🏆 Miben emelkedik ki az OmniRoute

_{📊 Teljes módszertan és funkciónkénti részletek a 9router, az OpenRouter, a CLIProxyAPI és a LiteLLM megoldásokkal összehasonlítva → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md}

💚 Az OmniRoute támogatása

Az OmniRoute MIT-licencű, és nyíltan karbantartott projekt. Ha időt vagy pénzt takarít meg Önnek, így segíthet megőrizni a függetlenségét — válassza az Önnek megfelelő lehetőséget. A szponzoráció soha nem befolyásolja az útválasztási prioritást; láthatóságot vásárol, nem jobb helyezést.

⭐ Adjon csillagot a tárolónak	Ingyenes — valóban növeli a láthatóságot	Adjon csillagot az OmniRoute-nak
🐙 GitHub Sponsors	Egyszeri vagy havi · nulla platformdíj	github.com/sponsors/diegosouzapw
☕ Ko-fi	Gyors, egyszeri támogatás, a támogatónak nem kell regisztrálnia	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Kis, kötetlen gesztus	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Ismétlődő · nonprofit · nyílt forráskódú	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazília)	Azonnali, díjmentes	a kulcs és a QR-kód alább található
₿ Kriptovaluta	BTC · ETH · USDT-TRC20 · USDC-Solana	a címek alább találhatók

🇧🇷 PIX — azonnali, díjmentes (Brazília)

Kulcs (véletlenszerű): 5d865059-bc44-483a-962d-43ceb80126eb

Másolható és beilleszthető Pix-kód:

00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD

₿ Kriptovaluta — BTC · ETH · USDT-TRC20 · USDC-Solana (kattintson a kibontáshoz)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Minden kriptovalutát kizárólag a feltüntetett hálózaton küldjön — ha nem a megfelelő hálózatot használja, elveszítheti az összeget.}

🐛 Hibát talált, vagy visszajelzése van? Nyisson egy beszélgetést.

Fejlesztői megjegyzések: A projekt a fejlesztők kényelme érdekében létrehozhat egy helyi .env fájlt az npm install/postinstall során. Ezt a fájlt a rendszer szándékosan figyelmen kívül hagyja a .gitignore segítségével (lásd: .gitignore), és soha nem szabad commitolni — ha véletlenül mégis commitolta, cserélje le az összes nyilvánosságra került titkos adatot, és távolítsa el a fájlt az előzményekből. A helyi környezeti fájlok és titkos adatok kezelésével kapcsolatos útmutatásért lásd: docs/DEVELOPER-ENVIRONMENT.md.

📡 OmniRoute Radar

A fő, ingyenes csomagra vonatkozó érték továbbra is ~1,62 milliárd token/hó a fent dokumentált, készletek között duplikációmentesített katalógus alapján. A szolgáltatók ideiglenes regisztrációs jóváírásai ezen felül az első havi keretet ~2,22 milliárdra növelhetik. A Radar egy opcionális, aláírt katalógusréteg azok számára, akik az OmniRoute kiadásai között naprakészebb információkat szeretnének az ingyenes modellek elérhetőségéről; a közösségi katalógus és minden meglévő ingyenes funkció továbbra is ingyenes marad.

A támogatók hozzáférhetnek az élő katalógushoz és további szolgáltatói lehetőségekhez. Ennek különálló, változó felső határa a szolgáltatók elérhetőségétől függően legfeljebb körülbelül 3 milliárd token/hó. Ez a felső határ nem jelent garanciát: a szolgáltatók bármikor módosíthatják a kvótákat, a jogosultsági feltételeket, a modelleket vagy a régiókat.

A Radar használata opcionális, és kizárólag GET-kéréseket alkalmaz. Az OmniRoute kliens nem tölt fel promptokat, forgalmi adatokat, szolgáltatói konfigurációt, használati telemetriát vagy a közlemények elvetésének helyi állapotát. A jogosultsági feltételekről és az aktuális katalógusról a radar.omniroute.online/planos oldalon tájékozódhat.

✨ Újdonságok

Legutóbbi fénypontok a v3.8.20 → v3.8.53 verzióból. Teljes előzmény: CHANGELOG.md.

⚖️ quota-weighted útvonalválasztás — a 20. kombó-stratégia kihagyja a kimerült fiókokat, majd a többiek közül a maradék kvóta ÷ folyamatban lévő terhelés arányában választ, miközben a meglévő beszélgetések rögzítve maradnak. → Auto-Combo
🧰 Headless mód — az omniroute serve --headless (vagy OMNIROUTE_HEADLESS=1) csak a /v1/* proxy motort futtatja, az irányítópult és a csak-irányítópult alrendszerek kikapcsolásával. → Headless mód
🔎 Modellfelderítés — a /v1/models szűr képesség, kontextus, fajta és szöveg szerint, a POST /v1/models/query pedig egy rövid, determinisztikus szűkített listát ad vissza ugyanazzal a kulcsonkénti láthatósággal. → API-referencia
🔑 Kulcsonkénti útvonalvezérlés — rögzíts egy API-kulcsot egyetlen modellhez vagy kombóhoz a forcedModel segítségével, és atomikusan add hozzá vagy távolítsd el egy kulcs modelljeit és kombóit (/api/keys/{id}/access). → API-referencia · OpenAPI
🛡️ Finomabb PII-vezérlők — típusonkénti kiválasztás, akár 20 validált egyéni maszkolási minta és típusonkénti észlelési számlálók; maga a maszkolás továbbra is opt-in. → Guardrails
🌍 67 nyelv — irányítópult, dokumentáció-tükrök és CLI, ahol az npm run i18n:add-locale egyetlen paranccsal mindenhol hozzáad egy nyelvet. → i18n útmutató
🎛️ OmniConductor — bejövő A2A delegálás az ügynökflottádhoz, Conductor készségek az Agent Cardon, és egy irányítópult-panel Faro push-to-talk hangcsevegéssel. → A2A szerver
🛂 Adaptív beléptetés és túlterhelés-védelem — a nagy súlyú csevegési kérések sorba állnak 503 helyett, atomi RPM gördülő lease-ekkel kapcsolatonként. → Reziliencia-útmutató
🗂️ Kanonikus /v1/models sorrend — szolgáltatónként egy összefüggő, szolgáltató szerint csoportosított blokk (a kombók elöl rögzítve), minden katalógusforrás esetében stabil. → API-referencia
🗜️ Tömörítés megerősítése — alapértelmezés szerint bekapcsolt inflation guard, Caveman csomagok DE / FR / JA + kínai (wényán) nyelvhez, RTK szűrők Gradle & .NET-hez. → Tömörítés
💸 Őszinte átalánydíjas költség — az előfizetéses / coding-plan szolgáltatók $0-ként jelennek meg a költség-analitikában; a büdzsé, a kvóta és az útvonalválasztás továbbra is becsül. → API-referencia
⚖️ Quota-Share útvonalválasztás — egy megosztott fiók kvótájának méltányos felosztása a közös kulcsok között, munkakonzerváló módon, így a tétlen szeletek kölcsönadásra kerülnek. → Reziliencia-útmutató
🤖 Egyparancsos CLI/ügynök-beállítás — 15 regisztrált setup-* parancs; az omniroute run 7 CLI-t indít (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); az omniroute configure 11 célt támogat interaktív szolgáltató+modell-választóval és kontextusonkénti kedvencekkel. → CLI-integrációk
🛰️ Távoli mód — távoli OmniRoute vezérlése hatókörözött tokenekkel (connect / contexts / tokens) + egy antigravity OAuth segéd VPS-telepítésekhez. → Távoli mód
🧭 Okosabb automatikus útvonalválasztás — auto/<category>:<tier> kombók, Fusion (modellpanel + bíró), feladattudatos útvonalválasztás, kérésenkénti modell / mód / USD-büdzsé felülírások. → Auto-Combo
🗜️ Bővíthető tömörítés — 12 komponálható motor + Compression Studios: LLMLingua-2, kétszintű Ultra, omniglyph, lépésenkénti hűségkapu, GCF v3.2, húzd-és-áthelyezd szerkesztő. → Tömörítés
🕵️ Átlátszó MITM-visszafejtés (TPROXY) — a proxy környezeti változókat figyelmen kívül hagyó CLI-k elfogása, SNI-nkénti CA + trust-store telepítővel. → MITM/TPROXY
💸 Költség-telemetria mindenhol — X-OmniRoute-* költség/használat fejlécek minden végponton, cache-HIT megtakarítás fejléc, kulcsonkénti USD-költési kvóták. → API-referencia
🧠 Általad vezérelt memória — alapértelmezés szerint kikapcsolva, opcionális int8 vektor-kvantálás + tipizált lecsengés, kérésenkénti x-omniroute-no-memory. → Memória
🛡️ Biztonság — prompt-injection védelem minden LLM-útvonalon (red-team csomag), opcionális hitelesítőadat-maszkoló guardrail (mindkét irányban kitakarja a kiszivárgott API-kulcsokat/titkokat), ingyenes DuckDuckGo végső webes keresés, és opcionális OIDC bejelentkezési kapu az irányítópulthoz (a jelszavas bejelentkezés mindig elérhető marad). → Guardrails
🖼️ Új végpontok — a /v1/ocr (Mistral OCR) és a /v1/audio/translations (Whisper-stílusú) teljessé teszi a médiával kapcsolatos felületet. → API-referencia
🎨 Kép / videó / hang generálás — egyetlen API a médiához: xAI Grok Imagine & Novita AI videó, ComfyUI, Magnific, Adobe Firefly, Segmind, valamint beszédszolgáltatók, például az ElevenLabs. → API-referencia
🌍 Telepítés és üzemeltetés — reverse-proxy basePath, böngészőnyelv automatikus felismerése, kulcsonkénti eszközkövetés, root nélküli MITM trust, zh-TW lokalizáció. → Környezet
🤝 Több szolgáltató és ügynök — felhőügynökök (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) böngészős + OAuth bejelentkezéssel, Ollama első osztályú kártya, Claude Opus 5 & Sonnet 5, hivatalos Kimi partnerség (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… és egy frissített 380 szolgáltatós katalógus. → Szolgáltatók
📡 Útvonalválasztási átláthatóság — minden válasz hordoz egy X-OmniRoute-Decision fejlécet, amely megnevezi az őt kiszolgáló stratégiát/szolgáltatót/késleltetést; egy új cache-optimized kombó-stratégia + Auto-Combo cacheAffinity tényező visszairányítja az ismétlődő kéréseket a gyorsítótárazott előtagot tartó kapcsolathoz; és egy csak olvasható /v1/auto-combo/{channel}/candidates végpont feltárja egy auto/* csatorna élő jelöltkészletét. → Auto-Combo
⚡ Helyi teljesítmény és infrastruktúra — egykattintásos helyi Redis, Cloudflare Workers / Deno Deploy relay-telepítők, valamint Bifrost és Mux felügyelt beágyazott szolgáltatásként. → Beágyazott szolgáltatások
🧩 Szintén a csomagban — bővítménykeretrendszer és piactér, Omni/Agent/GitHub készségkeretrendszerek, Obsidian vault integráció (22 MCP-eszköz), OpenAI-kompatibilis Batch és Files API-k, szemantikus válaszgyorsítótár, játékosítás ranglistákkal, ACP-ügynökfelderítés (15 beépített ügynök), ütemezett naplóexport BigQuery-be, auto/chaos párhuzamos többmodelles szétosztás, Telegram bot híd, alkalmazáson belüli verziókezelő és LMArena-ELO ingyenes szolgáltatói rangsorok. → Dokumentáció

🤖 Kompatibilis CLIs és kódoló ügynökök

Egy konfiguráció — http://localhost:20128/v1 — és** minden** AI IDE vagy CLI ingyenes és olcsó modelleken fut.

_{Claude kód}	_{Codex CLI}	_Cline	_kilokód	_{állatkerti kód}	_Folytatás
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{gyári droid}	_{Copilot CLI}	_{Cursor CLI}		_Pi	_{Grok Build}
_{Hermes ügynök}	_OpenClaw	_liba	_{nyílt tolmács}	_{Warp AI}	_deyin.ai

＋ -vel is működik · Agent Deck · Kiro · Parancskód · Antigravity · Windsurf · AMP · bármilyen OpenAI-kompatibilis eszköz

_{📖 Szerszámonkénti beállítás mind a 38 eszközhöz (27 CLI kód + 11 CLI ügynöke) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode plugin → @omniroute/opencode-provider}

Indítsa el a támogatott CLI OmniRoute keresztül egyetlen paranccsal — nem írnak konfigurációs fájlokat, a hitelesítő adatokat folyamatonként fecskendezik be, a Qwen/Gemini eldobható, elszigetelt otthont kap:

omniroute run claude   --model openai/gpt-5.4          # Claude Code
omniroute run codex    --model glm/glm-5.2             # OpenAI Codex CLI
omniroute run aider    --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose    --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen     --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini   --model glm/glm-5.2 -- --skip-trust -p "reply OK"

# Or pick provider+model interactively and write the tool's own config:
omniroute configure codex          # also: claude opencode qwen aider goose gemini cline continue kilo 5dive

Minden parancs tiszteletben tartja az aktív távoli környezetet (omniroute connect <host>), --dry-run a pontos env/args előnézetét végrehajtás nélkül tekinti meg, --api-key-env NAME pedig távol tartja a titkokat a shell előzményeiből. → CLI integrációk

🌐 380 AI-szolgáltató — közülük 153 a katalógus szerint ingyenes

380 regisztrált szolgáltató a kanonikus chat-, média-, keresési, helyi, felhőügynök- és rendszergyűjteményekben, köztük 153 olyan, amely hasFree: true felderítési metaadatot hordoz. A chatmodellek nyilvántartása 239 szolgáltatót / 3 059 különálló szolgáltató–modell-párt / 1 475 nyers modellazonosítót fed le; a különálló, ingyenes kereteket tartalmazó katalógusban 471 modellenkénti sor, 34 megújuló keret és 52 megújuló/kulcs nélküli, örökre ingyenes szolgáltató található. Ezek a nevezők szándékosan eltérnek; a definíciók és a keretek duplikációját kiszűrő számítások a Szolgáltatói referenciában és az Ingyenes csomagok dokumentumban találhatók.

🏢 Minden jelentős labor — egyetlen végponton keresztül

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…és további több mint 350 — minden ikon élőben töltődik be az irányítópult szolgáltatói katalógusából. 📖 Szolgáltatói referencia}

🆓 Örökre ingyenes — $0, bankkártya nélkül

OpenCode Zen _{DeepSeek V4, Nemotron 3 Nincs tokenkorlát}	Kilo Code _{Automatikus útválasztó, Tencent Hy3 Örökre ingyenes}	Requesty _{GPT-OSS 120B, Nemotron Örökre ingyenes}	SiliconFlow _{DeepSeek V3.2 / R1 Ingyenes csomag}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Örökre ingyenes}	Baidu ERNIE _{ERNIE 4.0 Örökre ingyenes}
Qoder AI _{Qwen3-Max, Kimi-K2 Korlátlanul INGYENES}	Pollinations _{GPT, Llama, Claude Nincs szükség kulcsra}	Cloudflare AI _{50+ modell 10 000 neuron/nap}	NVIDIA NIM _{GLM, MiniMax ~40 RPM ingyenesen}	Cerebras _{GLM 4.7, GPT-OSS Egyszeri 5 $-os jóváírás; bankkártya szükséges}	OpenRouter _{:free modellek +10 $ → magasabb RPM}

📖 Teljes, géppel olvasható katalógus → docs/reference/PROVIDER_REFERENCE.md

🖥️ Ahol OmniRoute fut – bárhol

Ugyanaz az alkalmazás, a géped, a te szabályaid. Globális npm telepítéstől a** a telefonját** Termuxon keresztül.

Windows / macOS / LinuxOmniRouteTray)

Platform		telepítése Fénypontok
📦 npm (globális)	`npm telepítés -g omniroute`	Egy parancs, tetszőleges OS
⚡ Bun (globális)	`bun add -g omniroute`	Ugyanaz a rendszerleíró adatbázis tarball, gyorsabban telepíthető
🐳 Docker	`dokkoló fut … diegosouzapw/omniroute`	Többíves AMD64 + ARM64
🖥️ Desktop (Electron
`npm futás elektron:build`	Natív ablak + rendszertálca
🎩 Menüsor
`brew install --cask zoispag/tap/omniroute-tray`	Felügyeli & automatikus frissítését a szerveren — macOS
💪 ARM	natív `arm64`	Raspberry Pi, ARM szerverek, Apple Silicon
📱 Android (Termux)	`pkg nodejs && npx -y omniroute`	fut a telefonon , 24/7, nincs
📲 PWA	„Hozzáadás a kezdőképernyőhöz”	Teljes képernyős, offline, böngészőből telepíthető
🧩 OpenCode modul	`@omniroute/opencode-provider`	Natív OpenCode integráció
🤖 VS kód Copilot Chat	telepítés OmniCopilot bővítmény	Minden OmniRoute -modell a natív Copilot Chat-választóban – stabil & Bennfentesek
🛠️ Forrásból	`npm telepítés && npm futtatása dev`	Feltörni, hozzájárulás

_{📖 Docker útmutató · Asztali · Menüsor tálca · Termux · PWA · OpenCode}

🧩 Új: OmniRoute VS Code natív Copilot chatjében

Nincs új oldalsáv, nincs új chat UI – minden OmniRoute modell megjelenik közvetlenül aCopilot Chat modellválasztó, amelyet már használ . VS Code 1.122 óta a szolgáltatói modellek GitHub bejelentkezés vagy Copilot -előfizetés nélkül működnek – ügynöki mód, eszközhívás és látás, ingyenesen.

Telepítse a** OmniCopilot** kiterjesztés, mutasson rá OmniRoute szerverre (alapértelmezetten localhost:20128), majd nyissa meg Copilot Chat → modellválasztót →** Modellek kezelése…** →OmniRoute .

< td igazítás ="balra">VS kód — stabil & Bennfentesek < td igazítás ="balra">Cursor, Windsurf, VSCodium, Theia, Giqqr-server, AntigravityKiro…

Store	Link	Működik a
🧩 VS Code Marketplace	Telepítse →
🔓 VSX Registry megnyitása	Telepítse →

A szerkesztő belsejéből: nyissa meg a** Kiterjesztések** megtekintés, keresés** "OmniRoute"** , kattintson** Telepítés** - mindkét üzletben ugyanúgy működik. Forrás, kiadások és a kiadói runbook élőben diegosouzapw/OmniCopilot oldalon.

_{📖 VS kód Copilot Csevegési útmutató – beállítás, mit mutat a választó, irányítópult egy lapon, hibaelhárítás}

🎩 Új: OmniRouteTray – az Ön átjárója, amely a menüsorban található

omniroute serve akkor a legboldogabb, ha mindig be van kapcsolva.** OmniRouteTray** ezt a macOS menüsor-alkalmazásává változtatja: beállítja és elfelejti: elindítja a szervert, életben tartja az újraindítások során, frissíti a helyére, és egyetlen kattintással elérhetővé teszi az élő token költségvetését –** nincs nyitva hagyott terminálablak, nincs npm install -g omniroute a babaváráshoz.**

A Tauri v2- vel (kerekítési hiba méretű Rust mag) épült, saját aláírt Node 24 futtatókörnyezetét szállítja, és egy alkalmazás tulajdonában lévő OmniRoute telepítést kezel, így soha nem harcol a globális node/bun ellen. Azt** megosztja a meglévő ~/.omniroute/ konfigurációt és adatbázist** — tehát ugyanaz a OmniRoute, amit már fut, csak kalappal. 🎩

mit csinál
🟢 Felügyeli a	szervert `omniroute serve` , átvesz egy már futó példányt a megkettőzés helyett
📊 Élő használat áttekintése	Szolgáltatói kvótasávok, Claude session/weekly korlátok visszaszámlálással, 30 napos költségbontás
🔄 Automatikus frissítések a helyükön	szakaszos telepítés, atomcsere, visszaállítás hiba esetén – mindig a legújabb kiadáson
🚀 Indítás bejelentkezéskor	Opcionális indítás bejelentkezéskor; csak tálca, nincs dokkoló ikon
🩺 Doctor & naplók	Egykattintásos diagnosztika és szervernapló-hozzáférés

brew install --cask zoispag/tap/omniroute-tray

_{Inkább letöltöd? Töltse le a legújabb .dmg fájlt innen
Kiadja . Forrás, problémák és felépítés
A docs a zoispag/omniroute-tray található.

💛 A @zoispag közösségi projektje – nem hivatalos OmniRoute kiadás.}

🔒 Privát és helyi működésre tervezve

_{📖 Engedélyezés · Védelmi korlátok · Megfelelőség}

🔌 Teljes CLI + A2A és MCP

A szerveren túl az OmniRoute egy teljes parancssori vezérlőpult több mint 80 paranccsal, valamint nyílt ügynökprotokollokkal, így egy MI-ügynök önállóan is vezérelheti.

⌨️ Valódi CLI (nem csupán `start`)

omniroute               # átjáró + irányítópult kiszolgálása (20128-as port)
omniroute chat          # interaktív TUI-csevegőkliens (perjeles parancsok: /model /combo /skill /memory)
omniroute setup         # vezetett első indítási varázsló
omniroute doctor        # szolgáltatók, portok és natív függőségek diagnosztizálása

🛰️ Távoli mód — a CLI itt, az OmniRoute egy VPS-en fut

Az OmniRoute egy szerveren fut? Vezérelje laptopjáról ugyanazzal a CLI-vel. Jelentkezzen be egyszer egy korlátozott hatókörű hozzáférési tokennel; ezután minden parancs a távoli példányt célozza.

omniroute connect 192.168.0.15            # jelszó → korlátozott hatókörű token, kontextusként mentve
omniroute models                         # ← a TÁVOLI szerveren fut
omniroute configure codex                 # ← kiválaszt egy távoli modellt, és létrehoz egy helyi Codex-profilt
omniroute tokens create --name ci --scope read   # szűkebb hatókörű tokenek létrehozása más gépekhez
omniroute contexts use default            # ← visszaváltás a helyi szerverre

A tokenek hatóköre read / write / admin; a folyamatokat indító útvonalak kizárólag a visszacsatolási interfészen érhetők el. _{📖 Távoli mód}

Animált termináldemó az OmniRoute CLI-ről — omniroute providers list, omniroute combo list és omniroute health — végiglépkedve a 89 parancsot tartalmazó legfelső szintű felületen: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

🤝 Csatlakoztasson egy ügynököt — és az maga vezérli az OmniRoute-ot

Tegye elérhetővé az OmniRoute-ot MCP, A2A, REST API, webhookok vagy távoli CLI használatával — így bármely megfelelő képességű ügynök (vagy a saját kódja) önállóan hozzáférhet a teljes átjáróhoz: útválasztás, szolgáltatók, kombinációk, gyorsítótár, tömörítés és memória. Az alábbi HTTP-végpontok a http://localhost:20128 címen érhetők el.

Interfész	Végpont / parancs	Felhasználási terület
🧰 MCP (stdio)	`omniroute --mcp`	Integráció a Claude Desktop, a Cursor vagy bármely MCP-kliens használatával
🌊 MCP (HTTP)	`/api/mcp/stream`	Távoli MCP — 110 eszköz, 33 hatókör (a kikényszerítés opcionális), teljes auditnapló
📡 MCP (SSE)	`/api/mcp/sse`	Adatfolyam-alapú MCP-átvitel
🤝 A2A	`/.well-known/agent.json`	Ügynökök közötti kommunikáció, JSON-RPC 2.0 + SSE, 6 készség
🌐 REST API	`/v1/*`	OpenAI-kompatibilis — csevegés, beágyazások, képek, hang és OCR
🔔 Webhookok	`/api/webhooks`	Kérés- és kvótaesemények továbbítása a Slack, Discord vagy Telegram felé, illetve bármely URL-re
🛰️ Távoli CLI	`omniroute connect`	Távoli példány vezérlése korlátozott hatókörű hozzáférési tokenekkel

# A teljes OmniRoute-eszközkészlet biztosítása a Claude Code számára MCP-n keresztül:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

_{📖 MCP-szerver · A2A-szerver · Ügynökprotokollok}

🗜️ Takarítson meg 15–95% tokent — automatikusan

📖 Hogyan működik — pipeline, architektúra és a megtakarítás matematikája

Az alapértelmezett egymásra épülő kombináció a RTK → Caveman. Amikor mindkettő ugyanarra a tool-/kontextus-payloadra hat, a megtakarítások halmozódnak:

combined = 1 − (1 − RTK) × (1 − Caveman_input)
average  = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range    = 78.4 – 94.6%

A kódblokkokat, URL-eket, a JSON-t és a strukturált adatokat a megőrzési motor mindig védi.

Miért használjunk sok tokent, ha kevés token is elvégzi a munkát? Minden kérés transzparensen áthalad az OmniRoute tömörítési pipeline-ján — ügyféloldali módosítások nélkül. Ez mára egy 12 összekapcsolható motorból álló verem, amelyek sorrendben futnak, és routing-kombinációnként szabadon kombinálhatók — olyan ötletekre építve, mint a RTK, a Caveman (⭐ 90K+), a LLMLingua-2 és a Troglodita (PT-BR).

🧱 A 12 motoros verem

A motorok a pipeline sorrendjében futnak; mindegyik kombinációnként függetlenül ki- és bekapcsolható, valamint konfigurálható:

#	Motor	Mit tesz
1	Session-Dedup	Eltávolítja a fordulók között ismétlődő tartalmat (tartalom szerint címezve, fordulókon átívelően)
2	CCR	A nagy blokkokat visszakereső markerek mögé archiválja, amelyek igény szerint lekérhetők
3	Lite	Whitespace- és kép-URL-csonkítás (kis késleltetésű alapvonal)
4	RTK	Intelligens tool-eredmény-szűrés, dedup és csonkítás (parancs-tudatos)
5	Responses Tool Output	Veszteségmentes elsőbbségű JSON + korlátos diagnosztikai tömörítés shell/patch/search/build kimenetekhez (Responses API)
6	Headroom	JSON-tömbök veszteségmentes táblázatos tömörítése (~30%) egy beágyazott GCF codec segítségével
7	Relevance	Extrakciós mondatpontozás az utolsó felhasználói lekérdezéshez viszonyítva
8	Caveman	Szabályalapú prózatömörítés (~65–75% a kimeneten)
9	Aggressive	Összegzés + a régi fordulók fokozatos elöregítése
10	LLMLingua-2	ML-alapú szemantikai nyesés MobileBERT ONNX segítségével — kódbarát, aszinkron
11	Ultra	Heurisztikus token-nyesés opcionális kismodell- (SLM-) szinttel
12	OmniGlyph	Kísérleti kontextus-képként-kódolás a mért Claude Fable 5 számára a közvetlen Anthropic-vezetéken; a GPT 5.6 transformer-ek a szolgáltatói visszaigazolásokig fail-closed állapotban maradnak. Négy tömörítési profil (aggressive – alapértelmezett, balanced, coding-safe, passthrough) (a legagresszívabb; opt-in)

A kódblokkok, URL-ek és strukturált adatok mindig bájtra pontosan megőrződnek. Az egykattintásos előbeállítások kombinálják a motorokat:

Mód	Megtakarítás	Legjobb ehhez
🪶 Lite	~15%	Mindig bekapcsolt, biztonságos alapértelmezés
🪨 Standard (Caveman)	~30%	Mindennapi kódolás
⚡ Aggressive	~50%	Hosszú, tool-igényes munkamenetek
🔥 Ultra	~75%	Maximális megtakarítás
🧰 RTK	60–90%	Shell/test/build/git kimenet
🔗 Stacked (RTK → Caveman)	78–95%	Vegyes promptok + tool-naplók

Valós példa — Standard mód:

Előtte (69 token): "A React-komponensed újrarenderelésének oka valószínűleg az, hogy minden renderelési ciklusban új objektumhivatkozást hozol létre. Amikor egy inline objektumot adsz át propként, a React sekély összehasonlítása minden alkalommal más objektumnak látja, ami újrarenderelést vált ki. Javaslom, hogy a useMemo használatával memoizáld az objektumot."

Utána (19 token): "Új objektumhivatkozás minden rendereléskor. Inline objektum prop = új hivatkozás = újrarenderelés. Csomagold useMemo-ba."

Ugyanaz a válasz. 72%-kal kevesebb token. Nulla pontosságvesztés. ✅

PT-BR példa — Troglodita mód:

Előtte (42 token): „A probléma az, hogy a komponens újrarenderelődik, mert minden renderelési ciklusban új objektumreferencia jön létre. A useMemo használatát javasolnám.”

Utána (12 token): „Újrarenderelés: minden ciklusban új referencia (az inline objektum újra létrejön). Használd a useMemo-t.”

Ugyanaz a válasz. ~70%-kal kevesebb token. A technikai pontosság változatlan. ✅

🎚️ A motorokon túl — kimeneti stílusok, adaptív szabályozó és kérésenkénti vezérlés

A fenti 12 motor azt tömöríti, ami bekerül. További három réteg alakítja, hogyan, mikor és mi kerül ki:

🪄 Kimeneti stílusok (kimeneti tengely vezérlése) — determinisztikus, gyorsítótár-biztos utasításokat szúrnak be a válasz formálásához; kombinálhatók, mindegyik lite / full / ultra intenzitással. Egy stílus hozzáadása egyetlen sor a regisztrációs jegyzékben:
- Tömör próza — mellőzi a töltelékszavakat / névelőket / bizonytalankodást; a technikai tartalmat pontosan megőrzi.
- Kevesebb kód — „lusta senior fejlesztő” YAGNI: a legkisebb működő módosítás, kéretlen vázkód nélkül.
- Lófarok (lusta senior fejlesztő) — végigmegy a YAGNI-létrán, kijavítja a kiváltó okot, és a legkisebb működő diffet adja.
- ADHD-m van (cselekvésközpontú) — a következő művelettel kezd, számozott lépések, egyetlen konkrét következő lépés, bevezetés nélkül.
- Tömör CJK (文言) — klasszikus kínai, rendkívül tömör stílus (területi beállítás alapján csak zh esetén).
🎯 Adaptív kontextuskeret (a szabályozó) — egyetlen be-/kikapcsolási tokenküszöb helyett csak annyira fokozza a legolcsóbb, legkisebb veszteségű motorok használatát, amennyire szükséges ahhoz, hogy a tartalom beleférjen a modell kontextusablakába. Szabályzat: reserve-output (alapértelmezett, modellfüggő) · percentage · absolute. Mód: floor (garantáltan belefér) · replace-autotrigger (az explicit választásod elsőbbséget élvez) · off (örökölt küszöbérték).
🎛️ Hol dől el a tömörítés (elsőbbség, magastól az alacsonyig) — kérésenkénti x-omniroute-compression fejléc › útválasztási kombináció felülbírálása › aktív elnevezett profil › adaptív / automatikus aktiválás › vezérlőpult alapértelmezése › kikapcsolva. Az alkalmazott terv visszaköszön az X-OmniRoute-Compression: <mode>; source=<source> válaszfejlécben.

Állíts be tokenküszöb szerinti automatikus aktiválást, kapcsold be az adaptív szabályozót, rögzíts egy elnevezett profilt, adj meg egyszeri beállítást kérésenként, vagy rendelj folyamatot egy útválasztási kombinációhoz — amelyik leginkább megfelel a munkaterhelésnek. Egy opcionális, offline kiértékelési keretrendszer (npm run eval:compression) rögzített korpuszon pontozza a tartalmi hűséget a megtakarításhoz viszonyítva, mielőtt élesítenéd a módosítást.

📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md

⚡ Gyors kezdés

1) Telepítés és futtatás

npm install -g omniroute
omniroute

💡 npm warn ERESOLVE vagy tárfüggőségi figyelmeztetéseket látsz? Ezek ártalmatlanok. npm 11-et vagy újabbat használsz? Az npm blokkolhatja a csomagok életciklus-szkriptjeit, ha azok nincsenek engedélyezve. Az OmniRoute postinstall szkriptje (node scripts/build/postinstall.mjs) szükséges a natív futtatókörnyezeti fájlok előkészítéséhez. Globális telepítéskor engedélyezd az npm figyelmeztetésében megnevezett csomagokat. Az OmniRoute 3.8.53 által jelzett csomagkészlet esetén:
npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
Ha ezt az engedélyezési listát a jövőbeli globális telepítéseknél is használni szeretnéd, állítsd be egyszer, majd telepíts a szokásos módon:
npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
npm install -g omniroute
A függőségek listája kiadásonként változhat; ha az npm más listát jelez, használd az abban a figyelmeztetésben szereplő csomagneveket. Egy csomag engedélyezése lehetővé teszi a telepítési szkriptjeinek futtatását. Gemini Webet vagy más, webes cookie-kat használó szolgáltatót használsz? Az npm-csomag tartalmazza a Playwrightot, de a Chromium binárisát nem. Az első webes szolgáltatói kérés elküldése előtt lásd a Playwright Chromium beállításáról szóló megjegyzést.

Vezérlőpult: http://localhost:20128 · API: http://localhost:20128/v1.

2) Csatlakoztass egy megfelelő szolgáltatót a saját fiókoddal

Vezérlőpult → Szolgáltatók → válassz olyan szolgáltatót, amelynek aktuális feltételei és kvótája megfelel a felhasználási esetednek → add hozzá az API-kulcsát, vagy végezd el a fiókcsatlakoztatási folyamatát. Az ingyenes csomagokhoz regisztráció, jóváhagyás vagy fizetési mód megadása lehet szükséges. Tekintsd át az ingyenes csomagokról szóló útmutatót; a kulcs nélküli hozzáférés nem garantált, és a tos: avoid jelölésű szolgáltatók alapértelmezés szerint ki vannak zárva az auto útválasztásból.

3) Állítsd be a kódolási eszközödet

Alap URL: http://localhost:20128/v1
API-kulcs: [másold ki innen: Vezérlőpult → Végpontok]
Modell:    auto            (az elérhető kapcsolatok között irányít — vagy válassz szolgáltatót/modellt)

4) Ellenőrizd a működést

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

A csatlakoztatott modellek listáját kell látnod. 🎉 Ennyi — kezdj el kódolni, az OmniRoute pedig automatikusan útválaszt és szükség esetén tartalék szolgáltatóra vált.

Ha a kliensed nem tud egyéni fejléceket küldeni, az OmniRoute tokenizált kompatibilitási aliasokat is biztosít:

OpenAI-katalógus: http://localhost:20128/vscode/YOUR_KEY/
OpenAI-modellek:  http://localhost:20128/vscode/YOUR_KEY/models
OpenAI-csevegés:  http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI-válaszok:  http://localhost:20128/vscode/YOUR_KEY/responses
Ollama-csevegés:  http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama-címkék:    http://localhost:20128/vscode/YOUR_KEY/api/tags

Ezeket csak olyan kliensekhez használd, amelyek nem tudják csatolni az Authorization: Bearer ... fejlécet. Továbbra is a fejlécalapú hitelesítés az előnyben részesített mód.

📦 További telepítési módok — Docker, forráskód, pnpm, Arch

🐳 Docker

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

A :latest a legmagasabb közzétett stabil SemVer-verziót követi. Nem követi a git main ágát. GitOps használatához rögzítse a :X.Y.Z verziót. Lásd: Docker kiadási csatornák. A lemezképben az OMNIROUTE_MEMORY_MB=1024 érték van rögzítve. Ez elegendő a vezérlőpulthoz és könnyű csevegési feladatokhoz. A kódoló ügynököknek (Claude Code, Codex, Grok stb. által küldött POST /v1/responses kérések) jóval nagyobb V8-heapre van szükségük, különben a folyamat két, egymást időben átfedő hosszú kontextus esetén körülbelül 12 GiB-nál FATAL ERROR hibával leáll. A konténer méretét a heap fölé állítsa (a natív pufferek a V8-on kívül helyezkednek el):

Terhelés	Heap (`-e OMNIROUTE_MEMORY_MB`)	Konténer (`--memory`)
Vezérlőpult / könnyű csevegés	`1024` (lemezkép alapértéke)	≥2 g
Egy kódoló ügynök	`8192`	≥10 g
Két egyidejű hosszú `/v1/responses`	`10240`–`12288`	≥12–16 g

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
  -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
  -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

Teljes táblázat: Docker útmutató — futásidejű RAM.

Előzetes kiadású Docker-csatorna: a diegosouzapw/omniroute:next és a diegosouzapw/omniroute:next-web az aktuális alapértelmezett release/v* ágat követi. Ezek a változó címkék kizárólag a még kiadatlan javítások tesztelésére szolgálnak, és éles környezetben nem támogatottak. Lásd: Docker kiadási csatornák.

🥟 Bun

A szabványos bun install és a globális telepítés (bun install -g omniroute) a Bun futtatókörnyezetének felismerésével támogatott:

Beépített bun:sqlite: Az OmniRoute a Bun alatt történő futtatáskor a Bun beépített bun:sqlite illesztőprogramját használja, Node.js alatt pedig a better-sqlite3, illetve a sql.js használatára tér át.
A Webpack csomagoló automatikus kiválasztása fejlesztéskor: A fejlesztési mód (bun run dev) automatikusan felismeri a Bunt, és a natív V8-kötések inkompatibilitásának megelőzése érdekében letiltja a Turbopacket a Webpack javára. Az éles buildelés (bun run build) pontosan úgy követi az OMNIROUTE_USE_TURBOPACK értékét, mint Node alatt: alapértelmezés szerint Turbopacket használ; Webpackkel történő buildeléshez állítsa be az OMNIROUTE_USE_TURBOPACK=0 értéket (a Dockerfile.bun ezt --build-arg argumentumként teszi elérhetővé).
Dedikált Bun Dockerfile: Többlépcsős Dockerfile.bun natív Bun-alapú éles telepítésekhez (docker build -f Dockerfile.bun -t omniroute:bun .).

# Telepítés és futtatás Bunnal
bun install
bun run dev

🛠️ Forráskódból

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# Nix flake-ek használatával
nix develop
npm run dev

# Vagy devbox használatával
devbox run npm run dev

📖 Docker útmutató — Compose-profilok, Caddy HTTPS, Cloudflare-alagutak.

🦭 Podman

# 1. A csatolással hozzákapcsolt adatkönyvtár előkészítése
mkdir -p data

# 2. Csak Linux + helyi root nélküli Podman esetén (távoli Podman Machine-klienssel soha):
podman unshare chown 1000:1000 ./data

# 3. Állítsa be a futtatókörnyezetre vonatkozó jelzést, építse meg a helyi Compose-lemezképet, majd indítsa el
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build

macOS vagy Windows rendszeren a Podman távoli Podman Machine-t használ: hagyja ki a podman unshare lépést, és kövesse a topológiaspecifikus adatkönyvtár-útmutatást.

📖 Podman útmutató — Compose-buildek, Podman Machine és Linux/systemd Quadlet-beállítás.

⚡ Gyorsabb / kisebb erőforrás-igényű telepítés (a natív build kihagyása)

A natív SQLite-motor (better-sqlite3) egy opcionális függőség, ezért a globális telepítés soha nem akad el a forráskódból történő fordításnál: előre buildelt bináris fájlt használ, ha talál az adott platformnak/Node-nak megfelelőt, ellenkező esetben pedig észrevétlenül egy tisztán JS-alapú motorra vált (node:sqlite Node 22+ alatt, egyébként a mellékelt sql.js WASM-re) — nincs szükség buildeszközökre.

A telepítés utáni natív előkészítés teljes kihagyásához (CI, grafikus felület nélküli vagy lassú gépeken):

OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute   # A CI=1 szintén kihagyja

A leggyorsabb telepítéshez részesítse előnyben a pnpm használatát (tartalomcímzett tároló + merev hivatkozások — lásd fent). Vezérlőpult nélküli, grafikus felületet nem igénylő futtatáshoz használja a Docker base profilját (fent) vagy a Termux útmutatót. A CLI-t és a webes vezérlőpultot ugyanaz a folyamat szolgálja ki egyetlen porton, ezért jelenleg nincs külön, kizárólag CLI-t tartalmazó csomag.

🎬 Az OmniRoute működés közben

📹 Videóútmutatók

_{Pillanatkép a vezérlőpultról: 2026-10-18 · Nyers katalógus: YT 1.352 | TT 334 | IG 290 · Frissesség (nap): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 megtekintés}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 megtekintés}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 megtekintés}

🎬 #4 — Instagram
_{theopenstack — 692,419 megtekintés}

🎬 #5 — TikTok
_{migue.baena — 685,788 megtekintés}

Teljes rangsor (duplikációmentes kanonikus URL-ek, v > 0, legnagyobb elérés):

#1	#2	#3	#4	#5
nick_saraev — Instagram — 3,042,474	nnapier7 — Instagram — 1,454,535	Amidia AI & Tech — YouTube — 794,974	theopenstack — Instagram — 692,419	migue.baena — TikTok — 685,788

#6	#7	#8	#9	#10
milesreevesai — TikTok — 620,400	nikothetech — TikTok — 610,803	Vaibhav Sisinty — YouTube — 509,281	buildwithai.club — Instagram — 347,652	nivedan.ai — Instagram — 331,973

Kanonikus mérőszámok 2026-10-18-án: 1.976 egyedi videó · 20.220.289 ismert megtekintés (v > 0) · 1.210 csatorna/profil hálózatonként. A nyers vezérlőpult 1.976 sort tartalmaz (YouTube 1.352 = 740 hosszú videó + 612 Shorts · TikTok 334 · Instagram 290); a kanonikus URL szerinti normalizálás után egyetlen duplikátum sem maradt, és videónként a legnagyobb számlálóérték maradt meg. A YouTube-adatgyűjtés 2026-10-13 óta szünetel (az API-kvóta 14. és 18/10. között kimerült), a TikTok/Instagram adatgyűjtése pedig 2026-09-02 óta (nincs adatgyűjtési kredit); 76 videóhoz továbbra sem tartozik megtekintésszám.

🎬 Készítettél videót az OmniRoute-ról? Nyiss egy hibajegyet vagy egy beszélgetést a hivatkozással — itt fogjuk kiemelni.

📧 Közösség és segítség

Minden egy helyen — kövesd a karbantartót, csevegj a közösséggel, vagy nyiss egy hibajegyet.

Csatorna	Hol / hogyan
💼 LinkedIn — kövesd a karbantartót	linkedin.com/in/diegosouzapw
🐙 GitHub — kövesd a kiadásokért és tippekért	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 Globális	csatlakozás a csoporthoz
🟢 WhatsApp — 🇧🇷 Brazília	csatlakozás a csoporthoz
🌍 Webhely	omniroute.online
🌍 🌍StHub OmniRoute-közösség (ingyenes)	StHub portál
📦 Forráskód	github.com/diegosouzapw/OmniRoute
🐛 Hiba jelentése	probléma megnyitása — csatold az `npm run system-info` kimenetét
🤝 Közreműködés	CONTRIBUTING.md · Elágazási és kiadási modell · válassz egy `good first issue` címkéjű problémát
💚 A projekt támogatása	Támogatási lehetőségek ↑ · GitHub Sponsors

🛠️ Technológiai stack

Réteg	Technológia
Futtatókörnyezet	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Nyelv	TypeScript 6.0 — 100% TypeScript a `src/` és az `open-sse/` könyvtárban (nulla `any` a magban a v2.0 óta)
Keretrendszer	Next.js 16 + React 19 + Tailwind CSS 4
Adatbázis	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 147 domainmodul, 219 migráció
Memória	SQLite FTS5 teljes szöveges keresés + int8-ra kvantált vektorbembeddingek, típusos lecsengés
Sémák	Zod 4 — MCP-eszközök I/O-validációja + API-szerződések
Protokollok	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streamelés	Server-Sent Events (SSE) + WebSocket híd (`/v1/ws`)
Tömörítés	12 motorból álló pipeline — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Hitelesítés és biztonság	OAuth 2.0 (PKCE) + JWT + API-kulcsok + MCP hatókörözött hitelesítés · AES-256-GCM tárolt adatokon (at rest) · DOMPurify
Stealth	wreq-js — JA3 / JA4 TLS-ujjlenyomat-utánzás, 3 szintű proxy
Hibatűrés	Áramkörmegszakító (circuit breaker), exponenciális backoff, anti-thundering-herd, auto-combo öngyógyítás
Naplózás	pino — strukturált JSON-naplók kéréskontextussal
Tesztelés	Node.js test runner + Vitest — több mint 56 000 statikus tesztdeklaráció 7 800+ nyilvántartott tesztfájlban (unit, integrációs, E2E, biztonsági, ökoszisztéma)
Platformok	Asztali (Electron) · Android (Termux) · PWA (bármely böngésző)
CI/CD	GitHub Actions — automatikus npm publish + Docker Hub kiadáskor
Hivatkozások	Weboldal · npm · Docker Hub

📖 Dokumentáció

📘 Első lépések

Dokumentum	Leírás
Felhasználói útmutató	Szolgáltatók, kombinációk, CLI-integráció, üzembe helyezés
Beállítási útmutató	Teljes körű telepítési módszerek, CLI-eszközök konfigurációi, protokollbeállítás, időtúllépések finomhangolása
CLI-eszközök útmutatója	Eszközönkénti beállítás a Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo és Copilot számára
Távoli mód	Távoli OmniRoute (VPS) vezérlése a laptop CLI-jéből korlátozott hatókörű hozzáférési tokenekkel
Claude Code-konfiguráció	A Claude Code csatlakoztatása az OmniRoute-hoz (helyi/távoli) a `launch` paranccsal és modellenkénti profilokkal
Gyors kezdés	3 lépéses telepítés → csatlakoztatás → konfigurálás

🔧 Üzemeltetés és üzembe helyezés

Dokumentum	Leírás
Docker-útmutató	Docker-futtatás, Compose-profilok, Caddy HTTPS, alagutak, rendszerképcímkék
Podman-útmutató	Quadlet systemd-integráció, podman-compose, SELinux
Virtuális gépes üzembe helyezés	Teljes útmutató: virtuális gép + nginx + Cloudflare beállítása
Üzembe helyezés a Fly.io-n	Üzembe helyezés a Fly.io-n tartós tárhellyel
Termux-útmutató	Az OmniRoute futtatása Androidon a Termux segítségével
PWA-útmutató	Progresszív webalkalmazás telepítése, gyorsítótárazása és architektúrája
Eltávolítási útmutató	Tiszta eltávolítás minden telepítési módszerhez
Környezeti konfiguráció	A `.env` változók és hivatkozások teljes körű leírása

🧠 Funkciók és architektúra

Dokumentum	Leírás
Architektúra	Rendszerarchitektúra, adatfolyam és belső működés
Tömörítési útmutató	7 lehetőséges feldolgozási folyamat: kikapcsolt / enyhe / normál / agresszív / ultra / RTK / halmozott
RTK-tömörítés	Parancskimenetek tömörítése, szűrők, megbízhatóság, ellenőrzés, nyers kimenet helyreállítása
Tömörítési motorok	Caveman, RTK, halmozott feldolgozási folyamatok, irányítópulti/API-/MCP-felületek
Tömörítési szabályok formátuma	JSON-szabálycsomagok sémái a Caveman- és RTK-szűrőkhöz
Tömörítési nyelvi csomagok	Nyelvfelismerés és Caveman-szabálycsomagok készítése
Hibatűrési útmutató	Áramkör-megszakítók, várakozási idők, várólista, egyidejű kérésáradat elleni védelem, TLS-megszemélyesítés
Automatikus kombinációs motor	16 tényezős pontozás, módcsomagok, önjavítás
Proxyútmutató	3 szintű proxyrendszer, 1proxy piactér, beállításjegyzék-CRUD
Ingyenes csomagok	Összevont jegyzék: 34 dokumentált, ismétlődően elérhető készlet / 484 katalogizált ingyenes csomagbejegyzés
Funkciógaléria	Az irányítópult képernyőképekkel illusztrált vizuális bemutatása
A kódbázis dokumentációja	Kezdőbarát áttekintés a kódbázisról

🤖 Protokollok és API-k

Dokumentum	Leírás
API-referencia	Az összes végpont példákkal
OpenAPI-specifikáció	OpenAPI 3.0 specifikáció
MCP-szerver	110 MCP-eszköz, IDE-konfigurációk, Python-/TS-/Go-kliensek
MCP-szerver útmutatója	MCP-telepítés, átviteli módok és eszközreferencia
A2A-szerver	JSON-RPC 2.0 protokoll, képességek, streamelés, feladatkezelés
A2A-szerver útmutatója	A2A-ügynökkártya, feladatok, képességek és streamelés

📋 Projekt és minőség

Dokumentum	Leírás
Közreműködés	Fejlesztői környezet beállítása és irányelvek
Ág- és kiadási modell	Hová irányulnak a PR-ek (`release/*`), valamint mit jelent a `main` és a címkék
Változásnapló	Teljes, verziónkénti kiadási előzmények
Biztonsági szabályzat	Sérülékenységek jelentése és biztonsági gyakorlatok
i18n-útmutató	67 nyelv támogatása, fordítási munkafolyamat, RTL
Kiadási ellenőrzőlista	Kiadás előtti ellenőrzési lépések
Lefedettségi terv	Tesztlefedettségi stratégia több mint 56 000 statikus tesztdeklarációhoz, több mint 7 800 nyomon követett tesztfájlban

⭐ Legkiemelkedőbb közreműködők

Az OmniRoute-ot egy lelkes nyílt forráskódú közösség formálja. Ezek a személyek olyan kiemelkedő hozzájárulásokat tettek, amelyek közvetlenül befolyásolják a projekt minőségét, stabilitását és elérését. Köszönjük.

Külső közreműködők az egyesített pull requestek száma szerint

Helyezés	Közreműködő	Egyesített PR-ek	~Módosított sorok
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{A felmérés 2026-10-18 15:09:09 UTC időpontban készült, a release/v3.8.52 ág élő 656f01cb43 csúcsával. A lapozott GitHub GraphQL-felmérés 9 191 egyesített PR-t tartalmaz: 3 834-et a repozitórium tulajdonosától, 229-et a Dependabottól, 6-ot más botoktól/alkalmazásoktól, valamint 5 122 külső PR-t 835 különböző közreműködőtől. A „Módosított sorok” a GitHubon jelzett hozzáadások és törlések összege, amely a generált fájlokat, zárolási fájlokat, katalógusokat, fordításokat és dokumentációt is magában foglalja; ez a módosítások mennyiségét jelzi, nem a szerző által írt forráskódsorok számát. 49 PR esetében a GitHub által jelentett eltérés meghaladja az 500 000 sort (például a #13399, amely egyetlen szolgáltató hozzáadása, 2 347 módosított fájlt sorol fel), ami a fenti összesítések közül többet is megemel. Az azonos eredményt elérők azonos helyezést kaptak.}

GitHubhoz rendelt commitok

Dizzle _{🥇 367 GitHubhoz rendelt commit}	Bob.Hou _{🥈 269 GitHubhoz rendelt commit}	Paijo _{🥉 229 GitHubhoz rendelt commit}	backryun _{🏅 202 GitHubhoz rendelt commit}	Paco Cartones _{🏅 174 GitHubhoz rendelt commit}	Ravi Tharuma _{🏅 126 GitHubhoz rendelt commit}
Markus Hartung _{🏅 114 GitHubhoz rendelt commit}	Randi _{🏅 108 GitHubhoz rendelt commit}	Jan Leon _{🏅 87 GitHubhoz rendelt commit}	Chris _{🏅 70 GitHubhoz rendelt commit}	Koosha Paridehpour _{🏅 68 GitHubhoz rendelt commit}

_{Újraellenőrizve: 2026-10-18 14:44:45 UTC. A GitHubhoz rendelt commitokat a tároló Contributors API-ja jelentette a release/v3.8.52 alapértelmezett ághoz. Az API 849 identitást adott vissza (429 felhasználó, 2 bot, 418 névtelen); ez a táblázat nem tartalmazza a karbantartót, a botokat és a névtelen identitásokat, a holtversenyeket pedig megőrzi. Ez eltér mind a fenti egyesített PR-ok szerinti rangsortól, mind az alábbi Git-metaadatok alapján készült összesítéstől.}

🙏 E közreműködők funkciói, hibajavításai és infrastruktúra-fejlesztései alapvető részét képezik annak, amitől az OmniRoute megbízható és funkciókban gazdag. Minden pull request, minden teszteset és minden i18n-fordítási fájl számít. A nyílt forráskódot hozzájuk hasonló emberek építik.

💖 Szponzorok

Szívből köszönjük azoknak, akik saját pénzükből finanszírozzák az OmniRoute-ot — minden hozzájárulás segít abban, hogy a projekt ingyenes és független maradjon, és tovább fejlődjön.

Andrew _{💛 Aktív havi szponzor}	Vlad I _{💛 Aktív havi szponzor}	小妍儿 _{💛 Aktív havi szponzor}	Guilherme Costa _{💛 Aktív egyszeri szponzor}	Henrique Iurkiv _{💛 Aktív egyszeri szponzor}	Somesh Ghaturle _{💛 Aktív egyszeri szponzor}
Kolonie AI _{💛 Korábbi egyszeri támogató}	Prof. Igor Morais _{💛 Korábbi egyszeri támogató}	Pixma _{💛 Korábbi egyszeri támogató}	Paco Cartones _{💛 Korábbi egyszeri támogató}	longtao _{💛 Korábbi egyszeri támogató}

_{… és másoknak is, akik inkább névtelenek szeretnének maradni 💛}

_{A nyilvános GitHub Sponsors-adatokat 2026-10-18-án ellenőriztük újra a GitHub Sponsors GraphQL API segítségével: az összesen 14 szponzorációból 11 nyilvános (6 aktív, 5 korábbi). A fenti aktív címkéket a GitHub isActive állapota határozza meg; a korábbi nyilvános egyszeri támogatóknak továbbra is köszönetet mondunk, a privát szponzorok pedig névtelenek maradnak. A Ko-fi-, Buy Me a Coffee-, Liberapay-, PIX- és kriptoadományok nem szerepelnek a listán, mivel nem tartozik hozzájuk nyilvános szponzori bejegyzés.}

💖 Legyél szponzor → — minden dollár segít abban, hogy az OmniRoute ingyenes és független maradjon.

👥 Több mint 900 közreműködő

_{Ellenőrizve 2026-10-18-án az élő release/v3.8.52 ág ad160ab2d1 csúcsánál (6 826 véglegesítés): 993 normalizált emberi Git-identitás — 707 véglegesítésszerzőként jelenik meg (beleértve a karbantartót is), 286 pedig kizárólag explicit Co-authored-by záradékokban. Az összesítés alkalmazza a .mailmap fájlt, a kis- és nagybetűk figyelmen kívül hagyásával hasonlítja össze az e-mail-címeket, a numerikus és egyszerű GitHub noreply címeket csak akkor kapcsolja össze, ha ugyanazt a felhasználónevet kódolják, kizár 26 bot-, ügynök-, szolgáltatás- vagy helyőrző-identitást, és nem von össze hagyományos e-mail-címeket pusztán azért, mert a megjelenített nevük megegyezik. A 2026-08-24-i ellenőrzés 639-et tett közzé; ezt a módszert az akkori ellenőrzés ac02c5b42f alapjára ismételten alkalmazva 619-et kapunk, így a növekedés új közreműködőkből, nem pedig egy megengedőbb módszerből ered.}

Hogyan járulhatsz hozzá

Forkold a tárolót
Hozz létre ágat az aktív release/vX.Y.Z ág csúcsából (ne a main ágból) — lásd: Ágkezelési és kiadási modell
Hozd létre a funkcióágadat (git checkout -b feat/amazing-feature)
Véglegesítsd a módosításaidat (git commit -m 'feat: add amazing feature')
Töltsd fel az ágat (git push origin feat/amazing-feature)
Nyiss egy Pull Requestet, ahol base = az adott release/vX.Y.Z ág

A részletes irányelvekért lásd a CONTRIBUTING.md fájlt.

Új verzió kiadása

# Kiadás létrehozása — az npm publish automatikusan megtörténik
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 Csillagok

🌍 StarMapper

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

Az OmniRoute óriások vállán áll. A projekt a 9router forkjaként és a Go nyelvű CLIProxyAPI projekt TypeScript-portjaként indult — ezt követően pedig az alábbi alrendszerek mindegyikét egy-egy olyan nyílt forráskódú projekt ihlette, amely korábban valósította meg az adott megoldást. Mindegyikük az OmniRoute egy konkrét részét formálta. Ezzel szeretnénk köszönetet mondani mindannyiuknak. 🙏

⭐ a csillagok száma a GitHub REST API-jával lett ellenőrizve 2026. október 18-án — adjatok egy csillagot ezeknek a projekteknek. Az értékek egy adott időpontban készült pontos pillanatképet tükröznek, ezért természetesen változni fognak.

🧬 Eredet és átjáró

Projekt	⭐	Hogyan ihlette az OmniRoute-ot
9router	31,004	Az eredeti projekt, amelyre ez a fork épül — itt multimodális API-kkal és egy teljes TypeScript-újraírással kibővítve.
CLIProxyAPI	55,591	Az a Go-implementáció, amely ezt a JavaScript / TypeScript-portot ihlette.
LiteLLM	61,482	Az az MI-átjáró, amelynek nyilvános árazási adatkészlete biztosítja a költségkövetési szinkronizálásunk adatait, szolgáltatónormalizálási modellje pedig hatással volt az útválasztásunkra.
codex-chatgpt-web	14,526	MIT-licencű forráskód, amelyet a csomagba foglalt ChatGPT Web → Codex Responses-hídhoz adaptáltunk, beleértve a böngészőmunkamenet-, válaszkeretezési, használatkövetési és webes keresési adaptereket.
free-claude-code	61,430	A stream-helyreállításba, a gondolkodás nélküli aliasokba, a tartalék webes keresésbe, a csúszóablakos korlátokba, a naplóadatok kitakarásába és a megerősített indítási folyamatokba átültetett minták.
composer-api	346	A Cursor Composer eszközválasztási, kimenetkorlátozási és eszközvéglegesítési mintái, amelyeket a natív Cursor-végrehajtóhoz adaptáltunk.
codex-multi-auth	553	A Codex OAuth-újrahitelesítésbe átültetett friss bejelentkezési és frissítésitoken-rotációs minták.
opencode-anthropic-auth	558	A Claude Code-dal kompatibilis átalakítási alapértékek és számlázásifejléc-viselkedés, amelyeket általánosítottunk az OmniRoute konfigurációvezérelt hídjához.
grok2api-merged	2	A Grok-modellleképezéseit, hamis TypeError-t használó Statsig-generátorát, kérés- és eszközalapértékeit, valamint NDJSON-válaszfeldolgozóját érdemben adaptáltuk az OmniRoute Grok Web-végrehajtójához.
TQZHR/grok2api	706	A grok2api-merged mögötti elsődleges tranzitív kódforrás; modell-, fejléc-, hasznosadat-, Statsig- és feldolgozóimplementációit a Grok Web eredeti származási lánca megőrzi.
chenyme/grok2api	7,819	A Grok hasznosadat- és eszközalapértékeinek, a Statsig-generátornak, valamint a TQZHR-en és a grok2api-merged projekten keresztül átvett `result.response` feldolgozónak az alapjául szolgáló MIT-licencű forráskód.
grok2api-pro	27	Egy tranzitív forrás, amelyet a grok2api-merged a proxykészlet-rétegéért tüntet fel; az OmniRoute megőrzi ezt a származási hivatkozást, de nem állítja, hogy a korlátozott hatókörű Grok Web-végrehajtója a proxykészlet portját tartalmazná.
GrokProxy	51	A cookie-hitelesítésű Grok-proxyja és `result.response.token` streamelési mintája hatással volt az OmniRoute Grok Web-átvitelére.
GrokBridge	5	Az eredeti Grok Web-implementáció a projekt HTTP-/böngészőalapú upstream kialakítását vette alapul; közvetlen HTTP-útvonala a GrokProxyból származik, ezért nem állítjuk, hogy önálló kódport történt.

🗜️ Kontextus- és tokentömörítés — motorok

Projekt	⭐	Hogyan inspirálta az OmniRoute-ot
Caveman	113,396	A virálissá vált „miért használ sok token, ha kevés token elég” projekt — ősemberbeszéd-filozófiája adja a szabványos tömörítési módunk, valamint több mint 30 töltelékszó-eltávolítási és sűrítési szabályunk alapját.
RTK – Rust Token Killer	83,835	Nagy teljesítményű parancskimenet-tömörítés — ez inspirálta az RTK motorunkat, a JSON-szűrő DSL-t, a nyers kimenet visszaállítását és az egymásra épülő RTK → Caveman feldolgozási láncot.
headroom	75,741	Visszafordítható kontextustömörítés (SmartCrusher) — ez inspirálta a `headroom` motorunkat és a `ccr` lekérési jelölőmintát.
LLMLingua	6,757	Prompttömörítési kutatás (LLMLingua / LLMLingua-2) — ez inspirálta az aszinkron, kódbiztos, hiba esetén az eredeti tartalmat továbbengedő `llmlingua` motorunkat.
llmlingua-2-js	32	A JS/ONNX-port (MobileBERT / XLM-RoBERTa), amelyet az LLMLingua motorunk munkaszálas háttérrendszereként használunk.
Troglodita	50	pt-BR tokentömörítés — erre épül a pt-BR nyelvi csomagunk: a brazil portugál nyelvtanhoz hangolt pleonazmuscsökkentés és töltelékszó-eltávolítás.
ponytail	166,731	A virálissá vált „lusta senior fejlesztő” YAGNI-kódolási készség — ez inspirálta a less-code kimeneti stílusunkat: a legkisebb működő módosításra ösztönöz, így csökkenti a _generált_ kód mennyiségét (a Caveman tömör prózájának kimeneti tengelyen elhelyezkedő párja).
i-have-adhd	57,628	Cselekvésközpontú, ADHD-barát válaszstílusát öt nyelven adaptáltuk az OmniRoute tömör kimeneti stílusához.

🧩 Kompakt formátumok, tokenkutatás és kódtudatos eszközök

Projekt	⭐	Hogyan inspirálta az OmniRoute-ot
TOON	25,509	Tokenorientált objektumjelölés — oszlopos, fejlécből és sorokból álló modellje formálta a táblázatos tömörítési szakaszunkat.
GCF – Graph Compact Format	59	Kompakt gráfformátuma és általánosprofil-tervezése hatással volt az OmniRoute táblázatos tömörítésére és a Headroom kodekformátumára.
gcf-typescript	4	Az MIT-licencű TypeScript-megvalósítás, amelyet közvetlenül beemeltünk és kibővítettünk a Headroom általánosprofil-kodekeként.
token-optimizer-mcp	551	Brotli/SQLite gyorsítótár + munkamenetenkénti kontextuskülönbség — ez inspirálta a `session-dedup` motorunkat.
token-savior	1,182	Bash-kimenet tömörítése + MCP-profilok — ez inspirálta a tömörítés megszakítására vonatkozó fegyelmünket és az MCP-eszközjegyzék csökkentését.
token-saver	154	Tartalomtudatos, fájltípusonkénti kimenettömörítés hibatűrő megszakítással — megerősítette a típusonkénti továbbításunk és a minimális nyereség alatti kihagyásunk helyességét.
token-optimizer	2,595	„Találd meg a szellemtokeneket” — a kiszervezési és visszaállítható hivatkozásmintája hatással volt a CCR-kiszervezéssel kapcsolatos megközelítésünkre.
TokenMizer	33	Egy munkamenetgráf- és fordulókon átívelő sordeduplikációs tervrajz, amely hatással volt a session-dedup kialakítására.
OmniCompress	3	Rust-alapú oszlopos JSON + tartalomcímzett lekérés + üzenetek közötti deduplikáció — megerősítette a `headroom`/`ccr`/`session-dedup` motortervünk, valamint a gyorsítótár-stabil „a tömörített forma pozíciófüggetlen” invariáns helyességét.
mcp-compressor	133	MCP-eszközséma- és leírástömörítés — hatással volt az MCP-eszközjegyzék számosságának csökkentésére.
RepoMapper	217	Aider-stílusú repótérkép-rangsorolás — hatással volt a repótérkép- és lekérésirangsorolás-kutatásunkra.
quiet-shell-mcp	4	Deklaratív shellkimenet-csökkentés MCP-n keresztül — megerősítette a deklaratív Bash-kimenettömörítésünk helyességét.
ts-morph	6,205	TypeScript Compiler API-eszközkészlet — ez inspirálta az elemzőalapú megjegyzés-eltávolításunkat, amely megőrzi a karakterlánc-, sablon- és regexliterálokat.

🧠 Memória és RAG

Projekt	⭐	Hogyan inspirálta az OmniRoute-ot
Mem0	67,385	Univerzális memóriaréteg — a proxyt írási/olvasási határként alkalmazó modellje alakította memóriaarchitektúránkat.
Letta (MemGPT)	25,179	Állapottartó ágensek többszintű memóriával — ez inspirálta a Context Control & Recovery (CCR) többszintű modelljét.
WFGY	1,800	A 16 visszatérő RAG-/LLM-hibatípust rendszerező ProblemMap taxonómia — ez biztosítja hibaelhárítási útmutatónk közös szókincsét.

🛰️ Forgalomvizsgálat, MITM és transzparens proxy

Projekt	⭐	Hogyan inspirálta az OmniRoute-ot
llm-interceptor	79	A kódolási asszisztens ↔ LLM közötti forgalom MITM-elfogása/-elemzése meghatározta a Traffic Inspector korai követelményeit. Négy korábban származtatott modult — az SSE-egyesítést, a beszélgetések normalizálását, a titkos adatok maszkolását és a fejlécek tisztítását — nyilvános protokollszabványokon alapuló, független, tiszta megvalósításokra cseréltünk. A két gazdagép-közvetlen továbbítási felület (`passthrough.ts` és `_internal/bypass.cjs`) továbbra is egymástól függetlenül besorolt, belső OmniRoute-megvalósítás; ezeket nem írtuk újra a csere részeként.
ProxyBridge	6,814	Transzparens, folyamatonkénti proxyútválasztás — ez inspirálta az összeomlásbiztos MITM-leállítást, a socketek inaktivitási időtúllépéseit, a `/proc` alapú folyamathoz-rendelést és a TPROXY-forgalomrögzítést.

📚 Modelladatok, megfigyelhetőség és felhasználói felület

Projekt	⭐	Hogyan inspirálta az OmniRoute-ot
models.dev	7,286	MI-modellek specifikációinak, árainak és képességeinek nyílt adatbázisa — natívan szinkronizáljuk a modellkatalógusunkkal.
React Flow / xyflow	38,705	A csomópontalapú gráfkönyvtár, amely a valós idejű Compression Studio és Combo/Routing Studio működését biztosítja.
LangGraph	43,443	A LangGraph Studio élő munkafolyamatgráf-vizualizációja inspirálta stúdióink valós idejű kaszkádnézetét.
Langfuse	35,990	A nyomkövetés → szakasz → generálás megfigyelhetőségi modellje alakította a Compression Studio vízesésdiagramját.
Kiali	3,645	Az Istio szolgáltatásháló megfigyelhetősége — ez inspirálta a Routing/Combo Studio áramkör-megszakító jelvényeit és hibakapcsolat-vizualizációit.
lobe-icons	2,615	MI-/LLM-márkalogók, amelyek szolgáltatói ikonként jelennek meg a vezérlőpulton.
flag-icons	12,473	Biztosítja a README nyelvválasztója által használt, MIT-licencű SVG-zászlókat.

🛡️ Biztonság

Projekt	⭐	Hogyan inspirálta az OmniRoute-ot
awesome-secure-defaults	722	A biztonságos alapbeállításokat alkalmazó könyvtárak válogatott listája, amely biztonsági döntéseinket irányítja (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

🧭 Kiegészítő eszközök

Projekt	⭐	Hogyan inspirálta az OmniRoute-ot
ClawRouter	6,628	Inspirálta a kérések deduplikálását, a vészhelyzeti, költségmentes tartalékmegoldást, a bővíthető Auto-Combo stratégiákat és a többnyelvű szándékosztályozást.
Antigravity-Manager	32,333	A fióktudatos modell-újraleképezés, a végrehajtható fájlok elérési útjának ellenőrzése és a csomagcímkék kezelése hozzájárult az OmniRoute Antigravity-futtatókörnyezetének kialakításához.
vscode-antigravity-cockpit	4,850	A kvóta-visszaállításig hátralévő idő kompakt formátuma inspirálta az OmniRoute megfelelő szolgáltatóikorlát-kijelzését.
AionUi	33,611	ACP-integrációi inspirálták a telepített CLI-ágensek OmniRoute általi automatikus észlelését.
CodexBar	22,616	Azonosította a Grok Build kvótafelületét; az OmniRoute ezt követően függetlenül ellenőrizte és javította a tényleges átviteli formátumot.

📄 Licenc

MIT licenc – részletekért lásd a LICENSE fájlt.

⬆ Vissza a tetejére · ❤️-vel készült a nyílt forráskódú AI-közösség számára.

_{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT licenc · omniroute.online}

FilesExpand file tree

README.md

Latest commit

History