diff --git a/README.ar.md b/README.ar.md
new file mode 100644
index 0000000000..55c195f7b0
--- /dev/null
+++ b/README.ar.md
@@ -0,0 +1,1153 @@
+
+
+
+ # 🚀 OmniRoute — بوابة الذكاء الاصطناعي المجانية
+
+### لا تتوقف أبدًا عن البرمجة. التوجيه الذكي إلى **نماذج الذكاء الاصطناعي المجانية ومنخفضة التكلفة** مع الرجوع التلقائي.
+
+_وكيل واجهة برمجة التطبيقات العالمي الخاص بك — نقطة نهاية واحدة، وأكثر من 36 موفرًا، بدون أي توقف عن العمل._
+
+**إكمالات الدردشة • التضمينات • إنشاء الصور • الصوت • إعادة الترتيب • 100% TypeScript**
+
+---
+
+### 🤖 موفر الذكاء الاصطناعي المجاني لوكلاء البرمجة المفضلين لديك
+
+_قم بتوصيل أي أداة IDE أو CLI مدعومة بالذكاء الاصطناعي من خلال OmniRoute - بوابة واجهة برمجة التطبيقات المجانية للترميز غير المحدود._
+
+
+
+---
+
+## 🤔 لماذا OmniRoute؟
+
+**توقف عن إهدار المال وضرب الحدود:**
+
+- تنتهي صلاحية حصة الاشتراك غير المستخدمة كل شهر
+- حدود الأسعار تمنعك من الترميز المتوسط
+- واجهات برمجة التطبيقات باهظة الثمن (20-50 دولارًا شهريًا لكل مزود)
+- التبديل اليدوي بين مقدمي الخدمة
+
+** OmniRoute يحل هذا: **
+
+- ✅ **تعظيم الاشتراكات** - تتبع الحصة، استخدم كل جزء منها قبل إعادة التعيين
+- ✅ **الرجوع التلقائي** - الاشتراك → مفتاح واجهة برمجة التطبيقات → رخيص → مجاني، بدون توقف
+- ✅ **حسابات متعددة** - جولة روبن بين الحسابات لكل مزود
+- ✅ **عالمي** - يعمل مع Claude Code وCodex وGemini CLI وCursor وCline وOpenClaw وأي أداة CLI
+
+---
+
+## 🔄 كيف يعمل
+
+```
+┌─────────────┐
+│ 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
+```
+
+---
+
+## ⚡ بداية سريعة
+
+**1. التثبيت عالميًا:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 تفتح لوحة التحكم في `http://localhost:20128`
+
+| الأمر | الوصف |
+| ----------------------- | ----------------------------------------- |
+| `omniroute` | بدء تشغيل الخادم (المنفذ الافتراضي 20128) |
+| `omniroute --port 3000` | استخدم المنفذ المخصص |
+| `omniroute --no-open` | لا تفتح المتصفح تلقائيًا |
+| `omniroute --help` | عرض المساعدة |
+
+**2. الاتصال بمزود مجاني: **
+
+لوحة التحكم → الموفرون → الاتصال **Claude Code** أو **Antigravity** → تسجيل الدخول OAuth → تم!
+
+**3. استخدم في أداة CLI الخاصة بك:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copy from dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**هذا كل شيء!** ابدأ البرمجة باستخدام نماذج الذكاء الاصطناعي المجانية.
+
+** البديل - تشغيل من المصدر: **
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 عامل الميناء
+
+OmniRoute متاح كصورة Docker عامة على [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**الجري السريع:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+** مع ملف البيئة: **
+
+```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
+```
+
+**استخدام Docker Compose:**
+
+```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
+```
+
+| صورة | العلامة | الحجم | الوصف |
+| ------------------------ | -------- | ------------- | ---------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250 ميجابايت | أحدث إصدار مستقر |
+| `diegosouzapw/omniroute` | `1.0.3` | ~250 ميجابايت | النسخة الحالية |
+
+---
+
+## 💰 لمحة سريعة عن الأسعار
+
+| الطبقة | مقدم | التكلفة | إعادة ضبط الحصص | الأفضل لـ |
+| ---------------------------------- | ---------------------------- | ---------------------- | ----------------------- | ------------------------- |
+| **💳الإشتراك** | كلود كود (برو) | 20 دولارًا شهريًا | 5 ساعات + أسبوعي | اشتركت بالفعل |
+| | الدستور الغذائي (زائد / برو) | 20-200 دولار شهريًا | 5 ساعات + أسبوعي | مستخدمي OpenAI |
+| | الجوزاء CLI | **مجاني** | 180 ألف/شهر + 1 ألف/يوم | الجميع! |
+| | جيثب مساعد الطيار | 10-19 دولارًا شهريًا | شهري | مستخدمي جيثب |
+| **🔑 مفتاح واجهة برمجة التطبيقات** | نفيديا نيم | **مجانًا** (1000 نقطة) | لمرة واحدة | اختبار المستوى المجاني |
+| | ديب سيك | الدفع لكل استخدام | لا شيء | أفضل سعر/جودة |
+| | جروك | طبقة مجانية + مدفوعة | معدل محدود | الاستدلال فائق السرعة |
+| | xAI (جروك) | الدفع لكل استخدام | لا شيء | نماذج جروك |
+| | ميسترال | طبقة مجانية + مدفوعة | معدل محدود | الذكاء الاصطناعي الأوروبي |
+| | اوبن راوتر | الدفع لكل استخدام | لا شيء | أكثر من 100 موديل |
+| **💰 رخيص** | جي إل إم-4.7 | 0.6 دولار/1 مليون | يوميا 10 صباحا | نسخة احتياطية للميزانية |
+| | ميني ماكس M2.1 | 0.2 دولار/1 مليون | المتداول لمدة 5 ساعات | الخيار الأرخص |
+| | كيمي ك2 | 9 دولارات شهريًا مسطحة | 10 مليون رمز/شهر | التكلفة المتوقعة |
+| **🆓مجانًا** | اي فلو | $0 | غير محدود | 8 نماذج مجانية |
+| | كوين | $0 | غير محدود | 3 نماذج مجانية |
+| | كيرو | $0 | غير محدود | كلود مجاني |
+
+**💡 نصيحة احترافية:** ابدأ مع مجموعة Gemini CLI (180 ألفًا مجانًا شهريًا) + مجموعة iFlow (مجانية غير محدودة) = تكلفة 0 دولار!
+
+---
+
+## 🎯 حالات الاستخدام
+
+### الحالة 1: "لدي اشتراك Claude Pro"
+
+**المشكلة:** تنتهي صلاحية الحصة غير المستخدمة، وحدود المعدل أثناء عملية الترميز المكثف
+
+```
+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: "أريد تكلفة صفرية"
+
+**المشكلة:** لا أستطيع تحمل تكلفة الاشتراكات، وتحتاج إلى ترميز يعتمد على الذكاء الاصطناعي
+
+```
+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: "أحتاج إلى تشفير على مدار 24 ساعة طوال أيام الأسبوع، دون انقطاع"
+
+**المشكلة:** المواعيد النهائية، لا أستطيع تحمل فترات التوقف عن العمل
+
+```
+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: "أريد ذكاءً اصطناعيًا مجانيًا في OpenClaw"
+
+**المشكلة:** تحتاج إلى مساعد الذكاء الاصطناعي في تطبيقات المراسلة، مجانًا تمامًا
+
+```
+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...
+```
+
+---
+
+## 💡 الميزات الرئيسية
+
+### 🧠 التوجيه الأساسي والذكاء
+
+| ميزة | ماذا يفعل |
+| --------------------------------- | ---------------------------------------------------------------------------------------------- |
+| 🎯 **احتياطي ذكي من 4 طبقات** | المسار التلقائي: الاشتراك → مفتاح API → رخيص → مجاني |
+| 📊 **تتبع الحصص في الوقت الفعلي** | عدد الرموز الحية + إعادة تعيين العد التنازلي لكل مزود |
+| 🔄 **تنسيق الترجمة** | OpenAI ↔ كلود ↔ الجوزاء ↔ المؤشر ↔ كيرو سلس + تعقيم الاستجابة |
+| 👥 **دعم الحسابات المتعددة** | حسابات متعددة لكل مزود مع اختيار ذكي |
+| 🔄 **تحديث تلقائي للرمز** | يتم تحديث رموز OAuth المميزة تلقائيًا من خلال إعادة المحاولة |
+| 🎨 **مجموعات مخصصة** | 6 إستراتيجيات: التعبئة أولاً، الجولة روبن، P2C، عشوائي، الأقل استخدامًا، الأمثل من حيث التكلفة |
+| 🧩 **نماذج مخصصة** | أضف أي معرف نموذج إلى أي مزود |
+| 🌐 **جهاز توجيه Wildcard** | قم بتوجيه أنماط `provider/*` إلى أي مزود ديناميكيًا |
+| 🧠 **ميزانية التفكير** | أوضاع العبور والتلقائي والمخصص والتكيفي لنماذج الاستدلال |
+| 💬 **الحقن الفوري للنظام** | يتم تطبيق موجه النظام العالمي على كافة الطلبات |
+| 📄 **Responses API** | دعم واجهة برمجة تطبيقات استجابات OpenAI الكاملة (`/v1/responses`) لـ Codex |
+
+### 🎵 واجهات برمجة التطبيقات متعددة الوسائط
+
+| ميزة | ماذا يفعل |
+| -------------------------- | --------------------------------------------------------- |
+| 🖼️ **إنشاء الصور** | `/v1/images/generations` — 4 مقدمي خدمات، أكثر من 9 نماذج |
+| 📐 **المضامين** | `/v1/embeddings` — 6 مقدمي خدمات، أكثر من 9 نماذج |
+| 🎤 **نسخ صوتي** | `/v1/audio/transcriptions` — متوافق مع الهمس |
+| 🔊 **تحويل النص إلى كلام** | `/v1/audio/speech` — تركيب صوتي متعدد الموفرين |
+| 🛡️ **اعتدالات** | `/v1/moderations` — فحوصات سلامة المحتوى |
+| 🔀 **إعادة الترتيب** | `/v1/rerank` — إعادة ترتيب مدى صلة الوثيقة |
+
+### 🛡️ المرونة والأمان
+
+| ميزة | ماذا يفعل |
+| --------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| 🔌 **قاطع الدائرة** | فتح/إغلاق تلقائي لكل مزود مع حدود قابلة للتكوين |
+| 🛡️ **القطيع المضاد للرعد** | الحد الأقصى لمعدل Mutex + الإشارة لموفري مفاتيح API |
+| 🧠 **ذاكرة التخزين المؤقت الدلالية** | ذاكرة التخزين المؤقت ذات المستويين (التوقيع + الدلالي) تقلل التكلفة وزمن الوصول |
+| ⚡ **طلب العجز** | نافذة 5s dedup للطلبات المكررة |
+| 🔒 **انتحال بصمة الإصبع TLS** | تجاوز اكتشاف الروبوتات المستندة إلى TLS عبر wreq-js |
+| 🌐 **تصفية IP** | القائمة المسموح بها/القائمة المحظورة للتحكم في الوصول إلى واجهة برمجة التطبيقات |
+| 📊 **حدود المعدل القابلة للتحرير** | عدد الدورات في الدقيقة القابل للتكوين والفجوة الدنيا والحد الأقصى المتزامن على مستوى النظام |
+| 🛡 **حماية نقطة نهاية واجهة برمجة التطبيقات** | بوابة المصادقة + حظر الموفر لنقطة النهاية `/models` |
+| 🔒 **رؤية الوكيل** | شارات مرمزة بالألوان: 🟢 عالمية، 🟡 مزود، 🔵 لكل اتصال مع عرض IP |
+| 🌐 ** تكوين الوكيل ذو 3 مستويات ** | قم بتكوين الوكلاء على المستوى العالمي أو لكل مزود أو لكل اتصال |
+
+### 📊 إمكانية الملاحظة والتحليلات
+
+| ميزة | ماذا يفعل |
+| ------------------------------------ | -------------------------------------------------------------------------------------------- |
+| 📝 **تسجيل الطلبات** | وضع التصحيح مع سجلات الطلب/الاستجابة الكاملة |
+| 💾 **سجلات وكيل SQLite** | تستمر سجلات الوكيل المستمرة في إعادة تشغيل الخادم |
+| 📊 **لوحة التحكم التحليلية** | مدعوم من إعادة التخطيط: بطاقات إحصائيات، مخطط استخدام النموذج، جدول الموفر |
+| 📈 **تتبع التقدم** | الاشتراك في أحداث تقدم SSE للبث |
+| 🧪 **تقييمات ماجستير إدارة الأعمال** | اختبار المجموعة الذهبية مع 4 إستراتيجيات المباراة |
+| 🔍 **طلب القياس عن بعد** | تجميع زمن الوصول p50/p95/p99 + تتبع معرف طلب X |
+| 📋 **لوحة تحكم السجلات** | صفحة موحدة مكونة من 4 علامات تبويب: سجلات الطلب، وسجلات الوكيل، وسجلات التدقيق، ووحدة التحكم |
+| 🖥️ **عارض سجل وحدة التحكم** | عارض على النمط الطرفي في الوقت الفعلي مع مرشح المستوى والبحث والتمرير التلقائي |
+| 📑 ** التسجيل المعتمد على الملفات ** | يلتقط جهاز اعتراض وحدة التحكم جميع المخرجات إلى ملف سجل JSON بالتدوير |
+| 🏥 **لوحة المعلومات الصحية** | وقت تشغيل النظام، حالات قاطع الدائرة، عمليات الإغلاق، إحصائيات ذاكرة التخزين المؤقت |
+| 💰 **تتبع التكلفة** | إدارة الميزانية + تكوين التسعير لكل نموذج |
+
+### ☁️ النشر والمزامنة
+
+| ميزة | ماذا يفعل |
+| ----------------------------------------- | ----------------------------------------------------------------------------- |
+| 💾 **المزامنة السحابية** | مزامنة التكوين عبر الأجهزة عبر Cloudflare Workers |
+| 🌐 **النشر في أي مكان** | المضيف المحلي، VPS، Docker، عمال Cloudflare |
+| 🔑 **إدارة مفاتيح واجهة برمجة التطبيقات** | إنشاء مفاتيح واجهة برمجة التطبيقات وتدويرها ونطاقها لكل مزود |
+| 🧙 **معالج الإعداد** | إعداد إرشادي من 4 خطوات للمستخدمين لأول مرة |
+| 🔧 **لوحة تحكم أدوات CLI** | بنقرة واحدة قم بتكوين Claude، Codex، Cline، OpenClaw، Kilo، Antigravity |
+| 🔄 **النسخ الاحتياطية لقاعدة البيانات** | النسخ الاحتياطي التلقائي والاستعادة والتصدير والاستيراد لجميع الإعدادات |
+| 🌐 **التدويل** | i18n الكامل مع دعم next-intl — الإنجليزية + البرتغالية (البرازيل) |
+| 🌍 **محدد اللغة** | أيقونة الكرة الأرضية في رأس الصفحة للتبديل بين اللغات في الوقت الفعلي (🇺🇸/🇧🇷) |
+| 📂 **دليل البيانات المخصصة** | `DATA_DIR` env var لتجاوز مسار التخزين الافتراضي `~/.omniroute` |
+
+
+📖 تفاصيل الميزة
+
+### 🎯 نظام احتياطي ذكي مكون من 4 طبقات
+
+إنشاء مجموعات باستخدام خيار الرجوع التلقائي:
+
+```
+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
+```
+
+### 📊 تتبع الحصص في الوقت الحقيقي
+
+- استهلاك الرمز المميز لكل مزود
+- إعادة ضبط العد التنازلي (5 ساعات، يوميًا، أسبوعيًا)
+- تقدير التكلفة للمستويات المدفوعة
+- تقارير الإنفاق الشهرية
+
+### 🔄 ترجمة التنسيق
+
+ترجمة سلسة بين الصيغ:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **استجابات OpenAI**
+- ترسل أداة CLI الخاصة بك تنسيق OpenAI ← يترجم OmniRoute ← يتلقى الموفر التنسيق الأصلي
+- يعمل مع أي أداة تدعم نقاط نهاية OpenAI المخصصة
+- **تطهير الاستجابة** - يزيل الحقول غير القياسية من أجل توافق صارم مع OpenAI SDK
+- **تطبيع الدور** — `developer` → `system` لغير OpenAI؛ `system` → `user` لطرز GLM/ERNIE
+- **استخراج علامة التفكير** — كتل `` → `reasoning_content` لنماذج التفكير
+- **الإخراج المنظم** — `json_schema` → الجوزاء `responseMimeType`/`responseSchema`
+
+### 👥 دعم الحسابات المتعددة
+
+- إضافة حسابات متعددة لكل مزود
+- التوجيه التلقائي أو التوجيه على أساس الأولوية
+- الرجوع إلى الحساب التالي عندما يصل أحد إلى الحصة
+
+### 🔄 التحديث التلقائي للرموز
+
+- يتم تحديث رموز OAuth المميزة تلقائيًا قبل انتهاء الصلاحية
+- لا حاجة لإعادة المصادقة اليدوية
+- تجربة سلسة عبر جميع مقدمي الخدمة
+
+### 🎨 مجموعات مخصصة
+
+- إنشاء مجموعات نماذج غير محدودة
+- 6 إستراتيجيات: التعبئة أولاً، جولة روبن، قوة الاختيارين، العشوائية، الأقل استخدامًا، الأمثل من حيث التكلفة
+- مشاركة المجموعات عبر الأجهزة باستخدام Cloud Sync
+
+### 🏥 لوحة المعلومات الصحية
+
+- حالة النظام (وقت التشغيل، الإصدار، استخدام الذاكرة)
+- حالات قاطع الدائرة لكل مزود (مغلق/مفتوح/نصف مفتوح)
+- حالة الحد الأقصى للسعر وعمليات الإغلاق النشطة
+- إحصائيات ذاكرة التخزين المؤقت للتوقيع
+- قياس الكمون عن بعد (ص50/ص95/ص99) + ذاكرة تخزين مؤقت سريعة
+- إعادة ضبط الحالة الصحية بنقرة واحدة
+
+### 🔧 ملعب المترجم
+
+يشتمل OmniRoute على ساحة مترجم قوية مدمجة مع **4 أوضاع** لتصحيح الأخطاء واختبار ومراقبة ترجمات واجهة برمجة التطبيقات:
+
+| الوضع | الوصف |
+| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻 الملعب** | ترجمة التنسيق المباشر - الصق أي نص طلب واجهة برمجة التطبيقات (API) وشاهد على الفور كيف يقوم OmniRoute بترجمته بين تنسيقات الموفر (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). يتضمن أمثلة على القوالب والكشف التلقائي عن التنسيق. |
+| **💬 اختبار الدردشة** | أرسل طلبات دردشة حقيقية من خلال OmniRoute وشاهد الرحلة الكاملة ذهابًا وإيابًا: مدخلاتك، والطلب المترجم، واستجابة الموفر، والرد المترجم. لا تقدر بثمن للتحقق من صحة توجيه التحرير والسرد. |
+| **🧪 مقعد الاختبار** | وضع الاختبار المجمع - حدد حالات اختبار متعددة بمدخلات مختلفة ومخرجات متوقعة، وقم بتشغيلها كلها مرة واحدة، وقارن النتائج عبر الموفرين والنماذج. |
+| **📱 مراقب مباشر** | مراقبة الطلبات في الوقت الفعلي - شاهد الطلبات الواردة أثناء تدفقها عبر OmniRoute، وشاهد ترجمات التنسيق التي تحدث مباشرة، وحدد المشكلات على الفور. |
+
+**الوصول:** لوحة المعلومات ← المترجم (الشريط الجانبي)
+
+### 💾 المزامنة السحابية
+
+- موفري المزامنة والمجموعات والإعدادات عبر الأجهزة
+- مزامنة الخلفية التلقائية
+- تخزين مشفر آمن
+
+
+
+---
+
+## 📖 دليل الإعداد
+
+
+💳 موفري الاشتراك
+
+### كلود كود (برو/ماكس)
+
+```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
+```
+
+**نصيحة احترافية:** استخدم Opus للمهام المعقدة، وSonnet للسرعة. OmniRoute يتتبع الحصة لكل نموذج!
+
+### 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 (180 ألفًا شهريًا مجانًا!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**أفضل قيمة:** طبقة مجانية ضخمة! استخدم هذا قبل المستويات المدفوعة.
+
+### مساعد جيثب
+
+```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
+```
+
+
+
+
+🔑 موفري مفاتيح واجهة برمجة التطبيقات
+
+### NVIDIA NIM (1000 نقطة مجانية!)
+
+1. قم بالتسجيل: [build.nvidia.com](https://build.nvidia.com)
+2. احصل على مفتاح واجهة برمجة التطبيقات (API) مجانًا (يتضمن 1000 نقطة استدلال)
+3. لوحة المعلومات → إضافة موفر → NVIDIA NIM:
+ - مفتاح واجهة برمجة التطبيقات: `nvapi-your-key`
+
+**النماذج:** `nvidia/llama-3.3-70b-instruct`، `nvidia/mistral-7b-instruct`، وأكثر من 50 طرازًا آخر
+
+**نصيحة احترافية:** واجهة برمجة التطبيقات المتوافقة مع OpenAI — تعمل بسلاسة مع ترجمة تنسيق OmniRoute!
+
+### ديب سيك
+
+1. قم بالتسجيل: [platform.deepseek.com](https://platform.deepseek.com)
+2. احصل على مفتاح API
+3. لوحة المعلومات → إضافة موفر → DeepSeek
+
+**النماذج:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (الطبقة المجانية متاحة!)
+
+1. قم بالتسجيل: [console.groq.com](https://console.groq.com)
+2. احصل على مفتاح API (الطبقة المجانية متضمنة)
+3. لوحة المعلومات → إضافة موفر → Groq
+
+**النماذج:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**نصيحة احترافية:** استنتاج فائق السرعة — الأفضل للبرمجة في الوقت الفعلي!
+
+### OpenRouter (+100 موديل)
+
+1. قم بالتسجيل: [openrouter.ai](https://openrouter.ai)
+2. احصل على مفتاح API
+3. لوحة المعلومات → إضافة موفر → OpenRouter
+
+**النماذج:** يمكنك الوصول إلى أكثر من 100 نموذج من جميع المزودين الرئيسيين من خلال مفتاح واجهة برمجة التطبيقات (API) واحد.
+
+
+
+
+💰 مقدمو الخدمة الرخيصة (النسخ الاحتياطي)
+
+### GLM-4.7 (إعادة التعيين اليومي، 0.6 دولار/1 مليون)
+
+1. قم بالتسجيل: [Zhipu AI](https://open.bigmodel.cn/)
+2. احصل على مفتاح API من خطة الترميز
+3. لوحة المعلومات → إضافة مفتاح واجهة برمجة التطبيقات:
+ - المزود: `glm`
+ - مفتاح واجهة برمجة التطبيقات: `your-key`
+
+**الاستخدام:** `glm/glm-4.7`
+
+**نصيحة احترافية:** توفر خطة البرمجة حصة 3× بتكلفة 1/7! إعادة الضبط يوميًا الساعة 10:00 صباحًا.
+
+### MiniMax M2.1 (إعادة الضبط لمدة 5 ساعات، 0.20 دولار/1 مليون)
+
+1. قم بالتسجيل: [MiniMax](https://www.minimax.io/)
+2. احصل على مفتاح API
+3. لوحة المعلومات → إضافة مفتاح API
+
+**الاستخدام:** `minimax/MiniMax-M2.1`
+
+**نصيحة احترافية:** الخيار الأرخص للسياق الطويل (مليون رمز)!
+
+### كيمي K2 (شقة بقيمة 9 دولارات شهريًا)
+
+1. الاشتراك: [Moonshot AI](https://platform.moonshot.ai/)
+2. احصل على مفتاح API
+3. لوحة المعلومات → إضافة مفتاح API
+
+**الاستخدام:** `kimi/kimi-latest`
+
+**نصيحة احترافية:** سعر ثابت قدره 9 دولارات شهريًا مقابل 10 ملايين رمز مميز = 0.90 دولارًا أمريكيًا/مليون تكلفة فعالة!
+
+
+
+
+🆓 موفرو الخدمة المجانية (النسخ الاحتياطي في حالات الطوارئ)
+
+### iFlow (8 نماذج مجانية)
+
+```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
+```
+
+### كوين (3 موديلات مجانية)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### كيرو (كلود فري)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 إنشاء مجموعات
+
+### مثال 1: زيادة الاشتراك إلى الحد الأقصى → النسخ الاحتياطي الرخيص
+
+```
+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: مجاني فقط (بدون تكلفة)
+
+```
+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!
+```
+
+
+
+
+🔧 تكامل واجهة سطر الأوامر
+
+### بيئة تطوير متكاملة للمؤشر
+
+```
+Settings → Models → Advanced:
+ OpenAI API Base URL: http://localhost:20128/v1
+ OpenAI API Key: [from OmniRoute dashboard]
+ Model: cc/claude-opus-4-6
+```
+
+### كلود كود
+
+استخدم صفحة **أدوات CLI** في لوحة المعلومات للتكوين بنقرة واحدة، أو قم بتحرير `~/.claude/settings.json` يدويًا.
+
+### كوديكس سطر الأوامر
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**الخيار 1 — لوحة التحكم (مستحسن):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**الخيار 2 — يدويًا:** تحرير `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **ملاحظة:** يعمل OpenClaw فقط مع OmniRoute المحلي. استخدم `127.0.0.1` بدلاً من `localhost` لتجنب مشكلات دقة IPv6.
+
+### كلاين / متابعة / RooCode
+
+```
+Settings → API Configuration:
+ Provider: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [from OmniRoute dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 الموديلات المتوفرة
+
+
+عرض جميع الموديلات المتاحة
+
+**كود كلود (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**المخطوطة (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - مجانًا:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**مساعد جيثب (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - أرصدة مجانية:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- أكثر من 50 طرازًا آخر على [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - 0.6 دولار/مليون:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - 0.2 دولار/1 مليون:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - مجانًا:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**كوين (`qw/`)** - مجانًا:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**كيرو (`kr/`)** - مجانًا:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - أكثر من 100 طراز:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- أي موديل من [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 التقييمات (التقييمات)
+
+يشتمل OmniRoute على إطار تقييم مدمج لاختبار جودة استجابة LLM مقابل المجموعة الذهبية. يمكنك الوصول إليه عبر **Analytics → Evals** في لوحة التحكم.
+
+### الطقم الذهبي المدمج
+
+تحتوي "OmniRoute Golden Set" المحملة مسبقًا على 10 حالات اختبار تغطي:
+
+- تحياتي، الرياضيات، الجغرافيا، توليد التعليمات البرمجية
+- الامتثال لتنسيق JSON والترجمة وتخفيض السعر
+- رفض السلامة (المحتوى الضار)، العد، المنطق المنطقي
+
+### استراتيجيات التقييم
+
+| استراتيجية | الوصف | مثال |
+| ---------- | ------------------------------------------------------------- | -------------------------------- |
+| `exact` | يجب أن يتطابق الإخراج تمامًا مع | `"4"` |
+| `contains` | يجب أن يحتوي الإخراج على سلسلة فرعية (غير حساسة لحالة الأحرف) | `"Paris"` |
+| `regex` | يجب أن يتطابق الإخراج مع نمط regex | `"1.*2.*3"` |
+| `custom` | ترجع دالة JS المخصصة صواب/خطأ | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em Servidor Remoto (إعداد OAuth عن بعد)
+
+
+
+> **⚠️ هام لمستخدمي OmniRoute على VPS/Docker/servidor عن بعد**
+
+### لماذا OAuth يفعل Antigravity / Gemini CLI في الخوادم البعيدة؟
+
+تم إثبات **Antigravity** e **Gemini CLI** باستخدام **Google OAuth 2.0** للمصادقة. تطلب Google أن يتم استخدام `redirect_uri` دون تدفق OAuth ** على وجه التحديد ** إلى معرفات URI السابقة للمسح في تطبيق Google Cloud Console.
+
+نظرًا لأن اعتمادات OAuth المُدمجة ليست في OmniRoute، فهي عبارة عن سجلات **apenas لـ \__OMNI_TOKEN_123_**. عندما تصل إلى OmniRoute من خادم بعيد (على سبيل المثال: `https://omniroute.meuservidor.com`)، تحصل Google على مصادقة عبر:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### الحل: تكوين OAuth الخاص بك
+
+يجب عليك إنشاء **OAuth 2.0 Client ID** على Google Cloud Console باستخدام URI لخادمك.
+
+#### باسو باسو
+
+**1. الوصول إلى Google Cloud Console**
+
+العبرة: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
+
+**2. طلب معرف عميل OAuth 2.0 **
+
+- انقر على **"+ إنشاء بيانات الاعتماد"** → **"معرف عميل OAuth"**
+- نوع التطبيق: **"تطبيق ويب"**
+- الاسم: اسم escolha qualquer (على سبيل المثال: `OmniRoute Remote`)
+
+**3. Adicione كمحددات URI لإعادة التوجيه المعتمدة**
+
+ليس هناك مجال **"عناوين URI لإعادة التوجيه المعتمدة"**، أضف:
+
+```
+https://seu-servidor.com/callback
+```
+
+> استبدال `seu-servidor.com` بنطاقك أو IP الخاص بخادمك (بما في ذلك البوابة الضرورية، على سبيل المثال: `http://45.33.32.156:20128/callback`).
+
+**4. حفظ ونسخ كمعتمدة**
+
+وبعد ذلك، قم بإنشاء أو عرض Google o **معرف العميل** أو **سر العميل**.
+
+**5. تكوين كمتغيرات البيئة **
+
+لا يوجد `.env` (أو متغيرات بيئة 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 أو OmniRoute**
+
+```bash
+# Se usando npm:
+npm run dev
+
+# Se usando Docker:
+docker restart omniroute
+```
+
+**7. خيمة تواصل جديدة**
+
+لوحة المعلومات → الموفرون → Antigravity (ou Gemini CLI) → OAuth
+
+Agora o Google redirecionará corretamente para `https://seu-servidor.com/callback` e a autenticação funcionará.
+
+---
+
+### الحل المؤقت (لم يتم تكوين الاعتمادات الخاصة)
+
+إذا لم ترغب في إنشاء بيانات اعتماد خاصة بك منذ الآن، فمن الممكن استخدام التدفق **دليل URL**:
+
+1. يفتح OmniRoute عنوان URL لتفويض Google
+2. قم بتفويض Google لإعادة التوجيه إلى `localhost` (لا يوجد خادم عن بعد)
+3. **انسخ عنوان URL كاملاً** من شريط الإدخال في متصفحك (حتى لا يتم نقل الصفحة)
+4. هذا هو عنوان URL الذي يظهر في وضع الاتصال بـ OmniRoute
+5. انقر على **"الاتصال"**
+
+> يعمل هذا الحل البديل لأن رمز التفويض الموجود على عنوان URL يكون صالحًا بشكل مستقل لإعادة التوجيه حيث يتم تحميله أو لا.
+
+---
+
+## 🐛 استكشاف الأخطاء وإصلاحها
+
+
+انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها
+
+**"نموذج اللغة لم يقدم رسائل"**
+
+- استنفدت حصة الموفر → تحقق من تعقب حصة الموفر في لوحة المعلومات
+- الحل: استخدم خيار التحرير والسرد الاحتياطي أو قم بالتبديل إلى مستوى أرخص
+
+** الحد من المعدل **
+
+- حصة الاشتراك المحددة → الرجوع إلى GLM/MiniMax
+- إضافة التحرير والسرد: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+** انتهت صلاحية رمز OAuth **
+
+- يتم التحديث تلقائيًا بواسطة OmniRoute
+- إذا استمرت المشكلات: لوحة المعلومات → الموفر → إعادة الاتصال
+
+**تكاليف مرتفعة**
+
+- التحقق من إحصائيات الاستخدام في لوحة المعلومات → التكاليف
+- تبديل النموذج الأساسي إلى GLM/MiniMax
+- استخدم الطبقة المجانية (Gemini CLI، iFlow) للمهام غير الحرجة
+
+** لوحة المعلومات تفتح على منفذ خاطئ **
+
+- اضبط `PORT=20128` و`NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**أخطاء المزامنة السحابية**
+
+- تحقق من نقاط `BASE_URL` لمثيلك قيد التشغيل
+- تحقق من نقاط `CLOUD_URL` إلى نقطة نهاية السحابة المتوقعة
+- احتفظ بقيم `NEXT_PUBLIC_*` متوافقة مع القيم من جانب الخادم
+
+**تسجيل الدخول الأول لا يعمل**
+
+- تحقق من `INITIAL_PASSWORD` في `.env`
+- في حالة عدم تعيينها، تكون كلمة المرور الاحتياطية هي `123456`
+
+** لا توجد سجلات الطلب **
+
+- اضبط `ENABLE_REQUEST_LOGS=true` في `.env`
+
+**يظهر اختبار الاتصال "غير صالح" لمقدمي الخدمات المتوافقين مع OpenAI**
+
+- لا يكشف العديد من مقدمي الخدمة عن نقطة النهاية `/models`
+- يتضمن OmniRoute v1.0.6+ التحقق الاحتياطي من خلال إكمال الدردشة
+- تأكد من أن عنوان URL الأساسي يتضمن اللاحقة `/v1`
+
+
+
+---
+
+## 🛠️ تيك ستاك
+
+- **وقت التشغيل**: Node.js 18–22 LTS (⚠️ Node.js 24+ **غير مدعومة** — `better-sqlite3` الثنائيات الأصلية غير متوافقة)
+- **اللغة**: TypeScript 5.9 — **TypeScript بنسبة 100%** عبر `src/` و`open-sse/` (الإصدار 1.0.6)
+- **الإطار**: Next.js 16 + React 19 + Tailwind CSS 4
+- **قاعدة البيانات**: LowDB (JSON) + SQLite (حالة المجال + سجلات الوكيل)
+- **البث**: الأحداث المرسلة من الخادم (SSE)
+- **المصادقة**: OAuth 2.0 (PKCE) + JWT + مفاتيح API
+- **الاختبار**: مشغل اختبار Node.js (أكثر من 368 اختبارًا للوحدة)
+- **CI/CD**: إجراءات GitHub (نشر npm التلقائي + Docker Hub عند الإصدار)
+- **الموقع الإلكتروني**: [omniroute.online](https://omniroute.online)
+- **الحزمة**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **عامل الميناء**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **المرونة**: قاطع الدائرة الكهربائية، والتراجع الأسي، وقطيع مضاد للرعد، وانتحال TLS
+
+---
+
+## 📖 التوثيق
+
+| وثيقة | الوصف |
+| -------------------------------------------- | --------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md) | مقدمو الخدمات، والمجموعات، وتكامل CLI، والنشر |
+| [API Reference](docs/API_REFERENCE.md) | جميع نقاط النهاية مع الأمثلة |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | المشاكل والحلول الشائعة |
+| [Architecture](docs/ARCHITECTURE.md) | بنية النظام والداخلية |
+| [Contributing](CONTRIBUTING.md) | إعداد التطوير والمبادئ التوجيهية |
+| [OpenAPI Spec](docs/openapi.yaml) | مواصفات OpenAPI 3.0 |
+| [Security Policy](SECURITY.md) | الإبلاغ عن الثغرات الأمنية والممارسات الأمنية |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | الدليل الكامل: إعداد VM + nginx + Cloudflare |
+| [Features Gallery](docs/FEATURES.md) | جولة لوحة القيادة المرئية مع لقطات الشاشة |
+
+### 📸 معاينة لوحة التحكم
+
+
+انقر لرؤية لقطات شاشة لوحة المعلومات
+
+| صفحة | لقطة شاشة |
+| --------------------- | ------------------------------------------------- |
+| ** مقدمو الخدمة ** |  |
+| **المجموعات** |  |
+| **تحليلات** |  |
+| **الصحة** |  |
+| **مترجم** |  |
+| **الإعدادات** |  |
+| **أدوات سطر الأوامر** |  |
+| **سجلات الاستخدام** |  |
+| **نقطة النهاية** |  |
+
+
+
+---
+
+## 🗺️خريطة الطريق
+
+يحتوي OmniRoute على **210+ ميزات مخطط لها** عبر مراحل تطوير متعددة. فيما يلي المجالات الرئيسية:
+
+| الفئة | الميزات المخططة | أبرز الأحداث |
+| --------------------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| 🧠 **التوجيه والاستخبارات** | 25+ | التوجيه ذو زمن الاستجابة الأقل، والتوجيه القائم على العلامات، والاختبار المبدئي للحصة، واختيار حساب P2C |
+| 🔒 **الأمان والامتثال** | 20+ | تقوية SSRF، وإخفاء بيانات الاعتماد، والحد الأقصى للمعدل لكل نقطة نهاية، وتحديد نطاق مفتاح الإدارة |
+| 📊 **قابلية الملاحظة** | 15+ | تكامل OpenTelemetry ومراقبة الحصص في الوقت الفعلي وتتبع التكلفة لكل نموذج |
+| 🔄 **تكامل الموفر** | 20+ | تسجيل النموذج الديناميكي، فترات تهدئة الموفر، الدستور الغذائي متعدد الحسابات، تحليل حصة الطيار المساعد |
+| ⚡ **الأداء** | 15+ | طبقة ذاكرة التخزين المؤقت المزدوجة، ذاكرة التخزين المؤقت السريعة، ذاكرة التخزين المؤقت للاستجابة، استمرار البث، واجهة برمجة التطبيقات الدفعية |
+| 🌐 **النظام البيئي** | 10+ | WebSocket API، إعادة تحميل التكوين السريع، مخزن التكوين الموزع، الوضع التجاري |
+
+### 🔜قريبا
+
+- 🔗 **تكامل OpenCode** — دعم الموفر الأصلي لـ OpenCode AI IDE للترميز
+- 🔗 **تكامل TRAE** — الدعم الكامل لإطار تطوير TRAE AI
+- 📦 **Batch API** — معالجة الدفعات غير المتزامنة للطلبات المجمعة
+- 🎯 **التوجيه المعتمد على العلامات** — توجيه الطلبات بناءً على العلامات المخصصة والبيانات الوصفية
+- 💰 **إستراتيجية أقل تكلفة** — تحديد أرخص مزود متاح تلقائيًا
+
+> 📝 مواصفات الميزات الكاملة متوفرة في [**OMNI_TOKEN_147**](docs/new-features/) (217 مواصفات تفصيلية)
+
+---
+
+## 📧 الدعم
+
+> 💬 **انضم إلى مجتمعنا!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — احصل على المساعدة وشارك النصائح وابق على اطلاع.
+
+- **الموقع الإلكتروني**: [omniroute.online](https://omniroute.online)
+- **جيثب**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **المشاكل**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **واتساب**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **المشروع الأصلي**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 المساهمون
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### كيفية المساهمة
+
+1. شوكة المستودع
+2. قم بإنشاء فرع الميزات الخاص بك (`git checkout -b feature/amazing-feature`)
+3. تنفيذ التغييرات (`git commit -m 'Add amazing feature'`)
+4. ادفع إلى الفرع (`git push origin feature/amazing-feature`)
+5. افتح طلب السحب
+
+راجع [CONTRIBUTING.md](CONTRIBUTING.md) للحصول على إرشادات مفصلة.
+
+### إطلاق نسخة جديدة
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 تاريخ النجوم
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 شكر وتقدير
+
+شكر خاص لـ **[9router](https://github.com/decolua/9router)** بواسطة **[decolua](https://github.com/decolua)** — المشروع الأصلي الذي ألهم هذه الشوكة. يعتمد OmniRoute على هذا الأساس المذهل مع ميزات إضافية وواجهات برمجة التطبيقات متعددة الوسائط وإعادة كتابة TypeScript كاملة.
+
+شكر خاص لـ **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — تطبيق Go الأصلي الذي ألهم منفذ JavaScript هذا.
+
+---
+
+## 📄 الترخيص
+
+ترخيص MIT - راجع [LICENSE](LICENSE) للحصول على التفاصيل.
+
+---
+
+---
diff --git a/README.bg.md b/README.bg.md
new file mode 100644
index 0000000000..e65bd1ca67
--- /dev/null
+++ b/README.bg.md
@@ -0,0 +1,1238 @@
+
+
+
+ # 🚀 OmniRoute — Безплатният AI Gateway
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Никога не спирайте да кодирате. Интелигентно маршрутизиране към **БЕЗПЛАТНИ и евтини AI модели** с автоматичен резервен вариант.
+
+_Вашият универсален API прокси — една крайна точка, 36+ доставчици, нулев престой._
+
+**Завършвания на чат • Вграждания • Генериране на изображения • Аудио • Прекласиране • 100% TypeScript**
+
+---
+
+### 🤖 Безплатен доставчик на AI за вашите любими кодиращи агенти
+
+_Свържете всеки базиран на AI IDE или CLI инструмент чрез OmniRoute — безплатен API шлюз за неограничено кодиране._
+
+
+
+
+ # 🚀 OmniRoute — שער הבינה המלאכותית החינמית
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### לעולם אל תפסיק לקוד. ניתוב חכם לדגמי בינה מלאכותית **בחינם ובעלות נמוכה** עם חזרה אוטומטית.
+
+_שרת ה-API האוניברסלי שלך - נקודת קצה אחת, 36+ ספקים, אפס זמן השבתה._
+
+**השלמות צ'אט • הטמעות • יצירת תמונות • אודיו • דירוג מחדש • 100% TypeScript**
+
+---
+
+### 🤖 ספק AI בחינם עבור סוכני הקידוד המועדפים עליך
+
+_חבר כל כלי IDE או CLI המופעל על ידי AI דרך OmniRoute - שער API בחינם לקידוד בלתי מוגבל._
+
+
diff --git a/README.hu.md b/README.hu.md
new file mode 100644
index 0000000000..b359093d9e
--- /dev/null
+++ b/README.hu.md
@@ -0,0 +1,1238 @@
+
+
+
+ # 🚀 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._
+
+
+
+---
+
+## 🤔 Miért az OmniRoute?
+
+**Ne pazarolja a pénzt, és ne lépje túl a limiteket:**
+
+- Az előfizetési kvóta minden hónapban fel nem használt
+- A sebességkorlátok megakadályozzák a közbenső kódolást
+- Drága API-k (20-50 USD/hó szolgáltatónként)
+- 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 |
+
+
+📖 Funkció részletei
+
+### 🎯 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** — `` 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
+
+
+
+---
+
+## 📖 Beállítási útmutató
+
+
+💳 Előfizetési szolgáltatók
+
+### 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
+```
+
+
+
+
+🔑 API kulcs szolgáltatók
+
+### 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.
+
+
+
+
+💰 Olcsó szolgáltatók (tartalék)
+
+### 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!
+
+
+
+
+🆓 INGYENES szolgáltatók (vészhelyzeti biztonsági mentés)
+
+### 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
+```
+
+
+
+
+🎨 Kombók létrehozása
+
+### 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!
+```
+
+
+
+
+🔧 CLI-integráció
+
+### 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
+```
+
+
+
+---
+
+## 📊 Elérhető modellek
+
+
+Az összes elérhető modell megtekintése
+
+**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
+
+
+
+---
+
+## 🧪 É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)
+
+
+
+> **⚠️ 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
+
+
+Kattintson a hibaelhárítási útmutató kibontásához
+
+**"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
+
+
+
+---
+
+## 🛠️ 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
+
+
+Kattintson az irányítópult képernyőképeinek megtekintéséhez
+
+| Oldal | Képernyőkép |
+| --------------------- | ------------------------------------------------- |
+| **Szolgáltatók** |  |
+| **Combos** |  |
+| **Analytics** |  |
+| **Egészség** |  |
+| **Fordító** |  |
+| **Beállítások** |  |
+| **CLI eszközök** |  |
+| **Használati naplók** |  |
+| **Végpont** |  |
+
+
+
+---
+
+## 🗺️ Ú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 [**OMNI_TOKEN_147**](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
+
+[](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
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 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ó
+
+
+
+### 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)
+
+---
+
+
+ A ❤️ segítségével készült a 24/7 kódoló fejlesztőknek
+
+ omniroute.online
+
diff --git a/README.id.md b/README.id.md
new file mode 100644
index 0000000000..7801d4a019
--- /dev/null
+++ b/README.id.md
@@ -0,0 +1,1238 @@
+
+
+
+ # 🚀 OmniRoute — Gerbang AI Gratis
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Jangan pernah berhenti membuat kode. Perutean cerdas ke **model AI GRATIS & berbiaya rendah** dengan fallback otomatis.
+
+_Proksi API universal Anda — satu titik akhir, 36+ penyedia, tanpa waktu henti._
+
+**Penyelesaian Obrolan • Penyematan • Pembuatan Gambar • Audio • Pemeringkatan Ulang • 100% TypeScript**
+
+---
+
+### 🤖 Penyedia AI gratis untuk agen coding favorit Anda
+
+_Hubungkan alat IDE atau CLI apa pun yang didukung AI melalui OmniRoute — gerbang API gratis untuk pengkodean tanpa batas._
+
+
+
+---
+
+## 🤔 Mengapa OmniRoute?
+
+**Berhenti membuang-buang uang dan mencapai batas:**
+
+- Kuota berlangganan habis tanpa terpakai setiap bulannya
+- Batas kecepatan menghentikan Anda di tengah coding
+- API mahal ($20-50/bulan per penyedia)
+- Peralihan antar penyedia secara manual
+
+**OmniRoute memecahkan masalah ini:**
+
+- ✅ **Maksimalkan langganan** - Lacak kuota, gunakan setiap bit sebelum menyetel ulang
+- ✅ **Pengembalian otomatis** - Berlangganan → Kunci API → Murah → Gratis, tanpa downtime
+- ✅ **Multi-akun** - Round-robin antar akun per penyedia
+- ✅ **Universal** - Bekerja dengan Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, alat CLI apa pun
+
+---
+
+## 🔄 Cara Kerjanya
+
+```
+┌─────────────┐
+│ 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
+```
+
+---
+
+## ⚡ Mulai Cepat
+
+**1. Instal secara global:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Dasbor terbuka di `http://localhost:20128`
+
+| Perintah | Deskripsi |
+| ----------------------- | --------------------------------- |
+| `omniroute` | Mulai server (port default 20128) |
+| `omniroute --port 3000` | Gunakan port khusus |
+| `omniroute --no-open` | Jangan buka otomatis browser |
+| `omniroute --help` | Tampilkan bantuan |
+
+**2. Hubungkan penyedia GRATIS:**
+
+Dasbor → Penyedia → Hubungkan **Kode Claude** atau **Antigravitasi** → Login OAuth → Selesai!
+
+**3. Gunakan di alat CLI Anda:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copy from dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**Selesai!** Mulai coding dengan model AI GRATIS.
+
+**Alternatif — dijalankan dari sumber:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 buruh pelabuhan
+
+OmniRoute tersedia sebagai image Docker publik di [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Lari cepat:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**Dengan file lingkungan:**
+
+```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
+```
+
+**Menggunakan Docker Tulis:**
+
+```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
+```
+
+| Gambar | Tandai | Ukuran | Deskripsi |
+| ------------------------ | -------- | ------- | -------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250 MB | Rilis stabil terbaru |
+| `diegosouzapw/omniroute` | `1.0.3` | ~250 MB | Versi saat ini |
+
+---
+
+## 💰 Sekilas tentang Harga
+
+| Tingkat | Penyedia | Biaya | Reset Kuota | Terbaik Untuk |
+| ------------------- | ----------------- | ------------------------- | ------------------------- | --------------------------- |
+| **💳 BERLANGGANAN** | Kode Claude (Pro) | $20/bln | 5 jam + mingguan | Sudah berlangganan |
+| | Kodeks (Plus/Pro) | $20-200/bln | 5 jam + mingguan | Pengguna OpenAI |
+| | CLI Gemini | **GRATIS** | 180K/bln + 1K/hari | Setiap orang! |
+| | Kopilot GitHub | $10-19/bln | Bulanan | Pengguna GitHub |
+| **🔑 KUNCI API** | NVIDIA NIM | **GRATIS** (1000 sks) | Satu kali | Pengujian tingkat gratis |
+| | Pencarian Dalam | Bayar per penggunaan | Tidak ada | Harga/kualitas terbaik |
+| | Bagus | Tingkat gratis + berbayar | Tarif terbatas | Inferensi ultra-cepat |
+| | xAI (Grok) | Bayar per penggunaan | Tidak ada | Model Grok |
+| | Mistral | Tingkat gratis + berbayar | Tarif terbatas | AI Eropa |
+| | BukaRouter | Bayar per penggunaan | Tidak ada | 100+ model |
+| **💰 MURAH** | GLM-4.7 | $0,6/1 juta | Setiap hari pukul 10 pagi | Cadangan anggaran |
+| | MiniMax M2.1 | $0,2/1 juta | 5 jam bergulir | Pilihan termurah |
+| | Kimi K2 | $9/bln tetap | 10 juta token/bln | Biaya yang dapat diprediksi |
+| **🆓 GRATIS** | iFlow | $0 | Tidak terbatas | 8 model gratis |
+| | Qwen | $0 | Tidak terbatas | 3 model gratis |
+| | Kiro | $0 | Tidak terbatas | Claude gratis |
+
+**💡 Kiat Pro:** Mulai dengan Gemini CLI (gratis 180 ribu/bulan) + kombo iFlow (gratis tanpa batas) = biaya $0!
+
+---
+
+## 🎯 Kasus Penggunaan
+
+### Kasus 1: "Saya berlangganan Claude Pro"
+
+**Masalah:** Kuota habis tanpa terpakai, batas kecepatan selama coding berat
+
+```
+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
+```
+
+### Kasus 2: "Saya ingin tanpa biaya"
+
+**Masalah:** Tidak mampu berlangganan, memerlukan pengkodean AI yang andal
+
+```
+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
+```
+
+### Kasus 3: "Saya memerlukan pengkodean 24/7, tanpa gangguan"
+
+**Masalah:** Tenggat waktu, tidak mampu membayar downtime
+
+```
+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
+```
+
+### Kasus 4: "Saya ingin AI GRATIS di OpenClaw"
+
+**Masalah:** Membutuhkan asisten AI dalam aplikasi perpesanan, sepenuhnya gratis
+
+```
+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...
+```
+
+---
+
+## 💡 Fitur Utama
+
+### 🧠 Perutean & Kecerdasan Inti
+
+| Fitur | Apa Fungsinya |
+| ------------------------------------ | ---------------------------------------------------------------------------------- |
+| 🎯 **Pengembalian 4 Tingkat Cerdas** | Rute otomatis: Berlangganan → Kunci API → Murah → Gratis |
+| 📊 **Pelacakan Kuota Waktu Nyata** | Jumlah token langsung + setel ulang hitungan mundur per penyedia |
+| 🔄 **Terjemahan Format** | OpenAI ↔ Claude ↔ Gemini ↔ Kursor ↔ Kiro mulus + sanitasi respons |
+| 👥 **Dukungan Multi-Akun** | Banyak akun per penyedia dengan pilihan cerdas |
+| 🔄 **Penyegaran Token Otomatis** | Token OAuth disegarkan secara otomatis dengan coba lagi |
+| 🎨 **Kombo Khusus** | 6 strategi: isi dulu, round-robin, p2c, acak, paling jarang digunakan, hemat biaya |
+| 🧩 **Model Khusus** | Tambahkan ID model apa pun ke penyedia mana pun |
+| 🌐 **Router Wildcard** | Rutekan pola `provider/*` ke penyedia mana pun secara dinamis |
+| 🧠 **Memikirkan Anggaran** | Mode passthrough, otomatis, kustom, dan adaptif untuk model penalaran |
+| 💬 **Injeksi Perintah Sistem** | Perintah sistem global diterapkan di semua permintaan |
+| 📄 **API Respons** | Dukungan penuh OpenAI Responses API (`/v1/responses`) untuk Codex |
+
+### 🎵 API Multi-Modal
+
+| Fitur | Apa Fungsinya |
+| -------------------------- | ------------------------------------------------------ |
+| 🖼️ **Pembuatan Gambar** | `/v1/images/generations` — 4 penyedia, 9+ model |
+| 📐 **Sematan** | `/v1/embeddings` — 6 penyedia, 9+ model |
+| 🎤 **Transkripsi Audio** | `/v1/audio/transcriptions` — Kompatibel dengan bisikan |
+| 🔊 **Teks-ke-Ucapan** | `/v1/audio/speech` — Sintesis audio multi-penyedia |
+| 🛡️ **Moderasi** | `/v1/moderations` — Pemeriksaan keamanan konten |
+| 🔀 **Pemeringkatan Ulang** | `/v1/rerank` — Pemeringkatan ulang relevansi dokumen |
+
+### 🛡️ Ketahanan & Keamanan
+
+| Fitur | Apa Fungsinya |
+| ------------------------------------ | ------------------------------------------------------------------------------------------ |
+| 🔌 **Pemutus Arus** | Buka/tutup otomatis per penyedia dengan ambang batas yang dapat dikonfigurasi |
+| 🛡️ **Kawanan Anti Guntur** | Batas kecepatan mutex + semaphore untuk penyedia kunci API |
+| 🧠 **Cache Semantik** | Cache dua tingkat (tanda tangan + semantik) mengurangi biaya & latensi |
+| ⚡ **Minta Idempotensi** | Jendela dedup 5 detik untuk permintaan duplikat |
+| 🔒 **Spoofing Sidik Jari TLS** | Lewati deteksi bot berbasis TLS melalui wreq-js |
+| 🌐 **Pemfilteran IP** | Daftar yang diizinkan/daftar blokir untuk kontrol akses API |
+| 📊 **Batas Tarif yang Dapat Diedit** | RPM yang dapat dikonfigurasi, celah minimum, dan maks secara bersamaan pada tingkat sistem |
+| 🛡 **Perlindungan Titik Akhir API** | Gerbang autentikasi + pemblokiran penyedia untuk titik akhir `/models` |
+| 🔒 **Visibilitas Proksi** | Lencana berkode warna: 🟢 global, 🟡 penyedia, 🔵 per koneksi dengan tampilan IP |
+| 🌐 **Konfigurasi Proksi 3 Tingkat** | Konfigurasikan proxy di tingkat global, per penyedia, atau per koneksi |
+
+### 📊 Observabilitas & Analisis
+
+| Fitur | Apa Fungsinya |
+| ---------------------------- | ------------------------------------------------------------------------------- |
+| 📝 **Permintaan Pencatatan** | Mode debug dengan log permintaan/respons lengkap |
+| 💾 **Log Proksi SQLite** | Log proksi persisten bertahan saat server dimulai ulang |
+| 📊 **Dasbor Analitik** | Didukung grafik ulang: kartu stat, bagan penggunaan model, tabel penyedia |
+| 📈 **Pelacakan Kemajuan** | Ikut serta dalam acara kemajuan SSE untuk streaming |
+| 🧪 **Evaluasi LLM** | Pengujian set emas dengan 4 strategi pertandingan |
+| 🔍 **Permintaan Telemetri** | agregasi latensi p50/p95/p99 + penelusuran X-Request-Id |
+| 📋 **Dasbor Log** | Halaman 4 tab terpadu: Log Permintaan, Log Proksi, Log Audit, Konsol |
+| 🖥️ **Penampil Log Konsol** | Penampil gaya terminal real-time dengan filter level, pencarian, gulir otomatis |
+| 📑 **Logging Berbasis File** | Pencegat konsol menangkap semua output ke file log JSON dengan rotasi |
+| 🏥 **Dasbor Kesehatan** | Waktu aktif sistem, status pemutus sirkuit, penguncian, statistik cache |
+| 💰 **Pelacakan Biaya** | Manajemen anggaran + konfigurasi harga per model |
+
+### ☁️ Penerapan & Sinkronisasi
+
+| Fitur | Apa Fungsinya |
+| ---------------------------- | ---------------------------------------------------------------------------- |
+| 💾 **Sinkronisasi Cloud** | Sinkronkan konfigurasi antar perangkat melalui Cloudflare Workers |
+| 🌐 **Terapkan Di Mana Saja** | Localhost, VPS, Docker, Pekerja Cloudflare |
+| 🔑 **Manajemen Kunci API** | Menghasilkan, memutar, dan mencakup kunci API per penyedia |
+| 🧙 **Wizard Orientasi** | Penyiapan terpandu 4 langkah untuk pengguna pertama kali |
+| 🔧 **Dasbor Alat CLI** | Konfigurasikan sekali klik Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **Cadangan DB** | Pencadangan, pemulihan, ekspor & impor otomatis untuk semua pengaturan |
+| 🌐 **Internasionalisasi** | I18n lengkap dengan next-intl — Dukungan Inggris + Portugis (Brasil) |
+| 🌍 **Pemilih Bahasa** | Ikon bola dunia di header untuk peralihan bahasa secara real-time (🇮🇩/🇧🇷) |
+| 📂 **Direktori Data Khusus** | `DATA_DIR` env var untuk mengganti jalur penyimpanan `~/.omniroute` default |
+
+
+📖 Detail Fitur
+
+### 🎯 Penggantian 4 Tingkat yang Cerdas
+
+Buat kombo dengan fallback otomatis:
+
+```
+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
+```
+
+### 📊 Pelacakan Kuota Waktu Nyata
+
+- Konsumsi token per penyedia
+- Atur ulang hitungan mundur (5 jam, harian, mingguan)
+- Estimasi biaya untuk tingkatan berbayar
+- Laporan pengeluaran bulanan
+
+### 🔄 Format Terjemahan
+
+Terjemahan mulus antar format:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **Respon OpenAI**
+- Alat CLI Anda mengirimkan format OpenAI → OmniRoute menerjemahkan → Penyedia menerima format asli
+- Bekerja dengan alat apa pun yang mendukung titik akhir OpenAI khusus
+- **Sanitasi respons** — Menghapus kolom non-standar untuk kompatibilitas OpenAI SDK yang ketat
+- **Normalisasi peran** — `developer` → `system` untuk non-OpenAI; `system` → `user` untuk model GLM/ERNIE
+- **Think tag ekstraksi** — `` blok → `reasoning_content` untuk model berpikir
+- **Keluaran terstruktur** — `json_schema` → `responseMimeType`/`responseSchema` Gemini
+
+### 👥 Dukungan Multi-Akun
+
+- Tambahkan beberapa akun per penyedia
+- Perutean otomatis round-robin atau berbasis prioritas
+- Penggantian ke akun berikutnya ketika ada yang mencapai kuota
+
+### 🔄 Penyegaran Token Otomatis
+
+- Token OAuth secara otomatis disegarkan sebelum masa berlakunya habis
+- Tidak diperlukan otentikasi ulang manual
+- Pengalaman mulus di semua penyedia
+
+### 🎨 Kombo Khusus
+
+- Buat kombinasi model tanpa batas
+- 6 strategi: isi pertama, round-robin, kekuatan dua pilihan, acak, paling jarang digunakan, hemat biaya
+- Bagikan kombo di seluruh perangkat dengan Cloud Sync
+
+### 🏥 Dasbor Kesehatan
+
+- Status sistem (waktu aktif, versi, penggunaan memori)
+- Status pemutus sirkuit per penyedia (Tertutup/Terbuka/Setengah Terbuka)
+- Status batas tarif dan penguncian aktif
+- Statistik cache tanda tangan
+- Telemetri latensi (p50/p95/p99) + cache cepat
+- Atur ulang status kesehatan dengan satu klik
+
+### 🔧 Taman Bermain Penerjemah
+
+OmniRoute menyertakan Taman Bermain Penerjemah bawaan yang canggih dengan **4 mode** untuk melakukan debug, menguji, dan memantau terjemahan API:
+
+| Modus | Deskripsi |
+| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻 Taman bermain** | Terjemahan format langsung — tempelkan isi permintaan API apa pun dan langsung lihat bagaimana OmniRoute menerjemahkannya antar format penyedia (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Termasuk contoh templat dan deteksi otomatis format. |
+| **💬 Penguji Obrolan** | Kirim permintaan obrolan nyata melalui OmniRoute dan lihat perjalanan pulang pergi selengkapnya: masukan Anda, permintaan yang diterjemahkan, respons penyedia, dan respons yang diterjemahkan kembali. Sangat berharga untuk memvalidasi perutean kombo. |
+| **🧪 Bangku Tes** | Mode pengujian batch — tentukan beberapa kasus pengujian dengan masukan berbeda dan keluaran yang diharapkan, jalankan semuanya sekaligus, dan bandingkan hasilnya di seluruh penyedia dan model. |
+| **📱 Monitor Langsung** | Pemantauan permintaan waktu nyata — perhatikan permintaan masuk saat mengalir melalui OmniRoute, lihat terjemahan format yang terjadi secara langsung, dan identifikasi masalah secara instan. |
+
+**Akses:** Dasbor → Penerjemah (bilah samping)
+
+### 💾 Sinkronisasi Awan
+
+- Sinkronisasi penyedia, kombo, dan pengaturan di seluruh perangkat
+- Sinkronisasi latar belakang otomatis
+- Penyimpanan terenkripsi yang aman
+
+
+
+---
+
+## 📖 Panduan Pengaturan
+
+
+💳 Penyedia Langganan
+
+### Kode Claude (Pro/Maks)
+
+```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
+```
+
+**Kiat Pro:** Gunakan Opus untuk tugas kompleks, Soneta untuk kecepatan. OmniRoute melacak kuota per model!
+
+### Kodeks OpenAI (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 (GRATIS 180K/bulan!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Nilai Terbaik:** Tingkat gratis yang sangat besar! Gunakan ini sebelum tingkatan berbayar.
+
+### Kopilot GitHub
+
+```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
+```
+
+
+
+
+🔑 Penyedia Kunci API
+
+### NVIDIA NIM (GRATIS 1000 kredit!)
+
+1. Daftar: [build.nvidia.com](https://build.nvidia.com)
+2. Dapatkan kunci API gratis (termasuk 1000 kredit inferensi)
+3. Dasbor → Tambah Penyedia → NVIDIA NIM:
+ - Kunci API: `nvapi-your-key`
+
+**Model:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct`, dan 50+ lainnya
+
+**Kiat Pro:** API yang kompatibel dengan OpenAI — bekerja secara lancar dengan terjemahan format OmniRoute!
+
+### Pencarian Dalam
+
+1. Daftar: [platform.deepseek.com](https://platform.deepseek.com)
+2. Dapatkan kunci API
+3. Dasbor → Tambah Penyedia → DeepSeek
+
+**Model:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (Tersedia Tingkat Gratis!)
+
+1. Daftar: [console.groq.com](https://console.groq.com)
+2. Dapatkan kunci API (termasuk tingkat gratis)
+3. Dasbor → Tambah Penyedia → Groq
+
+**Model:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Kiat Pro:** Inferensi ultra-cepat — terbaik untuk pengkodean waktu nyata!
+
+### OpenRouter (100+ Model)
+
+1. Daftar: [openrouter.ai](https://openrouter.ai)
+2. Dapatkan kunci API
+3. Dasbor → Tambah Penyedia → OpenRouter
+
+**Model:** Akses 100+ model dari semua penyedia utama melalui satu kunci API.
+
+
+
+
+💰 Penyedia Murah (Cadangan)
+
+### GLM-4.7 (Reset harian, $0,6/1 juta)
+
+1. Daftar: [Zhipu AI](https://open.bigmodel.cn/)
+2. Dapatkan kunci API dari Coding Plan
+3. Dasbor → Tambahkan Kunci API:
+ - Penyedia: `glm`
+ - Kunci API: `your-key`
+
+**Gunakan:** `glm/glm-4.7`
+
+**Tips Pro:** Paket Coding menawarkan 3× kuota dengan biaya 1/7! Reset setiap hari pukul 10.00.
+
+### MiniMax M2.1 (reset 5 jam, $0,20/1 juta)
+
+1. Daftar: [MiniMax](https://www.minimax.io/)
+2. Dapatkan kunci API
+3. Dasbor → Tambahkan Kunci API
+
+**Gunakan:** `minimax/MiniMax-M2.1`
+
+**Kiat Pro:** Opsi termurah untuk konteks panjang (1 juta token)!
+
+### Kimi K2 ($9/bulan tetap)
+
+1. Berlangganan: [Moonshot AI](https://platform.moonshot.ai/)
+2. Dapatkan kunci API
+3. Dasbor → Tambahkan Kunci API
+
+**Gunakan:** `kimi/kimi-latest`
+
+**Kiat Pro:** Memperbaiki $9/bulan untuk 10 juta token = biaya efektif $0,90/1 juta!
+
+
+
+
+🆓 Penyedia GRATIS (Cadangan Darurat)
+
+### iFlow (8 model GRATIS)
+
+```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 model GRATIS)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Claude GRATIS)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Buat Kombo
+
+### Contoh 1: Maksimalkan Langganan → Cadangan Murah
+
+```
+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
+```
+
+### Contoh 2: Gratis Saja (Tanpa Biaya)
+
+```
+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!
+```
+
+
+
+
+🔧 Integrasi CLI
+
+### IDE Kursor
+
+```
+Settings → Models → Advanced:
+ OpenAI API Base URL: http://localhost:20128/v1
+ OpenAI API Key: [from OmniRoute dashboard]
+ Model: cc/claude-opus-4-6
+```
+
+### Kode Claude
+
+Gunakan halaman **Alat CLI** di dasbor untuk konfigurasi sekali klik, atau edit `~/.claude/settings.json` secara manual.
+
+### Kodeks CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### Buka Cakar
+
+**Opsi 1 — Dasbor (disarankan):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**Opsi 2 — Panduan:** Sunting `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Catatan:** OpenClaw hanya berfungsi dengan OmniRoute lokal. Gunakan `127.0.0.1` alih-alih `localhost` untuk menghindari masalah resolusi IPv6.
+
+### Cline / Lanjutkan / RooCode
+
+```
+Settings → API Configuration:
+ Provider: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [from OmniRoute dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Model yang Tersedia
+
+
+Lihat semua model yang tersedia
+
+**Kode Claude (`cc/`)** - Pro/Maks:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Kodeks (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - GRATIS:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**Copilot GitHub (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - Kredit GRATIS:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ model lainnya di [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - $0,6/1 juta:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0,2/1 juta:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - GRATIS:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - GRATIS:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - GRATIS:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ model:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Model apa pun dari [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Evaluasi (Eval)
+
+OmniRoute menyertakan kerangka evaluasi bawaan untuk menguji kualitas respons LLM terhadap rangkaian emas. Akses melalui **Analytics → Evals** di dasbor.
+
+### Set Emas Bawaan
+
+"OmniRoute Golden Set" yang dimuat sebelumnya berisi 10 kasus uji yang meliputi:
+
+- Salam, matematika, geografi, pembuatan kode
+- Kepatuhan format JSON, terjemahan, penurunan harga
+- Penolakan keamanan (konten berbahaya), penghitungan, logika boolean
+
+### Strategi Evaluasi
+
+| Strategi | Deskripsi | Contoh |
+| ---------- | ------------------------------------------------------------ | -------------------------------- |
+| `exact` | Output harus sama persis | `"4"` |
+| `contains` | Output harus berisi substring (tidak peka huruf besar-kecil) | `"Paris"` |
+| `regex` | Output harus sesuai dengan pola regex | `"1.*2.*3"` |
+| `custom` | Fungsi JS khusus mengembalikan benar/salah | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em Servidor Remoto (Pengaturan OAuth Jarak Jauh)
+
+
+
+> **⚠️ PENTING bagi pengguna dengan OmniRoute pada VPS/Docker/server jarak jauh**
+
+### Mengapa OAuth melakukan Antigravity / Gemini CLI gagal dalam layanan jarak jauh?
+
+Pembuktiannya **Antigravitasi** dan **Gemini CLI** digunakan **Google OAuth 2.0** untuk autentikasi. Google meminta agar `redirect_uri` menggunakan OAuth yang terus berubah, jadi **exatamente** adalah URI yang sudah ada sebelumnya di Google Cloud Console yang dapat diterapkan.
+
+Karena kredensial OAuth yang diberikan pada OmniRoute adalah kadastrada **apenas untuk `localhost`**. Ketika Anda mengakses OmniRoute dari server jarak jauh (misal: `https://omniroute.meuservidor.com`), atau Google meminta autenticação com:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### Solusi: Konfigurasikan akun OAuth Anda
+
+Anda perlu membuat **ID Klien OAuth 2.0** di Google Cloud Console dengan URI di server Anda.
+
+#### Lewati dulu
+
+**1. Mengakses Google Cloud Console**
+
+Abra: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
+
+**2. Inilah ID Klien OAuth 2.0 yang baru**
+
+- Klik pada **"+ Buat Kredensial"** → **"ID klien OAuth"**
+- Tip aplikasi: **"Aplikasi web"**
+- Nama: nama escolha qualquer (misal: `OmniRoute Remote`)
+
+**3. Tambahan sebagai URI Pengalihan Resmi**
+
+Selain itu **"URI pengalihan resmi"**, tambahan:
+
+```
+https://seu-servidor.com/callback
+```
+
+> Pengganti `seu-servidor.com` pelo domínio atau IP ke server Anda (termasuk port yang diperlukan, misal: `http://45.33.32.156:20128/callback`).
+
+**4. Salep dan salin sebagai kredensial**
+
+Kemudian, Google menampilkan **ID Klien** dan **Rahasia Klien**.
+
+**5. Konfigurasikan sebagai variáveis de ambiente**
+
+Di `.env` (atau berbagai lingkungan di 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. Memulai kembali OmniRoute**
+
+```bash
+# Se usando npm:
+npm run dev
+
+# Se usando Docker:
+docker restart omniroute
+```
+
+**7. Mari kita sambungkan lagi**
+
+Dasbor → Penyedia → Antigravitasi (atau Gemini CLI) → OAuth
+
+Sekarang o Google dialihkan langsung ke `https://seu-servidor.com/callback` dan autentikasi berfungsi.
+
+---
+
+### Solusi sementara (sem configurar credenciais próprias)
+
+Jika Anda tidak ingin membuat kredensial pribadi sekarang, Anda mungkin dapat menggunakan fluks **panduan URL**:
+
+1. O OmniRoute membuka URL autoriza dari Google
+2. Setelah Anda autorizar, Google mengarahkan pengalihan ke `localhost` (yang gagal pada server jarak jauh)
+3. **Salin URL lengkap** dari bilah akhir browser Anda (meskipun halaman tidak dimuat)
+4. Gunakan URL ini karena tidak ada modal koneksi ke OmniRoute
+5. Klik pada **"Hubungkan"**
+
+> Solusi ini berfungsi karena kode otorisasi pada URL valid secara independen untuk mengarahkan ulang ke akun atau tidak.
+
+---
+
+## 🐛 Pemecahan masalah
+
+
+Klik untuk memperluas panduan pemecahan masalah
+
+**"Model bahasa tidak memberikan pesan"**
+
+- Kuota penyedia habis → Periksa dashboard pelacak kuota
+- Solusi: Gunakan combo fallback atau beralih ke tier yang lebih murah
+
+**Pembatasan tarif**
+
+- Kuota berlangganan habis → Penggantian ke GLM/MiniMax
+- Tambahkan kombo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**Token OAuth kedaluwarsa**
+
+- Disegarkan secara otomatis oleh OmniRoute
+- Jika masalah terus berlanjut: Dasbor → Penyedia → Sambungkan kembali
+
+**Biaya tinggi**
+
+- Periksa statistik penggunaan di Dashboard → Biaya
+- Ganti model utama ke GLM/MiniMax
+- Gunakan tingkat gratis (Gemini CLI, iFlow) untuk tugas-tugas yang tidak penting
+
+**Dasbor terbuka pada port yang salah**
+
+- Tetapkan `PORT=20128` dan `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Kesalahan sinkronisasi cloud**
+
+- Verifikasi `BASE_URL` poin ke instance Anda yang sedang berjalan
+- Verifikasi `CLOUD_URL` poin ke titik akhir cloud yang Anda harapkan
+- Jaga agar nilai `NEXT_PUBLIC_*` selaras dengan nilai sisi server
+
+**Login pertama tidak berfungsi**
+
+- Periksa `INITIAL_PASSWORD` di `.env`
+- Jika tidak disetel, kata sandi cadangan adalah `123456`
+
+**Tidak ada log permintaan**
+
+- Tetapkan `ENABLE_REQUEST_LOGS=true` di `.env`
+
+**Tes koneksi menunjukkan "Tidak Valid" untuk penyedia yang kompatibel dengan OpenAI**
+
+- Banyak penyedia tidak mengekspos titik akhir `/models`
+- OmniRoute v1.0.6+ menyertakan validasi fallback melalui penyelesaian obrolan
+- Pastikan URL dasar menyertakan akhiran `/v1`
+
+
+
+---
+
+## 🛠️ Tumpukan Teknologi
+
+- **Runtime**: Node.js 18–22 LTS (⚠️ Node.js 24+ **tidak didukung** — `better-sqlite3` biner asli tidak kompatibel)
+- **Bahasa**: TypeScript 5.9 — **100% TypeScript** di `src/` dan `open-sse/` (v1.0.6)
+- **Kerangka Kerja**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Database**: LowDB (JSON) + SQLite (status domain + log proksi)
+- **Streaming**: Peristiwa Terkirim Server (SSE)
+- **Auth**: OAuth 2.0 (PKCE) + JWT + Kunci API
+- **Pengujian**: pelari pengujian Node.js (368+ pengujian unit)
+- **CI/CD**: Tindakan GitHub (publikasi npm otomatis + Docker Hub saat dirilis)
+- **Situs Web**: [omniroute.online](https://omniroute.online)
+- **Paket**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Pekerja Pelabuhan**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Ketahanan**: Pemutus sirkuit, kemunduran eksponensial, kawanan anti-guntur, spoofing TLS
+
+---
+
+## 📖 Dokumentasi
+
+| Dokumen | Deskripsi |
+| -------------------------------------------- | --------------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md) | Penyedia, kombo, integrasi CLI, penerapan |
+| [API Reference](docs/API_REFERENCE.md) | Semua titik akhir dengan contoh |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Masalah umum dan solusinya |
+| [Architecture](docs/ARCHITECTURE.md) | Arsitektur sistem dan internal |
+| [Contributing](CONTRIBUTING.md) | Pengaturan dan pedoman pengembangan |
+| [OpenAPI Spec](docs/openapi.yaml) | Spesifikasi OpenAPI 3.0 |
+| [Security Policy](SECURITY.md) | Pelaporan kerentanan dan praktik keamanan |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Panduan lengkap: VM + nginx + Pengaturan Cloudflare |
+| [Features Gallery](docs/FEATURES.md) | Tur dasbor visual dengan tangkapan layar |
+
+### 📸 Pratinjau Dasbor
+
+
+Klik untuk melihat tangkapan layar dasbor
+
+| Halaman | Tangkapan layar |
+| ------------------ | ------------------------------------------------- |
+| **Penyedia** |  |
+| **Kombo** |  |
+| **Analitik** |  |
+| **Kesehatan** |  |
+| **Penerjemah** |  |
+| **Pengaturan** |  |
+| **Alat CLI** |  |
+| **Log Penggunaan** |  |
+| **Titik Akhir** |  |
+
+
+
+---
+
+## 🗺️ Peta Jalan
+
+OmniRoute memiliki **210+ fitur yang direncanakan** di berbagai fase pengembangan. Berikut adalah bidang-bidang utamanya:
+
+| Kategori | Fitur yang Direncanakan | Sorotan |
+| ---------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------- |
+| 🧠 **Perutean & Kecerdasan** | 25+ | Perutean latensi terendah, perutean berbasis tag, preflight kuota, pemilihan akun P2C |
+| 🔒 **Keamanan & Kepatuhan** | 20+ | Pengerasan SSRF, penyelubungan kredensial, batas tarif per titik akhir, pelingkupan kunci manajemen |
+| 📊 **Kemampuan Observasi** | 15+ | Integrasi OpenTelemetry, pemantauan kuota waktu nyata, pelacakan biaya per model |
+| 🔄 **Integrasi Penyedia** | 20+ | Registri model dinamis, cooldown penyedia, Codex multi-akun, penguraian kuota Salinan |
+| ⚡ **Kinerja** | 15+ | Lapisan cache ganda, cache cepat, cache respons, streaming keepalive, API batch |
+| 🌐 **Ekosistem** | 10+ | WebSocket API, konfigurasi hot-reload, penyimpanan konfigurasi terdistribusi, mode komersial |
+
+### 🔜 Segera Hadir
+
+- 🔗 **Integrasi OpenCode** — Dukungan penyedia asli untuk IDE pengkodean AI OpenCode
+- 🔗 **Integrasi TRAE** — Dukungan penuh untuk kerangka pengembangan AI TRAE
+- 📦 **Batch API** — Pemrosesan batch asinkron untuk permintaan massal
+- 🎯 **Perutean Berbasis Tag** — Merutekan permintaan berdasarkan tag dan metadata khusus
+- 💰 **Strategi Biaya Terendah** — Secara otomatis memilih penyedia termurah yang tersedia
+
+> 📝 Spesifikasi fitur lengkap tersedia di [**OMNI_TOKEN_147**](docs/new-features/) (217 spesifikasi detail)
+
+---
+
+## 📧 Dukungan
+
+> 💬 **Bergabunglah dengan komunitas kami!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Dapatkan bantuan, berbagi kiat, dan dapatkan informasi terbaru.
+
+- **Situs Web**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Masalah**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **Proyek Asli**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Kontributor
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Cara Berkontribusi
+
+1. Cabangkan repositori
+2. Buat cabang fitur Anda (`git checkout -b feature/amazing-feature`)
+3. Komit perubahan Anda (`git commit -m 'Add amazing feature'`)
+4. Dorong ke cabang (`git push origin feature/amazing-feature`)
+5. Buka Permintaan Tarik
+
+Lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk panduan detailnya.
+
+### Merilis Versi Baru
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 Sejarah Bintang
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Ucapan Terima Kasih
+
+Terima kasih khusus kepada **[9router](https://github.com/decolua/9router)** oleh **[decolua](https://github.com/decolua)** — proyek asli yang menginspirasi fork ini. OmniRoute dibangun di atas fondasi luar biasa tersebut dengan fitur tambahan, API multi-modal, dan penulisan ulang TypeScript lengkap.
+
+Terima kasih khusus kepada **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — implementasi Go asli yang menginspirasi port JavaScript ini.
+
+---
+
+## 📄 Lisensi
+
+Lisensi MIT - lihat [LICENSE](LICENSE) untuk detailnya.
+
+---
+
+---
+
+## 🇧🇷 OmniRoute — Gerbang IA Gratis
+
+
+
+### Tidak ada kode apa pun. Roteamento cerdas untuk **model IA GRATIS dan hak istimewa** dengan fallback otomatis.
+
+_Proksi universal API — um titik akhir, 36+ bukti, tanpa waktu henti._
+
+### 🌐 Internasionalisasi (i18n)
+
+Pada dasbor, lakukan OmniRoute mendukung **beberapa idiom**. Saat ini kami telah membagikannya:
+
+| Idiom | Kode | Status |
+| --------------------- | ------- | ---------- |
+| 🇮🇩 Bahasa Inggris | `en` | ✅ Lengkap |
+| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Lengkap |
+
+**Untuk trocar o idioma:** Klik no selector de idioma (🇮🇩 EN) no header do dashboard → pilih idioma yang diinginkan.
+
+**Untuk menambahkan idiom baru:**
+
+1. Teriak `src/i18n/messages/{codigo}.json` berdasarkan `en.json`
+2. Tambahan kode pada `src/i18n/config.ts` → `LOCALES` dan `LANGUAGES`
+3. Memulai kembali server
+
+### ⚡ Mulai Cepat
+
+```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
+```
+
+### 🐳 buruh pelabuhan
+
+```bash
+docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
+```
+
+### 🔑 Prinsip Fungsionalidades
+
+- **36+ bukti IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, dan lainnya
+- **Roteamento inteligente** — Penggantian otomatis ke seluruh bukti
+- **Penulisan format** — OpenAI ↔ Claude ↔ Gemini secara otomatis
+- **Multi-konta** — Multi-konta berdasarkan pilihan yang cerdas
+- **Cache semântico** — Memulihkan biaya dan latensi
+- **OAuth otomatis** — Token diperbarui secara otomatis
+- **Kombo yang dipersonalisasi** — 6 strategi roteamento
+- **Dasbor lengkap** — Monitor, log, analisis, konfigurasi
+- **Alat CLI** — Konfigurasikan Kode Claude, Codex, Kursor, Cline com um klik
+- **100% TypeScript** — Kode limpo dan tipado
+
+### 📖 Dokumentasi
+
+| Dokumen | Deskripsi |
+| ----------------------------------------------- | ---------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, kombo, CLI, terapkan |
+| [Referência da API](docs/API_REFERENCE.md) | Semua titik akhir dengan contoh |
+| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Masalah Umum dan Solusi |
+| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura dan internal dalam sistem |
+| [Contribuição](CONTRIBUTING.md) | Menyiapkan pedoman desenvolvimento |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Panduan lengkap: VM + nginx + Cloudflare |
+
+### 📧 Dukungan
+
+> 💬 **Entre to a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Ban dúvidas, compartilhe dicas dan fique aktualizado.
+
+- **Situs Web**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Masalah**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+
+ Dibangun dengan ❤️ untuk pengembang yang membuat kode 24/7
+
+ omniroute.online
+
diff --git a/README.in.md b/README.in.md
new file mode 100644
index 0000000000..927910e656
--- /dev/null
+++ b/README.in.md
@@ -0,0 +1,1032 @@
+
+ __OMNI_टोकन_234__
+
+ # 🚀 ओम्निरूट - निःशुल्क एआई गेटवे
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | ****ओएमएनआई_टोकन_159****
+
+### कोडिंग कभी बंद न करें। स्वचालित फ़ॉलबैक के साथ **मुफ़्त और कम लागत वाले AI मॉडल** के लिए स्मार्ट रूटिंग।
+
+_आपका सार्वभौमिक एपीआई प्रॉक्सी - एक समापन बिंदु, 36+ प्रदाता, शून्य डाउनटाइम।_
+
+**चैट समापन • एंबेडिंग • छवि निर्माण • ऑडियो • पुनर्रैंकिंग • 100% टाइपस्क्रिप्ट**
+
+---
+
+### 🤖 आपके पसंदीदा कोडिंग एजेंटों के लिए निःशुल्क एआई प्रदाता
+
+_OmniRoute के माध्यम से किसी भी AI-संचालित IDE या CLI टूल को कनेक्ट करें - असीमित कोडिंग के लिए निःशुल्क API गेटवे।_
+
+**OMNI_टोकन_33**
+
+📡 सभी एजेंट http://localhost:20128/v1 या http://cloud.omniroute.online/v1 के माध्यम से जुड़ते हैं - एक कॉन्फ़िगरेशन, असीमित मॉडल और कोटा
+
+---
+
+[](https://www.npmjs.com/package/omniroute)
+[](https://hub.docker.com/r/diegosouzapw/omniroute)
+[](https://github.com/diegosouzapw/OmniRoute/blob/main/LICENSE)
+[](https://omniroute.online)
+[](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)
+
+**OMNI_टोकन_247**
+
+---
+
+## 🤔ओम्नीरूट क्यों?
+
+**पैसा बर्बाद करना और सीमा पार करना बंद करें:**
+
+- सदस्यता कोटा हर महीने अप्रयुक्त रूप से समाप्त हो जाता है
+- दर सीमा आपको कोडिंग के बीच में रोक देती है
+- महँगे API ($20-50/माह प्रति प्रदाता)
+- प्रदाताओं के बीच मैन्युअल स्विचिंग
+
+**OmniRoute इसका समाधान करता है:**
+
+- ✅ **सब्सक्रिप्शन अधिकतम करें** - कोटा ट्रैक करें, रीसेट से पहले हर बिट का उपयोग करें
+- ✅ **ऑटो फ़ॉलबैक** - सदस्यता → एपीआई कुंजी → सस्ता → निःशुल्क, शून्य डाउनटाइम
+- ✅ **मल्टी-अकाउंट** - प्रति प्रदाता खातों के बीच राउंड-रॉबिन
+- ✅ **यूनिवर्सल** - क्लाउड कोड, कोडेक्स, जेमिनी सीएलआई, कर्सर, क्लाइन, ओपनक्लॉ, किसी भी सीएलआई टूल के साथ काम करता है
+
+---
+
+## 🔄 यह कैसे काम करता है
+
+```
+┌─────────────┐
+│ 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
+```
+
+---
+
+## ⚡ त्वरित शुरुआत
+
+**1. विश्व स्तर पर स्थापित करें:**
+
+**OMNI_टोकन_1**
+
+🎉 डैशबोर्ड `http://localhost:20128` पर खुलता है
+
+| आदेश | विवरण |
+| ----------------------- | ----------------------------------------- |
+| `omniroute` | सर्वर प्रारंभ करें (डिफ़ॉल्ट पोर्ट 20128) |
+| `omniroute --port 3000` | कस्टम पोर्ट का उपयोग करें |
+| `omniroute --no-open` | ब्राउज़र को स्वतः न खोलें |
+| `omniroute --help` | सहायता दिखाएँ |
+
+**2. एक मुफ़्त प्रदाता से जुड़ें:**
+
+डैशबोर्ड → प्रदाता → कनेक्ट **क्लाउड कोड** या **एंटीग्रेविटी** → OAuth लॉगिन → हो गया!
+
+**3. अपने सीएलआई टूल में उपयोग करें:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copy from dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**बस!** मुफ़्त AI मॉडल के साथ कोडिंग शुरू करें।
+
+**वैकल्पिक - स्रोत से चलाएँ:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 डॉकर
+
+ओमनीरूट [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute) पर सार्वजनिक डॉकर छवि के रूप में उपलब्ध है।
+
+**त्वरित दौड़:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**पर्यावरण फ़ाइल के साथ:**
+
+**OMNI_टोकन_5**
+
+**डॉकर कंपोज़ का उपयोग करना:**
+
+**OMNI_टोकन_6**
+
+| छवि | टैग | आकार | विवरण |
+| ------------------------ | -------- | -------- | ------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250एमबी | नवीनतम स्थिर रिलीज़ |
+| `diegosouzapw/omniroute` | `1.0.3` | ~250एमबी | वर्तमान संस्करण |
+
+---
+
+## 💰 मूल्य निर्धारण एक नज़र में
+
+| टियर | प्रदाता | लागत | कोटा रीसेट | के लिए सर्वश्रेष्ठ |
+| ----------------- | ------------------- | ------------------------- | -------------------- | ------------------------ |
+| **💳 सदस्यता** | क्लाउड कोड (प्रो) | $20/माह | 5 घंटे + साप्ताहिक | पहले ही सदस्यता ले ली है |
+| | कोडेक्स (प्लस/प्रो) | $20-200/महीना | 5 घंटे + साप्ताहिक | OpenAI उपयोगकर्ता |
+| | जेमिनी सीएलआई | **मुफ़्त** | 180K/माह + 1K/दिन | सब लोग! |
+| | गिटहब कोपायलट | $10-19/माह | मासिक | GitHub उपयोगकर्ता |
+| **🔑एपीआई कुंजी** | एनवीडिया एनआईएम | **मुफ़्त** (1000 क्रेडिट) | एक बार | निःशुल्क स्तरीय परीक्षण |
+| | डीपसीक | भुगतान-प्रति-उपयोग | कोई नहीं | सर्वोत्तम मूल्य/गुणवत्ता |
+| | ग्रोक | फ्री टियर + पेड | दर सीमित | अल्ट्रा-फास्ट अनुमान |
+| | एक्सएआई (ग्रोक) | भुगतान-प्रति-उपयोग | कोई नहीं | ग्रोक मॉडल |
+| | मिस्ट्रल | फ्री टियर + पेड | दर सीमित | यूरोपीय एआई |
+| | ओपनराउटर | भुगतान-प्रति-उपयोग | कोई नहीं | 100+ मॉडल |
+| **💰सस्ता** | जीएलएम-4.7 | $0.6/1 मिलियन | प्रतिदिन सुबह 10 बजे | बजट बैकअप |
+| | मिनीमैक्स एम2.1 | $0.2/1 मिलियन | 5 घंटे की रोलिंग | सबसे सस्ता विकल्प |
+| | किमी K2 | $9/महीना फ्लैट | 10एम टोकन/माह | अनुमानित लागत |
+| **🆓 मुफ़्त** | आईफ्लो | $0 | असीमित | 8 मॉडल निःशुल्क |
+| | क्वेन | $0 | असीमित | 3 मॉडल मुफ़्त |
+| | किरो | $0 | असीमित | क्लाउड मुक्त |
+
+**💡 प्रो टिप:** जेमिनी सीएलआई (180 हजार निःशुल्क/माह) + आईफ्लो (असीमित निःशुल्क) कॉम्बो = $0 लागत से शुरू करें!
+
+---
+
+## 🎯 उपयोग के मामले
+
+### केस 1: "मेरे पास क्लाउड प्रो सदस्यता है"
+
+**समस्या:** भारी कोडिंग के दौरान कोटा अप्रयुक्त, दर सीमा समाप्त हो जाता है
+
+```
+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: "मुझे शून्य लागत चाहिए"
+
+**समस्या:** सदस्यताएं वहन नहीं कर सकते, विश्वसनीय एआई कोडिंग की आवश्यकता है
+
+**OMNI_टोकन_8**
+
+### केस 3: "मुझे 24/7 कोडिंग चाहिए, कोई रुकावट नहीं"
+
+**समस्या:** समय सीमा, डाउनटाइम बर्दाश्त नहीं कर सकते
+
+```
+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: "मुझे ओपनक्लॉ में मुफ़्त एआई चाहिए"
+
+**समस्या:** मैसेजिंग ऐप्स में AI सहायक की आवश्यकता है, पूरी तरह से निःशुल्क
+
+```
+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...
+```
+
+---
+
+## 💡 मुख्य विशेषताएं
+
+### 🧠 कोर रूटिंग और इंटेलिजेंस
+
+| फ़ीचर | यह क्या करता है |
+| --------------------------------- | ------------------------------------------------------------------------------------ |
+| 🎯 **स्मार्ट 4-टियर फ़ॉलबैक** | ऑटो-रूट: सदस्यता → एपीआई कुंजी → सस्ता → मुफ़्त |
+| 📊 **वास्तविक समय कोटा ट्रैकिंग** | लाइव टोकन गिनती + प्रति प्रदाता रीसेट उलटी गिनती |
+| 🔄 **प्रारूप अनुवाद** | OpenAI ↔ क्लाउड ↔ जेमिनी ↔ कर्सर ↔ किरो सीमलेस + रिस्पॉन्स सैनिटाइजेशन |
+| 👥 **मल्टी-अकाउंट सपोर्ट** | बुद्धिमान चयन के साथ प्रति प्रदाता एकाधिक खाते |
+| 🔄 **ऑटो टोकन रिफ्रेश** | OAuth टोकन पुनः प्रयास के साथ स्वचालित रूप से ताज़ा हो जाते हैं |
+| 🎨 **कस्टम कॉम्बो** | 6 रणनीतियाँ: पहले भरें, राउंड-रॉबिन, पी2सी, यादृच्छिक, कम से कम उपयोग, लागत-अनुकूलित |
+| 🧩 **कस्टम मॉडल** | किसी भी प्रदाता से कोई भी मॉडल आईडी जोड़ें |
+| 🌐 **वाइल्डकार्ड राउटर** | `provider/*` पैटर्न को गतिशील रूप से किसी भी प्रदाता तक रूट करें |
+| 🧠 **सोच बजट** | तर्क मॉडल के लिए पासथ्रू, ऑटो, कस्टम और अनुकूली मोड |
+| 💬 **सिस्टम प्रॉम्प्ट इंजेक्शन** | ग्लोबल सिस्टम प्रॉम्प्ट सभी अनुरोधों पर लागू किया गया |
+| 📄 **प्रतिक्रियाएं एपीआई** | कोडेक्स के लिए पूर्ण ओपनएआई रिस्पॉन्स एपीआई (`/v1/responses`) समर्थन |
+
+### 🎵 मल्टी-मॉडल एपीआई
+
+| फ़ीचर | यह क्या करता है |
+| ---------------------------- | ------------------------------------------------- |
+| 🖼️ **छवि निर्माण** | `/v1/images/generations` - 4 प्रदाता, 9+ मॉडल |
+| 📐 **एंबेडिंग** | `/v1/embeddings` — 6 प्रदाता, 9+ मॉडल |
+| 🎤 **ऑडियो ट्रांस्क्रिप्शन** | `/v1/audio/transcriptions` - कानाफूसी-संगत |
+| 🔊 **टेक्स्ट-टू-स्पीच** | `/v1/audio/speech` - बहु-प्रदाता ऑडियो संश्लेषण |
+| 🛡️ **संयम** | `/v1/moderations` — सामग्री सुरक्षा जांच |
+| 🔀 **पुनर्रैंकिंग** | `/v1/rerank` — दस्तावेज़ प्रासंगिकता पुनर्रैंकिंग |
+
+### 🛡️ लचीलापन और सुरक्षा
+
+| फ़ीचर | यह क्या करता है |
+| ------------------------------------- | ---------------------------------------------------------------------------- |
+| 🔌 **सर्किट ब्रेकर** | कॉन्फ़िगर करने योग्य थ्रेशोल्ड के साथ प्रति-प्रदाता स्वतः खोलें/बंद करें |
+| 🛡️ **एंटी-थंडरिंग झुंड** | एपीआई कुंजी प्रदाताओं के लिए म्यूटेक्स + सेमाफोर दर-सीमा |
+| 🧠 **सिमेंटिक कैश** | दो-स्तरीय कैश (हस्ताक्षर + सिमेंटिक) लागत और विलंबता को कम करता है |
+| ⚡ **निष्क्रियता का अनुरोध** | डुप्लिकेट अनुरोधों के लिए 5s डिडअप विंडो |
+| 🔒 **टीएलएस फ़िंगरप्रिंट स्पूफ़िंग** | Wreq-js के माध्यम से टीएलएस-आधारित बॉट डिटेक्शन को बायपास करें |
+| 🌐 **आईपी फ़िल्टरिंग** | एपीआई अभिगम नियंत्रण के लिए अनुमति सूची/अवरुद्ध सूची |
+| 📊 **संपादन योग्य दर सीमाएँ** | सिस्टम स्तर पर कॉन्फ़िगर करने योग्य आरपीएम, न्यूनतम अंतर और अधिकतम समवर्ती |
+| 🛡 **एपीआई एंडपॉइंट सुरक्षा** | `/models` समापन बिंदु के लिए ऑथेंटिक गेटिंग + प्रदाता अवरोधन |
+| 🔒 **प्रॉक्सी दृश्यता** | रंग-कोडित बैज: 🟢 वैश्विक, 🟡 प्रदाता, 🔵 आईपी डिस्प्ले के साथ प्रति-कनेक्शन |
+| 🌐 **3-स्तरीय प्रॉक्सी कॉन्फ़िगरेशन** | वैश्विक, प्रति-प्रदाता, या प्रति-कनेक्शन स्तर पर प्रॉक्सी कॉन्फ़िगर करें |
+
+### 📊 अवलोकनशीलता और विश्लेषण
+
+| फ़ीचर | यह क्या करता है |
+| ------------------------------- | ------------------------------------------------------------------------------ |
+| 📝 **लॉगिंग का अनुरोध** | पूर्ण अनुरोध/प्रतिक्रिया लॉग के साथ डिबग मोड |
+| 💾 **SQLite प्रॉक्सी लॉग्स** | लगातार प्रॉक्सी लॉग सर्वर पुनरारंभ होने से बचे रहते हैं |
+| 📊 **एनालिटिक्स डैशबोर्ड** | रिचार्ज-संचालित: स्टेट कार्ड, मॉडल उपयोग चार्ट, प्रदाता तालिका |
+| 📈 **प्रगति ट्रैकिंग** | स्ट्रीमिंग के लिए ऑप्ट-इन एसएसई प्रगति कार्यक्रम |
+| 🧪 **एलएलएम मूल्यांकन** | 4 मैच रणनीतियों के साथ गोल्डन सेट परीक्षण |
+| 🔍 **टेलीमेट्री के लिए अनुरोध** | p50/p95/p99 विलंबता एकत्रीकरण + एक्स-अनुरोध-आईडी ट्रेसिंग |
+| 📋 **लॉग्स डैशबोर्ड** | एकीकृत 4-टैब पृष्ठ: अनुरोध लॉग, प्रॉक्सी लॉग, ऑडिट लॉग, कंसोल |
+| 🖥️ **कंसोल लॉग व्यूअर** | लेवल फ़िल्टर, खोज, ऑटो-स्क्रॉल के साथ रीयल-टाइम टर्मिनल-शैली व्यूअर |
+| 📑 **फ़ाइल-आधारित लॉगिंग** | कंसोल इंटरसेप्टर रोटेशन के साथ सभी आउटपुट को JSON लॉग फ़ाइल में कैप्चर करता है |
+| 🏥 **स्वास्थ्य डैशबोर्ड** | सिस्टम अपटाइम, सर्किट ब्रेकर स्थिति, लॉकआउट, कैश आँकड़े |
+| 💰 **लागत ट्रैकिंग** | बजट प्रबंधन + प्रति-मॉडल मूल्य निर्धारण विन्यास |
+
+### ☁️ परिनियोजन और सिंक
+
+| फ़ीचर | यह क्या करता है |
+| ---------------------------- | ---------------------------------------------------------------------------- | ----------------------------- |
+| 💾 **क्लाउड सिंक** | क्लाउडफ्लेयर वर्कर्स के माध्यम से सभी डिवाइसों में कॉन्फिगरेशन सिंक करें |
+| 🌐 **कहीं भी तैनात करें** | लोकलहोस्ट, वीपीएस, डॉकर, क्लाउडफ्लेयर वर्कर्स |
+| 🔑 **एपीआई कुंजी प्रबंधन** | प्रति प्रदाता एपीआई कुंजियाँ उत्पन्न करें, घुमाएँ और स्कोप करें |
+| 🧙 **ऑनबोर्डिंग विज़ार्ड** | पहली बार उपयोगकर्ताओं के लिए 4-चरणीय निर्देशित सेटअप |
+| 🔧 **सीएलआई टूल्स डैशबोर्ड** | क्लाउड, कोडेक्स, क्लाइन, ओपनक्लॉ, किलो, एंटीग्रेविटी | को एक-क्लिक से कॉन्फ़िगर करें |
+| 🔄 **डीबी बैकअप** | सभी सेटिंग्स के लिए स्वचालित बैकअप, पुनर्स्थापना, निर्यात और आयात |
+| 🌐 **अंतर्राष्ट्रीयकरण** | नेक्स्ट-इंटल के साथ पूर्ण i18n - अंग्रेजी + पुर्तगाली (ब्राजील) समर्थन |
+| 🌍 **भाषा चयनकर्ता** | रीयल-टाइम भाषा स्विचिंग के लिए हेडर में ग्लोब आइकन (🇺🇸/🇧🇷) |
+| 📂 **कस्टम डेटा निर्देशिका** | `DATA_DIR` env var डिफ़ॉल्ट `~/.omniroute` संग्रहण पथ को ओवरराइड करने के लिए |
+
+**OMNI_टोकन_248**
+
+📖 सुविधा विवरण
+
+### 🎯 स्मार्ट 4-टियर फ़ॉलबैक
+
+स्वचालित फ़ॉलबैक के साथ कॉम्बो बनाएं:
+
+**OMNI_टोकन_11**
+
+### 📊 रीयल-टाइम कोटा ट्रैकिंग
+
+- प्रति प्रदाता टोकन खपत
+- उलटी गिनती रीसेट करें (5 घंटे, दैनिक, साप्ताहिक)
+- भुगतान किए गए स्तरों के लिए लागत अनुमान
+- मासिक खर्च रिपोर्ट
+
+### 🔄 प्रारूप अनुवाद
+
+प्रारूपों के बीच निर्बाध अनुवाद:
+
+- **ओपनएआई** ↔ **क्लाउड** ↔ **मिथुन** ↔ **ओपनएआई प्रतिक्रियाएं**
+- आपका सीएलआई उपकरण ओपनएआई प्रारूप भेजता है → ओमनीरूट अनुवाद करता है → प्रदाता मूल प्रारूप प्राप्त करता है
+- कस्टम ओपनएआई एंडपॉइंट्स का समर्थन करने वाले किसी भी टूल के साथ काम करता है
+- **प्रतिक्रिया स्वच्छता** - सख्त ओपनएआई एसडीके संगतता के लिए गैर-मानक फ़ील्ड को हटा देता है
+- **भूमिका सामान्यीकरण** - `developer` → गैर-OpenAI के लिए `system`; `system` → GLM/ERNIE मॉडल के लिए `user`
+- **टैग निष्कर्षण के बारे में सोचें** - `` ब्लॉक → सोच मॉडल के लिए `reasoning_content`
+- **संरचित आउटपुट** — `json_schema` → मिथुन राशि का `responseMimeType`/`responseSchema`
+
+### 👥 मल्टी-अकाउंट सपोर्ट
+
+- प्रति प्रदाता एकाधिक खाते जोड़ें
+- ऑटो राउंड-रॉबिन या प्राथमिकता-आधारित रूटिंग
+- कोटा पूरा होने पर अगले खाते में फ़ॉलबैक
+
+### 🔄 ऑटो टोकन रिफ्रेश
+
+- OAuth टोकन समाप्ति से पहले स्वचालित रूप से ताज़ा हो जाते हैं
+- किसी मैन्युअल पुन: प्रमाणीकरण की आवश्यकता नहीं है
+- सभी प्रदाताओं के बीच निर्बाध अनुभव
+
+### 🎨 कस्टम कॉम्बो
+
+- असीमित मॉडल संयोजन बनाएं
+- 6 रणनीतियाँ: पहले भरें, राउंड-रॉबिन, दो-विकल्पों की शक्ति, यादृच्छिक, कम से कम उपयोग, लागत-अनुकूलित
+- क्लाउड सिंक के साथ सभी डिवाइसों पर कॉम्बो साझा करें
+
+### 🏥 स्वास्थ्य डैशबोर्ड
+
+- सिस्टम स्थिति (अपटाइम, संस्करण, मेमोरी उपयोग)
+- प्रति प्रदाता सर्किट ब्रेकर की स्थिति (बंद/खुला/आधा खुला)
+- दर सीमा स्थिति और सक्रिय तालाबंदी
+- हस्ताक्षर कैश आँकड़े
+- विलंबता टेलीमेट्री (p50/p95/p99) + शीघ्र कैश
+- एक क्लिक से स्वास्थ्य स्थिति रीसेट करें
+
+### 🔧 अनुवादक खेल का मैदान
+
+ओमनीरूट में डिबगिंग, परीक्षण और एपीआई अनुवादों की निगरानी के लिए **4 मोड** के साथ एक शक्तिशाली अंतर्निहित अनुवादक खेल का मैदान शामिल है:
+
+| मोड | विवरण |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻खेल का मैदान** | प्रत्यक्ष प्रारूप अनुवाद - किसी भी एपीआई अनुरोध निकाय को पेस्ट करें और तुरंत देखें कि ओम्नीरूट प्रदाता प्रारूपों (ओपनएआई ↔ क्लाउड ↔ जेमिनी ↔ रिस्पॉन्स एपीआई) के बीच इसका अनुवाद कैसे करता है। उदाहरण टेम्प्लेट और प्रारूप ऑटो-डिटेक्शन शामिल है। |
+| **💬 चैट परीक्षक** | ओम्निरूट के माध्यम से वास्तविक चैट अनुरोध भेजें और पूरी राउंड-ट्रिप देखें: आपका इनपुट, अनुवादित अनुरोध, प्रदाता प्रतिक्रिया, और अनुवादित प्रतिक्रिया वापस। कॉम्बो रूटिंग को मान्य करने के लिए अमूल्य। |
+| **🧪 टेस्ट बेंच** | बैच परीक्षण मोड - विभिन्न इनपुट और अपेक्षित आउटपुट के साथ कई परीक्षण मामलों को परिभाषित करें, उन सभी को एक साथ चलाएं, और प्रदाताओं और मॉडलों के परिणामों की तुलना करें। |
+| **📱लाइव मॉनिटर** | वास्तविक समय अनुरोध की निगरानी - आने वाले अनुरोधों को ओम्नीरूट के माध्यम से प्रवाहित होते हुए देखें, प्रारूप अनुवाद को लाइव होते हुए देखें, और समस्याओं की तुरंत पहचान करें। |
+
+**पहुँच:** डैशबोर्ड → अनुवादक (साइडबार)
+
+### 💾 क्लाउड सिंक
+
+- सभी डिवाइसों में सिंक प्रदाता, कॉम्बो और सेटिंग्स
+- स्वचालित पृष्ठभूमि सिंक
+- सुरक्षित एन्क्रिप्टेड भंडारण
+
+**OMNI_टोकन_253**
+
+---
+
+## 📖 सेटअप गाइड
+
+**OMNI_टोकन_254**
+
+💳 सदस्यता प्रदाता
+
+### क्लाउड कोड (प्रो/मैक्स)
+
+**OMNI_टोकन_12**
+
+**प्रो टिप:** जटिल कार्यों के लिए ओपस और गति के लिए सॉनेट का उपयोग करें। ओमनीरूट प्रति मॉडल कोटा ट्रैक करता है!
+
+### ओपनएआई कोडेक्स (प्लस/प्रो)
+
+**OMNI_टोकन_13**
+
+### जेमिनी सीएलआई (मुफ़्त 180K/माह!)
+
+**OMNI_टोकन_14**
+
+**सर्वोत्तम मूल्य:** विशाल निःशुल्क स्तर! सशुल्क स्तरों से पहले इसका उपयोग करें।
+
+### गिटहब कोपायलट
+
+**OMNI_टोकन_15**
+
+**OMNI_टोकन_259**
+
+
+🔑 API कुंजी प्रदाता
+
+### एनवीडिया एनआईएम (मुफ़्त 1000 क्रेडिट!)
+
+1. साइन अप करें: [build.nvidia.com](https://build.nvidia.com)
+2. निःशुल्क एपीआई कुंजी प्राप्त करें (1000 अनुमान क्रेडिट शामिल)
+3. डैशबोर्ड → प्रदाता जोड़ें → एनवीडिया एनआईएम:
+ - एपीआई कुंजी: `nvapi-your-key`
+
+**मॉडल:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct`, और 50+ अधिक
+
+**प्रो टिप:** ओपनएआई-संगत एपीआई - ओमनीरूट के प्रारूप अनुवाद के साथ सहजता से काम करता है!
+
+### डीपसीक
+
+1. साइन अप करें: [platform.deepseek.com](https://platform.deepseek.com)
+2. एपीआई कुंजी प्राप्त करें
+3. डैशबोर्ड → प्रदाता जोड़ें → डीपसीक
+
+**मॉडल:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### ग्रोक (निःशुल्क टियर उपलब्ध!)
+
+1. साइन अप करें: [console.groq.com](https://console.groq.com)
+2. एपीआई कुंजी प्राप्त करें (फ्री टियर शामिल)
+3. डैशबोर्ड → प्रदाता जोड़ें → ग्रोक
+
+**मॉडल:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**प्रो टिप:** अल्ट्रा-फास्ट अनुमान - वास्तविक समय कोडिंग के लिए सर्वोत्तम!
+
+### ओपनराउटर (100+ मॉडल)
+
+1. साइन अप करें: [openrouter.ai](https://openrouter.ai)
+2. एपीआई कुंजी प्राप्त करें
+3. डैशबोर्ड → प्रदाता जोड़ें → ओपनराउटर
+
+**मॉडल:** एक ही एपीआई कुंजी के माध्यम से सभी प्रमुख प्रदाताओं से 100+ मॉडल तक पहुंचें।
+
+**OMNI_टोकन_265**
+
+**OMNI_टोकन_266**
+
+💰 सस्ते प्रदाता (बैकअप)
+
+### GLM-4.7 (दैनिक रीसेट, $0.6/1 मिलियन)
+
+1. साइन अप करें: [Zhipu AI](https://open.bigmodel.cn/)
+2. कोडिंग योजना से एपीआई कुंजी प्राप्त करें
+3. डैशबोर्ड → एपीआई कुंजी जोड़ें:
+ - प्रदाता: `glm`
+ - एपीआई कुंजी: `your-key`
+
+**उपयोग करें:** `glm/glm-4.7`
+
+**प्रो टिप:** कोडिंग प्लान 1/7 लागत पर 3× कोटा प्रदान करता है! प्रतिदिन सुबह 10:00 बजे रीसेट करें।
+
+### मिनीमैक्स एम2.1 (5 घंटे रीसेट, $0.20/1 मिलियन)
+
+1. साइन अप करें: [MiniMax](https://www.minimax.io/)
+2. एपीआई कुंजी प्राप्त करें
+3. डैशबोर्ड → एपीआई कुंजी जोड़ें
+
+**उपयोग:** `minimax/MiniMax-M2.1`
+
+**प्रो टिप:** लंबे संदर्भ के लिए सबसे सस्ता विकल्प (1M टोकन)!
+
+### किमी K2 ($9/माह फ्लैट)
+
+1. सदस्यता लें: [Moonshot AI](https://platform.moonshot.ai/)
+2. एपीआई कुंजी प्राप्त करें
+3. डैशबोर्ड → एपीआई कुंजी जोड़ें
+
+**उपयोग करें:** `kimi/kimi-latest`
+
+**प्रो टिप:** 10एम टोकन के लिए निश्चित $9/माह = $0.90/1एम प्रभावी लागत!
+
+**OMNI_टोकन_271**
+
+**OMNI_टोकन_272**
+
+🆓 मुफ़्त प्रदाता (आपातकालीन बैकअप)
+
+### आईफ्लो (8 मुफ़्त मॉडल)
+
+**OMNI_टोकन_16**
+
+### क्वेन (3 मुफ़्त मॉडल)
+
+**OMNI_टोकन_17**
+
+### किरो (क्लाउड फ्री)
+
+**OMNI_टोकन_18**
+
+**OMNI_टोकन_277**
+
+**OMNI_टोकन_278**
+
+🎨 कॉम्बो बनाएं
+
+### उदाहरण 1: सदस्यता अधिकतम करें → सस्ता बैकअप
+
+**OMNI_टोकन_19**
+
+### उदाहरण 2: केवल निःशुल्क (शून्य लागत)
+
+```
+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!
+```
+
+**OMNI_टोकन_283**
+
+**OMNI_टोकन_284**
+
+🔧 CLI एकीकरण
+
+### कर्सर आईडीई
+
+**OMNI_टोकन_21**
+
+### क्लाउड कोड
+
+एक-क्लिक कॉन्फ़िगरेशन के लिए डैशबोर्ड में **CLI टूल्स** पृष्ठ का उपयोग करें, या `~/.claude/settings.json` को मैन्युअल रूप से संपादित करें।
+
+### कोडेक्स सीएलआई
+
+**OMNI_टोकन_22**
+
+### ओपनक्लॉ
+
+**विकल्प 1 - डैशबोर्ड (अनुशंसित):**
+
+**OMNI_टोकन_23**
+
+**विकल्प 2 - मैनुअल:** संपादित करें `~/.openclaw/openclaw.json`:
+
+**OMNI_टोकन_24**
+
+> **ध्यान दें:** ओपनक्लाव केवल स्थानीय ओमनीरूट के साथ काम करता है। IPv6 रिज़ॉल्यूशन समस्याओं से बचने के लिए `localhost` के बजाय `127.0.0.1` का उपयोग करें।
+
+### क्लाइन / जारी रखें / रूकोड
+
+**OMNI_टोकन_25**
+
+**OMNI_टोकन_289**
+
+---
+
+## 📊 उपलब्ध मॉडल
+
+
+सभी उपलब्ध मॉडल देखें
+
+**क्लाउड कोड (`cc/`)** - प्रो/मैक्स:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**कोडेक्स (`cx/`)** - प्लस/प्रो:
+
+- **OMNI_टोकन_84**
+- `cx/gpt-5.1-codex-max`
+
+**मिथुन सीएलआई (`gc/`)** - मुफ़्त:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**गिटहब कोपायलट (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**एनवीडिया एनआईएम (`nvidia/`)** - मुफ़्त क्रेडिट:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- [build.nvidia.com](https://build.nvidia.com) पर 50+ अधिक मॉडल
+
+**जीएलएम (`glm/`)** - $0.6/1M:
+
+- `glm/glm-4.7`
+
+**मिनीमैक्स (`minimax/`)** - $0.2/1M:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - मुफ़्त:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**क्वेन (`qw/`)** - मुफ़्त:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**किरो (`kr/`)** - मुफ़्त:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**ओपनराउटर (`or/`)** - 100+ मॉडल:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- [openrouter.ai/models](https://openrouter.ai/models) से कोई भी मॉडल
+
+**OMNI_टोकन_295**
+
+---
+
+## 🧪 मूल्यांकन (Evaluations)
+
+ओमनीरूट में गोल्डन सेट के मुकाबले एलएलएम प्रतिक्रिया गुणवत्ता का परीक्षण करने के लिए एक अंतर्निहित मूल्यांकन ढांचा शामिल है। डैशबोर्ड में **एनालिटिक्स → इवेल्स** के माध्यम से इसे एक्सेस करें।
+
+### बिल्ट-इन गोल्डन सेट
+
+प्री-लोडेड "ओम्नीरूट गोल्डन सेट" में 10 परीक्षण मामले शामिल हैं:
+
+- नमस्ते, गणित, भूगोल, कोड जनरेशन
+- JSON प्रारूप अनुपालन, अनुवाद, मार्कडाउन
+- सुरक्षा इनकार (हानिकारक सामग्री), गिनती, बूलियन तर्क
+
+### मूल्यांकन रणनीतियाँ
+
+| रणनीति | विवरण | उदाहरण |
+| ---------- | ------------------------------------------------- | -------------------------------- |
+| `exact` | आउटपुट बिल्कुल मेल खाना चाहिए | `"4"` |
+| `contains` | आउटपुट में सबस्ट्रिंग (केस-असंवेदनशील) होना चाहिए | `"Paris"` |
+| `regex` | आउटपुट रेगेक्स पैटर्न से मेल खाना चाहिए | `"1.*2.*3"` |
+| `custom` | कस्टम जेएस फ़ंक्शन सही/गलत लौटाता है | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em सर्विडोर रेमोटो (रिमोट OAuth सेटअप)
+
+
+
+> **⚠️ वीपीएस/डॉकर/सर्विडोर रिमोट पर ओमनीरूट का उपयोग करने के लिए महत्वपूर्ण**
+
+### क्या आप एंटीग्रेविटी/जेमिनी सीएलआई के लिए OAuth का उपयोग कर रहे हैं?
+
+प्रमाणित करने के लिए **एंटीग्रेविटी** और **मिथुन सीएलआई** का उपयोग करें **Google OAuth 2.0** का उपयोग करें। Google के लिए यह आवश्यक है कि `redirect_uri` का उपयोग बिना किसी प्रवाह के OAuth सेजा **exatamente** के माध्यम से किया जाए ताकि URIs को Google क्लाउड कंसोल के लिए पूर्व-आवेदन किया जा सके।
+
+जैसा कि OAuth का प्रमाण है, कोई ओम्निरूट कैडस्ट्राड नहीं है ** `localhost`** के लिए एपेनास। एक सर्विडोर रिमोट (उदा: `https://omniroute.meuservidor.com`) पर ओमनीरूट का उपयोग कैसे करें, या Google एक प्रमाणीकरण कॉम को पुनः प्राप्त करता है:
+
+**OMNI_टोकन_26**
+
+### समाधान: OAuth को कॉन्फ़िगर करें
+
+आपका सटीक विवरण **OAuth 2.0 क्लाइंट आईडी** आपके सर्वर पर यूआरआई के साथ Google क्लाउड कंसोल नहीं है।
+
+#### पासो ए पासो
+
+**1. Google क्लाउड कंसोल तक पहुंच**
+
+अब्राहम: [https://console.cloud.google.com/apis/credentials](https://console.cloud.google.com/apis/credentials)
+
+**2. नया OAuth 2.0 क्लाइंट आईडी देखें**
+
+- उन्हें क्लिक करें **"+ क्रेडेंशियल बनाएं"** → **"OAuth क्लाइंट आईडी"**
+- आवेदन टिप: **"वेब एप्लिकेशन"**
+- नोम: एस्कोल्हा क्वाल्कर नोम (उदा: `OmniRoute Remote`)
+
+**3. अधिकृत रीडायरेक्ट यूआरआई के रूप में एडिकियोन**
+
+कोई शिकायत नहीं **"अधिकृत रीडायरेक्ट यूआरआई"**, आदि:
+
+```
+https://seu-servidor.com/callback
+```
+
+> स्थानापन्न `seu-servidor.com` अपने आईपी को अपने सर्वर पर रखें (इसमें एक आवश्यक पोर्ट भी शामिल है, उदाहरण के लिए: `http://45.33.32.156:20128/callback`)।
+
+**4. साख के रूप में सहेजें और कॉपी करें**
+
+एपोस क्रियर, Google द्वारा **क्लाइंट आईडी** और **क्लाइंट सीक्रेट**।
+
+**5. परिवेश परिवर्तन** के रूप में कॉन्फ़िगर करें
+
+कोई `.env` नहीं (आप डॉकर के परिवेश को कैसे बदल सकते हैं):
+
+```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. ओम्निरूट का नवीनीकरण**
+
+```bash
+# Se usando npm:
+npm run dev
+
+# Se usando Docker:
+docker restart omniroute
+```
+
+**7. नए सिरे से संपर्क करें**
+
+डैशबोर्ड → प्रदाता → एंटीग्रेविटी (या जेमिनी सीएलआई) → OAuth
+
+`https://seu-servidor.com/callback` और एक प्रमाणीकरण कार्य के लिए Google पुनर्निर्देशन।
+
+---
+
+### वर्कअराउंड टेम्पोरैरियो (सेम कॉन्फिगरेशन क्रेडेंशियल प्रोप्रियास)
+
+यदि आप पहले से ही उचित क्रेडेंशियल प्राप्त नहीं करना चाहते हैं, तो आपके लिए फ्लक्सो का उपयोग करना संभव है **यूआरएल का मैनुअल**:
+
+1. Google पर स्वचालित URL का उपयोग करके ओम्निरूट का उपयोग करें
+2. ऑटोरिज़ार का लाभ, `localhost` के लिए Google पुनर्निर्देशन (यदि कोई सर्वर रिमोट नहीं है)
+3. **एक यूआरएल को पूरा कॉपी करें** अपने ब्राउजर से दोबारा डाउनलोड करें (मुझे लगता है कि एक पेज अभी भी उपलब्ध है)
+4. ओम्निरूट से जुड़ने के लिए कोई भी यूआरएल नहीं है
+5. उन्हें क्लिक करें **"कनेक्ट"**
+
+> यह समाधान यूआरएल को स्वचालित रूप से डाउनलोड करने के लिए काम कर रहा है और आपके द्वारा किए गए रीडायरेक्ट को स्वतंत्र रूप से वैध बनाता है।
+
+---
+
+## 🐛 समस्या निवारण
+
+**OMNI_टोकन_298**
+
+समस्या निवारण मार्गदर्शिका का विस्तार करने के लिए क्लिक करें
+
+**"भाषा मॉडल ने संदेश प्रदान नहीं किया"**
+
+- प्रदाता कोटा समाप्त → डैशबोर्ड कोटा ट्रैकर की जाँच करें
+- समाधान: कॉम्बो फ़ॉलबैक का उपयोग करें या सस्ते स्तर पर स्विच करें
+
+**दर सीमित करना**
+
+- सदस्यता कोटा ख़त्म → GLM/MiniMax पर फ़ॉलबैक
+- कॉम्बो जोड़ें: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**OAuth टोकन समाप्त हो गया**
+
+- ओम्निरूट द्वारा स्वतः ताज़ा
+- यदि समस्या बनी रहती है: डैशबोर्ड → प्रदाता → पुनः कनेक्ट करें
+
+**उच्च लागत**
+
+- डैशबोर्ड → लागत में उपयोग के आँकड़े जाँचें
+- प्राथमिक मॉडल को जीएलएम/मिनीमैक्स पर स्विच करें
+- गैर-महत्वपूर्ण कार्यों के लिए फ्री टियर (मिथुन सीएलआई, आईफ्लो) का उपयोग करें
+
+**डैशबोर्ड गलत पोर्ट पर खुलता है**
+
+- `PORT=20128` और `NEXT_PUBLIC_BASE_URL=http://localhost:20128` सेट करें
+
+**क्लाउड सिंक त्रुटियाँ**
+
+- अपने चल रहे उदाहरण के लिए `BASE_URL` अंक सत्यापित करें
+- अपने अपेक्षित क्लाउड एंडपॉइंट पर `CLOUD_URL` पॉइंट सत्यापित करें
+- `NEXT_PUBLIC_*` मानों को सर्वर-साइड मानों के साथ संरेखित रखें
+
+**पहला लॉगिन काम नहीं कर रहा**
+
+- `.env` में `INITIAL_PASSWORD` को जांचें
+- यदि सेट नहीं है, तो फ़ॉलबैक पासवर्ड `123456` है
+
+**कोई अनुरोध लॉग नहीं**
+
+- `.env` में `ENABLE_REQUEST_LOGS=true` सेट करें
+
+**कनेक्शन परीक्षण OpenAI-संगत प्रदाताओं के लिए "अमान्य" दिखाता है**
+
+- कई प्रदाता `/models` समापन बिंदु को उजागर नहीं करते हैं
+- ओमनीरूट v1.0.6+ में चैट पूर्णता के माध्यम से फ़ॉलबैक सत्यापन शामिल है
+- सुनिश्चित करें कि आधार URL में `/v1` प्रत्यय शामिल हो
+
+**OMNI_टोकन_303**
+
+---
+
+## 🛠️ टेक स्टैक
+
+- **रनटाइम**: Node.js 18–22 LTS (⚠️ Node.js 24+ **समर्थित नहीं** है - `better-sqlite3` मूल बायनेरिज़ असंगत हैं)
+- **भाषा**: टाइपस्क्रिप्ट 5.9 - **100% टाइपस्क्रिप्ट** `src/` और `open-sse/` (v1.0.6) में
+- **फ्रेमवर्क**: नेक्स्ट.जेएस 16 + रिएक्ट 19 + टेलविंड सीएसएस 4
+- **डेटाबेस**: लोडीबी (JSON) + SQLite (डोमेन स्थिति + प्रॉक्सी लॉग)
+- **स्ट्रीमिंग**: सर्वर-भेजे गए इवेंट (एसएसई)
+- **प्रामाणिक**: OAuth 2.0 (PKCE) + JWT + API कुंजियाँ
+- **परीक्षण**: Node.js परीक्षण धावक (368+ इकाई परीक्षण)
+- **सीआई/सीडी**: गिटहब क्रियाएँ (ऑटो एनपीएम प्रकाशन + रिलीज पर डॉकर हब)
+- **वेबसाइट**: [omniroute.online](https://omniroute.online)
+- **पैकेज**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **डॉकर**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **लचीलापन**: सर्किट ब्रेकर, एक्सपोनेंशियल बैकऑफ़, एंटी-थंडरिंग झुंड, टीएलएस स्पूफिंग
+
+---
+
+## 📖 दस्तावेज़ीकरण
+
+| दस्तावेज़ | विवरण |
+| -------------------------------------------- | ------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md) | प्रदाता, कॉम्बो, सीएलआई एकीकरण, तैनाती |
+| [API Reference](docs/API_REFERENCE.md) | उदाहरण सहित सभी समापन बिंदु |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | सामान्य समस्याएँ एवं समाधान |
+| [Architecture](docs/ARCHITECTURE.md) | सिस्टम आर्किटेक्चर और आंतरिक |
+| [Contributing](CONTRIBUTING.md) | विकास सेटअप और दिशानिर्देश |
+| [OpenAPI Spec](docs/openapi.yaml) | ओपनएपीआई 3.0 विशिष्टता |
+| [Security Policy](SECURITY.md) | भेद्यता रिपोर्टिंग और सुरक्षा प्रथाएं |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | संपूर्ण गाइड: VM + nginx + Cloudflare सेटअप |
+| [Features Gallery](docs/FEATURES.md) | स्क्रीनशॉट के साथ विजुअल डैशबोर्ड टूर |
+
+### 📸 डैशबोर्ड पूर्वावलोकन
+
+**OMNI_टोकन_304**
+
+डैशबोर्ड स्क्रीनशॉट देखने के लिए क्लिक करें
+
+| पेज | स्क्रीनशॉट |
+| ----------------- | ------------------------------------------------- |
+| **प्रदाता** |  |
+| **कॉम्बोस** |  |
+| **एनालिटिक्स** |  |
+| **स्वास्थ्य** |  |
+| **अनुवादक** |  |
+| **सेटिंग्स** |  |
+| **सीएलआई उपकरण** |  |
+| **उपयोग लॉग** |  |
+| **समाप्ति बिंदु** |  |
+
+**OMNI_टोकन_309**
+
+---
+
+## 🗺️ रोडमैप
+
+ओम्निरूट ने कई विकास चरणों में **210+ सुविधाओं की योजना बनाई है**। यहां प्रमुख क्षेत्र हैं:
+
+| श्रेणी | नियोजित विशेषताएं | हाइलाइट्स |
+| --------------------------- | ----------------- | ------------------------------------------------------------------------------------------- |
+| 🧠 **रूटिंग और इंटेलिजेंस** | 25+ | न्यूनतम-विलंबता रूटिंग, टैग-आधारित रूटिंग, कोटा प्रीफ़्लाइट, पी2सी खाता चयन |
+| 🔒 **सुरक्षा एवं अनुपालन** | 20+ | एसएसआरएफ हार्डनिंग, क्रेडेंशियल क्लोकिंग, प्रति समापन बिंदु दर-सीमा, प्रबंधन कुंजी स्कोपिंग |
+| 📊 **अवलोकनशीलता** | 15+ | ओपन टेलीमेट्री एकीकरण, वास्तविक समय कोटा निगरानी, प्रति मॉडल लागत ट्रैकिंग |
+| 🔄 **प्रदाता एकीकरण** | 20+ | डायनेमिक मॉडल रजिस्ट्री, प्रदाता कूलडाउन, मल्टी-अकाउंट कोडेक्स, कोपायलट कोटा पार्सिंग |
+| ⚡ **प्रदर्शन** | 15+ | दोहरी कैश परत, शीघ्र कैश, प्रतिक्रिया कैश, स्ट्रीमिंग कीपलाइव, बैच एपीआई |
+| 🌐 **पारिस्थितिकी तंत्र** | 10+ | वेबसॉकेट एपीआई, कॉन्फिग हॉट-रीलोड, वितरित कॉन्फिग स्टोर, वाणिज्यिक मोड |
+
+### 🔜 जल्द आ रहा है
+
+- 🔗 **ओपनकोड इंटीग्रेशन** - ओपनकोड एआई कोडिंग आईडीई के लिए मूल प्रदाता समर्थन
+- 🔗 **TRAE एकीकरण** - TRAE AI विकास ढांचे के लिए पूर्ण समर्थन
+- 📦 **बैच एपीआई** - थोक अनुरोधों के लिए अतुल्यकालिक बैच प्रोसेसिंग
+- 🎯 **टैग-आधारित रूटिंग** - कस्टम टैग और मेटाडेटा के आधार पर रूट अनुरोध
+- 💰 **न्यूनतम-लागत रणनीति** — स्वचालित रूप से सबसे सस्ते उपलब्ध प्रदाता का चयन करें
+
+> 📝 पूर्ण फीचर विशिष्टताएं [**OMNI_TOKEN_147**](docs/new-features/) में उपलब्ध हैं (217 विस्तृत विवरण)
+
+---
+
+## 📧समर्थन
+
+> 💬 **हमारे समुदाय में शामिल हों!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) - सहायता प्राप्त करें, सुझाव साझा करें और अपडेट रहें।
+
+- **वेबसाइट**: [omniroute.online](https://omniroute.online)
+- **गिटहब**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **मुद्दे**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **व्हाट्सएप**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **मूल परियोजना**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 योगदानकर्ता
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### योगदान कैसे करें
+
+1. रिपॉजिटरी को फोर्क करें
+2. अपनी फीचर शाखा बनाएं (`git checkout -b feature/amazing-feature`)
+3. अपने परिवर्तन प्रतिबद्ध करें (`git commit -m 'Add amazing feature'`)
+4. शाखा में पुश करें (`git push origin feature/amazing-feature`)
+5. एक पुल अनुरोध खोलें
+
+विस्तृत दिशानिर्देशों के लिए [CONTRIBUTING.md](CONTRIBUTING.md) देखें।
+
+### एक नया संस्करण जारी करना
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 सितारा इतिहास
+
+
+ __OMNI_टोकन_311__
+ __OMNI_टोकन_312__
+ __OMNI_टोकन_313__
+ __OMNI_टोकन_239__
+ __OMNI_टोकन_314__
+
+
+---
+
+## 🙏 आभार
+
+**[decolua](https://github.com/decolua)** द्वारा **[decolua](https://github.com/decolua)** को विशेष धन्यवाद - मूल परियोजना जिसने इस फोर्क को प्रेरित किया। ओमनीरूट अतिरिक्त सुविधाओं, मल्टी-मोडल एपीआई और पूर्ण टाइपस्क्रिप्ट पुनर्लेखन के साथ उस अविश्वसनीय नींव पर आधारित है।
+
+**[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** को विशेष धन्यवाद - मूल गो कार्यान्वयन जिसने इस जावास्क्रिप्ट पोर्ट को प्रेरित किया।
+
+---
+
+## 📄 लाइसेंस
+
+एमआईटी लाइसेंस - विवरण के लिए [LICENSE](LICENSE) देखें।
+
+---
+
+---
+
+## 🇧🇷 ओमनीरूट - गेटवे डी आईए ग्रैटुइटो
+
+
+
+### नूनका पारे डे कोडर। रोटेमेंटो इंटेलिजेंट पैरा **मॉडलोस डी आईए ग्रैटुइटोस और डे बैक्सो कस्टम** कॉम फ़ॉलबैक ऑटोमेटिको।
+
+_एसईयू प्रॉक्सी यूनिवर्सल डी एपीआई - उम एंडपॉइंट, 36+ प्रोडोर्स, शून्य डाउनटाइम।_
+
+### 🌐 इंटरनेशनलिज़ाकाओ (i18n)
+
+ओम्नीरूट का डैशबोर्ड **मल्टीप्लोस इडियोमास** का समर्थन करता है। उन्हें वास्तविक वितरण:
+
+| मुहावरा | कोडिगो | स्थिति |
+| ----------------------- | ------- | ----------- |
+| 🇺🇸 अंग्रेजी | `en` | ✅ कंप्लीटो |
+| 🇧🇷 पोर्टुगुएस (ब्राजील) | `pt-BR` | ✅ कंप्लीटो |
+
+**मुहावरे के बारे में जानकारी:** मुहावरे के चयन पर क्लिक करें (🇺🇸 EN) डैशबोर्ड पर कोई हेडर नहीं → वाक्यांश के चयन के बारे में क्लिक करें।
+
+**एक नया मुहावरा जोड़ने के लिए:**
+
+1. `src/i18n/messages/{codigo}.json` को `en.json` पर आधारित करें
+2. `src/i18n/config.ts` → `LOCALES` और `LANGUAGES` कोड का उपयोग
+3. सेवा प्रदाता की सेवा
+
+### ⚡ इनिसियो रैपिडो
+
+```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
+```
+
+### 🐳 डॉकर
+
+```bash
+docker run -d --name omniroute -p 20128:20128 diegosouzapw/omniroute:latest
+```
+
+### 🔑 फंक्सोनियलिडेड्स प्रिंसिपैस
+
+- **36+ आईए** - क्लाउड, जीपीटी, जेमिनी, लामा, क्वेन, डीपसीक, और अन्य
+- **रोटीमेंटो इंटेलिजेंट** — फ़ॉलबैक ऑटोमेटिको एंटर प्रोवोर्स
+- **प्रारूप अनुवाद** — OpenAI ↔ क्लाउड ↔ जेमिनी ऑटोमैटिक
+- **मल्टी-कॉन्टा** - चयनित इंटेलिजेंट के लिए मल्टीप्लास कॉन्टास
+- **कैश सिमेंटिको** - कस्टम और लेटेंसी रेडुज़
+- **OAuth automático** — टोकन स्वचालित रूप से नवीनीकृत होते हैं
+- **व्यक्तिगत संयोजन** — 6 रोटेमेंटो एस्ट्रैटेजीस
+- **डैशबोर्ड संपूर्ण** - मॉनिटर, लॉग, विश्लेषण, कॉन्फ़िगरेशन
+- **सीएलआई उपकरण** - क्लाउड कोड, कोडेक्स, कर्सर, क्लाइन को एक क्लिक पर कॉन्फ़िगर करें
+- **100% टाइपस्क्रिप्ट** — कोडिगो लिम्पो और टिपडो
+
+### 📖 दस्तावेज़ीकरण
+
+| डॉक्यूमेंटो | विवरण |
+| ----------------------------------------------- | --------------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md) | प्रोवेडोर्स, कॉम्बो, सीएलआई, तैनाती |
+| [Referência da API](docs/API_REFERENCE.md) | सभी ओएस एंडपॉइंट उदाहरण उदाहरण |
+| [Solução de Problemas](docs/TROUBLESHOOTING.md) | समस्याएं और समाधान |
+| [Arquitetura](docs/ARCHITECTURE.md) | आर्किटेक्चर और इंटर्नोस डो सिस्तेमा |
+| [Contribuição](CONTRIBUTING.md) | सेटअप डे डेसेनवोल्विमेंटो ई दिशानिर्देश |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | संपूर्ण मार्गदर्शिका: VM + nginx + Cloudflare |
+
+### 📧 सपोर्ट
+
+> 💬 **एक अधिसूचना के लिए प्रवेश!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — दो सप्ताह, पूर्ण विवरण और पूर्ण विवरण।
+
+- **वेबसाइट**: [omniroute.online](https://omniroute.online)
+- **गिटहब**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **मुद्दे**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+**OMNI_टोकन_318**
+24/7 कोड करने वाले डेवलपर्स के लिए ❤️ के साथ निर्मित
+**OMNI_टोकन_321**
+omniroute.online
+**OMNI_टोकन_326**
diff --git a/README.it.md b/README.it.md
index 2eb09dc4ef..fd1897b46f 100644
--- a/README.it.md
+++ b/README.it.md
@@ -104,7 +104,7 @@ _Connetti qualsiasi IDE o strumento CLI con IA tramite OmniRoute — gateway API
[🌐 Sito Web](https://omniroute.online) • [🚀 Avvio Rapido](#-avvio-rapido) • [💡 Funzionalità](#-funzionalità-principali) • [📖 Docs](#-documentazione) • [💰 Prezzi](#-panoramica-prezzi)
-🌐 **Disponibile in:** [English](README.md) | [Português](README.pt-BR.md) | [Español](README.es.md) | [Русский](README.ru.md) | [中文](README.zh-CN.md) | [Deutsch](README.de.md) | [Français](README.fr.md) | [Italiano](README.it.md)
+🌐 **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)
diff --git a/README.ja.md b/README.ja.md
new file mode 100644
index 0000000000..acdf300075
--- /dev/null
+++ b/README.ja.md
@@ -0,0 +1,1152 @@
+
+
+
+ # 🚀 OmniRoute — 무료 AI 게이트웨이
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### 코딩을 멈추지 마세요. 자동 폴백을 통해 **무료 및 저가형 AI 모델**로 스마트 라우팅합니다.
+
+_범용 API 프록시 — 하나의 엔드포인트, 36개 이상의 공급자, 가동 중지 시간 없음._
+
+**채팅 완료 • 임베딩 • 이미지 생성 • 오디오 • 순위 재지정 • 100% TypeScript**
+
+---
+
+### 🤖 좋아하는 코딩 에이전트를 위한 무료 AI 제공업체
+
+_무제한 코딩을 위한 무료 API 게이트웨이인 OmniRoute를 통해 AI 기반 IDE 또는 CLI 도구를 연결하세요._
+
+
+
+
+ # 🚀 OmniRoute — Gerbang AI Percuma
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Jangan sekali-kali berhenti mengekod. Penghalaan pintar ke **model AI PERCUMA & kos rendah** dengan sandaran automatik.
+
+_Proksi API universal anda — satu titik akhir, 36+ pembekal, masa henti sifar._
+
+**Penyelesaian Sembang • Pembenaman • Penjanaan Imej • Audio • Kedudukan Semula • 100% TypeScript**
+
+---
+
+### 🤖 Pembekal AI percuma untuk ejen pengekodan kegemaran anda
+
+_Sambungkan mana-mana alat IDE atau CLI berkuasa AI melalui OmniRoute — get laluan API percuma untuk pengekodan tanpa had._
+
+
+
+---
+
+## 🤔 Hvorfor OmniRoute?
+
+**Slutt å kaste bort penger og nå grensene:**
+
+- Abonnementskvoten utløper ubrukt hver måned
+- Takstgrenser stopper deg med midtkoding
+- Dyre APIer ($20–50/måned per leverandør)
+- Manuell veksling mellom tilbydere
+
+**OmniRoute løser dette:**
+
+- ✅ **Maksimer abonnementer** - Spor kvote, bruk hver bit før tilbakestilling
+- ✅ **Automatisk fallback** - Abonnement → API-nøkkel → Billig → Gratis, null nedetid
+- ✅ **Multi-konto** - Round-robin mellom kontoer per leverandør
+- ✅ **Universal** - Fungerer med Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, hvilket som helst CLI-verktøy
+
+---
+
+## 🔄 Hvordan det fungerer
+
+```
+┌─────────────┐
+│ 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
+```
+
+---
+
+## ⚡ Hurtigstart
+
+**1. Installer globalt:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Dashboard åpner kl. `http://localhost:20128`
+
+| Kommando | Beskrivelse |
+| ----------------------- | ---------------------------------- |
+| `omniroute` | Start server (standard port 20128) |
+| `omniroute --port 3000` | Bruk tilpasset port |
+| `omniroute --no-open` | Ikke åpne nettleseren automatisk |
+| `omniroute --help` | Vis hjelp |
+
+**2. Koble til en GRATIS leverandør:**
+
+Dashboard → Leverandører → Koble til **Claude-kode** eller **Antigravity** → OAuth-pålogging → Ferdig!
+
+**3. Bruk i CLI-verktøyet:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copy from dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**Det var det!** Begynn å kode med GRATIS AI-modeller.
+
+**Alternativt – kjør fra kilden:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Docker
+
+OmniRoute er tilgjengelig som et offentlig Docker-bilde på [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Rask løp:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**Med miljøfil:**
+
+```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
+```
+
+**Bruke Docker Compose:**
+
+```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
+```
+
+| Bilde | Tag | Størrelse | Beskrivelse |
+| ------------------------ | -------- | --------- | ----------------------- |
+| `diegosouzapw/omniroute` | `latest` | ~250MB | Siste stabile utgivelse |
+| `diegosouzapw/omniroute` | `1.0.3` | ~250MB | Gjeldende versjon |
+
+---
+
+## 💰 Priser på et øyeblikk
+
+| Nivå | Leverandør | Kostnad | Kvote Tilbakestill | Best for |
+| ----------------- | ----------------- | ----------------------------- | ----------------------- | -------------------- |
+| **💳 ABONNEMENT** | Claude Code (Pro) | $20/md | 5t + ukentlig | Allerede abonnert |
+| | Codex (Pluss/Pro) | $20-200/md | 5t + ukentlig | OpenAI-brukere |
+| | Gemini CLI | **GRATIS** | 180K/mnd + 1K/dag | Alle sammen! |
+| | GitHub Copilot | $10-19/md | Månedlig | GitHub-brukere |
+| **🔑 API NØKKEL** | NVIDIA NIM | **GRATIS** (1000 studiepoeng) | Engangs | Gratis tier testing |
+| | DeepSeek | Betal per bruk | Ingen | Beste pris/kvalitet |
+| | Groq | Gratis lag + betalt | Begrenset pris | Ultrarask slutning |
+| | xAI (Grok) | Betal per bruk | Ingen | Grok modeller |
+| | Mistral | Gratis lag + betalt | Begrenset pris | Europeisk AI |
+| | OpenRouter | Betal per bruk | Ingen | 100+ modeller |
+| **💰 BILLIG** | GLM-4.7 | $0,6/1M | Daglig 10:00 | Budsjett backup |
+| | MiniMax M2.1 | $0,2/1M | 5-timers rullende | Billigste alternativ |
+| | Kimi K2 | $9/md leilighet | 10 millioner tokens/mnd | Forutsigbar kostnad |
+| **🆓 GRATIS** | iFlow | $0 | Ubegrenset | 8 modeller gratis |
+| | Qwen | $0 | Ubegrenset | 3 modeller gratis |
+| | Kiro | $0 | Ubegrenset | Claude gratis |
+
+**💡 Profftips:** Start med Gemini CLI (180K gratis/måned) + iFlow (ubegrenset gratis) kombinasjon = $0 kostnad!
+
+---
+
+## 🎯 Brukssaker
+
+### Sak 1: "Jeg har Claude Pro-abonnement"
+
+**Problem:** Kvoten utløper ubrukt, satsgrenser under tung koding
+
+```
+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
+```
+
+### Tilfelle 2: "Jeg vil ha null kostnad"
+
+**Problem:** Har ikke råd til abonnementer, trenger pålitelig AI-koding
+
+```
+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
+```
+
+### Tilfelle 3: "Jeg trenger 24/7 koding, ingen avbrudd"
+
+**Problem:** Tidsfrister, har ikke råd til nedetid
+
+```
+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
+```
+
+### Tilfelle 4: "Jeg vil ha GRATIS AI i OpenClaw"
+
+**Problem:** Trenger AI-assistent i meldingsapper, helt gratis
+
+```
+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...
+```
+
+---
+
+## 💡 Nøkkelfunksjoner
+
+### 🧠 Kjerneruting og intelligens
+
+| Funksjon | Hva det gjør |
+| ---------------------------------- | ---------------------------------------------------------------------------------------- |
+| 🎯 **Smart 4-lags fallback** | Automatisk rute: Abonnement → API-nøkkel → Billig → Gratis |
+| 📊 **Sanntidskvotesporing** | Live tokenantall + tilbakestilt nedtelling per leverandør |
+| 🔄 **Formatoversettelse** | OpenAI ↔ Claude ↔ Gemini ↔ Markør ↔ Kiro sømløs + respons sanitization |
+| 👥 **Støtte for flere kontoer** | Flere kontoer per leverandør med intelligent utvalg |
+| 🔄 **Auto Token Refresh** | OAuth-tokens oppdateres automatisk med prøv på nytt |
+| 🎨 **Egendefinerte kombinasjoner** | 6 strategier: fyll først, round-robin, p2c, tilfeldig, minst brukt, kostnadsoptimalisert |
+| 🧩 **Egendefinerte modeller** | Legg til hvilken som helst modell-ID til en hvilken som helst leverandør |
+| 🌐 **Wildcard-ruter** | Ruter `provider/*`-mønstre til enhver leverandør dynamisk |
+| 🧠 **Tenkebudsjett** | Passthrough, auto, egendefinerte og adaptive moduser for resonnerende modeller |
+| 💬 **Systemprompt-injeksjon** | Global systemforespørsel brukt på alle forespørsler |
+| 📄 **Responses API** | Full støtte for OpenAI Responses API (`/v1/responses`) for Codex |
+
+### 🎵 Multi-Modal APIer
+
+| Funksjon | Hva det gjør |
+| ----------------------- | ------------------------------------------------------ |
+| 🖼️ **Bildegenerering** | `/v1/images/generations` — 4 leverandører, 9+ modeller |
+| 📐 **Innbygging** | `/v1/embeddings` — 6 leverandører, 9+ modeller |
+| 🎤 **Lydtranskripsjon** | `/v1/audio/transcriptions` — Whisper-kompatibel |
+| 🔊 **Tekst-til-tale** | `/v1/audio/speech` — Multi-leverandør lydsyntese |
+| 🛡️ **Moderasjoner** | `/v1/moderations` — Innholdssikkerhetssjekker |
+| 🔀 **Omrangering** | `/v1/rerank` — Rerangering av dokumentrelevans |
+
+### 🛡️ Spenst og sikkerhet
+
+| Funksjon | Hva det gjør |
+| --------------------------------- | ----------------------------------------------------------------------------- |
+| 🔌 **Circuit Breaker** | Automatisk åpning/lukking per leverandør med konfigurerbare terskler |
+| 🛡️ **Anti-tordenflokk** | Mutex + semaforhastighetsgrense for API-nøkkelleverandører |
+| 🧠 **Semantisk cache** | To-lags cache (signatur + semantisk) reduserer kostnader og ventetid |
+| ⚡ **Be om idempotens** | 5s dedup-vindu for dupliserte forespørsler |
+| 🔒 **TLS-fingeravtrykkspoofing** | Omgå TLS-basert botdeteksjon via wreq-js |
+| 🌐 **IP-filtrering** | Tillatelsesliste/blokkeringsliste for API-tilgangskontroll |
+| 📊 **Redigerbare satsgrenser** | Konfigurerbar RPM, min gap og maks samtidig på systemnivå |
+| 🛡 **API-endepunktbeskyttelse** | Auth-gate + leverandørblokkering for `/models`-endepunktet |
+| 🔒 **Proxy-synlighet** | Fargekodede merker: 🟢 global, 🟡 leverandør, 🔵 per tilkobling med IP-skjerm |
+| 🌐 **3-nivå proxy-konfigurasjon** | Konfigurer proxyer på globalt nivå, per leverandør eller per tilkoblingsnivå |
+
+### 📊 Observerbarhet og analyse
+
+| Funksjon | Hva det gjør |
+| -------------------------- | ----------------------------------------------------------------------------------- |
+| 📝 **Be om logging** | Feilsøkingsmodus med fullstendige forespørsels-/svarlogger |
+| 💾 **SQLite proxy-logger** | Vedvarende proxy-logger overlever omstart av server |
+| 📊 **Analytics Dashboard** | Recharts-drevet: statistikkkort, modellbruksdiagram, leverandørtabell |
+| 📈 **Fremdriftssporing** | Opt-in SSE-fremdriftshendelser for streaming |
+| 🧪 **LLM-evalueringer** | Gylden sett-testing med 4 kampstrategier |
+| 🔍 **Be om telemetri** | p50/p95/p99 latensaggregering + X-Request-Id-sporing |
+| 📋 **Logger Dashboard** | Samlet side med 4 faner: Forespørselslogger, proxy-logger, revisjonslogger, konsoll |
+| 🖥️ **Konsollloggvisning** | Viser i sanntid i terminalstil med nivåfilter, søk, automatisk rulling |
+| 📑 **Filbasert logging** | Console interceptor fanger opp all utgang til JSON-loggfil med rotasjon |
+| 🏥 **Helse Dashboard** | Systemoppetid, strømbrytertilstander, sperringer, cachestatistikk |
+| 💰 **Kostnadssporing** | Budsjettadministrasjon + priskonfigurasjon per modell |
+
+### ☁️ Implementering og synkronisering
+
+| Funksjon | Hva det gjør |
+| -------------------------------- | ---------------------------------------------------------------------------------------- |
+| 💾 **Cloud Sync** | Synkroniser konfigurasjon på tvers av enheter via Cloudflare Workers |
+| 🌐 **Distribuer hvor som helst** | Localhost, VPS, Docker, Cloudflare Workers |
+| 🔑 **API Key Management** | Generer, roter og omfang API-nøkler per leverandør |
+| 🧙 **Onboarding Wizard** | 4-trinns veiledet oppsett for førstegangsbrukere |
+| 🔧 **CLI Tools Dashboard** | Ett-klikk konfigurer Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **DB-sikkerhetskopier** | Automatisk sikkerhetskopiering, gjenoppretting, eksport og import for alle innstillinger |
+| 🌐 **Internasjonalisering** | Full i18n med neste-intl — støtte for engelsk + portugisisk (Brasil) |
+| 🌍 **Språkvelger** | Globusikon i overskriften for sanntids språkbytte (🇺🇸/🇧🇷) |
+| 📂 **Tilpasset datakatalog** | `DATA_DIR` env var for å overstyre standard `~/.omniroute` lagringsbane |
+
+
+📖 Funksjonsdetaljer
+
+### 🎯 Smart 4-lags fallback
+
+Lag kombinasjoner med automatisk fallback:
+
+```
+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
+```
+
+### 📊 Sanntidskvotesporing
+
+- Tokenforbruk per leverandør
+- Tilbakestill nedtellingen (5 timer, daglig, ukentlig)
+- Kostnadsestimat for betalte nivåer
+- Månedlige utgiftsrapporter
+
+### 🔄 Formatoversettelse
+
+Sømløs oversettelse mellom formater:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI-svar**
+- CLI-verktøyet ditt sender OpenAI-format → OmniRoute oversetter → Leverandøren mottar eget format
+- Fungerer med alle verktøy som støtter tilpassede OpenAI-endepunkter
+- **Responssanering** - Fjerner ikke-standardfelter for streng OpenAI SDK-kompatibilitet
+- **Rollenormalisering** — `developer` → `system` for ikke-OpenAI; `system` → `user` for GLM/ERNIE-modeller
+- **Tenk tag-utvinning** — `` blokker → `reasoning_content` for tenkemodeller
+- **Strukturert utgang** — `json_schema` → Gemini's `responseMimeType`/`responseSchema`
+
+### 👥 Støtte for flere kontoer
+
+- Legg til flere kontoer per leverandør
+- Auto round-robin eller prioritetsbasert ruting
+- Tilbakeslag til neste konto når en når kvoten
+
+### 🔄 Automatisk tokenoppdatering
+
+- OAuth-tokens oppdateres automatisk før utløp
+- Ingen manuell re-autentisering nødvendig
+- Sømløs opplevelse på tvers av alle leverandører
+
+### 🎨 Egendefinerte kombinasjoner
+
+- Lag ubegrensede modellkombinasjoner
+- 6 strategier: fyll-først, round-robin, kraft-av-to-valg, tilfeldig, minst brukt, kostnadsoptimalisert
+- Del kombinasjoner på tvers av enheter med Cloud Sync
+
+### 🏥 Helse Dashboard
+
+- Systemstatus (oppetid, versjon, minnebruk)
+- Strømbrytertilstander per leverandør (lukket/åpen/halvåpen)
+- Takstgrensestatus og aktive sperringer
+- Signaturbufferstatistikk
+- Latency-telemetri (p50/p95/p99) + hurtigbuffer
+- Tilbakestill helsestatus med ett klikk
+
+### 🔧 Oversetter Lekeplass
+
+OmniRoute inkluderer en kraftig innebygd oversetterlekeplass med **4 moduser** for feilsøking, testing og overvåking av API-oversettelser:
+
+| Modus | Beskrivelse |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻 Lekeplass** | Direkte formatoversettelse – lim inn hvilken som helst API-forespørselstekst og se umiddelbart hvordan OmniRoute oversetter den mellom leverandørformater (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). Inkluderer eksempelmaler og automatisk gjenkjenning av formater. |
+| **💬 Chat Tester** | Send ekte chatteforespørsler gjennom OmniRoute og se hele rundturen: innspillet ditt, den oversatte forespørselen, leverandørens svar og det oversatte svaret tilbake. Uvurderlig for validering av kombinasjonsruting. |
+| **🧪 Testbenk** | Batch-testmodus – definer flere testtilfeller med forskjellige innganger og forventede utganger, kjør dem alle samtidig og sammenlign resultater på tvers av leverandører og modeller. |
+| **📱 Live Monitor** | Sanntidsovervåking av forespørsler – se innkommende forespørsler mens de strømmer gjennom OmniRoute, se formatoversettelser som skjer live, og identifiser problemer umiddelbart. |
+
+**Tilgang:** Dashboard → Oversetter (sidefelt)
+
+### 💾 Cloud Sync
+
+- Synkroniser leverandører, kombinasjoner og innstillinger på tvers av enheter
+- Automatisk bakgrunnssynkronisering
+- Sikker kryptert lagring
+
+
+
+---
+
+## 📖 Oppsettveiledning
+
+
+💳 Abonnementsleverandører
+
+### 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
+```
+
+**Profftips:** Bruk Opus for komplekse oppgaver, Sonnet for hastighet. OmniRoute sporer kvote per modell!
+
+### 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 (GRATIS 180K/måned!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Mest verdi:** Enormt gratis nivå! Bruk dette før betalte nivåer.
+
+### GitHub Copilot
+
+```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
+```
+
+
+
+
+🔑 API nøkkelleverandører
+
+### NVIDIA NIM (GRATIS 1000 studiepoeng!)
+
+1. Registrer deg: [build.nvidia.com](https://build.nvidia.com)
+2. Få gratis API-nøkkel (1000 slutningspoeng inkludert)
+3. Dashboard → Legg til leverandør → NVIDIA NIM:
+ - API-nøkkel: `nvapi-your-key`
+
+**Modeller:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct` og 50+ til
+
+**Profftips:** OpenAI-kompatibel API — fungerer sømløst med OmniRoutes formatoversettelse!
+
+### DeepSeek
+
+1. Registrer deg: [platform.deepseek.com](https://platform.deepseek.com)
+2. Få API-nøkkel
+3. Dashboard → Legg til leverandør → DeepSeek
+
+**Modeller:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (gratis nivå tilgjengelig!)
+
+1. Registrer deg: [console.groq.com](https://console.groq.com)
+2. Få API-nøkkel (gratis nivå inkludert)
+3. Dashboard → Legg til leverandør → Groq
+
+**Modeller:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Profftips:** Ultrarask slutning — best for sanntidskoding!
+
+### OpenRouter (100+ modeller)
+
+1. Registrer deg: [openrouter.ai](https://openrouter.ai)
+2. Få API-nøkkel
+3. Dashboard → Legg til leverandør → OpenRouter
+
+**Modeller:** Få tilgang til 100+ modeller fra alle store leverandører gjennom én enkelt API-nøkkel.
+
+
+
+
+💰 Billige leverandører (backup)
+
+### GLM-4.7 (Daglig tilbakestilling, $0,6/1M)
+
+1. Registrer deg: [Zhipu AI](https://open.bigmodel.cn/)
+2. Få API-nøkkel fra Coding Plan
+3. Dashboard → Legg til API-nøkkel:
+ - Leverandør: `glm`
+ - API-nøkkel: `your-key`
+
+**Bruk:** `glm/glm-4.7`
+
+**Profftips:** Coding Plan tilbyr 3× kvote til 1/7 kostnad! Tilbakestill daglig 10:00.
+
+### MiniMax M2.1 (5t tilbakestilling, $0,20/1M)
+
+1. Registrer deg: [MiniMax](https://www.minimax.io/)
+2. Få API-nøkkel
+3. Dashboard → Legg til API-nøkkel
+
+**Bruk:** `minimax/MiniMax-M2.1`
+
+**Profftips:** Billigste alternativet for lang kontekst (1M tokens)!
+
+### Kimi K2 ($9/mnd leilighet)
+
+1. Abonner: [Moonshot AI](https://platform.moonshot.ai/)
+2. Få API-nøkkel
+3. Dashboard → Legg til API-nøkkel
+
+**Bruk:** `kimi/kimi-latest`
+
+**Profftips:** Fast $9/måned for 10M tokens = $0,90/1M effektiv kostnad!
+
+
+
+
+🆓 GRATIS Leverandører (Emergency Backup)
+
+### iFlow (8 GRATIS modeller)
+
+```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 GRATIS modeller)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Claude FREE)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Lag kombinasjoner
+
+### Eksempel 1: Maksimer abonnement → Billig sikkerhetskopi
+
+```
+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
+```
+
+### Eksempel 2: Kun gratis (nullkostnad)
+
+```
+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!
+```
+
+
+
+
+🔧 CLI-integrasjon
+
+### Markør 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
+
+Bruk **CLI Tools**-siden i dashbordet for ett-klikks konfigurasjon, eller rediger `~/.claude/settings.json` manuelt.
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**Alternativ 1 – Dashboard (anbefalt):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**Alternativ 2 — Manuell:** Rediger `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Merk:** OpenClaw fungerer bare med lokale OmniRoute. Bruk `127.0.0.1` i stedet for `localhost` for å unngå problemer med IPv6-oppløsning.
+
+### Cline / Fortsett / RooCode
+
+```
+Settings → API Configuration:
+ Provider: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [from OmniRoute dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Tilgjengelige modeller
+
+
+Se alle tilgjengelige modeller
+
+**Claude-kode (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Kodex (`cx/`)** - Pluss/Proff:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - GRATIS:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**GitHub Copilot (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - GRATIS kreditter:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ flere modeller på [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - $0,6/1M:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0,2/1M:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - GRATIS:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - GRATIS:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - GRATIS:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ modeller:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Alle modeller fra [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Evalueringer (evalueringer)
+
+OmniRoute inkluderer et innebygd evalueringsrammeverk for å teste LLM-responskvaliteten mot et gyldent sett. Få tilgang til den via **Analytics → Evals** i dashbordet.
+
+### Innebygd gyldent sett
+
+Det forhåndsinstallerte "OmniRoute Golden Set" inneholder 10 testcases som dekker:
+
+- Hilsen, matematikk, geografi, kodegenerering
+- JSON-formatoverholdelse, oversettelse, markdown
+- Sikkerhetsavslag (skadelig innhold), telling, boolsk logikk
+
+### Evalueringsstrategier
+
+| Strategi | Beskrivelse | Eksempel |
+| ---------- | --------------------------------------------------------------------- | -------------------------------- |
+| `exact` | Utdata må samsvare nøyaktig med | `"4"` |
+| `contains` | Utdata må inneholde understreng (uavhengig av store og små bokstaver) | `"Paris"` |
+| `regex` | Utdata må samsvare med regulært uttrykksmønster | `"1.*2.*3"` |
+| `custom` | Egendefinert JS-funksjon returnerer true/false | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em Servidor Remoto (Ekstern OAuth-oppsett)
+
+
+
+> **⚠️ VIKTIG for bruk av OmniRoute med VPS/Docker/server-fjernkontroll**
+
+### Hva med OAuth gjør Antigravity / Gemini CLI falha em servidores remotos?
+
+Os testedores **Antigravity** og **Gemini CLI** usam **Google OAuth 2.0** for autenticação. O Google exige que a `redirect_uri` usada no fluxo OAuth seja **exatamente** uma das URIs pre-cadastradas no Google Cloud Console do aplicativo.
+
+Som credenciais OAuth embutidas no OmniRoute estão cadastradas **apenas para `localhost`**. Quando você acessa o OmniRoute em um servidor remoto (eks: `https://omniroute.meuservidor.com`), o Google avviser autenticação com:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### Løsning: Konfigurer OAuth-tilbehør
+
+Você precisa criar um **OAuth 2.0 Client ID** no Google Cloud Console com en URI for seu service.
+
+#### Passo a passo
+
+**1. Tilgang til 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 Client ID**
+
+- Klikk dem **"+ Opprett legitimasjon"** → **"OAuth-klient-ID"**
+- Tipo de aplicativo: **"Nettapplikasjon"**
+- Navn: escolha qualquer nome (eks.: `OmniRoute Remote`)
+
+**3. Adicione som autorisert omdirigerings-URI**
+
+Ingen campo **"Authorized redirect URIs"**, adicione:
+
+```
+https://seu-servidor.com/callback
+```
+
+> Substitua `seu-servidor.com` pelo domínio ou IP do seu servidor (inclua a porta se necessário, ex: `http://45.33.32.156:20128/callback`).
+
+**4. Salve e copy as credenciais**
+
+Após criar, o Google mostrará o **Client ID** e o **Client Secret**.
+
+**5. Konfigurer som variáveis de ambiente**
+
+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**
+
+Dashboard → Leverandører → Antigravity (ou Gemini CLI) → OAuth
+
+Agora o Google redirecionará corretamente para `https://seu-servidor.com/callback` e autenticação funcionará.
+
+---
+
+### Midlertidig midlertidig løsning (som konfigureres på forhånd)
+
+Se não quiser criar credenciais próprias agora, ainda é possível usar o fluxo **manual de URL**:
+
+1. O OmniRoute abrirá en URL fra autorização til Google
+2. Após você autorizar, o Google tentará redirecionar for `localhost` (que falha no servidor remoto)
+3. **Kopier en URL fullført** da barra de endereço do seu nettleseren (mesmo que a página não carregue)
+4. Cole essa URL no campo que aparece no modal de conexão do OmniRoute
+5. Klikk på **"Koble til"**
+
+> Este workaround funciona porque or código de autorização na URL é válido independente do redirect ter carregado or não.
+
+---
+
+## 🐛 Feilsøking
+
+
+Klikk for å utvide feilsøkingsveiledningen
+
+**«Språkmodellen ga ikke meldinger»**
+
+- Leverandørkvoten er oppbrukt → Sjekk dashboardkvotesporing
+- Løsning: Bruk kombinasjonsalternativ eller bytt til et billigere nivå
+
+**Satsbegrensning**
+
+- Abonnementskvote ut → Fallback til GLM/MiniMax
+- Legg til kombinasjon: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**OAuth-token er utløpt**
+
+- Automatisk oppdatering av OmniRoute
+- Hvis problemene vedvarer: Dashboard → Leverandør → Koble til på nytt
+
+**Høye kostnader**
+
+- Sjekk bruksstatistikk i Dashboard → Kostnader
+- Bytt primærmodell til GLM/MiniMax
+- Bruk gratis nivå (Gemini CLI, iFlow) for ikke-kritiske oppgaver
+
+**Dashboard åpnes på feil port**
+
+- Sett `PORT=20128` og `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Skysynkroniseringsfeil**
+
+- Bekreft at `BASE_URL` peker på løpeforekomsten din
+- Bekreft `CLOUD_URL` poeng til det forventede skyendepunktet
+- Hold `NEXT_PUBLIC_*` verdier på linje med verdiene på tjenersiden
+
+**Første pålogging fungerer ikke**
+
+- Sjekk `INITIAL_PASSWORD` i `.env`
+- Hvis det ikke er angitt, er reservepassordet `123456`
+
+**Ingen forespørselslogger**
+
+- Sett `ENABLE_REQUEST_LOGS=true` i `.env`
+
+**Test viser «Ugyldig» for OpenAI-kompatible leverandører**
+
+- Mange leverandører avslører ikke et `/models`-endepunkt
+- OmniRoute v1.0.6+ inkluderer reservevalidering via chatfullføringer
+- Sørg for at basis-URL inkluderer suffikset `/v1`
+
+
+
+---
+
+## 🛠️ Tech Stack
+
+- **Kjøretid**: Node.js 18–22 LTS (⚠️ Node.js 24+ støttes **ikke** — `better-sqlite3` native binærfiler er inkompatible)
+- **Språk**: TypeScript 5.9 — **100 % TypeScript** på tvers av `src/` og `open-sse/` (v1.0.6)
+- **Rammeverk**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Database**: LowDB (JSON) + SQLite (domenetilstand + proxy-logger)
+- **Streaming**: Server-sendte hendelser (SSE)
+- **Auth**: OAuth 2.0 (PKCE) + JWT + API-nøkler
+- **Test**: Node.js-testløper (368+ enhetstester)
+- **CI/CD**: GitHub-handlinger (automatisk npm-publisering + Docker Hub ved utgivelse)
+- **Nettsted**: [omniroute.online](https://omniroute.online)
+- **Pakke**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Dokker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Resiliens**: Strømbryter, eksponentiell backoff, anti-trdnende flokk, TLS-spoofing
+
+---
+
+## 📖 Dokumentasjon
+
+| Dokument | Beskrivelse |
+| -------------------------------------------- | ---------------------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md) | Leverandører, kombinasjoner, CLI-integrasjon, distribusjon |
+| [API Reference](docs/API_REFERENCE.md) | Alle endepunkter med eksempler |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Vanlige problemer og løsninger |
+| [Architecture](docs/ARCHITECTURE.md) | Systemarkitektur og innvendig |
+| [Contributing](CONTRIBUTING.md) | Utviklingsoppsett og retningslinjer |
+| [OpenAPI Spec](docs/openapi.yaml) | OpenAPI 3.0-spesifikasjon |
+| [Security Policy](SECURITY.md) | Sårbarhetsrapportering og sikkerhetspraksis |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Komplett guide: VM + nginx + Cloudflare-oppsett |
+| [Features Gallery](docs/FEATURES.md) | Visuell dashbordomvisning med skjermbilder |
+
+### 📸 Forhåndsvisning av dashbord
+
+
+Klikk for å se skjermbilder av dashbordet
+
+| Side | Skjermbilde |
+| ----------------- | ------------------------------------------------- |
+| **Tilbydere** |  |
+| **Komboer** |  |
+| **Analyse** |  |
+| **Helse** |  |
+| **Oversetter** |  |
+| **Innstillinger** |  |
+| **CLI-verktøy** |  |
+| **Brukslogger** |  |
+| **Endepunkt** |  |
+
+
+
+---
+
+## 🗺️ Veikart
+
+OmniRoute har **210+ funksjoner planlagt** på tvers av flere utviklingsfaser. Her er nøkkelområdene:
+
+| Kategori | Planlagte funksjoner | Høydepunkter |
+| -------------------------------- | -------------------- | ---------------------------------------------------------------------------------------------- |
+| 🧠 **Routing og intelligens** | 25+ | Ruting med lavest ventetid, tag-basert ruting, forhåndskontroll av kvoter, valg av P2C-konto |
+| 🔒 **Sikkerhet og overholdelse** | 20+ | SSRF-herding, tilsløring av legitimasjon, hastighetsgrense per endepunkt, styringsnøkkelomfang |
+| 📊 **Observerbarhet** | 15+ | OpenTelemetry-integrasjon, kvoteovervåking i sanntid, kostnadssporing per modell |
+| 🔄 **Tilbyderintegrasjoner** | 20+ | Dynamisk modellregister, leverandørnedkjøling, multi-konto Codex, Copilot-kvoteparsing |
+| ⚡ **Ytelse** | 15+ | Dobbelt hurtigbufferlag, promptbuffer, svarbuffer, streaming keepalive, batch API |
+| 🌐 **Økosystem** | 10+ | WebSocket API, config hot-reload, distribuert config store, kommersiell modus |
+
+### 🔜 Kommer snart
+
+- 🔗 **OpenCode Integration** — Innebygd leverandørstøtte for OpenCode AI-kodings-IDE
+- 🔗 **TRAE-integrasjon** — Full støtte for utviklingsrammeverket for TRAE AI
+- 📦 **Batch API** — Asynkron batchbehandling for bulkforespørsler
+- 🎯 **Tag-basert ruting** — Ruteforespørsler basert på tilpassede tagger og metadata
+- 💰 **Laveste kostnadsstrategi** — Velg automatisk den billigste tilgjengelige leverandøren
+
+> 📝 Full funksjonsspesifikasjoner tilgjengelig i [**OMNI_TOKEN_147**](docs/new-features/) (217 detaljerte spesifikasjoner)
+
+---
+
+## 📧 Støtte
+
+> 💬 **Bli med i fellesskapet vårt!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Få hjelp, del tips og hold deg oppdatert.
+
+- **Nettsted**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Problemer**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **Originalt prosjekt**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Bidragsytere
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Hvordan bidra
+
+1. Fordel depotet
+2. Lag din funksjonsgren (`git checkout -b feature/amazing-feature`)
+3. Bekreft endringene dine (`git commit -m 'Add amazing feature'`)
+4. Skyv til grenen (`git push origin feature/amazing-feature`)
+5. Åpne en pull-forespørsel
+
+Se [CONTRIBUTING.md](CONTRIBUTING.md) for detaljerte retningslinjer.
+
+### Slipper en ny versjon
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 Stjernehistorie
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Anerkjennelser
+
+Spesiell takk til **[9router](https://github.com/decolua/9router)** av **[decolua](https://github.com/decolua)** — det originale prosjektet som inspirerte denne gaffelen. OmniRoute bygger på det utrolige grunnlaget med tilleggsfunksjoner, multimodale APIer og en full TypeScript-omskriving.
+
+Spesiell takk til **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — den originale Go-implementeringen som inspirerte denne JavaScript-porten.
+
+---
+
+## 📄 Lisens
+
+MIT-lisens - se [LICENSE](LICENSE) for detaljer.
+
+---
+
+---
+
+## 🇧🇷 OmniRoute — Gateway de IA Gratuito
+
+
+
+### Nunca pare de codar. Roteamento inteligente for **modeller av IA GRATUITOS og de baixo custo** com reserve automático.
+
+_Seu proxy universal de API — et endepunkt, 36+ tester, null nedetid._
+
+### 🌐 Internacionalização (i18n)
+
+O dashbordet for OmniRoute støtter **multiplos idiomas**. Atualmente disponível em:
+
+| Idioma | Kode | Status |
+| --------------------- | ------- | ----------- |
+| 🇺🇸 Engelsk | `en` | ✅ Komplett |
+| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Komplett |
+
+**Para trocar o idioma:** Clique no selector de idioma (🇺🇸 EN) no header do dashboard → selection o idioma desejado.
+
+**Tillegg et nytt uttrykk:**
+
+1. Crie `src/i18n/messages/{codigo}.json` baseado em `en.json`
+2. Adicione o código em `src/i18n/config.ts` → `LOCALES` og `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+ provedores de IA** - Claude, GPT, Gemini, Llama, Qwen, DeepSeek, e mais
+- **Roteamento inteligente** — Fallback automático entre provedores
+- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
+- **Multi-conta** — Multiplas-innhold for testing com seleção inteligente
+- **Cache semântico** — Reduz custos e latência
+- **OAuth automático** — Tokens renovam automaticamente
+- **Personlig kombinasjoner** — 6 estratégias de roteamento
+- **Dashboard komplett** — Monitoramento, logger, analyser, konfigurasjoner
+- **CLI Tools** — Konfigurer Claude Code, Codex, Cursor, Cline com um clique
+- **100 % TypeScript** — Código limpo e tipado
+
+### 📖 Dokumentasjon
+
+| Documento | Beskrivelse |
+| ----------------------------------------------- | -------------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, distribuere |
+| [Referência da API](docs/API_REFERENCE.md) | Todos os endepunkter med eksempler |
+| [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) | Oppsett av desenvolvimento og retningslinjer |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Fullfør: VM + nginx + Cloudflare |
+
+### 📧 Støtte
+
+> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
+
+- **Nettsted**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Problemer**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+
+ Bygget med ❤️ for utviklere som koder 24/7
+
+ omniroute.online
+
diff --git a/README.phi.md b/README.phi.md
new file mode 100644
index 0000000000..ecbdc8373a
--- /dev/null
+++ b/README.phi.md
@@ -0,0 +1,1238 @@
+
+
+
+ # 🚀 OmniRoute — Ang Libreng AI Gateway
+
+🌐 **[English](#-omniroute--the-free-ai-gateway)** | **[Português (BR)](#-omniroute--gateway-de-ia-gratuito)**
+
+### Huwag kailanman ihinto ang coding. Smart routing sa **LIBRE at murang mga modelo ng AI** na may awtomatikong fallback.
+
+_Iyong unibersal na API proxy — isang endpoint, 36+ provider, zero downtime._
+
+**Mga Pagkumpleto ng Chat • Mga Pag-embed • Pagbuo ng Imahe • Audio • Pag-rerank • 100% TypeScript**
+
+---
+
+### 🤖 Libreng AI Provider para sa iyong mga paboritong coding agent
+
+_Ikonekta ang anumang AI-powered IDE o CLI tool sa pamamagitan ng OmniRoute — libreng API gateway para sa walang limitasyong coding._
+
+
+
+---
+
+## 🤔 Bakit OmniRoute?
+
+**Ihinto ang pag-aaksaya ng pera at pag-abot sa mga limitasyon:**
+
+- Mag-e-expire ang quota ng subscription na hindi nagamit bawat buwan
+- Pinipigilan ka ng mga limitasyon sa rate sa mid-coding
+- Mga Mamahaling API ($20-50/buwan bawat provider)
+- Manu-manong paglipat sa pagitan ng mga provider
+
+**Sumalutas ito ng OmniRoute:**
+
+- ✅ **I-maximize ang mga subscription** - Subaybayan ang quota, gamitin ang bawat bit bago i-reset
+- ✅ **Auto fallback** - Subscription → API Key → Mura → Libre, zero downtime
+- ✅ **Multi-account** - Round-robin sa pagitan ng mga account sa bawat provider
+- ✅ **Universal** - Gumagana sa Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw, anumang CLI tool
+
+---
+
+## 🔄 Paano Ito Gumagana
+
+```
+┌─────────────┐
+│ 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
+```
+
+---
+
+## ⚡ Mabilis na Pagsisimula
+
+**1. I-install sa buong mundo:**
+
+```bash
+npm install -g omniroute
+omniroute
+```
+
+🎉 Magbubukas ang dashboard sa `http://localhost:20128`
+
+| Utos | Paglalarawan |
+| ----------------------- | --------------------------------------- |
+| `omniroute` | Simulan ang server (default port 20128) |
+| `omniroute --port 3000` | Gumamit ng custom na port |
+| `omniroute --no-open` | Huwag awtomatikong buksan ang browser |
+| `omniroute --help` | Ipakita ang tulong |
+
+**2. Ikonekta ang isang LIBRENG provider:**
+
+Dashboard → Mga Provider → Ikonekta ang **Claude Code** o **Antigravity** → OAuth login → Tapos na!
+
+**3. Gamitin sa iyong CLI tool:**
+
+```
+Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline Settings:
+ Endpoint: http://localhost:20128/v1
+ API Key: [copy from dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+**Iyon na!** Magsimulang mag-coding gamit ang LIBRENG mga modelo ng AI.
+
+**Alternatibong — tumakbo mula sa pinagmulan:**
+
+```bash
+cp .env.example .env
+npm install
+PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev
+```
+
+---
+
+## 🐳 Docker
+
+Available ang OmniRoute bilang isang pampublikong larawan ng Docker sa [Docker Hub](https://hub.docker.com/r/diegosouzapw/omniroute).
+
+**Mabilis na pagtakbo:**
+
+```bash
+docker run -d \
+ --name omniroute \
+ --restart unless-stopped \
+ -p 20128:20128 \
+ -v omniroute-data:/app/data \
+ diegosouzapw/omniroute:latest
+```
+
+**Na may environment file:**
+
+```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
+```
+
+**Gumagamit ng Docker Compose:**
+
+```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
+```
+
+| Larawan | Tag | Sukat | Paglalarawan |
+| ------------------------ | -------- | ------ | ------------------------------ |
+| `diegosouzapw/omniroute` | `latest` | ~250MB | Pinakabagong stable na release |
+| `diegosouzapw/omniroute` | `1.0.3` | ~250MB | Kasalukuyang bersyon |
+
+---
+
+## 💰 Pagpepresyo sa isang Sulyap
+
+| Tier | Provider | Gastos | I-reset ang Quota | Pinakamahusay Para sa |
+| ------------------- | ----------------- | ------------------------ | -------------------- | ------------------------------- |
+| **💳 SUBSCRIPTION** | Claude Code (Pro) | $20/buwan | 5h + lingguhan | Naka-subscribe na |
+| | Codex (Plus/Pro) | $20-200/buwan | 5h + lingguhan | Mga user ng OpenAI |
+| | Gemini CLI | **LIBRE** | 180K/buwan + 1K/araw | Lahat! |
+| | GitHub Copilot | $10-19/buwan | Buwanang | Mga user ng GitHub |
+| **🔑 API KEY** | NVIDIA NIM | **LIBRE** (1000 credits) | Isang beses | Libreng tier na pagsubok |
+| | DeepSeek | Pay-per-use | Wala | Pinakamahusay na presyo/kalidad |
+| | Groq | Libreng tier + bayad | Limitado ang rate | Napakabilis na hinuha |
+| | xAI (Grok) | Pay-per-use | Wala | Mga modelong Grok |
+| | Mistral | Libreng tier + bayad | Limitado ang rate | European AI |
+| | OpenRouter | Pay-per-use | Wala | 100+ modelo |
+| **💰 MURA** | GLM-4.7 | $0.6/1M | Araw-araw 10AM | Backup ng badyet |
+| | MiniMax M2.1 | $0.2/1M | 5 oras na rolling | Pinaka murang opsyon |
+| | Kimi K2 | $9/buwan flat | 10M token/buwan | Nahuhulaang gastos |
+| **🆓 LIBRE** | iFlow | $0 | Walang limitasyong | 8 mga modelong libre |
+| | Qwen | $0 | Walang limitasyong | 3 mga modelong libre |
+| | Kiro | $0 | Walang limitasyong | Claude libre |
+
+**💡 Pro Tip:** Magsimula sa Gemini CLI (180K libre/buwan) + iFlow (walang limitasyong libre) combo = $0 na halaga!
+
+---
+
+## 🎯 Use Cases
+
+### Case 1: "May subscription ako sa Claude Pro"
+
+**Problema:** Nag-e-expire ang quota nang hindi nagamit, mga limitasyon sa rate sa panahon ng mabigat na coding
+
+```
+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
+```
+
+### Case 2: "Gusto ko ng zero cost"
+
+**Problema:** Hindi kayang bayaran ang mga subscription, kailangan ng maaasahang AI coding
+
+```
+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
+```
+
+### Case 3: "Kailangan ko ng 24/7 coding, walang mga pagkaantala"
+
+**Problema:** Mga deadline, hindi kayang bayaran ang downtime
+
+```
+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
+```
+
+### Kaso 4: "Gusto ko ng LIBRENG AI sa OpenClaw"
+
+**Problema:** Kailangan ng AI assistant sa mga app sa pagmemensahe, ganap na libre
+
+```
+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...
+```
+
+---
+
+## 💡 Mga Pangunahing Tampok
+
+### 🧠 Core Routing at Intelligence
+
+| Tampok | Ano ang Ginagawa Nito |
+| ------------------------------- | -------------------------------------------------------------------------------------------- |
+| 🎯 **Smart 4-Tier Fallback** | Auto-ruta: Subscription → API Key → Mura → Libre |
+| 📊 **Real-Time Quota Tracking** | Live na bilang ng token + reset countdown bawat provider |
+| 🔄 **Format Translation** | OpenAI ↔ Claude ↔ Gemini ↔ Cursor ↔ Kiro seamless + response sanitization |
+| 👥 **Suporta sa Multi-Account** | Maramihang account sa bawat provider na may matalinong pagpili |
+| 🔄 **Auto Token Refresh** | Awtomatikong nagre-refresh ang mga token ng OAuth sa muling pagsubok |
+| 🎨 **Mga Custom na Combos** | 6 na diskarte: fill-first, round-robin, p2c, random, hindi gaanong ginagamit, cost-optimized |
+| 🧩 **Mga Custom na Modelo** | Magdagdag ng anumang ID ng modelo sa anumang provider |
+| 🌐 **Wildcard Router** | Iruta ang `provider/*` na mga pattern sa anumang provider nang dynamic na |
+| 🧠 **Badyet sa Pag-iisip** | Passthrough, auto, custom, at adaptive mode para sa mga modelo ng pangangatwiran |
+| 💬 **System Prompt Injection** | Inilapat ang global system prompt sa lahat ng kahilingan |
+| 📄 **Responses API** | Buong OpenAI Responses API (`/v1/responses`) na suporta para sa Codex |
+
+### 🎵 Mga Multi-Modal na API
+
+| Tampok | Ano ang Ginagawa Nito |
+| -------------------------- | ------------------------------------------------------------ |
+| 🖼️ **Pagbuo ng Larawan** | `/v1/images/generations` — 4 na provider, 9+ na modelo |
+| 📐 **Mga Pag-embed** | `/v1/embeddings` — 6 na provider, 9+ na modelo |
+| 🎤 **Audio Transcription** | `/v1/audio/transcriptions` — Whisper-compatible |
+| 🔊 **Text-to-Speech** | `/v1/audio/speech` — Multi-provider audio synthesis |
+| 🛡️ **Mga Pag-moderate** | `/v1/moderations` — Mga pagsusuri sa kaligtasan ng nilalaman |
+| 🔀 **Reranking** | `/v1/rerank` — Muling pagraranggo ng kaugnayan ng dokumento |
+
+### 🛡️ Katatagan at Seguridad
+
+| Tampok | Ano ang Ginagawa Nito |
+| ----------------------------------------- | ------------------------------------------------------------------------------------- |
+| 🔌 **Circuit Breaker** | Awtomatikong buksan/isara ang bawat provider na may mga na-configure na threshold |
+| 🛡️ **Anti-Thundering Herd** | Mutex + semaphore rate-limit para sa mga API key provider |
+| 🧠 **Semantic Cache** | Binabawasan ng two-tier na cache (pirma + semantiko) ang gastos at latency |
+| ⚡ **Humiling ng Idempotency** | 5s dedup window para sa mga duplicate na kahilingan |
+| 🔒 **TLS Fingerprint Spoofing** | I-bypass ang TLS-based na bot detection sa pamamagitan ng wreq-js |
+| 🌐 **Pag-filter ng IP** | Allowlist/blocklist para sa API access control |
+| 📊 **Mga Nae-edit na Limitasyon sa Rate** | Configurable RPM, min gap, at max na kasabay sa antas ng system |
+| 🛡 **Proteksyon sa Endpoint ng API** | Auth gating + pagharang ng provider para sa `/models` endpoint |
+| 🔒 **Proxy Visibility** | Mga color-coded na badge: 🟢 global, 🟡 provider, 🔵 per-connection na may IP display |
+| 🌐 **3-Level Proxy Config** | I-configure ang mga proxy sa global, per-provider, o per-connection level |
+
+### 📊 Pagmamasid at Analytics
+
+| Tampok | Ano ang Ginagawa Nito |
+| ------------------------------- | -------------------------------------------------------------------------------------------- |
+| 📝 **Kahilingan sa Pag-log** | Debug mode na may buong kahilingan/tugon logs |
+| 💾 **SQLite Proxy Logs** | Ang mga paulit-ulit na proxy log ay nakaligtas sa pag-restart ng server |
+| 📊 **Analytics Dashboard** | Recharts-powered: mga stat card, chart ng paggamit ng modelo, talahanayan ng provider |
+| 📈 **Pagsubaybay sa Pag-unlad** | Mag-opt-in sa mga kaganapan sa pag-usad ng SSE para sa streaming |
+| 🧪 **Mga Pagsusuri sa LLM** | Golden set testing na may 4 na diskarte sa pagtutugma |
+| 🔍 **Humiling ng Telemetry** | p50/p95/p99 latency aggregation + X-Request-Id tracing |
+| 📋 **Dashboard ng Mga Log** | Pinag-isang 4-tab na pahina: Mga Log ng Kahilingan, Mga Proxy Log, Mga Log ng Audit, Console |
+| 🖥️ **Console Log Viewer** | Real-time na terminal-style viewer na may level filter, search, auto-scroll |
+| 📑 **File-Based Logging** | Kinukuha ng Console interceptor ang lahat ng output sa JSON log file na may pag-ikot |
+| 🏥 **Dashboard ng Kalusugan** | System uptime, circuit breaker states, lockouts, cache stats |
+| 💰 **Pagsubaybay sa Gastos** | Pamamahala ng badyet + configuration ng pagpepresyo sa bawat modelo |
+
+### ☁️ Deployment at Pag-sync
+
+| Tampok | Ano ang Ginagawa Nito |
+| ----------------------------------- | ----------------------------------------------------------------------------------------------- |
+| 💾 **Cloud Sync** | I-sync ang config sa mga device sa pamamagitan ng Cloudflare Workers |
+| 🌐 **I-deploy Kahit Saan** | Localhost, VPS, Docker, Cloudflare Workers |
+| 🔑 **API Key Management** | Bumuo, paikutin, at saklawin ang mga API key sa bawat provider |
+| 🧙 **Onboarding Wizard** | 4-step guided setup para sa mga unang beses na user |
+| 🔧 **CLI Tools Dashboard** | One-click configure Claude, Codex, Cline, OpenClaw, Kilo, Antigravity |
+| 🔄 **Mga Backup ng DB** | Awtomatikong pag-backup, pagpapanumbalik, pag-export at pag-import para sa lahat ng mga setting |
+| 🌐 **Internasyonalisasyon** | Buong i18n na may next-intl — suporta sa English + Portuguese (Brazil) |
+| 🌍 **Pili ng Wika** | Globe icon sa header para sa real-time na paglipat ng wika (🇺🇸/🇧🇷) |
+| 📂 **Custom na Direktoryo ng Data** | `DATA_DIR` env var to override default `~/.omniroute` storage path |
+
+
+📖 Mga Detalye ng Tampok
+
+### 🎯 Smart 4-Tier Fallback
+
+Gumawa ng mga combo na may awtomatikong fallback:
+
+```
+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
+```
+
+### 📊 Real-Time na Pagsubaybay sa Quota
+
+- Pagkonsumo ng token bawat provider
+- I-reset ang countdown (5 oras, araw-araw, lingguhan)
+- Pagtatantya ng gastos para sa mga bayad na tier
+- Mga ulat sa buwanang paggasta
+
+### 🔄 Pagsasalin ng Format
+
+Walang putol na pagsasalin sa pagitan ng mga format:
+
+- **OpenAI** ↔ **Claude** ↔ **Gemini** ↔ **OpenAI Responses**
+- Ang iyong CLI tool ay nagpapadala ng OpenAI na format → OmniRoute nagsasalin → Provider ay tumatanggap ng katutubong format
+- Gumagana sa anumang tool na sumusuporta sa mga custom na endpoint ng OpenAI
+- **Response sanitization** — Tinatanggal ang mga hindi karaniwang field para sa mahigpit na OpenAI SDK compatibility
+- **Pag-normalize ng tungkulin** — `developer` → `system` para sa hindi OpenAI; `system` → `user` para sa mga modelo ng GLM/ERNIE
+- **Think tag extraction** — `` block → `reasoning_content` para sa mga modelo ng pag-iisip
+- **Structured output** — `json_schema` → Gemini's `responseMimeType`/`responseSchema`
+
+### 👥 Multi-Account Support
+
+- Magdagdag ng maramihang mga account sa bawat provider
+- Auto round-robin o priority-based na pagruruta
+- Fallback sa susunod na account kapag naabot ng isa ang quota
+
+### 🔄 Auto Token Refresh
+
+- Awtomatikong nagre-refresh ang mga token ng OAuth bago mag-expire
+- Walang kinakailangang manu-manong muling pagpapatotoo
+- Walang putol na karanasan sa lahat ng provider
+
+### 🎨 Mga Custom na Combos
+
+- Lumikha ng walang limitasyong mga kumbinasyon ng modelo
+- 6 na diskarte: fill-first, round-robin, power-of-two-choices, random, hindi gaanong ginagamit, cost-optimized
+- Magbahagi ng mga combo sa mga device na may Cloud Sync
+
+### 🏥 Dashboard ng Kalusugan
+
+- Katayuan ng system (uptime, bersyon, paggamit ng memorya)
+- Mga estado ng circuit breaker bawat provider (Sarado/Bukas/Kalahating Bukas)
+- Katayuan ng limitasyon sa rate at mga aktibong lockout
+- Mga istatistika ng cache ng lagda
+- Latency telemetry (p50/p95/p99) + prompt cache
+- I-reset ang katayuan ng kalusugan sa isang pag-click
+
+### 🔧 Palaruan ng Tagasalin
+
+Kasama sa OmniRoute ang isang malakas na built-in na Playground ng Translator na may **4 na mode** para sa pag-debug, pagsubok, at pagsubaybay sa mga pagsasalin ng API:
+
+| Mode | Paglalarawan |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **💻 Palaruan** | Direktang pagsasalin ng format — i-paste ang anumang katawan ng kahilingan sa API at agad na makita kung paano ito isinasalin ng OmniRoute sa pagitan ng mga format ng provider (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). May kasamang mga halimbawang template at format ng auto-detection. |
+| **💬 Chat Tester** | Magpadala ng mga totoong kahilingan sa chat sa pamamagitan ng OmniRoute at tingnan ang buong round-trip: ang iyong input, ang isinaling kahilingan, ang tugon ng provider, at ang isinaling tugon pabalik. Napakahalaga para sa pagpapatunay ng combo routing. |
+| **🧪 Test Bench** | Batch testing mode — tumukoy ng maraming test case na may iba't ibang input at inaasahang output, patakbuhin ang mga ito nang sabay-sabay, at paghambingin ang mga resulta sa mga provider at modelo. |
+| **📱 Live Monitor** | Real-time na pagsubaybay sa kahilingan — panoorin ang mga papasok na kahilingan habang dumadaloy ang mga ito sa OmniRoute, tingnan ang mga pagsasalin ng format na nangyayari nang live, at tukuyin kaagad ang mga isyu. |
+
+**Access:** Dashboard → Translator (sidebar)
+
+### 💾 Cloud Sync
+
+- I-sync ang mga provider, combo, at mga setting sa mga device
+- Awtomatikong pag-sync sa background
+- Secure na naka-encrypt na imbakan
+
+
+
+---
+
+## 📖 Gabay sa Pag-setup
+
+
+💳 Mga Tagabigay ng Subscription
+
+### 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
+```
+
+**Pro Tip:** Gamitin ang Opus para sa mga kumplikadong gawain, Soneto para sa bilis. Sinusubaybayan ng OmniRoute ang quota bawat modelo!
+
+### 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 (LIBRE 180K/buwan!)
+
+```bash
+Dashboard → Providers → Connect Gemini CLI
+→ Google OAuth
+→ 180K completions/month + 1K/day
+
+Models:
+ gc/gemini-3-flash-preview
+ gc/gemini-2.5-pro
+```
+
+**Pinakamahusay na Halaga:** Malaking libreng tier! Gamitin ito bago ang mga bayad na tier.
+
+### GitHub Copilot
+
+```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
+```
+
+
+
+
+🔑 API Key Provider
+
+### NVIDIA NIM (LIBRE 1000 credits!)
+
+1. Mag-sign up: [build.nvidia.com](https://build.nvidia.com)
+2. Kumuha ng libreng API key (1000 inference credits kasama)
+3. Dashboard → Magdagdag ng Provider → NVIDIA NIM:
+ - API Key: `nvapi-your-key`
+
+**Mga Modelo:** `nvidia/llama-3.3-70b-instruct`, `nvidia/mistral-7b-instruct`, at 50+ pa
+
+**Pro Tip:** OpenAI-compatible na API — gumagana nang walang putol sa pagsasalin ng format ng OmniRoute!
+
+### DeepSeek
+
+1. Mag-sign up: [platform.deepseek.com](https://platform.deepseek.com)
+2. Kunin ang API key
+3. Dashboard → Magdagdag ng Provider → DeepSeek
+
+**Mga Modelo:** `deepseek/deepseek-chat`, `deepseek/deepseek-coder`
+
+### Groq (Magagamit ang Libreng Tier!)
+
+1. Mag-sign up: [console.groq.com](https://console.groq.com)
+2. Kunin ang API key (kasama ang libreng tier)
+3. Dashboard → Magdagdag ng Provider → Groq
+
+**Mga Modelo:** `groq/llama-3.3-70b`, `groq/mixtral-8x7b`
+
+**Pro Tip:** Napakabilis na inference — pinakamahusay para sa real-time na coding!
+
+### OpenRouter (100+ Modelo)
+
+1. Mag-sign up: [openrouter.ai](https://openrouter.ai)
+2. Kunin ang API key
+3. Dashboard → Magdagdag ng Provider → OpenRouter
+
+**Mga Modelo:** I-access ang 100+ na modelo mula sa lahat ng pangunahing provider sa pamamagitan ng iisang API key.
+
+
+
+
+💰 Mga Murang Provider (Backup)
+
+### GLM-4.7 (Araw-araw na pag-reset, $0.6/1M)
+
+1. Mag-sign up: [Zhipu AI](https://open.bigmodel.cn/)
+2. Kumuha ng API key mula sa Coding Plan
+3. Dashboard → Magdagdag ng API Key:
+ - Provider: `glm`
+ - API Key: `your-key`
+
+**Gamitin:** `glm/glm-4.7`
+
+**Pro Tip:** Nag-aalok ang Coding Plan ng 3× na quota sa 1/7 na halaga! I-reset araw-araw 10:00 AM.
+
+### MiniMax M2.1 (5h reset, $0.20/1M)
+
+1. Mag-sign up: [MiniMax](https://www.minimax.io/)
+2. Kunin ang API key
+3. Dashboard → Magdagdag ng API Key
+
+**Gamitin:** `minimax/MiniMax-M2.1`
+
+**Pro Tip:** Ang pinakamurang opsyon para sa mahabang konteksto (1M token)!
+
+### Kimi K2 ($9/month flat)
+
+1. Mag-subscribe: [Moonshot AI](https://platform.moonshot.ai/)
+2. Kunin ang API key
+3. Dashboard → Magdagdag ng API Key
+
+**Gamitin:** `kimi/kimi-latest`
+
+**Pro Tip:** Nakapirming $9/buwan para sa 10M token = $0.90/1M epektibong gastos!
+
+
+
+
+🆓 LIBRENG Provider (Emergency Backup)
+
+### iFlow (8 LIBRENG modelo)
+
+```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 LIBRENG modelo)
+
+```bash
+Dashboard → Connect Qwen
+→ Device code authorization
+→ Unlimited usage
+
+Models:
+ qw/qwen3-coder-plus
+ qw/qwen3-coder-flash
+```
+
+### Kiro (Claude LIBRE)
+
+```bash
+Dashboard → Connect Kiro
+→ AWS Builder ID or Google/GitHub
+→ Unlimited usage
+
+Models:
+ kr/claude-sonnet-4.5
+ kr/claude-haiku-4.5
+```
+
+
+
+
+🎨 Lumikha ng mga Combo
+
+### Halimbawa 1: I-maximize ang Subscription → Murang Backup
+
+```
+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
+```
+
+### Halimbawa 2: Libre-Lamang (Zero na Gastos)
+
+```
+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!
+```
+
+
+
+
+🔧 CLI Integration
+
+### Cursor 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
+
+Gamitin ang pahina ng **CLI Tools** sa dashboard para sa isang pag-click na configuration, o manu-manong i-edit ang `~/.claude/settings.json`.
+
+### Codex CLI
+
+```bash
+export OPENAI_BASE_URL="http://localhost:20128"
+export OPENAI_API_KEY="your-omniroute-api-key"
+
+codex "your prompt"
+```
+
+### OpenClaw
+
+**Pagpipilian 1 — Dashboard (inirerekomenda):**
+
+```
+Dashboard → CLI Tools → OpenClaw → Select Model → Apply
+```
+
+**Pagpipilian 2 — Manwal:** I-edit ang `~/.openclaw/openclaw.json`:
+
+```json
+{
+ "models": {
+ "providers": {
+ "omniroute": {
+ "baseUrl": "http://127.0.0.1:20128/v1",
+ "apiKey": "sk_omniroute",
+ "api": "openai-completions"
+ }
+ }
+ }
+}
+```
+
+> **Tandaan:** Ang OpenClaw ay gumagana lamang sa lokal na OmniRoute. Gamitin ang `127.0.0.1` sa halip na `localhost` upang maiwasan ang mga isyu sa paglutas ng IPv6.
+
+### Cline / Magpatuloy / RooCode
+
+```
+Settings → API Configuration:
+ Provider: OpenAI Compatible
+ Base URL: http://localhost:20128/v1
+ API Key: [from OmniRoute dashboard]
+ Model: if/kimi-k2-thinking
+```
+
+
+
+---
+
+## 📊 Mga Magagamit na Modelo
+
+
+Tingnan ang lahat ng available na modelo
+
+**Claude Code (`cc/`)** - Pro/Max:
+
+- `cc/claude-opus-4-6`
+- `cc/claude-sonnet-4-5-20250929`
+- `cc/claude-haiku-4-5-20251001`
+
+**Codex (`cx/`)** - Plus/Pro:
+
+- `cx/gpt-5.2-codex`
+- `cx/gpt-5.1-codex-max`
+
+**Gemini CLI (`gc/`)** - LIBRE:
+
+- `gc/gemini-3-flash-preview`
+- `gc/gemini-2.5-pro`
+
+**GitHub Copilot (`gh/`)**:
+
+- `gh/gpt-5`
+- `gh/claude-4.5-sonnet`
+
+**NVIDIA NIM (`nvidia/`)** - LIBRENG mga kredito:
+
+- `nvidia/llama-3.3-70b-instruct`
+- `nvidia/mistral-7b-instruct`
+- 50+ pang mga modelo sa [build.nvidia.com](https://build.nvidia.com)
+
+**GLM (`glm/`)** - $0.6/1M:
+
+- `glm/glm-4.7`
+
+**MiniMax (`minimax/`)** - $0.2/1M:
+
+- `minimax/MiniMax-M2.1`
+
+**iFlow (`if/`)** - LIBRE:
+
+- `if/kimi-k2-thinking`
+- `if/qwen3-coder-plus`
+- `if/deepseek-r1`
+- `if/glm-4.7`
+- `if/minimax-m2`
+
+**Qwen (`qw/`)** - LIBRE:
+
+- `qw/qwen3-coder-plus`
+- `qw/qwen3-coder-flash`
+
+**Kiro (`kr/`)** - LIBRE:
+
+- `kr/claude-sonnet-4.5`
+- `kr/claude-haiku-4.5`
+
+**OpenRouter (`or/`)** - 100+ na modelo:
+
+- `or/anthropic/claude-4-sonnet`
+- `or/google/gemini-2.5-pro`
+- Anumang modelo mula sa [openrouter.ai/models](https://openrouter.ai/models)
+
+
+
+---
+
+## 🧪 Mga Pagsusuri (Evals)
+
+Ang OmniRoute ay may kasamang built-in na balangkas ng pagsusuri upang subukan ang kalidad ng pagtugon ng LLM laban sa isang ginintuang hanay. I-access ito sa pamamagitan ng **Analytics → Evals** sa dashboard.
+
+### Built-in na Golden Set
+
+Ang pre-loaded na "OmniRoute Golden Set" ay naglalaman ng 10 test case na sumasaklaw sa:
+
+- Pagbati, matematika, heograpiya, pagbuo ng code
+- Pagsunod sa format ng JSON, pagsasalin, markdown
+- Pagtanggi sa kaligtasan (nakapipinsalang nilalaman), pagbibilang, lohika ng boolean
+
+### Estratehiya sa Pagsusuri
+
+| Diskarte | Paglalarawan | Halimbawa |
+| ---------- | ------------------------------------------------------------ | -------------------------------- |
+| `exact` | Dapat na eksaktong tumugma ang output | `"4"` |
+| `contains` | Ang output ay dapat maglaman ng substring (case-insensitive) | `"Paris"` |
+| `regex` | Ang output ay dapat tumugma sa regex pattern | `"1.*2.*3"` |
+| `custom` | Ang custom na JS function ay nagbabalik ng true/false | `(output) => output.length > 10` |
+
+---
+
+## 🔐 OAuth em Servidor Remoto (Remote OAuth Setup)
+
+
+
+> **⚠️ MAHALAGA para sa usuários com OmniRoute sa VPS/Docker/servidor remoto**
+
+### Para sa que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?
+
+Os provedores **Antigravity** at **Gemini CLI** gamit ang **Google OAuth 2.0** para sa autenticação. O Google exige que a `redirect_uri` usada no fluxo OAuth seja **exatamente** uma das URIs pré-cadastradas no Google Cloud Console do aplicativo.
+
+Bilang credenciais OAuth embutidas no OmniRoute estão cadastradas **apenas para sa `localhost`**. Quando você acessa o OmniRoute em um servidor remoto (hal: `https://omniroute.meuservidor.com`), o Google rejeita a autenticação com:
+
+```
+Error 400: redirect_uri_mismatch
+```
+
+### Solusyon: I-configure ang suas próprias credenciais OAuth
+
+Você precisa criar um **OAuth 2.0 Client ID** walang Google Cloud Console com a URI do seu servidor.
+
+#### Passo a passo
+
+**1. Mag-access sa 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 Client ID**
+
+- Clique em **"+ Lumikha ng Mga Kredensyal"** → **"OAuth client ID"**
+- Tipo de aplicativo: **"Web application"**
+- Pangalan: escolha qualquer nome (hal: `OmniRoute Remote`)
+
+**3. Idagdag bilang Mga Awtorisadong URI sa Pag-redirect**
+
+Walang campo **"Mga Awtorisadong URI sa pag-redirect"**, idagdag:
+
+```
+https://seu-servidor.com/callback
+```
+
+> Substitua `seu-servidor.com` pelo domínio ou IP do seu servidor (kasama ang porta se necessário, hal: `http://45.33.32.156:20128/callback`).
+
+**4. I-save at kopyahin bilang kredensyal**
+
+Após criar, o Google mostrará o **Client ID** at ** Client Secret**.
+
+**5. I-configure bilang variáveis de ambiente**
+
+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**
+
+Dashboard → Mga Provider → Antigravity (ou Gemini CLI) → OAuth
+
+Agora o Google redirectionará corretamente para sa `https://seu-servidor.com/callback` at a autenticação funcionará.
+
+---
+
+### Workaround temporário (sem configurar credenciais próprias)
+
+Se não quiser criar credenciais próprias agora, may posibilidad na magamit o fluxo **manual de URL**:
+
+1. OmniRoute abrirá a URL de authorização do Google
+2. Após você authorizar, o Google tentará redirectionar para sa `localhost` (que falha no servidor remoto)
+3. **Kopyahin ang isang URL completa** sa 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. Clique em **"Kumonekta"**
+
+> Ang workaround na ito ay gumagana sa pamamagitan ng código de authorização na URL ay maaaring mag-redirect sa iyong carregado ou não.
+
+---
+
+## 🐛 Pag-troubleshoot
+
+
+Mag-click upang palawakin ang gabay sa pag-troubleshoot
+
+**"Ang modelo ng wika ay hindi nagbigay ng mga mensahe"**
+
+- Naubos na ang quota ng provider → Suriin ang tracker ng quota ng dashboard
+- Solusyon: Gumamit ng combo fallback o lumipat sa mas murang tier
+
+**Paglilimita sa rate**
+
+- Out na ang quota ng subscription → Fallback sa GLM/MiniMax
+- Magdagdag ng combo: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`
+
+**Nag-expire ang token ng OAuth**
+
+- Auto-refresh ng OmniRoute
+- Kung magpapatuloy ang mga isyu: Dashboard → Provider → Muling kumonekta
+
+**Mataas na gastos**
+
+- Suriin ang mga istatistika ng paggamit sa Dashboard → Mga Gastos
+- Ilipat ang pangunahing modelo sa GLM/MiniMax
+- Gumamit ng libreng tier (Gemini CLI, iFlow) para sa mga hindi kritikal na gawain
+
+**Nagbubukas ang dashboard sa maling port**
+
+- Itakda ang `PORT=20128` at `NEXT_PUBLIC_BASE_URL=http://localhost:20128`
+
+**Mga error sa cloud sync**
+
+- I-verify ang `BASE_URL` na mga puntos sa iyong running instance
+- I-verify ang `CLOUD_URL` na mga puntos sa iyong inaasahang cloud endpoint
+- Panatilihing nakahanay ang mga value ng `NEXT_PUBLIC_*` sa mga value sa gilid ng server
+
+**Hindi gumagana ang unang pag-login**
+
+- Suriin ang `INITIAL_PASSWORD` sa `.env`
+- Kung hindi nakatakda, ang fallback na password ay `123456`
+
+**Walang mga log ng kahilingan**
+
+- Itakda ang `ENABLE_REQUEST_LOGS=true` sa `.env`
+
+**Ang pagsubok sa koneksyon ay nagpapakita ng "Di-wasto" para sa mga provider na katugma sa OpenAI**
+
+- Maraming provider ang hindi naglalantad ng `/models` endpoint
+- Kasama sa OmniRoute v1.0.6+ ang fallback validation sa pamamagitan ng mga pagkumpleto ng chat
+- Tiyaking may kasamang `/v1` suffix ang base URL
+
+
+
+---
+
+## 🛠️ Tech Stack
+
+- **Runtime**: Node.js 18–22 LTS (⚠️ Node.js 24+ ay **hindi suportado** — `better-sqlite3` native binary ay hindi tugma)
+- **Wika**: TypeScript 5.9 — **100% TypeScript** sa `src/` at `open-sse/` (v1.0.6)
+- **Framework**: Next.js 16 + React 19 + Tailwind CSS 4
+- **Database**: LowDB (JSON) + SQLite (domain state + proxy logs)
+- **Streaming**: Mga Kaganapang Ipinadala ng Server (SSE)
+- **Auth**: OAuth 2.0 (PKCE) + JWT + API Keys
+- **Pagsubok**: Node.js test runner (368+ unit test)
+- **CI/CD**: GitHub Actions (auto npm publish + Docker Hub on release)
+- **Website**: [omniroute.online](https://omniroute.online)
+- **Package**: [npmjs.com/package/omniroute](https://www.npmjs.com/package/omniroute)
+- **Docker**: [hub.docker.com/r/diegosouzapw/omniroute](https://hub.docker.com/r/diegosouzapw/omniroute)
+- **Resilience**: Circuit breaker, exponential backoff, anti-thundering herd, TLS spoofing
+
+---
+
+## 📖 Dokumentasyon
+
+| Dokumento | Paglalarawan |
+| -------------------------------------------- | --------------------------------------------------- |
+| [User Guide](docs/USER_GUIDE.md) | Mga provider, combo, CLI integration, deployment |
+| [API Reference](docs/API_REFERENCE.md) | Lahat ng mga endpoint na may mga halimbawa |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Mga karaniwang problema at solusyon |
+| [Architecture](docs/ARCHITECTURE.md) | Arkitektura ng system at mga panloob |
+| [Contributing](CONTRIBUTING.md) | Pag-setup at mga alituntunin ng pag-unlad |
+| [OpenAPI Spec](docs/openapi.yaml) | OpenAPI 3.0 na detalye |
+| [Security Policy](SECURITY.md) | Pag-uulat ng kahinaan at mga kasanayan sa seguridad |
+| [VM Deployment](docs/VM_DEPLOYMENT_GUIDE.md) | Kumpletong gabay: VM + nginx + Cloudflare setup |
+| [Features Gallery](docs/FEATURES.md) | Visual dashboard tour na may mga screenshot |
+
+### 📸 Preview ng Dashboard
+
+
+Mag-click para makita ang mga screenshot ng dashboard
+
+| Pahina | Screenshot |
+| ----------------------- | ------------------------------------------------- |
+| **Mga Provider** |  |
+| **Combos** |  |
+| **Analytics** |  |
+| **Kalusugan** |  |
+| **Tagasalin** |  |
+| **Mga Setting** |  |
+| **Mga CLI Tools** |  |
+| **Mga Log ng Paggamit** |  |
+| **Endpoint** |  |
+
+
+
+---
+
+## 🗺️ Roadmap
+
+Ang OmniRoute ay may **210+ feature na binalak** sa maraming yugto ng pag-unlad. Narito ang mga pangunahing lugar:
+
+| Kategorya | Mga Nakaplanong Tampok | Mga Highlight |
+| -------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------- |
+| 🧠 **Routing at Intelligence** | 25+ | Lowest-latency routing, tag-based na routing, quota preflight, P2C account selection |
+| 🔒 **Seguridad at Pagsunod** | 20+ | SSRF hardening, credential cloaking, rate-limit sa bawat endpoint, management key scoping |
+| 📊 **Pagmamasid** | 15+ | Pagsasama ng OpenTelemetry, real-time na pagsubaybay sa quota, pagsubaybay sa gastos bawat modelo |
+| 🔄 **Mga Pagsasama ng Provider** | 20+ | Dynamic na model registry, provider cooldowns, multi-account Codex, Copilot quota parsing |
+| ⚡ **Pagganap** | 15+ | Dual cache layer, prompt cache, response cache, streaming keepalive, batch API |
+| 🌐 **Ecosystem** | 10+ | WebSocket API, config hot-reload, distributed config store, commercial mode |
+
+### 🔜 Malapit na
+
+- 🔗 **OpenCode Integration** — Suporta ng katutubong provider para sa OpenCode AI coding IDE
+- 🔗 **TRAE Integration** — Buong suporta para sa balangkas ng pag-develop ng TRAE AI
+- 📦 **Batch API** — Asynchronous na pagproseso ng batch para sa maramihang kahilingan
+- 🎯 **Tag-Based Routing** — Mga kahilingan sa ruta batay sa mga custom na tag at metadata
+- 💰 **Diskarte sa Pinakamababang Gastos** — Awtomatikong piliin ang pinakamurang available na provider
+
+> 📝 Available ang buong detalye ng feature sa [**OMNI_TOKEN_147**](docs/new-features/) (217 detalyadong spec)
+
+---
+
+## 📧 Suporta
+
+> 💬 **Sumali sa aming komunidad!** [WhatsApp Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Humingi ng tulong, magbahagi ng mga tip, at manatiling updated.
+
+- **Website**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Mga Isyu**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+- **WhatsApp**: [Community Group](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t)
+- **Orihinal na Proyekto**: [9router by decolua](https://github.com/decolua/9router)
+
+---
+
+## 👥 Mga nag-aambag
+
+[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
+
+### Paano Mag-ambag
+
+1. I-fork ang repositoryo
+2. Gawin ang iyong sangay ng tampok (`git checkout -b feature/amazing-feature`)
+3. Ibigay ang iyong mga pagbabago (`git commit -m 'Add amazing feature'`)
+4. Itulak sa sangay (`git push origin feature/amazing-feature`)
+5. Magbukas ng Pull Request
+
+Tingnan ang [CONTRIBUTING.md](CONTRIBUTING.md) para sa mga detalyadong alituntunin.
+
+### Naglalabas ng Bagong Bersyon
+
+```bash
+# Create a release — npm publish happens automatically
+gh release create v1.0.6 --title "v1.0.6" --generate-notes
+```
+
+---
+
+## 📊 Kasaysayan ng Bituin
+
+
+
+
+
+
+
+
+
+---
+
+## 🙏 Pasasalamat
+
+Espesyal na pasasalamat kay **[9router](https://github.com/decolua/9router)** ni **[decolua](https://github.com/decolua)** — ang orihinal na proyektong nagbigay inspirasyon sa tinidor na ito. Bumubuo ang OmniRoute sa hindi kapani-paniwalang pundasyong iyon na may mga karagdagang feature, multi-modal na API, at buong TypeScript na muling pagsulat.
+
+Espesyal na salamat sa **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — ang orihinal na pagpapatupad ng Go na nagbigay inspirasyon sa JavaScript port na ito.
+
+---
+
+## 📄 Lisensya
+
+Lisensya ng MIT - tingnan ang [LICENSE](LICENSE) para sa mga detalye.
+
+---
+
+---
+
+## 🇧🇷 OmniRoute — Gateway de IA Gratuito
+
+
+
+### Nunca pare de codar. Roteamento intelligente para **modelos de IA GRATUITOS e de baixo custo** com fallback automático.
+
+_Seu proxy universal de API — um endpoint, 36+ provedores, zero downtime._
+
+### 🌐 Internacionalização (i18n)
+
+O dashboard ng OmniRoute suporta **multiplos idiomas**. Ibigay ang mga ito:
+
+| Idyoma | Código | Katayuan |
+| --------------------- | ------- | ----------- |
+| 🇺🇸 Ingles | `en` | ✅ Kumpleto |
+| 🇧🇷 Português (Brasil) | `pt-BR` | ✅ Kumpleto |
+
+**Para trocar o idioma:** Clique no seletor de idioma (🇺🇸 EN) walang header do dashboard → selecione o idioma desejado.
+
+**Para adicionar um novo idioma:**
+
+1. Sumigaw `src/i18n/messages/{codigo}.json` baseado em `en.json`
+2. Addicione 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+ provedores de IA** — Claude, GPT, Gemini, Llama, Qwen, DeepSeek, at iba pa
+- **Roteamento intelligente** — Fallback automatico entre provedores
+- **Tradução de formato** — OpenAI ↔ Claude ↔ Gemini automaticamente
+- **Multi-conta** — Múltiplas contas por provedor com seleção intelligente
+- **Cache semântico** — Reduz custos at latência
+- **OAuth automático** — Token renovam automaticamente
+- **Combos personalizados** — 6 estratégias de roteamento
+- **Dashboard completo** — Monitoramento, logs, análises, configurações
+- **CLI Tools** — I-configure ang Claude Code, Codex, Cursor, Cline com um clique
+- **100% TypeScript** — Código limpo at tipado
+
+### 📖 Documentação
+
+| Dokumento | Paglalarawan |
+| ----------------------------------------------- | ------------------------------------------- |
+| [Guia do Usuário](docs/USER_GUIDE.md) | Provedores, combos, CLI, deploy |
+| [Referência da API](docs/API_REFERENCE.md) | Todos os endpoints com exemplos |
+| [Solução de Problemas](docs/TROUBLESHOOTING.md) | Problema communs at soluções |
+| [Arquitetura](docs/ARCHITECTURE.md) | Arquitetura at internos do sistema |
+| [Contribuição](CONTRIBUTING.md) | Setup ng desenvolvimento at mga alituntunin |
+| [Deploy em VM](docs/VM_DEPLOYMENT_GUIDE.md) | Guia completo: VM + nginx + Cloudflare |
+
+### 📧 Suporta
+
+> 💬 **Entre para a comunidade!** [Grupo WhatsApp](https://chat.whatsapp.com/JI7cDQ1GyaiDHhVBpLxf8b?mode=gi_t) — Tire dúvidas, compartilhe dicas e fique atualizado.
+
+- **Website**: [omniroute.online](https://omniroute.online)
+- **GitHub**: [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute)
+- **Mga Isyu**: [github.com/diegosouzapw/OmniRoute/issues](https://github.com/diegosouzapw/OmniRoute/issues)
+
+---
+
+
+ Built with ❤️ para sa mga developer na nagko-code 24/7
+
+ omniroute.online
+
+
+ # 🚀 OmniRoute — بوابة الذكاء الاصطناعي المجانية
+
+### لا تتوقف أبدًا عن البرمجة. التوجيه الذكي إلى **نماذج الذكاء الاصطناعي المجانية ومنخفضة التكلفة** مع الرجوع التلقائي.
+
+_وكيل واجهة برمجة التطبيقات العالمي الخاص بك — نقطة نهاية واحدة، وأكثر من 36 موفرًا، بدون أي توقف عن العمل._
+
+**إكمالات الدردشة • التضمينات • إنشاء الصور • الصوت • إعادة الترتيب • 100% TypeScript**
+
+---
+
+### 🤖 موفر الذكاء الاصطناعي المجاني لوكلاء البرمجة المفضلين لديك
+
+_قم بتوصيل أي أداة IDE أو CLI مدعومة بالذكاء الاصطناعي من خلال OmniRoute - بوابة واجهة برمجة التطبيقات المجانية للترميز غير المحدود._
+
+ 
تنتهي صلاحية حصة الاشتراك غير المستخدمة كل شهر
+-