> مفت درجوں کو دستی طور پر یکجا کرنا تکلیف دہ ہے — درجنوں SDKs، درجنوں شرح کی حدود، اور یہ معلوم ہی نہیں ہوتا کہ حقیقتاً آپ کے پاس کتنا ہے۔ OmniRoute، **35 بار بار دستیاب پول کیز میں 489 مفت درجے کے اندراجات** کی فہرست مرتب کرتا ہے اور ٹوکن کی نمایاں تعداد کا حساب **شائع شدہ مثبت ماہانہ بجٹ والے 17 پولز، نیز فی ماڈل Groq کی پانچ حدود** سے لگاتا ہے، جبکہ مشترکہ پول کے لحاظ سے نقل ختم کی جاتی ہے۔ وہ کوٹے جو صرف علاقائی شناخت کی جانچ کے بعد دستیاب ہوتے ہیں (فی الحال: ModelScope)، الگ دکھائے جاتے ہیں، علاقائی شناخت کی توثیق کے پیچھے +~6M، اور انہیں کبھی بھی نمایاں مجموعے میں شامل نہیں کیا جاتا۔ نتیجہ ڈیش بورڈ (`/dashboard/free-tiers`) پر نظر آتا رہتا ہے۔
> براہِ راست `/dashboard/free-tiers` صفحے کا متحرک خلاصہ۔ مکمل طریقۂ کار (پول کی نقل کا خاتمہ، کریڈٹ درجے، فراہم کنندہ کی شرائط): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**۔
>
> ان اعداد و شمار کا براہِ راست کیٹلاگ کے مقابل ہر دو ہفتے بعد دوبارہ آڈٹ کیا جاتا ہے اور یہ **دونوں سمتوں میں تبدیل ہوتے ہیں** — کوئی فراہم کنندہ مفت درجہ ختم کرے تو تعداد کم ہو جاتی ہے؛ نیا شامل ہو تو بڑھ جاتی ہے۔ ہم وہی شائع کرتے ہیں جس کا کیٹلاگ حقیقتاً حساب لگاتا ہے، کبھی بھی اوپر کی طرف گول کیا ہوا بہترین ممکنہ منظرنامہ نہیں۔
⭐ اگر OMNIROUTE نے پیسے بچانے اور آپ کا کام آسان بنانے میں مدد کی ہے تو ریپو کو اسٹار کریں۔
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 کمیونٹی میں شامل ہوں
**👋 مینٹینر کو فالو کریں — نئے فراہم کنندگان، ریلیزز اور تجاویز سب سے پہلے حاصل کریں:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**سوالات، فراہم کنندگان سے متعلق تجاویز، روڈ میپ اور معاونت → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 عالمی](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 برازیل](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [پورٹل](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 گیٹ وے مسلسل بڑھ رہا ہے
## 🆓 انسٹال کرتے ہی کام کرتا ہے — کوئی کیز نہیں، کوئی کنفیگ نہیں
```bash
# تازہ انسٹال، زیرو کریڈینشلز — `auto` پہلے ہی کام کرتا ہے:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
ایک مخصوص مفت بیک اینڈ کو ترجیح دیتے ہیں؟ براہ راست `oc/…` (OpenCode Free) کو کال کریں۔ پھر `auto` پر گریجویٹ کریں اور OmniRoute کو منتخب کرنے دیں۔📦 **Python, Node.js, PHP, اور cURL** کے لیے کاپی پیسٹ کوئیک اسٹارٹ اسکرپٹس → [`examples/quickstart/`](examples/quickstart/)
# 💥 وعدہ
# 🤔 OmniRoute کیوں؟
## 🤝 ہمارے اوپن سورس دوستوں کا تعاون
> **کیا آپ بطور اوپن سورس دوست شامل ہونا چاہتے ہیں؟** یہ وہ کمپنیاں ہیں جو اوپن سورس کی حمایت کرتی ہیں اور OmniRoute کو متحرک رکھنے میں مدد کرتی ہیں — اور ہم عوامی طور پر بتاتے ہیں کہ ان کا دیا ہوا ہر ٹوکن کہاں جاتا ہے۔ رابطہ کریں: [diegosouza.pw@outlook.com](mailto: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/offline
🔋 سب سے زیادہ کوٹا / ریٹ لمٹ گنجائش کو پہلی ترجیح
auto/smart
🔭 معیار کو ترجیح + بہتر ماڈلز دریافت کرنے کے لیے 10% آزمائش
auto/lkgp
📌 آخری معلوم اچھے فراہم کنندہ کے ساتھ واضح وابستگی
auto/chaos
🧪 لچک کی جانچ کے لیے فالٹ انجیکشن وزن (کیاس انجینئرنگ)
##
### 🔀 یا اپنا کامبو بنائیں — روٹنگ کی 19 حکمتِ عملیاں
تمام **19** حکمتِ عملیاں — ہر کامبو مرحلے کے لیے حسبِ ضرورت ملائیں:
#
حکمتِ عملی
یہ کیا کرتی ہے
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
reset-window
اس ہدف کو ترجیح دیں جس کی کوٹا ونڈو سب سے پہلے ری سیٹ ہو
12
reset-aware
کوٹا ری سیٹ وقت کے مطابق درجہ بندی کریں — مختصر ونڈوز پہلے 📊
13
context-relay
طویل گفتگوؤں کے لیے اہداف کے درمیان سیاق و سباق منتقل کریں 🧠
14
context-optimized
موجودہ سیاق و سباق کے حجم کے لیے بہترین موزوں ہدف منتخب کریں
15
cache-optimized
ہر قابلِ استعمالِ نو پرامپٹ سابقے کو اسی اکاؤنٹ سے منسلک رکھیں — پرامپٹ کیش ہٹس زیادہ سے زیادہ کریں 🎯
16
lkgp
آخری معلوم کامیاب راستہ — آخری کامیاب فراہم کنندہ سے منسلک رہتا ہے، پھر قواعد کے مطابق متبادل استعمال کرتا ہے
17
auto
ہر کنکشن میں 16 عوامل پر مبنی براہِ راست اسکورنگ 🤖
18
fusion
ماڈلز کے ایک پینل تک درخواست پھیلائیں + ایک منصف جوابات کو یکجا کر کے ایک جواب بناتا ہے 🧬
19
pipeline
مراحل کو زنجیر بنائیں — ہر ہدف کا آؤٹ پٹ اگلے ہدف کو فراہم کیا جاتا ہے 🔗
Auto-Combo انجن ہر امیدوار کو **16 عوامل** (صحت، کوٹا، لاگت، تاخیر، کام سے مطابقت، معیار، سیشن کی دستیابی…) پر اسکور کرتا ہے — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) دیکھیں۔
##
### 🧱 لچک پہلے سے شامل ہے (3 آزاد پرتیں)
📖 [آٹو کومبو انجن](docs/routing/AUTO-COMBO.md) · [لچک کی رہنما کتاب](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute کو کیا چیز ممتاز کرتی ہے
📊 مکمل طریقہ کار اور فی خصوصیت تفصیل بمقابلہ 9router، OpenRouter، CLIProxyAPI اور LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRoute کی معاونت کریں
OmniRoute کو MIT لائسنس حاصل ہے اور اسے کھلے عام برقرار رکھا جاتا ہے۔ اگر یہ آپ کا وقت یا پیسہ بچاتا ہے، تو اسے خودمختار رکھنے کے طریقے یہ ہیں — جو آپ کے لیے موزوں ہو، اسے منتخب کریں۔ اسپانسرشپ کبھی بھی روٹنگ کی ترجیح پر اثرانداز نہیں ہوتی؛ اس سے صرف نمایاں حیثیت ملتی ہے، درجہ بندی نہیں۔
**🇧🇷 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](https://github.com/diegosouzapw/OmniRoute/discussions) کھولیں۔
ڈویلپر نوٹس: ڈویلپر کی سہولت کے لیے پروجیکٹ 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](https://radar.omniroute.online/planos)** پر جانیں۔
## ✨ نیا کیا ہے
> **v3.8.20 → v3.8.50** کی حالیہ نمایاں تبدیلیاں۔ مکمل تاریخ [`CHANGELOG.md`](CHANGELOG.md) میں موجود ہے۔
- **🎛️ OmniConductor** — آپ کے agent fleet کو inbound A2A delegation، Agent Card پر Conductor skills، اور Faro push-to-talk voice chat کے ساتھ ایک dashboard panel۔ → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 موافق admission اور overload تحفظ** — بھاری chat requests اب 503 دینے کے بجائے queue ہوتی ہیں، جبکہ ہر connection کے لیے atomic RPM rolling leases موجود ہیں۔ → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ معیاری `/v1/models` ترتیب** — ہر provider کے لیے ایک مسلسل، provider کے لحاظ سے گروپ شدہ block (combos پہلے pin کیے گئے)، جو ہر catalog source میں مستحکم رہتا ہے۔ → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ Compression کی مضبوطی** — بطور default فعال inflation guard، DE / FR / JA + Chinese (wényán) کے لیے Caveman packs، اور Gradle و .NET کے لیے RTK filters۔ → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 شفاف flat-rate لاگت** — subscription / coding-plan providers کی cost analytics میں لاگت **$0** دکھائی جاتی ہے؛ budget، quota اور routing بدستور تخمینہ لگاتے رہتے ہیں۔ → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share routing** — مشترکہ account کا quota pooled keys کے درمیان منصفانہ طور پر تقسیم کرتا ہے، اور work-conserving انداز میں غیر استعمال شدہ حصے دوسروں کو دے دیتا ہے۔ → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 ایک command سے CLI/agent setup** — 13 رجسٹرڈ `setup-*` commands؛ `omniroute run` سے 7 CLIs (Claude Code، Codex، Aider، Goose، OpenCode، Qwen Code، Gemini CLI) چلتی ہیں؛ `omniroute configure` interactive provider+model picker اور ہر context کے الگ favorites کے ساتھ 10 targets کو support کرتا ہے۔ → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Remote mode** — scoped tokens (`connect` / `contexts` / `tokens`) کے ساتھ remote OmniRoute چلائیں، نیز VPS تنصیبات کے لیے ایک `antigravity` OAuth helper استعمال کریں۔ → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 زیادہ ذہین auto-routing** — `auto/:` combos، **Fusion** (model panel + judge)، task-aware routing، اور ہر request کے لیے model / mode / USD-budget overrides۔ → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Pluggable compression** — 12 قابلِ ترکیب engines + Compression Studios: LLMLingua-2، two-tier Ultra، omniglyph، ہر step کے لیے fidelity gate، GCF v3.2، اور drag-reorder editor۔ → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ شفاف MITM decrypt (TPROXY)** — ان CLIs کو capture کریں جو proxy env vars نظرانداز کرتی ہیں، ایک per-SNI CA اور trust-store installer کے ساتھ۔ → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 ہر جگہ cost telemetry** — ہر endpoint پر `X-OmniRoute-*` cost/usage headers، cache-HIT savings header، اور ہر key کے لیے USD spend quotas۔ → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 آپ کے اختیار میں memory** — بطور default بند، اختیاری int8 vector quantization + typed decay، اور ہر request کے لیے `x-omniroute-no-memory`۔ → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ سیکیورٹی** — ہر LLM route پر prompt-injection guard (red-team suite)، اختیاری credential-masking guardrail (دونوں سمتوں میں افشا شدہ API keys/secrets کو redact کرتا ہے)، مفت DuckDuckGo آخری چارۂ کار web search، اور dashboard کے لیے اختیاری OIDC login gate (password login ہمیشہ دستیاب رہتا ہے)۔ → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ نئے endpoints** — `/v1/ocr` (Mistral OCR) اور `/v1/audio/translations` (Whisper-style) media surface کو مکمل کرتے ہیں۔ → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 Image / video / audio generation** — media کے لیے ایک API: xAI Grok Imagine اور Novita AI video، ComfyUI، Magnific، Adobe Firefly، Segmind، اور ElevenLabs جیسے speech providers۔ → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 Deployment اور ops** — reverse-proxy `basePath`، browser-language کی خودکار شناخت، ہر key کے لیے device tracking، root-less MITM trust، اور zh-TW localization۔ → [Environment](docs/reference/ENVIRONMENT.md)
- **🤝 مزید providers اور agents** — cloud agents (Codex Cloud، Cursor، Devin، Jules)، browser + OAuth login کے ساتھ Grok Build (xAI)، Ollama کا first-class card، Claude Opus 5 اور Sonnet 5، Kimi کی باضابطہ partnership (Code/Web/Moonshot)، Zed، Requesty، SenseNova، Yuanbao، Agnes AI… اور تازہ کردہ **352-provider catalog**۔ → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Routing کی شفافیت** — ہر response میں ایک `X-OmniRoute-Decision` header شامل ہوتا ہے جو اسے فراہم کرنے والی strategy/provider/latency بتاتا ہے، نئی `cache-optimized` combo strategy + Auto-Combo کا `cacheAffinity` factor بار بار آنے والی requests کو cached prefix رکھنے والے connection کی طرف واپس route کرتا ہے، اور read-only `/v1/auto-combo/{channel}/candidates` endpoint کسی `auto/*` channel کا live candidate pool ظاہر کرتا ہے۔ → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ مقامی performance اور infra** — one-click local Redis، Cloudflare Workers / Deno Deploy relay deployers، اور supervised embedded services کے طور پر Bifrost و Mux۔ → [Embedded Services](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 پیکیج میں مزید بھی شامل ہے** — plugin framework + marketplace، Omni/Agent/GitHub skills frameworks، Obsidian vault integration (22 MCP tools)، OpenAI-compatible Batch اور Files APIs، semantic response cache، leaderboards کے ساتھ gamification، ACP agent discovery (15 built-in agents)، BigQuery پر scheduled log export، `auto/chaos` fault injection، Telegram bot bridge، in-app version manager، اور LMArena-ELO free-provider rankings۔ → [Docs](docs/README.md)
## 🤖 مطابقت رکھنے والے CLIs اور کوڈنگ ایجنٹس
> ایک کنفیگ — `http://localhost:20128/v1` — اور **ہر** AI IDE یا CLI مفت اور کم لاگت والے ماڈلز پر چلتا ہے۔
＋ ان کے ساتھ بھی کام کرتا ہے · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · OpenAI سے مطابقت رکھنے والا کوئی بھی ٹول
📖 تمام 36 ٹولز کے لیے فی ٹول سیٹ اپ (26 CLI Code's + 10 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode پلگ اِن → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**ایک ہی کمانڈ کے ذریعے OmniRoute سے کوئی بھی معاونت یافتہ CLI چلائیں** — کوئی کنفیگریشن فائل نہیں لکھی جاتی،
اسناد ہر پراسیس میں شامل کی جاتی ہیں، اور Qwen/Gemini کو عارضی علیحدہ ہوم ملتا ہے:
```bash
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"
# یا انٹرایکٹو انداز میں provider+model منتخب کریں اور ٹول کی اپنی کنفیگریشن لکھیں:
omniroute configure codex # یہ بھی: claude opencode qwen aider goose gemini cline continue kilo
```
ہر کمانڈ فعال ریموٹ سیاق (`omniroute connect `) کی پیروی کرتی ہے، `--dry-run`
عمل درآمد کیے بغیر عین env/args کا پیش منظر دکھاتا ہے، اور `--api-key-env NAME` رازوں کو
آپ کی شیل ہسٹری سے باہر رکھتا ہے۔ → [CLI انضمامات](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 357 AI فراہم کنندگان — 152 کیٹلاگ میں مفت نشان زدہ
> **357 رجسٹرڈ فراہم کنندگان** مستند چیٹ، میڈیا، تلاش، مقامی، کلاؤڈ ایجنٹ اور سسٹم کلیکشنز میں موجود ہیں، جن میں **152 کے ڈسکوری میٹا ڈیٹا میں `hasFree: true` درج ہے**۔ چیٹ ماڈل رجسٹری میں **229 فراہم کنندگان / 2,554 منفرد فراہم کنندہ-ماڈل جوڑے / 1,283 خام ماڈل IDs** شامل ہیں؛ علیحدہ مفت بجٹ کیٹلاگ میں **491 فی ماڈل قطاریں**، **35 بار بار تجدید ہونے والے پولز** اور **54 بار بار تجدید ہونے والے/بغیر کلید کے ہمیشہ مفت فراہم کنندگان** ہیں۔ یہ دانستہ طور پر مختلف مخرج ہیں؛ تعریفیں اور پول کی تکرار ختم کر کے کیے گئے حسابات [فراہم کنندہ کا حوالہ](docs/reference/PROVIDER_REFERENCE.md) اور [مفت درجات](docs/reference/FREE_TIERS.md) میں موجود ہیں۔
### 🏢 ہر بڑی لیب — ایک ہی اینڈ پوائنٹ کے ذریعے
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…اور 330+ مزید — ہر آئیکن ڈیش بورڈ کے فراہم کنندہ کیٹلاگ سے براہِ راست حاصل ہوتا ہے۔ 📖 [فراہم کنندہ کا حوالہ](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 ہمیشہ مفت — $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 1M ٹوکنز/دن
OpenRouter :free ماڈلز +$10 → زیادہ RPM
📖 مکمل مشین کے قابلِ مطالعہ کیٹلاگ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute کہاں چلتا ہے — ہر جگہ
> وہی ایپ، آپ کی مشین، آپ کے اصول۔ عالمی npm انسٹالیشن سے لے کر Termux کے ذریعے **آپ کے فون** تک۔
پلیٹ فارم
انسٹالیشن
نمایاں خصوصیات
📦 npm (عالمی)
npm install -g omniroute
ایک کمانڈ، کوئی بھی OS
🐳 Docker
docker run … diegosouzapw/omniroute
ملٹی آرکیٹیکچر AMD64 + ARM64
🖥️ ڈیسک ٹاپ (Electron)
npm run electron:build
مقامی ونڈو + سسٹم ٹرے — Windows / macOS / Linux
🎩 مینو بار (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
سرور کی نگرانی اور خودکار اپ ڈیٹس — macOS
💪 ARM
مقامی arm64
Raspberry Pi، ARM سرورز، Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
آپ کے فون پر، 24/7، بغیر root کے چلتا ہے
📲 PWA
"ہوم اسکرین میں شامل کریں"
فل اسکرین، آف لائن، براؤزر سے قابلِ تنصیب
🧩 OpenCode پلگ اِن
@omniroute/opencode-provider
مقامی OpenCode انضمام
🤖 VS Code Copilot Chat
OmniCopilot ایکسٹینشن انسٹال کریں
مقامی Copilot Chat انتخاب کنندہ میں OmniRoute کا ہر ماڈل — مستحکم اور Insiders
### 🧩 نیا: VS Code کے مقامی Copilot Chat کے اندر OmniRoute
> کوئی نئی سائڈ بار نہیں، کوئی نیا چیٹ UI نہیں — OmniRoute کا فراہم کردہ ہر ماڈل براہِ راست
> **اسی Copilot Chat ماڈل انتخاب کنندہ میں ظاہر ہوتا ہے جسے آپ پہلے ہی استعمال کرتے ہیں**۔ VS Code 1.122 سے، فراہم کنندہ کے ماڈلز
> GitHub سائن اِن یا Copilot سبسکرپشن کے بغیر کام کرتے ہیں — ایجنٹ موڈ، ٹول کالنگ اور وژن،
> مفت۔
**[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** ایکسٹینشن انسٹال کریں، اسے
اپنے OmniRoute سرور کی طرف متوجہ کریں (پہلے سے طے شدہ `localhost:20128`)، پھر Copilot Chat → ماڈل انتخاب کنندہ
→ **ماڈلز کا نظم کریں…** → **OmniRoute** کھولیں۔
ایڈیٹر کے اندر سے: **ایکسٹینشنز** منظر کھولیں، **"OmniRoute"** تلاش کریں، **انسٹال کریں** پر کلک کریں
— دونوں اسٹورز پر اسی طرح کام کرتا ہے۔ سورس، مسائل اور اشاعت کی عملی ہدایات
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) پر موجود ہیں۔
📖 [VS Code Copilot Chat رہنما](docs/guides/VSCODE-COPILOT.md) — سیٹ اپ، انتخاب کنندہ کیا دکھاتا ہے، ٹیب کے اندر ڈیش بورڈ، مسائل کا حل
### 🎩 نیا: OmniRouteTray — آپ کا گیٹ وے، مینو بار میں موجود
> `omniroute serve` اس وقت بہترین کام کرتا ہے جب یہ ہمیشہ فعال ہو۔ **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> اسے macOS کے لیے ایک مرتبہ ترتیب دے کر بھول جانے والی مینو بار ایپ بنا دیتا ہے: یہ سرور شروع کرتا ہے، ری بوٹس
> کے بعد بھی اسے فعال رکھتا ہے، وہیں اپ ڈیٹ کرتا ہے، اور آپ کا لائیو ٹوکن بجٹ ایک کلک کی دوری پر رکھتا ہے — **کسی
> ٹرمینل ونڈو کو کھلا رکھنے کی ضرورت نہیں، نہ ہی `npm install -g omniroute` کی دیکھ بھال درکار ہے۔**
[Tauri v2](https://v2.tauri.app/) کے ساتھ بنایا گیا (ایک Rust کور جس کا حجم معمولی سی عددی خطا جتنا ہے)، یہ
اپنے دستخط شدہ Node 24 رن ٹائم کے ساتھ آتا ہے اور ایپ کی ملکیت والی OmniRoute انسٹالیشن کا نظم کرتا ہے، اس لیے یہ کبھی آپ کے
عالمی `node`/`bun` سے متصادم نہیں ہوتا۔ یہ **آپ کی موجودہ `~/.omniroute/` ترتیب اور ڈیٹابیس مشترکہ طور پر استعمال کرتا ہے** — لہٰذا یہ
وہی OmniRoute ہے جسے آپ پہلے ہی چلاتے ہیں، بس اب اس نے ٹوپی پہن رکھی ہے۔ 🎩
یہ کیا کرتا ہے
کیسے
🟢 سرور کی نگرانی کرتا ہے
omniroute serve شروع کرتا ہے، نقل بنانے کے بجائے پہلے سے چلتی ہوئی مثال کو اپنا لیتا ہے
📊 لائیو استعمال ایک نظر میں
فراہم کنندہ کے کوٹے کی پٹیاں، ری سیٹ الٹی گنتی کے ساتھ Claude سیشن/ہفتہ وار حدود، 30 دن کی لاگت کی تفصیل
🔄 وہیں خودکار اپ ڈیٹس
مرحلہ وار انسٹالیشن، ایٹمی تبادلہ، ناکامی پر واپسی — ہمیشہ تازہ ترین ریلیز پر
🚀 لاگ اِن پر آغاز
لاگ اِن پر اختیاری آغاز؛ صرف ٹرے، کوئی ڈاک آئیکن نہیں
🩺 Doctor اور لاگز
ایک کلک میں تشخیص اور سرور لاگز تک رسائی
```sh
brew install --cask zoispag/tap/omniroute-tray
```
ڈاؤن لوڈ کو ترجیح دیتے ہیں؟ تازہ ترین .dmgریلیزز سے حاصل کریں۔ سورس، مسائل اور بلڈ
دستاویزات zoispag/omniroute-tray پر موجود ہیں۔
💛 @zoispag کا ایک کمیونٹی پروجیکٹ — یہ OmniRoute کی باضابطہ ریلیز نہیں ہے۔
> سرور سے آگے بڑھ کر، OmniRoute ایک **مکمل کمانڈ لائن کاک پٹ** ہے جس میں **80+ کمانڈز** ہیں، نیز کھلے ایجنٹ پروٹوکولز بھی ہیں تاکہ کوئی AI ایجنٹ اسے **خود سے** چلا سکے۔
### ⌨️ ایک حقیقی CLI (صرف `start` نہیں)
```bash
omniroute # گیٹ وے + ڈیش بورڈ پیش کریں (پورٹ 20128)
omniroute chat # انٹرایکٹو TUI چیٹ کلائنٹ (سلیش: /model /combo /skill /memory)
omniroute setup # پہلی بار چلانے کے لیے رہنمائی یافتہ وزرڈ
omniroute doctor # فراہم کنندگان، پورٹس اور مقامی انحصارات کی تشخیص کریں
```
### 🛰️ ریموٹ موڈ — CLI یہاں چلائیں، OmniRoute کو VPS پر
OmniRoute کسی سرور پر ہے؟ اسے اپنے لیپ ٹاپ سے **اسی CLI** کے ذریعے چلائیں۔ محدود دائرۂ کار والے رسائی ٹوکن کے ساتھ ایک بار لاگ اِن کریں؛ اس کے بعد ہر کمانڈ ریموٹ کو ہدف بنائے گی۔
```bash
omniroute connect 192.168.0.15 # پاس ورڈ → محدود دائرۂ کار والا ٹوکن، بطور سیاق محفوظ
omniroute models list # ← ریموٹ سرور کے خلاف چلتا ہے
omniroute configure codex # ← ریموٹ ماڈل منتخب کرتا ہے، مقامی Codex پروفائل لکھتا ہے
omniroute tokens create --name ci --scope read # دیگر مشینوں کے لیے مزید محدود ٹوکن بنائیں
omniroute contexts use default # ← واپس مقامی سرور پر جائیں
```
ٹوکنز کے دائرۂ کار `read` / `write` / `admin` ہیں؛ پراسیس شروع کرنے والے روٹس صرف لوپ بیک تک محدود رہتے ہیں۔
📖 [ریموٹ موڈ](docs/guides/REMOTE-MODE.md)
### 🤝 ایک ایجنٹ منسلک کریں — اور وہ خود OmniRoute کو کنٹرول کرے گا
OmniRoute کو **MCP**، **A2A**، ایک **REST API**، **webhooks** یا ایک **remote CLI** کے ذریعے دستیاب کریں — کوئی بھی اہل ایجنٹ (یا آپ کا اپنا کوڈ) پورے گیٹ وے کی کنجیاں حاصل کر لیتا ہے: روٹنگ، فراہم کنندگان، کمبوز، کیش، کمپریشن، میموری — خودکار طور پر۔ ذیل کے HTTP اینڈ پوائنٹس `http://localhost:20128` کے تحت فراہم کیے جاتے ہیں۔
انٹرفیس
اینڈ پوائنٹ / کمانڈ
اس کا استعمال
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop، Cursor یا کسی بھی MCP کلائنٹ سے منسلک کریں
OpenAI سے ہم آہنگ — چیٹ، ایمبیڈنگز، تصاویر، آڈیو، OCR
🔔 Webhooks
/api/webhooks
درخواست / کوٹہ ایونٹس کو Slack، Discord، Telegram یا کسی بھی URL پر بھیجیں
🛰️ Remote CLI
omniroute connect
محدود دائرۂ کار والے رسائی ٹوکنز کے ساتھ ریموٹ انسٹینس چلائیں
```bash
# Claude Code کو MCP کے ذریعے OmniRoute کے تمام ٹولز فراہم کریں:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP سرور](docs/frameworks/MCP-SERVER.md) · [A2A سرور](docs/frameworks/A2A-SERVER.md) · [ایجنٹ پروٹوکولز](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ 15–95% ٹوکنز بچائیں — خودکار طور پر
### 📖 یہ کیسے کام کرتا ہے — پائپ لائن، آرکیٹیکچر اور بچت کا حساب
پہلے سے طے شدہ اسٹیک شدہ امتزاج `RTK → Caveman` چلاتا ہے۔ جب دونوں ایک ہی ٹول/کانٹیکسٹ پے لوڈ پر عمل کرتے ہیں تو بچت مرکب ہو جاتی ہے:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
کوڈ بلاکس، URLs، JSON اور ساختی ڈیٹا کو تحفظاتی انجن کے ذریعے **ہمیشہ محفوظ رکھا جاتا ہے**۔
> **جب چند ٹوکنز سے کام ہو سکتا ہے تو زیادہ ٹوکنز کیوں استعمال کریں؟** ہر درخواست OmniRoute کی کمپریشن پائپ لائن سے **شفاف طور پر** گزرتی ہے — کلائنٹ میں کسی تبدیلی کی ضرورت نہیں۔ اب یہ **12 قابلِ امتزاج انجنز کا ایک اسٹیک** ہے، جو ترتیب سے چلتے ہیں اور ہر روٹنگ امتزاج کے مطابق باہم ملائے جا سکتے ہیں — یہ [RTK](https://github.com/rtk-ai/rtk)، [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+)، [LLMLingua-2](https://github.com/microsoft/LLMLingua)، اور [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) کے تصورات پر مبنی ہے۔
### 🧱 12 انجنز کا اسٹیک
انجنز پائپ لائن کی ترتیب میں چلتے ہیں؛ ہر انجن کو ہر امتزاج کے لیے آزادانہ طور پر فعال یا غیر فعال اور ترتیب دیا جا سکتا ہے:
#
انجن
یہ کیا کرتا ہے
1
Session-Dedup
مختلف باریوں میں دہرایا گیا مواد حذف کرتا ہے (مواد کے پتے پر مبنی، مختلف باریوں کے درمیان)
2
CCR
بڑے بلاکس کو بازیافتی نشانات کے پیچھے محفوظ کرتا ہے، جنہیں ضرورت کے وقت حاصل کیا جاتا ہے
3
Lite
خالی جگہوں + تصویری URLs کی تراش خراش (کم تاخیر والی بنیادی سطح)
4
RTK
ٹول کے نتائج کی ذہین فلٹرنگ، نقل کا خاتمہ اور اختصار (کمانڈ سے آگاہ)
5
Responses Tool Output
shell/patch/search/build آؤٹ پٹس کے لیے پہلے بے نقصان JSON + محدود تشخیصی کمپریشن (Responses API)
6
Headroom
شامل کردہ GCF codec کے ذریعے JSON arrays کی بے نقصان جدولی اختصار کاری (~30%)
7
Relevance
صارف کے آخری استفسار کے مقابل اقتباسی جملوں کی درجہ بندی
8
Caveman
قواعد پر مبنی نثری کمپریشن (آؤٹ پٹ میں ~65–75%)
9
Aggressive
خلاصہ سازی + پرانی باریوں کی بتدریج فرسودگی
10
LLMLingua-2
MobileBERT ONNX کے ذریعے ML معنوی چھٹائی — کوڈ کے لیے محفوظ، غیر ہم وقت
11
Ultra
اختیاری چھوٹے ماڈل (SLM) کی سطح کے ساتھ تخمینی ٹوکن چھٹائی
12
OmniGlyph
براہِ راست Anthropic wire پر پیمائش شدہ Claude Fable 5 کے لیے تجرباتی context-as-image encoding؛ فراہم کنندہ کی رسیدیں ملنے تک GPT 5.6 transformers بدستور fail-closed رہتے ہیں۔ کمپریشن کے چار پروفائلز (پہلے سے طے شدہ aggressive، balanced، coding-safe، passthrough) (سب سے زیادہ aggressive؛ اختیاری)
کوڈ بلاکس، URLs اور ساختی ڈیٹا **ہمیشہ بعینہٖ ہر بائٹ سمیت محفوظ رکھے جاتے ہیں**۔ **ایک کلک کے presets** انجنز کو یکجا کرتے ہیں:
موڈ
بچت
کس کے لیے بہترین
🪶 Lite
~15%
ہمیشہ فعال محفوظ ڈیفالٹ
🪨 Standard (Caveman)
~30%
روزمرہ کوڈنگ
⚡ Aggressive
~50%
طویل، ٹولز سے بھرپور سیشنز
🔥 Ultra
~75%
زیادہ سے زیادہ بچت
🧰 RTK
60–90%
shell/test/build/git آؤٹ پٹ
🔗 Stacked (RTK → Caveman)
78–95%
مخلوط پرامپٹس + ٹول لاگز
**حقیقی مثال — Standard موڈ:**
> **پہلے (69 ٹوکنز):** _"آپ کا React component غالباً اس لیے دوبارہ render ہو رہا ہے کیونکہ آپ ہر render cycle میں ایک نیا object reference بنا رہے ہیں۔ جب آپ ایک inline object کو prop کے طور پر دیتے ہیں، تو React کا shallow comparison اسے ہر بار ایک مختلف object سمجھتا ہے، جس سے دوبارہ render شروع ہو جاتا ہے۔ میری تجویز ہے کہ object کو memoize کرنے کے لیے useMemo استعمال کریں۔"_
>
> **بعد میں (19 ٹوکنز):** _"ہر render میں نیا object ref۔ Inline object prop = نیا ref = دوبارہ render۔ useMemo میں لپیٹیں۔"_
>
> **وہی جواب۔ 72% کم ٹوکنز۔ درستگی میں کوئی کمی نہیں۔** ✅
**PT-BR مثال — [Troglodita](https://github.com/leninejunior/troglodita) موڈ:**
> **پہلے (42 ٹوکنز):** _"مسئلہ یہ ہے کہ کمپوننٹ دوبارہ رینڈر ہو رہا ہے کیونکہ ہر رینڈرنگ سائیکل میں آبجیکٹ کا ایک نیا ریفرنس بنایا جا رہا ہے۔ میں `useMemo` استعمال کرنے کی تجویز دوں گا۔"_
>
> **بعد میں (12 ٹوکنز):** _"دوبارہ رینڈر: ہر سائیکل میں نیا ریفرنس (اِن لائن آبجیکٹ دوبارہ تخلیق ہوتا ہے)۔ `useMemo` استعمال کریں۔"_
>
> **وہی جواب۔ تقریباً 70% کم ٹوکنز۔ تکنیکی درستگی برقرار۔** ✅
### 🎚️ انجنز سے آگے — آؤٹ پٹ اسٹائلز، اڈاپٹیو ڈائل اور فی درخواست کنٹرول
اوپر موجود 12 انجنز اِن پٹ کو مختصر کرتے ہیں۔ مزید تین پرتیں یہ طے کرتی ہیں کہ آؤٹ پٹ **کیسے**، **کب** اور **کیا** نکلے گا:
- **🪄 آؤٹ پٹ اسٹائلز** _(آؤٹ پٹ محور کی رہنمائی)_ — جواب کی ساخت متعین کرنے والی قطعی اور کیش-محفوظ ہدایات شامل کریں؛ انہیں یکجا کیا جا سکتا ہے اور ہر ایک کی شدت `lite` / `full` / `ultra` ہو سکتی ہے۔ کوئی اسٹائل شامل کرنے کے لیے رجسٹری میں صرف ایک سطر درکار ہے:
- **مختصر نثر** — غیر ضروری عبارت / آرٹیکلز / تذبذب نکال دیں؛ تکنیکی مواد بالکل درست رکھیں۔
- **کم کوڈ** — "سست سینئر ڈویلپر" والا YAGNI: کم سے کم قابلِ عمل تبدیلی، بغیر مانگے کوئی اضافی ڈھانچہ نہیں۔
- **پونی ٹیل (سست سینئر ڈویلپر)** — YAGNI کی سیڑھی چڑھیں، بنیادی وجہ درست کریں، کم سے کم قابلِ عمل diff۔
- **مجھے ADHD ہے (عمل پہلے)** — اگلا عمل پہلے، مراحل نمبر وار، ایک واضح اگلا قدم، کوئی تمہید نہیں۔
- **مختصر CJK (文言)** — کلاسیکی چینی کا انتہائی مختصر انداز (صرف `zh` لوکیل کے لیے)۔
- **🎯 اڈاپٹیو سیاقی بجٹ** _(ڈائل)_ — ٹوکنز کی صرف ایک آن/آف حد کے بجائے، کم ترین لاگت اور کم ترین معلوماتی نقصان والے انجنز کو صرف اتنا بڑھائیں جتنا **ماڈل کی کانٹیکسٹ ونڈو میں فٹ ہونے** کے لیے ضروری ہو۔ پالیسی: `reserve-output` (ڈیفالٹ، ماڈل سے آگاہ) · `percentage` · `absolute`۔ موڈ: `floor` (فٹ ہونے کی ضمانت) · `replace-autotrigger` (آپ کا واضح انتخاب مقدم) · `off` (روایتی حد)۔
- **🎛️ کمپریشن کا فیصلہ کہاں ہوتا ہے** _(ترجیح، زیادہ → کم)_ — فی درخواست `x-omniroute-compression` ہیڈر › راؤٹنگ-کومبو اووررائیڈ › فعال نام زد پروفائل › اڈاپٹیو / آٹو ٹریگر › پینل ڈیفالٹ › آف۔ لاگو شدہ منصوبہ `X-OmniRoute-Compression: ; source=` رسپانس ہیڈر میں واپس دکھائی دیتا ہے۔
ٹوکن حد کے ذریعے آٹو ٹریگر کریں، اڈاپٹیو ڈائل آن کریں، کوئی نام زد پروفائل مقرر کریں، فی درخواست ایک وقتی ترتیب لگائیں، یا ہر راؤٹنگ کومبو کے لیے پائپ لائن مختص کریں — جو بھی کام کے بوجھ کے مطابق ہو۔ اختیاری آف لائن **جائزہ فریم ورک** (`npm run eval:compression`) کسی تبدیلی کو نافذ کرنے سے پہلے ایک مقررہ کارپس پر معلوماتی وفاداری بمقابلہ بچت کی درجہ بندی کرتا ہے۔
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ فوری آغاز
**1) انسٹال کریں اور چلائیں**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` یا peer-dep انتباہات نظر آ رہے ہیں؟ [یہ بے ضرر ہیں](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)۔
ڈیش بورڈ `http://localhost:20128` پر · API `http://localhost:20128/v1` پر۔
**2) ایک مفت فراہم کنندہ منسلک کریں (سائن اپ کے بغیر)**
ڈیش بورڈ → **فراہم کنندگان** → **Kiro AI** (مفت Claude، فی اکاؤنٹ تقریباً 50 کریڈٹس/ماہ) یا **OpenCode Free** (بغیر تصدیق) منسلک کریں → مکمل۔
**3) اپنے کوڈنگ ٹول کو متعین کریں**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (zero-config smart routing — or any provider/model)
```
**4) تصدیق کریں کہ یہ کام کر رہا ہے**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
آپ کو اپنے منسلک ماڈلز کی فہرست نظر آنی چاہیے۔ 🎉 بس اتنا ہی — کوڈنگ شروع کریں، اور OmniRoute خودکار طور پر آپ کے لیے روٹنگ اور فال بیک سنبھالے گا۔
اگر آپ کا کلائنٹ حسبِ ضرورت ہیڈرز نہیں بھیج سکتا تو OmniRoute ٹوکن پر مبنی مطابقتی عرف بھی فراہم کرتا ہے:
```txt
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 ...` منسلک نہیں کر سکتے۔ ہیڈر کے ذریعے تصدیق بدستور ترجیحی طریقہ ہے۔
## 📦 تنصیب کے مزید طریقے — Docker، سورس، pnpm، Arch
**🐳 Docker**
```bash
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 ریلیز چینلز](docs/guides/DOCKER_GUIDE.md#release-channels) دیکھیں۔ امیج میں **`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 |
```bash
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](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents)۔
> **قبل از ریلیز Docker چینل:** `diegosouzapw/omniroute:next` اور
> `diegosouzapw/omniroute:next-web` موجودہ ڈیفالٹ `release/v*`
> برانچ کی پیروی کرتے ہیں۔ یہ قابلِ تغیر tags صرف غیر جاری شدہ اصلاحات کی جانچ کے لیے ہیں اور
> **پروڈکشن کے لیے معاونت یافتہ نہیں ہیں**۔ دیکھیں
> [Docker ریلیز چینلز](docs/guides/DOCKER_GUIDE.md#release-channels)۔
**🥟 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 .`)۔
```bash
# Bun کے ساتھ تنصیب کریں اور چلائیں
bun install
bun run dev
```
**🛠️ سورس سے**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Nix flakes استعمال کرتے ہوئے
nix develop
npm run dev
# یا devbox استعمال کرتے ہوئے
devbox run npm run dev
```
📖 [Docker گائیڈ](docs/guides/DOCKER_GUIDE.md) — Compose profiles، Caddy HTTPS، Cloudflare tunnels۔
**🦭 Podman**
```bash
# 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 کے لحاظ سے مخصوص ڈیٹا ڈائریکٹری کی رہنمائی](contrib/podman/README.md#data-directory-permissions-by-topology) پر عمل کریں۔
📖 [Podman گائیڈ](contrib/podman/README.md) — 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، یا سست مشینیں):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 بھی اسے چھوڑ دیتا ہے
```
تیز ترین تنصیبات کے لیے **pnpm** کو ترجیح دیں (content-addressed store + hard links — اوپر دیکھیں)۔
ڈیش بورڈ کے بغیر headless رن ٹائم کے لیے Docker کا `base` profile (اوپر) یا
[Termux گائیڈ](docs/guides/TERMUX_GUIDE.md) استعمال کریں۔ CLI اور ویب ڈیش بورڈ ایک ہی پراسیس کے ذریعے ایک
پورٹ پر پیش کیے جاتے ہیں، اس لیے فی الحال کوئی الگ صرف-CLI package موجود نہیں ہے۔
5,100+ ٹریک شدہ ٹیسٹ فائلوں میں 39,000+ جامد ٹیسٹ اعلانات کے لیے ٹیسٹ کوریج کی حکمت عملی
# ⭐ نمایاں شراکت کار
> OmniRoute ایک پُرجوش اوپن سورس کمیونٹی کی بدولت تشکیل پاتا ہے۔ ان افراد نے غیر معمولی شراکتیں کی ہیں جو براہِ راست پروجیکٹ کے معیار، استحکام اور رسائی پر اثر انداز ہوتی ہیں۔ **آپ کا شکریہ۔**
### ضم شدہ پل ریکوئسٹس کے لحاظ سے بیرونی شراکت کار
2026-08-24 05:26:03 UTC تک کے مرجز کے ساتھ، لائیو release/v3.8.50 ٹِپ dafb4ae808 پر منجمد۔ صفحات میں تقسیم شدہ GitHub GraphQL مردم شماری میں 5,911 ضم شدہ PRs شامل ہیں: 2,707 ریپوزٹری کے مالک کی جانب سے، 179 Dependabot کی جانب سے، اور 535 منفرد شراکت کاروں کی جانب سے 3,025 بیرونی PRs۔ “تبدیل شدہ سطریں” سے مراد GitHub کے اضافوں اور حذف شدگیوں کا مجموعہ ہے اور اس میں تیار کردہ فائلیں، لاک فائلیں، کیٹلاگز، تراجم اور دستاویزات شامل ہیں؛ یہ تبدیلیوں کا حجم ہے، تحریر کردہ LOC نہیں۔ حدِ انتخاب پر برابر درجہ رکھنے والوں کو برقرار رکھا گیا ہے۔
### GitHub سے منسوب کمیٹس
Bob.Hou 🏅 GitHub سے منسوب 51 commits · #10 پر برابر
Xiangzhe 🏅 GitHub سے منسوب 51 commits · #10 پر برابر
2026-08-24 06:14:31 UTC پر دوبارہ جانچ کی گئی: release/v3.8.50 ڈیفالٹ برانچ کے لیے ریپوزٹری Contributors API کی رپورٹ کردہ GitHub سے منسوب commits۔ API نے 525 شناختیں واپس کیں (415 صارفین، 2 bots، 108 گمنام)؛ یہ جدول مینٹینر، bots اور گمنام شناختوں کو خارج کرتا ہے اور مقابلے میں برابر پوزیشنوں کو برقرار رکھتا ہے۔ یہ اوپر دی گئی ضم شدہ PR درجہ بندی اور نیچے دی گئی 639 افراد پر مشتمل Git-metadata مردم شماری، دونوں سے الگ ہے۔
> 🙏 ان معاونین کی خصوصیات، بگ فکسز، اور انفراسٹرکچر میں بہتریاں اس چیز کا **بنیادی حصہ** ہیں جو OmniRoute کو قابلِ اعتماد اور خصوصیات سے بھرپور بناتی ہے۔ ہر pull request، ہر test case، اور ہر i18n ترجمہ فائل اہم ہے۔ اوپن سورس ان ہی جیسے لوگوں کی بدولت وجود میں آتا ہے۔
---
## 💖 اسپانسرز
ان لوگوں کا تہِ دل سے شکریہ جو اپنی جیب سے OmniRoute کی مالی معاونت کرتے ہیں — ہر تعاون اس پروجیکٹ کو مفت، خودمختار اور رواں دواں رکھتا ہے۔
… اور وہ دیگر افراد جو اپنی شناخت نجی رکھنا پسند کرتے ہیں 💛عوامی GitHub اسپانسرز کی 2026-08-24 کو دوبارہ توثیق کی گئی۔ GitHub کی activeOnly حیثیت اوپر موجود فعال لیبلز کا تعین کرتی ہے؛ پہلے ظاہر کیے گئے عوامی یک وقتی معاونین کا شکریہ برقرار ہے، جبکہ نجی اسپانسرز گمنام رہتے ہیں۔💖 اسپانسر بنیں → — ہر ڈالر OmniRoute کو مفت اور خودمختار رکھنے میں مدد دیتا ہے۔
## 👥 600+ معاونین
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-08-24 کو منجمد بنیاد ac02c5b42f پر آڈٹ کیا گیا اور لائیو release/v3.8.50 کے آخری سرے dafb4ae808 پر دوبارہ جانچ کی گئی: 639 معمول پر لائی گئی انسانی Git شناختیں — 407 کمٹ مصنفین کے طور پر ظاہر ہوتے ہیں (بشمول مینٹینر) اور 232 صرف واضح Co-authored-by ٹریلرز میں موجود ہیں۔ یہ مردم شماری GitHub کے noreply ہینڈلز کو معمول پر لاتی ہے، 26 bot/agent/service/placeholder شناختوں کو خارج کرتی ہے، اور محض یکساں نمائشی نام ہونے کی وجہ سے عام ای میل پتوں کو ضم نہیں کرتی۔
### تعاون کیسے کریں
1. ریپوزٹری کو فورک کریں
2. **فعال** `release/vX.Y.Z` کے آخری سرے سے برانچ بنائیں (`main` سے نہیں) — [برانچنگ اور ریلیز ماڈل](docs/ops/BRANCHING_MODEL.md) دیکھیں
3. اپنی فیچر برانچ بنائیں (`git checkout -b feat/amazing-feature`)
4. اپنی تبدیلیاں کمٹ کریں (`git commit -m 'feat: add amazing feature'`)
5. برانچ پر پش کریں (`git push origin feat/amazing-feature`)
6. **base = وہی `release/vX.Y.Z` برانچ** رکھتے ہوئے ایک پل ریکویسٹ کھولیں
تفصیلی رہنما اصولوں کے لیے [CONTRIBUTING.md](CONTRIBUTING.md) دیکھیں۔
### نیا ورژن جاری کرنا
```bash
# ایک ریلیز بنائیں — npm publish خودکار طور پر انجام پاتا ہے
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 ستارے
## 🌍 StarMapper
## 🙏 اعتراف و تشکر
OmniRoute عظیم منصوبوں کی بنیاد پر قائم ہے۔ اس کا آغاز **[9router](https://github.com/decolua/9router)** کے ایک فورک اور Go پروجیکٹ **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** کی TypeScript پورٹ کے طور پر ہوا — اور اس کے بعد ذیل میں موجود ہر ذیلی نظام ایک ایسے اوپن سورس پروجیکٹ سے متاثر ہوا جو یہ کام پہلے کر چکا تھا۔ ان میں سے ہر ایک نے OmniRoute کے ایک ٹھوس حصے کو تشکیل دیا۔ یہ ان سب کے لیے ہمارا اظہارِ تشکر ہے۔ 🙏
> ⭐ ستاروں کی تعداد کی 24 اگست 2026 کو GitHub کی REST API سے تصدیق کی گئی — جا کر ان پروجیکٹس کو ایک ستارہ دیں۔ یہ تعداد ایک مخصوص تاریخ کی عین تصویر ہے اور فطری طور پر تبدیل ہوتی رہے گی۔
### 🧬 نسب اور گیٹ وے
وہ AI گیٹ وے جس کا عوامی قیمتوں کا ڈیٹا سیٹ ہماری لاگت کی ٹریکنگ کی ہم وقت سازی کو ڈیٹا فراہم کرتا ہے اور جس کے فراہم کنندہ کو معمول پر لانے کے ماڈل نے ہماری روٹنگ کی تشکیل میں رہنمائی کی۔
اس کے پیٹرنز کو اسٹریم بحالی، no-thinking aliases، متبادل ویب سرچ، سلائیڈنگ ونڈو حدود، لاگ کی خفیہ معلومات چھپانے اور زیادہ محفوظ لانچر فلوز میں پورٹ کیا گیا۔
اس کی Grok ماڈل میپنگز، جعلی TypeError پر مبنی Statsig generator، درخواست اور ڈیوائس ڈیفالٹس، اور NDJSON رسپانس پروسیسر کو نمایاں طور پر OmniRoute کے Grok Web executor میں ڈھالا گیا۔
ایک بالواسطہ ماخذ جسے grok2api-merged نے اپنی پراکسی پول تہہ کے لیے کریڈٹ دیا؛ OmniRoute اس سلسلۂ ماخذ کے نوٹس کو محفوظ رکھتا ہے، لیکن اپنے محدود Grok Web executor میں پراکسی پول پورٹ کا دعویٰ نہیں کرتا۔
اصل Grok Web نفاذ نے اس کے HTTP/براؤزر اپ اسٹریم ڈیزائن سے استفادہ کیا؛ اس کا براہِ راست HTTP راستہ GrokProxy سے اخذ شدہ ہے، اس لیے کسی آزاد کوڈ پورٹ کا دعویٰ نہیں کیا جاتا۔
وائرل "جب چند ٹوکن سے کام ہو جائے تو زیادہ ٹوکن کیوں استعمال کرنا" پروجیکٹ — اس کا غار کے انسان جیسی زبان کا فلسفہ ہمارے معیاری کمپریشن موڈ اور 30+ غیر ضروری الفاظ کے اخراج/اختصار کے قواعد کی بنیاد ہے۔
اعلیٰ کارکردگی والی کمانڈ آؤٹ پٹ کمپریشن — اس سے ہمارے RTK انجن، JSON فلٹر DSL، خام آؤٹ پٹ کی بازیابی اور تہہ دار RTK → Caveman پائپ لائن کو تحریک ملی۔
پرامپٹ کمپریشن کی تحقیق (LLMLingua / LLMLingua-2) — اس سے ہمارے غیر متزامن، کوڈ کے لیے محفوظ، ناکامی کی صورت میں اصل متن برقرار رکھنے والے llmlingua انجن کو تحریک ملی۔
وائرل "سست سینئر ڈویلپر" YAGNI-کوڈر مہارت — اس سے ہمارے کم کوڈ آؤٹ پٹ اسٹائل کو تحریک ملی: کم ترین قابلِ عمل تبدیلی کی سمت نمائی، جو _تیار کردہ_ کوڈ کم کرتی ہے (Caveman کی مختصر نثر کا آؤٹ پٹ محور پر ہم منصب)۔
مواد سے آگاہ، ہر فائل کی قسم کے مطابق آؤٹ پٹ کمپریشن، جس میں ناکامی کی صورت میں عمل ترک کرنے کی سہولت ہے — اس نے ہماری ہر قسم کے مطابق ترسیل اور کم از کم فائدہ نہ ہونے پر عمل چھوڑنے کی توثیق کی۔
Rust کالمی JSON + مواد کے پتے پر مبنی بازیابی + مختلف پیغامات میں نقل کا اخراج — اس نے ہمارے headroom/ccr/session-dedup انجن ڈیزائن اور کیش کے لیے مستحکم "کمپریس شدہ شکل مقام سے آزاد ہے" مستقل اصول کی توثیق کی۔
کوڈنگ اسسٹنٹ ↔ LLM ٹریفک کی MITM مداخلت/تجزیے نے Traffic Inspector کی ابتدائی ضروریات سے آگاہ کیا۔ پہلے اخذ کردہ چار ماڈیولز — SSE انضمام، گفتگو کو معیاری بنانا، رازوں کو چھپانا اور ہیڈر کی تطہیر — کو عوامی پروٹوکول معیارات پر مبنی آزاد کلین روم نفاذات سے تبدیل کر دیا گیا ہے۔ ہوسٹ پاس تھرو کی دو سطحیں (passthrough.ts اور _internal/bypass.cjs) اب بھی OmniRoute کے داخلی نفاذات ہیں جن کی آزادانہ درجہ بندی کی گئی ہے؛ اس تبدیلی کے حصے کے طور پر انہیں دوبارہ نہیں لکھا گیا۔
بطور ڈیفالٹ محفوظ لائبریریوں کی منتخب فہرست، جو ہمارے سیکیورٹی کے انتخاب کی رہنمائی کرتی ہے (Helmet.js، DOMPurify، ssrf-req-filter، safe-regex، Google Tink)۔
اس کے اکاؤنٹ سے آگاہ ماڈل ری میپنگ، قابل نفاذ فائل کے راستے کی توثیق اور پلان لیبل کے رویے نے OmniRoute کے Antigravity رن ٹائم کی تشکیل میں رہنمائی کی۔
اس نے Grok Build کوٹہ سطح کی نشان دہی کی؛ پھر OmniRoute نے آزادانہ طور پر لائیو وائر فارمیٹ کی تصدیق اور اصلاح کی۔
## 📄 لائسنس
MIT لائسنس — تفصیلات کے لیے [LICENSE](LICENSE) دیکھیں۔
---
**[⬆ اوپر واپس جائیں](#-omniroute)** · اوپن سورس AI کمیونٹی کے لیے ❤️ کے ساتھ تیار کیا گیا۔
OmniRoute v3.8.51 · Node ≥22.22.2 · MIT لائسنس · omniroute.online
> براہِ راست `/dashboard/free-tiers` صفحے کا متحرک خلاصہ۔ مکمل طریقۂ کار (پول کی نقل کا خاتمہ، کریڈٹ درجے، فراہم کنندہ کی شرائط): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**۔
>
> ان اعداد و شمار کا براہِ راست کیٹلاگ کے مقابل ہر دو ہفتے بعد دوبارہ آڈٹ کیا جاتا ہے اور یہ **دونوں سمتوں میں تبدیل ہوتے ہیں** — کوئی فراہم کنندہ مفت درجہ ختم کرے تو تعداد کم ہو جاتی ہے؛ نیا شامل ہو تو بڑھ جاتی ہے۔ ہم وہی شائع کرتے ہیں جس کا کیٹلاگ حقیقتاً حساب لگاتا ہے، کبھی بھی اوپر کی طرف گول کیا ہوا بہترین ممکنہ منظرنامہ نہیں۔
```bash
# تازہ انسٹال، زیرو کریڈینشلز — `auto` پہلے ہی کام کرتا ہے:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
ایک مخصوص مفت بیک اینڈ کو ترجیح دیتے ہیں؟ براہ راست `oc/…` (OpenCode Free) کو کال کریں۔ پھر `auto` پر گریجویٹ کریں اور OmniRoute کو منتخب کرنے دیں۔
📦 **Python, Node.js, PHP, اور cURL** کے لیے کاپی پیسٹ کوئیک اسٹارٹ اسکرپٹس → [`examples/quickstart/`](examples/quickstart/)
> **کامبو** ماڈلز کی ایک زنجیر ہے جن کے درمیان OmniRoute **خودکار طور پر** روٹنگ کرتا ہے۔ اگر کوٹا ختم ہو جائے، کوئی فراہم کنندہ ناکام ہو جائے، یا اخراجات اچانک بڑھ جائیں، تو کامبو اگلے اہل اور فعال ماڈل پر منتقل ہو سکتا ہے۔ 🛡️
### ⚡ صفر کنفیگریشن — بس `auto` استعمال کریں
کوئی کامبو بنانے کی ضرورت نہیں۔ اپنے ماڈل کو `auto` (یا اس کی کسی قسم) پر سیٹ کریں اور OmniRoute آپ کے منسلک فراہم کنندگان سے ایک ورچوئل کامبو بناتا ہے، جس کی براہِ راست اسکورنگ کی جاتی ہے:
📖 [آٹو کومبو انجن](docs/routing/AUTO-COMBO.md) · [لچک کی رہنما کتاب](docs/architecture/RESILIENCE_GUIDE.md)
📊 مکمل طریقہ کار اور فی خصوصیت تفصیل بمقابلہ 9router، OpenRouter، CLIProxyAPI اور LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
کلید (بے ترتیب): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix کاپی اور پیسٹ:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [اجازت دہی](docs/architecture/AUTHZ_GUIDE.md) · [حفاظتی حدود](docs/security/GUARDRAILS.md) · [تعمیل](docs/security/COMPLIANCE.md)
پہلے سے طے شدہ اسٹیک شدہ امتزاج `RTK → Caveman` چلاتا ہے۔ جب دونوں ایک ہی ٹول/کانٹیکسٹ پے لوڈ پر عمل کرتے ہیں تو بچت مرکب ہو جاتی ہے:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
کوڈ بلاکس، URLs، JSON اور ساختی ڈیٹا کو تحفظاتی انجن کے ذریعے **ہمیشہ محفوظ رکھا جاتا ہے**۔
> **جب چند ٹوکنز سے کام ہو سکتا ہے تو زیادہ ٹوکنز کیوں استعمال کریں؟** ہر درخواست OmniRoute کی کمپریشن پائپ لائن سے **شفاف طور پر** گزرتی ہے — کلائنٹ میں کسی تبدیلی کی ضرورت نہیں۔ اب یہ **12 قابلِ امتزاج انجنز کا ایک اسٹیک** ہے، جو ترتیب سے چلتے ہیں اور ہر روٹنگ امتزاج کے مطابق باہم ملائے جا سکتے ہیں — یہ [RTK](https://github.com/rtk-ai/rtk)، [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+)، [LLMLingua-2](https://github.com/microsoft/LLMLingua)، اور [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) کے تصورات پر مبنی ہے۔
### 🧱 12 انجنز کا اسٹیک
انجنز پائپ لائن کی ترتیب میں چلتے ہیں؛ ہر انجن کو ہر امتزاج کے لیے آزادانہ طور پر فعال یا غیر فعال اور ترتیب دیا جا سکتا ہے:
