mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-18 04:42:30 +03:00

Files

Diego Rodrigues de Sa e Souza c3e966eeb9 docs(changelog): reconcile the v3.8.51 living section — round 2 (2026-09-15) (#13731 )

Second `npm run release:reconcile` pass on `release/v3.8.50..release/v3.8.51`
(091589089c..c0f92ec98a, 916 non-merge commits, 877 merged PRs):

- fold the 173 changelog.d fragments accumulated since #12971 under
  `## [3.8.51]` and delete them
- generate bullets for the 58 cycle commits that had no fragment
  (4 features / 42 fixes / 12 maintenance), each with the merged PR link and
  `— thanks @author`
- link 137 fragment bullets to the PR of the commit that added them and
  credit the author; two prefix/origin mismatches reviewed (#12945→#13392,
  #13001→#13379, both maintainer rebaselines of other people's PRs)
- refresh "Release by the numbers" + Top-25 and regenerate the
  `### 🙌 Contributors` hall (112 external contributors + maintainer; every
  non-bot author of the 877 merged PRs present)
- closed-PR credit audit for the window: nothing to add (#13215→#13361 and
  #13059→#13690 are still open, #12998 was independently fixed earlier by
  #12853); no human co-author trailers, no commits without a PR
- resync the 58 i18n CHANGELOG mirrors

Gates: check:changelog-integrity OK, check:docs-sync PASS.

2026-09-17 10:47:11 -03:00

docs

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CHANGELOG.md

docs(changelog): reconcile the v3.8.51 living section — round 2 (2026-09-15) (#13731 )

2026-09-17 10:47:11 -03:00

CLAUDE.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CODE_OF_CONDUCT.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CONTRIBUTING.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

GEMINI.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

llm.txt

fix(db): bound health scans and isolate native diagnostics (#13717 )

2026-09-16 12:59:45 -03:00

README.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

SECURITY.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

README.md

README (اردو)

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

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

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

💰 ~1.47B مفت ٹوکنز / ماہ

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

OmniRoute مفت درجے کا بجٹ کارڈ: مستقل طور پر ہر ماہ ~1.47B مفت ٹوکنز، سائن اپ کریڈٹس کے ساتھ پہلے ماہ میں زیادہ سے زیادہ ~2.07B، ایک اینڈ پوائنٹ کے پیچھے مفت درجے کے 452 فہرست بند اندراجات کا احاطہ کرنے والی 34 دستاویزی مسلسل پول کیز سے۔ دیانت دارانہ، پول کی نقل ختم کر کے کیا گیا حساب — ہر مشترکہ پول صرف ایک بار شمار کیا جاتا ہے، جس میں شائع شدہ مثبت ماہانہ ٹوکن بجٹ والے 16 مسلسل پولز کے علاوہ Groq کی فی ماڈل پانچ حدود شامل ہیں؛ شرائط کے خطرے والے کیٹلاگ میں 13 فراہم کنندگان کو اجتناب کے طور پر نشان زد کیا گیا ہے تاکہ فیصلہ آپ کریں۔ بجٹ بار میں Mistral 1B، Nara 210M، LLM7 150M، Groq 30M (فی ماڈل پانچ حدود) اور چھوٹے پولز شامل ہیں، نیز پہلے ماہ کے سائن اپ کریڈٹس اور مستقل طور پر مفت، بغیر ٹوکن حد والے فراہم کنندگان کو الگ دکھایا گیا ہے تاکہ وہ نمایاں مجموعے کو کبھی مصنوعی طور پر نہ بڑھائیں۔ براہِ راست استعمال شدہ/باقی مقدار /dashboard/free-tiers پر۔

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

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

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

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

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

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

📈 گیٹ وے مسلسل بڑھ رہا ہے

	v3.8.49	v3.8.50	`v3.8.51+`
🌐 فراہم کنندگان	290	352	مزید قطار میں
🧠 منفرد چیٹ ماڈل IDs	1185	1312	—
🖼️ موڈیلٹی برج	—	🆕 وژن + آڈیو + ویڈیو	—
📡 Radar مفت کیٹلاگ	—	🆕 اختیاری	—
⚖️ کوٹہ سے آگاہ شیڈولنگ	—	🆕 Quota-Share	—
📊 کوٹہ ٹیلی میٹری	—	🆕 براہِ راست	—

→ روڈ میپ — v3.9.0 LTS کی جانب رواں دواں

🧩 دستیاب

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

🌐 66 زبانوں میں

🆓 انسٹال کرتے ہی کام کرتا ہے — نہ کلیدیں، نہ کنفیگریشن

انسٹال کرتے ہی کام کرتا ہے — صفر کنفیگریشن۔ تین مراحل: 1. انسٹال کریں — npm i -g omniroute، سرور localhost:20128 پر شروع ہو جاتا ہے۔ 2. اپنے ٹول کو http://localhost:20128/v1 کی طرف پوائنٹ کریں — کوئی بھی OpenAI سے مطابقت رکھنے والا ٹول (Claude Code، Cursor، Cline)۔ 3. یہ جواب دیتا ہے — فوری جواب کے لیے model auto کو کال کریں، بغیر API کلید، سائن اپ یا کنفیگریشن کے۔ بغیر کلید والا فراہم کنندہ OpenCode Free پہلے ہی auto کومبو میں منسلک ہے، اس لیے نئی انسٹالیشن فوراً جواب دیتی ہے۔

# نئی انسٹالیشن، صفر اسناد — `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/}

💥 وعدہ

🤔 OmniRoute کیوں؟

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

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

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

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

Kimi کی معاونت سے کیا ممکن ہوتا ہے: Kimi کے API کریڈٹس OmniRoute کی AI سے توثیق شدہ ریلیز پائپ لائن کو تقویت دیتے ہیں — یعنی Kimi K3 کے ذریعے چلنے والا مرج کی توثیق کا مرحلہ، جو ہر پل ریکویسٹ کی ترسیل سے پہلے اس کا جائزہ لیتا ہے — نیز روزمرہ فیچر ڈیولپمنٹ کو بھی۔ Kimi کے لیے فرسٹ کلاس سپورٹ دونوں راستوں پر دستیاب ہے: براہِ راست Kimi API (kimi-k3) اور Kimi Code کوڈنگ پلان (OAuth اور API کلید)۔ 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 صارفین کے لیے فائدہ مند ہو؟ ایک ایشو کھولیں اور ہم اسے یہاں شامل کر دیں گے۔}

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

تمام 19 کامبو روٹنگ حکمتِ عملیاں متحرک انداز میں — ہر حکمتِ عملی کے لیے ایک ٹائل: priority، fill-first، weighted، round-robin، p2c، least-used، random، strict-random، cost-optimized، headroom، reset-window، reset-aware، context-relay، context-optimized، cache-optimized، lkgp، auto، fusion، pipeline۔ ہر ایک کے کام کی تفصیل کے لیے اوپر دیا گیا جدول دیکھیں۔

کامبو ماڈلز کی ایک زنجیر ہے جن کے درمیان 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 دیکھیں۔}

🧱 لچک پہلے سے شامل ہے (3 آزاد پرتیں)

OmniRoute کی لچک — خودکار بحالی کی 3 آزاد تہیں، درست ناکامی کے لیے درست تہہ۔ تہہ 1 فراہم کنندہ سرکٹ بریکر (مکمل فراہم کنندہ): صرف 408/5xx پر ٹرپ ہوتا ہے، حدیں OAuth 8× / API-key 12× / local 2×، HALF-OPEN جانچ میں 60s/30s/15s کے بعد ری سیٹ، ضرورت کے وقت بحالی؛ OPEN کے دوران combo اگلے فراہم کنندہ کی طرف دوبارہ روٹ کرتا ہے۔ تہہ 2 کنکشن کول ڈاؤن (ایک کلید/اکاؤنٹ): بنیادی مدت OAuth کے لیے 5s / API-key کے لیے 3s، اینٹی تھنڈرنگ ہرڈ حفاظتی انتظام کے ساتھ ×2 ایکسپونینشل بیک آف، 429 پر Retry-After کی پابندی، کامیابی تمام خرابی کی حالت صاف کر دیتی ہے؛ کول ڈاؤن میں موجود ایک کلید کو چھوڑ دیا جاتا ہے جبکہ دوسری کلیدیں سروس جاری رکھتی ہیں۔ تہہ 3 ماڈل لاک آؤٹ (ایک ماڈل): فی ماڈل 429، local 404 یا موڈ کی نامنظوری صرف اسی ماڈل کو لاک کرتی ہے — کبھی بھی پورے کنکشن کو نہیں۔ اختتامی حالتیں (پابندی زدہ، میعاد ختم، کریڈٹس ختم) آپریٹر کے لیے ہیں، کول ڈاؤنز کے لیے نہیں۔

_{📖 آٹو کومبو انجن · لچک کی رہنما کتاب}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

📡 OmniRoute Radar

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

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

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

✨ نیا کیا ہے

v3.8.20 → v3.8.50 کی حالیہ نمایاں تبدیلیاں۔ مکمل تاریخ CHANGELOG.md میں موجود ہے۔

🎛️ OmniConductor — آپ کے agent fleet کو inbound A2A delegation، Agent Card پر Conductor skills، اور Faro push-to-talk voice chat کے ساتھ ایک dashboard panel۔ → A2A Server
🛂 موافق admission اور overload تحفظ — بھاری chat requests اب 503 دینے کے بجائے queue ہوتی ہیں، جبکہ ہر connection کے لیے atomic RPM rolling leases موجود ہیں۔ → Resilience Guide
🗂️ معیاری /v1/models ترتیب — ہر provider کے لیے ایک مسلسل، provider کے لحاظ سے گروپ شدہ block (combos پہلے pin کیے گئے)، جو ہر catalog source میں مستحکم رہتا ہے۔ → API Reference
🗜️ Compression کی مضبوطی — بطور default فعال inflation guard، DE / FR / JA + Chinese (wényán) کے لیے Caveman packs، اور Gradle و .NET کے لیے RTK filters۔ → Compression
💸 شفاف flat-rate لاگت — subscription / coding-plan providers کی cost analytics میں لاگت $0 دکھائی جاتی ہے؛ budget، quota اور routing بدستور تخمینہ لگاتے رہتے ہیں۔ → API Reference
⚖️ Quota-Share routing — مشترکہ account کا quota pooled keys کے درمیان منصفانہ طور پر تقسیم کرتا ہے، اور work-conserving انداز میں غیر استعمال شدہ حصے دوسروں کو دے دیتا ہے۔ → Resilience Guide
🤖 ایک 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
🛰️ Remote mode — scoped tokens (connect / contexts / tokens) کے ساتھ remote OmniRoute چلائیں، نیز VPS تنصیبات کے لیے ایک antigravity OAuth helper استعمال کریں۔ → Remote Mode
🧭 زیادہ ذہین auto-routing — auto/<category>:<tier> combos، Fusion (model panel + judge)، task-aware routing، اور ہر request کے لیے model / mode / USD-budget overrides۔ → Auto-Combo
🗜️ Pluggable compression — 12 قابلِ ترکیب engines + Compression Studios: LLMLingua-2، two-tier Ultra، omniglyph، ہر step کے لیے fidelity gate، GCF v3.2، اور drag-reorder editor۔ → Compression
🕵️ شفاف MITM decrypt (TPROXY) — ان CLIs کو capture کریں جو proxy env vars نظرانداز کرتی ہیں، ایک per-SNI CA اور trust-store installer کے ساتھ۔ → MITM/TPROXY
💸 ہر جگہ cost telemetry — ہر endpoint پر X-OmniRoute-* cost/usage headers، cache-HIT savings header، اور ہر key کے لیے USD spend quotas۔ → API Reference
🧠 آپ کے اختیار میں memory — بطور default بند، اختیاری int8 vector quantization + typed decay، اور ہر request کے لیے x-omniroute-no-memory۔ → Memory
🛡️ سیکیورٹی — ہر 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
🖼️ نئے endpoints — /v1/ocr (Mistral OCR) اور /v1/audio/translations (Whisper-style) media surface کو مکمل کرتے ہیں۔ → API Reference
🎨 Image / video / audio generation — media کے لیے ایک API: xAI Grok Imagine اور Novita AI video، ComfyUI، Magnific، Adobe Firefly، Segmind، اور ElevenLabs جیسے speech providers۔ → API Reference
🌍 Deployment اور ops — reverse-proxy basePath، browser-language کی خودکار شناخت، ہر key کے لیے device tracking، root-less MITM trust، اور zh-TW localization۔ → Environment
🤝 مزید 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
📡 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
⚡ مقامی performance اور infra — one-click local Redis، Cloudflare Workers / Deno Deploy relay deployers، اور supervised embedded services کے طور پر Bifrost و Mux۔ → Embedded Services
🧩 پیکیج میں مزید بھی شامل ہے — 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

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

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

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_{Agent Deck}

＋ ان کے ساتھ بھی کام کرتا ہے · Kiro · Command Code · Antigravity · Windsurf · AMP · ہر OpenAI سے ہم آہنگ ٹول

_{📖 تمام 36 ٹولز (26 CLI Code's + 10 CLI Agents) کے لیے فی ٹول سیٹ اپ → docs/reference/CLI-TOOLS.md · 🧩 OpenCode پلگ اِن → @omniroute/opencode-provider}

کسی بھی معاونت یافتہ CLI کو OmniRoute کے ذریعے ایک کمانڈ میں چلائیں — کوئی کنفیگ فائل نہیں لکھی جاتی، ہر پراسیس کے لیے اسناد شامل کی جاتی ہیں، جبکہ Qwen/Gemini کو ایک عارضی، الگ تھلگ ہوم دیا جاتا ہے:

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

# یا فراہم کنندہ+ماڈل تعاملی طور پر منتخب کریں اور ٹول کی اپنی کنفیگ لکھیں:
omniroute configure codex          # یہ بھی: claude opencode qwen aider goose gemini cline continue kilo

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

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

352 رجسٹرڈ فراہم کنندگان مستند چیٹ، میڈیا، تلاش، مقامی، کلاؤڈ ایجنٹ اور سسٹم کلیکشنز میں شامل ہیں، جن میں سے 152 کے پاس hasFree: true دریافت میٹا ڈیٹا موجود ہے۔ چیٹ ماڈل رجسٹری میں 229 فراہم کنندگان / 2,554 منفرد فراہم کنندہ-ماڈل جوڑے / 1,283 خام ماڈل IDs شامل ہیں؛ علیحدہ مفت بجٹ کیٹلاگ میں 443 فی ماڈل قطاریں، 34 بار بار دستیاب ہونے والے پولز اور 53 بار بار دستیاب ہونے والے/کلید کے بغیر ہمیشہ مفت فراہم کنندگان موجود ہیں۔ یہ دانستہ طور پر مختلف مخرج ہیں؛ تعریفیں اور پول کی نقل ختم کر کے کیے گئے حسابات فراہم کنندہ حوالہ اور مفت درجات میں موجود ہیں۔

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

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

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

🆓 ہمیشہ مفت — $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

🖥️ 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
🛠️ سورس سے	`npm install && npm run dev`	اس میں تبدیلیاں کریں، تعاون کریں

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

🧩 نیا: VS Code کے مقامی Copilot Chat کے اندر OmniRoute

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

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

اسٹور	لنک	ان کے ساتھ کام کرتا ہے
🧩 VS Code Marketplace	انسٹال کریں →	VS Code — مستحکم اور Insiders
🔓 Open VSX Registry	انسٹال کریں →	Cursor، Windsurf، VSCodium، Theia، code-server، Gitpod، Antigravity، Kiro…

ایڈیٹر کے اندر سے: ایکسٹینشنز منظر کھولیں، "OmniRoute" تلاش کریں، انسٹال کریں پر کلک کریں — دونوں اسٹورز پر اسی طرح کام کرتا ہے۔ سورس، مسائل اور اشاعت کی عملی ہدایات diegosouzapw/OmniCopilot پر موجود ہیں۔

_{📖 VS Code Copilot Chat رہنما — سیٹ اپ، انتخاب کنندہ کیا دکھاتا ہے، ٹیب کے اندر ڈیش بورڈ، مسائل کا حل}

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

omniroute serve اس وقت بہترین کام کرتا ہے جب یہ ہمیشہ فعال ہو۔ OmniRouteTray اسے macOS کے لیے ایک مرتبہ ترتیب دے کر بھول جانے والی مینو بار ایپ بنا دیتا ہے: یہ سرور شروع کرتا ہے، ری بوٹس کے بعد بھی اسے فعال رکھتا ہے، وہیں اپ ڈیٹ کرتا ہے، اور آپ کا لائیو ٹوکن بجٹ ایک کلک کی دوری پر رکھتا ہے — کسی ٹرمینل ونڈو کو کھلا رکھنے کی ضرورت نہیں، نہ ہی npm install -g omniroute کی دیکھ بھال درکار ہے۔

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

OmniRoute کمپریشن پائپ لائن: 10,000 ٹوکنز پر مشتمل ایک مثالی کلائنٹ درخواست 12 قابلِ امتزاج انجنز — Session-Dedup، CCR، Lite، RTK، Responses Tool Output، Headroom، Relevance، Caveman، Aggressive، LLMLingua-2، Ultra اور OmniGlyph — سے گزرتی ہے، اور دستاویزی اسٹیک شدہ مثال میں تقریباً 1,080 ٹوکنز کے ساتھ فراہم کنندہ تک پہنچ سکتی ہے۔ ساختی مواد کو تحفظاتی گارڈز اور ہر مرحلے کے fidelity gates کے ذریعے محفوظ رکھا جاتا ہے؛ واضح lossy یا تجرباتی موڈز اہل مواد کو تبدیل کر سکتے ہیں۔

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

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

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

جب چند ٹوکنز سے کام ہو سکتا ہے تو زیادہ ٹوکنز کیوں استعمال کریں؟ ہر درخواست OmniRoute کی کمپریشن پائپ لائن سے شفاف طور پر گزرتی ہے — کلائنٹ میں کسی تبدیلی کی ضرورت نہیں۔ اب یہ 12 قابلِ امتزاج انجنز کا ایک اسٹیک ہے، جو ترتیب سے چلتے ہیں اور ہر روٹنگ امتزاج کے مطابق باہم ملائے جا سکتے ہیں — یہ RTK، Caveman (⭐ 90K+)، LLMLingua-2، اور 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 موڈ:

پہلے (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: <mode>; source=<source> رسپانس ہیڈر میں واپس دکھائی دیتا ہے۔

ٹوکن حد کے ذریعے آٹو ٹریگر کریں، اڈاپٹیو ڈائل آن کریں، کوئی نام زد پروفائل مقرر کریں، فی درخواست ایک وقتی ترتیب لگائیں، یا ہر راؤٹنگ کومبو کے لیے پائپ لائن مختص کریں — جو بھی کام کے بوجھ کے مطابق ہو۔ اختیاری آف لائن جائزہ فریم ورک (npm run eval:compression) کسی تبدیلی کو نافذ کرنے سے پہلے ایک مقررہ کارپس پر معلوماتی وفاداری بمقابلہ بچت کی درجہ بندی کرتا ہے۔

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

⚡ فوری آغاز

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

npm install -g omniroute
omniroute

💡 npm warn ERESOLVE یا peer-dep انتباہات نظر آ رہے ہیں؟ یہ بے ضرر ہیں۔

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

2) ایک مفت فراہم کنندہ منسلک کریں (سائن اپ کے بغیر)

ڈیش بورڈ → فراہم کنندگان → Kiro AI (مفت Claude، فی اکاؤنٹ تقریباً 50 کریڈٹس/ماہ) یا OpenCode Free (بغیر تصدیق) منسلک کریں → مکمل۔

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

Base URL: http://localhost:20128/v1
API Key:  [copy from Dashboard → Endpoints]
Model:    auto            (zero-config smart routing — or any provider/model)

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

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

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

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

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

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

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

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

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

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

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

🥟 Bun

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

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

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

🛠️ سورس سے

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

📦 pnpm

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

🐧 Arch Linux (AUR)

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

🔧 Nix (Flake)

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

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

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

🦭 Podman

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

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

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

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

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

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

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

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

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

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

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

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

_{2026-08-24 کو پینل کا اسنیپ شاٹ · خام کیٹلاگ: YT 809 | TT 137 | IG 124 · تازگی (دن): YT 1 | TT 21 | IG 22}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 ملاحظات}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 ملاحظات}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 ملاحظات}

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

#1	#2	#3	#4	#5
nick_saraev — Instagram — 3,042,474	theopenstack — Instagram — 692,419	milesreevesai — TikTok — 620,400	Vaibhav Sisinty — YouTube — 391,109	buildwithai.club — Instagram — 347,652

#6	#7	#8	#9	#10
nivedan.ai — Instagram — 331,973	vaibhavsisinty — Instagram — 263,744	Nick Automates — YouTube شارٹس — 218,174	theroshankrishna — Instagram — 186,786	midudev — TikTok — 177,800

2026-08-24 کو کینونیکل میٹرکس: 1.029 منفرد ویڈیوز · 11.132.922 معلوم ملاحظات (v > 0) · نیٹ ورک کے لحاظ سے 639 چینلز/پروفائلز۔ خام پینل میں 1.070 قطاریں شامل ہیں؛ Instagram کی 41 نقلوں کو کینونیکل URL کے ذریعے معمول پر لایا گیا، اور ہر ویڈیو کے لیے سب سے زیادہ تعداد برقرار رکھی گئی۔

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

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

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

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

🛠️ ٹیکنالوجی اسٹیک

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

📖 دستاویزات

📘 آغاز کرنا

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

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

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

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

دستاویز	تفصیل
آرکیٹیکچر	سسٹم آرکیٹیکچر، ڈیٹا کا بہاؤ، اور اندرونی اجزا
کمپریشن رہنما	7 اختیاراتی پائپ لائن: بند / ہلکی / معیاری / جارحانہ / انتہائی / RTK / تہہ دار
RTK کمپریشن	کمانڈ آؤٹ پٹ کمپریشن، فلٹرز، اعتماد، تصدیق، خام آؤٹ پٹ کی بازیابی
کمپریشن انجنز	Caveman، RTK، تہہ دار پائپ لائنز، ڈیش بورڈ/API/MCP انٹرفیسز
کمپریشن قواعد کا فارمیٹ	Caveman اور RTK فلٹرز کے لیے JSON رول پیک اسکیمے
کمپریشن لینگویج پیکس	زبان کی شناخت اور Caveman رول پیک کی تیاری
لچک پذیری رہنما	سرکٹ بریکرز، کول ڈاؤنز، قطار، اینٹی تھنڈرنگ ہرڈ، TLS اسپوفنگ
آٹو کومبو انجن	16 عوامل پر مبنی اسکورنگ، موڈ پیکس، خودکار بحالی
پراکسی رہنما	3 سطحی پراکسی سسٹم، 1proxy مارکیٹ پلیس، رجسٹری CRUD
مفت درجات	جامع ڈائریکٹری: دستاویزی شکل میں 34 بار بار دستیاب پولز / کیٹلاگ میں مفت درجے کی 452 اندراجات
خصوصیات کی گیلری	اسکرین شاٹس کے ساتھ ڈیش بورڈ کا بصری دورہ
کوڈ بیس دستاویزات	ابتدائی افراد کے لیے موزوں کوڈ بیس کا مرحلہ وار جائزہ

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

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

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

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

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

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

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

درجہ	شراکت کار	ضم شدہ PRs	~تبدیل شدہ سطریں
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{یہ اعداد براہِ راست release/v3.8.50 کے آخری پوائنٹ dafb4ae808 پر منجمد کیے گئے ہیں، جن میں 2026-08-24 05:26:03 UTC تک کے مرجز شامل ہیں۔ صفحات میں منقسم GitHub GraphQL مردم شماری میں 5,911 ضم شدہ PRs شامل ہیں: 2,707 مخزن کے مالک کی جانب سے، 179 Dependabot کی جانب سے، اور 535 منفرد شراکت کاروں کی جانب سے 3,025 بیرونی PRs۔ ”تبدیل شدہ سطریں“ سے مراد GitHub کے اضافوں اور حذف شدگیوں کا مجموعہ ہے اور اس میں تیار کردہ فائلیں، لاک فائلیں، کیٹلاگز، تراجم اور دستاویزات شامل ہیں؛ یہ تبدیلیوں کی مقدار ہے، مصنف کی تحریر کردہ LOC نہیں۔ آخری حد پر برابر درجات برقرار رکھے گئے ہیں۔}

GitHub سے منسوب کمٹس

backryun _{🥇 GitHub سے منسوب 220 کمیٹس}	Paijo _{🥈 GitHub سے منسوب 219 کمیٹس}	Randi _{🥉 GitHub سے منسوب 108 کمیٹس}	Ravi Tharuma _{🏅 GitHub سے منسوب 81 کمیٹس}	Chris _{🏅 GitHub سے منسوب 70 کمیٹس}	Markus Hartung _{🏅 GitHub سے منسوب 69 کمیٹس · مشترکہ طور پر #6}
Dizzle _{🏅 GitHub سے منسوب 69 کمیٹس · مشترکہ طور پر #6}	Jan Leon _{🏅 GitHub سے منسوب 64 کمیٹس}	zenobit _{🏅 GitHub سے منسوب 62 کمیٹس}	Bob.Hou _{🏅 GitHub سے منسوب 51 کمیٹس · مشترکہ طور پر #10}	Xiangzhe _{🏅 GitHub سے منسوب 51 کمیٹس · مشترکہ طور پر #10}

_{2026-08-24 06:14:31 UTC پر دوبارہ جانچ کی گئی: ڈیفالٹ برانچ release/v3.8.50 کے لیے ریپوزٹری Contributors API کی رپورٹ کردہ GitHub سے منسوب کمیٹس۔ API نے 525 شناختیں واپس کیں (415 صارفین، 2 بوٹس، 108 گمنام)؛ اس جدول میں مینٹینر، بوٹس اور گمنام شناختیں شامل نہیں ہیں، جبکہ مساوی مقابلاتی پوزیشنیں برقرار رکھی گئی ہیں۔ یہ اوپر دی گئی ضم شدہ PR درجہ بندی اور نیچے دی گئی 639 افراد پر مشتمل Git میٹا ڈیٹا مردم شماری، دونوں سے الگ ہے۔}

🙏 ان معاونین کی خصوصیات، بگ فکسز اور انفراسٹرکچر میں بہتریاں اس چیز کا بنیادی حصہ ہیں جو OmniRoute کو قابلِ اعتماد اور خصوصیات سے بھرپور بناتی ہے۔ ہر pull request، ہر test case، اور ہر i18n ترجمہ فائل اہم ہے۔ اوپن سورس ان ہی جیسے لوگوں کی بدولت بنتا ہے۔

💖 اسپانسرز

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

Andrew
_{💛 فعال ماہانہ اسپانسر}

Vlad I
_{💛 فعال ماہانہ اسپانسر}

Paco Cartones
_{💛 فعال یک وقتی اسپانسر}

Prof. Igor Morais
_{💛 سابق یک وقتی معاون}

longtao
_{💛 سابق یک وقتی معاون}

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

_{عوامی GitHub اسپانسرز کی 2026-08-24 کو دوبارہ توثیق کی گئی۔ GitHub کی activeOnly حیثیت اوپر موجود فعال لیبلز کا تعین کرتی ہے؛ پہلے ظاہر کیے گئے عوامی یک وقتی معاونین کا شکریہ برقرار ہے، جبکہ نجی اسپانسرز گمنام رہتے ہیں۔}

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

👥 600+ معاونین

_{2026-08-24 کو منجمد بنیاد ac02c5b42f پر آڈٹ کیا گیا اور لائیو release/v3.8.50 کے آخری سرے dafb4ae808 پر دوبارہ جانچ کی گئی: 639 معمول پر لائی گئی انسانی Git شناختیں — 407 کمٹ مصنفین کے طور پر ظاہر ہوتے ہیں (بشمول مینٹینر) اور 232 صرف واضح Co-authored-by ٹریلرز میں موجود ہیں۔ یہ مردم شماری GitHub کے noreply ہینڈلز کو معمول پر لاتی ہے، 26 bot/agent/service/placeholder شناختوں کو خارج کرتی ہے، اور محض یکساں نمائشی نام ہونے کی وجہ سے عام ای میل پتوں کو ضم نہیں کرتی۔}

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

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

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

نیا ورژن جاری کرنا

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

📊 ستارے

🌍 StarMapper

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

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

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

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

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
9router	26,161	اصل پروجیکٹ جس پر یہ fork بنایا گیا ہے — یہاں اسے ملٹی موڈل APIs اور مکمل TypeScript باز تحریر کے ساتھ وسعت دی گئی ہے۔
CLIProxyAPI	48,497	Go کا وہ نفاذ جس سے یہ JavaScript / TypeScript پورٹ متاثر ہوا۔
LiteLLM	57,100	وہ AI گیٹ وے جس کا عوامی قیمتوں کا ڈیٹا سیٹ ہماری لاگت کی ٹریکنگ کی ہم وقت سازی کو ڈیٹا فراہم کرتا ہے اور جس کے فراہم کنندہ کو معمول پر لانے کے ماڈل نے ہماری روٹنگ کی تشکیل میں رہنمائی کی۔
codex-chatgpt-web	1,410	MIT ماخذ کو شامل شدہ ChatGPT Web → Codex Responses برج میں ڈھالا گیا، جس میں براؤزر سیشن، رسپانس فریمنگ، استعمال اور ویب سرچ اڈاپٹرز شامل ہیں۔
free-claude-code	48,112	اس کے پیٹرنز کو اسٹریم بحالی، no-thinking aliases، متبادل ویب سرچ، سلائیڈنگ ونڈو حدود، لاگ کی خفیہ معلومات چھپانے اور زیادہ محفوظ لانچر فلوز میں پورٹ کیا گیا۔
composer-api	322	Cursor Composer کے ٹول انتخاب، آؤٹ پٹ پابندی اور ٹول کمٹ پیٹرنز کو مقامی Cursor executor میں ڈھالا گیا۔
codex-multi-auth	457	تازہ لاگ اِن اور refresh-token گردش کے پیٹرنز کو Codex OAuth کی دوبارہ توثیق میں پورٹ کیا گیا۔
opencode-anthropic-auth	510	Claude Code سے ہم آہنگ ٹرانسفارم ڈیفالٹس اور بلنگ ہیڈر کے طرزِ عمل کو عمومی بنا کر OmniRoute کے کنفیگ سے چلنے والے برج میں شامل کیا گیا۔
grok2api-merged	2	اس کی Grok ماڈل میپنگز، جعلی TypeError پر مبنی Statsig generator، درخواست اور ڈیوائس ڈیفالٹس، اور NDJSON رسپانس پروسیسر کو نمایاں طور پر OmniRoute کے Grok Web executor میں ڈھالا گیا۔
TQZHR/grok2api	705	grok2api-merged کے پسِ پشت بنیادی بالواسطہ کوڈ ماخذ؛ اس کے ماڈل، ہیڈر، پے لوڈ، Statsig اور پروسیسر کے نفاذ Grok Web کے سلسلۂ ماخذ میں محفوظ ہیں۔
chenyme/grok2api	7,520	Grok پے لوڈ اور ڈیوائس ڈیفالٹس، Statsig generator، اور TQZHR اور grok2api-merged کے ذریعے منتقل ہونے والے `result.response` پروسیسر کا بنیادی MIT ماخذ۔
grok2api-pro	27	ایک بالواسطہ ماخذ جسے grok2api-merged نے اپنی پراکسی پول تہہ کے لیے کریڈٹ دیا؛ OmniRoute اس سلسلۂ ماخذ کے نوٹس کو محفوظ رکھتا ہے، لیکن اپنے محدود Grok Web executor میں پراکسی پول پورٹ کا دعویٰ نہیں کرتا۔
GrokProxy	50	اس کی کوکی سے توثیق شدہ Grok پراکسی اور `result.response.token` اسٹریمنگ پیٹرن نے OmniRoute کے Grok Web ٹرانسپورٹ کی تشکیل میں رہنمائی کی۔
GrokBridge	5	اصل Grok Web نفاذ نے اس کے HTTP/براؤزر اپ اسٹریم ڈیزائن سے استفادہ کیا؛ اس کا براہِ راست HTTP راستہ GrokProxy سے اخذ شدہ ہے، اس لیے کسی آزاد کوڈ پورٹ کا دعویٰ نہیں کیا جاتا۔
grok-web-api	14	اس کے Rust `ChatOptions` اور رسپانس انویلپ اسکیماؤں نے OmniRoute کی TypeScript Grok درخواست اور اسٹریمنگ رسپانس اقسام کی تشکیل میں رہنمائی کی۔

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

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
Caveman	100,538	وائرل "جب چند ٹوکن سے کام ہو جائے تو زیادہ ٹوکن کیوں استعمال کرنا" پروجیکٹ — اس کا غار کے انسان جیسی زبان کا فلسفہ ہمارے معیاری کمپریشن موڈ اور 30+ غیر ضروری الفاظ کے اخراج/اختصار کے قواعد کی بنیاد ہے۔
RTK – Rust Token Killer	77,185	اعلیٰ کارکردگی والی کمانڈ آؤٹ پٹ کمپریشن — اس سے ہمارے RTK انجن، JSON فلٹر DSL، خام آؤٹ پٹ کی بازیابی اور تہہ دار RTK → Caveman پائپ لائن کو تحریک ملی۔
headroom	67,310	قابلِ واپسی سیاقی کمپریشن (SmartCrusher) — اس سے ہمارے `headroom` انجن اور `ccr` بازیابی مارکر پیٹرن کو تحریک ملی۔
LLMLingua	6,598	پرامپٹ کمپریشن کی تحقیق (LLMLingua / LLMLingua-2) — اس سے ہمارے غیر متزامن، کوڈ کے لیے محفوظ، ناکامی کی صورت میں اصل متن برقرار رکھنے والے `llmlingua` انجن کو تحریک ملی۔
llmlingua-2-js	31	JS/ONNX پورٹ (MobileBERT / XLM-RoBERTa)، جو ہمارے LLMLingua انجن کے لیے ورکر تھریڈ بیک اینڈ کے طور پر استعمال ہوتا ہے۔
Troglodita	40	PT-BR ٹوکن کمپریشن — یہ ہمارے pt-BR لینگویج پیک کی بنیاد ہے: برازیلی پرتگالی قواعد کے مطابق غیر ضروری تکرار میں کمی اور زائد الفاظ کا اخراج۔
ponytail	108,957	وائرل "سست سینئر ڈویلپر" YAGNI-کوڈر مہارت — اس سے ہمارے کم کوڈ آؤٹ پٹ اسٹائل کو تحریک ملی: کم ترین قابلِ عمل تبدیلی کی سمت نمائی، جو _تیار کردہ_ کوڈ کم کرتی ہے (Caveman کی مختصر نثر کا آؤٹ پٹ محور پر ہم منصب)۔
i-have-adhd	23,526	اس کے عمل کو مقدم رکھنے والے، ADHD کے لیے موزوں جوابی انداز کو پانچ زبانوں میں OmniRoute کے مختصر آؤٹ پٹ اسٹائل کے لیے ڈھالا گیا۔

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

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

🧠 میموری اور RAG

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

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

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

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

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
models.dev	6,555	AI ماڈل کی تفصیلات، قیمتوں اور صلاحیتوں کا کھلا ڈیٹابیس — ہمارے ماڈل کیٹلاگ میں مقامی طور پر ہم وقت کیا گیا۔
React Flow / xyflow	38,108	نوڈ پر مبنی گراف لائبریری جو ہمارے ریئل ٹائم Compression Studio اور Combo/Routing Studio کو چلاتی ہے۔
LangGraph	40,314	LangGraph Studio کے لائیو ورک فلو گراف کی منظرکشی نے ہمارے Studios کے ریئل ٹائم کیسکیڈ منظر کو متاثر کیا۔
Langfuse	33,592	اس کے ٹریس → اسپین → جنریشن مشاہدہ پذیری ماڈل نے ہمارے Compression Studio واٹر فال کو تشکیل دیا۔
Kiali	3,631	Istio سروس میش مشاہدہ پذیری — اس نے Routing/Combo Studio میں ہمارے سرکٹ بریکر بیجز اور خرابی کے کناروں کی منظرکشی کو متاثر کیا۔
lobe-icons	2,428	AI/LLM برانڈ لوگوز، جو ہمارے ڈیش بورڈ میں فراہم کنندگان کے آئیکنز دکھاتے ہیں۔
flag-icons	12,354	README کے زبان منتخب کنندہ میں استعمال ہونے والے MIT لائسنس یافتہ SVG پرچم فراہم کرتا ہے۔

🛡️ سیکیورٹی

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

🧭 تکمیلی ٹولز

پروجیکٹ	⭐	اس نے OmniRoute کو کیسے متاثر کیا
ClawRouter	6,564	اس نے درخواستوں کی تکرار ختم کرنے، ہنگامی صفر لاگت فال بیک، قابل توسیع Auto-Combo حکمت عملیوں اور کثیر لسانی نیت کی درجہ بندی کو متاثر کیا۔
Antigravity-Manager	30,652	اس کے اکاؤنٹ سے آگاہ ماڈل ری میپنگ، قابل نفاذ فائل کے راستے کی توثیق اور پلان لیبل کے رویے نے OmniRoute کے Antigravity رن ٹائم کی تشکیل میں رہنمائی کی۔
vscode-antigravity-cockpit	4,817	اس کے مختصر کوٹہ ری سیٹ کاؤنٹ ڈاؤن فارمیٹ نے OmniRoute میں متعلقہ فراہم کنندہ کی حد کے ڈسپلے کو متاثر کیا۔
AionUi	32,230	اس کی ACP انٹیگریشنز نے OmniRoute میں نصب شدہ CLI ایجنٹس کی خودکار شناخت کو متاثر کیا۔
CodexBar	20,507	اس نے Grok Build کوٹہ سطح کی نشان دہی کی؛ پھر OmniRoute نے آزادانہ طور پر لائیو وائر فارمیٹ کی تصدیق اور اصلاح کی۔

📄 لائسنس

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

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

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

README.md Unescape Escape

README (اردو)

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

💰 ~1.47B مفت ٹوکنز / ماہ

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

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

📈 گیٹ وے مسلسل بڑھ رہا ہے

🧩 دستیاب

🆓 انسٹال کرتے ہی کام کرتا ہے — نہ کلیدیں، نہ کنفیگریشن

💥 وعدہ

🤔 OmniRoute کیوں؟

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

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

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

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

🧱 لچک پہلے سے شامل ہے (3 آزاد پرتیں)

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

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

📡 OmniRoute Radar

✨ نیا کیا ہے

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

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

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

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

🖥️ OmniRoute کہاں چلتا ہے — ہر جگہ

🧩 نیا: VS Code کے مقامی Copilot Chat کے اندر OmniRoute

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

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

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

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

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

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

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

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

🧱 12 انجنز کا اسٹیک

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

⚡ فوری آغاز

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

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

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

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

🛠️ ٹیکنالوجی اسٹیک

📖 دستاویزات

📘 آغاز کرنا

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

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

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

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

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

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

GitHub سے منسوب کمٹس

💖 اسپانسرز

👥 600+ معاونین

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

نیا ورژن جاری کرنا

📊 ستارے

🌍 StarMapper

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

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

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

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

🧠 میموری اور RAG

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

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

🛡️ سیکیورٹی

🧭 تکمیلی ٹولز

📄 لائسنس

README.md

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

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