Skip to content

Latest commit

 

History

History
1153 lines (827 loc) · 58.9 KB

README.ar.md

File metadata and controls

1153 lines (827 loc) · 58.9 KB
OmniRoute Dashboard

🚀 OmniRoute — بوابة الذكاء الاصطناعي المجانية

لا تتوقف أبدًا عن البرمجة. التوجيه الذكي إلى نماذج الذكاء الاصطناعي المجانية ومنخفضة التكلفة مع الرجوع التلقائي.

وكيل واجهة برمجة التطبيقات العالمي الخاص بك — نقطة نهاية واحدة، وأكثر من 36 موفرًا، بدون أي توقف عن العمل.

إكمالات الدردشة • التضمينات • إنشاء الصور • الصوت • إعادة الترتيب • 100% TypeScript

🤖 موفر الذكاء الاصطناعي المجاني لوكلاء البرمجة المفضلين لديك

قم بتوصيل أي أداة IDE أو CLI مدعومة بالذكاء الاصطناعي من خلال OmniRoute - بوابة واجهة برمجة التطبيقات المجانية للترميز غير المحدود.

OpenClaw
OpenClaw
⭐ 205K 		NanoBot
NanoBot
⭐ 20.9K 		PicoClaw
PicoClaw
⭐ 14.6K 		ZeroClaw
ZeroClaw
⭐ 9.9K 		IronClaw
IronClaw
⭐ 2.1K
OpenCode
OpenCode
⭐ 106K 		Codex CLI
Codex CLI
⭐ 60.8K 		Claude Code
Claude Code
⭐ 67.3K 		Gemini CLI
Gemini CLI
⭐ 94.7K 		Kilo Code
Kilo Code
⭐ 15.5K

📡 يتصل جميع الوكلاء عبر http://localhost:20128/v1 أو http://cloud.omniroute.online/v1 - تكوين واحد ونماذج غير محدودة و الحصة

npm version Docker Hub License Website WhatsApp

🌐 الموقع • 🚀 البداية السريعة • 💡 الميزات • 📖 التوثيق • 💰 الأسعار • 💬 WhatsApp

🌐 متوفر باللغات: 🇺🇸 English | 🇧🇷 Português (Brasil) | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇷🇺 Русский | 🇨🇳 中文 (简体) | 🇩🇪 Deutsch | 🇮🇳 हिन्दी | 🇹🇭 ไทย | 🇺🇦 Українська | 🇸🇦 العربية | 🇯🇵 日本語 | 🇻🇳 Tiếng Việt | 🇧🇬 Български | 🇩🇰 Dansk | 🇫🇮 Suomi | 🇮🇱 עברית | 🇭🇺 Magyar | 🇮🇩 Bahasa Indonesia | 🇰🇷 한국어 | 🇲🇾 Bahasa Melayu | 🇳🇱 Nederlands | 🇳🇴 Norsk | 🇵🇹 Português (Portugal) | 🇷🇴 Română | 🇵🇱 Polski | 🇸🇰 Slovenčina | 🇸🇪 Svenska | 🇵🇭 Filipino

🤔 لماذا 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. التثبيت عالميًا:

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

هذا كل شيء! ابدأ البرمجة باستخدام نماذج الذكاء الاصطناعي المجانية.

** البديل - تشغيل من المصدر: **

cp .env.example .env
npm install
PORT=20128 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run dev

🐳 عامل الميناء

OmniRoute متاح كصورة Docker عامة على Docker Hub.

الجري السريع:

docker run -d \
  --name omniroute \
  --restart unless-stopped \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

** مع ملف البيئة: **

# 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:

# 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
  • استخراج علامة التفكير — كتل <think> → reasoning_content لنماذج التفكير
  • الإخراج المنظم — json_schema → الجوزاء responseMimeType/responseSchema

👥 دعم الحسابات المتعددة

  • إضافة حسابات متعددة لكل مزود
  • التوجيه التلقائي أو التوجيه على أساس الأولوية
  • الرجوع إلى الحساب التالي عندما يصل أحد إلى الحصة

🔄 التحديث التلقائي للرموز

  • يتم تحديث رموز OAuth المميزة تلقائيًا قبل انتهاء الصلاحية
  • لا حاجة لإعادة المصادقة اليدوية
  • تجربة سلسة عبر جميع مقدمي الخدمة

🎨 مجموعات مخصصة

  • إنشاء مجموعات نماذج غير محدودة
  • 6 إستراتيجيات: التعبئة أولاً، جولة روبن، قوة الاختيارين، العشوائية، الأقل استخدامًا، الأمثل من حيث التكلفة
  • مشاركة المجموعات عبر الأجهزة باستخدام Cloud Sync

🏥 لوحة المعلومات الصحية

  • حالة النظام (وقت التشغيل، الإصدار، استخدام الذاكرة)
  • حالات قاطع الدائرة لكل مزود (مغلق/مفتوح/نصف مفتوح)
  • حالة الحد الأقصى للسعر وعمليات الإغلاق النشطة
  • إحصائيات ذاكرة التخزين المؤقت للتوقيع
  • قياس الكمون عن بعد (ص50/ص95/ص99) + ذاكرة تخزين مؤقت سريعة
  • إعادة ضبط الحالة الصحية بنقرة واحدة

🔧 ملعب المترجم

يشتمل OmniRoute على ساحة مترجم قوية مدمجة مع 4 أوضاع لتصحيح الأخطاء واختبار ومراقبة ترجمات واجهة برمجة التطبيقات:

الوضع الوصف
💻 الملعب ترجمة التنسيق المباشر - الصق أي نص طلب واجهة برمجة التطبيقات (API) وشاهد على الفور كيف يقوم OmniRoute بترجمته بين تنسيقات الموفر (OpenAI ↔ Claude ↔ Gemini ↔ Responses API). يتضمن أمثلة على القوالب والكشف التلقائي عن التنسيق.
💬 اختبار الدردشة أرسل طلبات دردشة حقيقية من خلال OmniRoute وشاهد الرحلة الكاملة ذهابًا وإيابًا: مدخلاتك، والطلب المترجم، واستجابة الموفر، والرد المترجم. لا تقدر بثمن للتحقق من صحة توجيه التحرير والسرد.
🧪 مقعد الاختبار وضع الاختبار المجمع - حدد حالات اختبار متعددة بمدخلات مختلفة ومخرجات متوقعة، وقم بتشغيلها كلها مرة واحدة، وقارن النتائج عبر الموفرين والنماذج.
📱 مراقب مباشر مراقبة الطلبات في الوقت الفعلي - شاهد الطلبات الواردة أثناء تدفقها عبر OmniRoute، وشاهد ترجمات التنسيق التي تحدث مباشرة، وحدد المشكلات على الفور.

الوصول: لوحة المعلومات ← المترجم (الشريط الجانبي)

💾 المزامنة السحابية

  • موفري المزامنة والمجموعات والإعدادات عبر الأجهزة
  • مزامنة الخلفية التلقائية
  • تخزين مشفر آمن

📖 دليل الإعداد

💳 موفري الاشتراك

كلود كود (برو/ماكس)

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)

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 ألفًا شهريًا مجانًا!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

أفضل قيمة: طبقة مجانية ضخمة! استخدم هذا قبل المستويات المدفوعة.

مساعد جيثب

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
  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
  2. احصل على مفتاح API
  3. لوحة المعلومات → إضافة موفر → DeepSeek

النماذج: deepseek/deepseek-chat, deepseek/deepseek-coder

Groq (الطبقة المجانية متاحة!)

  1. قم بالتسجيل: console.groq.com
  2. احصل على مفتاح API (الطبقة المجانية متضمنة)
  3. لوحة المعلومات → إضافة موفر → Groq

النماذج: groq/llama-3.3-70b, groq/mixtral-8x7b

نصيحة احترافية: استنتاج فائق السرعة — الأفضل للبرمجة في الوقت الفعلي!

OpenRouter (+100 موديل)

  1. قم بالتسجيل: openrouter.ai
  2. احصل على مفتاح API
  3. لوحة المعلومات → إضافة موفر → OpenRouter

النماذج: يمكنك الوصول إلى أكثر من 100 نموذج من جميع المزودين الرئيسيين من خلال مفتاح واجهة برمجة التطبيقات (API) واحد.

💰 مقدمو الخدمة الرخيصة (النسخ الاحتياطي)

GLM-4.7 (إعادة التعيين اليومي، 0.6 دولار/1 مليون)

  1. قم بالتسجيل: Zhipu AI
  2. احصل على مفتاح API من خطة الترميز
  3. لوحة المعلومات → إضافة مفتاح واجهة برمجة التطبيقات:
    • المزود: glm
    • مفتاح واجهة برمجة التطبيقات: your-key

الاستخدام: glm/glm-4.7

نصيحة احترافية: توفر خطة البرمجة حصة 3× بتكلفة 1/7! إعادة الضبط يوميًا الساعة 10:00 صباحًا.

MiniMax M2.1 (إعادة الضبط لمدة 5 ساعات، 0.20 دولار/1 مليون)

  1. قم بالتسجيل: MiniMax
  2. احصل على مفتاح API
  3. لوحة المعلومات → إضافة مفتاح API

الاستخدام: minimax/MiniMax-M2.1

نصيحة احترافية: الخيار الأرخص للسياق الطويل (مليون رمز)!

كيمي K2 (شقة بقيمة 9 دولارات شهريًا)

  1. الاشتراك: Moonshot AI
  2. احصل على مفتاح API
  3. لوحة المعلومات → إضافة مفتاح API

الاستخدام: kimi/kimi-latest

نصيحة احترافية: سعر ثابت قدره 9 دولارات شهريًا مقابل 10 ملايين رمز مميز = 0.90 دولارًا أمريكيًا/مليون تكلفة فعالة!

🆓 موفرو الخدمة المجانية (النسخ الاحتياطي في حالات الطوارئ)

iFlow (8 نماذج مجانية)

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 موديلات مجانية)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

كيرو (كلود فري)

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 يدويًا.

كوديكس سطر الأوامر

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:

{
  "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

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 طراز:

🧪 التقييمات (التقييمات)

يشتمل 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

**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):

# 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

# 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
  • الحزمة: npmjs.com/package/omniroute
  • عامل الميناء: hub.docker.com/r/diegosouzapw/omniroute
  • المرونة: قاطع الدائرة الكهربائية، والتراجع الأسي، وقطيع مضاد للرعد، وانتحال TLS

📖 التوثيق

وثيقة الوصف
User Guide مقدمو الخدمات، والمجموعات، وتكامل CLI، والنشر
API Reference جميع نقاط النهاية مع الأمثلة
Troubleshooting المشاكل والحلول الشائعة
Architecture بنية النظام والداخلية
Contributing إعداد التطوير والمبادئ التوجيهية
OpenAPI Spec مواصفات OpenAPI 3.0
Security Policy الإبلاغ عن الثغرات الأمنية والممارسات الأمنية
VM Deployment الدليل الكامل: إعداد VM + nginx + Cloudflare
Features Gallery جولة لوحة القيادة المرئية مع لقطات الشاشة

📸 معاينة لوحة التحكم

انقر لرؤية لقطات شاشة لوحة المعلومات
صفحة لقطة شاشة
** مقدمو الخدمة ** Providers
المجموعات Combos
تحليلات Analytics
الصحة Health
مترجم Translator
الإعدادات Settings
أدوات سطر الأوامر CLI Tools
سجلات الاستخدام Usage
نقطة النهاية Endpoint

🗺️خريطة الطريق

يحتوي 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 (217 مواصفات تفصيلية)

📧 الدعم

💬 انضم إلى مجتمعنا! WhatsApp Group — احصل على المساعدة وشارك النصائح وابق على اطلاع.

👥 المساهمون

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 للحصول على إرشادات مفصلة.

إطلاق نسخة جديدة

# Create a release — npm publish happens automatically
gh release create v1.0.6 --title "v1.0.6" --generate-notes

📊 تاريخ النجوم

Star History Chart

🙏 شكر وتقدير

شكر خاص لـ 9router بواسطة decolua — المشروع الأصلي الذي ألهم هذه الشوكة. يعتمد OmniRoute على هذا الأساس المذهل مع ميزات إضافية وواجهات برمجة التطبيقات متعددة الوسائط وإعادة كتابة TypeScript كاملة.

شكر خاص لـ CLIProxyAPI — تطبيق Go الأصلي الذي ألهم منفذ JavaScript هذا.

📄 الترخيص

ترخيص MIT - راجع LICENSE للحصول على التفاصيل.