# 🚀 OmniRoute — ফ্রি এআই গেটওয়ে (The Free AI Gateway)
## 💰 প্রতি মাসে ~1.62B বিনামূল্যের টোকেন
> হাতে হাতে ফ্রি টিয়ার একত্র করা কষ্টসাধ্য — ডজনখানেক SDK, ডজনখানেক রেট লিমিট, আর আপনার কাছে আসলে কতটা আছে সে সম্পর্কে কোনো ধারণাই থাকে না। 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
# Fresh install, zero credentials — `auto` already works:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
নির্দিষ্ট কোনো ফ্রি ব্যাকএন্ড পছন্দ করেন? সরাসরি `oc/…` (OpenCode Free) কল করুন। এরপর `auto`-তে রূপান্তর করুন এবং OmniRoute-কে বেছে নিতে দিন।📦 **Python, Node.js, PHP এবং cURL**-এর জন্য কপি-পেস্ট কুইকস্টার্ট স্ক্রিপ্টসমূহ → [`examples/quickstart/`](examples/quickstart/)
# 💥 প্রতিশ্রুতি
# 🤔 কেন OmniRoute?
## 🤝 আমাদের ওপেন সোর্স বন্ধুদের সহায়তায়
> **ওপেন সোর্স বন্ধু হিসেবে যোগ দিতে চান?** এই প্রতিষ্ঠানগুলো ওপেন সোর্সকে সমর্থন করে এবং OmniRoute-কে এগিয়ে যেতে সহায়তা করে — আর তাদের দেওয়া প্রতিটি টোকেন কোথায় ব্যয় হয়, তা আমরা প্রকাশ্যে জানাই। যোগাযোগ করুন: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
এই প্রকল্পকে সমর্থন করার জন্য আমাদের প্রতিষ্ঠাতা ওপেন সোর্স বন্ধু Kimi (Moonshot AI)-কে ধন্যবাদ! Kimi হলো ওপেন-ওয়েট K2 ও K3 মডেল পরিবারের পেছনের AI ল্যাব — Kimi K3 ক্লোজড-মডেলের দামের একটি ক্ষুদ্র অংশে 1M-টোকেন কনটেক্সট উইন্ডো, নেটিভ ভিশন এবং অগ্রসীমার কোডিং সক্ষমতা প্রদান করে এবং Claude Code, Codex ও OmniRoute পরিবেশিত প্রতিটি কোডিং টুলের সঙ্গে সরাসরি কাজ করে।
Kimi-এর সহায়তায় যা পরিচালিত হয়: Kimi-এর API ক্রেডিট OmniRoute-এর AI-যাচাইকৃত রিলিজ পাইপলাইনকে শক্তি জোগায় — অর্থাৎ Kimi K3 দ্বারা পরিচালিত মার্জ যাচাইকরণ ধাপটি, যা প্রকাশের আগে প্রতিটি pull request পর্যালোচনা করে — পাশাপাশি দৈনন্দিন ফিচার ডেভেলপমেন্টেও সহায়তা করে। উভয় পথেই প্রথম-শ্রেণির Kimi সমর্থন রয়েছে: সরাসরি Kimi API (kimi-k3) এবং Kimi Code কোডিং প্ল্যান (OAuth ও API key)। এছাড়াও, Kimi-এর সহায়তা কর্মসূচিতে OmniRoute হলো ব্রাজিলের প্রথম ওপেন-সোর্স প্রকল্প। 15% অতিরিক্ত ক্রেডিটসহ একটি Kimi API key নিন →
Cheaper Inference cheaperinference.com
এই প্রকল্পকে সমর্থন করার জন্য OmniRoute-এর ওপেন সোর্স বন্ধু Cheaper Inference-কে ধন্যবাদ! Cheaper Inference হলো মূল্য অনুযায়ী সাজানো একটি গেটওয়ে, যা Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ও MiniMax-সহ 42টি অগ্রসীমার মডেল একটি OpenAI-সামঞ্জস্যপূর্ণ এন্ডপয়েন্টের মাধ্যমে পুনর্বিক্রি করে এবং প্রতিটি অনুরোধকে সবচেয়ে সাশ্রয়ী যোগ্য প্রদানকারীর কাছে পাঠায়—কখনোই মডেল নির্মাতার তালিকাভুক্ত মূল্যের বেশি চার্জ না করে।
OmniRoute-এ প্রথম-শ্রেণির সমর্থন: Chat Completions, নেটিভ /v1/responses এন্ডপয়েন্ট, ভিশন, টুল কলিং এবং 3টি ইমেজ মডেল (grok-imagine, nano-banana-pro, nano-banana-2, যেগুলো cheaperinference/<model> হিসেবে ব্যবহারযোগ্য)। একটি API key নিন →
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 আপনার সংযুক্ত প্রোভাইডারগুলো থেকে একটি ভার্চুয়াল কম্বো তৈরি করবে, যার স্কোর সরাসরি হালনাগাদ হয়:
পুনরাবৃত্তি ডি-ডুপ্লিকেট না করে র্যান্ডম নির্বাচন 🎲
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 লাইসেন্সপ্রাপ্ত এবং উন্মুক্তভাবে রক্ষণাবেক্ষণ করা হয়। এটি যদি আপনার সময় বা অর্থ সাশ্রয় করে, তবে একে স্বাধীন রাখতে যেটি আপনার জন্য উপযুক্ত সেটি বেছে নিন। স্পনসরশিপ কখনোই রাউটিং অগ্রাধিকারকে প্রভাবিত করে না; এটি দৃশ্যমানতা দেয়, র্যাঙ্কিং নয়।
⭐ রেপোতে স্টার দিন
বিনামূল্যে — দৃশ্যমানতা বাড়াতে সত্যিই সাহায্য করে
⚠️ প্রতিটি কয়েন শুধু দেখানো নেটওয়ার্কেই পাঠান — ভুল নেটওয়ার্কে পাঠালে অর্থ হারিয়ে যেতে পারে।
🐛 কোনো বাগ পেয়েছেন বা মতামত আছে? একটি [আলোচনা](https://github.com/diegosouzapw/OmniRoute/discussions) শুরু করুন।
ডেভেলপার নোট: ডেভেলপারদের সুবিধার জন্য প্রকল্পটি npm install/postinstall-এর সময় একটি স্থানীয় .env ফাইল তৈরি করতে পারে। ফাইলটি ইচ্ছাকৃতভাবে .gitignore-এর মাধ্যমে উপেক্ষা করা হয় (.gitignore দেখুন) এবং এটি কখনোই কমিট করা যাবে না — ভুলবশত কমিট হয়ে গেলে উন্মুক্ত হয়ে পড়া যেকোনো সিক্রেট পরিবর্তন করুন এবং ইতিহাস থেকে ফাইলটি সরিয়ে ফেলুন। স্থানীয় এনভায়রনমেন্ট ফাইল ও সিক্রেট ব্যবস্থাপনার নির্দেশনার জন্য docs/DEVELOPER-ENVIRONMENT.md দেখুন।
## 📡 OmniRoute Radar
উপরের নথিভুক্ত, পুল-ডিডুপ্লিকেটেড ক্যাটালগ থেকে প্রধান ফ্রি-টিয়ার সীমা এখনও **~1.62B টোকেন/মাস**। সাময়িক প্রদানকারী সাইনআপ ক্রেডিট আলাদাভাবে প্রথম মাসের সীমা বাড়িয়ে **~2.22B** করতে পারে। যারা OmniRoute-এর রিলিজগুলোর মধ্যবর্তী সময়ে ফ্রি মডেলের আরও হালনাগাদপ্রাপ্ততা চান, তাদের জন্য Radar হলো একটি ঐচ্ছিক, স্বাক্ষরিত ক্যাটালগ ওভারলে; কমিউনিটি ক্যাটালগ এবং বিদ্যমান প্রতিটি ফ্রি ফিচার বিনামূল্যেই থাকবে।
সমর্থকেরা লাইভ ক্যাটালগ এবং অতিরিক্ত প্রদানকারী-সংক্রান্ত সুযোগ পেতে পারেন। প্রদানকারীর প্রাপ্যতার ওপর নির্ভর করে এর পৃথক, পরিবর্তনযোগ্য সর্বোচ্চ সীমা **সর্বাধিক আনুমানিক 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` ক্রম** — প্রতি প্রোভাইডারের জন্য একটি সংলগ্ন, প্রোভাইডার-অনুযায়ী গোষ্ঠীবদ্ধ ব্লক (কম্বোগুলো প্রথমে পিন করা), যা প্রতিটি ক্যাটালগ উৎসে স্থিতিশীল থাকে। → [API রেফারেন্স](docs/reference/API_REFERENCE.md)
- **🗜️ কম্প্রেশন দৃঢ়ীকরণ** — ডিফল্টভাবে সক্রিয় ইনফ্লেশন গার্ড, DE / FR / JA + Chinese (wényán)-এর জন্য Caveman প্যাক, Gradle ও .NET-এর জন্য RTK ফিল্টার। → [কম্প্রেশন](docs/compression/COMPRESSION_ENGINES.md)
- **💸 সৎ ফ্ল্যাট-রেট খরচ** — সাবস্ক্রিপশন / কোডিং-প্ল্যান প্রোভাইডারগুলোর খরচ বিশ্লেষণে **$0** দেখানো হয়; বাজেট, কোটা ও রাউটিং অনুমান চালিয়ে যায়। → [API রেফারেন্স](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share রাউটিং** — পুল করা কিগুলোর মধ্যে একটি শেয়ার করা অ্যাকাউন্টের কোটা ন্যায্যভাবে ভাগ করে; কাজ-সংরক্ষণশীল হওয়ায় নিষ্ক্রিয় অংশগুলো অন্যদের ধার দেওয়া হয়। → [স্থিতিস্থাপকতা নির্দেশিকা](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 এক-কমান্ডে CLI/এজেন্ট সেটআপ** — 13টি নিবন্ধিত `setup-*` কমান্ড; `omniroute run` 7টি CLI (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/:` কম্বো, **Fusion** (মডেল প্যানেল + বিচারক), টাস্ক-সচেতন রাউটিং, প্রতি-অনুরোধে মডেল / মোড / USD-বাজেট ওভাররাইড। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ প্লাগযোগ্য কম্প্রেশন** — 12টি সমন্বয়যোগ্য ইঞ্জিন + Compression Studios: LLMLingua-2, দুই-স্তরের Ultra, omniglyph, প্রতি-ধাপের ফিডেলিটি গেট, GCF v3.2, ড্র্যাগ-রিঅর্ডার এডিটর। → [কম্প্রেশন](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ স্বচ্ছ MITM ডিক্রিপশন (TPROXY)** — প্রতি-SNI CA ও ট্রাস্ট-স্টোর ইনস্টলার ব্যবহার করে প্রক্সি env var উপেক্ষা করা CLI-গুলো ক্যাপচার করুন। → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 সর্বত্র খরচ টেলিমেট্রি** — প্রতিটি এন্ডপয়েন্টে `X-OmniRoute-*` খরচ/ব্যবহার হেডার, ক্যাশ-HIT সাশ্রয় হেডার এবং প্রতি-কিতে USD ব্যয়ের কোটা। → [API রেফারেন্স](docs/reference/API_REFERENCE.md)
- **🧠 আপনার নিয়ন্ত্রণাধীন মেমোরি** — ডিফল্টভাবে বন্ধ; অপ্ট-ইন int8 ভেক্টর কোয়ান্টাইজেশন + টাইপড ডিকে এবং প্রতি-অনুরোধে `x-omniroute-no-memory`। → [মেমোরি](docs/frameworks/MEMORY.md)
- **🛡️ নিরাপত্তা** — প্রতিটি LLM রুটে প্রম্পট-ইনজেকশন গার্ড (রেড-টিম স্যুট), অপ্ট-ইন ক্রেডেনশিয়াল-মাস্কিং গার্ডরেল (উভয় দিকে ফাঁস হওয়া API কি/সিক্রেট গোপন করে), বিনামূল্যের DuckDuckGo শেষ-অবলম্বন ওয়েব সার্চ এবং ড্যাশবোর্ডের জন্য ঐচ্ছিক OIDC লগইন গেট (পাসওয়ার্ড লগইন সবসময় উপলভ্য থাকে)। → [গার্ডরেল](docs/security/GUARDRAILS.md)
- **🖼️ নতুন এন্ডপয়েন্ট** — `/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)
- **🌍 ডিপ্লয়মেন্ট ও অপারেশন** — রিভার্স-প্রক্সি `basePath`, ব্রাউজারের ভাষা স্বয়ংক্রিয় শনাক্তকরণ, প্রতি-কিতে ডিভাইস ট্র্যাকিং, রুট-লেস MITM ট্রাস্ট, 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` হেডার থাকে; নতুন `cache-optimized` কম্বো কৌশল + Auto-Combo `cacheAffinity` ফ্যাক্টর পুনরাবৃত্ত অনুরোধকে ক্যাশ করা প্রিফিক্সধারী সংযোগে ফেরত পাঠায়; এবং শুধু-পঠনযোগ্য `/v1/auto-combo/{channel}/candidates` এন্ডপয়েন্ট একটি `auto/*` চ্যানেলের লাইভ প্রার্থী পুল প্রকাশ করে। → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ লোকাল পারফরম্যান্স ও অবকাঠামো** — এক-ক্লিকে লোকাল Redis, Cloudflare Workers / Deno Deploy রিলে ডিপ্লয়ার এবং তত্ত্বাবধানে থাকা এমবেডেড সার্ভিস হিসেবে Bifrost ও Mux। → [এমবেডেড সার্ভিস](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 সঙ্গে আরও যা আছে** — প্লাগইন ফ্রেমওয়ার্ক + মার্কেটপ্লেস, Omni/Agent/GitHub স্কিল ফ্রেমওয়ার্ক, Obsidian ভল্ট ইন্টিগ্রেশন (22টি MCP টুল), OpenAI-সামঞ্জস্যপূর্ণ Batch ও Files API, সেমান্টিক রেসপন্স ক্যাশ, লিডারবোর্ডসহ গেমিফিকেশন, ACP এজেন্ট ডিসকভারি (15টি বিল্ট-ইন এজেন্ট), BigQuery-তে নির্ধারিত লগ এক্সপোর্ট, `auto/chaos` ফল্ট ইনজেকশন, একটি Telegram বট ব্রিজ, ইন-অ্যাপ সংস্করণ ম্যানেজার এবং LMArena-ELO বিনামূল্যের-প্রোভাইডার র্যাঙ্কিং। → [ডকুমেন্টেশন](docs/README.md)
## 🤖 সামঞ্জস্যপূর্ণ CLI ও কোডিং এজেন্ট
> একটি কনফিগ — `http://localhost:20128/v1` — এবং **প্রতিটি** AI IDE বা CLI বিনামূল্যের ও কম খরচের মডেলে চলে।
📖 সব 36টি টুলের জন্য পৃথক সেটআপ (26টি CLI Code + 10টি CLI Agent) → [`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` আপনার shell history থেকে
গোপন তথ্য দূরে রাখে। → [CLI ইন্টিগ্রেশন](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 357টি AI প্রদানকারী — 152টি ক্যাটালগে বিনামূল্য হিসেবে চিহ্নিত
> ক্যানোনিকাল চ্যাট, মিডিয়া, সার্চ, লোকাল, ক্লাউড-এজেন্ট ও সিস্টেম সংগ্রহজুড়ে **357টি নিবন্ধিত প্রদানকারী**, যার মধ্যে **152টির ডিসকভারি মেটাডেটায় `hasFree: true` রয়েছে**। চ্যাট মডেল রেজিস্ট্রিতে রয়েছে **229টি প্রদানকারী / 2,554টি স্বতন্ত্র প্রদানকারী-মডেল জোড়া / 1,283টি অপরিশোধিত মডেল ID**; পৃথক বিনামূল্যের বাজেট ক্যাটালগে রয়েছে **প্রতি-মডেলের 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 ৫০টির বেশি মডেল প্রতিদিন ১০K নিউরন
NVIDIA NIM GLM, MiniMax বিনামূল্যে ~৪০ RPM
Cerebras GLM 4.7, GPT-OSS প্রতিদিন 1M টোকেন
OpenRouter :free মডেলসমূহ +$10 → আরও বেশি RPM
📖 সম্পূর্ণ মেশিন-পাঠযোগ্য ক্যাটালগ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute কোথায় চলে — যেকোনো জায়গায়
> একই অ্যাপ, আপনার মেশিন, আপনার নিয়ম। গ্লোবাল npm ইনস্টল থেকে শুরু করে Termux-এর মাধ্যমে **আপনার ফোনেও**।
প্ল্যাটফর্ম
ইনস্টল
বিশেষত্ব
📦 npm (গ্লোবাল)
npm install -g omniroute
একটি কমান্ড, যেকোনো OS
🐳 Docker
docker run … diegosouzapw/omniroute
মাল্টি-আর্ক AMD64 + ARM64
🖥️ ডেস্কটপ (Electron)
npm run electron:build
নেটিভ উইন্ডো + সিস্টেম ট্রে — Windows / macOS / Linux
🎩 মেনু-বার (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
সার্ভার তত্ত্বাবধান ও স্বয়ংক্রিয়ভাবে আপডেট করে — macOS
💪 ARM
নেটিভ arm64
Raspberry Pi, ARM সার্ভার, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
আপনার ফোনে চলে, ২৪/৭, root ছাড়াই
📲 PWA
"হোম স্ক্রিনে যোগ করুন"
ফুলস্ক্রিন, অফলাইন, ব্রাউজার থেকে ইনস্টলযোগ্য
🧩 OpenCode প্লাগইন
@omniroute/opencode-provider
নেটিভ OpenCode ইন্টিগ্রেশন
🤖 VS Code Copilot Chat
OmniCopilot এক্সটেনশন ইনস্টল করুন
নেটিভ Copilot Chat পিকারে OmniRoute-এর প্রতিটি মডেল — stable ও 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 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 সেশন/সাপ্তাহিক সীমা, ৩০ দিনের খরচের বিস্তারিত
লগইনের সময় ঐচ্ছিকভাবে চালু; শুধু ট্রে, কোনো dock আইকন নেই
🩺 ডক্টর ও লগ
এক ক্লিকে ডায়াগনস্টিক ও সার্ভার লগে প্রবেশাধিকার
```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 নিয়ন্ত্রণ করবে
**MCP**, **A2A**, একটি **REST API**, **webhooks** অথবা একটি **রিমোট CLI**-এর মাধ্যমে OmniRoute উন্মুক্ত করুন—যেকোনো সক্ষম এজেন্ট (অথবা আপনার নিজস্ব কোড) সম্পূর্ণ গেটওয়ের নিয়ন্ত্রণ পাবে: রাউটিং, প্রোভাইডার, কম্বো, ক্যাশ, কম্প্রেশন, মেমরি—সবই স্বয়ংক্রিয়ভাবে। নিচের HTTP এন্ডপয়েন্টগুলো `http://localhost:20128`-এর অধীনে পরিবেশিত হয়।
ইন্টারফেস
এন্ডপয়েন্ট / কমান্ড
যে কাজে ব্যবহার করবেন
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor অথবা যেকোনো MCP ক্লায়েন্টে সংযুক্ত করুন
### 📖 এটি যেভাবে কাজ করে — পাইপলাইন, আর্কিটেকচার ও সাশ্রয়ের হিসাব
ডিফল্ট স্ট্যাকড কম্বো `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%
```
কোড ব্লক, URL, 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
বড় ব্লকগুলো রিট্রিভ মার্কারের পেছনে আর্কাইভ করে, প্রয়োজনমতো সেগুলো আনা হয়
সরাসরি Anthropic সংযোগে পরিমাপকৃত Claude Fable 5-এর জন্য পরীক্ষামূলক কনটেক্সট-অ্যাজ-ইমেজ এনকোডিং; প্রোভাইডার রসিদ না পাওয়া পর্যন্ত GPT 5.6 ট্রান্সফরমারগুলো ফেইল-ক্লোজড থাকে। চারটি কম্প্রেশন প্রোফাইল (ডিফল্ট হিসেবে অ্যাগ্রেসিভ, ব্যালান্সড, কোডিং-সেফ, পাসথ্রু) (সবচেয়ে অ্যাগ্রেসিভ; অপ্ট-ইন)
কোড ব্লক, URL এবং কাঠামোবদ্ধ ডেটা বাইট-নিখুঁতভাবে **সবসময় সংরক্ষিত** থাকে। **এক-ক্লিক প্রিসেটগুলো** ইঞ্জিনগুলোকে একত্র করে:
মোড
সাশ্রয়
যার জন্য সবচেয়ে উপযোগী
🪶 Lite
~15%
সর্বদা চালু রাখার মতো নিরাপদ ডিফল্ট
🪨 Standard (Caveman)
~30%
দৈনন্দিন কোডিং
⚡ Aggressive
~50%
দীর্ঘ, টুল-নির্ভর সেশন
🔥 Ultra
~75%
সর্বাধিক সাশ্রয়
🧰 RTK
60–90%
শেল/টেস্ট/বিল্ড/git আউটপুট
🔗 Stacked (RTK → Caveman)
78–95%
মিশ্র প্রম্পট + টুল লগ
**বাস্তব উদাহরণ — Standard মোড:**
> **আগে (69 টোকেন):** _"আপনার React কম্পোনেন্টটি সম্ভবত পুনরায় রেন্ডার হচ্ছে, কারণ আপনি প্রতিটি রেন্ডার চক্রে একটি নতুন অবজেক্ট রেফারেন্স তৈরি করছেন। আপনি যখন prop হিসেবে একটি ইনলাইন অবজেক্ট পাস করেন, তখন React-এর শ্যালো কম্প্যারিজন প্রতিবার সেটিকে আলাদা অবজেক্ট হিসেবে দেখে, যা পুনরায় রেন্ডার ট্রিগার করে। অবজেক্টটি মেমোইজ করতে useMemo ব্যবহার করার পরামর্শ দেব।"_
>
> **পরে (19 টোকেন):** _"প্রতি রেন্ডারে নতুন অবজেক্ট ref। ইনলাইন অবজেক্ট prop = নতুন ref = পুনরায় রেন্ডার। useMemo দিয়ে র্যাপ করুন।"_
>
> **একই উত্তর। 72% কম টোকেন। নির্ভুলতার কোনো ক্ষতি নেই।** ✅
**PT-BR উদাহরণ — [Troglodita](https://github.com/leninejunior/troglodita) মোড:**
> **আগে (42 টোকেন):** _"সমস্যাটি হলো, প্রতিটি রেন্ডার চক্রে একটি নতুন অবজেক্ট রেফারেন্স তৈরি হওয়ার কারণে কম্পোনেন্টটি পুনরায় রেন্ডার হচ্ছে। আমি `useMemo` ব্যবহারের পরামর্শ দেব।"_
>
> **পরে (12 টোকেন):** _"পুনরায় রেন্ডার: প্রতি চক্রে নতুন রেফারেন্স (ইনলাইন অবজেক্ট পুনর্নির্মিত)। `useMemo` ব্যবহার করুন।"_
>
> **একই উত্তর। ~70% কম টোকেন। প্রযুক্তিগত নির্ভুলতা অক্ষুণ্ণ।** ✅
### 🎚️ ইঞ্জিনগুলোর বাইরেও — আউটপুট স্টাইল, অভিযোজিত ডায়াল ও প্রতি-রিকোয়েস্ট নিয়ন্ত্রণ
উপরের 12টি ইঞ্জিন যা **ইনপুটে যায়** তা সংকুচিত করে। আরও তিনটি স্তর নির্ধারণ করে **কীভাবে**, **কখন**, এবং কী **আউটপুটে আসে**:
- **🪄 আউটপুট স্টাইল** _(আউটপুট-অক্ষ নির্দেশনা)_ — নির্ধারিত, ক্যাশ-নিরাপদ রেসপন্স-রূপদান নির্দেশনা যোগ করে; একাধিক একসঙ্গে ব্যবহারযোগ্য, প্রতিটি `lite` / `full` / `ultra` তীব্রতায়। একটি স্টাইল যোগ করতে রেজিস্ট্রিতে এক লাইনই যথেষ্ট:
- **সংক্ষিপ্ত গদ্য** — অপ্রয়োজনীয় কথা / আর্টিকেল / দ্বিধাসূচক ভাষা বাদ দেয়; প্রযুক্তিগত বিষয়বস্তু হুবহু রাখে।
- **কম কোড** — "অলস সিনিয়র ডেভেলপার" YAGNI: ক্ষুদ্রতম কার্যকর পরিবর্তন, অনুরোধ না-করা কোনো স্ক্যাফোল্ডিং নয়।
- **পনিটেইল (অলস সিনিয়র ডেভেলপার)** — YAGNI ধাপ ধরে এগিয়ে মূল কারণ ঠিক করে, ক্ষুদ্রতম কার্যকর diff দেয়।
- **আমার ADHD আছে (কাজ আগে)** — পরবর্তী কাজটি শুরুতে থাকে, ধাপগুলো নম্বরযুক্ত, একটি সুনির্দিষ্ট পরবর্তী পদক্ষেপ, কোনো ভূমিকা নয়।
- **সংক্ষিপ্ত CJK (文言)** — ধ্রুপদি-চীনা অতি-সংক্ষিপ্ত স্টাইল (`zh` লোকেলে সীমাবদ্ধ)।
- **🎯 অভিযোজিত কনটেক্সট-বাজেট** _(ডায়াল)_ — একটি মাত্র চালু/বন্ধ টোকেন সীমার বদলে, মডেলের কনটেক্সট উইন্ডোর মধ্যে **ফিট করাতে** যতটুকু প্রয়োজন, কেবল ততটুকুই সবচেয়ে সাশ্রয়ী ও সর্বনিম্ন-ক্ষতিসম্পন্ন ইঞ্জিনগুলো ধাপে ধাপে প্রয়োগ করে। নীতি: `reserve-output` (ডিফল্ট, মডেল-সচেতন) · `percentage` · `absolute`। মোড: `floor` (ফিট নিশ্চিত করে) · `replace-autotrigger` (আপনার স্পষ্ট পছন্দ অগ্রাধিকার পায়) · `off` (পুরোনো থ্রেশহোল্ড)।
- **🎛️ কোথায় কম্প্রেশন নির্ধারিত হয়** _(অগ্রাধিকার, উচ্চ → নিম্ন)_ — প্রতি-রিকোয়েস্ট `x-omniroute-compression` হেডার › রাউটিং-কম্বো ওভাররাইড › সক্রিয় নামযুক্ত প্রোফাইল › অভিযোজিত / স্বয়ংক্রিয় ট্রিগার › প্যানেলের ডিফল্ট › বন্ধ। প্রয়োগ করা পরিকল্পনাটি `X-OmniRoute-Compression: ; source=` রেসপন্স হেডারে ফিরে আসে।
টোকেন থ্রেশহোল্ড অনুযায়ী স্বয়ংক্রিয় ট্রিগার করুন, অভিযোজিত ডায়াল চালু করুন, একটি নামযুক্ত প্রোফাইল পিন করুন, প্রতি রিকোয়েস্টে একবারের জন্য সেট করুন, অথবা প্রতিটি রাউটিং কম্বোর জন্য একটি পাইপলাইন নির্ধারণ করুন — কাজের ধরনের সঙ্গে যেটি মানানসই। অপ্ট-ইন অফলাইন **মূল্যায়ন হারনেস** (`npm run eval:compression`) কোনো পরিবর্তন প্রয়োগের আগে পিন করা কর্পাসে বিশ্বস্ততা বনাম সাশ্রয়ের স্কোর নির্ধারণ করে।
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ দ্রুত শুরু
**1) ইনস্টল ও চালু করুন**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` বা peer-dep সতর্কতা দেখছেন? [এগুলো ক্ষতিকর নয়](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)।
ড্যাশবোর্ড `http://localhost:20128`-এ · API `http://localhost:20128/v1`-এ।
**2) একটি বিনামূল্যের প্রোভাইডার সংযুক্ত করুন (সাইনআপ ছাড়াই)**
ড্যাশবোর্ড → **প্রোভাইডার** → **Kiro AI** (বিনামূল্যের Claude, প্রতি অ্যাকাউন্টে ~50 ক্রেডিট/মাস) অথবা **OpenCode Free** (কোনো অথেন্টিকেশন নেই) সংযুক্ত করুন → সম্পন্ন।
**3) আপনার কোডিং টুল নির্দেশ করুন**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (zero-config smart routing — or any provider/model)
```
**4) এটি কাজ করছে কি না যাচাই করুন**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
তালিকায় আপনার সংযুক্ত মডেলগুলো দেখা উচিত। 🎉 এটুকুই — কোডিং শুরু করুন; OmniRoute স্বয়ংক্রিয়ভাবে আপনার জন্য রাউট করবে এবং প্রয়োজনে ফলব্যাক করবে।
আপনার ক্লায়েন্ট কাস্টম হেডার পাঠাতে না পারলে, OmniRoute টোকেনযুক্ত সামঞ্জস্যপূর্ণ অ্যালিয়াসও প্রদান করে:
```txt
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
শুধু সেইসব ক্লায়েন্টের জন্য এগুলো ব্যবহার করুন, যেগুলো `Authorization: Bearer ...` সংযুক্ত করতে পারে না। হেডার অথেন্টিকেশনই পছন্দের পদ্ধতি।
## 📦 আরও ইনস্টলেশন পদ্ধতি — Docker, সোর্স, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` সর্বোচ্চ **প্রকাশিত** স্থিতিশীল SemVer অনুসরণ করে। এটি git `main` অনুসরণ করে না। GitOps-এর জন্য `:X.Y.Z` পিন করুন। [Docker রিলিজ চ্যানেল](docs/guides/DOCKER_GUIDE.md#release-channels) দেখুন। ইমেজটি **`OMNIROUTE_MEMORY_MB=1024`** পিন করে। এটি ড্যাশবোর্ড এবং হালকা চ্যাটের জন্য যথেষ্ট। **কোডিং এজেন্টগুলোর** (Claude Code, Codex, Grok, … থেকে `POST /v1/responses`) আরও বড় V8 heap প্রয়োজন, নতুবা দুটি ওভারল্যাপিং দীর্ঘ কনটেক্সটের অধীনে প্রায় 12 GiB-এ প্রসেসটি `FATAL ERROR` দেয়। কনটেইনারের আকার heap-এর চেয়ে বেশি রাখুন (নেটিভ বাফারগুলো 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*`
> ব্রাঞ্চ অনুসরণ করে। এই পরিবর্তনশীল ট্যাগগুলো কেবল অপ্রকাশিত সংশোধন পরীক্ষা করার জন্য
> নির্ধারিত এবং **প্রোডাকশনে সমর্থিত নয়**। দেখুন
> [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 বান্ডলার নির্বাচন**: নেটিভ V8 বাইন্ডিংয়ের অসামঞ্জস্য প্রতিরোধ করতে ডেভেলপমেন্ট (`bun run dev`) স্বয়ংক্রিয়ভাবে Bun শনাক্ত করে এবং Webpack-এর পক্ষে Turbopack নিষ্ক্রিয় করে। প্রোডাকশন বিল্ড (`bun run build`) Node-এর মতোই `OMNIROUTE_USE_TURBOPACK` হুবহু অনুসরণ করে: ডিফল্টভাবে Turbopack, আর Webpack দিয়ে বিল্ড করতে `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` এটিকে `--build-arg` হিসেবে প্রকাশ করে)।
- **নিবেদিত Bun Dockerfile**: নেটিভ Bun প্রোডাকশন ডিপ্লয়মেন্টের জন্য মাল্টি-স্টেজ `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 প্রোফাইল, Caddy HTTPS, Cloudflare টানেল।
**🦭 Podman**
```bash
# ১. bind-mounted ডেটা ডিরেক্টরি প্রস্তুত করুন
mkdir -p data
# ২. কেবল Linux + স্থানীয় rootless Podman-এর জন্য (কখনোই কোনো রিমোট Podman Machine ক্লায়েন্টে নয়):
podman unshare chown 1000:1000 ./data
# ৩. রানটাইম হিন্ট সেট করুন, স্থানীয় Compose ইমেজ বিল্ড করুন এবং চালু করুন
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
macOS বা Windows-এ Podman একটি রিমোট Podman Machine ব্যবহার করে: `podman unshare` এড়িয়ে যান এবং
[টপোলজি-নির্দিষ্ট ডেটা ডিরেক্টরির নির্দেশনা](contrib/podman/README.md#data-directory-permissions-by-topology) অনুসরণ করুন।
📖 [Podman নির্দেশিকা](contrib/podman/README.md) — Compose বিল্ড, Podman Machine এবং
Linux/systemd Quadlet সেটআপ।
**⚡ দ্রুততর / হালকা ইনস্টলেশন (নেটিভ বিল্ড এড়িয়ে যান)**
নেটিভ SQLite ইঞ্জিন (`better-sqlite3`) একটি **ঐচ্ছিক** ডিপেন্ডেন্সি, তাই কোনো গ্লোবাল
ইনস্টলেশন কখনোই সোর্স থেকে কম্পাইল হওয়ার অপেক্ষায় আটকে থাকে না: আপনার প্ল্যাটফর্ম/Node-এর সঙ্গে মিলে গেলে এটি
একটি প্রি-বিল্ট বাইনারি ব্যবহার করে, অন্যথায় স্বচ্ছভাবে একটি বিশুদ্ধ-JS ইঞ্জিনে ফলব্যাক করে
(Node 22+-এ `node:sqlite`, নতুবা বান্ডেল করা `sql.js` WASM) — কোনো বিল্ড টুলের প্রয়োজন নেই।
ইনস্টলেশনের পরের নেটিভ ওয়ার্ম-আপ সম্পূর্ণ এড়িয়ে যেতে (CI, headless বা ধীরগতির মেশিনে):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1-ও এটি এড়িয়ে যায়
```
দ্রুততম ইনস্টলেশনের জন্য **pnpm** বেছে নিন (কনটেন্ট-অ্যাড্রেসড স্টোর + হার্ড লিংক — উপরে দেখুন)।
ড্যাশবোর্ডবিহীন headless রানটাইমের জন্য Docker `base` প্রোফাইল (উপরে) অথবা
[Termux নির্দেশিকা](docs/guides/TERMUX_GUIDE.md) ব্যবহার করুন। CLI এবং ওয়েব ড্যাশবোর্ড একই প্রসেস থেকে একই
পোর্টে পরিবেশিত হয়, তাই বর্তমানে আলাদা কোনো কেবল-CLI প্যাকেজ নেই।
5,100টির বেশি ট্র্যাক করা টেস্ট ফাইলজুড়ে 39,000টির বেশি স্ট্যাটিক টেস্ট ঘোষণার জন্য টেস্ট কভারেজ কৌশল
# ⭐ শীর্ষ অবদানকারীরা
> OmniRoute একটি নিবেদিতপ্রাণ ওপেন-সোর্স কমিউনিটির হাতে গড়ে উঠেছে। এই ব্যক্তিরা অসাধারণ অবদান রেখেছেন, যা প্রকল্পটির গুণমান, স্থিতিশীলতা ও প্রসারে সরাসরি প্রভাব ফেলেছে। **ধন্যবাদ।**
### মার্জ করা pull request অনুযায়ী বহিরাগত অবদানকারীরা
2026-08-24 05:26:03 UTC পর্যন্ত মার্জসহ সক্রিয় release/v3.8.50-এর সর্বশেষ অবস্থান dafb4ae808-এ তথ্য স্থির করা হয়েছে। পৃষ্ঠাবিন্যস্ত GitHub GraphQL গণনায় 5,911টি মার্জ করা PR রয়েছে: রিপোজিটরি মালিকের 2,707টি, Dependabot-এর 179টি এবং 535 জন স্বতন্ত্র অবদানকারীর 3,025টি বহিরাগত PR। “পরিবর্তিত লাইন” হলো GitHub-এর সংযোজন + অপসারণ এবং এতে জেনারেট করা ফাইল, lockfile, catalog, অনুবাদ ও নথিপত্র অন্তর্ভুক্ত রয়েছে; এটি পরিবর্তনের পরিমাণ, রচিত LOC নয়। সীমারেখায় সমান অবস্থানগুলো রাখা হয়েছে।
### GitHub-এ আরোপিত commitসমূহ
2026-08-24 06:14:31 UTC-এ পুনরায় যাচাই করা হয়েছে: ডিফল্ট শাখা release/v3.8.50-এর জন্য রিপোজিটরির Contributors API দ্বারা প্রতিবেদন করা GitHub-এ আরোপিত কমিট। API 525টি পরিচয় ফেরত দিয়েছে (415 জন ব্যবহারকারী, 2টি বট, 108টি বেনামী); এই সারণিতে রক্ষণাবেক্ষণকারী, বট ও বেনামী পরিচয়গুলো বাদ দেওয়া হয়েছে এবং যৌথ অবস্থান বজায় রাখা হয়েছে। এটি উপরের মার্জ করা PR-এর র্যাঙ্কিং এবং নিচের 639-ব্যক্তির Git-মেটাডেটা আদমশুমারি—উভয় থেকেই স্বতন্ত্র।
> 🙏 এই অবদানকারীদের ফিচার, বাগ সংশোধন এবং অবকাঠামোগত উন্নতিগুলো OmniRoute-কে নির্ভরযোগ্য ও ফিচারসমৃদ্ধ করে তোলার একটি **মূল অংশ**। প্রতিটি পুল রিকোয়েস্ট, প্রতিটি টেস্ট কেস এবং প্রতিটি i18n অনুবাদ ফাইল গুরুত্বপূর্ণ। তাদের মতো মানুষদের হাতেই ওপেন সোর্স নির্মিত হয়।
---
## 💖 স্পনসরগণ
যাঁরা নিজেদের অর্থে OmniRoute-কে সহায়তা করেন, তাঁদের প্রতি আন্তরিক কৃতজ্ঞতা — প্রতিটি অবদান প্রকল্পটিকে বিনামূল্যে, স্বাধীন এবং সচল রাখে।
… এবং অন্যরা, যাঁরা ব্যক্তিগত থাকতে পছন্দ করেন 💛সর্বজনীন GitHub Sponsors-দের তথ্য 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` ব্রাঞ্চ** দিয়ে একটি Pull Request খুলুন
বিস্তারিত নির্দেশিকার জন্য [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)**-এর একটি fork এবং Go প্রকল্প **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**-এর একটি TypeScript port হিসেবে যাত্রা শুরু করেছিল — আর সেখান থেকে নিচের প্রতিটি subsystem এমন কোনো open-source প্রকল্প থেকে অনুপ্রাণিত হয়েছে, যা আগে সেই পথ দেখিয়েছিল। প্রতিটি প্রকল্পই OmniRoute-এর একটি নির্দিষ্ট অংশকে রূপ দিয়েছে। তাদের সকলের প্রতি এটি আমাদের কৃতজ্ঞতা। 🙏
> ⭐ ২৪ আগস্ট, ২০২৬ তারিখে GitHub-এর REST API থেকে star-এর সংখ্যা যাচাই করা হয়েছে — এগিয়ে যান এবং এই প্রকল্পগুলোকে একটি করে star দিন। সংখ্যাগুলো নির্দিষ্ট তারিখের হুবহু snapshot এবং স্বাভাবিকভাবেই পরিবর্তিত হবে।
### 🧬 বংশধারা ও gateway
সেই AI gateway, যার সর্বজনীন pricing dataset আমাদের cost-tracking sync-এ তথ্য সরবরাহ করে এবং যার provider-normalization model আমাদের routing-কে প্রভাবিত করেছে।
MIT source-কে অন্তর্ভুক্ত ChatGPT Web → Codex Responses bridge-এ অভিযোজিত করা হয়েছে, যার মধ্যে browser-session, response-framing, usage এবং web-search adapter রয়েছে।
এর Grok model mapping, নকল-TypeError Statsig generator, request ও device default এবং NDJSON response processor-কে উল্লেখযোগ্যভাবে OmniRoute-এর Grok Web executor-এ অভিযোজিত করা হয়েছে।
grok2api-merged-এর পেছনের প্রধান transitive code source; এর model, header, payload, Statsig এবং processor বাস্তবায়ন Grok Web-এর lineage-এ সংরক্ষিত আছে।
এর proxy-pool layer-এর জন্য grok2api-merged কর্তৃক স্বীকৃত একটি transitive source; OmniRoute সেই lineage notice সংরক্ষণ করে, তবে এর সীমাবদ্ধ Grok Web executor-এ কোনো proxy-pool port করার দাবি করে না।
মূল Grok Web বাস্তবায়নে এর HTTP/browser upstream design বিবেচনা করা হয়েছিল; এর সরাসরি HTTP path GrokProxy থেকে উদ্ভূত, তাই কোনো স্বতন্ত্র code port করার দাবি করা হয় না।
ভাইরাল "অনেক টোকেন কেন ব্যবহার, যখন অল্প টোকেনেই কাজ হয়" প্রকল্পটি — এর গুহামানবসুলভ ভাষার দর্শন আমাদের স্ট্যান্ডার্ড কম্প্রেশন মোড এবং ৩০টিরও বেশি অপ্রয়োজনীয় শব্দ অপসারণ/সংকোচন নিয়মকে চালিত করে।
PT-BR টোকেন কম্প্রেশন — আমাদের pt-BR ভাষা প্যাককে চালিত করে: ব্রাজিলীয়-পর্তুগিজ ব্যাকরণের উপযোগী করে টিউন করা অতিরিক্ত পুনরুক্তি হ্রাস এবং অপ্রয়োজনীয় শব্দ অপসারণ।
ব্যর্থতা-সচেতনভাবে সরে আসার সুবিধাসহ কনটেন্ট-সচেতন, প্রতি-ফাইল-টাইপ আউটপুট কম্প্রেশন — আমাদের প্রতি-টাইপ ডিসপ্যাচ এবং ন্যূনতম-লাভে এড়িয়ে যাওয়ার নীতিকে সমর্থন করেছে।
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)।
> সরাসরি `/dashboard/free-tiers` পৃষ্ঠার অ্যানিমেটেড সারসংক্ষেপ। সম্পূর্ণ পদ্ধতি (পুল ডিডুপ্লিকেশন, ক্রেডিট টিয়ার, প্রদানকারীর শর্তাবলি): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**।
>
> এই পরিসংখ্যানগুলো প্রতি দুই সপ্তাহে সরাসরি ক্যাটালগের সঙ্গে পুনরায় নিরীক্ষা করা হয় এবং **দুই দিকেই পরিবর্তিত হয়** — কোনো প্রদানকারী একটি ফ্রি টিয়ার বন্ধ করলে সংখ্যাটি কমে যায়; নতুন একটি যুক্ত হলে তা বাড়ে। ক্যাটালগ প্রকৃতপক্ষে যা গণনা করে, আমরা সেটিই প্রকাশ করি—কখনোই ঊর্ধ্বমুখী রাউন্ড করা সর্বোত্তম সম্ভাব্য সংখ্যা নয়।
```bash
# Fresh install, zero credentials — `auto` already works:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
নির্দিষ্ট কোনো ফ্রি ব্যাকএন্ড পছন্দ করেন? সরাসরি `oc/…` (OpenCode Free) কল করুন। এরপর `auto`-তে রূপান্তর করুন এবং OmniRoute-কে বেছে নিতে দিন।
📦 **Python, Node.js, PHP এবং cURL**-এর জন্য কপি-পেস্ট কুইকস্টার্ট স্ক্রিপ্টসমূহ → [`examples/quickstart/`](examples/quickstart/)
> একটি **কম্বো** হলো মডেলের এমন একটি শৃঙ্খল, যার মধ্য দিয়ে OmniRoute **স্বয়ংক্রিয়ভাবে** রাউট করে। কোটা শেষ হয়ে গেলে, কোনো প্রোভাইডার ব্যর্থ হলে, অথবা খরচ হঠাৎ বেড়ে গেলে, কম্বোটি পরবর্তী উপযুক্ত ও সচল মডেলে চলে যেতে পারে। 🛡️
### ⚡ কোনো কনফিগারেশন নয় — শুধু `auto` ব্যবহার করুন
কোনো কম্বো তৈরি করতে হবে না। আপনার মডেলটি `auto` (অথবা এর কোনো ভ্যারিয়েন্ট) হিসেবে সেট করুন, আর OmniRoute আপনার সংযুক্ত প্রোভাইডারগুলো থেকে একটি ভার্চুয়াল কম্বো তৈরি করবে, যার স্কোর সরাসরি হালনাগাদ হয়:
📖 [অটো-কম্বো ইঞ্জিন](docs/routing/AUTO-COMBO.md) · [স্থিতিস্থাপকতা নির্দেশিকা](docs/architecture/RESILIENCE_GUIDE.md)
📊 সম্পূর্ণ পদ্ধতি এবং 9router, OpenRouter, CLIProxyAPI ও LiteLLM-এর সাথে প্রতি-ফিচার বিবরণ → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
কী (এলোমেলো): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix কপি-পেস্ট:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [অনুমোদন](docs/architecture/AUTHZ_GUIDE.md) · [সুরক্ষাব্যবস্থা](docs/security/GUARDRAILS.md) · [কমপ্লায়েন্স](docs/security/COMPLIANCE.md)
ডিফল্ট স্ট্যাকড কম্বো `RTK → Caveman` চালায়। উভয়ই একই টুল/কনটেক্সট পেলোডে কাজ করলে, সাশ্রয় চক্রবৃদ্ধি হারে বাড়ে:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
কোড ব্লক, URL, 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-ইঞ্জিনের স্ট্যাক
ইঞ্জিনগুলো পাইপলাইনের ক্রমানুসারে চলে; প্রতিটিকে আলাদাভাবে চালু বা বন্ধ করা এবং প্রতিটি কম্বোর জন্য কনফিগার করা যায়:
