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

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

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

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

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

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

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

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

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

🤔 لماذا 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

🎯 What OmniRoute Solves — 16 Real Pain Points

Every developer using AI tools faces these problems daily. OmniRoute was built to solve them all — from cost overruns to regional blocks, from broken OAuth flows to zero observability.

💸 1. "I pay for an expensive subscription but still get interrupted by limits"

Developers pay $20–200/month for Claude Pro, Codex Pro, or GitHub Copilot. Even paying, quota has a ceiling — 5h of usage, weekly limits, or per-minute rate limits. Mid-coding session, the provider stops responding and the developer loses flow and productivity.

How OmniRoute solves it:

Smart 4-Tier Fallback — If subscription quota runs out, automatically redirects to API Key → Cheap → Free with zero manual intervention
Real-Time Quota Tracking — Shows token consumption in real-time with reset countdown (5h, daily, weekly)
Multi-Account Support — Multiple accounts per provider with auto round-robin — when one runs out, switches to the next
Custom Combos — Customizable fallback chains with 6 balancing strategies (fill-first, round-robin, P2C, random, least-used, cost-optimized)
Codex Business Quotas — Business/Team workspace quota monitoring directly in the dashboard

🔌 2. "I need to use multiple providers but each has a different API"

OpenAI uses one format, Claude (Anthropic) uses another, Gemini yet another. If a dev wants to test models from different providers or fallback between them, they need to reconfigure SDKs, change endpoints, deal with incompatible formats. Custom providers (FriendLI, NIM) have non-standard model endpoints.

How OmniRoute solves it:

Unified Endpoint — A single http://localhost:20128/v1 serves as proxy for all 36+ providers
Format Translation — Automatic and transparent: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
Response Sanitization — Strips non-standard fields (x_groq, usage_breakdown, service_tier) that break OpenAI SDK v1.83+
Role Normalization — Converts developer → system for non-OpenAI providers; system → user for GLM/ERNIE
Think Tag Extraction — Extracts <think> blocks from models like DeepSeek R1 into standardized reasoning_content
Structured Output for Gemini — json_schema → responseMimeType/responseSchema automatic conversion
stream defaults to false — Aligns with OpenAI spec, avoiding unexpected SSE in Python/Rust/Go SDKs

🌐 3. "My AI provider blocks my region/country"

Providers like OpenAI/Codex block access from certain geographic regions. Users get errors like unsupported_country_region_territory during OAuth and API connections. This is especially frustrating for developers from developing countries.

How OmniRoute solves it:

3-Level Proxy Config — Configurable proxy at 3 levels: global (all traffic), per-provider (one provider only), and per-connection/key
Color-Coded Proxy Badges — Visual indicators: 🟢 global proxy, 🟡 provider proxy, 🔵 connection proxy, always showing the IP
OAuth Token Exchange Through Proxy — OAuth flow also goes through the proxy, solving unsupported_country_region_territory
Connection Tests via Proxy — Connection tests use the configured proxy (no more direct bypass)
SOCKS5 Support — Full SOCKS5 proxy support for outbound routing
TLS Fingerprint Spoofing — Browser-like TLS fingerprint via wreq-js to bypass bot detection

🆓 4. "I want to use AI for coding but I have no money"

Not everyone can pay $20–200/month for AI subscriptions. Students, devs from emerging countries, hobbyists, and freelancers need access to quality models at zero cost.

How OmniRoute solves it:

Free Tier Providers Built-in — Native support for 100% free providers: iFlow (8 unlimited models), Qwen (3 unlimited models), Kiro (Claude for free), Gemini CLI (180K/month free)
Free-Only Combos — Chain gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus = $0/month with zero downtime
NVIDIA NIM Free Credits — 1000 free credits integrated
Cost Optimized Strategy — Routing strategy that automatically chooses the cheapest available provider

🔒 5. "I need to protect my AI gateway from unauthorized access"

When exposing an AI gateway to the network (LAN, VPS, Docker), anyone with the address can consume the developer's tokens/quota. Without protection, APIs are vulnerable to misuse, prompt injection, and abuse.

How OmniRoute solves it:

API Key Management — Generation, rotation, and scoping per provider with a dedicated /dashboard/api-manager page
Model-Level Permissions — Restrict API keys to specific models (openai/*, wildcard patterns), with Allow All/Restrict toggle
API Endpoint Protection — Require a key for /v1/models and block specific providers from the listing
Auth Guard + CSRF Protection — All dashboard routes protected with withAuth middleware + CSRF tokens
Rate Limiter — Per-IP rate limiting with configurable windows
IP Filtering — Allowlist/blocklist for access control
Prompt Injection Guard — Sanitization against malicious prompt patterns
AES-256-GCM Encryption — Credentials encrypted at rest

🛑 6. "My provider went down and I lost my coding flow"

AI providers can become unstable, return 5xx errors, or hit temporary rate limits. If a dev depends on a single provider, they're interrupted. Without circuit breakers, repeated retries can crash the application.

How OmniRoute solves it:

Circuit Breaker per-provider — Auto-open/close with configurable thresholds and cooldown (Closed/Open/Half-Open)
Exponential Backoff — Progressive retry delays
Anti-Thundering Herd — Mutex + semaphore protection against concurrent retry storms
Combo Fallback Chains — If the primary provider fails, automatically falls through the chain with no intervention
Combo Circuit Breaker — Auto-disables failing providers within a combo chain
Health Dashboard — Uptime monitoring, circuit breaker states, lockouts, cache stats, p50/p95/p99 latency

🔧 7. "Configuring each AI tool is tedious and repetitive"

Developers use Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Each tool needs a different config (API endpoint, key, model). Reconfiguring when switching providers or models is a waste of time.

How OmniRoute solves it:

CLI Tools Dashboard — Dedicated page with one-click setup for Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline
GitHub Copilot Config Generator — Generates chatLanguageModels.json for VS Code with bulk model selection
Onboarding Wizard — Guided 4-step setup for first-time users
One endpoint, all models — Configure http://localhost:20128/v1 once, access 36+ providers

🔑 8. "Managing OAuth tokens from multiple providers is hell"

Claude Code, Codex, Gemini CLI, Copilot — all use OAuth 2.0 with expiring tokens. Developers need to re-authenticate constantly, deal with client_secret is missing, redirect_uri_mismatch, and failures on remote servers. OAuth on LAN/VPS is particularly problematic.

How OmniRoute solves it:

Auto Token Refresh — OAuth tokens refresh in background before expiration
OAuth 2.0 (PKCE) Built-in — Automatic flow for Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, iFlow
Multi-Account OAuth — Multiple accounts per provider via JWT/ID token extraction
OAuth LAN/Remote Fix — Private IP detection for redirect_uri + manual URL mode for remote servers
OAuth Behind Nginx — Uses window.location.origin for reverse proxy compatibility
Remote OAuth Guide — Step-by-step guide for Google Cloud credentials on VPS/Docker

📊 9. "I don't know how much I'm spending or where"

Developers use multiple paid providers but have no unified view of spending. Each provider has its own billing dashboard, but there's no consolidated view. Unexpected costs can pile up.

How OmniRoute solves it:

Cost Analytics Dashboard — Per-token cost tracking and budget management per provider
Budget Limits per Tier — Spending ceiling per tier that triggers automatic fallback
Per-Model Pricing Configuration — Configurable prices per model
Usage Statistics Per API Key — Request count and last-used timestamp per key
Analytics Dashboard — Stat cards, model usage chart, provider table with success rates and latency

🐛 10. "I can't diagnose errors and problems in AI calls"

When a call fails, the dev doesn't know if it was a rate limit, expired token, wrong format, or provider error. Fragmented logs across different terminals. Without observability, debugging is trial-and-error.

How OmniRoute solves it:

Unified Logs Dashboard — 4 tabs: Request Logs, Proxy Logs, Audit Logs, Console
Console Log Viewer — Real-time terminal-style viewer with color-coded levels, auto-scroll, search, filter
SQLite Proxy Logs — Persistent logs that survive server restarts
Translator Playground — 4 debugging modes: Playground (format translation), Chat Tester (round-trip), Test Bench (batch), Live Monitor (real-time)
Request Telemetry — p50/p95/p99 latency + X-Request-Id tracing
File-Based Logging with Rotation — Console interceptor captures everything to JSON log with size-based rotation

🏗️ 11. "Deploying and maintaining the gateway is complex"

Installing, configuring, and maintaining an AI proxy across different environments (local, VPS, Docker, cloud) is labor-intensive. Problems like hardcoded paths, EACCES on directories, port conflicts, and cross-platform builds add friction.

How OmniRoute solves it:

npm global install — npm install -g omniroute && omniroute — done
Docker Multi-Platform — AMD64 + ARM64 native (Apple Silicon, AWS Graviton, Raspberry Pi)
Docker Compose Profiles — base (no CLI tools) and cli (with Claude Code, Codex, OpenClaw)
Electron Desktop App — Native app for Windows/macOS/Linux with system tray, auto-start, offline mode
Split-Port Mode — API and Dashboard on separate ports for advanced scenarios (reverse proxy, container networking)
Cloud Sync — Config synchronization across devices via Cloudflare Workers
DB Backups — Automatic backup, restore, export and import of all settings

🌍 12. "The interface is English-only and my team doesn't speak English"

Teams in non-English-speaking countries, especially in Latin America, Asia, and Europe, struggle with English-only interfaces. Language barriers reduce adoption and increase configuration errors.

How OmniRoute solves it:

Dashboard i18n — 30 Languages — All 500+ keys translated including Arabic, Bulgarian, Danish, German, Spanish, Finnish, French, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Malay, Dutch, Norwegian, Polish, Portuguese (PT/BR), Romanian, Russian, Slovak, Swedish, Thai, Ukrainian, Vietnamese, Chinese, Filipino, English
RTL Support — Right-to-left support for Arabic and Hebrew
Multi-Language READMEs — 30 complete documentation translations
Language Selector — Globe icon in header for real-time switching

🔄 13. "I need more than chat — I need embeddings, images, audio"

AI isn't just chat completion. Devs need to generate images, transcribe audio, create embeddings for RAG, rerank documents, and moderate content. Each API has a different endpoint and format.

How OmniRoute solves it:

Embeddings — /v1/embeddings with 6 providers and 9+ models
Image Generation — /v1/images/generations with 4 providers and 9+ models
Audio Transcription — /v1/audio/transcriptions — Whisper-compatible
Text-to-Speech — /v1/audio/speech — Multi-provider audio synthesis
Moderations — /v1/moderations — Content safety checks
Reranking — /v1/rerank — Document relevance reranking
Responses API — Full /v1/responses support for Codex

🧪 14. "I have no way to test and compare quality across models"

Developers want to know which model is best for their use case — code, translation, reasoning — but comparing manually is slow. No integrated eval tools exist.

How OmniRoute solves it:

LLM Evaluations — Golden set testing with 10 pre-loaded cases covering greetings, math, geography, code generation, JSON compliance, translation, markdown, safety refusal
4 Match Strategies — exact, contains, regex, custom (JS function)
Translator Playground Test Bench — Batch testing with multiple inputs and expected outputs, cross-provider comparison
Chat Tester — Full round-trip with visual response rendering
Live Monitor — Real-time stream of all requests flowing through the proxy

📈 15. "I need to scale without losing performance"

As request volume grows, without caching the same questions generate duplicate costs. Without idempotency, duplicate requests waste processing. Per-provider rate limits must be respected.

How OmniRoute solves it:

Semantic Cache — Two-tier cache (signature + semantic) reduces cost and latency
Request Idempotency — 5s deduplication window for identical requests
Rate Limit Detection — Per-provider RPM, min gap, and max concurrent tracking
Editable Rate Limits — Configurable defaults in Settings → Resilience with persistence
API Key Validation Cache — 3-tier cache for production performance
Health Dashboard with Telemetry — p50/p95/p99 latency, cache stats, uptime

🤖 16. "I want to control model behavior globally"

Developers who want all responses in a specific language, with a specific tone, or want to limit reasoning tokens. Configuring this in every tool/request is impractical.

How OmniRoute solves it:

System Prompt Injection — Global prompt applied to all requests
Thinking Budget Validation — Reasoning token allocation control per request (passthrough, auto, custom, adaptive)
6 Routing Strategies — Global strategies that determine how requests are distributed
Wildcard Router — provider/* patterns route dynamically to any provider
Combo Enable/Disable Toggle — Toggle combos directly from the dashboard
Provider Toggle — Enable/disable all connections for a provider with one click
Blocked Providers — Exclude specific providers from /v1/models listing

⚡ بداية سريعة

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 ميجابايت	النسخة الحالية

🖥️ تطبيق سطح المكتب — غير متصل ومتاح دائمًا

🆕 جديد! أصبح OmniRoute متاحًا الآن كـ تطبيق سطح مكتب أصلي لنظام Windows وmacOS وLinux.

🖥️ نافذة أصلية — نافذة مخصصة مع تكامل شريط النظام
🔄 بدء تلقائي — تشغيل OmniRoute عند تسجيل الدخول
🔔 إشعارات أصلية — تنبيهات عند نفاد الحصة
⚡ تثبيت بنقرة واحدة — NSIS (Windows)، DMG (macOS)، AppImage (Linux)
🌐 وضع غير متصل — يعمل بالكامل بدون إنترنت

npm run electron:dev           # وضع التطوير
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg)
npm run electron:build:linux   # Linux (.AppImage)

📖 التوثيق الكامل: electron/README.md

💰 لمحة سريعة عن الأسعار

الطبقة	مقدم	التكلفة	إعادة ضبط الحصص	الأفضل لـ
💳الإشتراك	كلود كود (برو)	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 دولار!

💡 الميزات الرئيسية

🧠 التوجيه الأساسي والذكاء

ميزة	ماذا يفعل
🎯 احتياطي ذكي من 4 طبقات	المسار التلقائي: الاشتراك → مفتاح API → رخيص → مجاني
📊 تتبع الحصص في الوقت الفعلي	عدد الرموز الحية + إعادة تعيين العد التنازلي لكل مزود
🔄 تنسيق الترجمة	OpenAI ↔ كلود ↔ الجوزاء ↔ المؤشر ↔ كيرو سلس + تعقيم الاستجابة
👥 دعم الحسابات المتعددة	حسابات متعددة لكل مزود مع اختيار ذكي
🔄 تحديث تلقائي للرمز	يتم تحديث رموز OAuth المميزة تلقائيًا من خلال إعادة المحاولة
🎨 مجموعات مخصصة	6 إستراتيجيات: التعبئة أولاً، الجولة روبن، P2C، عشوائي، الأقل استخدامًا، الأمثل من حيث التكلفة
🧩 نماذج مخصصة	أضف أي معرف نموذج إلى أي مزود
🌐 جهاز توجيه Wildcard	قم بتوجيه أنماط `provider/*` إلى أي مزود ديناميكيًا
🧠 ميزانية التفكير	أوضاع العبور والتلقائي والمخصص والتكيفي لنماذج الاستدلال
🔀 Model Aliases	Auto-forward deprecated model IDs to current replacements (built-in + custom)
⚡ Background Degradation	Auto-route background tasks (titles, summaries) to cheaper models
💬 الحقن الفوري للنظام	يتم تطبيق موجه النظام العالمي على كافة الطلبات
📄 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	القائمة المسموح بها/القائمة المحظورة للتحكم في الوصول إلى واجهة برمجة التطبيقات
📊 حدود المعدل القابلة للتحرير	عدد الدورات في الدقيقة القابل للتكوين والفجوة الدنيا والحد الأقصى المتزامن على مستوى النظام
💾 Rate Limit Persistence	Learned limits survive restarts via SQLite with 60s debounce + 24h staleness
🔄 Token Refresh Resilience	Per-provider circuit breaker (5 fails→30min) + 30s timeout per attempt
🛡 حماية نقطة نهاية واجهة برمجة التطبيقات	بوابة المصادقة + حظر الموفر لنقطة النهاية `/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، وشاهد ترجمات التنسيق التي تحدث مباشرة، وحدد المشكلات على الفور.

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

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

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

🎯 حالات الاستخدام

الحالة 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...

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

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

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

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 نقطة مجانية!)

قم بالتسجيل: build.nvidia.com
احصل على مفتاح واجهة برمجة التطبيقات (API) مجانًا (يتضمن 1000 نقطة استدلال)
لوحة المعلومات → إضافة موفر → NVIDIA NIM:
- مفتاح واجهة برمجة التطبيقات: nvapi-your-key

النماذج: nvidia/llama-3.3-70b-instruct، nvidia/mistral-7b-instruct، وأكثر من 50 طرازًا آخر

نصيحة احترافية: واجهة برمجة التطبيقات المتوافقة مع OpenAI — تعمل بسلاسة مع ترجمة تنسيق OmniRoute!

ديب سيك

قم بالتسجيل: platform.deepseek.com
احصل على مفتاح API
لوحة المعلومات → إضافة موفر → DeepSeek

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

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

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

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

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

OpenRouter (+100 موديل)

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

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

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

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

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

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

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

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

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

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

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

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

الاشتراك: Moonshot AI
احصل على مفتاح API
لوحة المعلومات → إضافة مفتاح 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

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

يشتمل OmniRoute على إطار تقييم مدمج لاختبار جودة استجابة LLM مقابل المجموعة الذهبية. يمكنك الوصول إليه عبر Analytics → Evals في لوحة التحكم.

الطقم الذهبي المدمج

تحتوي "OmniRoute Golden Set" المحملة مسبقًا على 10 حالات اختبار تغطي:

تحياتي، الرياضيات، الجغرافيا، توليد التعليمات البرمجية
الامتثال لتنسيق JSON والترجمة وتخفيض السعر
رفض السلامة (المحتوى الضار)، العد، المنطق المنطقي

استراتيجيات التقييم

استراتيجية	الوصف	مثال
`exact`	يجب أن يتطابق الإخراج تمامًا مع	`"4"`
`contains`	يجب أن يحتوي الإخراج على سلسلة فرعية (غير حساسة لحالة الأحرف)	`"Paris"`
`regex`	يجب أن يتطابق الإخراج مع نمط regex	`"1.2.3"`
`custom`	ترجع دالة JS المخصصة صواب/خطأ	`(output) => output.length > 10`

🐛 استكشاف الأخطاء وإصلاحها

انقر لتوسيع دليل استكشاف الأخطاء وإصلاحها

"نموذج اللغة لم يقدم رسائل"

استنفدت حصة الموفر → تحقق من تعقب حصة الموفر في لوحة المعلومات
الحل: استخدم خيار التحرير والسرد الاحتياطي أو قم بالتبديل إلى مستوى أرخص

** الحد من المعدل **

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

🔐 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 لـ عندما تصل إلى 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:

يفتح OmniRoute عنوان URL لتفويض Google
قم بتفويض Google لإعادة التوجيه إلى localhost (لا يوجد خادم عن بعد)
انسخ عنوان URL كاملاً من شريط الإدخال في متصفحك (حتى لا يتم نقل الصفحة)
هذا هو عنوان URL الذي يظهر في وضع الاتصال بـ OmniRoute
انقر على "الاتصال"

يعمل هذا الحل البديل لأن رمز التفويض الموجود على عنوان URL يكون صالحًا بشكل مستقل لإعادة التوجيه حيث يتم تحميله أو لا.

🛠️ تيك ستاك

وقت التشغيل: 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	جولة لوحة القيادة المرئية مع لقطات الشاشة

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

انقر لرؤية لقطات شاشة لوحة المعلومات

صفحة	لقطة شاشة
مقدمو الخدمة
المجموعات
تحليلات
الصحة
مترجم
الإعدادات
أدوات سطر الأوامر
سجلات الاستخدام
نقطة النهاية

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

يحتوي OmniRoute على 210+ ميزات مخطط لها عبر مراحل تطوير متعددة. فيما يلي المجالات الرئيسية:

الفئة	الميزات المخططة	أبرز الأحداث
🧠 التوجيه والاستخبارات	25+	التوجيه ذو زمن الاستجابة الأقل، والتوجيه القائم على العلامات، والاختبار المبدئي للحصة، واختيار حساب P2C
🔒 الأمان والامتثال	20+	تقوية SSRF، وإخفاء بيانات الاعتماد، والحد الأقصى للمعدل لكل نقطة نهاية، وتحديد نطاق مفتاح الإدارة
📊 قابلية الملاحظة	15+	تكامل OpenTelemetry ومراقبة الحصص في الوقت الفعلي وتتبع التكلفة لكل نموذج
🔄 تكامل الموفر	20+	تسجيل النموذج الديناميكي، فترات تهدئة الموفر، الدستور الغذائي متعدد الحسابات، تحليل حصة الطيار المساعد
⚡ الأداء	15+	طبقة ذاكرة التخزين المؤقت المزدوجة، ذاكرة التخزين المؤقت السريعة، ذاكرة التخزين المؤقت للاستجابة، استمرار البث، واجهة برمجة التطبيقات الدفعية
🌐 النظام البيئي	10+	WebSocket API، إعادة تحميل التكوين السريع، مخزن التكوين الموزع، الوضع التجاري

🔜قريبا

🔗 تكامل OpenCode — دعم الموفر الأصلي لـ OpenCode AI IDE للترميز
🔗 تكامل TRAE — الدعم الكامل لإطار تطوير TRAE AI
📦 Batch API — معالجة الدفعات غير المتزامنة للطلبات المجمعة
🎯 التوجيه المعتمد على العلامات — توجيه الطلبات بناءً على العلامات المخصصة والبيانات الوصفية
💰 إستراتيجية أقل تكلفة — تحديد أرخص مزود متاح تلقائيًا

📝 مواصفات الميزات الكاملة متوفرة في link (217 مواصفات تفصيلية)

📧 الدعم

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

الموقع الإلكتروني: omniroute.online
جيثب: github.com/diegosouzapw/OmniRoute
المشاكل: github.com/diegosouzapw/OmniRoute/issues
واتساب: Community Group
المشروع الأصلي: 9router by decolua

👥 المساهمون

كيفية المساهمة

شوكة المستودع
قم بإنشاء فرع الميزات الخاص بك (git checkout -b feature/amazing-feature)
تنفيذ التغييرات (git commit -m 'Add amazing feature')
ادفع إلى الفرع (git push origin feature/amazing-feature)
افتح طلب السحب

راجع CONTRIBUTING.md للحصول على إرشادات مفصلة.

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

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

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

🙏 شكر وتقدير

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

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

📄 الترخيص

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

FilesExpand file tree

README.ar.md

Latest commit

History

README.ar.md

File metadata and controls

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

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

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

🤔 لماذا OmniRoute؟

🔄 كيف يعمل

🎯 What OmniRoute Solves — 16 Real Pain Points

⚡ بداية سريعة

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

🖥️ تطبيق سطح المكتب — غير متصل ومتاح دائمًا

💰 لمحة سريعة عن الأسعار

💡 الميزات الرئيسية

🧠 التوجيه الأساسي والذكاء

🎵 واجهات برمجة التطبيقات متعددة الوسائط

🛡️ المرونة والأمان

📊 إمكانية الملاحظة والتحليلات

☁️ النشر والمزامنة

🎯 نظام احتياطي ذكي مكون من 4 طبقات

📊 تتبع الحصص في الوقت الحقيقي

🔄 ترجمة التنسيق

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

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

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

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

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

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

🎯 حالات الاستخدام

الحالة 1: "لدي اشتراك Claude Pro"

الحالة 2: "أريد تكلفة صفرية"

الحالة 3: "أحتاج إلى تشفير على مدار 24 ساعة طوال أيام الأسبوع، دون انقطاع"

الحالة 4: "أريد ذكاءً اصطناعيًا مجانيًا في OpenClaw"

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

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

OpenAI Codex (Plus/Pro)

Gemini CLI (180 ألفًا شهريًا مجانًا!)

مساعد جيثب

NVIDIA NIM (1000 نقطة مجانية!)

ديب سيك

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

OpenRouter (+100 موديل)

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

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

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

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

كوين (3 موديلات مجانية)

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

مثال 1: زيادة الاشتراك إلى الحد الأقصى → النسخ الاحتياطي الرخيص

المثال 2: مجاني فقط (بدون تكلفة)

بيئة تطوير متكاملة للمؤشر

كلود كود

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

OpenClaw

كلاين / متابعة / RooCode

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

الطقم الذهبي المدمج

استراتيجيات التقييم

🐛 استكشاف الأخطاء وإصلاحها

🔐 OAuth em Servidor Remoto (إعداد OAuth عن بعد)

لماذا OAuth يفعل Antigravity / Gemini CLI في الخوادم البعيدة؟

الحل: تكوين OAuth الخاص بك

باسو باسو

الحل المؤقت (لم يتم تكوين الاعتمادات الخاصة)

🛠️ تيك ستاك

📖 التوثيق

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

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

🔜قريبا

📧 الدعم

👥 المساهمون

كيفية المساهمة

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

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

🙏 شكر وتقدير

📄 الترخيص