README (اردو)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

🚀 OmniRoute — مفت AI گیٹ وے

OmniRoute — کوڈنگ کبھی نہ روکیں۔ ہر AI ٹول → 380 فراہم کنندگان — 150+ مفت — ایک ہی endpoint کے ذریعے۔ Claude Code، Codex، Cursor، Cline، Copilot اور Antigravity کو خودکار fallback کے ساتھ مفت Claude / GPT / Gemini سے جوڑیں۔ RTK + Caveman کی تہہ دار compression سے 15–95% tokens (~89% اوسط) بچتے ہیں — کبھی limits تک نہ پہنچیں۔ 380 AI فراہم کنندگان · 150+ مفت tiers · ~1.62B مفت tokens/ماہ · 20 routing strategies · آغاز کے لیے $0۔

💰 فریقِ ثالث کے مفت درجات میں مجموعی طور پر ~1.62B ٹوکنز / ماہ

اپنے فراہم کنندہ اکاؤنٹس استعمال کریں۔ یہ الگ الگ اہلیت رکھنے والے فریقِ ثالث کے مفت درجات کا تخمینی مجموعہ ہے، OmniRoute کی جانب سے کوئی ٹوکن گرانٹ نہیں۔ سائن اپ کریں، جہاں ضروری ہو اسناد حاصل کریں، اور ان فراہم کنندگان کو منسلک کریں جنہیں آپ استعمال کر سکتے ہیں؛ ہر فراہم کنندہ اپنی حدود، دستیابی اور شرائط خود کنٹرول کرتا ہے۔

مفت درجات کو دستی طور پر یکجا کرنا تکلیف دہ ہے — درجنوں SDKs، درجنوں شرح حدود، اور یہ بھی معلوم نہیں ہوتا کہ حقیقت میں آپ کے پاس کتنا موجود ہے۔ OmniRoute، 34 اعادی پول کلیدوں میں 484 مفت درجے کے اندراجات کی فہرست بناتا ہے اور ٹوکن کی نمایاں تعداد کا حساب شائع شدہ مثبت ماہانہ بجٹ والے 17 پولز، نیز Groq کی فی ماڈل پانچ حدود سے لگاتا ہے، جبکہ مشترکہ پول کے لحاظ سے تکرار ختم کی جاتی ہے۔ وہ کوٹے جو صرف علاقائی شناختی جانچ کے بعد دستیاب ہوتے ہیں (فی الحال: ModelScope)، الگ دکھائے جاتے ہیں، علاقائی شناختی تصدیق کے پیچھے +~6M، اور انہیں کبھی بھی نمایاں مجموعے میں شامل نہیں کیا جاتا۔ نتیجہ ڈیش بورڈ (/dashboard/free-tiers) پر نظر آتا رہتا ہے۔

براہِ راست /dashboard/free-tiers صفحے کا متحرک خلاصہ۔ مکمل طریقۂ کار (پول کی تکرار کا خاتمہ، کریڈٹ درجات، فراہم کنندہ کی شرائط): docs/reference/FREE_TIERS.md۔

_{ان اعداد و شمار کا براہِ راست کیٹلاگ کے مقابل ہر دو ہفتے بعد دوبارہ آڈٹ کیا جاتا ہے اور یہ دونوں سمتوں میں تبدیل ہوتے ہیں — کوئی فراہم کنندہ مفت درجہ ختم کرے تو تعداد کم ہو جاتی ہے؛ نیا شامل ہو تو بڑھ جاتی ہے۔ ہم وہی شائع کرتے ہیں جس کا کیٹلاگ حقیقت میں حساب لگاتا ہے، کبھی بھی اوپر کی طرف گول کیا ہوا بہترین ممکنہ منظرنامہ نہیں۔}

⭐ اگر OMNIROUTE نے پیسے بچانے اور آپ کا کام آسان بنانے میں مدد کی ہے تو ریپو کو اسٹار دیں۔

💬 کمیونٹی میں شامل ہوں

👋 مینٹینر کو فالو کریں — نئے فراہم کنندگان، ریلیزز اور تجاویز سب سے پہلے حاصل کریں:

سوالات، فراہم کنندگان سے متعلق تجاویز، روڈ میپ اور معاونت → Discord · Telegram · WhatsApp 🌍 عالمی / 🇧🇷 برازیل / پورٹل

📈 گیٹ وے بڑھتا رہتا ہے۔

	v3.8.50	v3.8.51	`v3.8.53+`
🌐 فراہم کرنے والے	352	358	380
🧠 منفرد چیٹ ماڈل IDs	1320	1374	1475
🖼️ موڈالٹی پل	🆕 وژن + آڈیو + ویڈیو	✓	✓
📡 ریڈار مفت کیٹلاگ	🆕 آپٹ ان	✓	✓
⚖️ کوٹہ سے آگاہ شیڈولنگ	🆕 کوٹہ-شیئر	✓	✓
📊 کوٹہ ٹیلی میٹری	🆕 زندہ	✓	✓
🧰 ہیڈ لیس موڈ	—	—	🆕 `serve --headless`
🛤️ LTS ریل انفرا	—	—	🆕 ریلیز چینلز
🔎 ماڈل دریافت API	—	—	🆕 `/v1/models/query`

→ روڈ میپ - v3.9.0 LTS تک ریل کی سواری۔

🧩 دستیاب

🚀 آغاز	🚀 فوری آغاز	📦 انسٹال کریں	🆓 فراہم کنندہ منسلک کریں
💡 سیکھیں	💥 وعدہ	🤔 OmniRoute کیوں	🏆 امتیازی خصوصیات
⚙️ خصوصیات	🎯 کومبوز	🌐 فراہم کنندگان	🔌 CLI اور MCP
	🗜️ کمپریشن	🖥️ یہ کہاں چلتا ہے	🔒 نجی
👀 دیکھیں	🎬 عملی مظاہرہ	✨ نیا کیا ہے	🤖 ہم آہنگ CLIs
💚 معاونت	💚 معاونت / عطیہ	💬 کمیونٹی	💖 اسپانسرز
📦 پروجیکٹ	🛠️ ٹیکنالوجی اسٹیک	📖 دستاویزات	👥 معاونین

🌐 67 زبانوں میں

🆓 انسٹال کریں، کوئی فراہم کنندہ جوڑیں، پھر ایک اینڈ پوائنٹ کے ذریعے روٹ کریں

# فراہم کنندہ جوڑنے کے بعد، اپنی OmniRoute key کو Dashboard → Endpoints سے کاپی کریں:
curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{auto کو ایک اہل روٹ درکار ہے۔ نئی انسٹالیشن میں کوئی اہل keyless ہدف موجود نہیں ہو سکتا، اور کوئی keyless فراہم کنندہ تھرڈ پارٹی کلائنٹس کو مسترد کر سکتا ہے۔ tos: avoid کے بطور نشان زد فراہم کنندگان، بشمول Kiro، بطور ڈیفالٹ خودکار روٹنگ سے خارج ہیں؛ اکاؤنٹ جوڑنا اس ترتیب کو کالعدم نہیں کرتا۔ فراہم کنندہ منتخب کرنے سے پہلے مفت ٹائرز گائیڈ دیکھیں۔}

_{📦 Python, Node.js, PHP, اور cURL کے لیے کاپی پیسٹ کوئک اسٹارٹ اسکرپٹس → examples/quickstart/}

💥 وعدہ

🤔 OmniRoute کیوں؟

OmniRoute درخواست کا بہاؤ: آپ کا IDE یا CLI (Claude Code، Cursor، Cline…) ایک مقامی اینڈ پوائنٹ (http://localhost:20128/v1) کو کال کرتا ہے؛ OmniRoute Smart Router (RTK + Caveman کمپریشن، 20 روٹنگ حکمت عملیاں، circuit breakers، TLS stealth، MCP، A2A، guardrails) 4 فراہم کنندہ ٹئرز میں فال بیک کر سکتا ہے جب تک کوئی اہل صحت مند ہدف موجود رہے — Tier 1 سبسکرپشن، Tier 2 API Key، Tier 3 سستا اور Tier 4 مفت۔

🤝 ہمارے اوپن سورس دوستوں کا تعاون

کیا آپ بطور اوپن سورس دوست شامل ہونا چاہتے ہیں؟ یہ وہ کمپنیاں ہیں جو اوپن سورس کی حمایت کرتی ہیں اور OmniRoute کو متحرک رکھنے میں مدد کرتی ہیں — اور ہم عوامی طور پر بتاتے ہیں کہ ان کا دیا ہوا ہر ٹوکن کہاں جاتا ہے۔ رابطہ کریں: diegosouza.pw@outlook.com

Kimi
_{Moonshot AI} اس پروجیکٹ کی حمایت کرنے کے لیے ہمارے بانی اوپن سورس دوست، Kimi (Moonshot AI) کا شکریہ! Kimi وہ AI لیب ہے جو اوپن ویٹ K2 اور K3 ماڈل فیملیز کے پیچھے ہے — Kimi K3 ایک 1M-ٹوکن سیاق و سباق کی ونڈو، مقامی وژن اور فرنٹیئر لیول کی کوڈنگ فراہم کرتا ہے جو کلوزڈ ماڈلز کی قیمتوں کے ایک معمولی حصے پر دستیاب ہے، اور یہ Claude Code، Codex اور OmniRoute کے ذریعے فراہم کردہ ہر کوڈنگ ٹول کے ساتھ فوری طور پر کام کرتا ہے۔

Kimi کا تعاون کن چیزوں کو طاقت دیتا ہے: Kimi کے API کریڈٹس OmniRoute کی AI سے تصدیق شدہ ریلیز پائپ لائن کو طاقت دیتے ہیں — یعنی merge validation powered by Kimi K3 کا مرحلہ جو ہر پل ریکوئسٹ (pull request) کے بھیجے جانے سے پہلے اس کا جائزہ لیتا ہے — اس کے علاوہ روزانہ کی فیچر ڈویلپمنٹ۔ فرسٹ کلاس Kimi سپورٹ دونوں طریقوں پر دستیاب ہے: براہ راست Kimi API (kimi-k3) اور Kimi Code کوڈنگ پلان (OAuth اور API key)۔ OmniRoute، Kimi کے سپورٹ پروگرام میں پہلا برازیلی اوپن سورس پروجیکٹ بھی ہے۔ 15% اضافی کریڈٹس کے ساتھ Kimi API کلید حاصل کریں ←

Cheaper Inference
_{cheaperinference.com} اس پروجیکٹ کی حمایت کرنے کے لیے OmniRoute کے اوپن سورس دوست، Cheaper Inference کا شکریہ! Cheaper Inference ایک لاگت کے لحاظ سے درجہ بندی شدہ گیٹ وے ہے جو 42 فرنٹیئر ماڈلز — Claude، GPT-5.x، Gemini، Kimi K3، GLM، DeepSeek، Grok اور MiniMax — کو ایک OpenAI کے ہم آہنگ اینڈ پوائنٹ کے پیچھے دوبارہ فروخت کرتا ہے، ہر درخواست کو سستے ترین اہل فراہم کنندہ کی طرف بھیجتا ہے بغیر ماڈل بنانے والے کی لسٹ پرائس سے زیادہ چارج کیے۔

OmniRoute میں فرسٹ کلاس سپورٹ: Chat Completions، مقامی /v1/responses اینڈ پوائنٹ، وژن، ٹول کالنگ اور 3 امیج ماڈلز (grok-imagine، nano-banana-pro، nano-banana-2، جو cheaperinference/<model> کے طور پر قابل رسائی ہیں)۔ ایک API کلید حاصل کریں ←

_{ٹیگ شدہ لنکس aff=omniroute پارٹنر لنکس ہیں۔ وہ آپ کے لیے بغیر کسی اضافی قیمت کے پروجیکٹ کے لیے فنڈز فراہم کرتے ہیں۔}

_{🎟️ ایفی لیٹس پرومو — ان فراہم کنندگان سے مفت سائن اپ کوپن جنہیں ہم سپانسر نہیں کرتے (پھیلانے کے لیے کلک کریں)}

_{یہ سیکشن صرف ریفرل/کوپن کوڈز کے لیے ہے۔ سپانسر شدہ شراکت داریاں اوپر 🤝 ہمارے اوپن سورس دوستوں کا تعاون میں موجود ہیں۔ OmniRoute کی یہاں درج فراہم کنندگان کے ساتھ کوئی سپانسرشپ یا شراکت داری نہیں ہے — یہ عوامی کوپن ہیں جنہیں کوئی بھی استعمال کر سکتا ہے۔}

_AgentRouter
_{agentrouter.org} _{AgentRouter — ایفی لیٹ سائن اپ · $100 مفت کریڈٹس سائن اپ پر (مفت سرور، زیادہ لیٹنسی کی توقع رکھیں — ٹیسٹنگ کے لیے بہترین، پروڈکشن کے لیے نہیں)۔ v3.8.50 سے OmniRoute میں فرسٹ کلاس سپورٹ: Chat Completions، Anthropic کے ہم آہنگ وائر فارمیٹ اور OpenAI کے ہم آہنگ پاتھ۔ دستیاب ماڈلز میں claude-opus-4-8، claude-opus-5، gpt-5.6-sol اور بہت کچھ شامل ہیں۔ اپنے $100 حاصل کریں ←}

_{⚠️ ایفی لیٹ لنک — OmniRoute کی اس فراہم کنندہ کے ساتھ کوئی سپانسرشپ یا شراکت داری نہیں ہے۔}

_{کیا آپ کسی اور فراہم کنندہ کو جانتے ہیں جس کے پاس فراخدلانہ مفت سائن اپ کوپن ہے جو OmniRoute صارفین کو فائدہ پہنچاتا ہے؟ ایک ایشو (issue) کھولیں اور ہم اسے یہاں شامل کر دیں گے۔}

🎯 کومبوز — نمایاں خصوصیت

کومبو ماڈلز کی ایک زنجیر ہے جن کے درمیان OmniRoute خودکار طور پر روٹنگ کرتا ہے۔ اگر کوٹا ختم ہو جائے، کوئی فراہم کنندہ ناکام ہو جائے، یا اخراجات اچانک بڑھ جائیں، تو کومبو اگلے اہل اور صحت مند ماڈل پر منتقل ہو سکتا ہے۔ 🛡️

⚡ صفر کنفیگریشن — بس `auto` استعمال کریں

کوئی کومبو بنانے کی ضرورت نہیں۔ اپنے ماڈل کو auto (یا اس کی کسی قسم) پر سیٹ کریں، اور OmniRoute آپ کے منسلک فراہم کنندگان سے ایک ورچوئل کومبو بناتا ہے، جس کی لائیو اسکورنگ کی جاتی ہے:

ماڈل ID	یہ کس چیز کو بہتر بناتا ہے
`auto`	🎯 متوازن ڈیفالٹ (LKGP — آپ کے آخری اچھے فراہم کنندہ سے وابستہ رہتا ہے)
`auto/coding`	🧑💻 کوڈ تیار کرنے کے لیے معیار کو ترجیح دینے والے اوزان
`auto/fast`	⚡ سب سے کم تاخیر پہلے
`auto/cheap`	💰 فی ٹوکن سب سے سستا پہلے
`auto/subscription`	🎟️ صرف وہ سبسکرپشن کوٹا جس کی آپ پہلے ہی ادائیگی کرتے ہیں — بند حالت میں ناکام ہوتا ہے، کبھی قابلِ بل فال بیک استعمال نہیں کرتا (رہنما)
`auto/thrifty`	🪜 پہلے پلان کا کوٹا، پھر ایک وقت میں ایک درجہ طے کرتے ہوئے سب سے سستے بامعاوضہ اختیارات تک — پلان ری سیٹ ہونے کے بعد دوبارہ اسی پر واپسی (رہنما)
`auto/offline`	🔋 سب سے زیادہ کوٹا / شرح کی حد کی گنجائش پہلے
`auto/smart`	🔭 معیار پہلے + بہتر ماڈلز دریافت کرنے کے لیے 10% کھوج
`auto/lkgp`	📌 واضح طور پر آخری معلوم اچھے فراہم کنندہ سے وابستگی
`auto/chaos`	🧪 ماڈلز کے ایک پینل تک متوازی پھیلاؤ (فی فراہم کنندہ ایک، ڈیفالٹ طور پر 5)، ایک جواب واپس کرتا ہے؛ فی پینل ماڈل ایک اپ اسٹریم کال، خرابی داخل کرنا نہیں

🔀 یا اپنا بنائیں — روٹنگ کی 20 حکمتِ عملیاں

تمام 20 حکمتِ عملیاں — ہر کومبو مرحلے پر حسبِ خواہش ملائیں:

#	حکمتِ عملی	یہ کیا کرتی ہے
1	`priority`	پہلے ہدف کی ترتیب وار فہرست — اگلے سے پہلے ہر ایک کو مکمل استعمال کریں 🥇
2	`fill-first`	آگے بڑھنے سے پہلے ہر ہدف کا کوٹا مکمل طور پر استعمال کریں
3	`weighted`	فی ہدف وزن کے مطابق وزنی بے ترتیب انتخاب
4	`round-robin`	اہداف کو ترتیب سے باری باری استعمال کریں
5	`p2c`	دو انتخاب کی قوت پر مبنی بے ترتیب لوڈ بیلنسنگ
6	`least-used`	سب سے کم موجودہ لوڈ والا ہدف منتخب کریں
7	`random`	یکساں بے ترتیب انتخاب (نقلیں ہٹا کر)
8	`strict-random`	تکرار کی نقلیں ہٹائے بغیر بے ترتیب انتخاب 🎲
9	`cost-optimized`	لائیو کیٹلاگ قیمتوں سے فی درخواست $ کو کم سے کم کریں 💸
10	`headroom`	سب سے زیادہ باقی کوٹا والا ہدف منتخب کریں
11	`quota-weighted`	ختم شدہ اکاؤنٹس چھوڑ دیں، پھر باقی کوٹا ÷ زیرِ عمل لوڈ کے تناسب سے انتخاب کریں — موجودہ گفتگوئیں اسی ہدف سے منسلک رہتی ہیں ⚖️
12	`reset-window`	اس ہدف کو ترجیح دیں جس کی کوٹا ونڈو سب سے جلد ری سیٹ ہوتی ہے
13	`reset-aware`	کوٹا ری سیٹ کے وقت کے مطابق درجہ بندی کریں — مختصر ونڈوز پہلے 📊
14	`context-relay`	طویل گفتگوؤں کے لیے سیاق و سباق کو اہداف کے درمیان منتقل کریں 🧠
15	`context-optimized`	موجودہ سیاق و سباق کے حجم کے لیے موزوں ترین ہدف منتخب کریں
16	`cache-optimized`	ہر دوبارہ قابلِ استعمال پرامپٹ سابقے کو اسی اکاؤنٹ سے منسلک رکھیں — پرامپٹ کیش ہٹس کو زیادہ سے زیادہ کریں 🎯
17	`lkgp`	آخری معلوم اچھا راستہ — آخری کامیاب فراہم کنندہ سے منسلک رکھتا ہے، پھر قواعد پر فال بیک کرتا ہے
18	`auto`	ہر کنکشن میں 16 عوامل پر مبنی لائیو اسکورنگ 🤖
19	`fusion`	ماڈلز کے ایک پینل تک پھیلاؤ + ایک جج ایک جواب مرتب کرتا ہے 🧬
20	`pipeline`	مراحل کو زنجیر بنائیں — ہر ہدف کا آؤٹ پٹ اگلے کو فراہم ہوتا ہے 🔗

_{Auto-Combo انجن ہر امیدوار کو 16 عوامل (صحت، کوٹا، لاگت، تاخیر، کام سے مطابقت، معیار، سیشن کی دستیابی…) کی بنیاد پر اسکور دیتا ہے — دیکھیے docs/routing/AUTO-COMBO.md۔}

🧱 لچک پذیری پہلے سے شامل ہے (3 خود مختار تہیں)

_{📖 Auto-Combo انجن · لچک پذیری کی رہنما دستاویز}

🏆 OmniRoute کو منفرد کیا بناتا ہے

_{📊 مکمل طریقۂ کار اور ہر فیچر کی تفصیل بمقابلہ 9router، OpenRouter، CLIProxyAPI اور LiteLLM → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md}

💚 OmniRoute کی معاونت کریں

OmniRoute کو MIT لائسنس حاصل ہے اور اسے کھلے عام برقرار رکھا جاتا ہے۔ اگر یہ آپ کا وقت یا پیسہ بچاتا ہے، تو اسے خودمختار رکھنے کے طریقے یہ ہیں — جو آپ کے لیے موزوں ہو، اسے منتخب کریں۔ اسپانسرشپ کبھی بھی روٹنگ کی ترجیح پر اثرانداز نہیں ہوتی؛ اس سے صرف نمایاں حیثیت ملتی ہے، درجہ بندی نہیں۔

⭐ ریپوزٹری کو اسٹار کریں	مفت — اس سے واقعی نمایاں ہونے میں مدد ملتی ہے	OmniRoute کو اسٹار کریں
🐙 GitHub Sponsors	ایک مرتبہ یا ماہانہ · پلیٹ فارم فیس صفر	github.com/sponsors/diegosouzapw
☕ Ko-fi	فوری یک وقتی عطیہ، عطیہ دہندہ کے لیے سائن اپ ضروری نہیں	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	چھوٹا، غیر رسمی تعاون	buymeacoffee.com/diegosouzapw
🖐 Liberapay	بار بار ہونے والی ادائیگی · غیر منافع بخش · اوپن سورس	liberapay.com/diegosouzapw
🇧🇷 PIX (برازیل)	فوری، کوئی فیس نہیں	کلید اور QR ذیل میں
₿ کرپٹو	BTC · ETH · USDT-TRC20 · USDC-Solana	پتے ذیل میں

🇧🇷 PIX — فوری، کوئی فیس نہیں (برازیل)

کلید (بے ترتیب): 5d865059-bc44-483a-962d-43ceb80126eb

Pix کاپی اور پیسٹ:

00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD

₿ کرپٹو — BTC · ETH · USDT-TRC20 · USDC-Solana (توسیع کے لیے کلک کریں)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ ہر کوائن صرف دکھائے گئے نیٹ ورک پر بھیجیں — غلط نیٹ ورک پر بھیجنے سے فنڈز ضائع ہو سکتے ہیں۔}

🐛 کوئی بگ ملا یا آپ کے پاس رائے ہے؟ ایک Discussion کھولیں۔

ڈویلپر نوٹس: ڈویلپر کی سہولت کے لیے پروجیکٹ npm install/postinstall کے دوران ایک مقامی .env فائل بنا سکتا ہے۔ اس فائل کو جان بوجھ کر .gitignore کے ذریعے نظر انداز کیا جاتا ہے (.gitignore دیکھیں) اور اسے کبھی بھی کمٹ نہیں کرنا چاہیے — اگر یہ غلطی سے کمٹ ہو جائے تو ظاہر ہونے والے تمام راز تبدیل کریں اور فائل کو ہسٹری سے ہٹا دیں۔ مقامی ماحول کی فائلوں اور رازوں کے انتظام سے متعلق رہنمائی کے لیے docs/DEVELOPER-ENVIRONMENT.md دیکھیں۔

📡 OmniRoute Radar

اوپر درج دستاویزی اور پول کی سطح پر نقل سے پاک کیٹلاگ سے مفت درجے کی بنیادی پیشکش بدستور ~1.62B ٹوکنز/ماہ ہے۔ فراہم کنندگان کے عارضی سائن اَپ کریڈٹس پہلے مہینے کی حد کو علیحدہ طور پر بڑھا کر ~2.22B تک لے جا سکتے ہیں۔ Radar ایک اختیاری، دستخط شدہ کیٹلاگ اوورلے ہے، جو ان لوگوں کے لیے ہے جو OmniRoute کی ریلیزز کے درمیانی عرصے میں مفت ماڈلز کی تازہ ترین دستیابی چاہتے ہیں؛ کمیونٹی کیٹلاگ اور تمام موجودہ مفت خصوصیات بدستور مفت رہیں گی۔

معاونین لائیو کیٹلاگ اور فراہم کنندگان کے اضافی مواقع حاصل کر سکتے ہیں۔ اس کی علیحدہ، تبدیل ہونے والی بالائی حد فراہم کنندگان کی دستیابی کے لحاظ سے زیادہ سے زیادہ تقریباً 3B ٹوکنز/ماہ ہے۔ یہ بالائی حد ضمانت نہیں ہے: فراہم کنندگان کسی بھی وقت کوٹے، اہلیت، ماڈلز یا خطے تبدیل کر سکتے ہیں۔

Radar اختیاری ہے اور صرف GET استعمال کرتا ہے۔ OmniRoute کلائنٹ پرامپٹس، ٹریفک، فراہم کنندہ کی کنفیگریشن، استعمال کی ٹیلی میٹری، یا اعلانات مسترد کرنے کی مقامی حالت اپ لوڈ نہیں کرتا۔ اہلیت اور موجودہ کیٹلاگ کے بارے میں radar.omniroute.online/planos پر جانیں۔

✨ نیا کیا ہے

v3.8.20 → v3.8.53 کی حالیہ نمایاں خصوصیات۔ مکمل تاریخ CHANGELOG.md میں دیکھیں۔

⚖️ quota-weighted روٹنگ — 20ویں کومبو حکمتِ عملی ختم شدہ اکاؤنٹس کو نظر انداز کر دیتی ہے، پھر باقی اکاؤنٹس میں سے بچے ہوئے کوٹہ ÷ زیرِ التوا لوڈ کے تناسب سے انتخاب کرتی ہے، اور موجودہ گفتگوؤں کو جوں کی توں پن رکھتی ہے۔ → Auto-Combo
🧰 ہیڈلیس موڈ — omniroute serve --headless (یا OMNIROUTE_HEADLESS=1) صرف /v1/* پراکسی انجن چلاتا ہے، جبکہ ڈیش بورڈ اور صرف-ڈیش بورڈ والے ذیلی نظام بند رہتے ہیں۔ → ہیڈلیس موڈ
🔎 ماڈل دریافت — /v1/models صلاحیت، کانٹیکسٹ، قسم اور متن کے لحاظ سے فلٹر کرتا ہے، اور POST /v1/models/query اسی فی-کلید مرئیت کے ساتھ ایک مختصر deterministic فہرست لوٹاتا ہے۔ → API حوالہ
🔑 فی-کلید روٹنگ کنٹرول — forcedModel کے ذریعے کسی API کلید کو ایک ماڈل یا کومبو سے پن کریں، اور کسی کلید کے ماڈلز اور کومبوز atomic طور پر شامل یا ہٹائیں (/api/keys/{id}/access)۔ → API حوالہ · OpenAPI
🛡️ بہتر PII کنٹرولز — فی-قسم انتخاب، 20 تک تصدیق شدہ حسبِ منشا ماسکنگ پیٹرنز، اور فی-قسم شناخت کاؤنٹرز؛ ماسکنگ بذاتِ خود اختیاری (opt-in) ہی رہتی ہے۔ → گارڈریلز
🌍 67 زبانیں — ڈیش بورڈ، دستاویزات کے میررز اور CLI، جبکہ npm run i18n:add-locale ایک ہی کمانڈ میں ہر جگہ زبان شامل کر دیتا ہے۔ → i18n رہنما
🎛️ OmniConductor — آپ کی ایجنٹ فلیٹ کو اندرونی A2A ڈیلیگیشن، ایجنٹ کارڈ پر Conductor مہارتیں، اور Faro پش-ٹو-ٹاک وائس چیٹ کے ساتھ ڈیش بورڈ پینل۔ → A2A سرور
🛂 ایڈاپٹو ایڈمیشن اور اوورلوڈ تحفظ — بھاری چیٹ درخواستیں 503 دینے کے بجائے قطار میں لگتی ہیں، فی-کنکشن atomic RPM رولنگ لیزوں کے ساتھ۔ → لچک رہنما
🗂️ مستند /v1/models ترتیب — ہر فراہم کنندہ کے لیے ایک مسلسل فراہم کنندہ-گروپ شدہ بلاک (کومبوز پہلے پن شدہ)، ہر کیٹلاگ ماخذ میں مستحکم۔ → API حوالہ
🗜️ کمپریشن مضبوطی — پہلے سے فعال انفلیشن گارڈ، DE / FR / JA + چینی (wényán) کے لیے Caveman پیکس، Gradle اور .NET کے لیے RTK فلٹرز۔ → کمپریشن
💸 دیانت دارانہ فلیٹ-ریٹ لاگت — سبسکرپشن / کوڈنگ-پلان فراہم کنندگان لاگت تجزیات میں $0 دکھاتے ہیں؛ بجٹ، کوٹہ اور روٹنگ تخمینہ لگانا جاری رکھتے ہیں۔ → API حوالہ
⚖️ Quota-Share روٹنگ — مشترکہ اکاؤنٹ کے کوٹے کو پول شدہ کلیدوں میں منصفانہ طور پر تقسیم کریں، work-conserving انداز میں تاکہ فارغ حصے عارضی طور پر دوسروں کو دیے جا سکیں۔ → لچک رہنما
🤖 ایک کمانڈ میں CLI/ایجنٹ سیٹ اپ — 15 رجسٹرڈ setup-* کمانڈز؛ omniroute run سات CLI لانچ کرتا ہے (Claude Code، Codex، Aider، Goose، OpenCode، Qwen Code، Gemini CLI)؛ omniroute configure گیارہ اہداف کی معاونت کرتا ہے جس میں انٹرایکٹو فراہم کنندہ+ماڈل چننے والا اور فی-کانٹیکسٹ پسندیدہ شامل ہیں۔ → CLI انٹیگریشنز
🛰️ ریموٹ موڈ — سکوپ شدہ ٹوکنز (connect / contexts / tokens) کے ذریعے دور دراز OmniRoute چلائیں + VPS انسٹالز کے لیے ایک antigravity OAuth معاون۔ → ریموٹ موڈ
🧭 ہوشیار خودکار روٹنگ — auto/<category>:<tier> کومبوز، Fusion (ماڈل پینل + جج)، ٹاسک سے آگہ روٹنگ، فی-درخواست ماڈل / موڈ / USD-بجٹ اووررائیڈز۔ → Auto-Combo
🗜️ پلگ ایبل کمپریشن — 12 قابلِ ترکیب انجن + Compression Studios: LLMLingua-2، دو درجوں والی Ultra، omniglyph، فی-قدم فڈیلٹی گیٹ، GCF v3.2، ڈریگ سے دوبارہ ترتیب دینے والا ایڈیٹر۔ → کمپریشن
🕵️ شفاف MITM ڈکرپٹ (TPROXY) — ان CLI کو پکڑیں جو پراکسی ماحول متغیرات کو نظر انداز کرتے ہیں، فی-SNI CA + ٹرسٹ-اسٹور انسٹالر کے ساتھ۔ → MITM/TPROXY
💸 ہر جگہ لاگت ٹیلی میٹری — ہر اینڈ پوائنٹ پر X-OmniRoute-* لاگت/استعمال ہیڈرز، cache-HIT بچت کا ہیڈر، فی-کلید USD خرچ کوٹے۔ → API حوالہ
🧠 آپ کے کنٹرول میں میموری — پہلے سے بند، اختیاری int8 ویکٹر کوانٹائزیشن + ٹائپڈ decay، فی-درخواست x-omniroute-no-memory۔ → میموری
🛡️ سیکیورٹی — ہر LLM روٹ پر پرامپٹ-انجیکشن گارڈ (ریڈ-ٹیم سوٹ)، اختیاری کریڈینشل-ماسکنگ گارڈریل (دونوں سمتوں میں لِک ہوئی API کلیدیں/راز مٹاتا ہے)، مفت DuckDuckGo آخری سہارے کی ویب تلاش، اور ڈیش بورڈ کے لیے اختیاری OIDC لاگ اِن گیٹ (پاس ورڈ لاگ اِن ہمیشہ دستیاب رہتا ہے)۔ → گارڈریلز
🖼️ نئے اینڈ پوائنٹس — /v1/ocr (Mistral OCR) اور /v1/audio/translations (Whisper طرز) میڈیا کی سطح کو مکمل کرتے ہیں۔ → API حوالہ
🎨 تصویر / ویڈیو / آڈیو جنریشن — میڈیا کے لیے ایک API: xAI Grok Imagine اور Novita AI ویڈیو، ComfyUI، Magnific، Adobe Firefly، Segmind، اور ElevenLabs جیسے اسپیچ فراہم کنندگان۔ → API حوالہ
🌍 تعیناتی اور آپریشنز — ریورس-پراکسی basePath، براؤزر زبان کی خودکار شناخت، فی-کلید ڈیوائس ٹریکنگ، root کے بغیر MITM ٹرسٹ، zh-TW لوکلائزیشن۔ → ماحول
🤝 مزید فراہم کنندگان اور ایجنٹس — کلاؤڈ ایجنٹس (Codex Cloud، Cursor، Devin، Jules)، براؤزر + OAuth لاگ اِن کے ساتھ Grok Build (xAI)، Ollama فرسٹ-کلاس کارڈ، Claude Opus 5 اور Sonnet 5، Kimi سرکاری شراکت داری (Code/Web/Moonshot)، Zed، Requesty، SenseNova، Yuanbao، Agnes AI… اور تازہ شدہ 380 فراہم کنندگان کا کیٹلاگ۔ → فراہم کنندگان
📡 روٹنگ شفافیت — ہر جواب ایک X-OmniRoute-Decision ہیڈر ساتھ لاتا ہے جو اس حکمتِ عملی/فراہم کنندہ/لیٹنسی کا نام بتاتا ہے جس نے اسے پیش کیا، ایک نئی cache-optimized کومبو حکمتِ عملی + Auto-Combo cacheAffinity عنصر دہرائی گئی درخواستوں کو اسی کنکشن پر واپس بھیجتے ہیں جس کے پاس کیش شدہ prefix موجود ہے، اور ایک صرف-مطالعہ /v1/auto-combo/{channel}/candidates اینڈ پوائنٹ کسی auto/* چینل کا لائیو امیدوار پول ظاہر کرتا ہے۔ → Auto-Combo
⚡ مقامی کارکردگی اور انفراسٹرکچر — ون کلک مقامی Redis، Cloudflare Workers / Deno Deploy ریلے ڈیپلائرز، Bifrost اور Mux بطور نگرانی شدہ ایمبیڈڈ سروسز۔ → ایمبیڈڈ سروسز
🧩 اس کے علاوہ بھی شامل ہے — پلگ اِن فریم ورک + مارکیٹ پلیس، Omni/Agent/GitHub اسکلز فریم ورکس، Obsidian والٹ انٹیگریشن (22 MCP ٹولز)، OpenAI سے ہم آہنگ Batch اور Files APIs، سیمینٹک رسپانس کیشے، لیڈربورڈز کے ساتھ گیمیفیکیشن، ACP ایجنٹ ڈسکوری (15 بلٹ اِن ایجنٹس)، BigQuery میں شیڈول شدہ لاگ ایکسپورٹ، auto/chaos متوازی ملٹی ماڈل فین آؤٹ، ایک Telegram بوٹ برج، ایک اِن ایپ ورژن مینیجر اور LMArena-ELO فری پرووائیڈر رینکنگز۔ → دستاویزات

🤖 ہم آہنگ CLIs اور کوڈنگ ایجنٹس

ایک ترتیب — http://localhost:20128/v1 — اور** ہر** AI IDE یا CLI مفت اور کم لاگت والے ماڈلز پر چلتا ہے۔

_{Claude کوڈ}	_{Codex CLI}	_Cline	_{کلو کوڈ}	_{زو کوڈ}	_{جاری رکھیں}
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{فیکٹری Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok تعمیر}
_{ہرمیس ایجنٹ}	_OpenClaw	_ہنس	_{اوپن انٹرپریٹر}	_{Warp AI}	_deyin.ai

＋ · ایجنٹ ڈیک · Kiro · کمانڈ کوڈ · Antigravity · Windsurf · AMP · کسی بھی OpenAI سے مطابقت رکھنے والے ٹول کے ساتھ بھی کام کرتا ہے۔

_{📖 تمام 38 ٹولز کے لیے فی ٹول سیٹ اپ (27 CLI کوڈ کے + 11 CLI ایجنٹس) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode پلگ ان → @omniroute/opencode-provider}

ایک کمانڈ میں OmniRoute کے ذریعے کسی بھی تعاون یافتہ CLI لانچ کریں۔ - کوئی کنفگ فائل نہیں لکھی گئی، ہر عمل کے لیے اسناد داخل کی گئیں، Qwen/Gemini الگ تھلگ گھر ملے:

omniroute run claude   --model openai/gpt-5.4          # Claude Code
omniroute run codex    --model glm/glm-5.2             # OpenAI Codex CLI
omniroute run aider    --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose    --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen     --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini   --model glm/glm-5.2 -- --skip-trust -p "reply OK"

# Or pick provider+model interactively and write the tool's own config:
omniroute configure codex          # also: claude opencode qwen aider goose gemini cline continue kilo 5dive

ہر کمانڈ فعال ریموٹ سیاق و سباق کا احترام کرتی ہے (omniroute connect <host>)، --dry-run بغیر کسی عمل کے عین مطابق env/args کا پیش نظارہ کرتا ہے، اور --api-key-env NAME آپ کی شیل ہسٹری سے راز رکھتا ہے۔ → CLI انٹیگریشنز

🌐 380 AI فراہم کنندگان — 153 کیٹلاگ میں مفت کے طور پر نشان زد

مستند چیٹ، میڈیا، تلاش، مقامی، کلاؤڈ ایجنٹ اور سسٹم کے مجموعوں میں 380 رجسٹرڈ فراہم کنندگان موجود ہیں، جن میں 153 کے ساتھ hasFree: true ڈسکوری میٹا ڈیٹا شامل ہے۔ چیٹ ماڈل رجسٹری میں 239 فراہم کنندگان / 3,059 منفرد فراہم کنندہ-ماڈل جوڑے / 1,475 خام ماڈل IDs شامل ہیں؛ علیحدہ مفت بجٹ کیٹلاگ میں 471 فی ماڈل قطاریں، 34 بار بار دستیاب ہونے والے پولز اور 52 بار بار دستیاب/کلید کے بغیر ہمیشہ مفت فراہم کنندگان موجود ہیں۔ یہ پیمانے دانستہ طور پر مختلف ہیں؛ تعریفیں اور پول کی نقلیں ختم کرکے کیے گئے حسابات فراہم کنندگان کے حوالے اور مفت درجات میں موجود ہیں۔

🏢 ہر بڑی لیب — ایک ہی اینڈ پوائنٹ کے ذریعے

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…اور مزید 350+ — ہر آئیکن ڈیش بورڈ کے فراہم کنندگان کے کیٹلاگ سے براہِ راست حاصل ہوتا ہے۔ 📖 فراہم کنندگان کا حوالہ}

🆓 ہمیشہ مفت — $0، کسی کارڈ کی ضرورت نہیں

OpenCode Zen _{DeepSeek V4, Nemotron 3 ٹوکن کی کوئی حد نہیں}	Kilo Code _{خودکار راؤٹر، Tencent Hy3 ہمیشہ مفت}	Requesty _{GPT-OSS 120B, Nemotron ہمیشہ مفت}	SiliconFlow _{DeepSeek V3.2 / R1 مفت درجہ}	Z.AI GLM _{GLM-4.7 / 4.5-Flash ہمیشہ مفت}	Baidu ERNIE _{ERNIE 4.0 ہمیشہ مفت}
Qoder AI _{Qwen3-Max, Kimi-K2 لامحدود مفت}	Pollinations _{GPT, Llama, Claude کلید درکار نہیں}	Cloudflare AI _{50+ ماڈلز 10K نیورونز/دن}	NVIDIA NIM _{GLM, MiniMax تقریباً 40 RPM مفت}	Cerebras _{GLM 4.7, GPT-OSS ایک بار کا $5 کریڈٹ؛ کارڈ درکار ہے}	OpenRouter _{:free ماڈلز +$10 → زیادہ RPM}

📖 مکمل مشین کے قابلِ مطالعہ کیٹلاگ → docs/reference/PROVIDER_REFERENCE.md

🖥️ جہاں OmniRoute چلتا ہے — کہیں بھی

وہی ایپ، آپ کی مشین، آپ کے اصول۔ ایک عالمی npm سے install تک** آپ کا فون** ٹرمکس کے ذریعے۔

(Electron)— Windows / macOS / Linux خودکار اپ ڈیٹ کرتا — macOS, 24/7 no سے انسٹال کیا جا سکتا ہے میں تعاون کریں

پلیٹ فارم	انسٹال کریں	ہائی لائٹس
📦 npm (عالمی)	`npm انسٹال کریں -g omniroute`	ایک کمانڈ، کوئی بھی OS
⚡ Bun (عالمی)	`bun شامل کریں -g omniroute`	ایک ہی رجسٹری ٹربال، تیزی سے انسٹالز
🐳 Docker	`ڈاکر رن … diegosouzapw/omniroute`	ملٹی آرک AMD64 + ARM64
🖥️ ڈیسک	`npm چلائیں الیکٹران: تعمیر`	مقامی ونڈو + سسٹم
🎩 مینو بار (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	نگرانی کرتا ہے & سرور
💪 ARM	مقامی `arm64`	Raspberry Pi، ARM سرورز، Apple Silicon
📱 Android (Termux)	`pkg انسٹال کریں nodejs && npx -y omniroute`	آپ کے فون پر چلاتا
📲 PWA	"ہوم اسکرین میں شامل کریں"	فل سکرین، آف لائن، براؤزر
🧩 OpenCode	`@omniroute/opencode-provider`	مقامی OpenCode انضمام
🤖 VS کوڈ Copilot چیٹ	انسٹال کریں OmniCopilot ایکسٹینشن	مقامی Copilot چیٹ چننے والے میں ہر OmniRoute ماڈل — مستحکم &
🛠️ سورس سے	`npm انسٹال کریں && npm چلائیں dev`	اس پر ہیک کریں،

_{📖 Docker گائیڈ · ڈیسک ٹاپ · مینو بار ٹرے · Termux · PWA · OpenCode}

🧩 نیا: OmniRoute VS کوڈ کے مقامی Copilot چیٹ کے اندر

کوئی نیا سائڈبار نہیں، کوئی نیا چیٹ UI نہیں — ہر ماڈل OmniRoute پیش کرتا ہے بالکل اسی میں ظاہر ہوتا ہےCopilot چیٹ ماڈل چننے والا آپ پہلے ہی استعمال کر رہے ہیں۔ . VS کوڈ 1.122 کے بعد سے، فراہم کنندہ ماڈل GitHub سائن ان یا Copilot سبسکرپشن کے بغیر کام کرتے ہیں — ایجنٹ موڈ، ٹول کالنگ اور وژن، مفت میں۔

انسٹال کریں۔** OmniCopilot** توسیع، اسے اپنے OmniRoute سرور ( localhost:20128 پر پہلے سے طے شدہ) کی طرف اشارہ کریں، پھر Copilot چیٹ → ماڈل چننے والا → کھولیں۔** ماڈلز کا نظم کریں…** →OmniRoute .

ساتھ کام کرتا ہے < td سیدھ میں ="بائیں">VS کوڈ — مستحکم & اندرونی < td سیدھ ="بائیں">Cursor, Windsurf, VSCodium, Theia, Antigravity, Kiro…

اسٹور	لنک
🧩 VS کوڈ مارکیٹ پلیس	انسٹال کریں →
🔓 کھولیں VSX رجسٹری	انسٹال کریں →

ایڈیٹر کے اندر سے: کھولیں۔** ایکسٹینشنز** دیکھنا، تلاش کرنا** "OmniRoute"** ، کلک کریں۔** انسٹال کریں۔** - دونوں اسٹورز پر اسی طرح کام کرتا ہے۔ ماخذ، مسائل اور پبلشنگ رن بک diegosouzapw/OmniCopilot پر لائیو۔

_{📖 VS کوڈ Copilot چیٹ گائیڈ — سیٹ اپ، چننے والا کیا دکھاتا ہے، ڈیش بورڈ-ان-اے-ٹیب،} کا ازالہ

🎩 نیا: OmniRouteTray — آپ کا گیٹ وے، مینو بار میں رہنا

omniroute serve سب سے زیادہ خوش ہوتا ہے جب یہ ہمیشہ آن ہوتا ہے۔** OmniRouteTray** اسے macOS کے لیے سیٹ اور فرامیٹ مینو بار ایپ میں بدل دیتا ہے: یہ سرور کو شروع کرتا ہے، اسے دوبارہ شروع کرنے کے دوران زندہ رکھتا ہے، اسے اپنی جگہ پر اپ ڈیٹ کرتا ہے، اور آپ کے لائیو ٹوکن بجٹ کو ایک کلک کے فاصلے پر رکھتا ہے۔** کوئی ٹرمینل کھڑکی کھلی نہیں چھوڑی، کوئی npm install -g omniroute to babysit۔**

Tauri v2 (ایک راؤنڈنگ ایرر کے سائز کا زنگ کور) کے ساتھ بنایا گیا، یہ اپنا دستخط شدہ نوڈ 24 رن ٹائم بھیجتا ہے اور ایپ کی ملکیت والے OmniRoute انسٹال کا انتظام کرتا ہے، لہذا یہ کبھی بھی آپ کے عالمی node/bun سے نہیں لڑتا۔ یہ** آپ کے موجودہ ~/.omniroute/ کنفیگریشن اور ڈیٹا بیس کو شیئر کرتا ہے۔** - تو یہ وہی OmniRoute ہے جسے آپ پہلے ہی چلاتے ہیں، صرف ٹوپی کے ساتھ۔ 🎩

پر نہیں ہے۔

یہ کیا کرتا ہے	کیسے
🟢 سرور کی نگرانی کرتا ہے	Spawns `omniroute serve` ، اسے نقل کرنے کے بجائے پہلے سے چل رہی مثال کو اپناتا ہے
📊 ایک نظر میں براہ راست استعمال	فراہم کنندہ کوٹہ بارز، Claude session/weekly حدیں ری سیٹ الٹی گنتی کے ساتھ، 30 دن کی لاگت کی خرابی
🔄 جگہ پر خودکار اپ ڈیٹس	اسٹیجڈ انسٹال، ایٹمک سویپ، ناکامی پر رول بیک — ہمیشہ تازہ ترین ریلیز
🚀 لاگ ان پر شروع کریں	لاگ ان پر اختیاری لانچ؛ صرف ٹرے، کوئی ڈاک آئیکن
🩺 ڈاکٹر & لاگز	ایک کلک کی تشخیص اور سرور لاگ رسائی

brew install --cask zoispag/tap/omniroute-tray

_{ڈاؤن لوڈ کو ترجیح دیتے ہیں؟ تازہ ترین .dmg سے حاصل کریں۔
جاری کرتا ہے۔ ماخذ، مسائل اور تعمیر
دستاویزات zoispag/omniroute-tray پر رہتے ہیں۔

💛 @zoispag کی طرف سے ایک کمیونٹی پروجیکٹ — ایک سرکاری OmniRoute ریلیز نہیں۔}

🔒 نجی اور مقامی-اوّل

_{📖 اجازت دہی · حفاظتی حدود · تعمیل}

🔌 مکمل CLI + A2A اور MCP

سرور سے آگے، OmniRoute ایک مکمل کمانڈ لائن کاک پٹ ہے جس میں 80+ کمانڈز موجود ہیں، نیز اوپن ایجنٹ پروٹوکولز بھی ہیں تاکہ کوئی AI ایجنٹ اسے خود سے چلا سکے۔

⌨️ ایک حقیقی CLI (صرف `start` نہیں)

omniroute               # گیٹ وے + ڈیش بورڈ چلائیں (پورٹ 20128)
omniroute chat          # انٹرایکٹو TUI چیٹ کلائنٹ (سلیش: /model /combo /skill /memory)
omniroute setup         # پہلی بار چلانے کے لیے رہنمائی والا وزارڈ
omniroute doctor        # پرووائیڈرز، پورٹس اور مقامی انحصارات کی تشخیص کریں

🛰️ ریموٹ موڈ — CLI یہاں چلائیں، OmniRoute کو VPS پر

OmniRoute کسی سرور پر ہے؟ اسے اپنے لیپ ٹاپ سے اسی CLI کے ذریعے چلائیں۔ محدود دائرۂ اختیار والے رسائی ٹوکن کے ساتھ ایک بار لاگ اِن کریں؛ اس کے بعد ہر کمانڈ ریموٹ کو ہدف بنائے گی۔

omniroute connect 192.168.0.15            # پاس ورڈ → محدود دائرۂ اختیار والا ٹوکن، بطور کانٹیکسٹ محفوظ
omniroute models                         # ← ریموٹ سرور کے خلاف چلتا ہے
omniroute configure codex                 # ← ریموٹ ماڈل منتخب کرتا ہے، مقامی Codex پروفائل لکھتا ہے
omniroute tokens create --name ci --scope read   # دوسری مشینوں کے لیے مزید محدود ٹوکن بنائیں
omniroute contexts use default            # ← دوبارہ مقامی سرور پر منتقل ہوں

ٹوکنز کے دائرۂ اختیار read / write / admin ہیں؛ پراسیس شروع کرنے والے روٹس صرف لوپ بیک تک محدود رہتے ہیں۔ _{📖 ریموٹ موڈ}

OmniRoute CLI کا مظاہرہ کرتی ہوئی متحرک ٹرمینل — omniroute providers list، omniroute combo list اور omniroute health — 89 کمانڈز پر مشتمل اعلیٰ سطحی انٹرفیس میں باری باری چلتی ہوئی: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

🤝 کسی ایجنٹ کو منسلک کریں — اور وہ خود OmniRoute کو کنٹرول کرے گا

OmniRoute کو MCP، A2A، ایک REST API، webhooks یا ریموٹ CLI کے ذریعے دستیاب کریں — کوئی بھی اہل ایجنٹ (یا آپ کا اپنا کوڈ) پورے گیٹ وے کی کنجیاں حاصل کر لیتا ہے: روٹنگ، پرووائیڈرز، کومبوز، کیش، کمپریشن، میموری — خودکار طور پر۔ ذیل کے HTTP اینڈ پوائنٹس http://localhost:20128 کے تحت فراہم کیے جاتے ہیں۔

انٹرفیس	اینڈ پوائنٹ / کمانڈ	اس کا استعمال
🧰 MCP (stdio)	`omniroute --mcp`	Claude Desktop، Cursor یا کسی بھی MCP کلائنٹ سے منسلک کریں
🌊 MCP (HTTP)	`/api/mcp/stream`	ریموٹ MCP — 110 ٹولز، 33 دائرۂ اختیار (نفاذ اختیاری)، مکمل آڈٹ ٹریل
📡 MCP (SSE)	`/api/mcp/sse`	اسٹریمنگ MCP ٹرانسپورٹ
🤝 A2A	`/.well-known/agent.json`	ایجنٹ سے ایجنٹ، JSON-RPC 2.0 + SSE، 6 مہارتیں
🌐 REST API	`/v1/*`	OpenAI سے ہم آہنگ — چیٹ، ایمبیڈنگز، تصاویر، آڈیو، OCR
🔔 Webhooks	`/api/webhooks`	درخواست / کوٹا ایونٹس کو Slack، Discord، Telegram یا کسی بھی URL پر بھیجیں
🛰️ ریموٹ CLI	`omniroute connect`	محدود دائرۂ اختیار والے رسائی ٹوکنز کے ذریعے ریموٹ انسٹینس چلائیں

# Claude Code کو MCP کے ذریعے OmniRoute کا مکمل ٹول سیٹ دیں:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

_{📖 MCP سرور · A2A سرور · ایجنٹ پروٹوکولز}

🗜️ 15–95% ٹوکنز کی بچت — خودکار طور پر

📖 یہ کیسے کام کرتا ہے — پائپ لائن، آرکیٹیکچر اور بچت کا حساب

ڈیفالٹ اسٹیکڈ کومبو RTK → Caveman چلاتا ہے۔ جب دونوں ایک ہی ٹول/کانٹیکسٹ پے لوڈ پر کارروائی کرتے ہیں تو بچتیں مرکب ہو جاتی ہیں:

combined = 1 − (1 − RTK) × (1 − Caveman_input)
average  = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range    = 78.4 – 94.6%

کوڈ بلاکس، URLs، JSON اور سٹرکچرڈ ڈیٹا preservation انجن کی جانب سے ہمیشہ محفوظ رکھا جاتا ہے۔

جب چند ٹوکنز کام چلا سکتے ہیں تو بہت سے ٹوکنز کیوں استعمال کریں؟ ہر درخواست OmniRoute کی کمپریشن پائپ لائن سے شفاف طریقے سے گزرتی ہے — کلائنٹ میں کوئی تبدیلی درکار نہیں۔ یہ اب 12 قابلِ ترکیب انجنوں کا اسٹیک ہے جو ترتیب وار چلتے ہیں اور ہر روٹنگ کومبو کے مطابق مکس اینڈ میچ ہوتے ہیں — RTK، Caveman (⭐ 90K+)، LLMLingua-2، اور Troglodita (PT-BR) کے آئیڈیاز پر مبنی۔

🧱 12 انجنوں کا اسٹیک

انجن پائپ لائن کی ترتیب سے چلتے ہیں؛ ہر ایک آزادانہ طور پر ٹوگل کیے جانے کے قابل ہے اور ہر کومبو کے لیے کنفیگر کیا جا سکتا ہے:

#	انجن	یہ کیا کرتا ہے
1	Session-Dedup	ٹرنز میں دہرائے گئے مواد کو ہٹا دیتا ہے (content-addressed، cross-turn)
2	CCR	بڑے بلاکس کو retrieve مارکرز کے پیچھے آرکائیو کرتا ہے، ضرورت پر حاصل کیے جاتے ہیں
3	Lite	Whitespace اور image-URL کی trimming (کم لیٹنسی والی بنیادی سطح)
4	RTK	سمارٹ ٹول رزلٹ فلٹرنگ، dedup اور truncation (کمانڈ سے آگاہ)
5	Responses Tool Output	shell/patch/search/build آؤٹ پٹس کے لیے lossless-first JSON اور محدود diagnostic کمپریشن (Responses API)
6	Headroom	vendored GCF codec کے ذریعے JSON arrays کی lossless ٹیبلر کمپیکشن (~30%)
7	Relevance	آخری یوزر کیوری کے مقابلے میں extractive جملوں کی اسکورنگ
8	Caveman	رول بیسڈ نثری کمپریشن (آؤٹ پٹ پر ~65–75%)
9	Aggressive	خلاصہ سازی اور پرانے ٹرنز کی بتدریج aging
10	LLMLingua-2	MobileBERT ONNX کے ذریعے ML semantic پروننگ — کوڈ سیف، async
11	Ultra	اختیاری چھوٹے ماڈل (SLM) ٹائر کے ساتھ heuristic ٹوکن پروننگ
12	OmniGlyph	براہ راست Anthropic وائر پر ناپے گئے Claude Fable 5 کے لیے تجرباتی context-as-image انکوڈنگ؛ GPT 5.6 transformers فراہم کنندہ کی رسیدوں کے انتظار میں fail-closed رہتے ہیں۔ چار کمپریشن پروفائلز (aggressive default، balanced، coding-safe، passthrough) (سب سے زیادہ aggressive؛ opt-in)

کوڈ بلاکس، URLs اور سٹرکچرڈ ڈیٹا ہمیشہ بائٹ پرفیکٹ محفوظ رکھے جاتے ہیں۔ ون کلک پری سیٹس انجنوں کو یکجا کرتے ہیں:

موڈ	بچت	کس کے لیے بہترین
🪶 Lite	~15%	ہمیشہ آن محفوظ ڈیفالٹ
🪨 Standard (Caveman)	~30%	روزمرہ کی کوڈنگ
⚡ Aggressive	~50%	لمبے ٹول سے بھرپور سیشنز
🔥 Ultra	~75%	زیادہ سے زیادہ بچت
🧰 RTK	60–90%	Shell/test/build/git آؤٹ پٹ
🔗 Stacked (RTK → Caveman)	78–95%	ملے جلے پرامپٹس اور ٹول لاگز

حقیقی مثال — Standard موڈ:

پہلے (69 ٹوکنز): "آپ کے React کمپوننٹ کے دوبارہ رینڈر ہونے کی وجہ غالباً یہ ہے کہ آپ ہر رینڈر سائیکل پر ایک نئی آبجیکٹ ریفرنس بنا رہے ہیں۔ جب آپ بطور prop ایک inline آبجیکٹ پاس کرتے ہیں، تو React کا shallow comparison اسے ہر بار ایک مختلف آبجیکٹ سمجھتا ہے، جس سے re-render ٹرگر ہوتا ہے۔ میں تجویز کروں گا کہ آبجیکٹ کو memoize کرنے کے لیے useMemo استعمال کریں۔"

بعد میں (19 ٹوکنز): "ہر رینڈر پر نئی آبجیکٹ ref۔ Inline آبجیکٹ prop = نئی ref = re-render۔ useMemo میں لپیٹ دیں۔"

وہی جواب۔ 72% کم ٹوکنز۔ درستگی میں صفر کمی۔ ✅

PT-BR مثال — Troglodita موڈ:

پہلے (42 ٹوکنز): "مسئلہ یہ ہے کہ کمپوننٹ دوبارہ رینڈر ہو رہا ہے کیونکہ ہر رینڈر سائیکل میں آبجیکٹ کا ایک نیا حوالہ بنایا جا رہا ہے۔ میرا مشورہ ہے کہ useMemo استعمال کریں۔"

بعد میں (12 ٹوکنز): "دوبارہ رینڈر: ہر سائیکل میں نیا حوالہ (ان لائن آبجیکٹ دوبارہ بنتا ہے)۔ useMemo استعمال کریں۔"

وہی جواب۔ ~70% کم ٹوکنز۔ تکنیکی درستگی برقرار۔ ✅

🎚️ انجنوں سے آگے — آؤٹ پٹ اسٹائلز، ایڈاپٹو ڈائل اور فی-درخواست کنٹرول

اوپر دیے گئے 12 انجن اس چیز کو سکیرتے ہیں جو اندر جاتی ہے۔ مزید تین پرتیں یہ طے کرتی ہیں کہ کیسے، کب، اور کیا باہر آتا ہے:

🪄 آؤٹ پٹ اسٹائلز (آؤٹ پٹ محور کی اسٹیئرنگ) — deterministic، cache-safe جواب-تشکیل ہدایات inject کریں؛ آپس میں ملائے جا سکتے ہیں، ہر ایک lite / full / ultra شدت پر۔ اسٹائل شامل کرنا صرف ایک سطر کی registry انٹری ہے:
- مختصر نثر — فلر / حروفِ تعریف / احتیاطی الفاظ ہٹائیں؛ تکنیکی جوہر کو عین درست رکھیں۔
- کم کوڈ — "کاہل سینئر ڈویلپر" والا YAGNI: سب سے چھوٹی کام کرنے والی تبدیلی، کوئی غیر مطلوبہ scaffolding نہیں۔
- پونی ٹیل (کاہل سینئر ڈویلپر) — YAGNI کی سیڑھی چڑھیں، بنیادی وجہ ٹھیک کریں، سب سے چھوٹا کام کرنے والا diff۔
- مجھے ADHD ہے (عمل اول) — اگلا عمل سب سے آگے، مراحل نمبر دار، ایک ٹھوس اگلا قدم، کوئی تمہید نہیں۔
- مختصر CJK (文言) — کلاسیکی چینی فوقِ مختصر اسٹائل (zh locale تک محدود)۔
🎯 ایڈاپٹو کانٹیکسٹ بجٹ (ڈائل) — ایک on/off ٹوکن تھریشولڈ کے بجائے، سب سے سستے، سب سے کم نقصان دہ انجنوں کو صرف اتنا بڑھائیں جتنا ماڈل کی کانٹیکسٹ ونڈو میں فٹ ہونے کے لیے ضروری ہو۔ پالیسی: reserve-output (ڈیفالٹ، ماڈل سے آگاہ) · percentage · absolute۔ موڈ: floor (فٹ ہونے کی ضمانت) · replace-autotrigger (آپ کا واضح انتخاب جیتتا ہے) · off (پرانا تھریشولڈ)۔
🎛️ کمپریشن کہاں طے ہوتی ہے (ترجیح، زیادہ → کم) — فی-درخواست x-omniroute-compression ہیڈر › روٹنگ کومبو اووررائیڈ › فعال نامزد پروفائل › ایڈاپٹو / آٹو ٹرگر › پینل ڈیفالٹ › بند۔ لاگو کیا گیا پلان X-OmniRoute-Compression: <mode>; source=<source> رسپانس ہیڈر میں واپس گونجتا ہے۔

ٹوکن تھریشولڈ سے آٹو ٹرگر کریں، ایڈاپٹو ڈائل آن کریں، کوئی نامزد پروفائل پن کریں، فی درخواست ایک بار کے لیے سیٹ کریں، یا فی روٹنگ کومبو پائپ لائن تفویض کریں — جو بھی ورک لوڈ کے لیے موزوں ہو۔ ایک opt-in آف لائن eval harness (npm run eval:compression) کسی تبدیلی کو فروغ دینے سے پہلے pinned corpus پر fidelity بمقابلہ بچت کا اسکور دیتی ہے۔

📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md

⚡ فوری آغاز

1) انسٹال کریں اور چلائیں

npm install -g omniroute
omniroute

💡 npm warn ERESOLVE یا peer-dep وارننگز نظر آ رہی ہیں؟ یہ بے ضرر ہیں۔ npm 11 یا بعد کا ورژن استعمال کر رہے ہیں؟ npm پیکج لائف سائیکل اسکرپٹس کو تب تک بلاک کر سکتا ہے جب تک انہیں اجازت نہ دی جائے۔ OmniRoute کا postinstall (node scripts/build/postinstall.mjs) اس کی native runtime فائلیں تیار کرنے کے لیے ضروری ہے۔ عالمی طور پر انسٹال کرتے وقت npm کی وارننگ میں نامزد پیکجز کو اجازت دیں۔ OmniRoute 3.8.53 کی جانب سے رپورٹ شدہ پیکج سیٹ کے لیے:
npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
مستقبل کی عالمی انسٹالیشنز کے لیے اس allowlist کو دوبارہ استعمال کرنے کے لیے، اسے ایک بار configure کریں، پھر معمول کے مطابق انسٹال کریں:
npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
npm install -g omniroute
ڈیپینڈنسی فہرست ریلیزز کے درمیان بدل سکتی ہے؛ اگر npm کوئی مختلف فہرست رپورٹ کرے تو اسی وارننگ کے پیکج نام استعمال کریں۔ کسی پیکج کو اجازت دینے سے اس کے انسٹال اسکرپٹس چلنے کی اجازت ملتی ہے۔ Gemini Web یا کوئی اور web-cookie فراہم کنندہ استعمال کر رہے ہیں؟ npm پیکج میں Playwright شامل ہے لیکن اس کا Chromium binary نہیں۔ پہلی web-provider درخواست کرنے سے پہلے Playwright Chromium سیٹ اپ کا نوٹ دیکھیں۔

ڈیش بورڈ http://localhost:20128 پر · API http://localhost:20128/v1 پر۔

2) اپنے اکاؤنٹ سے کسی اہل فراہم کنندہ سے جڑیں

ڈیش بورڈ → Providers → ایسا فراہم کنندہ منتخب کریں جس کی موجودہ شرائط و کوٹہ آپ کے استعمال کے مطابق ہو → اس کی API key شامل کریں یا اس کا اکاؤنٹ فلو مکمل کریں۔ مفت ٹائرز کے لیے سائن اپ، منظوری، یا ادائیگی کا طریقہ درکار ہو سکتا ہے۔ Free Tiers Guide دیکھیں؛ بغیر key دستیابی کی ضمانت نہیں، اور tos: avoid نشان زد فراہم کنندگان ڈیفالٹ طور پر auto سے مستثنیٰ ہیں۔

3) اپنے کوڈنگ ٹول کو متوجہ کریں

Base URL: http://localhost:20128/v1
API Key:  [copy from Dashboard → Endpoints]
Model:    auto            (routes among eligible connections — or choose provider/model)

4) تصدیق کریں کہ یہ کام کر رہا ہے

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

آپ کو اپنے منسلک ماڈلز کی فہرست نظر آنی چاہیے۔ 🎉 بس اتنا ہی — کوڈنگ شروع کریں، اور OmniRoute آپ کے لیے خودکار طور پر route اور fallback کرے گا۔

اگر آپ کا کلائنٹ custom ہیڈرز نہیں بھیج سکتا، تو OmniRoute ٹوکنائزڈ مطابقت aliases بھی فراہم کرتا ہے:

OpenAI catalog:   http://localhost:20128/vscode/YOUR_KEY/
OpenAI models:    http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat:      http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat:      http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags:      http://localhost:20128/vscode/YOUR_KEY/api/tags

انہیں صرف ان کلائنٹس کے لیے استعمال کریں جو Authorization: Bearer ... منسلک نہیں کر سکتے۔ ہیڈر auth ہی ترجیحی طریقہ رہتا ہے۔

📦 تنصیب کے مزید طریقے — Docker، سورس، pnpm، Arch

🐳 Docker

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

:latest سب سے اعلیٰ شائع شدہ مستحکم SemVer کی پیروی کرتا ہے۔ یہ git main کو ٹریک نہیں کرتا۔ GitOps کے لیے :X.Y.Z مقرر کریں۔ Docker ریلیز چینلز دیکھیں۔ امیج میں OMNIROUTE_MEMORY_MB=1024 مقرر ہے۔ یہ ڈیش بورڈ اور ہلکی چیٹ کے لیے کافی ہے۔ کوڈنگ ایجنٹس (Claude Code، Codex، Grok، … سے POST /v1/responses) کو کہیں زیادہ بڑا V8 heap درکار ہوتا ہے، ورنہ دو باہم متجاوز طویل contexts کے دوران تقریباً 12 GiB پر پراسیس FATAL ERROR دیتا ہے۔ کنٹینر کا سائز heap سے زیادہ رکھیں (native buffers، V8 سے باہر موجود ہوتے ہیں):

کام کا بوجھ	Heap (`-e OMNIROUTE_MEMORY_MB`)	کنٹینر (`--memory`)
ڈیش بورڈ / ہلکی چیٹ	`1024` (امیج کا ڈیفالٹ)	≥2 g
ایک کوڈنگ ایجنٹ	`8192`	≥10 g
بیک وقت دو طویل `/v1/responses`	`10240`–`12288`	≥12–16 g

docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
  -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
  -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest

مکمل جدول: Docker گائیڈ — رن ٹائم RAM۔

قبل از ریلیز Docker چینل: diegosouzapw/omniroute:next اور diegosouzapw/omniroute:next-web موجودہ ڈیفالٹ release/v* برانچ کی پیروی کرتے ہیں۔ یہ قابلِ تغیر tags صرف غیر جاری شدہ اصلاحات کی جانچ کے لیے ہیں اور پروڈکشن کے لیے معاونت یافتہ نہیں ہیں۔ دیکھیں Docker ریلیز چینلز۔

🥟 Bun

Bun رن ٹائم کی شناخت کے ذریعے معیاری bun install اور عالمی تنصیب (bun install -g omniroute) معاونت یافتہ ہیں:

بلٹ اِن bun:sqlite: Bun کے تحت چلتے وقت OmniRoute، Bun کا بلٹ اِن bun:sqlite ڈرائیور استعمال کرتا ہے، جبکہ Node.js پر better-sqlite3 یا sql.js استعمال کرتا ہے۔
ڈویلپمنٹ میں خودکار Webpack bundler انتخاب: ڈویلپمنٹ (bun run dev) خودکار طور پر Bun کی شناخت کرتی ہے اور native V8 binding کی عدم مطابقت روکنے کے لیے Turbopack کو غیر فعال کرکے Webpack استعمال کرتی ہے۔ پروڈکشن builds (bun run build) عین Node کی طرح OMNIROUTE_USE_TURBOPACK کی پیروی کرتی ہیں: ڈیفالٹ طور پر Turbopack، اور Webpack کے ساتھ build کرنے کے لیے OMNIROUTE_USE_TURBOPACK=0 (Dockerfile.bun اسے --build-arg کے طور پر فراہم کرتا ہے)۔
Bun کے لیے مخصوص Dockerfile: مقامی Bun پروڈکشن deployments کے لیے multi-stage Dockerfile.bun (docker build -f Dockerfile.bun -t omniroute:bun .)۔

# Bun کے ساتھ تنصیب کریں اور چلائیں
bun install
bun run dev

🛠️ سورس سے

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# Nix flakes استعمال کرتے ہوئے
nix develop
npm run dev

# یا devbox استعمال کرتے ہوئے
devbox run npm run dev

📖 Docker گائیڈ — Compose profiles، Caddy HTTPS، Cloudflare tunnels۔

🦭 Podman

# 1. bind-mounted ڈیٹا ڈائریکٹری تیار کریں
mkdir -p data

# 2. صرف Linux + مقامی rootless Podman (کبھی بھی remote Podman Machine client نہیں):
podman unshare chown 1000:1000 ./data

# 3. رن ٹائم hint مقرر کریں، مقامی Compose امیج build کریں، اور آغاز کریں
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build

macOS یا Windows پر، Podman ایک remote Podman Machine استعمال کرتا ہے: podman unshare کو چھوڑ دیں اور topology کے لحاظ سے مخصوص ڈیٹا ڈائریکٹری کی رہنمائی پر عمل کریں۔

📖 Podman گائیڈ — Compose builds، Podman Machine، اور Linux/systemd Quadlet سیٹ اپ۔

⚡ تیز تر / ہلکی تنصیب (native build کو چھوڑ دیں)

native SQLite انجن (better-sqlite3) ایک اختیاری dependency ہے، اس لیے عالمی تنصیب کبھی بھی سورس سے compilation پر نہیں رکتی: جب کوئی prebuilt binary آپ کے پلیٹ فارم/Node سے مطابقت رکھتی ہو تو اسے استعمال کیا جاتا ہے، بصورتِ دیگر شفاف انداز میں pure-JS انجن (Node 22+ پر node:sqlite، ورنہ شامل کردہ sql.js WASM) استعمال کیا جاتا ہے — کسی build tool کی ضرورت نہیں۔

تنصیب کے بعد کی native warm-up کارروائی کو مکمل طور پر چھوڑنے کے لیے (CI، headless، یا سست مشینیں):

OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute   # CI=1 بھی اسے چھوڑ دیتا ہے

تیز ترین تنصیبات کے لیے pnpm کو ترجیح دیں (content-addressed store + hard links — اوپر دیکھیں)۔ ڈیش بورڈ کے بغیر headless رن ٹائم کے لیے Docker کا base profile (اوپر) یا Termux گائیڈ استعمال کریں۔ CLI اور ویب ڈیش بورڈ ایک ہی پراسیس کے ذریعے ایک پورٹ پر پیش کیے جاتے ہیں، اس لیے فی الحال کوئی الگ صرف-CLI package موجود نہیں ہے۔

🎬 OmniRoute عملی حالت میں

📹 ویڈیو گائیڈز

_{2026-10-18 کو پینل کا اسنیپ شاٹ · خام کیٹلاگ: YT 1.352 | TT 334 | IG 290 · تازگی (دن): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 ملاحظات}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 ملاحظات}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 ملاحظات}

🎬 #4 — Instagram
_{theopenstack — 692,419 ملاحظات}

🎬 #5 — TikTok
_{migue.baena — 685,788 ملاحظات}

مکمل درجہ بندی (نقل سے پاک کینونیکل URLs، v > 0، سب سے زیادہ رسائی):

#1	#2	#3	#4	#5
nick_saraev — Instagram — 3,042,474	nnapier7 — Instagram — 1,454,535	Amidia AI & Tech — YouTube — 794,974	theopenstack — Instagram — 692,419	migue.baena — TikTok — 685,788

#6	#7	#8	#9	#10
milesreevesai — TikTok — 620,400	nikothetech — TikTok — 610,803	Vaibhav Sisinty — YouTube — 509,281	buildwithai.club — Instagram — 347,652	nivedan.ai — Instagram — 331,973

2026-10-18 کو کینونیکل میٹرکس: 1.976 منفرد ویڈیوز · 20.220.289 معلوم ملاحظات (v > 0) · ہر نیٹ ورک پر 1.210 چینلز/پروفائلز۔ خام پینل میں 1.976 قطاریں شامل ہیں (YouTube 1.352 = 740 طویل ویڈیوز + 612 Shorts · TikTok 334 · Instagram 290)؛ کینونیکل URL کے ذریعے نارملائزیشن کے بعد کوئی نقل باقی نہیں رہی، جو ہر ویڈیو کے لیے سب سے زیادہ تعداد برقرار رکھتی ہے۔ YouTube کا ڈیٹا اکٹھا کرنے کا عمل 2026-10-13 سے منجمد ہے (14 سے 18/10 تک API کوٹا ختم ہو گیا تھا)، جبکہ TikTok/Instagram کا 2026-09-02 سے (ڈیٹا اکٹھا کرنے کے کریڈٹس دستیاب نہ ہونے کی وجہ سے)؛ 76 ویڈیوز کے ملاحظات کی تعداد اب بھی دستیاب نہیں ہے۔

🎬 OmniRoute کے بارے میں ویڈیو بنائی ہے؟ لنک کے ساتھ ایک مسئلہ یا گفتگو شروع کریں — ہم اسے یہاں نمایاں کریں گے۔

📧 کمیونٹی اور مدد

سب کچھ ایک ہی جگہ پر — مینٹینر کو فالو کریں، کمیونٹی کے ساتھ چیٹ کریں، یا کوئی مسئلہ کھولیں۔

چینل	کہاں / کیسے
💼 LinkedIn — مینٹینر کو فالو کریں	linkedin.com/in/diegosouzapw
🐙 GitHub — ریلیزز اور تجاویز کے لیے فالو کریں	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 عالمی	گروپ میں شامل ہوں
🟢 WhatsApp — 🇧🇷 برازیل	گروپ میں شامل ہوں
🌍 ویب سائٹ	omniroute.online
🌍 🌍StHub OmniRoute کمیونٹی (مفت)	StHub پورٹل
📦 سورس کوڈ	github.com/diegosouzapw/OmniRoute
🐛 بگ رپورٹ کریں	ایک مسئلہ درج کریں — `npm run system-info` کا آؤٹ پٹ منسلک کریں
🤝 تعاون کریں	CONTRIBUTING.md · برانچنگ اور ریلیز ماڈل · ایک `good first issue` منتخب کریں
💚 پروجیکٹ کی معاونت کریں	معاونت کے طریقے ↑ · GitHub Sponsors

🛠️ ٹیک اسٹیک

پرت	ٹیکنالوجی
رن ٹائم	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
زبان	TypeScript 6.0 — `src/` اور `open-sse/` میں 100% TypeScript (v2.0 سے کور میں صفر `any`)
فریم ورک	Next.js 16 + React 19 + Tailwind CSS 4
ڈیٹابیس	better-sqlite3 (SQLite، WAL جرنلنگ) + LowDB (JSON لیگیسی) — 147 ڈومین ماڈیولز، 219 مائیگریشنز
میموری	SQLite FTS5 فل ٹیکسٹ + int8-quantized ویکٹر ایمبیڈنگز، ٹائپڈ ڈیکے
اسکیماز	Zod 4 — MCP ٹول I/O کی توثیق + API کنٹریکٹس
پروٹوکولز	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
اسٹریمنگ	Server-Sent Events (SSE) + WebSocket برج (`/v1/ws`)
کمپریشن	12-انجن پائپ لائن — RTK، Caveman، LLMLingua-2 (MobileBERT ONNX)، GCF، OmniGlyph
توثیق اور سیکیورٹی	OAuth 2.0 (PKCE) + JWT + API Keys + MCP اسکوپڈ توثیق · ذخیرہ شدہ حالت میں AES-256-GCM · DOMPurify
اسٹیلتھ	wreq-js — JA3 / JA4 TLS فنگرپرنٹ کی نقالی، 3-درجہ پراکسی
لچکداری	سرکٹ بریکر، ایکسپونینشل بیک آف، اینٹی تھنڈرنگ ہرڈ، آٹو کومبو سیلف ہیلنگ
لاگنگ	pino — درخواست کے سیاق و سباق کے ساتھ اسٹرکچرڈ JSON لاگز
ٹیسٹنگ	Node.js test runner + Vitest — 7,800+ ٹریک شدہ ٹیسٹ فائلوں میں 56,000+ سٹیٹک ٹیسٹ ڈکلیریشنز (یونٹ، انٹیگریشن، E2E، سیکیورٹی، ایکو سسٹم)
پلیٹ فارمز	ڈیسک ٹاپ (Electron) · Android (Termux) · PWA (کوئی بھی براؤزر)
CI/CD	GitHub Actions — ریلیز پر خودکار npm پبلش + Docker Hub
لنکس	ویب سائٹ · npm · Docker Hub

📖 دستاویزات

📘 آغاز کرنا

دستاویز	تفصیل
صارف رہنما	پرووائیڈرز، کومبوز، CLI انضمام، تعیناتی
سیٹ اپ رہنما	تنصیب کے مکمل طریقے، CLI ٹول کنفیگریشنز، پروٹوکول سیٹ اپ، ٹائم آؤٹ ٹیوننگ
CLI ٹولز رہنما	Claude Code، Codex، Cursor، Cline، OpenClaw، Kilo، Copilot کے لیے ہر ٹول کا الگ سیٹ اپ
ریموٹ موڈ	محدود دائرۂ کار والے رسائی ٹوکنز کے ذریعے اپنے لیپ ٹاپ کی CLI سے ریموٹ OmniRoute (VPS) چلائیں
Claude Code کنفیگریشن	`launch` اور ہر ماڈل کے الگ پروفائلز کے ساتھ Claude Code کو OmniRoute (مقامی/ریموٹ) سے مربوط کریں
فوری آغاز	3 مراحل میں تنصیب → کنکشن → کنفیگریشن

🔧 آپریشنز اور تعیناتی

دستاویز	تفصیل
Docker رہنما	Docker run، Compose پروفائلز، Caddy HTTPS، ٹنلز، امیج ٹیگز
Podman رہنما	Quadlet systemd انضمام، podman-compose، SELinux
VM تعیناتی	مکمل رہنما: VM + nginx + Cloudflare سیٹ اپ
Fly.io تعیناتی	مستقل اسٹوریج کے ساتھ Fly.io پر تعینات کریں
Termux رہنما	Termux کے ذریعے Android پر OmniRoute چلائیں
PWA رہنما	Progressive Web App کی تنصیب، کیشنگ، آرکیٹیکچر
ان انسٹال رہنما	تنصیب کے تمام طریقوں کے لیے مکمل اور صاف اخراج
ماحول کی کنفیگریشن	`.env` کے مکمل متغیرات اور حوالہ جات

🧠 خصوصیات اور آرکیٹیکچر

دستاویز	تفصیل
آرکیٹیکچر	سسٹم آرکیٹیکچر، ڈیٹا کا بہاؤ، اور اندرونی ساخت
کمپریشن رہنما	7 اختیارات والی پائپ لائن: off / lite / standard / aggressive / ultra / RTK / stacked
RTK کمپریشن	کمانڈ آؤٹ پٹ کمپریشن، فلٹرز، اعتماد، توثیق، خام آؤٹ پٹ کی بازیابی
کمپریشن انجنز	Caveman، RTK، stacked پائپ لائنز، dashboard/API/MCP سطحیں
کمپریشن قواعد کا فارمیٹ	Caveman اور RTK فلٹرز کے لیے JSON رول پیک اسکیمے
کمپریشن لینگویج پیکس	زبان کی شناخت اور Caveman رول پیک کی تخلیق
لچک پذیری رہنما	سرکٹ بریکرز، کول ڈاؤنز، قطار، اینٹی تھنڈرنگ ہرڈ، TLS اسپوفنگ
Auto-Combo انجن	16 عوامل پر مبنی اسکورنگ، موڈ پیکس، خودکار بحالی
Proxy رہنما	3 سطحی پراکسی سسٹم، 1proxy مارکیٹ پلیس، رجسٹری CRUD
مفت درجے	یکجا ڈائریکٹری: 34 دستاویزی اعادی پولز / 484 فہرست شدہ مفت درجے کے اندراجات
خصوصیات کی گیلری	اسکرین شاٹس کے ساتھ ڈیش بورڈ کا بصری دورہ
کوڈ بیس دستاویزات	نئے صارفین کے لیے موزوں کوڈ بیس کا مرحلہ وار جائزہ

🤖 پروٹوکولز اور APIs

دستاویز	تفصیل
API حوالہ	مثالوں کے ساتھ تمام اینڈ پوائنٹس
OpenAPI تفصیلات	OpenAPI 3.0 کی وضاحت
MCP سرور	110 MCP ٹولز، IDE کنفیگریشنز، Python/TS/Go کلائنٹس
MCP سرور رہنما	MCP تنصیب، ٹرانسپورٹس، اور ٹول حوالہ
A2A سرور	JSON-RPC 2.0 پروٹوکول، مہارتیں، اسٹریمنگ، ٹاسک مینجمنٹ
A2A سرور رہنما	A2A ایجنٹ کارڈ، ٹاسکس، مہارتیں، اور اسٹریمنگ

📋 پروجیکٹ اور معیار

دستاویز	تفصیل
شراکت	ڈیولپمنٹ سیٹ اپ اور رہنما اصول
برانچنگ اور ریلیز ماڈل	PRs کا ہدف کہاں ہوتا ہے (`release/*`)، اور `main` اور ٹیگز کا کیا مطلب ہے
تبدیلیوں کا ریکارڈ	ہر ورژن کی مکمل ریلیز ہسٹری
سیکیورٹی پالیسی	کمزوریوں کی اطلاع دہی اور سیکیورٹی کے طریقۂ کار
i18n رہنما	67 زبانوں کی معاونت، ترجمے کا ورک فلو، RTL
ریلیز چیک لسٹ	ریلیز سے پہلے توثیق کے مراحل
کوریج منصوبہ	7,800+ ٹریک شدہ ٹیسٹ فائلوں میں 56,000+ جامد ٹیسٹ ڈیکلریشنز کے لیے ٹیسٹ کوریج کی حکمتِ عملی

⭐ نمایاں شراکت کار

OmniRoute ایک پُرجوش اوپن سورس کمیونٹی کی کاوشوں سے تشکیل پاتا ہے۔ ان افراد نے غیر معمولی شراکتیں کی ہیں جو منصوبے کے معیار، استحکام اور رسائی پر براہِ راست اثر ڈالتی ہیں۔ آپ کا شکریہ۔

ضم شدہ پل ریکوئسٹس کے لحاظ سے بیرونی شراکت کار

درجہ	شراکت کار	ضم شدہ PRs	~تبدیل شدہ سطور
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{یہ شمار 2026-10-18 15:09:09 UTC کو لائیو release/v3.8.52 ٹِپ 656f01cb43 کے ساتھ کیا گیا۔ صفحات میں منقسم GitHub GraphQL شمار میں 9,191 ضم شدہ PRs شامل ہیں: 3,834 ریپوزٹری کے مالک کی جانب سے، 229 Dependabot کی جانب سے، 6 دیگر بوٹس/ایپس کی جانب سے، اور 835 منفرد شراکت کاروں کی جانب سے 5,122 بیرونی PRs۔ ”تبدیل شدہ سطور“ سے مراد GitHub کے اضافے + حذف شدہ سطور ہیں، اور اس میں تیار کردہ فائلیں، لاک فائلیں، کیٹلاگز، تراجم اور دستاویزات شامل ہیں؛ یہ تبدیلیوں کا حجم ہے، تحریر کردہ LOC نہیں۔ 49 PRs میں GitHub کے رپورٹ کردہ diffs 500,000 سطور سے زیادہ ہیں (مثلاً #13399، جو کسی ایک پرووائیڈر کا اضافہ ہے، 2,347 تبدیل شدہ فائلیں دکھاتا ہے)، جس کی وجہ سے اوپر دیے گئے کئی مجموعے بڑھ گئے ہیں۔ برابر نتائج کو ایک ہی درجہ دیا گیا ہے۔}

GitHub سے منسوب commits

Dizzle _{🥇 GitHub سے منسوب 367 commits}	Bob.Hou _{🥈 GitHub سے منسوب 269 commits}	Paijo _{🥉 GitHub سے منسوب 229 commits}	backryun _{🏅 GitHub سے منسوب 202 commits}	Paco Cartones _{🏅 GitHub سے منسوب 174 commits}	Ravi Tharuma _{🏅 GitHub سے منسوب 126 commits}
Markus Hartung _{🏅 GitHub سے منسوب 114 commits}	Randi _{🏅 GitHub سے منسوب 108 commits}	Jan Leon _{🏅 GitHub سے منسوب 87 commits}	Chris _{🏅 GitHub سے منسوب 70 commits}	Koosha Paridehpour _{🏅 GitHub سے منسوب 68 commits}

_{2026-10-18 14:44:45 UTC پر دوبارہ جانچ کی گئی: ڈیفالٹ برانچ release/v3.8.52 کے لیے repository Contributors API کی رپورٹ کے مطابق GitHub سے منسوب commits۔ API نے 849 شناختیں واپس کیں (429 users، 2 bots، 418 anonymous)؛ اس جدول میں maintainer، bots اور anonymous شناختیں شامل نہیں ہیں، جبکہ برابر پوزیشنیں برقرار رکھی گئی ہیں۔ یہ اوپر دی گئی merged-PR درجہ بندی اور نیچے دی گئی Git-metadata مردم شماری، دونوں سے الگ ہے۔}

🙏 ان contributors کے features، bug fixes اور infrastructure میں بہتریاں اس چیز کا ایک بنیادی حصہ ہیں جو OmniRoute کو قابلِ اعتماد اور خصوصیات سے بھرپور بناتی ہے۔ ہر pull request، ہر test case اور ہر i18n translation file اہم ہے۔ Open source ان جیسے لوگوں کی بدولت بنتا ہے۔

💖 اسپانسرز

ان لوگوں کا تہِ دل سے شکریہ جو اپنی جیب سے OmniRoute کی مالی معاونت کرتے ہیں — ہر تعاون اس منصوبے کو مفت، خودمختار اور رواں دواں رکھتا ہے۔

Andrew _{💛 فعال ماہانہ اسپانسر}	Vlad I _{💛 فعال ماہانہ اسپانسر}	小妍儿 _{💛 فعال ماہانہ اسپانسر}	Guilherme Costa _{💛 فعال یک وقتی اسپانسر}	Henrique Iurkiv _{💛 فعال یک وقتی اسپانسر}	Somesh Ghaturle _{💛 فعال یک وقتی اسپانسر}
Kolonie AI _{💛 سابق یک وقتی معاون}	Prof. Igor Morais _{💛 سابق یک وقتی معاون}	Pixma _{💛 سابق یک وقتی معاون}	Paco Cartones _{💛 سابق یک وقتی معاون}	longtao _{💛 سابق یک وقتی معاون}

_{… اور وہ دیگر افراد جو اپنی شناخت نجی رکھنا پسند کرتے ہیں 💛}

_{عوامی GitHub Sponsors کی 2026-10-18 کو GitHub Sponsors GraphQL API کے ذریعے دوبارہ توثیق کی گئی: کل 14 میں سے 11 عوامی اسپانسرشپس (6 فعال، 5 سابقہ)۔ GitHub کی isActive حیثیت اوپر دیے گئے فعال لیبلز کا تعین کرتی ہے؛ سابقہ عوامی یک وقتی معاونین کا شکریہ بدستور ادا کیا جاتا ہے، جبکہ نجی اسپانسرز گمنام رہتے ہیں۔ Ko-fi، Buy Me a Coffee، Liberapay، PIX اور کرپٹو عطیات درج نہیں کیے گئے کیونکہ ان کا کوئی عوامی اسپانسر ریکارڈ موجود نہیں ہے۔}

💖 اسپانسر بنیں → — ہر ڈالر OmniRoute کو مفت اور خودمختار رکھتا ہے۔

👥 900+ معاونین

_{لائیو release/v3.8.52 کے تازہ ترین سرے ad160ab2d1 (6,826 کمیٹس) پر 2026-10-18 کو آڈٹ کیا گیا: 993 معیاری بنائی گئی انسانی Git شناختیں — 707 کمیٹ مصنفین کے طور پر ظاہر ہوتی ہیں (بشمول مینٹینر) اور 286 صرف واضح Co-authored-by ٹریلرز میں۔ یہ مردم شماری .mailmap کا اطلاق کرتی ہے، ای میل پتوں کا حروف کی چھوٹی بڑی شکل سے قطع نظر موازنہ کرتی ہے، عددی اور سادہ GitHub noreply پتوں کو صرف اس وقت یکجا کرتی ہے جب وہ ایک ہی ہینڈل کو ظاہر کریں، 26 bot/agent/service/placeholder شناختوں کو خارج کرتی ہے، اور عام ای میل پتوں کو محض اس وجہ سے ضم نہیں کرتی کہ ان کے نمائشی نام مماثل ہیں۔ 2026-08-24 کے آڈٹ میں 639 شائع کیے گئے تھے؛ اس طریقے کو اس آڈٹ کی بنیاد ac02c5b42f پر دوبارہ چلانے سے 619 حاصل ہوتے ہیں، لہٰذا اضافہ نئے معاونین کی وجہ سے ہے، کسی نرم طریقۂ کار کی وجہ سے نہیں۔}

تعاون کیسے کریں

ریپوزٹری کو فورک کریں
فعال release/vX.Y.Z کے تازہ ترین سرے سے برانچ بنائیں (main سے نہیں) — برانچنگ اور ریلیز ماڈل دیکھیں
اپنی فیچر برانچ بنائیں (git checkout -b feat/amazing-feature)
اپنی تبدیلیاں کمیٹ کریں (git commit -m 'feat: add amazing feature')
برانچ پر پُش کریں (git push origin feat/amazing-feature)
base = وہی release/vX.Y.Z برانچ رکھتے ہوئے Pull Request کھولیں

تفصیلی رہنما ہدایات کے لیے CONTRIBUTING.md دیکھیں۔

نیا ورژن ریلیز کرنا

# ریلیز بنائیں — npm publish خودکار طور پر انجام پاتا ہے
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 ستارے

🌍 StarMapper

🙏 اعتراف و تشکر

OmniRoute عظیم منصوبوں کی بنیاد پر قائم ہے۔ اس کا آغاز 9router کے ایک fork اور Go پروجیکٹ CLIProxyAPI کی TypeScript پورٹ کے طور پر ہوا — اور اس کے بعد، ذیل کا ہر ذیلی نظام کسی ایسے اوپن سورس پروجیکٹ سے متاثر ہوا جو پہلے ہی یہ کام کر چکا تھا۔ ان میں سے ہر ایک نے OmniRoute کے کسی نہ کسی ٹھوس حصے کو تشکیل دیا۔ یہ ان سب کے لیے ہمارا اظہارِ تشکر ہے۔ 🙏

⭐ ستاروں کی تعداد کی 18 اکتوبر 2026 کو GitHub کی REST API کے ذریعے تصدیق کی گئی — جا کر ان پروجیکٹس کو ستارہ دیں۔ یہ تعداد ایک مخصوص تاریخ پر لیا گیا بالکل درست عکس ہے اور وقت کے ساتھ فطری طور پر تبدیل ہوگی۔

🧬 نسب اور گیٹ وے

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
9router	31,004	وہ اصل پروجیکٹ جس پر یہ fork بنایا گیا ہے — جسے یہاں ملٹی موڈل APIs اور مکمل TypeScript باز تحریر کے ساتھ توسیع دی گئی ہے۔
CLIProxyAPI	55,591	Go کا وہ نفاذ جس نے اس JavaScript / TypeScript پورٹ کو متاثر کیا۔
LiteLLM	61,482	وہ AI گیٹ وے جس کا عوامی قیمتوں کا ڈیٹا سیٹ ہماری لاگت سے باخبر رہنے والی مطابقت پذیری کو ڈیٹا فراہم کرتا ہے، اور جس کے فراہم کنندہ کو معمول پر لانے کے ماڈل نے ہماری روٹنگ کی تشکیل میں رہنمائی کی۔
codex-chatgpt-web	14,526	MIT ماخذ کو پیکج میں شامل ChatGPT Web → Codex Responses برج کے لیے موزوں بنایا گیا، جس میں براؤزر سیشن، ردِعمل کی فریمنگ، استعمال اور ویب تلاش کے اڈاپٹر شامل ہیں۔
free-claude-code	61,430	اس کے نمونوں کو اسٹریم بحالی، بغیر سوچ بچار والے متبادل ناموں، متبادل ویب تلاش، سلائیڈنگ ونڈو حدود، لاگ کی حساس معلومات چھپانے اور زیادہ محفوظ لانچر بہاؤ میں منتقل کیا گیا۔
composer-api	346	Cursor Composer کے ٹول انتخاب، آؤٹ پٹ پابندی اور ٹول کمٹ کے نمونوں کو مقامی Cursor executor کے لیے موزوں بنایا گیا۔
codex-multi-auth	553	نئے لاگ اِن اور refresh-token گردشی تبدیلی کے نمونوں کو Codex OAuth کی دوبارہ توثیق میں منتقل کیا گیا۔
opencode-anthropic-auth	558	Claude Code سے ہم آہنگ تبدیلی کی طے شدہ ترتیبات اور بلنگ ہیڈر کے رویے کو عمومی بنا کر OmniRoute کے کنفیگریشن سے چلنے والے برج میں شامل کیا گیا۔
grok2api-merged	2	اس کی Grok ماڈل میپنگز، جعلی TypeError والا Statsig جنریٹر، درخواست اور ڈیوائس کی طے شدہ ترتیبات، اور NDJSON ردِعمل پروسیسر کو نمایاں طور پر OmniRoute کے Grok Web executor کے لیے موزوں بنایا گیا۔
TQZHR/grok2api	706	grok2api-merged کے پسِ پشت بنیادی بالواسطہ کوڈ ماخذ؛ اس کے ماڈل، ہیڈر، payload، Statsig اور پروسیسر کے نفاذ Grok Web کے نسب میں محفوظ ہیں۔
chenyme/grok2api	7,819	Grok payload اور ڈیوائس کی طے شدہ ترتیبات، Statsig جنریٹر، اور TQZHR اور grok2api-merged کے ذریعے منتقل ہونے والے `result.response` پروسیسر کا بنیادی MIT ماخذ۔
grok2api-pro	27	grok2api-merged کی جانب سے اپنی پراکسی پول تہہ کے لیے تسلیم کردہ ایک بالواسطہ ماخذ؛ OmniRoute اس نسبی انتساب کو محفوظ رکھتا ہے، لیکن اپنے محدود Grok Web executor میں پراکسی پول پورٹ کا دعویٰ نہیں کرتا۔
GrokProxy	51	اس کے کوکی سے توثیق شدہ Grok پراکسی اور `result.response.token` اسٹریمنگ نمونے نے OmniRoute کے Grok Web ٹرانسپورٹ کی تشکیل میں رہنمائی کی۔
GrokBridge	5	اصل Grok Web نفاذ میں اس کے HTTP/براؤزر upstream ڈیزائن سے رجوع کیا گیا؛ اس کا براہِ راست HTTP راستہ GrokProxy سے ماخوذ ہے، اس لیے کسی آزاد کوڈ پورٹ کا دعویٰ نہیں کیا جاتا۔

🗜️ سیاق و سباق اور ٹوکن کمپریشن — انجن

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
Caveman	113,396	وائرل "جب چند ٹوکن سے کام ہو تو زیادہ ٹوکن کیوں استعمال کریں" پروجیکٹ — اس کا غار کے انسان جیسا اندازِ بیان ہمارے معیاری کمپریشن موڈ اور 30+ زائد الفاظ ہٹانے/اختصار کے قواعد کی بنیاد ہے۔
RTK – Rust Token Killer	83,835	اعلیٰ کارکردگی والی کمانڈ آؤٹ پٹ کمپریشن — اس سے ہمارا RTK انجن، JSON فلٹر DSL، خام آؤٹ پٹ کی بازیابی اور تہہ دار RTK → Caveman پائپ لائن متاثر ہوئے۔
headroom	75,741	قابلِ واپسی سیاقی کمپریشن (SmartCrusher) — اس سے ہمارا `headroom` انجن اور `ccr` بازیابی-مارکر پیٹرن متاثر ہوئے۔
LLMLingua	6,757	پرامپٹ کمپریشن تحقیق (LLMLingua / LLMLingua-2) — اس سے ہمارا غیر ہم وقت، کوڈ-محفوظ، ناکامی کی صورت میں کھلا رہنے والا `llmlingua` انجن متاثر ہوا۔
llmlingua-2-js	32	JS/ONNX پورٹ (MobileBERT / XLM-RoBERTa)، جو ہمارے LLMLingua انجن کے لیے ورکر-تھریڈ بیک اینڈ کے طور پر استعمال ہوتا ہے۔
Troglodita	50	PT-BR ٹوکن کمپریشن — ہمارے pt-BR لینگویج پیک کی بنیاد: برازیلی پرتگالی قواعد کے مطابق موزوں غیر ضروری تکرار میں کمی اور زائد الفاظ کا اخراج۔
ponytail	166,731	وائرل "سست سینئر ڈویلپر" YAGNI-کوڈر مہارت — اس سے ہمارا less-code آؤٹ پٹ اسٹائل متاثر ہوا: سب سے چھوٹی قابلِ عمل تبدیلی کی سمت نمائی، جو _تخلیق کردہ_ کوڈ گھٹاتی ہے (Caveman کی مختصر نثر کا آؤٹ پٹ-محور ہم زاد)۔
i-have-adhd	57,628	اس کے عمل کو مقدم رکھنے والے، ADHD-دوست جوابی انداز کو پانچ زبانوں میں OmniRoute کے مختصر آؤٹ پٹ اسٹائل کے لیے ڈھالا گیا۔

🧩 مختصر فارمیٹس، ٹوکن تحقیق اور کوڈ سے آگاہ ٹولنگ

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
TOON	25,509	ٹوکن پر مبنی آبجیکٹ نوٹیشن — اس کے کالمی، ہیڈر-بمع-قطار ماڈل نے ہمارے جدولی اختصار کے مرحلے کو شکل دی۔
GCF – Graph Compact Format	59	اس کے مختصر گراف فارمیٹ اور عمومی پروفائل ڈیزائن نے OmniRoute کے جدولی اختصار اور Headroom کوڈیک فارمیٹ کی تشکیل میں رہنمائی کی۔
gcf-typescript	4	MIT TypeScript امپلیمنٹیشن، جسے براہِ راست شامل کر کے Headroom عمومی پروفائل کوڈیک کے طور پر توسیع دی گئی۔
token-optimizer-mcp	551	Brotli/SQLite کیش + فی سیشن سیاقی فرق — اس سے ہمارا `session-dedup` انجن متاثر ہوا۔
token-savior	1,182	Bash آؤٹ پٹ اختصار + MCP پروفائلز — اس سے ہماری کمپریشن ترک کرنے کی حکمتِ عملی اور MCP ٹول-مینی فیسٹ میں کمی متاثر ہوئی۔
token-saver	154	مواد سے آگاہ، فی فائل-قسم آؤٹ پٹ کمپریشن، جس میں ناکامی کے مطابق ترک کرنے کی صلاحیت ہے — اس نے ہماری فی قسم ترسیل اور کم از کم فائدے سے کم ہونے پر چھوڑ دینے کے طریقے کی توثیق کی۔
token-optimizer	2,595	"چھپے ہوئے ٹوکن تلاش کریں" — اس کے آف لوڈ + قابلِ بازیابی ہینڈل پیٹرن نے ہماری CCR آف لوڈ سوچ کی تشکیل میں رہنمائی کی۔
TokenMizer	33	ایک سیشن-گراف + مختلف ٹرنز کے درمیان سطری نقل ختم کرنے کا خاکہ، جس نے ہمارے session-dedup ڈیزائن کی تشکیل میں رہنمائی کی۔
OmniCompress	3	Rust کالمی JSON + مواد کے پتے سے بازیابی + پیغامات کے درمیان نقل کا خاتمہ — اس نے ہمارے `headroom`/`ccr`/`session-dedup` انجن ڈیزائن اور کیش-مستحکم "کمپریس شدہ صورت مقام سے آزاد ہے" مستقل اصول کی توثیق کی۔
mcp-compressor	133	MCP ٹول-اسکیما/وضاحت کی کمپریشن — اس نے ہمارے MCP ٹول-مینی فیسٹ کی تعداد میں کمی کی تشکیل میں رہنمائی کی۔
RepoMapper	217	Aider طرز کی ریپو-میپ درجہ بندی — اس نے ہماری ریپو-میپ / بازیابی-درجہ بندی کی تحقیق کی تشکیل میں رہنمائی کی۔
quiet-shell-mcp	4	MCP پر اعلانیہ شیل آؤٹ پٹ میں کمی — اس نے ہمارے اعلانیہ bash آؤٹ پٹ اختصار کی توثیق کی۔
ts-morph	6,205	TypeScript Compiler API ٹول کٹ — اس سے پارسر پر مبنی تبصرہ ہٹانے کا ہمارا طریقہ متاثر ہوا، جو اسٹرنگ، ٹیمپلیٹ اور ریجیکس لٹرلز کو محفوظ رکھتا ہے۔

🧠 میموری اور RAG

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
Mem0	67,385	جامع میموری تہہ — اس کے پراکسی بطور تحریر/مطالعہ حد ماڈل نے ہمارے میموری آرکیٹیکچر کو تشکیل دیا۔
Letta (MemGPT)	25,179	درجہ بند میموری کے حامل حالت برقرار رکھنے والے ایجنٹس — اس نے ہمارے Context Control & Recovery (CCR) کے درجہ بند ماڈل کو متاثر کیا۔
WFGY	1,800	بار بار پیش آنے والی 16 RAG/LLM ناکامی کی صورتوں کی ProblemMap درجہ بندی — ہماری ٹربل شوٹنگ گائیڈ میں مشترکہ اصطلاحات کی بنیاد۔

🛰️ ٹریفک معائنہ، MITM اور شفاف پراکسی

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
llm-interceptor	79	کوڈنگ اسسٹنٹ ↔ LLM ٹریفک کی MITM مداخلت/تجزیے نے Traffic Inspector کی ابتدائی ضروریات مرتب کرنے میں مدد دی۔ پہلے اخذ کیے گئے چار ماڈیولز — SSE انضمام، گفتگو کی معیار بندی، رازوں کی نقاب پوشی اور ہیڈر کی صفائی — کو عوامی پروٹوکول معیارات پر مبنی آزاد کلین روم نفاذ سے تبدیل کر دیا گیا ہے۔ ہوسٹ پاس تھرو کی دو سطحیں (`passthrough.ts` اور `_internal/bypass.cjs`) بدستور OmniRoute کے داخلی نفاذ ہیں جن کی آزادانہ درجہ بندی کی گئی ہے؛ اس تبدیلی کے تحت انہیں دوبارہ نہیں لکھا گیا۔
ProxyBridge	6,814	ہر عمل کے لیے شفاف پراکسی روٹنگ — اس نے ہمارے کریش سے محفوظ MITM اختتام، ساکٹ غیر فعالیت ٹائم آؤٹس، `/proc` عمل انتساب اور TPROXY کیپچر کو متاثر کیا۔

📚 ماڈل ڈیٹا، مشاہدہ پذیری اور UI

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
models.dev	7,286	AI ماڈل کی تفصیلات، قیمتوں اور صلاحیتوں کا کھلا ڈیٹابیس — ہمارے ماڈل کیٹلاگ میں مقامی طور پر ہم وقت کیا گیا۔
React Flow / xyflow	38,705	نوڈ پر مبنی گراف لائبریری جو ہمارے حقیقی وقت کے Compression Studio اور Combo/Routing Studio کو تقویت دیتی ہے۔
LangGraph	43,443	LangGraph Studio کی براہ راست ورک فلو گراف منظر کشی نے ہمارے Studios کے حقیقی وقت کے کیسکیڈ منظر کو متاثر کیا۔
Langfuse	35,990	اس کے ٹریس → اسپین → جنریشن مشاہدہ پذیری ماڈل نے ہمارے Compression Studio واٹر فال کو تشکیل دیا۔
Kiali	3,645	Istio سروس میش مشاہدہ پذیری — اس نے Routing/Combo Studio میں ہمارے سرکٹ بریکر بیجز اور ایرر ایج مناظر کو متاثر کیا۔
lobe-icons	2,615	AI/LLM برانڈ لوگوز جو ہمارے ڈیش بورڈ بھر میں فراہم کنندگان کے آئیکنز دکھاتے ہیں۔
flag-icons	12,473	README کے زبان منتخب کنندہ میں استعمال ہونے والے MIT لائسنس یافتہ SVG پرچم فراہم کرتا ہے۔

🛡️ سیکیورٹی

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
awesome-secure-defaults	722	بطور ڈیفالٹ محفوظ لائبریریوں کی منتخب فہرست جو ہمارے سیکیورٹی کے انتخاب کی رہنمائی کرتی ہے (Helmet.js، DOMPurify، ssrf-req-filter، safe-regex، Google Tink)۔

🧭 تکمیلی ٹولز

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
ClawRouter	6,628	اس نے درخواستوں کی نقل دور کرنے، ہنگامی صفر لاگت فال بیک، قابل تنصیب Auto-Combo حکمت عملیوں اور کثیر لسانی ارادے کی درجہ بندی کو متاثر کیا۔
Antigravity-Manager	32,333	اس کی اکاؤنٹ سے آگاہ ماڈل ری میپنگ، قابل نفاذ فائل کے راستے کی توثیق اور پلان لیبل کے طرز عمل نے OmniRoute کے Antigravity رن ٹائم کی تشکیل میں مدد دی۔
vscode-antigravity-cockpit	4,850	اس کے مختصر کوٹا ری سیٹ الٹی گنتی فارمیٹ نے OmniRoute میں فراہم کنندہ کی حد کے متعلقہ ڈسپلے کو متاثر کیا۔
AionUi	33,611	اس کے ACP انضمامات نے OmniRoute میں نصب شدہ CLI ایجنٹس کی خودکار شناخت کو متاثر کیا۔
CodexBar	22,616	اس نے Grok Build کوٹا سطح کی نشان دہی کی؛ پھر OmniRoute نے آزادانہ طور پر براہ راست وائر فارمیٹ کی توثیق اور اصلاح کی۔

📄 لائسنس

MIT لائسنس - تفصیلات کے لیے LICENSE دیکھیں۔

⬆ اوپر واپس جائیں · اوپن سورس AI کمیونٹی کے لیے ❤️ کے ساتھ تیار کردہ۔

_{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT لائسنس · omniroute.online}

FilesExpand file tree

README.md

Latest commit

History