mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-19 05:12:16 +03:00

Files

Diego Rodrigues de Sa e Souza b637350680 fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

1,104 mirrors rewritten over five passes of run-translation on the 22-source core set: the 14 sources edited since their translation, the 322 mirrors that were still English copies, and the frontmatter the old extractor leaked into the newer locales' bodies. The pipeline now caches per-`## `-section hashes and retranslates only changed sections, never reuses a section that is still English, rebuilds English-copy / leaked mirrors even when the source is unchanged, merges the state on save (parallel runs), and the drift gate (scoped to the core set) is blocking. Final audit: 0 stale, 0 English copies, 0 leaked frontmatter across 1,430 core mirrors.

⚠️ base-red inherited: #12732

2026-09-17 02:55:31 -03:00

docs

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CHANGELOG.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CLAUDE.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CODE_OF_CONDUCT.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CONTRIBUTING.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

GEMINI.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

llm.txt

fix(db): bound health scans and isolate native diagnostics (#13717 )

2026-09-16 12:59:45 -03:00

README.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

SECURITY.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

README.md

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

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

OmniRoute — Soha ne hagyd abba a kódolást. Minden AI-eszköz → 359 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 többrétegű tömörítés 15–95%-kal csökkenti a tokenfelhasználást (átlagosan ~89%-kal) — így sosem éred el a korlátokat. 359 AI-szolgáltató · több mint 150 ingyenes csomag · ~1,47 milliárd ingyenes token/hó · 19 útválasztási stratégia · indulás $0-ból.

💰 ~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).

OmniRoute ingyenes csomag keretkártyája: stabilan ~1,47 milliárd ingyenes token havonta, a regisztrációs kreditekkel pedig akár ~2,07 milliárd az első hónapban, 34 dokumentált ismétlődő készletkulcsból, amelyek 452 katalogizált ingyenes csomagbejegyzést fednek le egyetlen végpont mögött. Őszinte, készletalapú duplikációszűréssel végzett számítás — minden megosztott készlet csak egyszer számít, beleértve 16 ismétlődő készletet közzétett, pozitív havi tokenkerettel, valamint öt modellenkénti Groq-korlátot; 13 szolgáltató kerülendőként van megjelölve a felhasználási feltételek kockázati katalógusában, így te dönthetsz. A keretsáv tartalmazza a Mistral 1 milliárdos, a Nara 210 milliós, az LLM7 150 milliós és a Groq 30 milliós keretét (öt modellenkénti korlát), valamint kisebb készleteket, továbbá külön jeleníti meg az első havi regisztrációs krediteket és a tartósan ingyenes, tokenkorlát nélküli szolgáltatókat, így azok soha nem növelik mesterségesen a főösszeget. Élő felhasznált/fennmaradó adatok: /dashboard/free-tiers.

A működő /dashboard/free-tiers oldal 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

🌐 66 nyelven

🆓 A telepítés pillanatától működik — kulcsok és konfiguráció nélkül

A telepítés pillanatától működik — konfiguráció nélkül. Három lépés: 1. Telepítés — npm i -g omniroute, a szerver elindul a localhost:20128 címen. 2. Irányítsd az eszközödet a http://localhost:20128/v1 címre — bármilyen OpenAI-kompatibilis eszköz használható (Claude Code, Cursor, Cline). 3. Válaszol — hívd meg az auto modellt az azonnali válaszért, API-kulcs, regisztráció és konfiguráció nélkül. A kulcs nélküli OpenCode Free szolgáltató előre be van kötve az auto kombinációba, így egy friss telepítés azonnal használható.

# 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?

Az OmniRoute kéréseinek folyamata: az IDE-d vagy CLI-d (Claude Code, Cursor, Cline…) egyetlen helyi végpontot (http://localhost:20128/v1) hív meg; az OmniRoute intelligens útválasztója (RTK + Caveman tömörítés, 19 útválasztási stratégia, megszakító áramkörök, rejtett TLS-kommunikáció, MCP, A2A, védőkorlátok) négy szolgáltatói szint között válthat tartalékra mindaddig, amíg marad egy alkalmas, működőképes célpont — 1. szint: előfizetés, 2. szint: API-kulcs, 3. szint: olcsó és 4. szint: ingyenes.

🤝 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ó

Mind a 19 kombinált útválasztási stratégia animálva — stratégiánként egy csempe: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. A fenti táblázat ismerteti az egyes stratégiák működését.

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)

OmniRoute reziliencia — 3 független, öngyógyító réteg, a megfelelő réteg a megfelelő hibához. 1. réteg: szolgáltatói áramkör-megszakító (teljes szolgáltató): csak 408/5xx esetén aktiválódik, küszöbértékek: OAuth 8× / API-kulcs 12× / helyi 2×, visszaállítás 60s/30s/15s után HALF-OPEN próbaállapotba, lusta helyreállítás; OPEN állapotban a kombináció a következő szolgáltatóhoz irányít át. 2. réteg: kapcsolati várakozási idő (egy kulcs/fiók): alapérték 5s OAuth / 3s API-kulcs esetén, exponenciális ×2 visszalépés a hirtelen egyidejű újrapróbálkozásokat megakadályozó védelemmel, a 429 tiszteletben tartja a Retry-After értékét, a siker minden hibaállapotot töröl; a várakozási idő alatt lévő kulcs kimarad, miközben a többi kulcs továbbra is kiszolgál. 3. réteg: modellzárolás (egy modell): a modellenkénti 429, a helyi 404 vagy az üzemmód megtagadása csak az adott modellt zárolja — soha nem a teljes kapcsolatot. A végállapotokat (letiltva, lejárt, kreditek kimerültek) az üzemeltetőnek kell kezelnie, ezek nem várakozási idők.

_{📖 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.md fá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; az omniroute run 7 CLI-t indít el (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); az omniroute configure 10 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 egy antigravity OAuth-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-Decision fejlécet, amely megnevezi a kiszolgáláshoz használt stratégiát, szolgáltatót és késleltetést; az új cache-optimized kombinációs stratégia és az Auto-Combo cacheAffinity té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}/candidates végpont pedig felfedi egy auto/* 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/chaos hibainjektá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}

＋ ezekkel is működik · Kiro · Command Code · Antigravity · Windsurf · AMP · bármely OpenAI-kompatibilis eszköz

_{📖 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: true felderí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

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 10K neuron/nap}	NVIDIA NIM _{GLM, MiniMax ~40 RPM ingyenesen}	Cerebras _{GLM 4.7, GPT-OSS 1M token/nap}	OpenRouter _{:free modellek +$10 → magasabb RPM}

📖 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 serve akkor 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}

Animált termináldemó az OmniRoute CLI-ről — omniroute providers list, omniroute combo list és omniroute health — végiglépkedve a felső szintű, 86 parancsból álló 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-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 OmniRoute tömörítési folyamata: egy szemléltető, 10 000 tokenes klienskérés 12 kombinálható motoron halad keresztül — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra és OmniGlyph —, és a dokumentált, egymásra épülő példában körülbelül 1080 tokennel érheti el a szolgáltatót. A strukturált tartalmat megőrzési védelmek és lépésenkénti hűségellenőrzések óvják; a kifejezetten veszteségesként vagy kísérletiként megjelölt módok átalakíthatják az arra alkalmas tartalmat.

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 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 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 / ultra intenzitá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 zh eseté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-compression fejlé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 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 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 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-08-24 · Nyers katalógus: YT 809 | TT 137 | IG 124 · Frissesség (nap): YT 1 | TT 21 | IG 22}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 megtekintés}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 megtekintés}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 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	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 a main á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

🌍 StarMapper

🙏 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}

README.md Unescape Escape

README (Magyar)

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

💰 ~1,47 milliárd ingyenes token / hónap

⭐ 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

📈 Az átjáró folyamatosan növekszik

🧩 Elérhető

🆓 A telepítés pillanatától működik — kulcsok és konfiguráció nélkül

💥 Az ígéret

🤔 Miért az OmniRoute?

🤝 Nyílt forráskódú barátaink támogatásával

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

⚡ Nulla konfiguráció — csak használd az auto modellt

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

🧱 Beépített reziliencia (3 független réteg)

🏆 Mi teszi különlegessé az OmniRoute-ot

💚 Az OmniRoute támogatása

📡 OmniRoute Radar

✨ Újdonságok

🤖 Kompatibilis CLI-k és kódoló ügynökök

🌐 352 AI-szolgáltató — 152 katalógusban ingyenesként megjelölve

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

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

🖥️ Hol fut az OmniRoute — bárhol

🧩 Újdonság: OmniRoute a VS Code natív Copilot Chat felületén

🎩 Újdonság: OmniRouteTray — az átjáród közvetlenül a menüsávban

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

🔌 Teljes CLI + A2A és MCP

⌨️ Valódi CLI (nem csak start)

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

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

🗜️ 15–95%-os tokenmegtakarítás — automatikusan

📖 Hogyan működik — folyamat, architektúra és a megtakarítás kiszámítása

🧱 A 12 motorból álló rendszer

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

⚡ Gyors kezdés

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

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

📹 Videóútmutatók

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

🛠️ Technológiai eszköztár

📖 Dokumentáció

📘 Első lépések

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

🧠 Funkciók és architektúra

🤖 Protokollok és API-k

📋 Projekt és minőség

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

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

GitHubhoz rendelt commitok

💖 Szponzorok

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

Hogyan járulhatsz hozzá

Új verzió kiadása

📊 Csillagok

🌍 StarMapper

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

🧬 Eredet és átjáró

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

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

🧠 Memória és RAG

🛰️ Forgalomvizsgálat, MITM és transzparens proxy

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

🛡️ Biztonság

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

📄 Licenc

README.md

⚡ Nulla konfiguráció — csak használd az `auto` modellt

⌨️ Valódi CLI (nem csak `start`)