## 💰 ~1,62 milliárd token / hónap harmadik féltől származó ingyenes csomagokból
> **Hozd a saját szolgáltatói fiókjaidat.** Ez egy becsült összesítés a külön-külön jogosult harmadik féltől származó ingyenes csomagokból, nem pedig token-juttatás az OmniRoute-tól. Regisztrálj, szerezd be a szükséges hitelesítő adatokat, és kösd be azokat a szolgáltatókat, amelyeket használhatsz; minden szolgáltató maga szabályozza a korlátait, elérhetőségét és feltételeit.
>
> Az ingyenes csomagok kézi egymásra halmozása fájdalmas — több tucat SDK, több tucat sebességkorlát, és fogalmad sincs, mennyid van valójában. Az OmniRoute **467 ingyenes csomagbejegyzést tart nyilván 34 ismétlődő pool-kulcs alatt**, és a token-főszámot a **17 közzétett pozitív havi kerettel rendelkező poolból, valamint öt modellenkénti Groq-korlátból** számítja, a közös poolok szerint deduplikálva. A csak regionális személyazonosság-ellenőrzés után megnyíló keretek (ma: ModelScope) külön jelennek meg, +~6M regionális identitás-ellenőrzés mögött, és soha nem számítanak bele a főszámba. Az eredmény a dashboardon marad látható (`/dashboard/free-tiers`).
> Az élő `/dashboard/free-tiers` oldal animált összefoglalója. Teljes módszertan (pool-dedupe, kredit-szintek, szolgáltatói feltételek): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ezeket az adatokat kéthetente újra ellenőrizzük az élő katalógus alapján, és **mindkét irányba mozognak** — egy szolgáltató megszünteti az ingyenes csomagját, és a szám csökken; újat vezet be egy másik, és emelkedik. Azt tesszük közzé, amit a katalógus ténylegesen kiszámít, soha nem egy felfelé kerekített legjobb esetet.
⭐ Csillagozd meg a repót, ha az OMNIROUTE segített pénzt megtakarítani és könnyebbé tenni a munkádat.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 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:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Kérdések, szolgáltatói tippek, ütemterv és támogatás → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 A Gateway tovább növekszik
## 🆓 Telepítés, szolgáltató csatlakoztatása, majd irányítás egyetlen végponton keresztül
```bash
# After connecting a provider, copy your OmniRoute key from Dashboard → Endpoints:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
Az `auto` értékhez jogosult útvonal szükséges. Egy friss telepítésnek lehet, hogy nincs jogosult kulcs nélküli célpontja, és egy kulcs nélküli szolgáltató elutasíthatja a harmadik féltől származó klienseket. A `tos: avoid` jelöléssel ellátott szolgáltatók – köztük a Kiro – alapértelmezés szerint ki vannak zárva az automatikus útvonalválasztásból; egy fiók csatlakoztatása nem írja felül ezt a beállítást. A szolgáltató kiválasztása előtt lásd a [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) dokumentumot.📦 Másolható-beilleszthető gyorsindító szkriptek **Python, Node.js, PHP és cURL** nyelvekhez → [`examples/quickstart/`](examples/quickstart/)
# 💥 Az ígéret
# 🤔 Miért az OmniRoute?
## 🤝 Támogatnak nyílt forráskódú barátaink
> **Szeretnél csatlakozni nyílt forráskódú barátként?** Ezek azok a cégek, amelyek támogatják a nyílt forráskódot, és segítenek az OmniRoute működésében – és nyilvánosan elmondjuk, hogy minden tőlük kapott token mire megy. Keress minket: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Köszönjük a Kimi (Moonshot AI)-nak, alapító nyílt forráskódú barátunknak, hogy támogatja ezt a projektet! A Kimi az AI labor a nyílt súlyú K2 és K3 modellcsaládok mögött — a Kimi K3 1M-token kontextusablakot, natív látást és határszintű kódolást biztosít a zárt modellek árának töredékéért, és azonnal működik a Claude Code, Codex és minden kódoló eszközzel, amit az OmniRoute kiszolgál.
Mire használja a Kimi támogatását: A Kimi API kreditek az OmniRoute AI-val validált kiadási folyamatát táplálják — a Kimi K3 által működtetett egyesítési validálás fázist, amely minden pull requestet áttekint, mielőtt kiadják — plusz a napi funkciófejlesztést. Az első osztályú Kimi támogatás mindkét sínen elérhető: a közvetlen Kimi API (kimi-k3) és a Kimi Code kódolási terv (OAuth és API kulcs). Az OmniRoute az első brazil nyílt forráskódú projekt a Kimi támogatási programjában. Szerezzen Kimi API kulcsot 15% extra kredittel →
Cheaper Inference cheaperinference.com
Köszönjük a Cheaper Inference-nek, az OmniRoute nyílt forráskódú barátjának, hogy támogatja ezt a projektet! A Cheaper Inference egy költség-rangsorolt átjáró, amely 42 határmodellt – Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok és MiniMax – értékesít egy OpenAI-kompatibilis végpont mögött, minden kérést a legolcsóbb jogosult szolgáltatóhoz irányítva anélkül, hogy valaha is többet számolna fel, mint a modellgyártó listaára.
Első osztályú támogatás az OmniRoute-ban: Chat Completions, a natív /v1/responses végpont, látás, eszközhívás és 3 képmodell (grok-imagine, nano-banana-pro, nano-banana-2, elérhető mint cheaperinference/<model>). Szerezzen API kulcsot →
Az aff=omniroute címkével ellátott linkek partnerlinkek. Ezek a projektet finanszírozzák Önnek többletköltség nélkül. 🎟️ Partneri promóció — ingyenes regisztrációs kuponok olyan szolgáltatóktól, amelyeket nem szponzorálunk (kattintson a kibontáshoz)Ez a szakasz csak ajánló/kuponkódokról szól. A szponzorált partnerségek a fenti 🤝 Támogatnak nyílt forráskódú barátaink részben találhatók. Az OmniRoute-nak nincs szponzorálási vagy partnerségi kapcsolata az itt felsorolt szolgáltatókkal – ezek nyilvános kuponok, amelyeket bárki használhat.
AgentRouter agentrouter.org
AgentRouter — partneri regisztráció · 100 dollár ingyenes kredit regisztrációkor (ingyenes szerver, magasabb késleltetésre számíthat – tesztelésre a legjobb, nem éles környezetbe). Első osztályú támogatás az OmniRoute-ban v3.8.50 óta: Chat Completions, az Anthropic-kompatibilis vezetékes formátum és az OpenAI-kompatibilis útvonal. Elérhető modellek: claude-opus-4-8, claude-opus-5, gpt-5.6-sol és még sok más. Szerezze meg a 100 dollárját →
⚠️ Partneri link – Az OmniRoute-nak nincs szponzorálási vagy partnerségi kapcsolata ezzel a szolgáltatóval.
Ismer más szolgáltatót, amely nagylelkű ingyenes regisztrációs kupont kínál, ami az OmniRoute felhasználóinak előnyére válik? Nyisson egy hibajegyet, és hozzáadjuk ide.
## 🎯 Kombók — A zászlóshajó
> A **kombó** olyan modelllánc, amelyen az OmniRoute **automatikusan** végzi az útválasztást. Ha elfogy a kvóta, meghibásodik egy szolgáltató, vagy megugranak a költségek, a kombó továbbléphet a következő megfelelő és működőképes modellre. 🛡️
### ⚡ Konfiguráció nélkül — csak használd az `auto` értéket
Nem kell kombót létrehoznod. Állítsd a modelledet `auto` értékre (vagy valamelyik változatára), és az OmniRoute a csatlakoztatott szolgáltatóidból valós időben pontozott virtuális kombót hoz létre:
Modellazonosító
Mire optimalizál
auto
🎯 Kiegyensúlyozott alapértelmezés (LKGP — ragaszkodik a legutóbbi jól működő szolgáltatóhoz)
auto/coding
🧑💻 A minőséget előnyben részesítő súlyozás kódgeneráláshoz
auto/fast
⚡ Először a legalacsonyabb késleltetés
auto/cheap
💰 Először a tokenenként legolcsóbb
auto/subscription
🎟️ Csak a már kifizetett előfizetési kvóta — zárt hibakezelés, soha nincs számlázható tartalékmegoldás (útmutató)
auto/thrifty
🪜 Először a csomag kvótája, majd fokozatosan a legolcsóbb fizetős lehetőségek — a visszaállítás után ismét a csomagot használja (útmutató)
auto/offline
🔋 Először a legnagyobb kvóta- és sebességkorlát-tartalék
auto/smart
🔭 A minőséget helyezi előtérbe + 10%-os felderítés a jobb modellek megtalálásához
auto/lkgp
📌 Kifejezett ragaszkodás a legutóbbi jól működő szolgáltatóhoz
auto/chaos
🧪 Párhuzamos szétosztás egy modellpanelre (szolgáltatónként egy, alapértelmezés szerint 5), és egyetlen választ ad vissza; panelmodellenként egy felsőbb szintű hívás, nem hibabefecskendezés
##
### 🔀 Vagy készíts sajátot — 20 útválasztási stratégia
Mind a **20** stratégia — szabadon kombinálhatók a kombó egyes lépéseiben:
#
Stratégia
Működés
1
priority
Az első célpontot előnyben részesítő rendezett lista — mindegyiket kimeríti, mielőtt a következőre lép 🥇
2
fill-first
Teljesen felhasználja az egyes célpontok kvótáját, mielőtt továbblépne
3
weighted
Súlyozott véletlenszerű kiválasztás a célpontonkénti súly alapján
4
round-robin
Sorrendben, körkörösen halad végig a célpontokon
5
p2c
Véletlenszerű terheléselosztás két lehetőség közötti választással
6
least-used
A jelenleg legkisebb terhelésű célpontot választja
Véletlenszerű kiválasztás az ismétlődések eltávolítása nélkül 🎲
9
cost-optimized
Minimalizálja a kérésenkénti költséget az élő katalógus árai alapján 💸
10
headroom
A legtöbb fennmaradó kvótával rendelkező célpontot választja
11
quota-weighted
Kihagyja a kimerített fiókokat, majd a fennmaradó kvóta ÷ folyamatban lévő terhelés arányában választ — a meglévő beszélgetések az eredeti célponthoz rögzítve maradnak ⚖️
12
reset-window
Azt a célpontot részesíti előnyben, amelynek kvótaablaka a leghamarabb áll vissza
13
reset-aware
A kvóta visszaállítási ideje alapján rangsorol — először a rövid időablakok 📊
14
context-relay
Hosszú beszélgetéseknél átadja a kontextust a célpontok között 🧠
15
context-optimized
Az aktuális kontextusmérethez legjobban illő célpontot választja
16
cache-optimized
Minden újrafelhasználható promptelőtagot ugyanahhoz a fiókhoz rögzít — maximalizálja a promptgyorsítótár találatait 🎯
17
lkgp
Legutóbbi ismerten működő útvonal — az utolsó sikeres szolgáltatóhoz rögzít, majd szükség esetén a szabályokra vált
18
auto
16 tényezős, valós idejű pontozás minden kapcsolaton 🤖
19
fusion
Szétosztja a kérést egy modellpanelre, majd egy bíráló egyetlen választ állít össze 🧬
20
pipeline
Lépések láncolata — minden célpont kimenete a következő bemenete lesz 🔗
Az Auto-Combo motor minden jelöltet **16 tényező** (állapot, kvóta, költség, késleltetés, feladathoz való illeszkedés, minőség, munkamenet elérhetősége…) alapján pontoz — lásd: [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Beépített ellenálló képesség (3 független réteg)
📖 [Auto-Combo motor](docs/routing/AUTO-COMBO.md) · [Ellenálló képességi útmutató](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Miben emelkedik ki az OmniRoute
📊 Teljes módszertan és funkciónkénti részletek a 9router, az OpenRouter, a CLIProxyAPI és a LiteLLM megoldásokkal összehasonlítva → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](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.
**🇧🇷 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](https://github.com/diegosouzapw/OmniRoute/discussions).
Fejlesztői megjegyzések: A projekt a fejlesztők kényelme érdekében létrehozhat egy helyi .env fájlt az npm install/postinstall során. Ezt a fájlt a rendszer szándékosan figyelmen kívül hagyja a .gitignore segítségével (lásd: .gitignore), és soha nem szabad commitolni — ha véletlenül mégis commitolta, cserélje le az összes nyilvánosságra került titkos adatot, és távolítsa el a fájlt az előzményekből. A helyi környezeti fájlok és titkos adatok kezelésével kapcsolatos útmutatásért lásd: docs/DEVELOPER-ENVIRONMENT.md.
## 📡 OmniRoute Radar
A fő, ingyenes csomagra vonatkozó érték továbbra is **~1,62 milliárd token/hó** a fent dokumentált, készletek között duplikációmentesített katalógus alapján. A szolgáltatók ideiglenes regisztrációs jóváírásai ezen felül az első havi keretet **~2,22 milliárdra** növelhetik. A Radar egy opcionális, aláírt katalógusréteg azok számára, akik az OmniRoute kiadásai között naprakészebb információkat szeretnének az ingyenes modellek elérhetőségéről; a közösségi katalógus és minden meglévő ingyenes funkció továbbra is ingyenes marad.
A támogatók hozzáférhetnek az élő katalógushoz és további szolgáltatói lehetőségekhez. Ennek különálló, változó felső határa a szolgáltatók elérhetőségétől függően **legfeljebb körülbelül 3 milliárd token/hó**. Ez a felső határ nem jelent garanciát: a szolgáltatók bármikor módosíthatják a kvótákat, a jogosultsági feltételeket, a modelleket vagy a régiókat.
A Radar használata opcionális, és kizárólag GET-kéréseket alkalmaz. Az OmniRoute kliens nem tölt fel promptokat, forgalmi adatokat, szolgáltatói konfigurációt, használati telemetriát vagy a közlemények elvetésének helyi állapotát. A jogosultsági feltételekről és az aktuális katalógusról a **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** oldalon tájékozódhat.
## ✨ Újdonságok
> Legutóbbi fénypontok a **v3.8.20 → v3.8.53** verzióból. Teljes előzmény: [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ `quota-weighted` útvonalválasztás** — a 20. kombó-stratégia kihagyja a kimerült fiókokat, majd a többiek közül a maradék kvóta ÷ folyamatban lévő terhelés arányában választ, miközben a meglévő beszélgetések rögzítve maradnak. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless mód** — az `omniroute serve --headless` (vagy `OMNIROUTE_HEADLESS=1`) csak a `/v1/*` proxy motort futtatja, az irányítópult és a csak-irányítópult alrendszerek kikapcsolásával. → [Headless mód](docs/guides/HEADLESS.md)
- **🔎 Modellfelderítés** — a `/v1/models` szűr képesség, kontextus, fajta és szöveg szerint, a `POST /v1/models/query` pedig egy rövid, determinisztikus szűkített listát ad vissza ugyanazzal a kulcsonkénti láthatósággal. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🔑 Kulcsonkénti útvonalvezérlés** — rögzíts egy API-kulcsot egyetlen modellhez vagy kombóhoz a `forcedModel` segítségével, és atomikusan add hozzá vagy távolítsd el egy kulcs modelljeit és kombóit (`/api/keys/{id}/access`). → [API-referencia](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Finomabb PII-vezérlők** — típusonkénti kiválasztás, akár 20 validált egyéni maszkolási minta és típusonkénti észlelési számlálók; maga a maszkolás továbbra is opt-in. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 nyelv** — irányítópult, dokumentáció-tükrök és CLI, ahol az `npm run i18n:add-locale` egyetlen paranccsal mindenhol hozzáad egy nyelvet. → [i18n útmutató](docs/guides/I18N.md)
- **🎛️ OmniConductor** — bejövő A2A delegálás az ügynökflottádhoz, Conductor készségek az Agent Cardon, és egy irányítópult-panel Faro push-to-talk hangcsevegéssel. → [A2A szerver](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptív beléptetés és túlterhelés-védelem** — a nagy súlyú csevegési kérések sorba állnak 503 helyett, atomi RPM gördülő lease-ekkel kapcsolatonként. → [Reziliencia-útmutató](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonikus `/v1/models` sorrend** — szolgáltatónként egy összefüggő, szolgáltató szerint csoportosított blokk (a kombók elöl rögzítve), minden katalógusforrás esetében stabil. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🗜️ Tömörítés megerősítése** — alapértelmezés szerint bekapcsolt inflation guard, Caveman csomagok DE / FR / JA + kínai (wényán) nyelvhez, RTK szűrők Gradle & .NET-hez. → [Tömörítés](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Őszinte átalánydíjas költség** — az előfizetéses / coding-plan szolgáltatók **$0**-ként jelennek meg a költség-analitikában; a büdzsé, a kvóta és az útvonalválasztás továbbra is becsül. → [API-referencia](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share útvonalválasztás** — egy megosztott fiók kvótájának méltányos felosztása a közös kulcsok között, munkakonzerváló módon, így a tétlen szeletek kölcsönadásra kerülnek. → [Reziliencia-útmutató](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Egyparancsos CLI/ügynök-beállítás** — 15 regisztrált `setup-*` parancs; az `omniroute run` 7 CLI-t indít (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); az `omniroute configure` 11 célt támogat interaktív szolgáltató+modell-választóval és kontextusonkénti kedvencekkel. → [CLI-integrációk](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Távoli mód** — távoli OmniRoute vezérlése hatókörözött tokenekkel (`connect` / `contexts` / `tokens`) + egy `antigravity` OAuth segéd VPS-telepítésekhez. → [Távoli mód](docs/guides/REMOTE-MODE.md)
- **🧭 Okosabb automatikus útvonalválasztás** — `auto/:` kombók, **Fusion** (modellpanel + bíró), feladattudatos útvonalválasztás, kérésenkénti modell / mód / USD-büdzsé felülírások. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Bővíthető tömörítés** — 12 komponálható motor + Compression Studios: LLMLingua-2, kétszintű Ultra, omniglyph, lépésenkénti hűségkapu, GCF v3.2, húzd-és-áthelyezd szerkesztő. → [Tömörítés](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Átlátszó MITM-visszafejtés (TPROXY)** — a proxy környezeti változókat figyelmen kívül hagyó CLI-k elfogása, SNI-nkénti CA + trust-store telepítővel. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Költség-telemetria mindenhol** — `X-OmniRoute-*` költség/használat fejlécek minden végponton, cache-HIT megtakarítás fejléc, kulcsonkénti USD-költési kvóták. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🧠 Általad vezérelt memória** — alapértelmezés szerint kikapcsolva, opcionális int8 vektor-kvantálás + tipizált lecsengés, kérésenkénti `x-omniroute-no-memory`. → [Memória](docs/frameworks/MEMORY.md)
- **🛡️ Biztonság** — prompt-injection védelem minden LLM-útvonalon (red-team csomag), opcionális hitelesítőadat-maszkoló guardrail (mindkét irányban kitakarja a kiszivárgott API-kulcsokat/titkokat), ingyenes DuckDuckGo végső webes keresés, és opcionális OIDC bejelentkezési kapu az irányítópulthoz (a jelszavas bejelentkezés mindig elérhető marad). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ Új végpontok** — a `/v1/ocr` (Mistral OCR) és a `/v1/audio/translations` (Whisper-stílusú) teljessé teszi a médiával kapcsolatos felületet. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🎨 Kép / videó / hang generálás** — egyetlen API a médiához: xAI Grok Imagine & Novita AI videó, ComfyUI, Magnific, Adobe Firefly, Segmind, valamint beszédszolgáltatók, például az ElevenLabs. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🌍 Telepítés és üzemeltetés** — reverse-proxy `basePath`, böngészőnyelv automatikus felismerése, kulcsonkénti eszközkövetés, root nélküli MITM trust, zh-TW lokalizáció. → [Környezet](docs/reference/ENVIRONMENT.md)
- **🤝 Több szolgáltató és ügynök** — felhőügynökök (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) böngészős + OAuth bejelentkezéssel, Ollama első osztályú kártya, Claude Opus 5 & Sonnet 5, hivatalos Kimi partnerség (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… és egy frissített **375 szolgáltatós katalógus**. → [Szolgáltatók](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Útvonalválasztási átláthatóság** — minden válasz hordoz egy `X-OmniRoute-Decision` fejlécet, amely megnevezi az őt kiszolgáló stratégiát/szolgáltatót/késleltetést; egy új `cache-optimized` kombó-stratégia + Auto-Combo `cacheAffinity` tényező visszairányítja az ismétlődő kéréseket a gyorsítótárazott előtagot tartó kapcsolathoz; és egy csak olvasható `/v1/auto-combo/{channel}/candidates` végpont feltárja egy `auto/*` csatorna élő jelöltkészletét. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Helyi teljesítmény és infrastruktúra** — egykattintásos helyi Redis, Cloudflare Workers / Deno Deploy relay-telepítők, valamint Bifrost és Mux felügyelt beágyazott szolgáltatásként. → [Beágyazott szolgáltatások](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Szintén a csomagban** — bővítménykeretrendszer és piactér, Omni/Agent/GitHub készségkeretrendszerek, Obsidian vault integráció (22 MCP-eszköz), OpenAI-kompatibilis Batch és Files API-k, szemantikus válaszgyorsítótár, játékosítás ranglistákkal, ACP-ügynökfelderítés (15 beépített ügynök), ütemezett naplóexport BigQuery-be, `auto/chaos` párhuzamos többmodelles szétosztás, Telegram bot híd, alkalmazáson belüli verziókezelő és LMArena-ELO ingyenes szolgáltatói rangsorok. → [Dokumentáció](docs/README.md)
## 🤖 Kompatibilis CLI-k és kódolási ügynökök
> Egyetlen konfiguráció — `http://localhost:20128/v1` — és **minden** AI-alapú IDE vagy CLI ingyenes és alacsony költségű modelleken fut.
**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 beadott hitelesítő adatokkal, a Qwen/Gemini számára pedig ideiglenes, elkülönített saját könyvtárral:
```bash
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 hozza létre az eszköz saját konfigurációját:
omniroute configure codex # továbbá: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Minden parancs figyelembe veszi az aktív távoli környezetet (`omniroute connect `), 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 shell előzményeitől. → [CLI-integrációk](docs/guides/CLI-INTEGRATIONS.md)
> **375 regisztrált szolgáltató** a kanonikus chat-, média-, kereső-, helyi, felhőügynök- és rendszerkollekciókban, köztük **153, amely `hasFree: true` felfedezési metaadatot hordoz**. A chatmodell-nyilvántartás **239 szolgáltatót / 3 059 különálló szolgáltató–modell párt / 1 475 nyers modell-ID-t** fed le; a különálló ingyenesmodell-katalógus **467 modellenkénti sort**, **34 ismétlődő poolt** és **51 ismétlődő/kulcs nélküli, örökre ingyenes** elemet tartalmaz. Ezek szándékosan különböző nevezők; a definíciók és a poolok duplikációit kiszűrő számítások a [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) és a [Free Tiers](docs/reference/FREE_TIERS.md) dokumentumban találhatók.
### 🏢 Minden jelentős labor — egyetlen végponton keresztül
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…és további 350+ — minden ikon valós időben töltődik be az irányítópult szolgáltatókatalógusából. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Örökre ingyenes — 0 $, bankkártya nélkül
OpenCode Zen DeepSeek V4, Nemotron 3 Nincs tokenkorlát
Kilo Code Auto-router, 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 Nem szükséges kulcs
Cloudflare AI 50+ modell 10K neuron/nap
NVIDIA NIM GLM, MiniMax ~40 RPM ingyen
Cerebras GLM 4.7, GPT-OSS Egyszeri 5 $ kredit; bankkártya szükséges
### 🧩 Ú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](https://github.com/diegosouzapw/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.
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](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Code Copilot Chat útmutató](docs/guides/VSCODE-COPILOT.md) — 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](https://github.com/zoispag/omniroute-tray)**
> 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](https://v2.tauri.app/) 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
```sh
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.
> A szerveren túl az OmniRoute egy **teljes parancssori vezérlőpult** **több mint 80 paranccsal**, valamint nyílt ügynökprotokollokkal, így egy MI-ügynök **önállóan** is vezérelheti.
### ⌨️ Valódi CLI (nem csupán `start`)
```bash
omniroute # átjáró + irányítópult kiszolgálása (20128-as port)
omniroute chat # interaktív TUI-csevegőkliens (perjeles parancsok: /model /combo /skill /memory)
omniroute setup # vezetett első indítási varázsló
omniroute doctor # szolgáltatók, portok és natív függőségek diagnosztizálása
```
### 🛰️ Távoli mód — a CLI itt, az OmniRoute egy VPS-en fut
Az OmniRoute egy szerveren fut? Vezérelje laptopjáról **ugyanazzal a CLI-vel**. Jelentkezzen be egyszer
egy korlátozott hatókörű hozzáférési tokennel; ezután minden parancs a távoli példányt célozza.
```bash
omniroute connect 192.168.0.15 # jelszó → korlátozott hatókörű token, kontextusként mentve
omniroute models # ← a TÁVOLI szerveren fut
omniroute configure codex # ← kiválaszt egy távoli modellt, és létrehoz egy helyi Codex-profilt
omniroute tokens create --name ci --scope read # szűkebb hatókörű tokenek létrehozása más gépekhez
omniroute contexts use default # ← visszaváltás a helyi szerverre
```
A tokenek hatóköre `read` / `write` / `admin`; a folyamatokat indító útvonalak kizárólag a visszacsatolási interfészen érhetők el.
📖 [Távoli mód](docs/guides/REMOTE-MODE.md)
### 🤝 Csatlakoztasson egy ügynököt — és az maga vezérli az OmniRoute-ot
Tegye elérhetővé az OmniRoute-ot **MCP**, **A2A**, **REST API**, **webhookok** vagy **távoli CLI** használatával — így bármely megfelelő képességű ügynök (vagy a saját kódja) önállóan hozzáférhet a teljes átjáróhoz: útválasztás, szolgáltatók, kombinációk, gyorsítótár, tömörítés és memória. Az alábbi HTTP-végpontok a `http://localhost:20128` címen érhetők el.
Interfész
Végpont / parancs
Felhasználási terület
🧰 MCP (stdio)
omniroute --mcp
Integráció a Claude Desktop, a Cursor vagy bármely MCP-kliens használatával
🌊 MCP (HTTP)
/api/mcp/stream
Távoli MCP — 110 eszköz, 33 hatókör (a kikényszerítés opcionális), teljes auditnapló
📡 MCP (SSE)
/api/mcp/sse
Adatfolyam-alapú MCP-átvitel
🤝 A2A
/.well-known/agent.json
Ügynökök közötti kommunikáció, JSON-RPC 2.0 + SSE, 6 készség
🌐 REST API
/v1/*
OpenAI-kompatibilis — csevegés, beágyazások, képek, hang és OCR
🔔 Webhookok
/api/webhooks
Kérés- és kvótaesemények továbbítása a Slack, Discord vagy Telegram felé, illetve bármely URL-re
🛰️ Távoli CLI
omniroute connect
Távoli példány vezérlése korlátozott hatókörű hozzáférési tokenekkel
```bash
# A teljes OmniRoute-eszközkészlet biztosítása a Claude Code számára MCP-n keresztül:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP-szerver](docs/frameworks/MCP-SERVER.md) · [A2A-szerver](docs/frameworks/A2A-SERVER.md) · [Ügynökprotokollok](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Takarítson meg 15–95% tokent — automatikusan
### 📖 Hogyan működik — pipeline, architektúra és a megtakarítás matematikája
Az alapértelmezett egymásra épülő kombináció a `RTK → Caveman`. Amikor mindkettő ugyanarra a tool-/kontextus-payloadra hat, a megtakarítások halmozódnak:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
A kódblokkokat, URL-eket, a JSON-t és a strukturált adatokat a megőrzési motor **mindig védi**.
> **Miért használjunk sok tokent, ha kevés token is elvégzi a munkát?** Minden kérés **transzparensen** áthalad az OmniRoute tömörítési pipeline-ján — ügyféloldali módosítások nélkül. Ez mára egy **12 összekapcsolható motorból álló verem**, amelyek sorrendben futnak, és routing-kombinációnként szabadon kombinálhatók — olyan ötletekre építve, mint a [RTK](https://github.com/rtk-ai/rtk), a [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), a [LLMLingua-2](https://github.com/microsoft/LLMLingua) és a [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 A 12 motoros verem
A motorok a pipeline sorrendjében futnak; mindegyik kombinációnként függetlenül ki- és bekapcsolható, valamint konfigurálható:
#
Motor
Mit tesz
1
Session-Dedup
Eltávolítja a fordulók között ismétlődő tartalmat (tartalom szerint címezve, fordulókon átívelően)
2
CCR
A nagy blokkokat visszakereső markerek mögé archiválja, amelyek igény szerint lekérhetők
3
Lite
Whitespace- és kép-URL-csonkítás (kis késleltetésű alapvonal)
4
RTK
Intelligens tool-eredmény-szűrés, dedup és csonkítás (parancs-tudatos)
Kísérleti kontextus-képként-kódolás a mért Claude Fable 5 számára a közvetlen Anthropic-vezetéken; a GPT 5.6 transformer-ek a szolgáltatói visszaigazolásokig fail-closed állapotban maradnak. Négy tömörítési profil (aggressive – alapértelmezett, balanced, coding-safe, passthrough) (a legagresszívabb; opt-in)
A kódblokkok, URL-ek és strukturált adatok **mindig bájtra pontosan megőrződnek**. Az **egykattintásos előbeállítások** kombinálják a motorokat:
Mód
Megtakarítás
Legjobb ehhez
🪶 Lite
~15%
Mindig bekapcsolt, biztonságos alapértelmezés
🪨 Standard (Caveman)
~30%
Mindennapi kódolás
⚡ Aggressive
~50%
Hosszú, tool-igényes munkamenetek
🔥 Ultra
~75%
Maximális megtakarítás
🧰 RTK
60–90%
Shell/test/build/git kimenet
🔗 Stacked (RTK → Caveman)
78–95%
Vegyes promptok + tool-naplók
**Valós példa — Standard mód:**
> **Előtte (69 token):** _"A React-komponensed újrarenderelésének oka valószínűleg az, hogy minden renderelési ciklusban új objektumhivatkozást hozol létre. Amikor egy inline objektumot adsz át propként, a React sekély összehasonlítása minden alkalommal más objektumnak látja, ami újrarenderelést vált ki. Javaslom, hogy a useMemo használatával memoizáld az objektumot."_
>
> **Utána (19 token):** _"Új objektumhivatkozás minden rendereléskor. Inline objektum prop = új hivatkozás = újrarenderelés. Csomagold useMemo-ba."_
>
> **Ugyanaz a válasz. 72%-kal kevesebb token. Nulla pontosságvesztés.** ✅
**PT-BR példa — [Troglodita](https://github.com/leninejunior/troglodita) mód:**
> **Előtte (42 token):** _„A probléma az, hogy a komponens újrarenderelődik, mert minden renderelési ciklusban új objektumreferencia jön létre. A `useMemo` használatát javasolnám.”_
>
> **Utána (12 token):** _„Újrarenderelés: minden ciklusban új referencia (az inline objektum újra létrejön). Használd a `useMemo`-t.”_
>
> **Ugyanaz a válasz. ~70%-kal kevesebb token. A technikai pontosság változatlan.** ✅
### 🎚️ A motorokon túl — kimeneti stílusok, adaptív szabályozó és kérésenkénti vezérlés
A fenti 12 motor azt tömöríti, ami **bekerül**. További három réteg alakítja, **hogyan**, **mikor** és mi **kerül ki**:
- **🪄 Kimeneti stílusok** _(kimeneti tengely vezérlése)_ — determinisztikus, gyorsítótár-biztos utasításokat szúrnak be a válasz formálásához; kombinálhatók, mindegyik `lite` / `full` / `ultra` intenzitással. Egy stílus hozzáadása egyetlen sor a regisztrációs jegyzékben:
- **Tömör próza** — mellőzi a töltelékszavakat / névelőket / bizonytalankodást; a technikai tartalmat pontosan megőrzi.
- **Kevesebb kód** — „lusta senior fejlesztő” YAGNI: a legkisebb működő módosítás, kéretlen vázkód nélkül.
- **Lófarok (lusta senior fejlesztő)** — végigmegy a YAGNI-létrán, kijavítja a kiváltó okot, és a legkisebb működő diffet adja.
- **ADHD-m van (cselekvésközpontú)** — a következő művelettel kezd, számozott lépések, egyetlen konkrét következő lépés, bevezetés nélkül.
- **Tömör CJK (文言)** — klasszikus kínai, rendkívül tömör stílus (területi beállítás alapján csak `zh` esetén).
- **🎯 Adaptív kontextuskeret** _(a szabályozó)_ — egyetlen be-/kikapcsolási tokenküszöb helyett csak annyira fokozza a legolcsóbb, legkisebb veszteségű motorok használatát, amennyire szükséges ahhoz, hogy a tartalom **beleférjen a modell kontextusablakába**. Szabályzat: `reserve-output` (alapértelmezett, modellfüggő) · `percentage` · `absolute`. Mód: `floor` (garantáltan belefér) · `replace-autotrigger` (az explicit választásod elsőbbséget élvez) · `off` (örökölt küszöbérték).
- **🎛️ Hol dől el a tömörítés** _(elsőbbség, magastól az alacsonyig)_ — kérésenkénti `x-omniroute-compression` fejléc › útválasztási kombináció felülbírálása › aktív elnevezett profil › adaptív / automatikus aktiválás › vezérlőpult alapértelmezése › kikapcsolva. Az alkalmazott terv visszaköszön az `X-OmniRoute-Compression: ; source=` válaszfejlécben.
Állíts be tokenküszöb szerinti automatikus aktiválást, kapcsold be az adaptív szabályozót, rögzíts egy elnevezett profilt, adj meg egyszeri beállítást kérésenként, vagy rendelj folyamatot egy útválasztási kombinációhoz — amelyik leginkább megfelel a munkaterhelésnek. Egy opcionális, offline **kiértékelési keretrendszer** (`npm run eval:compression`) rögzített korpuszon pontozza a tartalmi hűséget a megtakarításhoz viszonyítva, mielőtt élesítenéd a módosítást.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Gyors kezdés
**1) Telepítés és futtatás**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` vagy tárfüggőségi figyelmeztetéseket látsz? [Ezek ártalmatlanok](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11-et vagy újabbat használsz?** Az npm blokkolhatja a csomagok életciklus-szkriptjeit, ha azok nincsenek engedélyezve. Az OmniRoute `postinstall` szkriptje (`node scripts/build/postinstall.mjs`) szükséges a natív futtatókörnyezeti fájlok előkészítéséhez. Globális telepítéskor engedélyezd az npm figyelmeztetésében megnevezett csomagokat. Az OmniRoute 3.8.53 által jelzett csomagkészlet esetén:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Ha ezt az engedélyezési listát a jövőbeli globális telepítéseknél is használni szeretnéd, állítsd be egyszer, majd telepíts a szokásos módon:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> A függőségek listája kiadásonként változhat; ha az npm más listát jelez, használd az abban a figyelmeztetésben szereplő csomagneveket. Egy csomag engedélyezése lehetővé teszi a telepítési szkriptjeinek futtatását.
> **Gemini Webet vagy más, webes cookie-kat használó szolgáltatót használsz?** Az npm-csomag tartalmazza a
> Playwrightot, de a Chromium binárisát nem. Az első webes szolgáltatói kérés elküldése előtt lásd a
> [Playwright Chromium beállításáról](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> szóló megjegyzést.
Vezérlőpult: `http://localhost:20128` · API: `http://localhost:20128/v1`.
**2) Csatlakoztass egy megfelelő szolgáltatót a saját fiókoddal**
Vezérlőpult → **Szolgáltatók** → válassz olyan szolgáltatót, amelynek aktuális feltételei és kvótája megfelel a felhasználási esetednek → add hozzá az API-kulcsát, vagy végezd el a fiókcsatlakoztatási folyamatát. Az ingyenes csomagokhoz regisztráció, jóváhagyás vagy fizetési mód megadása lehet szükséges. Tekintsd át az [ingyenes csomagokról szóló útmutatót](docs/getting-started/FREE-TIERS-GUIDE.md); a kulcs nélküli hozzáférés nem garantált, és a `tos: avoid` jelölésű szolgáltatók alapértelmezés szerint ki vannak zárva az `auto` útválasztásból.
**3) Állítsd be a kódolási eszközödet**
```txt
Alap URL: http://localhost:20128/v1
API-kulcs: [másold ki innen: Vezérlőpult → Végpontok]
Modell: auto (az elérhető kapcsolatok között irányít — vagy válassz szolgáltatót/modellt)
```
**4) Ellenőrizd a működést**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
A csatlakoztatott modellek listáját kell látnod. 🎉 Ennyi — kezdj el kódolni, az OmniRoute pedig automatikusan útválaszt és szükség esetén tartalék szolgáltatóra vált.
Ha a kliensed nem tud egyéni fejléceket küldeni, az OmniRoute tokenizált kompatibilitási aliasokat is biztosít:
```txt
OpenAI-katalógus: http://localhost:20128/vscode/YOUR_KEY/
OpenAI-modellek: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI-csevegés: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI-válaszok: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama-csevegés: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama-címkék: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Ezeket csak olyan kliensekhez használd, amelyek nem tudják csatolni az `Authorization: Bearer ...` fejlécet. Továbbra is a fejlécalapú hitelesítés az előnyben részesített mód.
## 📦 További telepítési módok — Docker, forráskód, pnpm, Arch
**🐳 Docker**
```bash
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](docs/guides/DOCKER_GUIDE.md#release-channels). 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 |
```bash
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](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **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](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 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 .`).
```bash
# Telepítés és futtatás Bunnal
bun install
bun run dev
```
**🛠️ Forráskódból**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Nix flake-ek használatával
nix develop
npm run dev
# Vagy devbox használatával
devbox run npm run dev
```
📖 [Docker útmutató](docs/guides/DOCKER_GUIDE.md) — Compose-profilok, Caddy HTTPS, Cloudflare-alagutak.
**🦭 Podman**
```bash
# 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](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Podman útmutató](contrib/podman/README.md) — 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):
```bash
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](docs/guides/TERMUX_GUIDE.md). 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.
Tesztlefedettségi stratégia 56 000+ statikus tesztdeklarációhoz több mint 7 800 nyilvántartott tesztfájlban
# ⭐ Legkiemelkedőbb közreműködők
> Az OmniRoute-ot egy lelkes nyílt forráskódú közösség formálja. Ezek az egyének kivételes hozzájárulásokat tettek, amelyek közvetlenül befolyásolják a projekt minőségét, stabilitását és elérését. **Köszönjük.**
### Külső közreműködők beolvasztott pull requestek szerint
Az összeírás 2026-10-18 15:09:09 UTC-kor készült az élő release/v3.8.52 csúcs 656f01cb43 állapotával. A lapozott GitHub GraphQL összeírás 9 191 beolvasztott PR-t tartalmaz: 3 834-et a tároló tulajdonosa, 229-et a Dependabot, 6-ot egyéb botok/alkalmazások, és 5 122 külső PR-t 835 különböző közreműködőtől. A „Módosított sorok” a GitHub hozzáadásainak és törléseinek összege, és tartalmaz generált fájlokat, lockfile-okat, katalógusokat, fordításokat és dokumentációt; ez churn, nem szerzői LOC. 49 PR esetében a GitHub diffje meghaladja az 500 000 sort (például a #13399, egyetlen szolgáltató hozzáadása, 2 347 módosított fájlt listáz), ami felfújja a fenti összegek egy részét. Az azonos értékek azonos helyezést kapnak.
### GitHub által attribútált commitok
Újraellenőrizve 2026-10-18 14:44:45 UTC-kor: a GitHub-hozzárendelt commitok, amelyeket a repository Contributors API jelentett a release/v3.8.52 alapértelmezett ághoz. Az API 849 identitást adott vissza (429 felhasználó, 2 bot, 418 névtelen); ez a táblázat kizárja a karbantartót, a botokat és a névtelen identitásokat, valamint megtartja a versenyben elért holtversenyeket. Különbözik mind a fenti, egyesített PR-okon alapuló rangsortól, mind az alábbi Git-metaadatokon alapuló összeírástól.
> 🙏 E közreműködők funkciói, hibajavításai és infrastruktúra-fejlesztései **alapvető részét** képezik annak, ami az OmniRoute-ot megbízhatóvá és funkciógazdaggá teszi. Minden pull request, minden teszteset és minden i18n fordítási fájl számít. A nyílt forráskódot hozzájuk hasonló emberek építik.
---
## 💖 Szponzorok
Szívből köszönjük azoknak, akik saját pénzükből finanszírozzák az OmniRoute-ot — minden hozzájárulás segít abban, hogy a projekt ingyenes és független maradjon, és tovább fejlődjön.
… és másoknak is, akik inkább névtelenek szeretnének maradni 💛A nyilvános GitHub Sponsors-adatokat 2026-10-18-án ellenőriztük újra a GitHub Sponsors GraphQL API segítségével: az összesen 14 szponzorációból 11 nyilvános (6 aktív, 5 korábbi). A fenti aktív címkéket a GitHub isActive állapota határozza meg; a korábbi nyilvános egyszeri támogatóknak továbbra is köszönetet mondunk, a privát szponzorok pedig névtelenek maradnak. A Ko-fi-, Buy Me a Coffee-, Liberapay-, PIX- és kriptoadományok nem szerepelnek a listán, mivel nem tartozik hozzájuk nyilvános szponzori bejegyzés.💖 Legyél szponzor → — minden dollár segít abban, hogy az OmniRoute ingyenes és független maradjon.
## 👥 Több mint 900 közreműködő
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Ellenőrizve 2026-10-18-án az élő release/v3.8.52 ág ad160ab2d1 csúcsánál (6 826 véglegesítés): 993 normalizált emberi Git-identitás — 707 véglegesítésszerzőként jelenik meg (beleértve a karbantartót is), 286 pedig kizárólag explicit Co-authored-by záradékokban. Az összesítés alkalmazza a .mailmap fájlt, a kis- és nagybetűk figyelmen kívül hagyásával hasonlítja össze az e-mail-címeket, a numerikus és egyszerű GitHub noreply címeket csak akkor kapcsolja össze, ha ugyanazt a felhasználónevet kódolják, kizár 26 bot-, ügynök-, szolgáltatás- vagy helyőrző-identitást, és nem von össze hagyományos e-mail-címeket pusztán azért, mert a megjelenített nevük megegyezik. A 2026-08-24-i ellenőrzés 639-et tett közzé; ezt a módszert az akkori ellenőrzés ac02c5b42f alapjára ismételten alkalmazva 619-et kapunk, így a növekedés új közreműködőkből, nem pedig egy megengedőbb módszerből ered.
### Hogyan járulhatsz hozzá
1. Forkold a tárolót
2. 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](docs/ops/BRANCHING_MODEL.md)
3. Hozd létre a funkcióágadat (`git checkout -b feat/amazing-feature`)
4. Véglegesítsd a módosításaidat (`git commit -m 'feat: add amazing feature'`)
5. Töltsd fel az ágat (`git push origin feat/amazing-feature`)
6. Nyiss egy Pull Requestet, ahol **base = az adott `release/vX.Y.Z` ág**
A részletes irányelvekért lásd a [CONTRIBUTING.md](CONTRIBUTING.md) fájlt.
### Új verzió kiadása
```bash
# Kiadás létrehozása — az npm publish automatikusan megtörténik
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Csillagok
## 🌍 StarMapper
## 🙏 Köszönetnyilvánítás
Az OmniRoute óriások vállán áll. A projekt a **[9router](https://github.com/decolua/9router)** forkjaként és a Go nyelvű **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** projekt TypeScript-portjaként indult — ezt követően pedig az alábbi alrendszerek mindegyikét egy-egy olyan nyílt forráskódú projekt ihlette, amely korábban valósította meg az adott megoldást. Mindegyikük az OmniRoute egy konkrét részét formálta. Ezzel szeretnénk köszönetet mondani mindannyiuknak. 🙏
> ⭐ a csillagok száma a GitHub REST API-jával lett ellenőrizve 2026. október 18-án — adjatok egy csillagot ezeknek a projekteknek. Az értékek egy adott időpontban készült pontos pillanatképet tükröznek, ezért természetesen változni fognak.
### 🧬 Eredet és átjáró
Az az MI-átjáró, amelynek nyilvános árazási adatkészlete biztosítja a költségkövetési szinkronizálásunk adatait, szolgáltatónormalizálási modellje pedig hatással volt az útválasztásunkra.
MIT-licencű forráskód, amelyet a csomagba foglalt ChatGPT Web → Codex Responses-hídhoz adaptáltunk, beleértve a böngészőmunkamenet-, válaszkeretezési, használatkövetési és webes keresési adaptereket.
A stream-helyreállításba, a gondolkodás nélküli aliasokba, a tartalék webes keresésbe, a csúszóablakos korlátokba, a naplóadatok kitakarásába és a megerősített indítási folyamatokba átültetett minták.
A Claude Code-dal kompatibilis átalakítási alapértékek és számlázásifejléc-viselkedés, amelyeket általánosítottunk az OmniRoute konfigurációvezérelt hídjához.
A Grok-modellleképezéseit, hamis TypeError-t használó Statsig-generátorát, kérés- és eszközalapértékeit, valamint NDJSON-válaszfeldolgozóját érdemben adaptáltuk az OmniRoute Grok Web-végrehajtójához.
A grok2api-merged mögötti elsődleges tranzitív kódforrás; modell-, fejléc-, hasznosadat-, Statsig- és feldolgozóimplementációit a Grok Web eredeti származási lánca megőrzi.
A Grok hasznosadat- és eszközalapértékeinek, a Statsig-generátornak, valamint a TQZHR-en és a grok2api-merged projekten keresztül átvett result.response feldolgozónak az alapjául szolgáló MIT-licencű forráskód.
Egy tranzitív forrás, amelyet a grok2api-merged a proxykészlet-rétegéért tüntet fel; az OmniRoute megőrzi ezt a származási hivatkozást, de nem állítja, hogy a korlátozott hatókörű Grok Web-végrehajtója a proxykészlet portját tartalmazná.
Az eredeti Grok Web-implementáció a projekt HTTP-/böngészőalapú upstream kialakítását vette alapul; közvetlen HTTP-útvonala a GrokProxyból származik, ezért nem állítjuk, hogy önálló kódport történt.
A virálissá vált „miért használ sok token, ha kevés token elég” projekt — ősemberbeszéd-filozófiája adja a szabványos tömörítési módunk, valamint több mint 30 töltelékszó-eltávolítási és sűrítési szabályunk alapját.
Nagy teljesítményű parancskimenet-tömörítés — ez inspirálta az RTK motorunkat, a JSON-szűrő DSL-t, a nyers kimenet visszaállítását és az egymásra épülő RTK → Caveman feldolgozási láncot.
Prompttömörítési kutatás (LLMLingua / LLMLingua-2) — ez inspirálta az aszinkron, kódbiztos, hiba esetén az eredeti tartalmat továbbengedő llmlingua motorunkat.
A virálissá vált „lusta senior fejlesztő” YAGNI-kódolási készség — ez inspirálta a less-code kimeneti stílusunkat: a legkisebb működő módosításra ösztönöz, így csökkenti a _generált_ kód mennyiségét (a Caveman tömör prózájának kimeneti tengelyen elhelyezkedő párja).
Tartalomtudatos, fájltípusonkénti kimenettömörítés hibatűrő megszakítással — megerősítette a típusonkénti továbbításunk és a minimális nyereség alatti kihagyásunk helyességét.
„Találd meg a szellemtokeneket” — a kiszervezési és visszaállítható hivatkozásmintája hatással volt a CCR-kiszervezéssel kapcsolatos megközelítésünkre.
Rust-alapú oszlopos JSON + tartalomcímzett lekérés + üzenetek közötti deduplikáció — megerősítette a headroom/ccr/session-dedup motortervünk, valamint a gyorsítótár-stabil „a tömörített forma pozíciófüggetlen” invariáns helyességét.
TypeScript Compiler API-eszközkészlet — ez inspirálta az elemzőalapú megjegyzés-eltávolításunkat, amely megőrzi a karakterlánc-, sablon- és regexliterálokat.
A kódolási asszisztens ↔ LLM közötti forgalom MITM-elfogása/-elemzése meghatározta a Traffic Inspector korai követelményeit. Négy korábban származtatott modult — az SSE-egyesítést, a beszélgetések normalizálását, a titkos adatok maszkolását és a fejlécek tisztítását — nyilvános protokollszabványokon alapuló, független, tiszta megvalósításokra cseréltünk. A két gazdagép-közvetlen továbbítási felület (passthrough.ts és _internal/bypass.cjs) továbbra is egymástól függetlenül besorolt, belső OmniRoute-megvalósítás; ezeket nem írtuk újra a csere részeként.
Transzparens, folyamatonkénti proxyútválasztás — ez inspirálta az összeomlásbiztos MITM-leállítást, a socketek inaktivitási időtúllépéseit, a /proc alapú folyamathoz-rendelést és a TPROXY-forgalomrögzítést.
### 📚 Modelladatok, megfigyelhetőség és felhasználói felület
A biztonságos alapbeállításokat alkalmazó könyvtárak válogatott listája, amely biztonsági döntéseinket irányítja (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Inspirálta a kérések deduplikálását, a vészhelyzeti, költségmentes tartalékmegoldást, a bővíthető Auto-Combo stratégiákat és a többnyelvű szándékosztályozást.
A fióktudatos modell-újraleképezés, a végrehajtható fájlok elérési útjának ellenőrzése és a csomagcímkék kezelése hozzájárult az OmniRoute Antigravity-futtatókörnyezetének kialakításához.
Azonosította a Grok Build kvótafelületét; az OmniRoute ezt követően függetlenül ellenőrizte és javította a tényleges átviteli formátumot.
## 📄 Licenc
MIT licenc – részletekért lásd a [LICENSE](LICENSE) fájlt.
---
**[⬆ Vissza a tetejére](#-omniroute)** · ❤️-vel készült a nyílt forráskódú AI-közösség számára.
OmniRoute v3.8.53 · Node ≥22.22.2 · MIT licenc · omniroute.online