omniroute 1.4.10 → 1.5.0

package/README.hu.md

@@ -0,0 +1,1238 @@
+<div align="center">
+  <img src="./docs/screenshots/MainOmniRoute.png" alt="OmniRoute Dashboard" width="800"/>
+  
+  # 🚀 OmniRoute – Az ingyenes mesterséges intelligencia átjáró
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Soha ne hagyd abba a kódolást. Intelligens útválasztás **INGYENES és alacsony költségű mesterséges intelligencia modellekhez** automatikus visszaállítással.
+
+_Az univerzális API-proxy – egy végpont, 36+ szolgáltató, nulla állásidő._
+
+**Csevegés befejezése • Beágyazások • Képgenerálás • Hang • Újrarangsorolás • 100% TypeScript**
+
+---
+
+### 🤖 Ingyenes mesterséges intelligencia szolgáltató kedvenc kódoló ügynökei számára
+
+_Csatlakoztasson bármilyen mesterséges intelligencia-alapú IDE-t vagy CLI-eszközt az OmniRoute-on keresztül – ingyenes API-átjáró a korlátlan kódoláshoz._
+
+  <table>
+    <tr>
+      <td align="center" width="110">
+        <a href="https://github.com/cline/cline">
+          <img src="./public/providers/openclaw.png" alt="OpenClaw" width="48"/><br/>
+          <b>OpenClaw</b>
+        </a><br/>
+        <sub>⭐ 205K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/HKUDS/nanobot">
+          <img src="./public/providers/nanobot.png" alt="NanoBot" width="48"/><br/>
+          <b>NanoBot</b>
+        </a><br/>
+        <sub>⭐ 20.9K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/sipeed/picoclaw">
+          <img src="./public/providers/picoclaw.jpg" alt="PicoClaw" width="48"/><br/>
+          <b>PicoClaw</b>
+        </a><br/>
+        <sub>⭐ 14.6K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/zeroclaw-labs/zeroclaw">
+          <img src="./public/providers/zeroclaw.png" alt="ZeroClaw" width="48"/><br/>
+          <b>ZeroClaw</b>
+        </a><br/>
+        <sub>⭐ 9.9K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/nearai/ironclaw">
+          <img src="./public/providers/ironclaw.png" alt="IronClaw" width="48"/><br/>
+          <b>IronClaw</b>
+        </a><br/>
+        <sub>⭐ 2.1K</sub>
+      </td>
+    </tr>
+    <tr>
+      <td align="center" width="110">
+        <a href="https://github.com/anomalyco/opencode">
+          <img src="./public/providers/opencode.svg" alt="OpenCode" width="48"/><br/>
+          <b>OpenCode</b>
+        </a><br/>
+        <sub>⭐ 106K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/openai/codex">
+          <img src="./public/providers/codex.png" alt="Codex CLI" width="48"/><br/>
+          <b>Codex CLI</b>
+        </a><br/>
+        <sub>⭐ 60.8K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/anthropics/claude-code">
+          <img src="./public/providers/claude.png" alt="Claude Code" width="48"/><br/>
+          <b>Claude Code</b>
+        </a><br/>
+        <sub>⭐ 67.3K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/google-gemini/gemini-cli">
+          <img src="./public/providers/gemini-cli.png" alt="Gemini CLI" width="48"/><br/>
+          <b>Gemini CLI</b>
+        </a><br/>
+        <sub>⭐ 94.7K</sub>
+      </td>
+      <td align="center" width="110">
+        <a href="https://github.com/Kilo-Org/kilocode">
+          <img src="./public/providers/kilocode.png" alt="Kilo Code" width="48"/><br/>
+          <b>Kilo Code</b>
+        </a><br/>
+        <sub>⭐ 15.5K</sub>
+      </td>
+    </tr>
+  </table>
+
+<sub>📡 Minden ügyintéző a <code>http://localhost:20128/v1</code> vagy <code>http://cloud.omni_TOKEN_244\_\_http://cloud.omniroute_EN_2NI4/v_1_TO_2.online-on keresztül csatlakozik konfiguráció, korlátlan modellek és kvóta</sub>
+
+---
+
+[![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute)
+[![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute)
+[![License](https://img.shields.io/github/license/diegosouzapw/OmniRoute)](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
+[![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online)
+[![WhatsApp](https://img.shields.io/badge/WhatsApp-Community-25D366?logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+
+[🌐 Website](https://omniroute.online) • [🚀 Quick Start](#-quick-start) • [💡 Features](#-key-features) • [📖 Docs](#-documentation) • [💰 Pricing](#-pricing-at-a-glance) • [💬 WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+
+🌐 **Available in:** 🇺🇸 [English](README.md) | 🇧🇷 [Português (Brasil)](README.pt-BR.md) | 🇪🇸 [Español](README.es.md) | 🇫🇷 [Français](README.fr.md) | 🇮🇹 [Italiano](README.it.md) | 🇷🇺 [Русский](README.ru.md) | 🇨🇳 [中文 (简体)](README.zh-CN.md) | 🇩🇪 [Deutsch](README.de.md) | 🇮🇳 [हिन्दी](README.in.md) | 🇹🇭 [ไทย](README.th.md) | 🇺🇦 [Українська](README.uk-UA.md) | 🇸🇦 [العربية](README.ar.md) | 🇯🇵 [日本語](README.ja.md) | 🇻🇳 [Tiếng Việt](README.vi.md) | 🇧🇬 [Български](README.bg.md) | 🇩🇰 [Dansk](README.da.md) | 🇫🇮 [Suomi](README.fi.md) | 🇮🇱 [עברית](README.he.md) | 🇭🇺 [Magyar](README.hu.md) | 🇮🇩 [Bahasa Indonesia](README.id.md) | 🇰🇷 [한국어](README.ko.md) | 🇲🇾 [Bahasa Melayu](README.ms.md) | 🇳🇱 [Nederlands](README.nl.md) | 🇳🇴 [Norsk](README.no.md) | 🇵🇹 [Português (Portugal)](README.pt.md) | 🇷🇴 [Română](README.ro.md) | 🇵🇱 [Polski](README.pl.md) | 🇸🇰 [Slovenčina](README.sk.md) | 🇸🇪 [Svenska](README.sv.md) | 🇵🇭 [Filipino](README.phi.md)
+
+</div>
+
+---
+
+## 🤔 Miért az OmniRoute?
+
+**Ne pazarolja a pénzt, és ne lépje túl a limiteket:**
+
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> Az előfizetési kvóta minden hónapban fel nem használt
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> A sebességkorlátok megakadályozzák a közbenső kódolást
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> Drága API-k (20-50 USD/hó szolgáltatónként)
+- <img src="https://img.shields.io/badge/✗-e74c3c?style=flat-square" height="16"/> Manuális váltás a szolgáltatók között
+
+**Az OmniRoute ezt megoldja:**
+
+- ✅ **Az előfizetések maximalizálása** - Kövesse nyomon a kvótát, használjon fel minden bitet a visszaállítás előtt
+- ✅ **Automatikus tartalék** - Előfizetés → API-kulcs → Olcsó → Ingyenes, nulla állásidő
+- ✅ **Több fiók** - Kör-robin a fiókok között szolgáltatónként
+- ✅ **Univerzális** - Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, bármilyen CLI eszközzel működik
+
+---
+
+## 🔄 Hogyan működik
+
+```
+┌─────────────┐
+│  Your CLI   │  (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...)
+│   Tool      │
+└──────┬──────┘
+       │ http://localhost:20128/v1
+       ↓
+┌─────────────────────────────────────────┐
+│           OmniRoute (Smart Router)        │
+│  • Format translation (OpenAI ↔ Claude) │
+│  • Quota tracking + Embeddings + Images │
+│  • Auto token refresh                   │
+└──────┬──────────────────────────────────┘
+       │
+       ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI
+       │   ↓ quota exhausted
+       ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc.
+       │   ↓ budget limit
+       ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M)
+       │   ↓ budget limit
+       └─→ [Tier 4: FREE] iFlow, Qwen, Kiro (unlimited)
+
+Result: Never stop coding, minimal cost
+```
+
+---
+
+## ⚡ Gyors kezdés
+
+**1. Globális telepítés:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Az irányítópult ekkor nyílik meg: `http://localhost:20128`
+
+| Parancs                 | Leírás                                        |
+| ----------------------- | --------------------------------------------- |
+| `omniroute`             | Szerver indítása (alapértelmezett port 20128) |
+| `omniroute --port 3000` | Egyéni port használata                        |
+| `omniroute --no-open`   | Ne nyissa meg automatikusan a böngészőt       |
+| `omniroute --help`      | Segítség megjelenítése                        |
+
+**2. Csatlakozzon egy INGYENES szolgáltatóhoz:**
+
+Irányítópult → Szolgáltatók → Csatlakozás **Claude Code** vagy **Antigravity** → OAuth bejelentkezés → Kész!
+
+**3. Használja a CLI eszközben:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+  Endpoint: http://localhost:20128/v1
+  API Key: [copy from dashboard]
+  Model: if/kimi-k2-thinking
+```
+
+**Ennyi!** Kezdje el a kódolást az INGYENES AI modellekkel.
+
+**Alternatív – forrásból fut:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Docker
+
+Az OmniRoute nyilvános Docker-képként érhető el a [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute) webhelyen.
+
+**Gyors futás:**
+
+```bash
+docker run -d \
+  --name omniroute \
+  --restart unless-stopped \
+  -p 20128:20128 \
+  -v omniroute-data:/app/data \
+  diegosouzapw/omniroute:latest
+```
+
+**Környezetfájllal:**
+
+```bash
+# Copy and edit .env first
+cp .env.example .env
+
+docker run -d \
+  --name omniroute \
+  --restart unless-stopped \
+  --env-file .env \
+  -p 20128:20128 \
+  -v omniroute-data:/app/data \
+  diegosouzapw/omniroute:latest
+```
+
+**A Docker Compose használata:**
+
+```bash
+# Base profile (no CLI tools)
+docker compose --profile base up -d
+
+# CLI profile (Claude Code, Codex, OpenClaw built-in)
+docker compose --profile cli up -d
+```
+
+| Kép                      | Címke    | Méret   | Leírás                 |
+| ------------------------ | -------- | ------- | ---------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250 MB | Legújabb stabil kiadás |
+| `diegosouzapw/omniroute` | `1.0.3`  | ~250 MB | Jelenlegi verzió       |
+
+---
+
+## 💰 Árazás egy pillantásra
+
+| Tier              | Szolgáltató        | Költség                     | Kvóta visszaállítása   | Legjobb a                       |
+| ----------------- | ------------------ | --------------------------- | ---------------------- | ------------------------------- |
+| **💳 ELŐFIZETÉS** | Claude Code (Pro)  | 20 USD/hó                   | 5 óra + heti           | Már előfizetett                 |
+|                   | Codex (Plus/Pro)   | 20-200 USD/hó               | 5 óra + heti           | OpenAI felhasználók             |
+|                   | Gemini CLI         | **INGYENES**                | 180 000/hó + 1 000/nap | Mindenki!                       |
+|                   | GitHub másodpilóta | 10-19 USD/hó                | Havi                   | GitHub felhasználók             |
+| **🔑 API KULCS**  | NVIDIA NIM         | **INGYENES** (1000 kredit)  | Egyszeri               | Ingyenes szintű tesztelés       |
+|                   | DeepSeek           | Felhasználásonkénti fizetés | Nincs                  | Legjobb ár/minőség              |
+|                   | Groq               | Ingyenes szint + fizetett   | Ár korlátozott         | Ultragyors következtetés        |
+|                   | xAI (Grok)         | Felhasználásonkénti fizetés | Nincs                  | Grok modellek                   |
+|                   | Mistral            | Ingyenes szint + fizetett   | Ár korlátozott         | Európai AI                      |
+|                   | OpenRouter         | Felhasználásonkénti fizetés | Nincs                  | 100+ modell                     |
+| **💰 OLCSÓ**      | GLM-4.7            | 0,6 USD/1M                  | Naponta 10:00          | Költségvetési biztonsági mentés |
+|                   | MiniMax M2.1       | 0,2 USD/1M                  | 5 órás gurulás         | Legolcsóbb lehetőség            |
+|                   | Kimi K2            | 9 USD/hó lakás              | 10 millió token/hó     | Előrelátható költség            |
+| **🆓 INGYENES**   | iFlow              | $0                          | Korlátlan              | 8 modell ingyenes               |
+|                   | Qwen               | $0                          | Korlátlan              | 3 modell ingyenes               |
+|                   | Kiro               | $0                          | Korlátlan              | Claude ingyen                   |
+
+**💡 Pro tipp:** Kezdje a Gemini CLI-vel (180 000 ingyenes/hónap) + iFlow (korlátlan ingyenes) kombináció = 0 USD költség!
+
+---
+
+## 🎯 Használati esetek
+
+### 1. eset: "Claude Pro előfizetésem van"
+
+**Probléma:** A kvóta lejár, kihasználatlanul, sebességkorlátozások erős kódolás közben
+
+```
+Combo: "maximize-claude"
+  1. cc/claude-opus-4-6        (use subscription fully)
+  2. glm/glm-4.7               (cheap backup when quota out)
+  3. if/kimi-k2-thinking       (free emergency fallback)
+
+Monthly cost: $20 (subscription) + ~$5 (backup) = $25 total
+vs. $20 + hitting limits = frustration
+```
+
+### 2. eset: "Nulla költséget akarok"
+
+**Probléma:** Nem engedheti meg magának az előfizetést, megbízható mesterséges intelligencia kódolásra van szüksége
+
+```
+Combo: "free-forever"
+  1. gc/gemini-3-flash         (180K free/month)
+  2. if/kimi-k2-thinking       (unlimited free)
+  3. qw/qwen3-coder-plus       (unlimited free)
+
+Monthly cost: $0
+Quality: Production-ready models
+```
+
+### 3. eset: "24 órás kódolásra van szükségem, megszakítás nélkül"
+
+**Probléma:** Határidők, nem engedheti meg magának az állásidőt
+
+```
+Combo: "always-on"
+  1. cc/claude-opus-4-6        (best quality)
+  2. cx/gpt-5.2-codex          (second subscription)
+  3. glm/glm-4.7               (cheap, resets daily)
+  4. minimax/MiniMax-M2.1      (cheapest, 5h reset)
+  5. if/kimi-k2-thinking       (free unlimited)
+
+Result: 5 layers of fallback = zero downtime
+```
+
+### 4. eset: "INGYENES AI-t akarok az OpenClawban"
+
+**Probléma:** AI-asszisztens szükséges az üzenetküldő alkalmazásokhoz, teljesen ingyenes
+
+```
+Combo: "openclaw-free"
+  1. if/glm-4.7                (unlimited free)
+  2. if/minimax-m2.1           (unlimited free)
+  3. if/kimi-k2-thinking       (unlimited free)
+
+Monthly cost: $0
+Access via: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...
+```
+
+---
+
+## 💡 Főbb jellemzők
+
+### 🧠 Core Routing & Intelligence
+
+| Funkció                                 | Mit csinál                                                                                  |
+| --------------------------------------- | ------------------------------------------------------------------------------------------- |
+| 🎯 **Intelligens 4-szintű tartalék**    | Automatikus útvonal: Előfizetés → API-kulcs → Olcsó → Ingyenes                              |
+| 📊 **Valós idejű kvótakövetés**         | Élő tokenszám + visszaszámlálás visszaállítása szolgáltatónként                             |
+| 🔄 **Formátum fordítás**                | OpenAI ↔ Claude ↔ Gemini ↔ Kurzor ↔ Kiro zökkenőmentes + válaszfertőtlenítés                |
+| 👥 **Többfiókos támogatás**             | Több fiók szolgáltatónként intelligens kiválasztással                                       |
+| 🔄 **Automatikus token frissítés**      | Az OAuth-tokenek automatikusan frissülnek                                                   |
+| 🎨 **Egyéni kombók**                    | 6 stratégia: fill-first, round-robin, p2c, random, legkevésbé használt, költségoptimalizált |
+| 🧩 **Egyedi modellek**                  | Adjon hozzá bármilyen modellazonosítót bármely szolgáltatóhoz                               |
+| 🌐 **Wildcard Router**                  | `provider/*` minták továbbítása bármely szolgáltatóhoz dinamikusan                          |
+| 🧠 **Átgondolt költségvetés**           | Átjárási, automatikus, egyéni és adaptív módok érvelési modellekhez                         |
+| 💬 **Rendszer azonnali befecskendezés** | Globális rendszerkérdés minden kérelemre érvényes                                           |
+| 📄 **Responses API**                    | Teljes OpenAI Responses API (`/v1/responses`) támogatás a Codexhez                          |
+
+### 🎵 Multimodális API-k
+
+| Funkció                | Mit csinál                                                   |
+| ---------------------- | ------------------------------------------------------------ |
+| 🖼️ **Képgenerálás**    | `/v1/images/generations` — 4 szolgáltató, 9+ modell          |
+| 📐 **Beágyazás**       | `/v1/embeddings` — 6 szolgáltató, 9+ modell                  |
+| 🎤 **Audio átírás**    | `/v1/audio/transcriptions` — Suttogás-kompatibilis           |
+| 🔊 **Szövegfelolvasó** | `/v1/audio/speech` — Hangszintézis több szolgáltatónál       |
+| 🛡️ **Moderálás**       | `/v1/moderations` — Tartalombiztonsági ellenőrzések          |
+| 🔀 **Átsorolás**       | `/v1/rerank` — A dokumentumok relevancia szerinti átsorolása |
+
+### 🛡️ Rugalmasság és biztonság
+
+| Funkció                           | Mit csinál                                                                                |
+| --------------------------------- | ----------------------------------------------------------------------------------------- |
+| 🔌 **Megszakító**                 | Automatikus megnyitás/bezárás szolgáltatónként konfigurálható küszöbértékekkel            |
+| 🛡️ **Menydörgésellenes csorda**   | Mutex + szemafor sebességkorlátozás API-kulcs-szolgáltatók számára                        |
+| 🧠 **Szemantikus gyorsítótár**    | A kétszintű gyorsítótár (aláírás + szemantikai) csökkenti a költségeket és a késleltetést |
+| ⚡ **Idempotencia kérése**        | 5s dedup ablak ismétlődő kérésekhez                                                       |
+| 🔒 **TLS ujjlenyomat-hamisítás**  | A TLS-alapú botészlelés megkerülése a wreq-js segítségével                                |
+| 🌐 **IP-szűrés**                  | Allowlist/blokkolista API hozzáférés-vezérléshez                                          |
+| 📊 **Szerkeszthető díjkorlátok**  | Konfigurálható fordulatszám, minimális rés és maximális egyidejű rendszerszinten          |
+| 🛡 **API Endpoint Protection**    | Auth kapuzás + szolgáltató blokkolása a `/models` végponthoz                              |
+| 🔒 **Proxy láthatósága**          | Színkódolt jelvények: 🟢 globális, 🟡 szolgáltató, 🔵 kapcsolatonként IP kijelzővel       |
+| 🌐 **3-szintű proxykonfiguráció** | Proxyk konfigurálása globális, szolgáltatónkénti vagy kapcsolatonkénti szinten            |
+
+### 📊 Megfigyelhetőség és elemzés
+
+| Funkció                          | Mit csinál                                                                                      |
+| -------------------------------- | ----------------------------------------------------------------------------------------------- | ----------- |
+| 📝 **Naplózás kérése**           | Hibakeresési mód teljes kérés/válasz naplókkal                                                  |
+| 💾 **SQLite proxynaplók**        | Az állandó proxynaplók túlélik a szerver újraindítását                                          |
+| 📊 **Analytics Dashboard**       | Újragrafikusok: statisztikai kártyák, modellhasználati táblázat, szolgáltatói táblázat          |
+| 📈 **Haladáskövetés**            | SSE előrehaladási események engedélyezése streaming                                             |
+| 🧪 **LLM értékelések**           | Aranykészlet tesztelése 4 meccsstratégiával                                                     |
+| 🔍 **Telemetria kérése**         | p50/p95/p99 késleltetési összesítés + X-Request-Id nyomkövetés                                  |
+| 📋 **Logs Dashboard**            | Egységes 4 lapos oldal: Kérelemnaplók, Proxynaplók, Auditnaplók, Konzol                         |
+| 🖥️ **Console Log Viewer**        | Valós idejű terminál stílusú megjelenítő szintszűrővel, kereséssel, automatikus görgetéssel     |
+| 📑 **Fájlalapú naplózás**        | A konzolelfogó az összes kimenetet JSON-naplófájlba rögzíti                                     | forgatással |
+| 🏥 **Egészségügyi irányítópult** | A rendszer üzemideje, az áramkör megszakítói állapotai, a zárolások, a gyorsítótár statisztikái |
+| 💰 **Költségkövetés**            | Költségvetés-kezelés + modellenkénti árképzés                                                   |
+
+### ☁️ Telepítés és szinkronizálás
+
+| Funkció                       | Mit csinál                                                                                    |
+| ----------------------------- | --------------------------------------------------------------------------------------------- | ------------ |
+| 💾 **Cloud Sync**             | Szinkronizálja a konfigurációt az eszközök között a Cloudflare Workers                        | segítségével |
+| 🌐 **Deploy Anywhere**        | Localhost, VPS, Docker, Cloudflare Workers                                                    |
+| 🔑 **API-kulcskezelés**       | API-kulcsok generálása, forgatása és hatóköre szolgáltatónként                                |
+| 🧙 **Bevezető varázsló**      | 4 lépésben irányított beállítás első felhasználók számára                                     |
+| 🔧 **CLI Tools Dashboard**    | Egy kattintással konfigurálja a Claude, Codex, Cline, OpenClaw, Kilo, Antigravity             |
+| 🔄 **DB biztonsági mentések** | Automatikus biztonsági mentés, visszaállítás, exportálás és importálás az összes beállításhoz |
+| 🌐 **Nemzetközivé válás**     | Teljes i18n next-intl-vel – angol + portugál (Brazília) támogatás                             |
+| 🌍 **Nyelvválasztó**          | Globe ikon a fejlécben a valós idejű nyelvváltáshoz (🇺🇸/🇧🇷)                                   |
+| 📂 **Egyéni adattár**         | `DATA_DIR` env var felülírja az alapértelmezett `~/.omniroute` tárolási útvonalat             |
+
+<details>
+<summary><b>📖 Funkció részletei</b></summary>
+
+### 🎯 Intelligens 4 szintes tartalék
+
+Hozzon létre kombókat automatikus visszaállítással:
+
+```
+Combo: "my-coding-stack"
+  1. cc/claude-opus-4-6        (your subscription)
+  2. nvidia/llama-3.3-70b      (free NVIDIA API)
+  3. glm/glm-4.7               (cheap backup, $0.6/1M)
+  4. if/kimi-k2-thinking       (free fallback)
+
+→ Auto switches when quota runs out or errors occur
+```
+
+### 📊 Valós idejű kvótakövetés
+
+- Token fogyasztás szolgáltatónként
+- Visszaszámlálás visszaállítása (5 órás, napi, heti)
+- Költségbecslés a fizetett szintekre
+- Havi kiadási jelentések
+
+### 🔄 Formátum fordítás
+
+Zökkenőmentes fordítás a formátumok között:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI válaszok**
+- A CLI eszköz OpenAI formátumot küld → OmniRoute lefordítja → szolgáltató natív formátumot kap
+- Minden olyan eszközzel működik, amely támogatja az egyéni OpenAI végpontokat
+- **Válaszfertőtlenítés** - Törli a nem szabványos mezőket a szigorú OpenAI SDK-kompatibilitás érdekében
+- **Szerepnormalizálás** — `developer` → `system` nem OpenAI esetén; `system` → `user` GLM/ERNIE modellekhez
+- **Gondolkodó címke kivonatolás** — `<think>` blokkok → `reasoning_content` gondolkodó modellekhez
+- **Strukturált kimenet** — `json_schema` → Gemini's `responseMimeType`/`responseSchema`
+
+### 👥 Többfiókos támogatás
+
+- Több fiók hozzáadása szolgáltatónként
+- Automatikus körbefutó vagy prioritás alapú útvonalválasztás
+- Visszatérés a következő fiókhoz, ha valamelyik eléri a kvótát
+
+### 🔄 Token automatikus frissítése
+
+- Az OAuth-tokenek a lejárat előtt automatikusan frissülnek
+- Nincs szükség manuális újrahitelesítésre
+- Zökkenőmentes tapasztalat az összes szolgáltatónál
+
+### 🎨 Egyéni kombók
+
+- Korlátlan számú modellkombináció létrehozása
+- 6 stratégia: töltsd ki először, körbefutó, kettős választási lehetőség, véletlenszerű, legkevésbé használt, költségoptimalizált
+- Oszd meg a kombinációkat az eszközök között a Cloud Sync segítségével
+
+### 🏥 Egészségügyi irányítópult
+
+- Rendszerállapot (üzemidő, verzió, memóriahasználat)
+- A megszakítók állapotai szolgáltatónként (zárt/nyitott/félig nyitva)
+- Díjkorlát állapot és aktív zárolások
+- Az aláírás gyorsítótár statisztikái
+- Késési telemetria (p50/p95/p99) + gyorsítótár
+- Állítsa vissza az egészségi állapotot egyetlen kattintással
+
+### 🔧 Fordítói Játszótér
+
+Az OmniRoute egy erőteljes beépített fordítói játszóteret tartalmaz **4 móddal** az API-fordítások hibakereséséhez, teszteléséhez és figyeléséhez:
+
+| mód                | Leírás                                                                                                                                                                                                                                                                  |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻 Játszótér**   | Közvetlen formátumfordítás – illessze be az API kérés törzsét, és azonnal megtudhatja, hogyan fordítja le az OmniRoute azt a szolgáltatói formátumok között (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Példa sablonokat és formátum automatikus felismerést tartalmaz. |
+| **💬 Chat Tester** | Küldjön valódi csevegési kérelmeket az OmniRoute-on keresztül, és tekintse meg a teljes körutazást: a bemenetet, a lefordított kérést, a szolgáltatói választ és a visszafordított választ. Felbecsülhetetlen a kombinált útválasztás érvényesítéséhez.                 |
+| **🧪 Tesztpad**    | Kötegelt tesztelési mód — határozzon meg több tesztesetet különböző bemenetekkel és várható kimenetekkel, futtassa le egyszerre, és hasonlítsa össze a szolgáltatók és modellek eredményeit.                                                                            |
+| **📱 Élő monitor** | Valós idejű kérések figyelése – figyelje a bejövő kéréseket, ahogy azok az OmniRoute-on keresztül áramlanak, nézze meg a formátumfordításokat élőben, és azonnal azonosítsa a problémákat.                                                                              |
+
+**Hozzáférés:** Irányítópult → Fordító (oldalsáv)
+
+### 💾 Cloud Sync
+
+- Szinkronizálja a szolgáltatókat, kombinációkat és beállításokat az eszközök között
+- Automatikus háttérszinkronizálás
+- Biztonságos titkosított tárhely
+
+</details>
+
+---
+
+## 📖 Beállítási útmutató
+
+<details>
+<summary><b>💳 Előfizetési szolgáltatók</b></summary>
+
+### Claude Code (Pro/Max)
+
+```bash
+Dashboard → Providers → Connect Claude Code
+→ OAuth login → Auto token refresh
+→ 5-hour + weekly quota tracking
+
+Models:
+  cc/claude-opus-4-6
+  cc/claude-sonnet-4-5-20250929
+  cc/claude-haiku-4-5-20251001
+```
+
+**Profi tipp:** Használja az Opust összetett feladatokhoz, a Sonnet pedig a sebességhez. Az OmniRoute nyomkövetési kvóta modellenként!
+
+### OpenAI Codex (Plus/Pro)
+
+```bash
+Dashboard → Providers → Connect Codex
+→ OAuth login (port 1455)
+→ 5-hour + weekly reset
+
+Models:
+  cx/gpt-5.2-codex
+  cx/gpt-5.1-codex-max
+```
+
+### Gemini CLI (INGYENES 180 000/hó!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+  gc/gemini-3-flash-preview
+  gc/gemini-2.5-pro
+```
+
+**Legjobb érték:** Hatalmas ingyenes szint! Használja ezt a fizetett szintek előtt.
+
+### GitHub másodpilóta
+
+```bash
+Dashboard → Providers → Connect GitHub
+→ OAuth via GitHub
+→ Monthly reset (1st of month)
+
+Models:
+  gh/gpt-5
+  gh/claude-4.5-sonnet
+  gh/gemini-3-pro
+```
+
+</details>
+
+<details>
+<summary><b>🔑 API kulcs szolgáltatók</b></summary>
+
+### NVIDIA NIM (INGYENES 1000 kredit!)
+
+1. Regisztráljon: [build.nvidia.com](https://build.nvidia.com)
+2. Ingyenes API-kulcs beszerzése (1000 következtetési kredit)
+3. Irányítópult → Szolgáltató hozzáadása → NVIDIA NIM:
+   - API-kulcs: `nvapi-your-key`
+
+**Modellek:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` és több mint 50
+
+**Profi tipp:** OpenAI-kompatibilis API – zökkenőmentesen működik az OmniRoute formátumfordításával!
+
+### DeepSeek
+
+1. Regisztráljon: [platform.deepseek.com](https://platform.deepseek.com)
+2. Szerezze be az API-kulcsot
+3. Irányítópult → Szolgáltató hozzáadása → DeepSeek
+
+**Modellek:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (ingyenes szint elérhető!)
+
+1. Regisztráljon: [console.groq.com](https://console.groq.com)
+2. API-kulcs beszerzése (ingyenes szint tartalmazza)
+3. Irányítópult → Szolgáltató hozzáadása → Groq
+
+**Modellek:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Profi tipp:** Ultragyors következtetés – a legjobb valós idejű kódoláshoz!
+
+### OpenRouter (100+ modell)
+
+1. Regisztráljon: [openrouter.ai](https://openrouter.ai)
+2. Szerezze be az API-kulcsot
+3. Irányítópult → Szolgáltató hozzáadása → OpenRouter
+
+**Modellek:** Hozzáférés több mint 100 modellhez az összes főbb szolgáltatótól egyetlen API-kulccsal.
+
+</details>
+
+<details>
+<summary><b>💰 Olcsó szolgáltatók (tartalék)</b></summary>
+
+### GLM-4.7 (napi visszaállítás, 0,6 USD/1 millió)
+
+1. Regisztráljon: [Zhipu AI](https://open.bigmodel.cn/)
+2. Szerezze be az API-kulcsot a Coding Plan-ból
+3. Irányítópult → API-kulcs hozzáadása:
+   - Szolgáltató: `glm`
+   - API-kulcs: `your-key`
+
+**Használd:** `glm/glm-4.7`
+
+**Profi tipp:** A kódolási terv 3-szoros kvótát kínál 1/7 költséggel! Visszaállítás naponta 10:00.
+
+### MiniMax M2.1 (5 óra visszaállítás, 0,20 USD/1 millió)
+
+1. Regisztráljon: [MiniMax](https://www.minimax.io/)
+2. Szerezze be az API-kulcsot
+3. Irányítópult → API-kulcs hozzáadása
+
+**Használd:** `minimax/MiniMax-M2.1`
+
+**Profi tipp:** A legolcsóbb lehetőség hosszú kontextushoz (1 millió token)!
+
+### Kimi K2 (9 USD/hó lakás)
+
+1. Feliratkozás: [Moonshot AI](https://platform.moonshot.ai/)
+2. Szerezze be az API-kulcsot
+3. Irányítópult → API-kulcs hozzáadása
+
+**Használat:** `kimi/kimi-latest`
+
+**Profi tipp:** Fix 9 USD/hó 10 millió token esetén = 0,90 USD/1 millió tényleges költség!
+
+</details>
+
+<details>
+<summary><b>🆓 INGYENES szolgáltatók (vészhelyzeti biztonsági mentés)</b></summary>
+
+### iFlow (8 INGYENES modell)
+
+```bash
+Dashboard → Connect iFlow
+→ iFlow OAuth login
+→ Unlimited usage
+
+Models:
+  if/kimi-k2-thinking
+  if/qwen3-coder-plus
+  if/glm-4.7
+  if/minimax-m2
+  if/deepseek-r1
+```
+
+### Qwen (3 INGYENES modell)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+  qw/qwen3-coder-plus
+  qw/qwen3-coder-flash
+```
+
+### Kiro (Claude INGYENES)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+  kr/claude-sonnet-4.5
+  kr/claude-haiku-4.5
+```
+
+</details>
+
+<details>
+<summary><b>🎨 Kombók létrehozása</b></summary>
+
+### 1. példa: Előfizetés maximalizálása → Olcsó biztonsági mentés
+
+```
+Dashboard → Combos → Create New
+
+Name: premium-coding
+Models:
+  1. cc/claude-opus-4-6 (Subscription primary)
+  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
+  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)
+
+Use in CLI: premium-coding
+```
+
+### 2. példa: Csak ingyenes (nulla költség)
+
+```
+Name: free-combo
+Models:
+  1. gc/gemini-3-flash-preview (180K free/month)
+  2. if/kimi-k2-thinking (unlimited)
+  3. qw/qwen3-coder-plus (unlimited)
+
+Cost: $0 forever!
+```
+
+</details>
+
+<details>
+<summary><b>🔧 CLI-integráció</b></summary>
+
+### Kurzor IDE
+
+```
+Settings → Models → Advanced:
+  OpenAI API Base URL: http://localhost:20128/v1
+  OpenAI API Key: [from OmniRoute dashboard]
+  Model: cc/claude-opus-4-6
+```
+
+### Claude Code
+
+Használja az irányítópult **CLI Tools** oldalát az egykattintásos konfiguráláshoz, vagy szerkessze manuálisan a `~/.claude/settings.json` fájlt.
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**1. lehetőség – Irányítópult (ajánlott):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**2. lehetőség – Kézi:** Szerkesztés `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "models": {
+    "providers": {
+      "omniroute": {
+        "baseUrl": "http://127.0.0.1:20128/v1",
+        "apiKey": "sk_omniroute",
+        "api": "openai-completions"
+      }
+    }
+  }
+}
+```
+
+> **Megjegyzés:** Az OpenClaw csak a helyi OmniRoute-tal működik. Használja az `127.0.0.1` `localhost` helyett az IPv6-feloldási problémák elkerülése érdekében.
+
+### Cline / Folytatás / RooCode
+
+```
+Settings → API Configuration:
+  Provider: OpenAI Compatible
+  Base URL: http://localhost:20128/v1
+  API Key: [from OmniRoute dashboard]
+  Model: if/kimi-k2-thinking
+```
+
+</details>
+
+---
+
+## 📊 Elérhető modellek
+
+<details>
+<summary><b>Az összes elérhető modell megtekintése</b></summary>
+
+**Claude Code (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Kód (`cx/`)** - Plusz/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** – INGYENES:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**GitHub másodpilóta (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - INGYENES kreditek:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ további modell itt: [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - 0,6 USD/1 millió:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - 0,2 USD/1 millió:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** – INGYENES:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - INGYENES:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** – INGYENES:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ modell:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Bármelyik modell a [openrouter.ai/models](https://openrouter.ai/models) terméktől
+
+</details>
+
+---
+
+## 🧪 Értékelések (Evals)
+
+Az OmniRoute egy beépített értékelési keretrendszert tartalmaz az LLM-válasz minőségének tesztelésére egy aranykészlettel összehasonlítva. Az irányítópult **Analytics → Evals** menüpontjában érheti el.
+
+### Beépített arany készlet
+
+Az előre feltöltött "OmniRoute Golden Set" 10 tesztesetet tartalmaz, amelyek lefedik:
+
+- Üdvözlet, matematika, földrajz, kódgenerálás
+- JSON formátum megfelelés, fordítás, leértékelés
+- Biztonsági elutasítás (káros tartalom), számlálás, logikai logika
+
+### Értékelési stratégiák
+
+| Stratégia  | Leírás                                                                                            | Példa                            |
+| ---------- | ------------------------------------------------------------------------------------------------- | -------------------------------- |
+| `exact`    | A kimenetnek pontosan meg kell egyeznie                                                           | `"4"`                            |
+| `contains` | A kimenetnek tartalmaznia kell részkarakterláncot (a kis- és nagybetűk nem különböznek egymástól) | `"Paris"`                        |
+| `regex`    | A kimenetnek meg kell egyeznie a regex mintával                                                   | `"1.*2.*3"`                      |
+| `custom`   | Az egyéni JS függvény igaz/hamis                                                                  | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em Servidor Remoto (távoli OAuth beállítás)
+
+<a name="oauth-em-servidor-remoto"></a>
+
+> **⚠️ FONTOS az OmniRoute em VPS/Docker/servidor Remoto használatához**
+
+### Az OAuth do Antigravity / Gemini CLI falha em servidores remotos?
+
+Az **Antigravitáció** és a **Gemini CLI** usam **Google OAuth 2.0** hitelesítése. A Google exige que a `redirect_uri` nincs fluxo OAuth seja **exatamente** uma das URI-k pre-cadastradas no Google Cloud Console do aplicativo.
+
+As credenciais OAuth embutidas no OmniRoute estão cadastradas **apenas para `localhost`**. Quando você acessa o OmniRoute em um servidor Remoto (pl.: `https://omniroute.meuservidor.com`), o Google rejeita a autenticação com:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### Megoldás: A suas próprias credenciais OAuth konfigurálása
+
+Você precisa criar um **OAuth 2.0 ügyfél-azonosító** nincs Google Cloud Console com egy URI do seu servidor.
+
+#### Passo a passo
+
+**1. Acesse o Google Cloud Console**
+
+Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
+
+**2. Crie um novo OAuth 2.0 ügyfél-azonosító**
+
+- Kattintson a gombra **"+ Hitelesítési adatok létrehozása"** → **"OAuth-kliens-azonosító"**
+- Tipo de Aplicativo: **"Web alkalmazás"**
+- Név: escolha qualquer nome (pl.: `OmniRoute Remote`)
+
+**3. Adicione mint engedélyezett átirányítási URI**
+
+No campo **"Engedélyezett átirányítási URI-k"**, kiegészítés:
+
+```
+https://seu-servidor.com/callback
+```
+
+> Helyettesítő `seu-servidor.com` pelo domínio vagy IP do seu servidor (beleértve a porta se necessário-t is, pl.: `http://45.33.32.156:20128/callback`).
+
+**4. Másolat mentése hitelesítésként**
+
+Após criar, o Google mostrará o **Client ID** e o **Client Secret**.
+
+**5. Konfigurálás variáveis de ambienteként**
+
+No seu `.env` (ou nas variáveis de ambiente do Docker):
+
+```bash
+# Para Antigravity:
+ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
+ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
+
+# Para Gemini CLI:
+GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
+GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
+GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
+```
+
+**6. Reinicie o OmniRoute**
+
+```bash
+# Se usando npm:
+npm run dev
+
+# Se usando Docker:
+docker restart omniroute
+```
+
+**7. Tente conectar novamente**
+
+Irányítópult → Szolgáltatók → Antigravity (vagy Gemini CLI) → OAuth
+
+Agora o Google redirecionará corretamente para `https://seu-servidor.com/callback` e a autenticação funcionará.
+
+---
+
+### Kerülő megoldás temporário (sem configurar credenciais próprias)
+
+Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo **manual de URL**:
+
+1. OmniRoute abrirá a Google autorização URL-jét
+2. Após você autorizar, o Google tentará redirecionar para `localhost` (que falha no servidor remoto)
+3. ** Teljes URL másolása** da barra de endereço do seu browser (mesmo que a página não carregue)
+4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
+5. Kattintson a **"Connect"** gombra
+
+> Este workaround funciona porque o código de autorização na URL é válido independente do redirect ter carregado ou não.
+
+---
+
+## 🐛 Hibaelhárítás
+
+<details>
+<summary><b>Kattintson a hibaelhárítási útmutató kibontásához</b></summary>
+
+**"A nyelvi modell nem adott üzenetet"**
+
+- A szolgáltatói kvóta kimerült → Ellenőrizze az irányítópult kvótakövetőjét
+- Megoldás: Használjon kombinált tartalékot, vagy váltson olcsóbb szintre
+
+**Drátakorlát**
+
+- Előfizetési kvóta lejárt → Tartalék a GLM/MiniMax-hoz
+- Kombinó hozzáadása: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**OAuth token lejárt**
+
+- Az OmniRoute automatikusan frissíti
+- Ha a problémák továbbra is fennállnak: Irányítópult → Szolgáltató → Újracsatlakozás
+
+**Magas költségek**
+
+- Ellenőrizze a használati statisztikákat az Irányítópult → Költségek menüpontban
+- Állítsa át az elsődleges modellt GLM/MiniMax-ra
+- Használjon ingyenes réteget (Gemini CLI, iFlow) a nem kritikus feladatokhoz
+
+**A műszerfal rossz porton nyílik meg**
+
+- `PORT=20128` és `NEXT_PUBLIC_BASE_URL=http://localhost:20128` beállítása
+
+**Felhő szinkronizálási hibák**
+
+- Ellenőrizze, hogy `BASE_URL` mutat a futó példányra
+- Ellenőrizzen `CLOUD_URL` pontot a várható felhő-végponthoz
+- Tartsa az `NEXT_PUBLIC_*` értékeket a szerveroldali értékekkel összhangban
+
+**Az első bejelentkezés nem működik**
+
+- Ellenőrizze a `INITIAL_PASSWORD`-t itt: `.env`
+- Ha nincs beállítva, a tartalék jelszó: `123456`
+
+**Nincs kérésnapló**
+
+- Állítsa be `ENABLE_REQUEST_LOGS=true` a `.env`-ban
+
+**A csatlakozási teszt „Érvénytelen” üzenetet mutat az OpenAI-kompatibilis szolgáltatók esetében**
+
+- Sok szolgáltató nem tesz közzé `/models` végpontot
+- Az OmniRoute v1.0.6+ tartalmazza a tartalék érvényesítést a csevegés befejezésén keresztül
+- Győződjön meg arról, hogy az alap URL tartalmazza a `/v1` utótagot
+
+</details>
+
+---
+
+## 🛠️ Tech Stack
+
+- **Futtatási idejű**: Node.js 18–22 LTS (⚠️ A Node.js 24+ **nem támogatott** - A `better-sqlite3` natív binárisok nem kompatibilisek)
+- **Nyelv**: TypeScript 5.9 – **100% TypeScript** `src/` és `open-sse/` (v1.0.6) között
+- **Keretrendszer**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Adatbázis**: LowDB (JSON) + SQLite (tartomány állapota + proxynaplók)
+- **Streaming**: Szerver által küldött események (SSE)
+- **Auth**: OAuth 2.0 (PKCE) + JWT + API kulcsok
+- **Tesztelés**: Node.js tesztfutó (368+ egységteszt)
+- **CI/CD**: GitHub Actions (automatikus npm közzététel + Docker Hub kiadáskor)
+- **Webhely**: [omniroute.online](https://omniroute.online)
+- **Csomag**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Dokker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Rugalmasság**: megszakító, exponenciális visszakapcsolás, mennydörgés elleni csorda, TLS-hamisítás
+
+---
+
+## 📖 Dokumentáció
+
+| dokumentum                                   | Leírás                                             |
+| -------------------------------------------- | -------------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md)             | Szolgáltatók, kombók, CLI-integráció, telepítés    |
+| [API Reference](docs/API_REFERENCE.md)       | Minden végpont példákkal                           |
+| [Troubleshooting](docs/TROUBLESHOOTING.md)   | Gyakori problémák és megoldások                    |
+| [Architecture](docs/ARCHITECTURE.md)         | Rendszerarchitektúra és belső elemek               |
+| [Contributing](CONTRIBUTING.md)              | Fejlesztési beállítások és irányelvek              |
+| [OpenAPI Spec](docs/openapi.yaml)            | OpenAPI 3.0 specifikáció                           |
+| [Security Policy](SECURITY.md)               | Sebezhetőségi jelentések és biztonsági gyakorlatok |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Teljes útmutató: VM + nginx + Cloudflare beállítás |
+| [Features Gallery](docs/FEATURES.md)         | Vizuális irányítópult bemutató képernyőképekkel    |
+
+### 📸 Irányítópult előnézete
+
+<details>
+<summary><b>Kattintson az irányítópult képernyőképeinek megtekintéséhez</b></summary>
+
+| Oldal                 | Képernyőkép                                       |
+| --------------------- | ------------------------------------------------- |
+| **Szolgáltatók**      | ![Providers](docs/screenshots/01-providers.png)   |
+| **Combos**            | ![Combos](docs/screenshots/02-combos.png)         |
+| **Analytics**         | ![Analytics](docs/screenshots/03-analytics.png)   |
+| **Egészség**          | ![Health](docs/screenshots/04-health.png)         |
+| **Fordító**           | ![Translator](docs/screenshots/05-translator.png) |
+| **Beállítások**       | ![Settings](docs/screenshots/06-settings.png)     |
+| **CLI eszközök**      | ![CLI Tools](docs/screenshots/07-cli-tools.png)   |
+| **Használati naplók** | ![Usage](docs/screenshots/08-usage.png)           |
+| **Végpont**           | ![Endpoint](docs/screenshots/09-endpoint.png)     |
+
+</details>
+
+---
+
+## 🗺️ Útiterv
+
+Az OmniRoute **210+ funkciót tervez** több fejlesztési fázisban. Íme a legfontosabb területek:
+
+| Kategória                           | Tervezett funkciók | Kiemelések                                                                                             |
+| ----------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------ |
+| 🧠 **Útválasztás és intelligencia** | 25+                | Legkisebb késleltetésű útválasztás, címke alapú útválasztás, kvóta elővizsgálat, P2C-fiók kiválasztása |
+| 🔒 **Biztonság és megfelelőség**    | 20+                | SSRF keményítés, hitelesítő adatok álcázása, végpontonkénti sebességkorlát, felügyeleti kulcs hatóköre |
+| 📊 **Megfigyelhetőség**             | 15+                | OpenTelemetry integráció, valós idejű kvótafigyelés, modellenkénti költségkövetés                      |
+| 🔄 ** Szolgáltatói integrációk**    | 20+                | Dinamikus modellnyilvántartás, szolgáltatói leállások, többfiókos Codex, másodpilóta kvótaelemzés      |
+| ⚡ **Teljesítmény**                 | 15+                | Kettős gyorsítótárréteg, gyorsítótár, válaszgyorsítótár, folyamatos adatfolyam, kötegelt API           |
+| 🌐 **Ökoszisztéma**                 | 10+                | WebSocket API, config hot-reload, elosztott konfigurációs tároló, kereskedelmi mód                     |
+
+### 🔜 Hamarosan
+
+- 🔗 **OpenCode integráció** - Natív szolgáltatói támogatás az OpenCode AI kódoló IDE-hez
+- 🔗 **TRAE integráció** — A TRAE AI fejlesztési keret teljes támogatása
+- 📦 **Batch API** - Aszinkron kötegelt feldolgozás tömeges kérésekhez
+- 🎯 **Címke alapú útválasztás** - Egyéni címkéken és metaadatokon alapuló útvonalkérések
+- 💰 **Legalacsonyabb költségű stratégia** - Automatikusan válassza ki a legolcsóbb elérhető szolgáltatót
+
+> 📝 A teljes funkció specifikációi a [link](docs/new-features/) címen érhetők el (217 részletes specifikáció)
+
+---
+
+## 📧 Támogatás
+
+> 💬 **Csatlakozzon közösségünkhöz!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Kérjen segítséget, ossza meg tippjeit, és naprakész legyen.
+
+- **Webhely**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Problémák**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **Eredeti projekt**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Közreműködők
+
+[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=100&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Hogyan járuljunk hozzá
+
+1. Fork a tároló
+2. Hozza létre saját jellemző ágát (`git checkout -b feature/amazing-feature`)
+3. Végezze el módosításait (`git commit -m 'Add amazing feature'`)
+4. Nyomja az ágra (`git push origin feature/amazing-feature`)
+5. Nyisson meg egy lehívási kérelmet
+
+A részletes útmutatásért lásd: [CONTRIBUTING.md](CONTRIBUTING.md).
+
+### Új verzió kiadása
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 Csillagtörténet
+
+<a href="https://star-history.com/#diegosouzapw/OmniRoute&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=diegosouzapw/OmniRoute&type=Date" />
+ </picture>
+</a>
+
+---
+
+## 🙏 Köszönetnyilvánítás
+
+Külön köszönet **[9router](https://github.com/decolua/9router)**, **[decolua](https://github.com/decolua)** – az eredeti projekt, amely ezt a villát inspirálta. Az OmniRoute erre a hihetetlen alapra épít további funkciókkal, multimodális API-kkal és teljes TypeScript-újraírással.
+
+Külön köszönet **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** – az eredeti Go implementációnak, amely ihlette ezt a JavaScript-portot.
+
+---
+
+## 📄 Licenc
+
+MIT-licenc – a részletekért lásd: [LICENSE](LICENSE).
+
+---
+
+---
+
+## 🇧🇷 OmniRoute — IA ingyenes átjáró
+
+<a name="-omniroute--gateway-de-ia-gratuito"></a>
+
+### Nunca pare de codar. Roteamento inteligente para **modelos de IA GRATUITOS e de baixo custo** com backback automatico.
+
+_Seu proxy univerzális API – um végpont, 36+ gyártó, nulla leállás._
+
+### 🌐 Internacionalização (i18n)
+
+O dashboard do OmniRoute támogatja a **múltiplos idiomas**. Atualmente disponível em:
+
+| Idioma                | Código  | Állapot     |
+| --------------------- | ------- | ----------- |
+| 🇺🇸 angol              | `en`    | ✅ Completo |
+| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Completo |
+
+**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 EN) no header do dashboard → Selectione o idioma desejado.
+
+**Para adicionar um novo idioma:**
+
+1. Sírj `src/i18n/messages/{codigo}.json` baseado em `en.json`
+2. Adicione o código em `src/i18n/config.ts` → `LOCALES` e `LANGUAGES`
+3. Reinicie o servidor
+
+### ⚡ Início Rápido
+
+```bash
+# Instalar via npm
+npx omniroute@latest
+
+# Ou rodar do código-fonte
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+### 🐳 Docker
+
+```bash
+docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
+```
+
+### 🔑 Funcionalidades Principais
+
+- **36+ IA produkátor** – Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
+- **Roteamento inteligente** — Fallback automatico entre provedores
+- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automatamente
+- **Multi-conta** — Múltiplas contas por provedor com seleção inteligente
+- **Cache szemântico** – Reduz custos e latência
+- **OAuth automatico** — Tokens renovam automaticamente
+- **Combos personalizados** - 6 estratégias de roteamento
+- **Befejezett irányítópult** - Monitoring, naplók, elemzések, konfigurációk
+- **CLI eszközök** — Claude Code, Codex, Cursor, Cline com um clique konfigurálása
+- **100% TypeScript** – Código limpo e tipado
+
+### 📖 Documentação
+
+| Documento                                       | Leírás                                 |
+| ----------------------------------------------- | -------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md)           | Provedores, kombók, CLI, telepítés     |
+| [Referência da API](docs/API_REFERENCE.md)      | Todos os végpontok com exemplos        |
+| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problemas comuns e soluções            |
+| [Arquitetura](docs/ARCHITECTURE.md)             | Arquitetura e internos do sistema      |
+| [Contribuição](CONTRIBUTING.md)                 | Setup de desenvolvimento e Guidelines  |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md)     | Teljes verzió: VM + nginx + Cloudflare |
+
+### 📧 Támogatás
+
+> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
+
+- **Webhely**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Problémák**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+<div align="center">
+  <sub>A ❤️ segítségével készült a 24/7 kódoló fejlesztőknek</sub>
+  <br/>
+  <sub><a href="https://omniroute.online">omniroute.online</a></sub>
+</div>