## 💰 فریقِ ثالث کے مفت درجات میں ~1.62B ٹوکنز / ماہ
> **اپنے فراہم کنندہ اکاؤنٹس استعمال کریں۔** یہ علیحدہ طور پر اہل فریقِ ثالث کے مفت درجات کا تخمینی مجموعہ ہے، OmniRoute کی جانب سے ٹوکن گرانٹ نہیں۔ سائن اپ کریں، جہاں ضروری ہو اسناد حاصل کریں، اور ان فراہم کنندگان کو منسلک کریں جنہیں آپ استعمال کر سکتے ہیں؛ ہر فراہم کنندہ اپنی حدود، دستیابی اور شرائط کو خود کنٹرول کرتا ہے۔
>
> مفت درجات کو دستی طور پر یکجا کرنا مشکل ہے — درجنوں 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
# فراہم کنندہ کو منسلک کرنے کے بعد، Dashboard → Endpoints سے اپنی OmniRoute کلید کاپی کریں:
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` کے لیے ایک اہل روٹ درکار ہوتا ہے۔ نئی تنصیب میں ممکن ہے کوئی اہل، بغیر کلید والا ہدف موجود نہ ہو، اور بغیر کلید والا فراہم کنندہ فریقِ ثالث کے کلائنٹس کو مسترد کر سکتا ہے۔ `tos: avoid` سے نشان زد فراہم کنندگان، بشمول OpenCode Free اور Kiro، بطورِ ڈیفالٹ خودکار روٹنگ سے خارج ہوتے ہیں؛ کسی اکاؤنٹ کو منسلک کرنا اس ترتیب کو تبدیل نہیں کرتا۔ فراہم کنندہ منتخب کرنے سے پہلے [مفت درجات کی رہنمائی](docs/getting-started/FREE-TIERS-GUIDE.md) دیکھیں۔📦 **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
🧪 ماڈلز کے ایک پینل تک متوازی پھیلاؤ (ہر فراہم کنندہ سے ایک، ڈیفالٹ طور پر 5)، ایک جواب واپس کرتا ہے؛ ہر پینل ماڈل کے لیے ایک اپ اسٹریم کال، فالٹ انجیکشن نہیں
##
### 🔀 یا اپنا بنائیں — روٹنگ کی 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** — آپ کے ایجنٹ فلیٹ کو آنے والی A2A تفویض، Agent Card پر Conductor کی مہارتیں، اور Faro پُش-ٹو-ٹاک صوتی چیٹ والا ڈیش بورڈ پینل۔ → [A2A سرور](docs/frameworks/A2A-SERVER.md)
- **🛂 موافق داخلہ اور اوورلوڈ تحفظ** — بھاری چیٹ درخواستیں 503 دینے کے بجائے قطار میں لگتی ہیں، اور ہر کنکشن کے لیے ایٹمی RPM رولنگ لیزز فراہم کی جاتی ہیں۔ → [لچک پذیری کی رہنما](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ معیاری `/v1/models` ترتیب** — ہر فراہم کنندہ کے لیے ایک مسلسل، فراہم کنندہ کے لحاظ سے گروپ شدہ بلاک (combos پہلے پِن کیے گئے)، جو ہر کیٹلاگ ماخذ میں مستحکم رہتا ہے۔ → [API حوالہ](docs/reference/API_REFERENCE.md)
- **🗜️ کمپریشن کی مضبوطی** — بطورِ ڈیفالٹ فعال inflation guard، DE / FR / JA + چینی (wényán) کے لیے Caveman پیکس، اور Gradle و .NET کے لیے RTK فلٹرز۔ → [کمپریشن](docs/compression/COMPRESSION_ENGINES.md)
- **💸 شفاف فلیٹ ریٹ لاگت** — سبسکرپشن / کوڈنگ پلان فراہم کنندگان لاگت کے تجزیات میں **$0** دکھاتے ہیں؛ بجٹ، کوٹا اور روٹنگ تخمینہ لگاتے رہتے ہیں۔ → [API حوالہ](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share روٹنگ** — مشترکہ اکاؤنٹ کا کوٹا pooled keys میں منصفانہ طور پر تقسیم کریں، اور کام کو جاری رکھتے ہوئے غیر استعمال شدہ حصے عارضی طور پر دوسروں کو دے دیں۔ → [لچک پذیری کی رہنما](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 ایک کمانڈ میں CLI/ایجنٹ سیٹ اپ** — 13 رجسٹرڈ `setup-*` کمانڈز؛ `omniroute run` سات CLIs (Claude Code، Codex، Aider، Goose، OpenCode، Qwen Code، Gemini CLI) چلاتا ہے؛ `omniroute configure` انٹرایکٹو فراہم کنندہ+ماڈل منتخب کنندہ اور ہر سیاق کے پسندیدہ اختیارات کے ساتھ 10 اہداف کی معاونت کرتا ہے۔ → [CLI انٹیگریشنز](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ ریموٹ موڈ** — محدود دائرۂ کار والے ٹوکنز (`connect` / `contexts` / `tokens`) اور VPS تنصیبات کے لیے ایک `antigravity` OAuth معاون کے ذریعے ریموٹ OmniRoute چلائیں۔ → [ریموٹ موڈ](docs/guides/REMOTE-MODE.md)
- **🧭 زیادہ ذہین خودکار روٹنگ** — `auto/:` combos، **Fusion** (ماڈل پینل + جج)، کام سے آگاہ روٹنگ، اور ہر درخواست کے لیے ماڈل / موڈ / USD بجٹ کی اووررائیڈز۔ → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ قابلِ توسیع کمپریشن** — 12 باہم قابلِ ترکیب انجنز + Compression Studios: LLMLingua-2، دو سطحی Ultra، omniglyph، ہر مرحلے کا fidelity gate، GCF v3.2، اور drag-reorder ایڈیٹر۔ → [کمپریشن](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ شفاف MITM ڈکرپشن (TPROXY)** — ان CLIs کو کیپچر کریں جو proxy env vars کو نظر انداز کرتے ہیں، ہر SNI کے لیے الگ CA اور trust-store انسٹالر کے ساتھ۔ → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 ہر جگہ لاگت کی ٹیلی میٹری** — ہر endpoint پر `X-OmniRoute-*` لاگت/استعمال کے headers، cache-HIT بچت کا header، اور ہر key کے لیے USD خرچ کے کوٹے۔ → [API حوالہ](docs/reference/API_REFERENCE.md)
- **🧠 آپ کے اختیار میں میموری** — بطورِ ڈیفالٹ بند، اختیاری int8 vector quantization + typed decay، اور ہر درخواست کے لیے `x-omniroute-no-memory`۔ → [میموری](docs/frameworks/MEMORY.md)
- **🛡️ سیکیورٹی** — ہر LLM روٹ پر prompt-injection guard (red-team suite)، اختیاری credential-masking guardrail (دونوں سمتوں میں افشا شدہ API keys/secrets کو مخفی کرتا ہے)، آخری چارے کے طور پر مفت DuckDuckGo ویب تلاش، اور ڈیش بورڈ کے لیے اختیاری OIDC لاگ اِن گیٹ (پاس ورڈ لاگ اِن ہمیشہ دستیاب رہتا ہے)۔ → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ نئے endpoints** — `/v1/ocr` (Mistral OCR) اور `/v1/audio/translations` (Whisper طرز) میڈیا کی سہولیات کو مکمل کرتے ہیں۔ → [API حوالہ](docs/reference/API_REFERENCE.md)
- **🎨 تصویر / ویڈیو / آڈیو جنریشن** — میڈیا کے لیے ایک API: xAI Grok Imagine اور Novita AI ویڈیو، ComfyUI، Magnific، Adobe Firefly، Segmind، اور ElevenLabs جیسے صوتی فراہم کنندگان۔ → [API حوالہ](docs/reference/API_REFERENCE.md)
- **🌍 ڈیپلائمنٹ اور آپریشنز** — reverse-proxy `basePath`، براؤزر کی زبان کی خودکار شناخت، ہر key کے لیے ڈیوائس ٹریکنگ، root-less MITM trust، اور zh-TW لوکلائزیشن۔ → [ماحول](docs/reference/ENVIRONMENT.md)
- **🤝 مزید فراہم کنندگان اور ایجنٹس** — کلاؤڈ ایجنٹس (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… اور تازہ کردہ **352 فراہم کنندگان کا کیٹلاگ**۔ → [فراہم کنندگان](docs/reference/PROVIDER_REFERENCE.md)
- **📡 روٹنگ کی شفافیت** — ہر جواب میں ایک `X-OmniRoute-Decision` header شامل ہوتا ہے جو اسے فراہم کرنے والی حکمتِ عملی/فراہم کنندہ/تاخیر بتاتا ہے، ایک نئی `cache-optimized` combo حکمتِ عملی + Auto-Combo کا `cacheAffinity` عامل دہرائی گئی درخواستوں کو cached prefix رکھنے والے کنکشن کی طرف واپس بھیجتا ہے، اور صرف پڑھنے کے لیے `/v1/auto-combo/{channel}/candidates` endpoint کسی `auto/*` چینل کا رواں candidate pool ظاہر کرتا ہے۔ → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ مقامی کارکردگی اور انفراسٹرکچر** — ایک کلک میں مقامی Redis، Cloudflare Workers / Deno Deploy relay deployers، اور زیرِ نگرانی embedded services کے طور پر Bifrost و Mux۔ → [Embedded Services](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 پیکیج میں مزید بھی** — plugin framework + marketplace، Omni/Agent/GitHub skills frameworks، Obsidian vault انٹیگریشن (22 MCP tools)، OpenAI سے ہم آہنگ Batch اور Files APIs، semantic response cache، leaderboards کے ساتھ gamification، ACP agent discovery (15 بلٹ اِن ایجنٹس)، BigQuery میں طے شدہ log export، `auto/chaos` متوازی multi-model fan-out، Telegram bot bridge، درونِ ایپ version manager، اور LMArena-ELO مفت فراہم کنندگان کی درجہ بندیاں۔ → [دستاویزات](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)
## 🌐 372 AI فراہم کنندگان — 154 کیٹلاگ میں مفت کے طور پر نشان زد
> **372 رجسٹرڈ فراہم کنندگان** جو مستند چیٹ، میڈیا، تلاش، مقامی، کلاؤڈ ایجنٹ اور سسٹم مجموعوں پر محیط ہیں، جن میں **154 کے ساتھ `hasFree: true` دریافت میٹا ڈیٹا موجود ہے**۔ چیٹ ماڈل رجسٹری میں **237 فراہم کنندگان / 3,009 منفرد فراہم کنندہ-ماڈل جوڑے / 1,443 خام ماڈل 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 ایک بار کا $5 کریڈٹ؛ کارڈ درکار ہے
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 آؤٹ پٹس کے لیے پہلے lossless JSON اور محدود تشخیصی کمپریشن (Responses API)
6
Headroom
فراہم کردہ GCF codec کے ذریعے JSON arrays کی lossless جدولی اختصار کاری (~30%)
7
Relevance
آخری صارف استفسار کے مقابلے میں جملوں کی استخراجی درجہ بندی
8
Caveman
قواعد پر مبنی نثری کمپریشن (آؤٹ پٹ پر ~65–75%)
9
Aggressive
خلاصہ سازی اور پرانی باریوں کی تدریجی عمر رسیدگی
10
LLMLingua-2
MobileBERT ONNX کے ذریعے ML معنوی تراش خراش — کوڈ کے لیے محفوظ، async
11
Ultra
اختیاری چھوٹے ماڈل (SLM) درجے کے ساتھ اکتشافی ٹوکن تراش خراش
12
OmniGlyph
براہِ راست Anthropic کنکشن پر ناپے گئے Claude Fable 5 کے لیے تجرباتی سیاق و سباق بطور تصویر انکوڈنگ؛ فراہم کنندہ کی رسیدیں موصول ہونے تک GPT 5.6 transformers بدستور fail-closed رہتے ہیں۔ کمپریشن کی چار پروفائلز (پہلے سے طے شدہ aggressive، balanced، coding-safe، passthrough) (سب سے زیادہ aggressive؛ اختیاری طور پر فعال)
کوڈ بلاکس، 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 جزو غالباً اس لیے دوبارہ رینڈر ہو رہا ہے کیونکہ آپ ہر رینڈر سائیکل میں ایک نیا آبجیکٹ حوالہ بنا رہے ہیں۔ جب آپ ایک inline آبجیکٹ کو prop کے طور پر پاس کرتے ہیں تو React کا سطحی موازنہ اسے ہر بار مختلف آبجیکٹ سمجھتا ہے، جس سے دوبارہ رینڈر متحرک ہو جاتا ہے۔ میری تجویز ہے کہ آبجیکٹ کو memoize کرنے کے لیے useMemo استعمال کریں۔"_
>
> **بعد میں (19 ٹوکنز):** _"ہر رینڈر میں نیا آبجیکٹ حوالہ۔ Inline آبجیکٹ prop = نیا حوالہ = دوبارہ رینڈر۔ 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)۔
> **npm 11 یا اس کے بعد کا ورژن استعمال کر رہے ہیں؟** اگر پیکیج لائف سائیکل اسکرپٹس کی اجازت نہ دی گئی ہو تو npm انہیں روک سکتا ہے۔ OmniRoute کا `postinstall` (`node scripts/build/postinstall.mjs`) اس کی مقامی رن ٹائم فائلیں تیار کرنے کے لیے ضروری ہے۔ عالمی سطح پر انسٹال کرتے وقت npm کے انتباہ میں درج پیکیجز کی اجازت دیں۔ OmniRoute 3.8.51 کی رپورٹ کردہ پیکیج فہرست کے لیے:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> مستقبل کی عالمی تنصیبات میں اس اجازت فہرست کو دوبارہ استعمال کرنے کے لیے، اسے ایک بار کنفیگر کریں، پھر معمول کے مطابق انسٹال کریں:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> ریلیزز کے درمیان انحصارات کی فہرست بدل سکتی ہے؛ اگر npm کوئی مختلف فہرست رپورٹ کرے تو اس انتباہ میں موجود پیکیج نام استعمال کریں۔ کسی پیکیج کو اجازت دینے سے اس کے انسٹال اسکرپٹس چل سکتے ہیں۔
> **Gemini Web یا کوئی دوسرا ویب کوکی فراہم کنندہ استعمال کر رہے ہیں؟** npm پیکیج میں
> Playwright شامل ہے، مگر اس کی Chromium بائنری نہیں۔ پہلی ویب فراہم کنندہ درخواست کرنے سے پہلے
> [Playwright Chromium کی ترتیب](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> سے متعلق نوٹ دیکھیں۔
ڈیش بورڈ `http://localhost:20128` پر · API `http://localhost:20128/v1` پر۔
**2) اپنے اکاؤنٹ کے ذریعے کسی اہل فراہم کنندہ کو مربوط کریں**
ڈیش بورڈ → **فراہم کنندگان** → ایسا فراہم کنندہ منتخب کریں جس کی موجودہ شرائط اور کوٹا آپ کے استعمال کے مطابق ہوں → اس کی API کلید شامل کریں یا اس کا اکاؤنٹ فلو مکمل کریں۔ مفت درجوں کے لیے سائن اپ، منظوری یا ادائیگی کا طریقہ درکار ہو سکتا ہے۔ [مفت درجوں کی رہنما](docs/getting-started/FREE-TIERS-GUIDE.md) دیکھیں؛ بغیر کلید دستیابی کی ضمانت نہیں، اور `tos: avoid` سے نشان زد فراہم کنندگان کو ڈیفالٹ طور پر `auto` سے خارج رکھا جاتا ہے۔
**3) اپنے کوڈنگ ٹول کو مربوط کریں**
```txt
بنیادی URL: http://localhost:20128/v1
API کلید: [ڈیش بورڈ → اینڈ پوائنٹس سے نقل کریں]
ماڈل: auto (اہل کنکشنز میں روٹنگ کرتا ہے — یا فراہم کنندہ/ماڈل منتخب کریں)
```
**4) تصدیق کریں کہ یہ کام کر رہا ہے**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
آپ کو اپنے مربوط ماڈلز فہرست میں نظر آنے چاہییں۔ 🎉 بس اتنا ہی — کوڈنگ شروع کریں، اور OmniRoute آپ کے لیے خودکار روٹنگ اور فال بیک سنبھالے گا۔
اگر آپ کا کلائنٹ حسب ضرورت ہیڈرز نہیں بھیج سکتا تو OmniRoute ٹوکنائزڈ مطابقتی عرف بھی فراہم کرتا ہے:
```txt
OpenAI کیٹلاگ: http://localhost:20128/vscode/YOUR_KEY/
OpenAI ماڈلز: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI چیٹ: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI رسپانسز: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama چیٹ: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama ٹیگز: 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.52 · Node ≥22.22.2 · MIT لائسنس · omniroute.online
> براہِ راست `/dashboard/free-tiers` صفحے کا متحرک خلاصہ۔ مکمل طریقۂ کار (پول کی نقل کا خاتمہ، کریڈٹ درجات، فراہم کنندہ کی شرائط): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**۔
>
> ان اعداد و شمار کا براہِ راست کیٹلاگ کے مقابل ہر دو ہفتے بعد دوبارہ آڈٹ کیا جاتا ہے اور یہ **دونوں سمتوں میں تبدیل ہوتے ہیں** — کوئی فراہم کنندہ مفت درجہ ختم کرے تو تعداد کم ہو جاتی ہے؛ نیا شامل ہو تو بڑھ جاتی ہے۔ ہم وہی شائع کرتے ہیں جس کا حساب کیٹلاگ حقیقتاً لگاتا ہے، کبھی بھی بڑھا چڑھا کر پیش کیا گیا بہترین ممکنہ منظرنامہ نہیں۔
```bash
# فراہم کنندہ کو منسلک کرنے کے بعد، Dashboard → Endpoints سے اپنی OmniRoute کلید کاپی کریں:
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` کے لیے ایک اہل روٹ درکار ہوتا ہے۔ نئی تنصیب میں ممکن ہے کوئی اہل، بغیر کلید والا ہدف موجود نہ ہو، اور بغیر کلید والا فراہم کنندہ فریقِ ثالث کے کلائنٹس کو مسترد کر سکتا ہے۔ `tos: avoid` سے نشان زد فراہم کنندگان، بشمول OpenCode Free اور Kiro، بطورِ ڈیفالٹ خودکار روٹنگ سے خارج ہوتے ہیں؛ کسی اکاؤنٹ کو منسلک کرنا اس ترتیب کو تبدیل نہیں کرتا۔ فراہم کنندہ منتخب کرنے سے پہلے [مفت درجات کی رہنمائی](docs/getting-started/FREE-TIERS-GUIDE.md) دیکھیں۔
📦 **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 انجنز کا اسٹیک
انجنز پائپ لائن کی ترتیب میں چلتے ہیں؛ ہر انجن کو ہر مجموعے کے لیے آزادانہ طور پر فعال یا غیر فعال اور ترتیب دیا جا سکتا ہے:
