# Conflicts: # README.md # config/quality/file-size-baseline.json # docs/diagrams/comparison-table.svg # docs/diagrams/free-tier-budget.svg # docs/diagrams/readme-hero.svg # docs/i18n/am/llm.txt # docs/i18n/ar/llm.txt # docs/i18n/az/llm.txt # docs/i18n/bg/llm.txt # docs/i18n/bn/llm.txt # docs/i18n/cs/llm.txt # docs/i18n/da/llm.txt # docs/i18n/de/llm.txt # docs/i18n/el/llm.txt # docs/i18n/es/llm.txt # docs/i18n/et/llm.txt # docs/i18n/fa/llm.txt # docs/i18n/fi/llm.txt # docs/i18n/fr/llm.txt # docs/i18n/ga/llm.txt # docs/i18n/gu/llm.txt # docs/i18n/ha/llm.txt # docs/i18n/he/llm.txt # docs/i18n/hi/llm.txt # docs/i18n/hr/llm.txt # docs/i18n/hu/llm.txt # docs/i18n/hy/llm.txt # docs/i18n/id/llm.txt # docs/i18n/ig/llm.txt # docs/i18n/it/llm.txt # docs/i18n/ja/llm.txt # docs/i18n/ka/llm.txt # docs/i18n/km/llm.txt # docs/i18n/kn/llm.txt # docs/i18n/ko/llm.txt # docs/i18n/lt/llm.txt # docs/i18n/lv/llm.txt # docs/i18n/ml/llm.txt # docs/i18n/mr/llm.txt # docs/i18n/ms/llm.txt # docs/i18n/mt/llm.txt # docs/i18n/my/llm.txt # docs/i18n/ne/llm.txt # docs/i18n/nl/llm.txt # docs/i18n/no/llm.txt # docs/i18n/or/llm.txt # docs/i18n/pa/llm.txt # docs/i18n/phi/llm.txt # docs/i18n/pl/llm.txt # docs/i18n/pt-BR/llm.txt # docs/i18n/pt/llm.txt # docs/i18n/ro/llm.txt # docs/i18n/ru/llm.txt # docs/i18n/si/llm.txt # docs/i18n/sk/llm.txt # docs/i18n/sl/llm.txt # docs/i18n/sr/llm.txt # docs/i18n/sv/llm.txt # docs/i18n/sw/llm.txt # docs/i18n/ta/llm.txt # docs/i18n/te/llm.txt # docs/i18n/th/llm.txt # docs/i18n/tr/llm.txt # docs/i18n/uk-UA/llm.txt # docs/i18n/ur/llm.txt # docs/i18n/uz/llm.txt # docs/i18n/vi/llm.txt # docs/i18n/yo/llm.txt # docs/i18n/zh-CN/llm.txt # docs/i18n/zh-TW/llm.txt # docs/reference/PROVIDER_REFERENCE.md # docs/screenshots/free-tier-budget-card.svg
README (Magyar)
🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 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
💰 ~1,47 milliárd ingyenes token / hónap
Az ingyenes csomagok kézi összevonása fáradságos — több tucat SDK, több tucat sebességkorlát, és fogalmad sincs, valójában mennyi áll rendelkezésedre. Az OmniRoute 452 ingyenes csomagbejegyzést tart nyilván 34 ismétlődő készletkulcshoz, és a tokenek főösszegét abból a 16 készletből számítja ki, amelyekhez közzétett, pozitív havi keret tartozik, kiegészítve öt modellenkénti Groq-korláttal, a megosztott készletek duplikációjának kiszűrésével. A csak regionális személyazonosság-ellenőrzés után elérhető kvóták (jelenleg: ModelScope) külön jelennek meg, +~6M regionális személyazonosság-ellenőrzés mögött, és soha nem számítanak bele a főösszegbe. Az eredmény mindig látható marad az irányítópulton (
/dashboard/free-tiers).
A működő
/dashboard/free-tiersoldal animált összefoglalója. Teljes módszertan (készletek duplikációjának kiszűrése, kreditszintek, 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ányban változhatnak — ha egy szolgáltató megszüntet egy ingyenes csomagot, a szám csökken; ha új jelenik meg, növekszik. Mindig azt tesszük közzé, amit a katalógus ténylegesen kiszámít, nem pedig egy felfelé kerekített, lehető legkedvezőbb értéket.
⭐ 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.49 | v3.8.50 | v3.8.51+ |
|
|---|---|---|---|
| 🌐 Szolgáltatók | 290 | 352 | továbbiak várakoznak |
| 🧠 Egyedi chatmodell-azonosítók | 1185 | 1312 | — |
| 🖼️ Modalitási híd | — | 🆕 kép + hang + videó | — |
| 📡 Radar ingyenes katalógusa | — | 🆕 opcionális | — |
| ⚖️ Kvótatudatos ütemezés | — | 🆕 Quota-Share | — |
| 📊 Kvótatelemzés | — | 🆕 élő | — |
→ Ütemterv — sínen a v3.9.0 LTS felé
🧩 Elérhető
| 🚀 Kezdés | 🚀 Gyors kezdés | 📦 Telepítés | 🆓 Nulla konfiguráció |
| 💡 Ismerd meg | 💥 Az ígéret | 🤔 Miért az OmniRoute? | 🏆 Mitől különleges? |
| ⚙️ Funkciók | 🎯 Kombók | 🌐 Szolgáltatók | 🔌 CLI és MCP |
| 🗜️ Tömörítés | 🖥️ Hol fut? | 🔒 Privát | |
| 👀 Nézd meg | 🎬 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 stack | 📖 Dokumentáció | 👥 Közreműködők |
🆓 A telepítés pillanatától működik — kulcsok és konfiguráció nélkül
# Friss telepítés, hitelesítő adatok nélkül — az `auto` máris működik:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
Inkább egy konkrét ingyenes háttérszolgáltatást használnál? Hívd meg közvetlenül az oc/… (OpenCode Free) szolgáltatást. Ezután válts az auto használatára, és hagyd, hogy az OmniRoute válasszon.
📦 Másolható és beilleszthető gyorsindító szkriptek Python, Node.js, PHP és cURL használatához → examples/quickstart/
💥 Az ígéret
🤔 Miért az OmniRoute?
🤝 Nyílt forráskódú barátaink támogatásával
Szeretnél csatlakozni nyílt forráskódú barátként? Ezek a vállalatok támogatják a nyílt forráskódot, és segítenek mozgásban tartani az OmniRoute-ot — mi pedig nyilvánosan közzétesszük, hogy az általuk biztosított minden egyes token mire megy el. Lépj kapcsolatba velünk: diegosouza.pw@outlook.com
|
Kimi Moonshot AI |
Köszönjük a Kiminek (Moonshot AI), alapító nyílt forráskódú barátunknak, hogy támogatja ezt a projektet! A Kimi a nyílt súlyozású K2 és K3 modellcsaládok mögött álló mesterségesintelligencia-laboratórium — a Kimi K3 1 millió tokenes kontextusablakot, natív képfeldolgozást és élvonalbeli kódolási képességeket kínál a zárt modellek árának töredékéért, továbbá azonnal használható a Claude Code-dal, a Codexszel és minden, az OmniRoute által kiszolgált kódolási eszközzel.
Amit a Kimi támogatása lehetővé tesz: A Kimi API-kreditjei működtetik az OmniRoute mesterséges intelligenciával ellenőrzött kiadási folyamatát — a Kimi K3 által végzett egyesítés-ellenőrzési szakaszt, amely minden pull requestet átvizsgál a kiadás előtt —, valamint a mindennapos funkciófejlesztést. A Kimi első osztályú támogatása mindkét útvonalon elérhető: a közvetlen Kimi API-n ( kimi-k3) és a Kimi Code kódolási csomagon (OAuth és API-kulcs) keresztül. Az OmniRoute egyben az első brazil nyílt forráskódú projekt a Kimi támogatási programjában. Szerezz Kimi API-kulcsot 15%-kal több 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 alapján rangsoroló átjáró, amely 42 élvonalbeli modellt — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok és MiniMax — értékesít tovább egyetlen OpenAI-kompatibilis végpont mögött, minden kérést a legolcsóbb megfelelő szolgáltatóhoz irányítva anélkül, hogy valaha is a modell gyártójának listaáránál többet számítana fel.
Első osztályú támogatás az OmniRoute-ban: Chat Completions, a natív /v1/responses végpont, képfeldolgozás, eszközhívás és 3 képmodell (grok-imagine, nano-banana-pro, nano-banana-2, amelyek cheaperinference/<model> formában érhetők el). Szerezz API-kulcsot →
|
Az aff=omniroute címkével ellátott hivatkozások partnerlinkek. Ezek számodra többletköltség nélkül finanszírozzák a projektet.
🎟️ Partneri promóciók — ingyenes regisztrációs kuponok olyan szolgáltatóktól, amelyek nem szponzorálnak bennünket (kattints a kibontáshoz)
Ez a szakasz kizárólag ajánlói/kuponkódokat tartalmaz. A szponzorált partnerségek helye a fenti 🤝 Nyílt forráskódú barátaink támogatásával szakasz. Az OmniRoute nem áll szponzori vagy partneri kapcsolatban az itt felsorolt szolgáltatókkal — ezek nyilvános kuponok, amelyeket bárki felhasználhat.
|
AgentRouter agentrouter.org |
AgentRouter — partneri regisztráció · $100 ingyenes kredit regisztrációkor (ingyenes szerver, ezért nagyobb késleltetésre számíts — teszteléshez ideális, éles használatra nem). Első osztályú támogatás az OmniRoute-ban a v3.8.50 verzió óta: Chat Completions, az Anthropic-kompatibilis adatátviteli formátum és az OpenAI-kompatibilis útvonal. Az elérhető modellek között szerepel a claude-opus-4-8, a claude-opus-5, a gpt-5.6-sol és számos további modell. Szerezd meg a $100 kreditet →
⚠️ Partnerlink — az OmniRoute nem áll szponzori vagy partneri kapcsolatban ezzel a szolgáltatóval. |
Ismersz másik szolgáltatót, amely bőkezű, ingyenes regisztrációs kupont kínál az OmniRoute felhasználóinak? Nyiss egy hibajegyet, és hozzáadjuk ide.
🎯 Kombók — A zászlóshajó
A kombó modellek olyan lánca, amelyek között az OmniRoute automatikusan végzi az útválasztást. Ha elfogy a kvóta, egy szolgáltató meghibásodik, vagy megugranak a költségek, a kombó továbbléphet a következő jogosult és működőképes modellre. 🛡️
⚡ Nulla konfiguráció — csak használd az auto modellt
Nem kell kombót létrehozni. Állítsd a modellt auto értékre (vagy valamelyik változatára), és az OmniRoute virtuális kombót állít össze a csatlakoztatott szolgáltatóidból, valós idejű pontozással:
| Modellazonosító | Mire optimalizál |
|---|---|
auto | 🎯 Kiegyensúlyozott alapértelmezés (LKGP — ragaszkodik a legutóbb jól működő szolgáltatóhoz) |
auto/coding | 🧑💻 A kódgenerálásnál a minőséget előnyben részesítő súlyok |
auto/fast | ⚡ Először a legalacsonyabb késleltetés |
auto/cheap | 💰 Először a tokenenként legolcsóbb |
auto/offline | 🔋 Először a legnagyobb kvóta- és sebességkorlát-tartalék |
auto/smart | 🔭 Minőségközpontú + 10%-os feltérképezés a jobb modellek felfedezéséhez |
auto/lkgp | 📌 Kifejezetten a legutóbb jól működő szolgáltatóhoz való ragaszkodás |
auto/chaos | 🧪 Hibainjektálási súlyok a rezilienciateszteléshez (káosztervezés) |
🔀 Vagy készíts sajátot — 19 útválasztási stratégia
Mind a 19 stratégia — tetszőlegesen kombinálhatók a kombó egyes lépéseiben:
| # | Stratégia | Működés |
|---|---|---|
| 1 | priority |
Első célpontot előnyben részesítő rendezett lista — mindegyik kimerítése a következő előtt 🥇 |
| 2 | fill-first |
Az egyes célpontok kvótájának teljes kihasználása a továbblépés előtt |
| 3 | weighted |
Súlyozott véletlenszerű választás célpontonkénti súlyok alapján |
| 4 | round-robin |
A célpontok sorban, ciklikusan követik egymást |
| 5 | p2c |
Véletlenszerű terheléselosztás a „kettő közül a jobb” módszerrel |
| 6 | least-used |
A jelenleg legkisebb terhelésű célpont kiválasztása |
| 7 | random |
Egyenletes véletlenszerű választás (duplikációk eltávolításával) |
| 8 | strict-random |
Véletlenszerű választás az ismétlődések kiszűrése nélkül 🎲 |
| 9 | cost-optimized |
A kérésenkénti költség minimalizálása az élő katalógus árai alapján 💸 |
| 10 | headroom |
A legtöbb fennmaradó kvótával rendelkező célpont kiválasztása |
| 11 | reset-window |
Annak a célpontnak az előnyben részesítése, amelynek kvótaablaka a leghamarabb visszaáll |
| 12 | reset-aware |
Rangsorolás a kvóta visszaállítási ideje alapján — a rövid ablakok előre kerülnek 📊 |
| 13 | context-relay |
A kontextus átadása a célpontok között hosszú beszélgetésekhez 🧠 |
| 14 | context-optimized |
Az aktuális kontextusmérethez legjobban illő célpont kiválasztása |
| 15 | cache-optimized |
Minden újrafelhasználható promptelőtag ugyanahhoz a fiókhoz rögzítése — a promptgyorsítótár találati arányának maximalizálása 🎯 |
| 16 | lkgp |
Legutóbbi ismerten jól működő útvonal — az utolsó sikeres szolgáltatóhoz rögzít, majd szükség esetén visszatér a szabályokhoz |
| 17 | auto |
16 tényezős valós idejű pontozás minden kapcsolaton 🤖 |
| 18 | fusion |
A kérés párhuzamos továbbítása modellek egy csoportjához, majd egy bíró egyetlen választ szintetizál 🧬 |
| 19 | pipeline |
Lépések láncolása — minden célpont kimenete a következő bemenetéül szolgál 🔗 |
Az Auto-Combo motor minden jelöltet 16 tényező alapján pontoz (állapot, kvóta, költség, késleltetés, feladathoz való illeszkedés, minőség, munkamenet elérhetősége…) — lásd: docs/routing/AUTO-COMBO.md.
🧱 Beépített reziliencia (3 független réteg)
📖 Automatikus kombinációs motor · Reziliencia-útmutató
🏆 Mi teszi különlegessé az OmniRoute-ot
📊 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
Az ingyenes csomag fő kerete továbbra is ~1,47 milliárd token/hó a fent dokumentált, készletszinten duplikációmentesített katalógus alapján. A szolgáltatók ideiglenes regisztrációs jóváírásai külön ~2,07 milliárdra növelhetik az első havi keretet. A Radar egy opcionális, aláírt katalógusréteg azoknak, akik az OmniRoute kiadásai között is 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 legfeljebb körülbelül 3 milliárd token/hó, a szolgáltatók elérhetőségétől függően. 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 önkéntes, é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 elutasításának helyi állapotát. A jogosultsági feltételekről és az aktuális katalógusról itt tájékozódhat: radar.omniroute.online/planos.
✨ Újdonságok
A v3.8.20 → v3.8.50 verziók legfontosabb újdonságai. A teljes előzmény a
CHANGELOG.mdfájlban található.
- 🎛️ OmniConductor — bejövő A2A-delegálás az ügynökflottádhoz, Conductor-képességek az Agent Cardon, valamint egy irányítópultpanel Faro adó-vevő hangcsevegéssel. → A2A-kiszolgáló
- 🛂 Adaptív beléptetés és túlterhelés elleni védelem — a nagy erőforrás-igényű csevegési kérések 503-as hiba helyett várólistára kerülnek, kapcsolatonkénti atomi, gördülő RPM-bérletekkel. → Ellenálló képességi útmutató
- 🗂️ Kanonikus
/v1/models-sorrend — szolgáltatónként egyetlen összefüggő, szolgáltató szerint csoportosított blokk (a kombinációk elöl rögzítve), minden katalógusforrásban stabilan. → API-referencia - 🗜️ Megerősített tömörítés — alapértelmezetten bekapcsolt kibontási védelem, Caveman-csomagok némethez, franciához, japánhoz és kínaihoz (wényán), valamint RTK-szűrők Gradle-höz és .NET-hez. → Tömörítés
- 💸 Valósághű átalánydíjas költség — az előfizetéses/kódolási csomagot kínáló szolgáltatók költségelemzési értéke $0; a költségkeret, a kvóta és az útválasztás továbbra is becslést használ. → API-referencia
- ⚖️ Quota-Share útválasztás — egy megosztott fiók kvótájának méltányos elosztása az összevont kulcsok között, munkamegőrző módon, így a kihasználatlan részek kölcsönadhatók. → Ellenálló képességi útmutató
- 🤖 Egyparancsos CLI-/ügynökbeállítás — 13 regisztrált
setup-*parancs; azomniroute run7 CLI-t indít el (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); azomniroute configure10 célrendszert támogat interaktív szolgáltató- és modellválasztóval, valamint kontextusonkénti kedvencekkel. → CLI-integrációk - 🛰️ Távoli mód — távoli OmniRoute vezérlése korlátozott hatókörű tokenekkel (
connect/contexts/tokens), valamint egyantigravityOAuth-segédeszközzel VPS-telepítésekhez. → Távoli mód - 🧭 Intelligensebb automatikus útválasztás —
auto/<category>:<tier>kombinációk, Fusion (modellpanel + bíró), feladattudatos útválasztás, valamint kérésenkénti modell-, mód- és USD-költségkeret-felülbírálás. → Auto-Combo - 🗜️ Bővíthető tömörítés — 12 kombinálható motor + Compression Studios: LLMLingua-2, kétszintű Ultra, omniglyph, lépésenkénti hűségkapu, GCF v3.2, húzással átrendezhető szerkesztő. → Tömörítés
- 🕵️ Transzparens MITM-visszafejtés (TPROXY) — a proxykörnyezeti változókat figyelmen kívül hagyó CLI-k forgalmának elfogása SNI-nkénti hitelesítésszolgáltatóval és bizalmi tárat konfiguráló telepítővel. → MITM/TPROXY
- 💸 Mindenre kiterjedő költségtelemetria —
X-OmniRoute-*költség- és használati fejlécek minden végponton, gyorsítótártalálati megtakarítási fejléc, kulcsonkénti USD-költési kvóták. → API-referencia - 🧠 Általad felügyelt memória — alapértelmezetten kikapcsolva, opcionális int8 vektorkvantálás + típusos lecsengés, kérésenkénti
x-omniroute-no-memory. → Memória - 🛡️ Biztonság — promptinjektálás elleni védelem minden LLM-útvonalon (red-team tesztcsomag), opcionális hitelesítőadat-maszkolási védőkorlát (mindkét irányban kitakarja a kiszivárgott API-kulcsokat és titkokat), ingyenes DuckDuckGo webes keresés végső megoldásként, valamint opcionális OIDC-bejelentkezési kapu az irányítópulthoz (a jelszavas bejelentkezés mindig elérhető marad). → Védőkorlátok
- 🖼️ Új végpontok — a
/v1/ocr(Mistral OCR) és a/v1/audio/translations(Whisper-stílusú) teszi teljessé a médiafunkciókat. → API-referencia - 🎨 Kép-, videó- és hanggenerálás — egyetlen API médiához: xAI Grok Imagine és 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 — fordított proxyhoz használható
basePath, böngészőnyelv automatikus felismerése, kulcsonkénti eszközkövetés, root nélküli MITM-megbízhatóság, zh-TW-lokalizáció. → Környezet - 🤝 További szolgáltatók és ügynökök — felhőügynökök (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) böngészős + OAuth-bejelentkezéssel, teljes értékű Ollama-kártya, Claude Opus 5 és Sonnet 5, hivatalos Kimi-partnerség (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… valamint egy megújult, 352 szolgáltatót tartalmazó katalógus. → Szolgáltatók
- 📡 Átlátható útválasztás — minden válasz tartalmaz egy
X-OmniRoute-Decisionfejlécet, amely megnevezi a kiszolgáláshoz használt stratégiát, szolgáltatót és késleltetést; az újcache-optimizedkombinációs stratégia és az Auto-CombocacheAffinitytényezője visszairányítja az ismételt kéréseket a gyorsítótárazott előtagot tároló kapcsolathoz; az írásvédett/v1/auto-combo/{channel}/candidatesvégpont pedig felfedi egyauto/*csatorna aktuális jelöltkészletét. → Auto-Combo - ⚡ Helyi teljesítmény és infrastruktúra — egykattintásos helyi Redis, Cloudflare Workers-/Deno Deploy-relételepítők, valamint felügyelt beágyazott szolgáltatásként futó Bifrost és Mux. → Beágyazott szolgáltatások
- 🧩 Szintén a csomag része — bővítménykeretrendszer + piactér, Omni-/Agent-/GitHub-képességkeretrendszerek, Obsidian-tárolóintegráció (22 MCP-eszköz), OpenAI-kompatibilis Batch- és Files API-k, szemantikus válaszgyorsítótár, ranglistás játékosítás, ACP-ügynökfelderítés (15 beépített ügynök), ütemezett naplóexportálás BigQuerybe,
auto/chaoshibainjektálás, Telegram-bot-híd, alkalmazáson belüli verziókezelő és LMArena-ELO rangsorok az ingyenes szolgáltatókhoz. → Dokumentáció
🤖 Kompatibilis CLI-k és kódoló ügynökök
Egyetlen konfiguráció —
http://localhost:20128/v1— és minden AI IDE vagy CLI ingyenes és alacsony költségű modellekkel fut.
Claude Code |
Codex CLI |
Cline |
Kilo Code |
Zoo Code |
Continue |
Aider |
ForgeCode |
jcode |
DeepSeek TUI |
CodeWhale |
OpenCode |
Factory Droid |
Copilot CLI |
Cursor CLI |
Smelt |
Pi |
Grok Build |
Hermes Agent |
OpenClaw |
Goose |
Open Interpreter |
Warp AI |
Agent Deck |
📖 Eszközönkénti beállítás mind a 36 eszközhöz (26 CLI-kódoló + 10 CLI-ügynök) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode-bővítmény → @omniroute/opencode-provider
Bármely támogatott CLI elindítása az OmniRoute-on keresztül egyetlen paranccsal — konfigurációs fájlok létrehozása nélkül, folyamatonként átadott hitelesítő adatokkal, a Qwen/Gemini számára pedig ideiglenes, elkülönített saját könyvtárral:
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"
# Vagy válasszon interaktívan szolgáltatót és modellt, majd írja ki az eszköz saját konfigurációját:
omniroute configure codex # további lehetőségek: claude opencode qwen aider goose gemini cline continue kilo
Minden parancs figyelembe veszi az aktív távoli környezetet (omniroute connect <host>), a --dry-run
végrehajtás nélkül megjeleníti a pontos környezeti változókat és argumentumokat, az --api-key-env NAME pedig távol tartja a titkos adatokat
a parancsértelmező előzményeitől. → CLI-integrációk
🌐 352 AI-szolgáltató — 152 katalógusban ingyenesként megjelölve
352 regisztrált szolgáltató a kanonikus csevegési, média-, keresési, helyi, felhőügynök- és rendszergyűjteményekben, közülük 152 rendelkezik
hasFree: truefelderítési metaadattal. A csevegésimodell-nyilvántartás 229 szolgáltatót / 2 554 egyedi szolgáltató–modell párost / 1 283 nyers modellazonosítót fed le; a különálló ingyenes keretkatalógusban 443 modellenkénti sor, 34 megújuló keret és 53 megújuló/kulcs nélküli, örökre ingyenes szolgáltató található. Ezek a nevezők szándékosan eltérőek; 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 csomagokban 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 330+ — 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
📖 Teljes, géppel olvasható katalógus → docs/reference/PROVIDER_REFERENCE.md
🖥️ Hol fut az OmniRoute — bárhol
Ugyanaz az alkalmazás, a te géped, a te szabályaid. A globális npm-telepítéstől egészen a telefonodig a Termuxon keresztül.
| Platform | Telepítés | Főbb jellemzők |
|---|---|---|
| 📦 npm (globális) | npm install -g omniroute | Egyetlen parancs, bármilyen operációs rendszer |
| 🐳 Docker | docker run … diegosouzapw/omniroute | Több architektúra: AMD64 + ARM64 |
| 🖥️ Asztali alkalmazás (Electron) | npm run electron:build | Natív ablak + rendszertálca — Windows / macOS / Linux |
| 🎩 Menüsáv (OmniRouteTray) | brew install --cask zoispag/tap/omniroute-tray | Felügyeli és automatikusan frissíti a szervert — macOS |
| 💪 ARM | natív arm64 | Raspberry Pi, ARM-szerverek, Apple Silicon |
| 📱 Android (Termux) | pkg install nodejs && npx -y omniroute | A telefonodon fut, éjjel-nappal, root nélkül |
| 📲 PWA | „Hozzáadás a kezdőképernyőhöz” | Teljes képernyős, offline, böngészőből telepíthető |
| 🧩 OpenCode-bővítmény | @omniroute/opencode-provider | Natív OpenCode-integráció |
| 🤖 VS Code Copilot Chat | telepítsd az OmniCopilot bővítményt | Minden OmniRoute-modell a natív Copilot Chat modellválasztójában — stabil és Insiders |
| 🛠️ Forráskódból | npm install && npm run dev | Módosítsd, járulj hozzá |
📖 Docker-útmutató · Asztali alkalmazás · Menüsávos tálca · Termux · PWA · OpenCode
🧩 Újdonság: OmniRoute a VS Code natív Copilot Chat felületén
Nincs új oldalsáv, nincs új csevegőfelület — az OmniRoute által kiszolgált összes modell közvetlenül a már használt Copilot Chat modellválasztóban jelenik meg. A VS Code 1.122 óta a szolgáltatói modellek GitHub-bejelentkezés és Copilot-előfizetés nélkül is működnek — ügynökmóddal, eszközhívással és képfeldolgozással, ingyenesen.
Telepítsd az OmniCopilot bővítményt, állítsd be
az OmniRoute-szervered címét (alapértelmezés szerint localhost:20128), majd nyisd meg a Copilot Chat → modellválasztó
→ Modellek kezelése… → OmniRoute menüpontot.
| Áruház | Hivatkozás | Kompatibilitás |
|---|---|---|
| 🧩 VS Code Marketplace | Telepítés → | VS Code — stabil és Insiders |
| 🔓 Open VSX Registry | Telepítés → | Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro… |
A szerkesztőben nyisd meg a Bővítmények nézetet, keress rá az „OmniRoute” kifejezésre, majd kattints a Telepítés gombra — mindkét áruházban ugyanúgy működik. A forráskód, a hibajegyek és a közzétételi kézikönyv itt található: diegosouzapw/OmniCopilot.
📖 VS Code Copilot Chat útmutató — beállítás, mit jelenít meg a modellválasztó, irányítópult egy lapon, hibaelhárítás
🎩 Újdonság: OmniRouteTray — az átjáród közvetlenül a menüsávban
Az
omniroute serveakkor működik a legjobban, ha folyamatosan fut. Az OmniRouteTray ezt egy „állítsd be és felejtsd el” típusú macOS-menüsávalkalmazássá alakítja: elindítja a szervert, újraindítások után is működésben tartja, helyben frissíti, és egyetlen kattintással elérhetővé teszi az aktuális tokenkeretedet — nincs nyitva hagyott terminálablak, és nincs felügyeletre szorulónpm install -g omniroute.
A Tauri v2 használatával készült (egy kerekítési hibányi méretű Rust-maggal), saját
aláírt Node 24 futtatókörnyezettel érkezik, és egy alkalmazás által kezelt OmniRoute-telepítést használ, így soha nem ütközik a
globális node/bun környezeteddel. Megosztja a meglévő ~/.omniroute/ konfigurációdat és adatbázisodat — tehát ugyanaz
az OmniRoute, amelyet már most is futtatsz, csak éppen kalapban. 🎩
| Funkció | Működés |
|---|---|
| 🟢 Felügyeli a szervert | Elindítja az omniroute serve folyamatot, és egy már futó példányt vesz át ahelyett, hogy megkettőzné |
| 📊 Élő használati adatok egy pillantással | Szolgáltatói kvótasávok, Claude-munkamenet- és heti korlátok visszaállítási visszaszámlálással, 30 napos költségbontás |
| 🔄 Automatikus helyben frissítés | Lépcsőzetes telepítés, atomi csere, visszaállítás hiba esetén — mindig a legújabb kiadást használja |
| 🚀 Indítás bejelentkezéskor | Opcionális indítás bejelentkezéskor; csak a menüsávban jelenik meg, dockikon nélkül |
| 🩺 Diagnosztika és naplók | Egykattintásos diagnosztika és hozzáférés a szervernaplókhoz |
brew install --cask zoispag/tap/omniroute-tray
Inkább letöltenéd? Szerezd be a legújabb .dmg-t a
Kiadások oldaláról. A forráskód, a hibajegyek és a buildelési
dokumentáció itt található: zoispag/omniroute-tray.
💛 Közösségi projekt @zoispag jóvoltából — 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 kiszolgálón túl az OmniRoute egy teljes parancssori vezérlőközpont 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 csak start)
omniroute # az átjáró és az 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 varázsló az első indításhoz
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 pedig egy VPS-en fut
Az OmniRoute egy kiszolgálón 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 meg.
omniroute connect 192.168.0.15 # jelszó → korlátozott hatókörű token, kontextusként mentve
omniroute models list # ← a TÁVOLI kiszolgálón 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 kiszolgálóra
A tokenek hatóköre read / write / admin; a folyamatokat indító útvonalak kizárólag a loopback interfészen érhetők el.
📖 Távoli mód
🤝 Csatlakoztasson egy ügynököt — és az maga vezérli az OmniRoute-ot
Tegye elérhetővé az OmniRoute-ot MCP-n, A2A-n, REST API-n, webhookokon vagy távoli CLI-n keresztül — így bármely megfelelő képességű ügynök (vagy saját kódja) hozzáférést kap a teljes átjáróhoz: az útválasztáshoz, a szolgáltatókhoz, a kombinációkhoz, a gyorsítótárhoz, a tömörítéshez és a memóriához — mindezt önállóan. Az alábbi HTTP-végpontok a http://localhost:20128 címen érhetők el.
| Interfész | Végpont / parancs | Felhasználási cél |
|---|---|---|
| 🧰 MCP (stdio) | omniroute --mcp | Csatlakoztatás a Claude Desktophoz, a Cursorhoz vagy bármely MCP-klienshez |
| 🌊 MCP (HTTP) | /api/mcp/stream | Távoli MCP — 110 eszköz, 33 hatókör (a kikényszerítés választható), 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, OCR |
| 🔔 Webhookok | /api/webhooks | Kérés- és kvótaesemények küldése Slackre, Discordra, Telegramra vagy 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-kiszolgáló · A2A-kiszolgáló · Ügynökprotokollok
🗜️ 15–95%-os tokenmegtakarítás — automatikusan
📖 Hogyan működik — folyamat, architektúra és a megtakarítás kiszámítása
Az alapértelmezett, egymásra épülő kombináció az RTK → Caveman sorrendet használja. Amikor mindkettő ugyanazon eszköz-/kontextustartalmon működik, a megtakarítások összeszorzó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, JSON-t és strukturált adatokat a megőrzési motor mindig védi.
Miért használjunk sok tokent, ha kevés is elvégzi a feladatot? Minden kérés átlátható módon halad át az OmniRoute tömörítési folyamatán — nincs szükség kliensoldali módosításokra. Ez mostantól 12 kombinálható motorból álló rendszer, amelyben a motorok sorrendben futnak, és útválasztási kombinációnként szabadon párosíthatók — a RTK, a Caveman (⭐ 90K+), a LLMLingua-2 és a Troglodita (PT-BR) ötleteire építve.
🧱 A 12 motorból álló rendszer
A motorok a folyamat sorrendjében futnak; mindegyik egymástól függetlenül kapcsolható be és konfigurálható kombinációnként:
| # | Motor | Mit csinál? |
|---|---|---|
| 1 | Session-Dedup | Eltávolítja a beszélgetési fordulók között ismétlődő tartalmat (tartalomcímzett, fordulókon átívelő) |
| 2 | CCR | A nagy blokkokat lekérési jelölők mögé archiválja, amelyek igény szerint kérhetők le |
| 3 | Lite | Szóközök és kép-URL-ek egyszerűsítése (alacsony késleltetésű alapmegoldás) |
| 4 | RTK | Intelligens eszközeredmény-szűrés, duplikációeltávolítás és csonkolás (parancstudatos) |
| 5 | Responses Tool Output | Elsődlegesen veszteségmentes JSON-tömörítés, valamint korlátozott diagnosztikai tömörítés shell-/javítási/keresési/build-kimenetekhez (Responses API) |
| 6 | Headroom | JSON-tömbök veszteségmentes, táblázatos tömörítése (~30%) egy beépített GCF kodekkel |
| 7 | Relevance | Kivonatoló mondatpontozás a legutóbbi felhasználói lekérdezés alapján |
| 8 | Caveman | Szabályalapú prózatömörítés (~65–75% a kimeneten) |
| 9 | Aggressive | Összegzés és a régi beszélgetési fordulók fokozatos tömörítése |
| 10 | LLMLingua-2 | Gépi tanuláson alapuló szemantikai ritkítás MobileBERT ONNX használatával — kódbiztos, aszinkron |
| 11 | Ultra | Heurisztikus tokenritkítás opcionális kisméretűmodelles (SLM) szinttel |
| 12 | OmniGlyph | Kísérleti, kontextust képként kódoló megoldás a mért Claude Fable 5-höz a közvetlen Anthropic-kapcsolaton; a GPT 5.6 transzformátorok továbbra is zárt hibakezelést alkalmaznak a szolgáltatói visszaigazolások beérkezéséig. Négy tömörítési profil (alapértelmezett agresszív, kiegyensúlyozott, kódbiztos, változtatás nélküli) (a legagresszívebb; külön engedélyezendő) |
A kódblokkok, URL-ek és strukturált adatok mindig bájtpontosan megmaradnak. Az egykattintásos előbeállítások kombinálják a motorokat:
| Mód | Megtakarítás | Ehhez ideális |
|---|---|---|
| 🪶 Lite | ~15% | Biztonságos, mindig aktív alapértelmezés |
| 🪨 Standard (Caveman) | ~30% | Mindennapi programozás |
| ⚡ Aggressive | ~50% | Hosszú, eszközintenzív munkamenetek |
| 🔥 Ultra | ~75% | Maximális megtakarítás |
| 🧰 RTK | 60–90% | Shell-/teszt-/build-/git-kimenet |
| 🔗 Stacked (RTK → Caveman) | 78–95% | Vegyes promptok és eszköznaplók |
Valós példa — Standard mód:
Előtte (69 token): „A React-komponensed valószínűleg azért renderelődik újra, mert minden renderelési ciklusban új objektumhivatkozást hozol létre. Amikor beágyazott objektumot adsz át propként, a React sekély összehasonlítása minden alkalommal eltérő objektumként érzékeli azt, ami újrarenderelést vált ki. Azt javaslom, hogy a useMemo használatával jegyezd meg az objektumot.”
Utána (19 token): „Minden renderelésnél új objektumhivatkozás. Beágyazott objektumprop = ú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 minden renderelési ciklusban újrarenderelődik, mert minden alkalommal új objektumreferencia jön létre. A
useMemohaszná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 csökkenti, ami bekerül. További három réteg alakítja, hogyan, mikor és mi kerül ki:
- 🪄 Kimeneti stílusok (kimeneti tengely szerinti vezérlés) — determinisztikus, gyorsítótárbarát utasításokat illesztenek be a válasz formálásához; kombinálhatók, mindegyik
lite/full/ultraintenzitással. Új stílus hozzáadásához elég egyetlen sor a nyilvántartásban:- Tömör próza — elhagyja a töltelékszavakat / névelőket / óvatoskodást; a technikai tartalmat pontosan megőrzi.
- Kevesebb kód — „lusta senior fejlesztő” YAGNI: a legkisebb működő módosítás, nem kért vázkód nélkül.
- Lófarok (lusta senior fejlesztő) — végigjárja a YAGNI-létrát, kijavítja a kiváltó okot, a lehető legkisebb működő diffel.
- ADHD-m van (cselekvésközpontú) — a következő művelettel kezd, számozott lépések, egy 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
zhesetén).
- 🎯 Adaptív kontextuskeret (a szabályozó) — egyetlen be-/kikapcsolható tokenküszöb helyett csak addig fokozza a legolcsóbb, legkisebb veszteségű motorok használatát, amíg a tartalom belefér a modell kontextusablakába. Házirend:
reserve-output(alapértelmezett, modellfüggő) ·percentage·absolute. Mód:floor(garantált illeszkedés) ·replace-autotrigger(a kifejezett választásod élvez elsőbbséget) ·off(korábbi küszöbalapú működés). - 🎛️ Hol dől el a tömörítés (precedencia, magastól az alacsonyig) — kérésenkénti
x-omniroute-compressionfejléc › útválasztási kombináció felülbírálása › aktív, névvel ellátott profil › adaptív / automatikus aktiválás › panel alapértelmezése › kikapcsolva. Az alkalmazott terv visszajelenik azX-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 névvel ellátott profilt, adj meg egyszeri beállítást kérésenként, vagy rendelj folyamatot minden útválasztási kombinációhoz — attól függően, melyik illik a munkaterheléshez. Egy opcionális, offline kiértékelési keretrendszer (npm run eval:compression) rögzített korpuszon pontozza a tartalomhűséget és a megtakarítást, mielőtt élesítenél egy 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üzenetet vagy peer-függőségi figyelmeztetéseket látsz? Ezek ártalmatlanok.
A vezérlőpult címe: http://localhost:20128 · Az API címe: http://localhost:20128/v1.
2) Csatlakoztass egy INGYENES szolgáltatót (regisztráció nélkül)
Vezérlőpult → Szolgáltatók → csatlakoztasd a Kiro AI szolgáltatást (ingyenes Claude, fiókonként ~50 kredit/hónap) vagy az OpenCode Free szolgáltatást (nincs hitelesítés) → kész.
3) Állítsd be a programozási eszközödet
Alap URL: http://localhost:20128/v1
API-kulcs: [másold ki innen: Vezérlőpult → Végpontok]
Modell: auto (konfigurációmentes intelligens útválasztás — vagy bármely szolgáltató/modell)
4) Ellenőrizd a működést
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
A csatlakoztatott modellek listájának kell megjelennie. 🎉 Ennyi — kezdhetsz programozni, az OmniRoute pedig automatikusan elvégzi az útválasztást, és szükség esetén tartalékra 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 ajánlott 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 adiegosouzapw/omniroute:next-webaz aktuális alapértelmezettrelease/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ítettbun:sqliteillesztőprogramját használja, Node.js alatt pedig abetter-sqlite3, illetve asql.jshaszná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 azOMNIROUTE_USE_TURBOPACKértékét, mint Node alatt: alapértelmezés szerint Turbopacket használ; Webpackkel történő buildeléshez állítsa be azOMNIROUTE_USE_TURBOPACK=0értéket (aDockerfile.bunezt--build-argargumentumként teszi elérhetővé). - Dedikált Bun Dockerfile: Többlépcsős
Dockerfile.bunnatí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-08-24 · Nyers katalógus: YT 809 | TT 137 | IG 124 · Frissesség (nap): YT 1 | TT 21 | IG 22
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 | theopenstack — Instagram — 692,419 | milesreevesai — TikTok — 620,400 | Vaibhav Sisinty — YouTube — 391,109 | buildwithai.club — Instagram — 347,652 |
| #6 | #7 | #8 | #9 | #10 |
|---|---|---|---|---|
| nivedan.ai — Instagram — 331,973 | vaibhavsisinty — Instagram — 263,744 | Nick Automates — YouTube Shorts — 218,174 | theroshankrishna — Instagram — 186,786 | midudev — TikTok — 177,800 |
Kanonikus mérőszámok 2026-08-24-én: 1.029 egyedi videó · 11.132.922 ismert megtekintés (v > 0) · 639 csatorna/profil platformonként. A nyers vezérlőpult 1.070 sort tartalmaz; 41 Instagram-duplikátumot normalizáltunk a kanonikus URL alapján, videónként a legmagasabb megtekintésszámot megtartva.
🎬 Készítettél videót az OmniRoute-ról? Nyiss egy hibajegyet, vagy indíts egy beszélgetést a hivatkozással — itt kiemeljük.
📧 Közösség és segítség
Minden egy helyen — kövesd a karbantartót, beszélgess 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 |
| 🌍 Weboldal | omniroute.online |
| 🌍 🌍StHub OmniRoute-közösség (ingyenes) | StHub-portál |
| 📦 Forráskód | github.com/diegosouzapw/OmniRoute |
| 🐛 Hibajelentés | probléma nyitá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 eszköztár
| 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/ teljes területén (a v2.0 óta nulla any az alapkomponensekben) |
| Keretrendszer | Next.js 16 + React 19 + Tailwind CSS 4 |
| Adatbázis | better-sqlite3 (SQLite, WAL-naplózás) + LowDB (örökölt JSON) — 122 tartománymodul, 176 migráció |
| Memória | SQLite FTS5 teljes szöveges keresés + int8-kvantált vektoros beágyazások, típusos lecsengés |
| Sémák | Zod 4 — az MCP-eszközök bemeneti/kimeneti validációja + API-szerződések |
| Protokollok | MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE) |
| Adatfolyam-továbbítás | Server-Sent Events (SSE) + WebSocket-híd (/v1/ws) |
| Tömörítés | 12 motoros feldolgozási lánc — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph |
| Hitelesítés és biztonság | OAuth 2.0 (PKCE) + JWT + API-kulcsok + hatóköralapú MCP-hitelesítés · AES-256-GCM a tárolt adatokhoz · DOMPurify |
| Rejtőzködés | wreq-js — JA3 / JA4 TLS-ujjlenyomat megszemélyesítése, háromszintű proxy |
| Hibatűrés | Áramkör-megszakító, exponenciális visszalépés, tömeges egyidejű kérések elleni védelem, automatikus kombinációs öngyógyítás |
| Naplózás | pino — strukturált JSON-naplók kéréskontextussal |
| Tesztelés | Node.js tesztfuttató + Vitest — több mint 39 000 statikus tesztdeklaráció több mint 5 100 nyomon követett tesztfájlban (egység-, integrációs, E2E-, biztonsági és ökoszisztéma-tesztek) |
| Platformok | Asztali gép (Electron) · Android (Termux) · PWA (bármely böngésző) |
| CI/CD | GitHub Actions — automatikus közzététel az npm-en + Docker Hub-kiadás új verzió megjelenésekor |
| Hivatkozások | Webhely · 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ó | Az összes telepítési mód, CLI-eszközök konfigurációi, protokollbeállítások, 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ója | A Claude Code csatlakoztatása az OmniRoute-hoz (helyi/távoli) a launch és modellenkénti profilok használatával |
| Gyors kezdés | Három lépés: telepítés → csatlakoztatás → konfigurálás |
🔧 Üzemeltetés és üzembe helyezés
| Dokumentum | Leírás |
|---|---|
| Docker-útmutató | Docker run, 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 körű útmutató: virtuális gép + nginx + Cloudflare beállítása |
| Fly.io üzembe helyezés | Üzembe helyezés a Fly.io platformon 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ód esetén |
| Környezeti konfiguráció | A .env változók és hivatkozások teljes listája |
🧠 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ó | Hétlehetőséges folyamat: kikapcsolva / enyhe / normál / agresszív / ultra / RTK / rétegzett |
| 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, rétegzett folyamatok, irányítópult-/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, terhelési rohamok elleni védelem, TLS-hamisítás |
| Automatikus kombinációs motor | 16 tényezős pontozás, módcsomagok, öngyógyítás |
| Proxyútmutató | Háromszintű proxyrendszer, 1proxy piactér, regiszter-CRUD |
| Ingyenes csomagok | Összesített címtár: 34 dokumentált, ismétlődő keret / 452 katalogizált ingyenes csomagbejegyzés |
| Funkciógaléria | Az irányítópult képernyőképes, 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-kiszolgáló | 110 MCP-eszköz, IDE-konfigurációk, Python-/TS-/Go-kliensek |
| MCP-kiszolgálói útmutató | MCP-telepítés, átviteli módok és eszközreferencia |
| A2A-kiszolgáló | JSON-RPC 2.0 protokoll, képességek, streamelés, feladatkezelés |
| A2A-kiszolgálói útmutató | 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 |
| Ágazási é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ó | 42 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 39 000 statikus tesztdeklarációhoz, több mint 5 100 nyomon követett tesztfájlban |
⭐ Legfőbb közreműködők
Az OmniRoute-ot egy szenvedélyes nyílt forráskódú közösség formálja. Ezek a személyek kivételes hozzájárulásokkal közvetlenül befolyásoltá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 alapján
| Helyezés | Közreműködő | Egyesített PR-ek | ~Módosított sorok |
|---|---|---|---|
| 1 | backryun | 190 | 227,977 |
| 2 | oyi77 | 180 | 407,678 |
| 3 | rdself | 145 | 80,663 |
| 4 | JxnLexn | 128 | 387,049 |
| 5 | KooshaPari | 101 | 125,747 |
| 6 | herjarsa | 88 | 230,872 |
| 7 | RaviTharuma | 79 | 55,106 |
| 8 | maxmad64bis | 69 | 394,715 |
| 9 | artickc | 59 | 33,260 |
| 10 | HouMinXi | 51 | 47,334 |
| 10 | chirag127 | 51 | 5,153 |
| 12 | xz-dev | 50 | 245,976 |
| 13 | hartmark | 47 | 52,185 |
| 14 | rqzbeh | 39 | 143,181 |
| 15 | dhaern | 34 | 19,559 |
| 16 | Dingding-leo | 33 | 1,986 |
| 17 | NomenAK | 32 | 13,854 |
| 18 | MumuTW | 30 | 16,953 |
| 19 | benzntech | 29 | 11,641 |
| 20 | pacocartones | 24 | 9,331 |
| 20 | Prudhvivuda | 24 | 6,312 |
A számlálás a release/v3.8.50 ág aktuális dafb4ae808 csúcsán lett rögzítve, a 2026-08-24 05:26:03 UTC időpontig végrehajtott egyesítésekkel. A lapozott GitHub GraphQL-felmérés 5 911 egyesített PR-t tartalmaz: 2 707-et a tároló tulajdonosától, 179-et a Dependabottól, valamint 3 025 külső PR-t 535 különböző közreműködőtől. A „módosított sorok” a GitHub szerinti hozzáadások és törlések összege, és magában foglalja a generált fájlokat, zárolási fájlokat, katalógusokat, fordításokat és dokumentációt; ez a változtatási mennyiséget jelzi, nem a megírt forráskódsorok számát. A határértéken azonos eredményt elérők mind szerepelnek.
GitHubhoz rendelt commitok
|
backryun 🥇 220 GitHubhoz rendelt véglegesítés |
Paijo 🥈 219 GitHubhoz rendelt véglegesítés |
Randi 🥉 108 GitHubhoz rendelt véglegesítés |
Ravi Tharuma 🏅 81 GitHubhoz rendelt véglegesítés |
Chris 🏅 70 GitHubhoz rendelt véglegesítés |
Markus Hartung 🏅 69 GitHubhoz rendelt véglegesítés · holtversenyben a 6. helyen |
|
Dizzle 🏅 69 GitHubhoz rendelt véglegesítés · holtversenyben a 6. helyen |
Jan Leon 🏅 64 GitHubhoz rendelt véglegesítés |
zenobit 🏅 62 GitHubhoz rendelt véglegesítés |
Bob.Hou 🏅 51 GitHubhoz rendelt véglegesítés · holtversenyben a 10. helyen |
Xiangzhe 🏅 51 GitHubhoz rendelt véglegesítés · holtversenyben a 10. helyen |
Újraellenőrizve: 2026-08-24 06:14:31 UTC. A GitHubhoz rendelt véglegesítéseket a tároló Contributors API-ja jelentette a release/v3.8.50 alapértelmezett ágához. Az API 525 identitást adott vissza (415 felhasználó, 2 bot, 108 névtelen); ez a táblázat nem tartalmazza a karbantartót, a botokat és a névtelen identitásokat, a holtversenyeket viszont megtartja. Ez nem azonos sem a fenti, egyesített lekérési kérelmek szerinti rangsorral, sem a lentebb található, 639 személyt tartalmazó Git-metaadat-összesítéssel.
🙏 E közreműködők funkciói, hibajavításai és infrastrukturális fejlesztései alapvető részét képezik annak, hogy az OmniRoute megbízható és funkciókban gazdag. Minden lekérési kérelem, 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 mindazoknak, akik saját zsebükből finanszírozzák az OmniRoute-ot — minden hozzájárulás segít abban, hogy a projekt ingyenes, független és folyamatosan fejlődő maradjon.
![]() Andrew 💛 Aktív havi szponzor |
![]() Vlad I 💛 Aktív havi szponzor |
![]() Paco Cartones 💛 Aktív egyszeri szponzor |
![]() Prof. Igor Morais 💛 Korábbi egyszeri támogató |
![]() longtao 💛 Korábbi egyszeri támogató |
… és mások, akik inkább névtelenek szeretnének maradni 💛
A nyilvános GitHub-szponzorok újbóli ellenőrzése 2026-08-24-én történt. A fenti aktív címkéket a GitHub activeOnly állapota határozza meg; a korábban nyilvánosságra hozott egyszeri támogatóknak továbbra is köszönetet mondunk, a privát szponzorok pedig névtelenek maradnak.
💖 Legyél szponzor → — minden dollár hozzájárul ahhoz, hogy az OmniRoute ingyenes és független maradjon.
👥 Több mint 600 közreműködő
A 2026-08-24-én, a rögzített ac02c5b42f alapon elvégzett audit, majd az élő release/v3.8.50 ág dafb4ae808 csúcsán végzett újbóli ellenőrzés eredménye: 639 normalizált, emberhez tartozó Git-identitás — közülük 407 commit-szerzőként jelenik meg (beleértve a karbantartót is), 232 pedig kizárólag explicit Co-authored-by záradékokban. Az összesítés normalizálja a GitHub noreply-azonosítókat, kizár 26 bot-, ügynök-, szolgáltatás- vagy helyőrző-identitást, és nem von össze szokványos e-mail-címeket pusztán azért, mert a megjelenített nevük megegyezik.
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 amainágból) — lásd: Ágkezelési és kiadási modell - Hozd létre a funkcióágadat (
git checkout -b feat/amazing-feature) - Commitold a módosításaidat (
git commit -m 'feat: add amazing feature') - Pushold az ágat (
git push origin feat/amazing-feature) - Nyiss egy Pull Requestet úgy, hogy a célág = az adott
release/vX.Y.Zág
A részletes irányelveket lásd a CONTRIBUTING.md fájlban.
Ú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
🙏 Köszönetnyilvánítás
Az OmniRoute óriások vállán áll. A 9router elágazásaként és a CLIProxyAPI Go-projekt TypeScript-portjaként indult — ezt követően pedig minden alábbi alrendszert egy olyan nyílt forráskódú projekt ihletett, amely már korábban megvalósította az adott megoldást. Mindegyikük az OmniRoute egy-egy konkrét részét formálta. Ezúton mondunk köszönetet mindannyiuknak. 🙏
⭐ A csillagok száma 2026. augusztus 24-én lett ellenőrizve a GitHub REST API-ján keresztül — adj egy csillagot ezeknek a projekteknek. Az értékek egy adott időpontban készült pontos pillanatfelvételt tükröznek, ezért természetes módon változni fognak.
🧬 Eredet és átjáró
| Projekt | ⭐ | Hogyan inspirálta az OmniRoute-ot |
|---|---|---|
| 9router | 26,161 | 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 | 48,497 | A Go-implementáció, amely ezt a JavaScript / TypeScript-portot ihlette. |
| LiteLLM | 57,100 | Az MI-átjáró, amelynek nyilvános árazási adatkészlete táplálja a költségkövetési szinkronizálásunkat, szolgáltatónormalizálási modellje pedig alapul szolgált az útválasztásunkhoz. |
| codex-chatgpt-web | 1,410 | MIT-forrás, amelyet a csomagba foglalt ChatGPT Web → Codex Responses-hídhoz adaptáltunk, beleértve a böngészőmunkamenet-, válaszkeretezési, használati és webeskeresés-adaptereket. |
| free-claude-code | 48,112 | 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ókitakarásba és a megerősített indítási folyamatokba átemelt minták. |
| composer-api | 322 | A Cursor Composer eszközválasztási, kimenetkorlátozási és eszközvéglegesítési mintái, a natív Cursor-végrehajtóhoz adaptálva. |
| codex-multi-auth | 457 | A friss bejelentkezési és frissítési-token-rotációs minták, a Codex OAuth-újrahitelesítésbe átemelve. |
| opencode-anthropic-auth | 510 | A Claude Code-dal kompatibilis alapértelmezett átalakítások és számlázásifejléc-viselkedés, az OmniRoute konfigurációvezérelt hídjában általánosítva. |
| grok2api-merged | 2 | A Grok-modellleképezéseit, ál-TypeError Statsig-generátorát, kérés- és eszköz-alapértelmezéseit, valamint NDJSON-válaszfeldolgozóját jelentős mértékben adaptáltuk az OmniRoute Grok Web-végrehajtójához. |
| TQZHR/grok2api | 705 | A grok2api-merged mögötti elsődleges tranzitív kódforrás; modell-, fejléc-, hasznosadat-, Statsig- és feldolgozóimplementációi megmaradtak a Grok Web származási láncában. |
| chenyme/grok2api | 7,520 | A Grok hasznosadat- és eszköz-alapértelmezéseinek, a Statsig-generátornak és a TQZHR-en, valamint a grok2api-mergeden keresztül továbbörökített result.response-feldolgozónak az alapjául szolgáló MIT-forrás. |
| grok2api-pro | 27 | A grok2api-merged által a proxykészlet-rétegéhez forrásként megjelölt tranzitív forrás; az OmniRoute megőrzi ezt a származási hivatkozást, de nem állítja, hogy korlátozott hatókörű Grok Web-végrehajtója tartalmazná a proxykészlet portját. |
| GrokProxy | 50 | A sütikkel hitelesített Grok-proxyja és result.response.token streamelési mintája alapul szolgált az OmniRoute Grok Web-átviteléhez. |
| GrokBridge | 5 | Az eredeti Grok Web-implementáció figyelembe vette a HTTP-/böngészőalapú upstream kialakítását; közvetlen HTTP-útvonala a GrokProxyból származik, ezért nem állítjuk, hogy önálló kódport történt. |
| grok-web-api | 14 | A Rust ChatOptions- és válaszboríték-sémái alapul szolgáltak az OmniRoute TypeScript-alapú Grok-kérés- és streameltválasz-típusaihoz. |
🗜️ Kontextus- és token-tömörítés — motorok
| Projekt | ⭐ | Hogyan inspirálta az OmniRoute-ot |
|---|---|---|
| Caveman | 100,538 | A virálissá vált „miért használ sok token, ha kevés token is elég” projekt — ősemberbeszéd-filozófiája adja a szabványos tömörítési módunk és több mint 30 töltelékszó-eltávolítási/tömörítési szabályunk alapját. |
| RTK – Rust Token Killer | 77,185 | Nagy teljesítményű parancskimenet-tömörítés — ez ihlette 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 folyamatot. |
| headroom | 67,310 | Visszafordítható kontextustömörítés (SmartCrusher) — ez ihlette a headroom motorunkat és a ccr lekérési jelölőmintát. |
| LLMLingua | 6,598 | Prompttömörítési kutatás (LLMLingua / LLMLingua-2) — ez ihlette az aszinkron, kódbiztos, hiba esetén eredeti tartalommal továbbműködő llmlingua motorunkat. |
| llmlingua-2-js | 31 | Az LLMLingua-motorunk munkaszálas háttérrendszereként használt JS/ONNX-port (MobileBERT / XLM-RoBERTa). |
| Troglodita | 40 | PT-BR tokentömörítés — ez működteti a pt-BR nyelvi csomagunkat: a brazil portugál nyelvtanra hangolt pleonazmuscsökkentést és töltelékszó-eltávolítást. |
| ponytail | 108,957 | A virálissá vált „lusta senior fejlesztő” YAGNI-kódolási készség — ez ihlette a less-code kimeneti stílusunkat: a legkisebb működő módosításra irányító megközelítést, amely csökkenti a _generált_ kód mennyiségét (a Caveman tömör prózájának kimeneti tengelyen értelmezett párja). |
| i-have-adhd | 23,526 | A cselekvésközpontú, ADHD-barát válaszstílusát adaptáltuk az OmniRoute tömör, öt nyelven elérhető kimeneti stílusává. |
🧩 Kompakt formátumok, tokenkutatás és kódtudatos eszközök
| Projekt | ⭐ | Hogyan inspirálta az OmniRoute-ot |
|---|---|---|
| TOON | 25,233 | Tokenorientált objektumjelölés — oszlopos, fejlécből és sorokból álló modellje alakította a táblázatos tömörítési szakaszunkat. |
| GCF – Graph Compact Format | 41 | Kompakt gráfformátuma és általános profilkialakítása hozzájárult az OmniRoute táblázatos tömörítésének és Headroom-kodekformátumának megtervezéséhez. |
| gcf-typescript | 4 | Az MIT-licencű TypeScript-megvalósítás, amelyet közvetlenül beépítettünk és kibővítettünk a Headroom általános profilú kodekjeként. |
| token-optimizer-mcp | 494 | Brotli/SQLite-gyorsítótár + munkamenetenkénti kontextuskülönbség — ez ihlette a session-dedup motorunkat. |
| token-savior | 1,122 | Bash-kimenet tömörítése + MCP-profilok — ez ihlette a tömörítés megszakítására vonatkozó szabályainkat és az MCP-eszközjegyzék csökkentését. |
| token-saver | 138 | Tartalomtudatos, fájltípusonkénti kimenettömörítés hibatudatos 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 | 1,951 | „Találd meg a szellemtokeneket” — a tehermentesítési és visszaállítható hivatkozási mintája hozzájárult a CCR-tehermentesítésre vonatkozó elképzeléseinkhez. |
| TokenMizer | 28 | Egy munkamenetgráfra és fordulókon átívelő sor-deduplikációra épülő tervrajz, amely hozzájárult a session-dedup kialakításához. |
| OmniCompress | 3 | Rust-alapú oszlopos JSON + tartalomcímzett lekérés + üzeneteken átívelő deduplikáció — megerősítette a headroom/ccr/session-dedup motorjaink kialakítását és azt a gyorsítótár-stabil invariánst, hogy „a tömörített forma pozíciófüggetlen”. |
| mcp-compressor | 113 | MCP-eszközsémák és -leírások tömörítése — hozzájárult az MCP-eszközjegyzék kardinalitásának csökkentéséhez. |
| RepoMapper | 197 | Aider-stílusú repótérkép-rangsorolás — hozzájárult a repótérképek és a lekérési rangsorolás lehetőségeinek feltárásához. |
| 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,162 | TypeScript Compiler API-eszközkészlet — ez ihlette az elemzőalapú megjegyzés-eltávolításunkat, amely megőrzi a sztring-, sablon- és reguláriskifejezés-literálokat. |
🧠 Memória és RAG
| Projekt | ⭐ | Hogyan inspirálta az OmniRoute-ot |
|---|---|---|
| Mem0 | 63,902 | Univerzális memóriaréteg — a proxyt írási/olvasási határként alkalmazó modellje alakította memóriaarchitektúránkat. |
| Letta (MemGPT) | 24,382 | Állapottartó ügynökök többszintű memóriával — ez inspirálta a Context Control & Recovery (CCR) többszintű modelljét. |
| WFGY | 1,781 | A 16 visszatérő RAG/LLM-hibatípust tartalmazó ProblemMap-taxonómia — ez biztosítja a 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 | 66 | A kódolási asszisztens ↔ LLM-forgalom MITM-alapú elfogása és elemzése hozzájárult a Traffic Inspector korai követelményeinek meghatározásához. 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 megtisztítását — nyilvános protokollszabványokon alapuló, független, tisztatéri implementációkra cseréltünk. A két gazdagép-átengedési felület (passthrough.ts és _internal/bypass.cjs) továbbra is egymástól függetlenül besorolt, OmniRoute-on belüli implementáció; ezek nem lettek újraírva a csere részeként. |
| ProxyBridge | 5,995 | Transzparens, folyamatonkénti proxyútválasztás — ez inspirálta az összeomlásbiztos MITM-leállítást, a socketek inaktivitási időkorlátait, a /proc alapú folyamat-hozzárendelést és a TPROXY-forgalomelfogást. |
📚 Modelladatok, megfigyelhetőség és felhasználói felület
| Projekt | ⭐ | Hogyan inspirálta az OmniRoute-ot |
|---|---|---|
| models.dev | 6,555 | Az AI-modellek specifikációit, árazását és képességeit tartalmazó nyílt adatbázis — natívan szinkronizáljuk a modellkatalógusunkba. |
| React Flow / xyflow | 38,108 | 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 | 40,314 | A LangGraph Studio élő munkafolyamatgráf-vizualizációja inspirálta a Studio-felületeink valós idejű kaszkádnézetét. |
| Langfuse | 33,592 | A nyomkövetés → részidőtartam → generálás megfigyelhetőségi modellje alakította a Compression Studio vízesésnézetét. |
| Kiali | 3,631 | Istio szolgáltatásháló-megfigyelhetőség — ez inspirálta a megszakítójelvényeket és a hibakapcsolatok vizuális megjelenítését a Routing/Combo Studio felületén. |
| lobe-icons | 2,428 | AI/LLM-márkalogók, amelyek a szolgáltatók ikonjait jelenítik meg az irányítópultunkon. |
| flag-icons | 12,354 | Ez biztosítja a README nyelvválasztójában használt, MIT-licencű SVG-zászlókat. |
🛡️ Biztonság
| Projekt | ⭐ | Hogyan inspirálta az OmniRoute-ot |
|---|---|---|
| awesome-secure-defaults | 721 | Biztonságos alapértelmezéseket alkalmazó könyvtárak válogatott listája, amely irányt mutat biztonsági döntéseinkhez (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,564 | Ez inspirálta a kérések deduplikációjá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ékbesorolást. |
| Antigravity-Manager | 30,652 | A fióktudatos modell-újraleképezés, a végrehajthatófájl-útvonalak ellenőrzése és a csomagcímkék működése hozzájárult az OmniRoute Antigravity futtatókörnyezetének kialakításához. |
| vscode-antigravity-cockpit | 4,817 | 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 | 32,230 | ACP-integrációi inspirálták a telepített CLI-ügynökök automatikus észlelését az OmniRoute-ban. |
| CodexBar | 20,507 | Azonosította a Grok Build kvótafelületét; az OmniRoute ezt követően függetlenül ellenőrizte és javította az éles vezetékes formátumot. |
📄 Licenc
MIT-licenc – a részletekért lásd: LICENSE.
⬆ Vissza a tetejére · ❤️-vel készült a nyílt forráskódú MI-közösség számára.
OmniRoute v3.8.51 · Node ≥22.22.2 · MIT-licenc · omniroute.online





