> Az ingyenes csomagok kézi halmozása fájdalmas — több tucat SDK, több tucat sebességkorlát, és fogalmad sincs, valójában mennyi áll rendelkezésedre. Az OmniRoute **489 ingyenes csomagbejegyzést tart nyilván 35 ismétlődő készletkulcshoz**, és a tokenek főösszegét abból a **17 készletből számítja ki, amelyek közzétett, pozitív havi kerettel rendelkeznek, valamint öt modellenkénti Groq-korlátból**, a megosztott készleteket deduplikálva. A csak regionális személyazonosság-ellenőrzés után elérhető kvóták (jelenleg: ModelScope) külön jelennek meg, +~6M a regionális személyazonosság-ellenőrzés mögött, és soha nem számítanak bele a főösszegbe. Az eredmény folyamatosan látható az irányítópulton (`/dashboard/free-tiers`).
> Az élő `/dashboard/free-tiers` oldal animált összefoglalója. Teljes módszertan (készlet-deduplikáció, kreditszintek, 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ányban változhatnak** — ha egy szolgáltató megszüntet egy ingyenes csomagot, a szám csökken; ha új jelenik meg, növekszik. Mindig azt tesszük közzé, amit a katalógus ténylegesen kiszámít, soha nem egy felfelé kerekített legjobb esetet.
⭐ Adj csillagot a repónak, ha az OMNIROUTE segített pénzt megtakarítani és megkönnyítette a munkádat.
[](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 [🌍 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
## 🆓 Azonnal működik a telepítés után — nincs kulcs, nincs konfiguráció
```bash
# Friss telepítés, nulla hitelesítő adat — az `auto` már működik:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
Inkább egy specifikus ingyenes backendet szeretne? Hívja közvetlenül az `oc/…` (OpenCode Free) szolgáltatót. Ezután térjen át az `auto` módra, és hagyja, hogy az OmniRoute válasszon.📦 Másolható-beilleszthető gyorsindító szkriptek **Pythonhoz, Node.js-hez, PHP-hoz és cURL-hez** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Az Ígéret
# 🤔 Miért 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ó** modellek olyan lánca, amelyek között az OmniRoute **automatikusan** végzi az útválasztást. Ha elfogy a kvóta, egy szolgáltató meghibásodik, vagy megugranak a költségek, a kombó továbbléphet a következő jogosult és működőképes modellre. 🛡️
### ⚡ Nulla konfiguráció — csak használd az `auto` modellt
Nem kell kombót létrehozni. Állítsd a modellt `auto` értékre (vagy valamelyik változatára), és az OmniRoute virtuális kombót állít össze a csatlakoztatott szolgáltatóidból, valós idejű pontozással:
Modellazonosító
Mire optimalizál
auto
🎯 Kiegyensúlyozott alapértelmezés (LKGP — ragaszkodik a legutóbb jól működő szolgáltatóhoz)
auto/coding
🧑💻 A kódgenerálásnál a minőséget előnyben részesítő súlyok
auto/fast
⚡ Először a legalacsonyabb késleltetés
auto/cheap
💰 Először a tokenenként legolcsóbb
auto/offline
🔋 Először a legnagyobb kvóta- és sebességkorlát-tartalék
auto/smart
🔭 Minőségközpontú + 10%-os feltérképezés a jobb modellek felfedezéséhez
auto/lkgp
📌 Kifejezetten a legutóbb jól működő szolgáltatóhoz való ragaszkodás
auto/chaos
🧪 Hibainjektálási súlyok a rezilienciateszteléshez (káosztervezés)
##
### 🔀 Vagy készíts sajátot — 19 útválasztási stratégia
Mind a **19** stratégia — tetszőlegesen kombinálhatók a kombó egyes lépéseiben:
#
Stratégia
Működés
1
priority
Első célpontot előnyben részesítő rendezett lista — mindegyik kimerítése a következő előtt 🥇
2
fill-first
Az egyes célpontok kvótájának teljes kihasználása a továbblépés előtt
3
weighted
Súlyozott véletlenszerű választás célpontonkénti súlyok alapján
4
round-robin
A célpontok sorban, ciklikusan követik egymást
5
p2c
Véletlenszerű terheléselosztás a „kettő közül a jobb” módszerrel
6
least-used
A jelenleg legkisebb terhelésű célpont kiválasztása
Véletlenszerű választás az ismétlődések kiszűrése nélkül 🎲
9
cost-optimized
A kérésenkénti költség minimalizálása az élő katalógus árai alapján 💸
10
headroom
A legtöbb fennmaradó kvótával rendelkező célpont kiválasztása
11
reset-window
Annak a célpontnak az előnyben részesítése, amelynek kvótaablaka a leghamarabb visszaáll
12
reset-aware
Rangsorolás a kvóta visszaállítási ideje alapján — a rövid ablakok előre kerülnek 📊
13
context-relay
A kontextus átadása a célpontok között hosszú beszélgetésekhez 🧠
14
context-optimized
Az aktuális kontextusmérethez legjobban illő célpont kiválasztása
15
cache-optimized
Minden újrafelhasználható promptelőtag ugyanahhoz a fiókhoz rögzítése — a promptgyorsítótár találati arányának maximalizálása 🎯
16
lkgp
Legutóbbi ismerten jól működő útvonal — az utolsó sikeres szolgáltatóhoz rögzít, majd szükség esetén visszatér a szabályokhoz
17
auto
16 tényezős valós idejű pontozás minden kapcsolaton 🤖
18
fusion
A kérés párhuzamos továbbítása modellek egy csoportjához, majd egy bíró egyetlen választ szintetizál 🧬
19
pipeline
Lépések láncolása — minden célpont kimenete a következő bemenetéül szolgál 🔗
Az Auto-Combo motor minden jelöltet **16 tényező** alapján pontoz (állapot, kvóta, költség, késleltetés, feladathoz való illeszkedés, minőség, munkamenet elérhetősége…) — lásd: [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Beépített reziliencia (3 független réteg)
📖 [Automatikus kombinációs motor](docs/routing/AUTO-COMBO.md) · [Reziliencia-útmutató](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Mi különbözteti meg az OmniRoute-ot
📊 Teljes módszertan & funkciónkénti részletek a 9router, OpenRouter, CLIProxyAPI & LiteLLM ellenében → [`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 **v3.8.20 → v3.8.50** verziók legfontosabb újdonságai. A teljes előzmény a [`CHANGELOG.md`](CHANGELOG.md) fájlban található.
- **🎛️ OmniConductor** — bejövő A2A-delegálás az ügynökflottádhoz, Conductor-képességek az Agent Cardon, valamint egy irányítópultpanel Faro adó-vevő hangcsevegéssel. → [A2A-kiszolgáló](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptív beléptetés és túlterhelés elleni védelem** — a nagy erőforrás-igényű csevegési kérések 503-as hiba helyett várólistára kerülnek, kapcsolatonkénti atomi, gördülő RPM-bérletekkel. → [Ellenálló képességi útmutató](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonikus `/v1/models`-sorrend** — szolgáltatónként egyetlen összefüggő, szolgáltató szerint csoportosított blokk (a kombinációk elöl rögzítve), minden katalógusforrásban stabilan. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🗜️ Megerősített tömörítés** — alapértelmezetten bekapcsolt kibontási védelem, Caveman-csomagok némethez, franciához, japánhoz és kínaihoz (wényán), valamint RTK-szűrők Gradle-höz és .NET-hez. → [Tömörítés](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Valósághű átalánydíjas költség** — az előfizetéses/kódolási csomagot kínáló szolgáltatók költségelemzési értéke **$0**; a költségkeret, a kvóta és az útválasztás továbbra is becslést használ. → [API-referencia](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share útválasztás** — egy megosztott fiók kvótájának méltányos elosztása az összevont kulcsok között, munkamegőrző módon, így a kihasználatlan részek kölcsönadhatók. → [Ellenálló képességi útmutató](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Egyparancsos CLI-/ügynökbeállítás** — 13 regisztrált `setup-*` parancs; az `omniroute run` 7 CLI-t indít el (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); az `omniroute configure` 10 célrendszert támogat interaktív szolgáltató- és modellválasztóval, valamint kontextusonkénti kedvencekkel. → [CLI-integrációk](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Távoli mód** — távoli OmniRoute vezérlése korlátozott hatókörű tokenekkel (`connect` / `contexts` / `tokens`), valamint egy `antigravity` OAuth-segédeszközzel VPS-telepítésekhez. → [Távoli mód](docs/guides/REMOTE-MODE.md)
- **🧭 Intelligensebb automatikus útválasztás** — `auto/:` kombinációk, **Fusion** (modellpanel + bíró), feladattudatos útválasztás, valamint kérésenkénti modell-, mód- és USD-költségkeret-felülbírálás. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Bővíthető tömörítés** — 12 kombinálható motor + Compression Studios: LLMLingua-2, kétszintű Ultra, omniglyph, lépésenkénti hűségkapu, GCF v3.2, húzással átrendezhető szerkesztő. → [Tömörítés](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transzparens MITM-visszafejtés (TPROXY)** — a proxykörnyezeti változókat figyelmen kívül hagyó CLI-k forgalmának elfogása SNI-nkénti hitelesítésszolgáltatóval és bizalmi tárat konfiguráló telepítővel. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Mindenre kiterjedő költségtelemetria** — `X-OmniRoute-*` költség- és használati fejlécek minden végponton, gyorsítótártalálati megtakarítási fejléc, kulcsonkénti USD-költési kvóták. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🧠 Általad felügyelt memória** — alapértelmezetten kikapcsolva, opcionális int8 vektorkvantálás + típusos lecsengés, kérésenkénti `x-omniroute-no-memory`. → [Memória](docs/frameworks/MEMORY.md)
- **🛡️ Biztonság** — promptinjektálás elleni védelem minden LLM-útvonalon (red-team tesztcsomag), opcionális hitelesítőadat-maszkolási védőkorlát (mindkét irányban kitakarja a kiszivárgott API-kulcsokat és titkokat), ingyenes DuckDuckGo webes keresés végső megoldásként, valamint opcionális OIDC-bejelentkezési kapu az irányítópulthoz (a jelszavas bejelentkezés mindig elérhető marad). → [Védőkorlátok](docs/security/GUARDRAILS.md)
- **🖼️ Új végpontok** — a `/v1/ocr` (Mistral OCR) és a `/v1/audio/translations` (Whisper-stílusú) teszi teljessé a médiafunkciókat. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🎨 Kép-, videó- és hanggenerálás** — egyetlen API médiához: xAI Grok Imagine és Novita AI videó, ComfyUI, Magnific, Adobe Firefly, Segmind, valamint beszédszolgáltatók, például az ElevenLabs. → [API-referencia](docs/reference/API_REFERENCE.md)
- **🌍 Telepítés és üzemeltetés** — fordított proxyhoz használható `basePath`, böngészőnyelv automatikus felismerése, kulcsonkénti eszközkövetés, root nélküli MITM-megbízhatóság, zh-TW-lokalizáció. → [Környezet](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, teljes értékű Ollama-kártya, Claude Opus 5 és Sonnet 5, hivatalos Kimi-partnerség (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… valamint egy megújult, **352 szolgáltatót tartalmazó katalógus**. → [Szolgáltatók](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Átlátható útválasztás** — minden válasz tartalmaz egy `X-OmniRoute-Decision` fejlécet, amely megnevezi a kiszolgáláshoz használt stratégiát, szolgáltatót és késleltetést; az új `cache-optimized` kombinációs stratégia és az Auto-Combo `cacheAffinity` tényezője visszairányítja az ismételt kéréseket a gyorsítótárazott előtagot tároló kapcsolathoz; az írásvédett `/v1/auto-combo/{channel}/candidates` végpont pedig felfedi egy `auto/*` csatorna aktuális jelöltkészletét. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Helyi teljesítmény és infrastruktúra** — egykattintásos helyi Redis, Cloudflare Workers-/Deno Deploy-relételepítők, valamint felügyelt beágyazott szolgáltatásként futó Bifrost és Mux. → [Beágyazott szolgáltatások](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Szintén a csomag része** — bővítménykeretrendszer + piactér, Omni-/Agent-/GitHub-képességkeretrendszerek, Obsidian-tárolóintegráció (22 MCP-eszköz), OpenAI-kompatibilis Batch- és Files API-k, szemantikus válaszgyorsítótár, ranglistás játékosítás, ACP-ügynökfelderítés (15 beépített ügynök), ütemezett naplóexportálás BigQuerybe, `auto/chaos` hibainjektálás, Telegram-bot-híd, alkalmazáson belüli verziókezelő és LMArena-ELO rangsorok az ingyenes szolgáltatókhoz. → [Dokumentáció](docs/README.md)
## 🤖 Kompatibilis CLI-k és kódoló ügynökök
> Egyetlen konfiguráció — `http://localhost:20128/v1` — és **minden** AI-alapú IDE vagy CLI ingyenes és alacsony költségű modellekkel működik.
**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 beinjektált hitelesítő adatokkal; a Qwen/Gemini ideiglenes, elkülönített saját könyvtárat 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álassz interaktívan szolgáltatót és modellt, majd írd ki az eszköz saját konfigurációját:
omniroute configure codex # további lehetőségek: claude opencode qwen aider goose gemini cline continue kilo
```
Minden parancs figyelembe veszi az aktív távoli környezetet (`omniroute connect `), a `--dry-run`
végrehajtás nélkül megjeleníti a pontos környezeti változókat és argumentumokat, az `--api-key-env NAME` pedig távol tartja a titkos adatokat
a parancsérzékeny terminálelőzményektől. → [CLI-integrációk](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 357 MI-szolgáltató — 152 a katalógusban ingyenesként jelölve
> **357 regisztrált szolgáltató** a kanonikus csevegési, média-, keresési, helyi, felhőügynök- és rendszergyűjteményekben, köztük **152 olyan, amely `hasFree: true` felderítési metaadatot hordoz**. A csevegésimodell-nyilvántartás **229 szolgáltatót / 2,554 különálló szolgáltató–modell-párt / 1,283 nyers modellazonosítót** tartalmaz; a különálló ingyenes keretkatalógusban **491 modellenkénti sor**, **35 ismétlődő keretkészlet**, valamint **54 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 keretkészletek szerinti duplikációmentes számítások a [Szolgáltatói referenciában](docs/reference/PROVIDER_REFERENCE.md) és az [Ingyenes csomagok](docs/reference/FREE_TIERS.md) dokumentációjában találhatók.
### 🏢 Minden jelentős labor — egyetlen végponton keresztül
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…és további 330+ — minden ikon élőben töltődik be az irányítópult szolgáltatói katalógusából. 📖 [Szolgáltatói referencia](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 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
### 🧩 Ú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 kiszolgálón túl az OmniRoute egy **teljes parancssori vezérlőközpont** **több mint 80 paranccsal**, valamint nyílt ügynökprotokollokkal, így egy MI-ügynök **önállóan** is vezérelheti.
### ⌨️ Valódi CLI (nem csak `start`)
```bash
omniroute # az átjáró és az irányítópult kiszolgálása (20128-as port)
omniroute chat # interaktív TUI-csevegőkliens (perjeles parancsok: /model /combo /skill /memory)
omniroute setup # vezetett varázsló az első indításhoz
omniroute doctor # szolgáltatók, portok és natív függőségek diagnosztizálása
```
### 🛰️ Távoli mód — a CLI itt, az OmniRoute pedig egy VPS-en fut
Az OmniRoute egy kiszolgálón fut? Vezérelje laptopjáról **ugyanazzal a CLI-vel**. Jelentkezzen be egyszer
egy korlátozott hatókörű hozzáférési tokennel; ezután minden parancs a távoli példányt célozza meg.
```bash
omniroute connect 192.168.0.15 # jelszó → korlátozott hatókörű token, kontextusként mentve
omniroute models list # ← a TÁVOLI kiszolgálón fut
omniroute configure codex # ← kiválaszt egy távoli modellt, és létrehoz egy helyi Codex-profilt
omniroute tokens create --name ci --scope read # szűkebb hatókörű tokenek létrehozása más gépekhez
omniroute contexts use default # ← visszaváltás a helyi kiszolgálóra
```
A tokenek hatóköre `read` / `write` / `admin`; a folyamatokat indító útvonalak kizárólag a loopback interfészen érhetők el.
📖 [Távoli mód](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-n**, **A2A-n**, **REST API-n**, **webhookokon** vagy **távoli CLI-n** keresztül — így bármely megfelelő képességű ügynök (vagy saját kódja) hozzáférést kap a teljes átjáróhoz: az útválasztáshoz, a szolgáltatókhoz, a kombinációkhoz, a gyorsítótárhoz, a tömörítéshez és a memóriához — mindezt önállóan. Az alábbi HTTP-végpontok a `http://localhost:20128` címen érhetők el.
Interfész
Végpont / parancs
Felhasználási cél
🧰 MCP (stdio)
omniroute --mcp
Csatlakoztatás a Claude Desktophoz, a Cursorhoz vagy bármely MCP-klienshez
🌊 MCP (HTTP)
/api/mcp/stream
Távoli MCP — 110 eszköz, 33 hatókör (a kikényszerítés választható), teljes auditnapló
📡 MCP (SSE)
/api/mcp/sse
Adatfolyam-alapú MCP-átvitel
🤝 A2A
/.well-known/agent.json
Ügynökök közötti kommunikáció, JSON-RPC 2.0 + SSE, 6 készség
Kérés- és kvótaesemények küldése Slackre, Discordra, Telegramra vagy bármely URL-re
🛰️ Távoli CLI
omniroute connect
Távoli példány vezérlése korlátozott hatókörű hozzáférési tokenekkel
```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-kiszolgáló](docs/frameworks/MCP-SERVER.md) · [A2A-kiszolgáló](docs/frameworks/A2A-SERVER.md) · [Ügynökprotokollok](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ 15–95%-os tokenmegtakarítás — automatikusan
### 📖 Hogyan működik — folyamat, architektúra és a megtakarítás kiszámítása
Az alapértelmezett, egymásra épülő kombináció az `RTK → Caveman` sorrendet használja. Amikor mindkettő ugyanazon eszköz-/kontextustartalmon működik, a megtakarítások összeszorzódnak:
```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áljunk sok tokent, ha kevés is elvégzi a feladatot?** Minden kérés **átlátható módon** halad át az OmniRoute tömörítési folyamatán — nincs szükség kliensoldali módosításokra. Ez mostantól **12 kombinálható motorból álló rendszer**, amelyben a motorok sorrendben futnak, és útválasztási kombinációnként szabadon párosíthatók — a [RTK](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) ötleteire építve.
### 🧱 A 12 motorból álló rendszer
A motorok a folyamat sorrendjében futnak; mindegyik egymástól függetlenül kapcsolható be és konfigurálható kombinációnként:
#
Motor
Mit csinál?
1
Session-Dedup
Eltávolítja a beszélgetési fordulók között ismétlődő tartalmat (tartalomcímzett, fordulókon átívelő)
2
CCR
A nagy blokkokat lekérési jelölők mögé archiválja, amelyek igény szerint kérhetők le
3
Lite
Szóközök és kép-URL-ek egyszerűsítése (alacsony késleltetésű alapmegoldás)
4
RTK
Intelligens eszközeredmény-szűrés, duplikációeltávolítás és csonkolás (parancstudatos)
5
Responses Tool Output
Elsődlegesen veszteségmentes JSON-tömörítés, valamint korlátozott diagnosztikai tömörítés shell-/javítási/keresési/build-kimenetekhez (Responses API)
6
Headroom
JSON-tömbök veszteségmentes, táblázatos tömörítése (~30%) egy beépített GCF kodekkel
7
Relevance
Kivonatoló mondatpontozás a legutóbbi felhasználói lekérdezés alapján
8
Caveman
Szabályalapú prózatömörítés (~65–75% a kimeneten)
9
Aggressive
Összegzés és a régi beszélgetési fordulók fokozatos tömörítése
Kísérleti, kontextust képként kódoló megoldás a mért Claude Fable 5-höz a közvetlen Anthropic-kapcsolaton; a GPT 5.6 transzformátorok továbbra is zárt hibakezelést alkalmaznak a szolgáltatói visszaigazolások beérkezéséig. Négy tömörítési profil (alapértelmezett agresszív, kiegyensúlyozott, kódbiztos, változtatás nélküli) (a legagresszívebb; külön engedélyezendő)
A kódblokkok, URL-ek és strukturált adatok **mindig bájtpontosan megmaradnak**. Az **egykattintásos előbeállítások** kombinálják a motorokat:
Mód
Megtakarítás
Ehhez ideális
🪶 Lite
~15%
Biztonságos, mindig aktív alapértelmezés
🪨 Standard (Caveman)
~30%
Mindennapi programozás
⚡ Aggressive
~50%
Hosszú, eszközintenzív munkamenetek
🔥 Ultra
~75%
Maximális megtakarítás
🧰 RTK
60–90%
Shell-/teszt-/build-/git-kimenet
🔗 Stacked (RTK → Caveman)
78–95%
Vegyes promptok és eszköznaplók
**Valós példa — Standard mód:**
> **Előtte (69 token):** _„A React-komponensed valószínűleg azért renderelődik újra, mert minden renderelési ciklusban új objektumhivatkozást hozol létre. Amikor beágyazott objektumot adsz át propként, a React sekély összehasonlítása minden alkalommal eltérő objektumként érzékeli azt, ami újrarenderelést vált ki. Azt javaslom, hogy a useMemo használatával jegyezd meg az objektumot.”_
>
> **Utána (19 token):** _„Minden renderelésnél új objektumhivatkozás. Beágyazott objektumprop = új hivatkozás = újrarenderelés. Csomagold useMemo-ba.”_
>
> **Ugyanaz a válasz. 72%-kal kevesebb token. Nulla pontosságvesztés.** ✅
**PT-BR példa — [Troglodita](https://github.com/leninejunior/troglodita) mód:**
> **Előtte (42 token):** _„A probléma az, hogy a komponens minden renderelési ciklusban újrarenderelődik, mert minden alkalommal új objektumreferencia jön létre. A `useMemo` használatát javasolnám.”_
>
> **Utána (12 token):** _„Újrarenderelés: minden ciklusban új referencia (az inline objektum újra létrejön). Használd a `useMemo`-t.”_
>
> **Ugyanaz a válasz. ~70%-kal kevesebb token. A technikai pontosság változatlan.** ✅
### 🎚️ A motorokon túl — kimeneti stílusok, adaptív szabályozó és kérésenkénti vezérlés
A fenti 12 motor azt csökkenti, ami **bekerül**. További három réteg alakítja, **hogyan**, **mikor** és mi **kerül ki**:
- **🪄 Kimeneti stílusok** _(kimeneti tengely szerinti vezérlés)_ — determinisztikus, gyorsítótárbarát utasításokat illesztenek be a válasz formálásához; kombinálhatók, mindegyik `lite` / `full` / `ultra` intenzitással. Új stílus hozzáadásához elég egyetlen sor a nyilvántartásban:
- **Tömör próza** — elhagyja a töltelékszavakat / névelőket / óvatoskodást; a technikai tartalmat pontosan megőrzi.
- **Kevesebb kód** — „lusta senior fejlesztő” YAGNI: a legkisebb működő módosítás, nem kért vázkód nélkül.
- **Lófarok (lusta senior fejlesztő)** — végigjárja a YAGNI-létrát, kijavítja a kiváltó okot, a lehető legkisebb működő diffel.
- **ADHD-m van (cselekvésközpontú)** — a következő művelettel kezd, számozott lépések, egy konkrét következő lépés, bevezetés nélkül.
- **Tömör CJK (文言)** — klasszikus kínai, rendkívül tömör stílus (területi beállítás alapján csak `zh` esetén).
- **🎯 Adaptív kontextuskeret** _(a szabályozó)_ — egyetlen be-/kikapcsolható tokenküszöb helyett csak addig fokozza a legolcsóbb, legkisebb veszteségű motorok használatát, amíg a tartalom **belefér a modell kontextusablakába**. Házirend: `reserve-output` (alapértelmezett, modellfüggő) · `percentage` · `absolute`. Mód: `floor` (garantált illeszkedés) · `replace-autotrigger` (a kifejezett választásod élvez elsőbbséget) · `off` (korábbi küszöbalapú működés).
- **🎛️ Hol dől el a tömörítés** _(precedencia, magastól az alacsonyig)_ — kérésenkénti `x-omniroute-compression` fejléc › útválasztási kombináció felülbírálása › aktív, névvel ellátott profil › adaptív / automatikus aktiválás › panel alapértelmezése › kikapcsolva. Az alkalmazott terv visszajelenik az `X-OmniRoute-Compression: ; source=` válaszfejlécben.
Állíts be tokenküszöb szerinti automatikus aktiválást, kapcsold be az adaptív szabályozót, rögzíts egy névvel ellátott profilt, adj meg egyszeri beállítást kérésenként, vagy rendelj folyamatot minden útválasztási kombinációhoz — attól függően, melyik illik a munkaterheléshez. Egy opcionális, offline **kiértékelési keretrendszer** (`npm run eval:compression`) rögzített korpuszon pontozza a tartalomhűséget és a megtakarítást, mielőtt élesítenél egy módosítást.
📖 [`COMPRESSION_GUIDE.md`](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` üzenetet vagy peer-függőségi figyelmeztetéseket látsz? [Ezek ártalmatlanok](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
A vezérlőpult címe: `http://localhost:20128` · Az API címe: `http://localhost:20128/v1`.
**2) Csatlakoztass egy INGYENES szolgáltatót (regisztráció nélkül)**
Vezérlőpult → **Szolgáltatók** → csatlakoztasd a **Kiro AI** szolgáltatást (ingyenes Claude, fiókonként ~50 kredit/hónap) vagy az **OpenCode Free** szolgáltatást (nincs hitelesítés) → kész.
**3) Állítsd be a programozási eszközödet**
```txt
Alap URL: http://localhost:20128/v1
API-kulcs: [másold ki innen: Vezérlőpult → Végpontok]
Modell: auto (konfigurációmentes intelligens útválasztás — vagy bármely szolgáltató/modell)
```
**4) Ellenőrizd a működést**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
A csatlakoztatott modellek listájának kell megjelennie. 🎉 Ennyi — kezdhetsz programozni, az OmniRoute pedig automatikusan elvégzi az útválasztást, és szükség esetén tartalékra vált.
Ha a kliensed nem tud egyéni fejléceket küldeni, az OmniRoute tokenizált kompatibilitási aliasokat is biztosít:
```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 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.
Tesztlefedettségi stratégia több mint 39 000 statikus tesztdeklarációhoz, több mint 5 100 nyomon követett tesztfájlban
# ⭐ Legkiemelkedőbb közreműködők
> Az OmniRoute-ot egy lelkes nyílt forráskódú közösség alakítja. Ezek a személyek 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érhetőségét. **Köszönjük.**
### Külső közreműködők az egyesített pull requestek száma szerint
A release/v3.8.50 élő ág dafb4ae808 csúcsán rögzítve, a 2026-08-24 05:26:03 UTC időpontig végrehajtott egyesítésekkel. A lapozott GitHub GraphQL-felmérés 5 911 egyesített PR-t tartalmaz: 2 707-et a tároló tulajdonosától, 179-et a Dependabottól, valamint 3 025 külső PR-t 535 különböző közreműködőtől. A „Módosított sorok” a GitHubon szereplő hozzáadások és törlések összege, és magában foglalja a generált fájlokat, zárolási fájlokat, katalógusokat, fordításokat és dokumentációt; ez a változtatások mennyiségét jelzi, nem a szerző által írt forráskódsorok számát. A határértéknél kialakult holtversenyeket megtartottuk.
### GitHubhoz rendelt commitok
Bob.Hou 🏅 51 GitHubnak tulajdonított commit · holtversenyben a 10. helyen
Xiangzhe 🏅 51 GitHubnak tulajdonított commit · holtversenyben a 10. helyen
Újraellenőrizve 2026-08-24 06:14:31 UTC időpontban: a tároló Contributors API-ja által a release/v3.8.50 alapértelmezett ághoz jelentett, GitHubnak tulajdonított commitok. Az API 525 identitást adott vissza (415 felhasználó, 2 bot, 108 névtelen); ez a táblázat kizárja a karbantartót, a botokat és a névtelen identitásokat, a holtversenyeket pedig megtartja. Ez eltér mind a fenti, egyesített PR-okon alapuló rangsortól, mind az alábbi, 639 személyt tartalmazó 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, 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 mindazoknak, akik saját zsebükből finanszírozzák az OmniRoute-ot — minden hozzájárulás segít abban, hogy a projekt ingyenes, független és folyamatosan fejlődő maradjon.
… és mások, akik inkább névtelenek szeretnének maradni 💛A nyilvános GitHub-szponzorok újbóli ellenőrzése 2026-08-24-én történt. A fenti aktív címkéket a GitHub activeOnly állapota határozza meg; a korábban nyilvánosságra hozott egyszeri támogatóknak továbbra is köszönetet mondunk, a privát szponzorok pedig névtelenek maradnak.💖 Legyél szponzor → — minden dollár hozzájárul ahhoz, hogy az OmniRoute ingyenes és független maradjon.
## 👥 Több mint 600 közreműködő
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
A 2026-08-24-én, a rögzített ac02c5b42f alapon elvégzett audit, majd az élő release/v3.8.50 ág dafb4ae808 csúcsán végzett újbóli ellenőrzés eredménye: 639 normalizált, emberhez tartozó Git-identitás — közülük 407 commit-szerzőként jelenik meg (beleértve a karbantartót is), 232 pedig kizárólag explicit Co-authored-by záradékokban. Az összesítés normalizálja a GitHub noreply-azonosítókat, kizár 26 bot-, ügynök-, szolgáltatás- vagy helyőrző-identitást, és nem von össze szokványos e-mail-címeket pusztán azért, mert a megjelenített nevük megegyezik.
### Hogyan járulhatsz hozzá
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. 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 úgy, hogy **a célág = az adott `release/vX.Y.Z` ág**
A részletes irányelveket lásd a [CONTRIBUTING.md](CONTRIBUTING.md) fájlban.
### Ú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)** elágazásaként és a **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** Go-projekt TypeScript-portjaként indult — ezt követően pedig minden alábbi alrendszert egy olyan nyílt forráskódú projekt ihletett, amely már korábban megvalósította az adott megoldást. Mindegyikük az OmniRoute egy-egy konkrét részét formálta. Ezúton mondunk köszönetet mindannyiuknak. 🙏
> ⭐ A csillagok száma 2026. augusztus 24-én lett ellenőrizve a GitHub REST API-ján keresztül — adj egy csillagot ezeknek a projekteknek. Az értékek egy adott időpontban készült pontos pillanatfelvételt tükröznek, ezért természetes módon változni fognak.
### 🧬 Eredet és átjáró
Az MI-átjáró, amelynek nyilvános árazási adatkészlete táplálja a költségkövetési szinkronizálásunkat, szolgáltatónormalizálási modellje pedig alapul szolgált az útválasztásunkhoz.
MIT-forrás, amelyet a csomagba foglalt ChatGPT Web → Codex Responses-hídhoz adaptáltunk, beleértve a böngészőmunkamenet-, válaszkeretezési, használati és webeskeresés-adaptereket.
A stream-helyreállításba, a gondolkodás nélküli aliasokba, a tartalék webes keresésbe, a csúszóablakos korlátokba, a naplókitakarásba és a megerősített indítási folyamatokba átemelt minták.
A Grok-modellleképezéseit, ál-TypeError Statsig-generátorát, kérés- és eszköz-alapértelmezéseit, valamint NDJSON-válaszfeldolgozóját jelentős mértékben adaptáltuk az OmniRoute Grok Web-végrehajtójához.
A grok2api-merged mögötti elsődleges tranzitív kódforrás; modell-, fejléc-, hasznosadat-, Statsig- és feldolgozóimplementációi megmaradtak a Grok Web származási láncában.
A Grok hasznosadat- és eszköz-alapértelmezéseinek, a Statsig-generátornak és a TQZHR-en, valamint a grok2api-mergeden keresztül továbbörökített result.response-feldolgozónak az alapjául szolgáló MIT-forrás.
A grok2api-merged által a proxykészlet-rétegéhez forrásként megjelölt tranzitív forrás; az OmniRoute megőrzi ezt a származási hivatkozást, de nem állítja, hogy korlátozott hatókörű Grok Web-végrehajtója tartalmazná a proxykészlet portját.
Az eredeti Grok Web-implementáció figyelembe vette a HTTP-/böngészőalapú upstream kialakítását; közvetlen HTTP-útvonala a GrokProxyból származik, ezért nem állítjuk, hogy önálló kódport történt.
A virálissá vált „miért használ sok token, ha kevés token is elég” projekt — ősemberbeszéd-filozófiája adja a szabványos tömörítési módunk és több mint 30 töltelékszó-eltávolítási/tömörítési szabályunk alapját.
Nagy teljesítményű parancskimenet-tömörítés — ez ihlette az RTK-motorunkat, a JSON-szűrő DSL-t, a nyers kimenet visszaállítását és az egymásra épülő RTK → Caveman folyamatot.
Prompttömörítési kutatás (LLMLingua / LLMLingua-2) — ez ihlette az aszinkron, kódbiztos, hiba esetén eredeti tartalommal továbbműködő llmlingua motorunkat.
PT-BR tokentömörítés — ez működteti a pt-BR nyelvi csomagunkat: a brazil portugál nyelvtanra hangolt pleonazmuscsökkentést és töltelékszó-eltávolítást.
A virálissá vált „lusta senior fejlesztő” YAGNI-kódolási készség — ez ihlette a less-code kimeneti stílusunkat: a legkisebb működő módosításra irányító megközelítést, amely csökkenti a _generált_ kód mennyiségét (a Caveman tömör prózájának kimeneti tengelyen értelmezett párja).
Tartalomtudatos, fájltípusonkénti kimenettömörítés hibatudatos megszakítással — megerősítette a típusonkénti továbbításunk és a minimális nyereség alatti kihagyásunk helyességét.
„Találd meg a szellemtokeneket” — a tehermentesítési és visszaállítható hivatkozási mintája hozzájárult a CCR-tehermentesítésre vonatkozó elképzeléseinkhez.
Rust-alapú oszlopos JSON + tartalomcímzett lekérés + üzeneteken átívelő deduplikáció — megerősítette a headroom/ccr/session-dedup motorjaink kialakítását és azt a gyorsítótár-stabil invariánst, hogy „a tömörített forma pozíciófüggetlen”.
TypeScript Compiler API-eszközkészlet — ez ihlette az elemzőalapú megjegyzés-eltávolításunkat, amely megőrzi a sztring-, sablon- és reguláriskifejezés-literálokat.
A kódolási asszisztens ↔ LLM-forgalom MITM-alapú elfogása és elemzése hozzájárult a Traffic Inspector korai követelményeinek meghatározásához. Négy korábban származtatott modult — az SSE-egyesítést, a beszélgetések normalizálását, a titkos adatok maszkolását és a fejlécek megtisztítását — nyilvános protokollszabványokon alapuló, független, tisztatéri implementációkra cseréltünk. A két gazdagép-átengedési felület (passthrough.ts és _internal/bypass.cjs) továbbra is egymástól függetlenül besorolt, OmniRoute-on belüli implementáció; ezek nem lettek újraírva a csere részeként.
Transzparens, folyamatonkénti proxyútválasztás — ez inspirálta az összeomlásbiztos MITM-leállítást, a socketek inaktivitási időkorlátait, a /proc alapú folyamat-hozzárendelést és a TPROXY-forgalomelfogást.
### 📚 Modelladatok, megfigyelhetőség és felhasználói felület
Istio szolgáltatásháló-megfigyelhetőség — ez inspirálta a megszakítójelvényeket és a hibakapcsolatok vizuális megjelenítését a Routing/Combo Studio felületén.
Biztonságos alapértelmezéseket alkalmazó könyvtárak válogatott listája, amely irányt mutat biztonsági döntéseinkhez (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ez inspirálta a kérések deduplikációját, a vészhelyzeti, költségmentes tartalékmegoldást, a bővíthető Auto-Combo stratégiákat és a többnyelvű szándékbesorolást.
A fióktudatos modell-újraleképezés, a végrehajthatófájl-útvonalak ellenőrzése és a csomagcímkék működése hozzájárult az OmniRoute Antigravity futtatókörnyezetének kialakításához.
Azonosította a Grok Build kvótafelületét; az OmniRoute ezt követően függetlenül ellenőrizte és javította az éles vezetékes formátumot.
## 📄 Licenc
MIT-licenc – a részletekért lásd: [LICENSE](LICENSE).
---
**[⬆ Vissza a tetejére](#-omniroute)** · ❤️-vel készült a nyílt forráskódú MI-közösség számára.
OmniRoute v3.8.51 · Node ≥22.22.2 · MIT-licenc · omniroute.online