# 🚀 OmniRoute — Az ingyenes AI-átjáró
**Készítette: [Diego Souza](https://github.com/diegosouzapw)**
## 💰 ~1,62 milliárd token havonta külső szolgáltatók ingyenes csomagjaiban
> **Használd saját szolgáltatói fiókjaidat.** Ez a külön-külön jogosult külső szolgáltatók ingyenes csomagjainak becsült összesítése, nem az OmniRoute által biztosított tokenkeret. Regisztrálj, szerezd be a szükséges hitelesítő adatokat, majd csatlakoztasd a használható szolgáltatókat; minden szolgáltató maga szabályozza a korlátait, elérhetőségét és feltételeit.
>
> Az ingyenes csomagok kézi összesítése fájdalmas — több tucat SDK, több tucat sebességkorlát, és fogalmad sincs, valójában mennyi áll rendelkezésedre. Az OmniRoute **465 ingyenes csomagbejegyzést katalogizál 34 ismétlődő kerékben**, és a kiemelt tokenszámot a **közzétett pozitív havi kerettel rendelkező 17 kerékből, valamint öt modellenkénti Groq-korlátból** számítja ki, a közös kerékek szerint deduplikálva. A csak regionális személyazonosság-ellenőrzés után megnyíló kvóták (jelenleg: ModelScope) külön jelennek meg, +~6 millió tokennel a regionális személyazonosság-ellenőrzés mögött, és soha nem kerülnek bele a kiemelt összesítésbe. Az eredmény továbbra is látható az irányítópulton (`/dashboard/free-tiers`).
> A live `/dashboard/free-tiers` oldal animált összefoglalója. A teljes módszertan (kerék-deduplikáció, jóváírási szintek, szolgáltatói feltételek): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Ezeket a számokat kéthetente újraellenőrizzük az élő katalógussal — és **mindkét irányban változhatnak**: ha egy szolgáltató megszünteti az ingyenes csomagját, a szám csökken; ha új szolgáltató jelenik meg, nő. Azt tesszük közzé, amit a katalógus ténylegesen kiszámít, soha nem egy felfelé kerekített legjobb esetet.
⭐ Csillagozd a repót, ha az OMNIROUTE segített pénzt megtakarítani és megkönnyítette 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 — elsőként értesülj 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 [🌍 Globális](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazília](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portál](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Az átjáró folyamatosan bővül
## 🆓 Telepítsen, csatlakoztasson egy szolgáltatót, majd irányítsa a kéréseket egyetlen végponton keresztül
```bash
# Szolgáltató csatlakoztatása után másolja ki OmniRoute-kulcsát a Dashboard → Endpoints menüpontból:
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!"}]}'
```
A(z) `auto` használatához jogosult útvonal szükséges. Egy friss telepítésben előfordulhat, hogy nincs jogosult, kulcs nélküli célpont, és egy kulcs nélküli szolgáltató elutasíthatja a külső klienseket. A `tos: avoid` jelölésű szolgáltatók, köztük a Kiro, alapértelmezés szerint ki vannak zárva az automatikus útválasztásból; egy fiók csatlakoztatása nem írja felül ezt a beállítást. Szolgáltató választása előtt tekintse meg az [Ingyenes csomagok útmutatóját](docs/getting-started/FREE-TIERS-GUIDE.md).📦 Másolja és illessze be a gyorsindító szkripteket **Pythonhoz, Node.js-hez, PHP-hoz és cURL-höz** → [`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)
## 🏆 Mi különbözteti meg az OmniRoute-ot
📊 Teljes módszertan és funkciónkénti részletek a 9routerrel, az OpenRouterrel, a CLIProxyAPI-val és a LiteLLM-mel való összehasonlításról → [`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
> A legutóbbi kiemelt változások a **v3.8.20 → v3.8.54** verziók között. A teljes előzmény a [`CHANGELOG.md`](CHANGELOG.md) fájlban található.
- **⚖️ `quota-weighted` routing** — a 20. kombinált stratégia kihagyja a kimerült fiókokat, majd a fennmaradók közül a megmaradt kvóta ÷ folyamatban lévő terhelés arányában választ, miközben a meglévő beszélgetéseket ugyanahhoz a fiókhoz rögzíti. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless mód** — az `omniroute serve --headless` (vagy az `OMNIROUTE_HEADLESS=1`) csak a `/v1/*` proxy-motort futtatja, a vezérlőpultot és a kizárólag vezérlőpulthoz tartozó alrendszereket kikapcsolva. → [Headless mód](docs/guides/HEADLESS.md)
- **🔎 Modellfelderítés** — a `/v1/models` képesség, kontextus, típus és szöveg alapján szűr, a `POST /v1/models/query` pedig rövid, determinisztikus listát ad vissza ugyanazzal a kulcsonkénti láthatósággal. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🔑 Kulcsonkénti routingvezérlés** — egy API-kulcsot a `forcedModel` használatával egyetlen modellhez vagy kombinációhoz lehet rögzíteni, továbbá egy kulcs modelljei és kombinációi atomikusan hozzáadhatók vagy eltávolíthatók (`/api/keys/{id}/access`). → [API-referencia](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Részletesebb PII-vezérlés** — típusonkénti kiválasztás, legfeljebb 20 ellenőrzött egyéni maszkolási minta és típusonkénti észlelési számlálók; maga a maszkolás továbbra is opcionálisan kapcsolható be. → [Védelmi korlátok](docs/security/GUARDRAILS.md)
- **🌍 67 nyelv** — a vezérlőpultban, a dokumentációs tükrökben és a CLI-ben; 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ához, Conductor-képességek az Agent Cardon, valamint egy vezérlőpulthoz tartozó panel Faro push-to-talk hangcsevegéssel. → [A2A-szerver](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptív beléptetés és túlterhelésvédelem** — a nagy erőforrás-igényű csevegési kérések sorba kerülnek az 503-as hibával való elutasítás helyett, kapcsolatonkénti atomikus, gördülő RPM-bérletekkel. → [Ellenálló képességi útmutató](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonikus `/v1/models` sorrendezés** — szolgáltatónként egyetlen összefüggő, szolgáltatók szerint csoportosított blokk (a kombinációk előre rögzítve), amely minden katalógusforrásban stabil marad. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🗜️ Tömörítés megerősítése** — alapértelmezés szerint bekapcsolt felfújódásvédelem, Caveman-csomagok DE / FR / JA + kínai (wényán) nyelvhez, RTK-szűrők Gradle és .NET számára. → [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** értékkel jelennek meg a költségelemzésben; a költségvetés, a kvóta és a routing továbbra is becslést készít. → [API-referencia](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share routing** — egy megosztott fiók kvótájának méltányos felosztása a készletbe vont kulcsok között, munkamegőrző módon, így az üresjáratban lévő részek kölcsönadhatók. → [Ellenálló képességi útmutató](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Egyparancsos CLI-/ügynökbeállítás** — 15 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` 11 célt támogat interaktív szolgáltató- és modellválasztóval, valamint környezetenkénti kedvencekkel. → [CLI-integrációk](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Távoli mód** — egy távoli OmniRoute vezérlése hatókörhöz kötött tokenekkel (`connect` / `contexts` / `tokens`), valamint egy `antigravity` OAuth-segéd VPS-telepítésekhez. → [Távoli mód](docs/guides/REMOTE-MODE.md)
- **🧭 Intelligensebb automatikus routing** — `auto/:` kombinációk, **Fusion** (modellpanel + bíró), feladattudatos routing, kérésenkénti modell-, mód- és USD-költségvetés-felülbírálások. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Bővíthető tömörítés** — 12 kombinálható motor + Compression Studios: LLMLingua-2, két szintű Ultra, omniglyph, lépésenkénti hűségkapu, GCF v3.2, fogd-és-vidd átrendezőszerkesztő. → [Tömörítés](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Átlátható MITM-visszafejtés (TPROXY)** — olyan CLI-k forgalmának rögzítése, amelyek figyelmen kívül hagyják a proxy környezeti változóit, SNI-nkénti CA-val és megbízhatósági tár-telepítővel. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Mindenhol elérhető költségtelemetria** — `X-OmniRoute-*` költség-/használati fejlécek minden végponton, gyorsítótár-találatból származó megtakarítási fejléc, kulcsonkénti USD-költési kvóták. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🧠 Ön által vezérelt memória** — alapértelmezés szerint kikapcsolva, opcionálisan bekapcsolható int8 vektorkvantálás + típusos leépülés, kérésenkénti `x-omniroute-no-memory`. → [Memória](docs/frameworks/MEMORY.md)
- **🛡️ Biztonság** — promptinjektálás elleni védelem minden LLM-útvonalon (red-team tesztcsomag), opcionálisan bekapcsolható hitelesítőadat-maszkolási védelmi korlát (a kiszivárgott API-kulcsokat/titkokat mindkét irányban kitakarja), ingyenes DuckDuckGo végső tartalék webes keresés, valamint opcionális OIDC-bejelentkezési kapu a vezérlőpulthoz (a jelszavas bejelentkezés mindig elérhető marad). → [Védelmi korlátok](docs/security/GUARDRAILS.md)
- **🖼️ Új végpontok** — a `/v1/ocr` (Mistral OCR) és a `/v1/audio/translations` (Whisper-stílusú) teljessé teszi a médiavégpontokat. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🎨 Kép-, videó- és hanggenerálás** — egyetlen API a médiához: xAI Grok Imagine és Novita AI videó, ComfyUI, Magnific, Adobe Firefly, Segmind, valamint olyan beszédszolgáltatók, mint 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-megbízhatóság, zh-TW-lokalizáció. → [Környezet](docs/reference/ENVIRONMENT.md)
- **🤝 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, első osztályú Ollama-kártya, Claude Opus 5 és Sonnet 5, hivatalos Kimi-partnerség (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… és egy frissített **388 szolgáltatós katalógus**. → [Szolgáltatók](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Routingátláthatóság** — minden válasz tartalmaz egy `X-OmniRoute-Decision` fejlécet, amely megnevezi a kiszolgálásáért felelős stratégiát/szolgáltatót/késleltetést; az új `cache-optimized` kombinációs stratégia és az Auto-Combo `cacheAffinity` faktora a megismételt kéréseket visszairányítja a gyorsítótárazott előtagot birtokló kapcsolathoz; a csak olvasható `/v1/auto-combo/{channel}/candidates` végpont pedig közzéteszi 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 felügyelt beágyazott szolgáltatásként futó Bifrost és Mux. → [Beágyazott szolgáltatások](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 A csomag része továbbá** — bővítménykeretrendszer és piactér, Omni/Agent/GitHub skills-keretrendszerek, Obsidian vault-integráció (22 MCP-eszköz), OpenAI-kompatibilis Batch- és Files API-k, szemantikus válaszgyorsítótár, ranglistákkal rendelkező gamifikáció, ACP-ügynökfelderítés (15 beépített ügynök), ütemezett naplóexport a BigQuery-be, `auto/chaos` párhuzamos, többmodelles fan-out, Telegram-bot-híd, alkalmazáson belüli verziókezelő, valamint az LMArena-ELO ingyenes szolgáltatói rangsora. → [Dokumentáció](docs/README.md)
## 🤖 Kompatibilis CLI-k és Kódoló Ügynökök
> Egyetlen konfiguráció — `http://localhost:20128/v1` — és **minden** AI IDE vagy CLI fut ingyenes és olcsó modelleken.
**Indíts el bármely támogatott CLI-t az OmniRoute-on keresztül egyetlen paranccsal** — nincs szükség konfigurációs fájlokra,
hitelesítő adatok folyamatonként injektálva, Qwen/Gemini elkülönített, ideiglenes home-ot kap:
```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álaszd ki interaktívan a szolgáltatót+modellt, és írd meg az eszköz saját konfigurációját:
omniroute configure codex # továbbiak: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Minden parancs figyelembe veszi az aktív távoli kontextust (`omniroute connect `), a `--dry-run`
megjeleníti a pontos környezeti változókat/argumentumokat végrehajtás nélkül, a `--api-key-env NAME` pedig
megóvja a titkos adatokat a shell előzményétől. → [CLI Integrációk](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 AI-szolgáltató — közülük 153 katalógus szerint ingyenes
> **388 regisztrált szolgáltató** a kanonikus csevegési, média-, keresési, helyi, felhőügynök- és rendszerkollekciókban, köztük **153 olyan szolgáltató, amely `hasFree: true` felfedezési metaadatot tartalmaz**. A csevegési modellregiszter **239 szolgáltatót / 3 059 különálló szolgáltató-modell párt / 1 475 nyers modellazonosítót** tartalmaz; a különálló ingyenes keretkatalógusban **471 modellenkénti sor**, **34 ismétlődő keret** és **52 ismétlődő vagy kulcs nélküli, örökre ingyenes szolgáltató** található. Ezek szándékosan eltérő nevezők; a definíciók és a keretduplikációktól megtisztított számítások a [Szolgáltatói referenciában](docs/reference/PROVIDER_REFERENCE.md) és az [Ingyenes csomagok](docs/reference/FREE_TIERS.md) oldalon találhatók.
### 🏢 Minden jelentős laboratórium — 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 még több mint 350 — minden ikon élőben, az irányítópult szolgáltatói katalógusából töltődik be. 📖 [Szolgáltatói referencia](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Örökre ingyenes — 0 $, nincs szükség bankkártyára
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 ingyenes RPM
Cerebras GLM 4.7, GPT-OSS Egyszeri 5 $ jóváírás; bankkártya szükséges
### 🧩 Új: OmniRoute VS Code natív Copilot chatjében
> Nincs új oldalsáv, nincs új chat UI – minden OmniRoute modell megjelenik közvetlenül a**Copilot Chat modellválasztó, amelyet már használ** . VS Code 1.122 óta a szolgáltatói modellek GitHub bejelentkezés vagy Copilot -előfizetés nélkül működnek – ügynöki mód, eszközhívás és látás, ingyenesen.
Telepítse a** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** kiterjesztés, mutasson rá OmniRoute szerverre (alapértelmezetten `localhost:20128`), majd nyissa meg Copilot Chat → modellválasztót →** Modellek kezelése…** →**OmniRoute** .
A szerkesztő belsejéből: nyissa meg a** Kiterjesztések** megtekintés, keresés** "OmniRoute"** , kattintson** Telepítés** - mindkét üzletben ugyanúgy működik. Forrás, kiadások és a kiadói runbook élőben [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) oldalon.
📖 [VS kód Copilot Csevegési útmutató](docs/guides/VSCODE-COPILOT.md) – beállítás, mit mutat a választó, irányítópult egy lapon, hibaelhárítás
### 🎩 Új: OmniRouteTray – az Ön átjárója, amely a menüsorban található
> `omniroute serve` akkor a legboldogabb, ha mindig be van kapcsolva.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** ezt a macOS menüsor-alkalmazásává változtatja: beállítja és elfelejti: elindítja a szervert, életben tartja az újraindítások során, frissíti a helyére, és egyetlen kattintással elérhetővé teszi az élő token költségvetését –** nincs nyitva hagyott terminálablak, nincs `npm install -g omniroute` a babaváráshoz.**
[A Tauri v2-](https://v2.tauri.app/) vel (kerekítési hiba méretű Rust mag) épült, saját aláírt Node 24 futtatókörnyezetét szállítja, és egy alkalmazás tulajdonában lévő OmniRoute telepítést kezel, így soha nem harcol a globális `node`/`bun` ellen. Azt** megosztja a meglévő `~/.omniroute/` konfigurációt és adatbázist** — tehát ugyanaz a OmniRoute, amit már fut, csak kalappal. 🎩
mit csinál
🟢 Felügyeli a
szervert omniroute serve , átvesz egy már futó példányt a megkettőzés helyett
📊 Élő használat áttekintése
Szolgáltatói kvótasávok, Claude session/weekly korlátok visszaszámlálással, 30 napos költségbontás
🔄 Automatikus frissítések a helyükön
szakaszos telepítés, atomcsere, visszaállítás hiba esetén – mindig a legújabb kiadáson
🚀 Indítás bejelentkezéskor
Opcionális indítás bejelentkezéskor; csak tálca, nincs dokkoló ikon
🩺 Doctor & naplók
Egykattintásos diagnosztika és szervernapló-hozzáférés
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Inkább letöltöd? Töltse le a legújabb .dmg fájlt innen
Kiadja . Forrás, problémák és felépítés
A docs a zoispag/omniroute-tray található.
💛 A @zoispag közösségi projektje – nem hivatalos OmniRoute kiadás.
> 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 automatikusan 15–95% tokent
### 📖 Így működik — folyamat, architektúra és a megtakarítás matematikája
Az alapértelmezett, egymásra épülő kombináció a `RTK → Caveman`. Amikor mindkettő ugyanazon eszköz-/kontextus-adattartalomra alkalmazható, a megtakarítások összeadó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, JSON-t és strukturált adatokat a megőrzési motor **mindig védi**.
> **Miért használna sok tokent, ha kevés token is elég?** Minden kérés **átláthatóan** áthalad az OmniRoute tömörítési folyamatán — nincs szükség kliensoldali módosításokra. Ez most egy **12 összeállítható motorból álló verem**, amelyek sorrendben futnak, és az egyes útválasztási kombinációk szerint tetszőlegesen kombinálhatók — a [RTK](https://github.com/rtk-ai/rtk), a [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), az [LLMLingua-2](https://github.com/microsoft/LLMLingua) és a [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) ötleteire építve.
### 🧱 A 12 motorból álló verem
A motorok a folyamat sorrendjében futnak; mindegyik külön kapcsolható és kombinációnként konfigurálható:
#
Motor
Működése
1
Session-Dedup
Elveti a fordulók között ismétlődő tartalmat (tartalomcímzéses, fordulókon átívelő)
2
CCR
A nagy blokkokat lekérési jelölők mögé archiválja, és igény szerint tölti be
3
Lite
Szóközök és kép-URL-ek eltávolítása (alacsony késleltetésű alapverzió)
4
RTK
Intelligens eszköz-eredmény szűrése, duplikáció-eltávolítás és csonkolás (parancsérzékeny)
Kísérleti kontextus-képként kódolás a közvetlen Anthropic-kapcsolaton, mért Claude Fable 5 támogatással; a GPT 5.6 transzformátorok a szolgáltatói visszaigazolásokig hibabiztosan le vannak tiltva. Négy tömörítési profil (agresszív alapértelmezett, kiegyensúlyozott, kódolásbiztos, átengedő) (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
Legjobb felhasználási terület
🪶 Lite
~15%
Mindig bekapcsolható, biztonságos alapértelmezés
🪨 Standard (Caveman)
~30%
Mindennapi kódolás
⚡ Aggressive
~50%
Hosszú, eszközökben gazdag munkamenetek
🔥 Ultra
~75%
Maximális megtakarítás
🧰 RTK
60–90%
Shell-/teszt-/build-/git-kimenet
🔗 Egymásra épített (RTK → Caveman)
78–95%
Vegyes promptok + eszköznaplók
**Valós példa — Standard mód:**
> **Előtte (69 token):** _"A React-komponens újrarenderelésének valószínű oka, hogy minden renderelési ciklusban új objektumhivatkozást hozol létre. Amikor inline objektumot adsz át propként, a React sekély összehasonlítása minden alkalommal másik objektumként érzékeli, ami újrarenderelést vált ki. Azt javaslom, hogy a `useMemo` használatával gyorsítótárazzátok az objektumot."_
>
> **Utána (19 token):** _"Minden renderelésnél új objektumhivatkozás. Inline objektum-prop = új hivatkozás = újrarenderelés. Csomagold `useMemo`-ba."_
>
> **Ugyanaz a válasz. 72%-kal kevesebb token. A pontosság egyáltalán nem csökkent.** ✅
**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 objektumhivatkozás jön létre. A `useMemo` használatát javasolnám.”_
>
> **Utána (12 token):** _„Újrarenderelés: új hivatkozás minden ciklusban (inline objektum újralétrehozva). 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, az adaptív tárcsa és kérésenkénti vezérlés
A fenti 12 motor azt zsugorítja össze, ami **bekerül**. További három réteg formálja azt, **hogyan**, **mikor** és mi kerül **ki**:
- **🪄 Kimeneti stílusok** _(a kimeneti tengely vezérlése)_ — determinisztikus, gyorsítótár-kompatibilis, válaszformáló utasításokat illesztenek be; kombinálhatók, és mindegyik `lite` / `full` / `ultra` intenzitással használható. Egy stílus hozzáadása egyetlen sornyi regisztráció:
- **Tömör próza** — hagyd el a töltelékszavakat / névelőket / bizonytalankodást; a technikai tartalom maradjon pontos.
- **Kevesebb kód** — „lusta senior fejlesztő” YAGNI: a legkisebb működő módosítás, kéretlen infrastruktúra nélkül.
- **Copfos (lusta senior fejlesztő)** — mássz fel a YAGNI-létrán, szüntesd meg a gyökérokot, és készítsd el a legkisebb működő diffet.
- **ADHD-m van (cselekvésközpontú)** — a következő művelet legyen elöl, a lépések legyenek számozva, legyen egyetlen konkrét következő lépés, bevezető nélkül.
- **Tömör CJK (文言)** — klasszikus kínai, ultra-tömör stílus (lokálfüggően, csak `zh` esetén).
- **🎯 Adaptív kontextuskeret** _(a tárcsa)_ — egyetlen be-/kikapcsolási tokenküszöb helyett csak a legolcsóbb, legkevesebb információveszteséggel járó motorokat erősíti fel annyira, amennyire szükséges ahhoz, hogy a tartalom **beleférjen a modell kontextusablakába**. Házirend: `reserve-output` (alapértelmezett, modellfüggő) · `percentage` · `absolute`. Mód: `floor` (garantálja a beleférést) · `replace-autotrigger` (a kifejezett választásod élvez elsőbbséget) · `off` (örökölt küszöb).
- **🎛️ Hol dől el a tömörítés** _(elsőbbség, magas → alacsony)_ — 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 visszatükröződik az `X-OmniRoute-Compression: ; source=` válaszfejlécben.
Automatikus aktiválás tokenküszöb alapján, az adaptív tárcsa bekapcsolása, egy névvel ellátott profil rögzítése, egyszeri beállítás kérésenként vagy pipeline hozzárendelése útválasztási kombinációhoz — válaszd azt, ami illik a munkaterheléshez. Egy opcionálisan bekapcsolható offline **kiértékelési keretrendszer** (`npm run eval:compression`) egy rögzített korpuszon méri a hűséget és a megtakarítást, mielőtt élesítenél egy 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 peer-függőségekre vonatkozó 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 letilthatja a csomag életciklus-szkriptjeit, ha nincsenek engedélyezve. Az OmniRoute `postinstall` szkriptjére (`node scripts/build/postinstall.mjs`) szükség van 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.54 által jelentett csomagkészlethez:
>
> ```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 későbbi globális telepítésekhez is fel szeretnéd használni, állítsd be egyszer, majd telepíts 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 eltérő listát jelez, használd 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-szolgáltatót használsz?** Az npm-csomag tartalmazza a Playwrightot, de a Chromium bináris fájlját nem. Az első webszolgáltatói kérés előtt olvasd el a [Playwright Chromium beállítása](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) című megjegyzést.
Irányítópult: `http://localhost:20128` · API: `http://localhost:20128/v1`.
**2) Csatlakoztass egy megfelelő szolgáltatót a saját fiókoddal**
Irányítópult → **Providers** → válassz olyan szolgáltatót, amelynek aktuális feltételei és kvótája megfelel a felhasználási esetednek → add meg az API-kulcsát, vagy hajtsd végre a fiókfolyamatot. Az ingyenes csomagok regisztrációt, jóváhagyást vagy fizetési módot igényelhetnek. Tekintsd át az [Ingyenes csomagok útmutatóját](docs/getting-started/FREE-TIERS-GUIDE.md); a kulcs nélküli elérhetőség nem garantált, és a `tos: avoid` jelölésű szolgáltatók alapértelmezés szerint ki vannak zárva az `auto` módból.
**3) Irányítsd rá a kódolási eszközödet**
```txt
Base URL: http://localhost:20128/v1
API Key: [másold az Irányítópult → Endpoints részből]
Model: auto (az elérhető kapcsolatok között irányít — vagy válassz szolgáltatót/modellt)
```
**4) Ellenőrizd, hogy működik-e**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Meg kell jelennie a csatlakoztatott modellek listájának. 🎉 Ennyi — kezdj el kódolni, az OmniRoute pedig automatikusan irányít és tartalékmegoldásra vált helyetted.
Ha a kliensed nem tud egyéni fejléceket küldeni, az OmniRoute tokenizált kompatibilitási aliasokat is biztosít:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Ezeket csak olyan kliensekkel használd, amelyek nem tudják csatolni az `Authorization: Bearer ...` fejlécet. A fejlécalapú hitelesítés továbbra is az ajánlott 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.
wreq-js — JA3 / JA4 TLS-ujjlenyomat-utánzás, 3 szintű proxy
Hibatűrés
Áramkörmegszakító, exponenciális visszalépés, tömeges újrapróbálkozás elleni védelem, automatikus kombinált öngyógyítás
Naplózás
pino — strukturált JSON-naplók kéréskörnyezettel
Tesztelés
Node.js tesztfuttató + Vitest — több mint 60 000 statikus tesztdeklaráció több mint 8 400 nyomon követett tesztfájlban (egység-, integrációs, E2E-, biztonsági és ökoszisztéma-tesztek)
# ⭐ Legfontosabb közreműködők
> Az OmniRoute-ot egy lelkes nyílt forráskódú közösség formálja. Ezek a személyek kivételes hozzájárulásokkal közvetlenül befolyásolták a projekt minőségét, stabilitását és elérhetőségét. **Köszönjük!**
### Külső közreműködők összevont pull requestek alapján
A felmérés időpontja: 2026-11-03 03:01:19 UTC, az élő release/v3.8.53 csúcsán található 05bc048d6c értékkel. A lapozott GitHub GraphQL-felmérés 9 947 összevont PR-t tartalmaz: 4 130-at a repository tulajdonosa, 240-et a Dependabot, 6-ot más botok/alkalmazások, valamint 5 571 külső PR-t 883 különböző közreműködőtől. A „módosított sorok” a GitHub által jelentett hozzáadások és törlések összege, és tartalmazza a generált fájlokat, lockfájlokat, katalógusokat, fordításokat és dokumentációt is; ez a változtatások mennyisége, nem a szerző által írt LOC. 53 PR esetében a GitHub diffjei több mint 500 000 sort tartalmaznak (például a #13399 egyetlen szolgáltatói bővítésként 2 347 módosított fájlt sorol fel), ami több fenti összesítést is felduzzaszt. Az azonos helyezést együtt kezeljük.
### GitHub által attribútált commitok
Újraellenőrizve: 2026-11-03 02:09:16 UTC: a GitHubnak tulajdonított commitok, amelyeket a repository Contributors API-ja jelentett a release/v3.8.53 alapértelmezett ágához. Az API 903 identitást adott vissza (429 felhasználó, 2 bot, 472 anonim); ez a táblázat kizárja a karbantartót, a botokat és az anonim identitásokat, valamint megtartja a holtversenyeket. Ez különbözik mind a fenti összevont PR-rangsorolástól, mind az alábbi Git-metaadat-összesítéstől.
> 🙏 E közreműködők funkciói, hibajavításai és infrastruktúra-fejlesztései **alapvető részét képezik** annak, amitől az OmniRoute megbízható és funkciókban gazdag. Minden pull request, minden teszteset és minden i18n-fordítási fájl számít. A nyílt forráskódot az ilyen 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.
## 👥 1,000+ közreműködő
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Auditálva: 2026-11-02, az éles release/v3.8.53 csúcson, 1c7135e0fb (7 972 commit): 1 074 normalizált emberi Git-identitás — 759 commit szerzőjeként jelenik meg (beleértve a karbantartót is), 315 pedig csak explicit Co-authored-by trailerekben szerepel. A számlálás alkalmazza a .mailmap fájlt, a kis- és nagybetűkre érzéketlenül hasonlítja össze az e-mail-címeket, a numerikus és a normál GitHub noreply-címeket csak akkor kapcsolja össze, ha ugyanazt a felhasználónevet kódolják, kizár 29 bot-, ügynök-, szolgáltatás- és helyőrző-identitást, továbbá nem von össze normál e-mail-címeket pusztán azért, mert a megjelenített nevük megegyezik. A 2026-08-24-i audit 639-et tett közzé; ugyanezt a módszert az audit alapjául szolgáló ac02c5b42f commiton újrafuttatva 619 adódik, így a növekedés új közreműködőktől származik, nem egy lazább módszerből.
### Közreműködés módja
1. Készíts egy forkot a repositoryról
2. Az **aktív** `release/vX.Y.Z` csúcsból hozz létre ágat (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. Commitold a módosításaidat (`git commit -m 'feat: add amazing feature'`)
5. Pushold az ágat (`git push origin feat/amazing-feature`)
6. Nyiss egy Pull Requestet, amelynek **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 **[9router](https://github.com/decolua/9router)** forkjaként és a Go nyelven készült **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** TypeScript-portjaként indult — innen pedig az alábbi alrendszereket mind egy-egy olyan nyílt forráskódú projekt ihlette, amely elsőként jutott el az adott megoldásig. Mindegyikük az OmniRoute egy-egy konkrét részét formálta. Ezúton köszönjük meg mindannyiuknak. 🙏
> ⭐ A csillagszámokat a GitHub REST API-jával ellenőriztük 2026. november 3-án — adj ezeknek a projekteknek egy csillagot. A számok pontos, dátumhoz kötött pillanatképet jelentenek, és természetesen változni fognak.
### 🧬 Származás és gateway
Az az AI-gateway, amelynek nyilvános árazási adatkészlete biztosítja a költségkövetési szinkronizálás adatforrását, és amelynek szolgáltató-normalizálási modellje tájékoztatta az útválasztásunkat.
Az MIT-forrásból adaptált kód a beágyazott ChatGPT Web → Codex Responses hídba került, beleértve a böngésző-munkamenet-, válaszkeretezési, használati és webes keresési adaptereket.
A mintákat a stream-helyreállításba, a gondolkodás nélküli aliasokba, a tartalék webes keresésbe, a csúszóablakos korlátozásokba, a naplóadatok maszkolásába és a megerősített indítási folyamatokba portoltuk.
A Claude Code-kompatibilis transzformációs alapértelmezéseket és számlázási fejléc-viselkedést általánosítottuk az OmniRoute konfigurációvezérelt hídjába.
A Grok modellleképezéseit, a hamis-TypeError Statsig-generátort, a kérés- és eszközalapértelmezéseket, valamint az NDJSON-válaszfeldolgozót érdemben adaptáltuk az OmniRoute Grok Web-végrehajtójába.
A grok2api-merged mögött álló elsődleges tranzitív kódforrás; modell-, fejléc-, payload-, Statsig- és feldolgozó-implementációi megmaradtak a Grok Web származási láncában.
A Grok payload- és eszközalapértelmezéseinek, a Statsig-generátornak, valamint a TQZHR-en és a grok2api-merged-en keresztül továbbvitt result.response feldolgozónak az alapjául szolgáló MIT-forrás.
A grok2api-merged által a proxykészlet-réteg forrásaként feltüntetett tranzitív forrás; az OmniRoute megőrzi ezt a származási megjegyzést, de a korlátozott Grok Web-végrehajtójában nem állít proxykészlet-portot.
Az eredeti Grok Web-implementáció HTTP-/böngészőalapú upstream-tervezését tanulmányoztuk; közvetlen HTTP-útvonala a GrokProxyból származik, ezért önálló kódportot nem állítunk.
A virális „why use many token when few token do trick” projekt — barlanglakó-beszédre épülő filozófiája működteti a standard tömörítési módunkat és több mint 30 kitöltő-/sűrítési szabályunkat.
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 helyreállítását és a többrétegű RTK → Caveman-folyamatot.
PT-BR token-tömörítés — ez működteti a pt-BR nyelvi csomagunkat: a brazil portugál nyelvtanra hangolt pleonazmuscsökkentést és kitöltőszó-eltávolítást.
A virális „lusta senior fejlesztő” YAGNI-kódoló készség — ez inspirálta a less-code kimeneti stílusunkat: a legkisebb működő változtatást előnyben részesítő vezérlést, amely csökkenti a _generált_ kód mennyiségét (a Caveman tömör prózájának kimeneti tengely menti megfelelője).
Tartalomtudatos, fájltípusonkénti kimenettömörítés hibatudatos visszalépéssel — ez igazolta a típusonkénti elosztást és a minimális nyereség alatti kihagyást.
„Találd meg a szellem tokeneket” — kiszervezési és helyreállítható fogantyúkat használó mintája hatással volt a CCR-kiszervezéssel kapcsolatos gondolkodásunkra.
Rust-alapú oszlopos JSON, tartalomcímezett lekérés és üzenetek közötti kettőzés — ez igazolta a headroom/ccr/session-dedup motorok kialakítását és a gyorsítótár-stabil „a tömörített forma pozíciófüggetlen” invariánst.
A kódolási asszisztens ↔ LLM-forgalom MITM-alapú elfogása és elemzése szolgáltatta a korai Traffic Inspector követelményeit. A korábban levezetett négy modul — SSE-összefésülés, beszélgetés-normalizálás, titokmaszkolás és fejléc-szanitizálás — helyét független, tiszta szobában készült, nyilvános protokollszabványokon alapuló implementációk vették át. A két host-passthrough felület (passthrough.ts és _internal/bypass.cjs) továbbra is az OmniRoute belső implementációja, és egymástól függetlenül van besorolva; azokat nem írtuk újra a csere részeként.
Transzparens, folyamatonkénti proxyn keresztüli forgalomirányítá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-alapú forgalomrögzítést.
### 📚 Modelladatok, megfigyelhetőség és felhasználói felület
Istio service-mesh megfigyelhetőség — ez inspirálta a circuit breaker jelvényeinket és a Routing/Combo Studio hibakapcsolatainak vizuális megjelenítését.
A biztonságos alapértelmezéseket követő könyvtárak válogatott listája, amely irányt mutat a biztonsági döntéseinkben (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Inspirálta a kérések deduplikációját, a sürgősségi, költségmentes tartalékmegoldást, a csatlakoztatható Auto-Combo-stratégiákat és a többnyelvű szándékosztályozást.
Fióktudatos modell-újrarendelése, a végrehajtható elérési utak ellenőrzése és a csomagcímkék viselkedése támpontot adott az OmniRoute Antigravity-futtatókörnyezetéhez.
Azonosította a Grok Build kvótabővületét; az OmniRoute ezután függetlenül ellenőrizte és javította az élő wire-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ú MI-közösség számára.
Készítette: Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT-licenc · omniroute.online