## 💰 তৃতীয়-পক্ষের ফ্রি টিয়ারগুলো মিলিয়ে প্রতি মাসে ~1.62B টোকেন
> **আপনার নিজস্ব প্রোভাইডার অ্যাকাউন্ট ব্যবহার করুন।** এটি পৃথকভাবে যোগ্য তৃতীয়-পক্ষের ফ্রি টিয়ারগুলোর আনুমানিক সমষ্টি, OmniRoute-এর দেওয়া কোনো টোকেন অনুদান নয়। সাইন আপ করুন, যেখানে প্রয়োজন সেখানে ক্রেডেনশিয়াল সংগ্রহ করুন এবং আপনি যেসব প্রোভাইডার ব্যবহার করতে পারেন সেগুলো সংযুক্ত করুন; প্রতিটি প্রোভাইডার তার নিজস্ব সীমা, প্রাপ্যতা ও শর্তাবলি নিয়ন্ত্রণ করে।
>
> হাতে হাতে ফ্রি টিয়ার একত্র করা কষ্টসাধ্য — কয়েক ডজন 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
# একটি প্রোভাইডার সংযুক্ত করার পর, Dashboard → Endpoints থেকে আপনার OmniRoute কী কপি করুন:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto`-এর জন্য একটি যোগ্য রুট প্রয়োজন। নতুন ইনস্টলেশনে কোনো যোগ্য কী-বিহীন টার্গেট নাও থাকতে পারে এবং কোনো কী-বিহীন প্রোভাইডার তৃতীয়-পক্ষের ক্লায়েন্ট প্রত্যাখ্যান করতে পারে। OpenCode Free এবং Kiro-সহ `tos: avoid` হিসেবে চিহ্নিত প্রোভাইডারগুলো ডিফল্টভাবে স্বয়ংক্রিয় রাউটিং থেকে বাদ থাকে; একটি অ্যাকাউন্ট সংযুক্ত করলে সেই সেটিং ওভাররাইড হয় না। কোনো প্রোভাইডার বেছে নেওয়ার আগে [ফ্রি টিয়ার নির্দেশিকা](docs/getting-started/FREE-TIERS-GUIDE.md) দেখুন।📦 **Python, Node.js, PHP এবং cURL**-এর জন্য কপি-পেস্টযোগ্য কুইকস্টার্ট স্ক্রিপ্ট → [`examples/quickstart/`](examples/quickstart/)
# 💥 প্রতিশ্রুতি
# 🤔 কেন OmniRoute?
## 🤝 আমাদের ওপেন সোর্স বন্ধুদের সহায়তায়
> **ওপেন সোর্স বন্ধু হিসেবে যোগ দিতে চান?** এই প্রতিষ্ঠানগুলো ওপেন সোর্সকে সমর্থন করে এবং OmniRoute-কে এগিয়ে যেতে সহায়তা করে — আর তাদের দেওয়া প্রতিটি টোকেন কোথায় ব্যয় হয়, তা আমরা প্রকাশ্যে জানাই। যোগাযোগ করুন: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
এই প্রকল্পকে সমর্থন করার জন্য আমাদের প্রতিষ্ঠাতা ওপেন সোর্স বন্ধু Kimi (Moonshot AI)-কে ধন্যবাদ! Kimi হলো ওপেন-ওয়েট 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 আপনার সংযুক্ত প্রোভাইডারগুলো থেকে একটি ভার্চুয়াল কম্বো তৈরি করবে, যার স্কোর সরাসরি নির্ধারিত হয়:
🔭 গুণমান প্রথমে + আরও ভালো মডেল খুঁজে পেতে 10% অনুসন্ধান
auto/lkgp
📌 সর্বশেষ-জ্ঞাত-কার্যকর-প্রোভাইডারের প্রতি সুস্পষ্ট স্থায়ী আনুগত্য
auto/chaos
🧪 মডেলের একটি প্যানেলে সমান্তরাল ফ্যান-আউট (প্রতি প্রোভাইডারে একটি, ডিফল্টভাবে 5টি), একটি উত্তর ফেরত দেয়; প্রতি প্যানেল মডেলের জন্য একটি আপস্ট্রিম কল, ফল্ট ইনজেকশন নয়
##
### 🔀 অথবা নিজেরটি তৈরি করুন — 19টি রাউটিং কৌশল
সব **19টি** কৌশল — প্রতিটি কম্বো ধাপে মিশিয়ে ও মিলিয়ে ব্যবহার করুন:
#
কৌশল
এটি যা করে
1
priority
প্রথম-টার্গেটভিত্তিক ক্রমবদ্ধ তালিকা — পরবর্তীটিতে যাওয়ার আগে প্রতিটিকে নিঃশেষ করুন 🥇
2
fill-first
পরবর্তীটিতে যাওয়ার আগে প্রতিটি টার্গেটের কোটা পুরোপুরি পূরণ করুন
3
weighted
প্রতি-টার্গেট ওজন অনুযায়ী ওজনযুক্ত র্যান্ডম নির্বাচন
4
round-robin
ক্রম অনুযায়ী টার্গেটগুলোর মধ্যে চক্রাকারে নির্বাচন
5
p2c
পাওয়ার-অব-টু-চয়েসেস র্যান্ডম লোড ব্যালান্সিং
6
least-used
বর্তমানে সর্বনিম্ন লোড থাকা টার্গেটটি বেছে নিন
7
random
সমবণ্টিত র্যান্ডম নির্বাচন (ডিডুপ্লিকেট করা)
8
strict-random
পুনরাবৃত্তি ডিডুপ্লিকেট না করে র্যান্ডম নির্বাচন 🎲
9
cost-optimized
লাইভ ক্যাটালগের মূল্য অনুযায়ী প্রতি অনুরোধের $ খরচ সর্বনিম্ন করুন 💸
10
headroom
সবচেয়ে বেশি অবশিষ্ট কোটা থাকা টার্গেটটি বেছে নিন
11
reset-window
যে টার্গেটের কোটা উইন্ডো সবচেয়ে আগে রিসেট হবে সেটিকে অগ্রাধিকার দিন
12
reset-aware
কোটা রিসেটের সময় অনুযায়ী র্যাঙ্ক করুন — ছোট উইন্ডো প্রথমে 📊
13
context-relay
দীর্ঘ কথোপকথনের জন্য টার্গেটগুলোর মধ্যে কনটেক্সট হস্তান্তর করুন 🧠
14
context-optimized
বর্তমান কনটেক্সটের আকারের জন্য সবচেয়ে উপযুক্তটি বেছে নিন
15
cache-optimized
পুনর্ব্যবহারযোগ্য প্রতিটি প্রম্পট প্রিফিক্সকে একই অ্যাকাউন্টে পিন করুন — প্রম্পট-ক্যাশ হিট সর্বাধিক করুন 🎯
16
lkgp
সর্বশেষ-জ্ঞাত-কার্যকর পাথ — সর্বশেষ সফল প্রোভাইডারে পিন করে, তারপর নিয়ম অনুযায়ী ফলব্যাক করে
17
auto
প্রতিটি সংযোগজুড়ে 16টি ফ্যাক্টরের লাইভ স্কোরিং 🤖
18
fusion
মডেলের একটি প্যানেলে ফ্যান-আউট করে + একজন বিচারক একটি উত্তর সংশ্লেষ করে 🧬
19
pipeline
ধাপগুলো শৃঙ্খলিত করুন — প্রতিটি টার্গেটের আউটপুট পরবর্তীটিতে প্রবেশ করে 🔗
Auto-Combo ইঞ্জিন প্রতিটি প্রার্থীকে **16টি ফ্যাক্টরের** (স্বাস্থ্য, কোটা, খরচ, ল্যাটেন্সি, কাজের উপযোগিতা, গুণমান, সেশনের প্রাপ্যতা…) ভিত্তিতে স্কোর করে — দেখুন [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)।
##
### 🧱 স্থিতিস্থাপকতা অন্তর্নির্মিত (3টি স্বাধীন স্তর)
📖 [অটো-কম্বো ইঞ্জিন](docs/routing/AUTO-COMBO.md) · [স্থিতিস্থাপকতা নির্দেশিকা](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute-কে যা অনন্য করে তোলে
📊 9router, OpenRouter, CLIProxyAPI & LiteLLM-এর সঙ্গে তুলনার সম্পূর্ণ পদ্ধতি & প্রতিটি ফিচারের বিস্তারিত → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRoute-কে সহায়তা করুন
OmniRoute MIT লাইসেন্সপ্রাপ্ত এবং উন্মুক্তভাবে রক্ষণাবেক্ষণ করা হয়। এটি যদি আপনার সময় বা অর্থ সাশ্রয় করে, তবে একে স্বাধীন রাখতে যেটি আপনার জন্য উপযুক্ত সেটি বেছে নিন। স্পনসরশিপ কখনোই রাউটিং অগ্রাধিকারকে প্রভাবিত করে না; এটি দৃশ্যমানতা দেয়, র্যাঙ্কিং নয়।
⭐ রেপোতে স্টার দিন
বিনামূল্যে — দৃশ্যমানতা বাড়াতে সত্যিই সাহায্য করে
⚠️ প্রতিটি কয়েন শুধু দেখানো নেটওয়ার্কেই পাঠান — ভুল নেটওয়ার্কে পাঠালে অর্থ হারিয়ে যেতে পারে।
🐛 কোনো বাগ পেয়েছেন বা মতামত আছে? একটি [আলোচনা](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 ও ট্রাস্ট-স্টোর ইনস্টলারসহ প্রক্সি এনভায়রনমেন্ট ভেরিয়েবল উপেক্ষা করা 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)
## 🌐 372টি AI প্রদানকারী — 154টি ক্যাটালগে বিনামূল্য হিসেবে চিহ্নিত
> ক্যানোনিক্যাল চ্যাট, মিডিয়া, সার্চ, লোকাল, ক্লাউড-এজেন্ট ও সিস্টেম সংগ্রহজুড়ে **372টি নিবন্ধিত প্রদানকারী**, যার মধ্যে **154টির ডিসকভারি মেটাডেটায় `hasFree: true` রয়েছে**। চ্যাট মডেল রেজিস্ট্রিতে রয়েছে **237টি প্রদানকারী / 3,009টি স্বতন্ত্র প্রদানকারী-মডেল জোড়া / 1,443টি অপরিশোধিত মডেল 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 কোনো কী প্রয়োজন নেই
### 🧩 নতুন: 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-এর কম্প্রেশন পাইপলাইনের মধ্য দিয়ে **স্বচ্ছভাবে** যায় — ক্লায়েন্টে কোনো পরিবর্তনের প্রয়োজন নেই। এটি এখন **১২টি সমন্বয়যোগ্য ইঞ্জিনের একটি স্ট্যাক**, যেগুলো ক্রমানুসারে চলে এবং প্রতিটি রাউটিং কম্বো অনুযায়ী মিলিয়ে ব্যবহার করা যায় — [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)-এর ধারণার ওপর ভিত্তি করে তৈরি।
### 🧱 ১২-ইঞ্জিনের স্ট্যাক
ইঞ্জিনগুলো পাইপলাইনের ক্রমানুসারে চলে; প্রতিটি ইঞ্জিন আলাদাভাবে চালু বা বন্ধ করা এবং প্রতিটি কম্বোর জন্য কনফিগার করা যায়:
#
ইঞ্জিন
এটি যা করে
1
Session-Dedup
বিভিন্ন টার্নে পুনরাবৃত্ত কনটেন্ট বাদ দেয় (কনটেন্ট-অ্যাড্রেসড, ক্রস-টার্ন)
2
CCR
বড় ব্লকগুলোকে রিট্রিভ মার্কারের আড়ালে আর্কাইভ করে, প্রয়োজন অনুযায়ী সেগুলো আনা হয়
সরাসরি Anthropic সংযোগে পরিমাপকৃত Claude Fable 5-এর জন্য পরীক্ষামূলক কনটেক্সট-অ্যাজ-ইমেজ এনকোডিং; প্রোভাইডার রসিদ না পাওয়া পর্যন্ত GPT 5.6 ট্রান্সফরমারগুলো ফেইল-ক্লোজড থাকে। চারটি কম্প্রেশন প্রোফাইল (ডিফল্ট aggressive, balanced, coding-safe, passthrough) (সবচেয়ে আক্রমণাত্মক; অপ্ট-ইন)
কোড ব্লক, URL এবং স্ট্রাকচার্ড ডেটা বাইট-নিখুঁতভাবে **সর্বদা সংরক্ষিত** থাকে। **এক-ক্লিক প্রিসেটগুলো** ইঞ্জিনগুলোকে একত্র করে:
মোড
সাশ্রয়
যার জন্য সবচেয়ে উপযুক্ত
🪶 Lite
~15%
সর্বদা চালু রাখার নিরাপদ ডিফল্ট
🪨 Standard (Caveman)
~30%
দৈনন্দিন কোডিং
⚡ Aggressive
~50%
দীর্ঘ, টুল-নির্ভর সেশন
🔥 Ultra
~75%
সর্বোচ্চ সাশ্রয়
🧰 RTK
60–90%
শেল/টেস্ট/বিল্ড/git আউটপুট
🔗 Stacked (RTK → Caveman)
78–95%
মিশ্র প্রম্পট + টুল লগ
**বাস্তব উদাহরণ — Standard মোড:**
> **আগে (৬৯ টোকেন):** _"আপনার React কম্পোনেন্টটি পুনরায় রেন্ডার হওয়ার সম্ভাব্য কারণ হলো, প্রতিটি রেন্ডার সাইকেলে আপনি একটি নতুন অবজেক্ট রেফারেন্স তৈরি করছেন। আপনি যখন prop হিসেবে একটি ইনলাইন অবজেক্ট পাঠান, তখন React-এর শ্যালো কম্পারিজন প্রতিবার সেটিকে আলাদা অবজেক্ট হিসেবে দেখে, যা পুনরায় রেন্ডার শুরু করে। অবজেক্টটি মেমোয়াইজ করতে আমি useMemo ব্যবহারের পরামর্শ দেব।"_
>
> **পরে (১৯ টোকেন):** _"প্রতি রেন্ডারে নতুন অবজেক্ট ref। ইনলাইন অবজেক্ট prop = নতুন ref = পুনরায় রেন্ডার। useMemo দিয়ে র্যাপ করুন।"_
>
> **একই উত্তর। ৭২% কম টোকেন। নির্ভুলতার কোনো ক্ষতি নেই।** ✅
**PT-BR উদাহরণ — [Troglodita](https://github.com/leninejunior/troglodita) মোড:**
> **আগে (42 tokens):** _"সমস্যাটি হলো, কম্পোনেন্টটি পুনরায় রেন্ডার হচ্ছে কারণ প্রতিটি রেন্ডারিং চক্রে একটি নতুন অবজেক্ট রেফারেন্স তৈরি হচ্ছে। আমি useMemo ব্যবহারের পরামর্শ দেব।"_
>
> **পরে (12 tokens):** _"পুনরায় রেন্ডার: প্রতি চক্রে নতুন ref (inline অবজেক্ট পুনরায় তৈরি)। `useMemo` ব্যবহার করুন।"_
>
> **একই উত্তর। ~70% কম tokens। প্রযুক্তিগত নির্ভুলতা অক্ষুণ্ণ।** ✅
### 🎚️ ইঞ্জিনগুলোর বাইরে — আউটপুট স্টাইল, অভিযোজিত ডায়াল ও প্রতি-রিকোয়েস্ট নিয়ন্ত্রণ
উপরের 12টি ইঞ্জিন যা **ভেতরে যায়** তা সংকুচিত করে। আরও তিনটি স্তর **কীভাবে**, **কখন**, এবং কী **বেরিয়ে আসে** তা নির্ধারণ করে:
- **🪄 আউটপুট স্টাইল** _(আউটপুট-অক্ষ নিয়ন্ত্রণ)_ — নির্ধারিত ও cache-safe প্রতিক্রিয়া-আকৃতিদানকারী নির্দেশনা প্রবেশ করায়; একত্রে ব্যবহারযোগ্য, প্রতিটি `lite` / `full` / `ultra` তীব্রতায়। একটি স্টাইল যোগ করতে registry-তে এক লাইন যোগ করলেই হয়:
- **সংক্ষিপ্ত গদ্য** — অপ্রয়োজনীয় কথা / article / দ্বিধাসূচক ভাষা বাদ দেয়; প্রযুক্তিগত বিষয়বস্তু হুবহু রাখে।
- **কম কোড** — "অলস সিনিয়র ডেভেলপার" YAGNI: সবচেয়ে ছোট কার্যকর পরিবর্তন, অনুরোধ না করা scaffolding নয়।
- **Ponytail (অলস সিনিয়র ডেভেলপার)** — YAGNI-এর ধাপ বেয়ে এগোয়, মূল কারণ সমাধান করে, সবচেয়ে ছোট কার্যকর diff দেয়।
- **আমার ADHD আছে (কাজ-আগে)** — পরবর্তী কাজটি আগে আসে, ধাপগুলো নম্বরযুক্ত, একটি সুনির্দিষ্ট পরবর্তী পদক্ষেপ, কোনো ভূমিকা নয়।
- **সংক্ষিপ্ত CJK (文言)** — ধ্রুপদি-চীনা অতি-সংক্ষিপ্ত স্টাইল (`zh` locale-এর জন্য সীমাবদ্ধ)।
- **🎯 অভিযোজিত context-budget** _(ডায়াল)_ — একটি on/off token threshold-এর বদলে, মডেলের context window-তে **মানানসই করার** জন্য যতটুকু দরকার ততটুকুই সবচেয়ে সাশ্রয়ী ও সর্বনিম্ন-ক্ষতির ইঞ্জিনগুলো ধাপে ধাপে প্রয়োগ করে। নীতি: `reserve-output` (ডিফল্ট, মডেল-সচেতন) · `percentage` · `absolute`। মোড: `floor` (মানানসই হওয়া নিশ্চিত করে) · `replace-autotrigger` (আপনার স্পষ্ট পছন্দ অগ্রাধিকার পায়) · `off` (পুরোনো threshold)।
- **🎛️ কোথায় compression নির্ধারিত হয়** _(অগ্রাধিকার, উচ্চ → নিম্ন)_ — প্রতি-রিকোয়েস্ট `x-omniroute-compression` header › routing-combo override › সক্রিয় named profile › adaptive / auto-trigger › panel default › off। প্রয়োগ করা পরিকল্পনাটি `X-OmniRoute-Compression: ; source=` response header-এ ফিরে আসে।
Token threshold অনুযায়ী auto-trigger করুন, adaptive dial চালু করুন, একটি named profile স্থির করুন, প্রতি রিকোয়েস্টে এককালীন মান সেট করুন, অথবা প্রতি routing combo-তে একটি pipeline নির্ধারণ করুন—workload-এর জন্য যেটি উপযুক্ত। ঐচ্ছিক offline **eval harness** (`npm run eval:compression`) কোনো পরিবর্তন প্রচারের আগে একটি স্থির corpus-এ fidelity বনাম সাশ্রয় মূল্যায়ন করে।
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ দ্রুত শুরু
**1) ইনস্টল ও চালু করুন**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` বা peer-dep সতর্কতা দেখছেন? [এগুলো ক্ষতিকর নয়](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)।
> **npm 11 বা পরবর্তী সংস্করণ ব্যবহার করছেন?** অনুমতি না দিলে npm package lifecycle script ব্লক করতে পারে। OmniRoute-এর native runtime file প্রস্তুত করতে এর `postinstall` (`node scripts/build/postinstall.mjs`) প্রয়োজন। বিশ্বব্যাপী ইনস্টল করার সময় npm-এর সতর্কতায় উল্লিখিত package-গুলোকে অনুমতি দিন। OmniRoute 3.8.51 যে package set জানায়, তার জন্য:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> ভবিষ্যতের global install-এ এই allowlist পুনরায় ব্যবহার করতে একবার এটি configure করুন, তারপর স্বাভাবিকভাবে install করুন:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Release-গুলোর মধ্যে dependency list পরিবর্তিত হতে পারে; npm ভিন্ন কোনো list জানালে সেই সতর্কতার package name-গুলো ব্যবহার করুন। কোনো package-কে অনুমতি দিলে সেটির install script চালানোর অনুমতি দেওয়া হয়।
> **Gemini Web বা অন্য কোনো web-cookie provider ব্যবহার করছেন?** npm package-টিতে
> Playwright অন্তর্ভুক্ত আছে, তবে এর Chromium binary নেই। প্রথম web-provider request করার আগে
> [Playwright Chromium setup](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> সংক্রান্ত নোটটি দেখুন।
Dashboard: `http://localhost:20128` · API: `http://localhost:20128/v1`।
**2) আপনার নিজস্ব account ব্যবহার করে একটি উপযুক্ত provider সংযুক্ত করুন**
Dashboard → **Providers** → এমন একটি provider বেছে নিন যার বর্তমান শর্তাবলি ও quota আপনার use case-এর সঙ্গে মানানসই → এর API key যোগ করুন অথবা account flow সম্পন্ন করুন। Free tier-এর জন্য signup, অনুমোদন বা payment method প্রয়োজন হতে পারে। [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) পর্যালোচনা করুন; keyless সুবিধার নিশ্চয়তা নেই এবং `tos: avoid` চিহ্নিত provider-গুলো ডিফল্টভাবে `auto` থেকে বাদ থাকে।
**3) আপনার coding tool-কে নির্দেশ করুন**
```txt
Base URL: http://localhost:20128/v1
API Key: [Dashboard → Endpoints থেকে কপি করুন]
Model: auto (উপযুক্ত connection-গুলোর মধ্যে route করে—অথবা provider/model বেছে নিন)
```
**4) এটি কাজ করছে কি না যাচাই করুন**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
আপনার সংযুক্ত model-গুলোর তালিকা দেখতে পাওয়ার কথা। 🎉 এটুকুই—coding শুরু করুন, আর OmniRoute আপনার জন্য স্বয়ংক্রিয়ভাবে route করবে ও fallback প্রয়োগ করবে।
আপনার client যদি custom header পাঠাতে না পারে, OmniRoute tokenized compatibility alias-ও প্রদান করে:
```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
```
শুধু যেসব client `Authorization: Bearer ...` সংযুক্ত করতে পারে না, সেগুলোর জন্য এগুলো ব্যবহার করুন। Header auth-ই পছন্দের পদ্ধতি।
## 📦 আরও ইনস্টলেশন পদ্ধতি — 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
# একটি প্রোভাইডার সংযুক্ত করার পর, Dashboard → Endpoints থেকে আপনার OmniRoute কী কপি করুন:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto`-এর জন্য একটি যোগ্য রুট প্রয়োজন। নতুন ইনস্টলেশনে কোনো যোগ্য কী-বিহীন টার্গেট নাও থাকতে পারে এবং কোনো কী-বিহীন প্রোভাইডার তৃতীয়-পক্ষের ক্লায়েন্ট প্রত্যাখ্যান করতে পারে। OpenCode Free এবং Kiro-সহ `tos: avoid` হিসেবে চিহ্নিত প্রোভাইডারগুলো ডিফল্টভাবে স্বয়ংক্রিয় রাউটিং থেকে বাদ থাকে; একটি অ্যাকাউন্ট সংযুক্ত করলে সেই সেটিং ওভাররাইড হয় না। কোনো প্রোভাইডার বেছে নেওয়ার আগে [ফ্রি টিয়ার নির্দেশিকা](docs/getting-started/FREE-TIERS-GUIDE.md) দেখুন।
📦 **Python, Node.js, PHP এবং cURL**-এর জন্য কপি-পেস্টযোগ্য কুইকস্টার্ট স্ক্রিপ্ট → [`examples/quickstart/`](examples/quickstart/)
> একটি **কম্বো** হলো মডেলগুলোর একটি শৃঙ্খল, যেগুলোর মধ্যে OmniRoute **স্বয়ংক্রিয়ভাবে** রাউট করে। কোটা শেষ হয়ে গেলে, কোনো প্রোভাইডার ব্যর্থ হলে বা খরচ হঠাৎ বেড়ে গেলে, কম্বোটি পরবর্তী যোগ্য ও সচল মডেলে যেতে পারে। 🛡️
### ⚡ কোনো কনফিগারেশন নয় — শুধু `auto` ব্যবহার করুন
কোনো কম্বো তৈরি করতে হবে না। আপনার মডেলটি `auto`-তে (অথবা এর কোনো ভ্যারিয়েন্টে) সেট করুন, আর OmniRoute আপনার সংযুক্ত প্রোভাইডারগুলো থেকে একটি ভার্চুয়াল কম্বো তৈরি করবে, যার স্কোর সরাসরি নির্ধারিত হয়:
📖 [অটো-কম্বো ইঞ্জিন](docs/routing/AUTO-COMBO.md) · [স্থিতিস্থাপকতা নির্দেশিকা](docs/architecture/RESILIENCE_GUIDE.md)
📊 9router, OpenRouter, CLIProxyAPI & LiteLLM-এর সঙ্গে তুলনার সম্পূর্ণ পদ্ধতি & প্রতিটি ফিচারের বিস্তারিত → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
কী (এলোমেলো): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix কপি-পেস্ট:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [অনুমোদন](docs/architecture/AUTHZ_GUIDE.md) · [সুরক্ষাব্যবস্থা](docs/security/GUARDRAILS.md) · [কমপ্লায়েন্স](docs/security/COMPLIANCE.md)
ডিফল্ট স্ট্যাকড কম্বো `RTK → Caveman` চালায়। উভয়ই একই টুল/কনটেক্সট পেলোডে কাজ করলে সাশ্রয় চক্রবৃদ্ধি হারে বাড়ে:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
কোড ব্লক, URL, JSON এবং স্ট্রাকচার্ড ডেটা সংরক্ষণ ইঞ্জিন দ্বারা **সর্বদা সুরক্ষিত** থাকে।
> **অল্প টোকেনেই যখন কাজ হয়, তখন বেশি টোকেন ব্যবহার করবেন কেন?** প্রতিটি অনুরোধ OmniRoute-এর কম্প্রেশন পাইপলাইনের মধ্য দিয়ে **স্বচ্ছভাবে** যায় — ক্লায়েন্টে কোনো পরিবর্তনের প্রয়োজন নেই। এটি এখন **১২টি সমন্বয়যোগ্য ইঞ্জিনের একটি স্ট্যাক**, যেগুলো ক্রমানুসারে চলে এবং প্রতিটি রাউটিং কম্বো অনুযায়ী মিলিয়ে ব্যবহার করা যায় — [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)-এর ধারণার ওপর ভিত্তি করে তৈরি।
### 🧱 ১২-ইঞ্জিনের স্ট্যাক
ইঞ্জিনগুলো পাইপলাইনের ক্রমানুসারে চলে; প্রতিটি ইঞ্জিন আলাদাভাবে চালু বা বন্ধ করা এবং প্রতিটি কম্বোর জন্য কনফিগার করা যায়:
