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

# 🚀 OmniRoute — အခမဲ့ AI Gateway

OmniRoute — ကုဒ်ရေးသားမှုကို ဘယ်တော့မှ မရပ်လိုက်ပါနှင့်။ AI ကိရိယာတိုင်း → ဝန်ဆောင်မှုပေးသူ 375 ခု — အခမဲ့ 150+ ခု — endpoint တစ်ခုတည်းမှတစ်ဆင့်။ Claude Code၊ Codex၊ Cursor၊ Cline၊ Copilot နှင့် Antigravity တို့ကို အလိုအလျောက် fallback ပါရှိသော အခမဲ့ Claude / GPT / Gemini နှင့် ချိတ်ဆက်ပါ။ RTK + Caveman အဆင့်ဆင့်ဖိသိပ်မှုက token 15–95% (~89% ပျမ်းမျှ) ကို ချွေတာပေးသောကြောင့် ကန့်သတ်ချက်များကို ဘယ်တော့မှ မထိတော့ပါ။ AI ဝန်ဆောင်မှုပေးသူ 375 ခု · အခမဲ့အဆင့် 150+ ခု · တစ်လလျှင် အခမဲ့ token ~1.62B · လမ်းကြောင်းရွေးချယ်မှု မဟာဗျူဟာ 20 ခု · စတင်ရန် $0။

## 💰 Third-Party Free Tier များမှ လစဉ် ~1.62B Tokens

> **သင်၏ ကိုယ်ပိုင် provider account များကို ယူဆောင်လာပါ။** ဤသည်မှာ OmniRoute မှ ပေးအပ်သော token မဟုတ်ဘဲ၊ သီးခြားစီ eligible ဖြစ်သော third-party free tier များပေါ်တွင်ရှိသော ခန့်မှန်းချေစုပေါင်းဖြစ်သည်။ စာရင်းသွင်းပါ၊ လိုအပ်သောနေရာများတွင် credential များ ရယူပါ၊ ပြီးနောက် သင်အသုံးပြုနိုင်သော provider များကို ချိတ်ဆက်ပါ။ provider တစ်ခုချင်းစီက ၎င်း၏ limit များ၊ ရရှိနိုင်မှုနှင့် စည်းကမ်းသတ်မှတ်ချက်များကို ကိုယ်တိုင်ထိန်းချုပ်သည်။ > > Free tier များကို လက်ဖြင့်စုစည်းခြင်းသည် ခက်ခဲနောက်ကျောတက်စရာဖြစ်သည် — SDK ဒါဇင်ပေါင်းများစွာ၊ rate limit ဒါဇင်ပေါင်းများစွာ၊ သင့်တွင် အမှန်တကယ် မည်မျှရှိသည်ကိုလည်း မသိရပါ။ OmniRoute သည် **recurring pool key 34 ခုရှိ free-tier entry 467 ခု** ကို catalog ပြုလုပ်ပြီး၊ shared pool အလိုက် deduplicate လုပ်ထားသည့် **published positive monthly budget ရှိသော pool 17 ခုနှင့် per-model Groq cap ငါးခု** မှ token headline ကို တွက်ချက်သည်။ Regional identity check ပြီးဆုံးမှသာ ဖွင့်ပေးသော quota များ (ယနေ့: ModelScope) ကို regional identity verification နောက်တွင် +~6M အဖြစ် သီးခြားပြသထားပြီး၊ headline ထဲသို့ ဘယ်တော့မှ ပေါင်းထည့်ခြင်း မပြုပါ။ ရလဒ်ကို dashboard (`/dashboard/free-tiers`) တွင် ဆက်လက်မြင်နိုင်ပါသည်။

> Live `/dashboard/free-tiers` စာမျက်နှာ၏ animated အကျဉ်းချုပ်။ Methodology အပြည့်အစုံ (pool dedupe၊ credit tiers၊ provider terms): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**။ > > _{ဤဂဏန်းများကို live catalog နှင့်တိုင်း နှစ်ပတ်တစ်ကြိမ် ပြန်လည်စစ်ဆေးပြီး **နှစ်ဘက်စလုံး ရွေ့လျားနိုင်သည်** — provider တစ်ခုက free tier ကို ရပ်ဆိုင်းလျှင် ဂဏန်းကျသွားပြီး၊ အသစ်တစ်ခု ဝင်ရောက်လာလျှင် တက်သွားသည်။ ကျွန်ုပ်တို့သည် catalog က အမှန်တကယ် တွက်ချက်ပေးသည့်အတိုင်းသာ ထုတ်ပြန်ပြီး၊ ဘယ်တော့မှ round-up လုပ်ထားသော best case မဟုတ်ပါ။}

⭐ OMNIROUTE က သင့်အား ငွေချွေတာရန်နှင့် အလုပ်ကို ပိုမိုလွယ်ကူစေရန် ကူညီပေးခဲ့ပါက repo ကို Star ပေးပါ။

[![ကြယ်များ](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Star History အဆင့်](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Community တွင် ပါဝင်ပါ **👋 Maintainer ကို follow လုပ်ပါ — provider အသစ်များ၊ release များနှင့် tips များကို အရင်ဆုံး ရယူပါ:** [![LinkedIn တွင် Diego ကို follow လုပ်ပါ](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![GitHub တွင် @diegosouzapw ကို follow လုပ်ပါ](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![ဝဘ်ဆိုက်](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **မေးခွန်းများ၊ provider tips များ၊ roadmap နှင့် support → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway သည် ဆက်လက်ကြီးထွားနေသည်

| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | ------------------------------------- | :-------------------------: | :---------: | :---------------------: | | 🌐 ပရိုဗိုက်ဒါများ | 352 | **358** | 375 | | 🧠 ထူးခြားသော chat model ID များ | 1320 | **1374** | 1475 | | 🖼️ Modality Bridge | 🆕 ရုပ်မြင် + အသံ + ဗီဒီယို | ✓ | ✓ | | 📡 Radar အခမဲ့ ကတ်တလော့ | 🆕 opt-in | ✓ | ✓ | | ⚖️ Quota ကိုထည့်စဉ်းစားသော scheduling | 🆕 Quota-Share | ✓ | ✓ | | 📊 Quota တယ်လီမက်ထရီ | 🆕 တိုက်ရိုက် | ✓ | ✓ | | 🧰 Headless မုဒ် | — | — | 🆕 `serve --headless` | | 🛤️ LTS rail အခြေခံအဆောက်အအုံ | — | — | 🆕 release channel များ | | 🔎 မော်ဒယ်ရှာဖွေရေး API | — | — | 🆕 `/v1/models/query` | **→ [လမ်းပြမြေပုံ](ROADMAP.md) — `v3.9.0 LTS` ဆီသို့ rail လမ်းကြောင်းအတိုင်း ဆက်လက်ဦးတည်နေသည်**

## 🧩 ရရှိနိုင်မှု [![npm ဗားရှင်း](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM လစဉ်](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![လိုင်စင်: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker ဒေါင်းလုဒ်ဆွဲမှုများ](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron ဒေါင်းလုဒ်များ](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 စတင်ရန်	🚀 အမြန်စတင်ရန်	📦 ထည့်သွင်းရန်	🆓 ဝန်ဆောင်မှုပေးသူတစ်ခုကို ချိတ်ဆက်ရန်
💡 လေ့လာရန်	💥 ကတိကဝတ်	🤔 OmniRoute ကို ဘာကြောင့် သုံးသင့်သလဲ	🏆 ထူးခြားစေသောအရာများ
⚙️ လုပ်ဆောင်ချက်များ	🎯 ပေါင်းစပ်မှုများ	🌐 ဝန်ဆောင်မှုပေးသူများ	🔌 CLI & MCP
	🗜️ ချုံ့ခြင်း	🖥️ လည်ပတ်နိုင်သည့်နေရာများ	🔒 သီးသန့်
👀 ကြည့်ရှုရန်	🎬 လက်တွေ့လုပ်ဆောင်ပုံ	✨ အသစ်ပါဝင်လာသောအရာများ	🤖 တွဲဖက်အသုံးပြုနိုင်သော CLI များ
💚 ပံ့ပိုးရန်	💚 ပံ့ပိုးရန် / လှူဒါန်းရန်	💬 အသိုင်းအဝိုင်း	💖 ပံ့ပိုးကူညီသူများ
📦 ပရောဂျက်	🛠️ နည်းပညာအစုအဝေး	📖 စာရွက်စာတမ်းများ	👥 ပါဝင်ကူညီသူများ

🌐 ဘာသာစကား ၆၇ မျိုးဖြင့်

## 🆓 ထည့်သွင်းပါ၊ provider တစ်ခု ချိတ်ဆက်ပါ၊ ပြီးနောက် endpoint တစ်ခုတည်းမှတဆင့် route လုပ်ပါ

အဆင့်သုံးဆင့်- OmniRoute ကို ထည့်သွင်းပြီး စတင်ပါ၊ သင့်ကိုယ်ပိုင် account သို့မဟုတ် API key ဖြင့် eligible provider တစ်ခု ချိတ်ဆက်ပါ၊ ပြီးနောက် OmniRoute API key နှင့် model auto ကို အသုံးပြု၍ သင့် tool ကို localhost:20128/v1 သို့ ညွှန်ပါ။ Routing သည် ရရှိနိုင်သော eligible ချိတ်ဆက်မှုများနှင့် provider ကန့်သတ်ချက်များပေါ် မူတည်သည်။

```bash # Provider တစ်ခု ချိတ်ဆက်ပြီးနောက်၊ Dashboard → Endpoints မှ သင့် OmniRoute key ကို ကူးယူပါ- 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` သည် eligible route တစ်ခု လိုအပ်သည်။ ထည့်သွင်းမှုအသစ်တွင် eligible keyless target များ လုံးဝမရှိနိုင်ပြီး၊ keyless provider က third-party client များကို ငြင်းပယ်နိုင်သည်။ Kiro အပါအဝင် `tos: avoid` ဟု မှတ်သားထားသော provider များကို automatic routing မှ မူလသတ်မှတ်ချက်အရ ဖယ်ထုတ်ထားပြီး၊ account ချိတ်ဆက်ခြင်းက ထိုသတ်မှတ်ချက်ကို ကျော်လွန်စေမည်မဟုတ်ပါ။ Provider တစ်ခု မရွေးချယ်မီ [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) ကို ကြည့်ပါ။} _{📦 **Python, Node.js, PHP နှင့် cURL** အတွက် copy-paste quickstart script များ → [`examples/quickstart/`](examples/quickstart/)}

# 💥 ကတိ

# 🤔 ဘာကြောင့် OmniRoute လဲ?

OmniRoute request flow- သင့် IDE သို့မဟုတ် CLI (Claude Code, Cursor, Cline…) က local endpoint တစ်ခု (http://localhost:20128/v1) ကို ခေါ်ဆိုသည်။ OmniRoute Smart Router (RTK + Caveman compression, routing strategy 20 ခု, circuit breaker, TLS stealth, MCP, A2A, guardrail) သည် eligible ကျန်းမာသော target ကျန်ရှိနေသေးသရွေ့ provider tier 4 ခုအပေါ် fallback လုပ်နိုင်သည် — Tier 1 Subscription, Tier 2 API Key, Tier 3 Cheap နှင့် Tier 4 Free

## 🤝 ကျွန်ုပ်တို့၏ Open Source သူငယ်ချင်းများမှ ပံ့ပိုးထားပါသည်။

> **Open Source သူငယ်ချင်းအဖြစ် ပါဝင်လိုပါသလား။** ၎င်းတို့သည် open source ကို ထောက်ခံပြီး OmniRoute ကို ဆက်လက်လည်ပတ်နိုင်ရန် ကူညီပေးသည့် ကုမ္ပဏီများဖြစ်သည် — ၎င်းတို့ပေးသော တိုကင်တိုင်း မည်သည့်နေရာသို့ ရောက်ရှိသည်ကို ကျွန်ုပ်တို့ လူသိရှင်ကြား ပြောပြပါသည်။ ဆက်သွယ်ရန်- [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} ဤပရောဂျက်ကို ပံ့ပိုးပေးသည့် ကျွန်ုပ်တို့၏ တည်ထောင်သူ Open Source သူငယ်ချင်း Kimi (Moonshot AI) အား ကျေးဇူးတင်ပါသည်။ Kimi သည် open-weight K2 နှင့် K3 မော်ဒယ်မိသားစုများနောက်ကွယ်မှ AI ဓာတ်ခွဲခန်းဖြစ်သည် — Kimi K3 သည် 1M-token context window၊ native vision နှင့် frontier-level coding တို့ကို closed-model ဈေးနှုန်း၏ အစိတ်အပိုင်းတစ်ခုဖြင့် ပေးစွမ်းပြီး Claude Code၊ Codex နှင့် OmniRoute မှ ပံ့ပိုးပေးသည့် coding tool တိုင်းနှင့် အဆင်ပြေစွာ အလုပ်လုပ်ပါသည်။

Kimi ၏ ပံ့ပိုးမှုက ဘာတွေလုပ်ဆောင်ပေးသလဲ- Kimi ၏ API credits များသည် OmniRoute ၏ AI-validated release pipeline ကို အားဖြည့်ပေးသည် — pull request တိုင်းကို မထုတ်ပြန်မီ ပြန်လည်သုံးသပ်သည့် merge validation powered by Kimi K3 အဆင့် — အပြင် နေ့စဉ် feature development ကိုပါ ပံ့ပိုးပေးပါသည်။ First-class Kimi support သည် လမ်းကြောင်းနှစ်ခုလုံးတွင် ပါဝင်သည်- တိုက်ရိုက် Kimi API (kimi-k3) နှင့် Kimi Code coding plan (OAuth နှင့် API key)။ OmniRoute သည် Kimi ၏ ပံ့ပိုးမှုအစီအစဉ်တွင် ပထမဆုံး ဘရာဇီးလ် open-source ပရောဂျက်လည်းဖြစ်သည်။ 15% အပို credits ဖြင့် Kimi API key ရယူပါ →

Cheaper Inference
_{cheaperinference.com} ဤပရောဂျက်ကို ပံ့ပိုးပေးသည့် OmniRoute Open Source သူငယ်ချင်း Cheaper Inference အား ကျေးဇူးတင်ပါသည်။ Cheaper Inference သည် Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok နှင့် MiniMax အပါအဝင် frontier မော်ဒယ် ၄၂ ခုကို OpenAI-compatible endpoint တစ်ခုနောက်ကွယ်မှ ပြန်လည်ရောင်းချသည့် ကုန်ကျစရိတ်အလိုက် အဆင့်သတ်မှတ်ထားသော gateway တစ်ခုဖြစ်ပြီး မော်ဒယ်ထုတ်လုပ်သူ၏ စာရင်းဈေးနှုန်းထက် ပိုမိုမကောက်ခံဘဲ တောင်းဆိုမှုတိုင်းကို ဈေးအသက်သာဆုံး အရည်အချင်းပြည့်မီသော ပံ့ပိုးသူထံသို့ လမ်းကြောင်းပြောင်းပေးပါသည်။

OmniRoute တွင် First-class support- Chat Completions၊ native /v1/responses endpoint၊ vision၊ tool calling နှင့် image မော်ဒယ် ၃ ခု (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> အဖြစ် ရရှိနိုင်သည်)။ API key ရယူပါ →

_{aff=omniroute ဟု တပ်ဆင်ထားသော လင့်ခ်များသည် ပါတနာလင့်ခ်များဖြစ်သည်။ ၎င်းတို့သည် သင့်အတွက် အပိုကုန်ကျစရိတ်မရှိဘဲ ပရောဂျက်ကို ရန်ပုံငွေထောက်ပံ့ပေးပါသည်။}

_{🎟️ Affiliates Promo — ကျွန်ုပ်တို့ မပံ့ပိုးသော ပံ့ပိုးသူများထံမှ အခမဲ့ စာရင်းသွင်းကူပွန်များ (ချဲ့ရန် နှိပ်ပါ)}

_{ဤအပိုင်းသည် referral/coupon codes များအတွက်သာဖြစ်သည်။ ပံ့ပိုးထားသော ပူးပေါင်းဆောင်ရွက်မှုများသည် အထက်ပါ 🤝 Supported by our Open Source Friends တွင် ရှိပါသည်။ OmniRoute သည် ဤနေရာတွင် ဖော်ပြထားသော ပံ့ပိုးသူများနှင့် ပံ့ပိုးမှု သို့မဟုတ် ပူးပေါင်းဆောင်ရွက်မှု မရှိပါ — ၎င်းတို့သည် မည်သူမဆို အသုံးပြုနိုင်သော အများပြည်သူသုံး ကူပွန်များဖြစ်သည်။}

_AgentRouter
_{agentrouter.org} _{AgentRouter — affiliate စာရင်းသွင်းခြင်း · စာရင်းသွင်းခြင်းတွင် $100 အခမဲ့ credits (အခမဲ့ server၊ latency ပိုများနိုင်သည် — စမ်းသပ်ရန် အကောင်းဆုံး၊ ထုတ်လုပ်မှုအတွက် မဟုတ်ပါ)။ OmniRoute တွင် v3.8.50 မှစ၍ First-class support- Chat Completions၊ Anthropic-compatible wire format နှင့် OpenAI-compatible path။ ရရှိနိုင်သော မော်ဒယ်များတွင် claude-opus-4-8၊ claude-opus-5၊ gpt-5.6-sol နှင့် အခြားအရာများ ပါဝင်သည်။ သင့် $100 ကို ရယူပါ →}

_{⚠️ Affiliate link — OmniRoute သည် ဤပံ့ပိုးသူနှင့် ပံ့ပိုးမှု သို့မဟုတ် ပူးပေါင်းဆောင်ရွက်မှု မရှိပါ။}

_{OmniRoute အသုံးပြုသူများအတွက် အကျိုးရှိစေမည့် ရက်ရောသော အခမဲ့ စာရင်းသွင်းကူပွန်ပါရှိသော အခြားပံ့ပိုးသူကို သိပါသလား။ issue တစ်ခုဖွင့်ပါ၊ ကျွန်ုပ်တို့ ဤနေရာတွင် ထည့်သွင်းပေးပါမည်။}

## 🎯 ကွန်ဘိုများ — အဓိကစွမ်းဆောင်ရည်

ကွန်ဘို routing strategy 20 ခုအနက် 18 ခုအတွက် လှုပ်ရှားသရုပ်ပြနမူနာများ — strategy တစ်ခုလျှင် tile တစ်ခုစီဖြင့် priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline တို့ကို ပြသထားသည်။ cache-optimized နှင့် quota-weighted ကို လှုပ်ရှားသရုပ်ပြမထားပါ။ အောက်ပါဇယားတွင် 20 ခုလုံးကို ဖော်ပြထားသည်။

> **ကွန်ဘို** ဆိုသည်မှာ OmniRoute က **အလိုအလျောက်** ဖြတ်သန်း route လုပ်ပေးသည့် model များ၏ အစဉ်တန်းတစ်ခုဖြစ်သည်။ quota ကုန်သွားလျှင်၊ provider တစ်ခု ပျက်ကွက်လျှင် သို့မဟုတ် ကုန်ကျစရိတ်များ ရုတ်တရက်မြင့်တက်လာလျှင် ကွန်ဘိုသည် သတ်မှတ်ချက်နှင့်ကိုက်ညီပြီး ကောင်းမွန်စွာအလုပ်လုပ်နေသည့် နောက် model တစ်ခုသို့ ပြောင်းနိုင်သည်။ 🛡️ ### ⚡ Zero-config — `auto` ကိုသာ အသုံးပြုပါ ကွန်ဘိုဖန်တီးရန် မလိုပါ။ သင့် model ကို `auto` (သို့မဟုတ် variant တစ်ခု) ဟု သတ်မှတ်လိုက်ပါက OmniRoute သည် သင်ချိတ်ဆက်ထားသော provider များမှ virtual combo တစ်ခုကို တိုက်ရိုက်ရမှတ်ပေး၍ တည်ဆောက်ပေးသည်-

Model ID	ဦးစားပေး အကောင်းဆုံးဖြစ်အောင် လုပ်ဆောင်သည့်အရာ
`auto`	🎯 မျှတသော မူလသတ်မှတ်ချက် (LKGP — နောက်ဆုံး ကောင်းမွန်စွာအလုပ်လုပ်ခဲ့သည့် provider ကို ဆက်လက်အသုံးပြုသည်)
`auto/coding`	🧑💻 ကုဒ်ထုတ်လုပ်မှုအတွက် အရည်အသွေးကို ဦးစားပေးသည့် weight များ
`auto/fast`	⚡ latency အနည်းဆုံးကို ဦးစွာရွေးချယ်သည်
`auto/cheap`	💰 token တစ်ခုလျှင် ဈေးအသက်သာဆုံးကို ဦးစွာရွေးချယ်သည်
`auto/subscription`	🎟️ သင်ပေးချေထားပြီးဖြစ်သည့် subscription quota ကိုသာ အသုံးပြုသည် — မရနိုင်ပါက ပိတ်ထားပြီး ငွေကောက်ခံနိုင်သည့် fallback ကို မည်သည့်အခါမျှ မသုံးပါ (လမ်းညွှန်)
`auto/thrifty`	🪜 plan quota ကို ဦးစွာအသုံးပြုပြီးနောက် ဈေးအသက်သာဆုံး အခပေးရွေးချယ်စရာများသို့ အဆင့်တစ်ဆင့်ချင်း ပြောင်းသည် — plan reset ဖြစ်ပြီးနောက် plan သို့ ပြန်သွားသည် (လမ်းညွှန်)
`auto/offline`	🔋 quota / rate-limit လက်ကျန်အများဆုံးကို ဦးစွာရွေးချယ်သည်
`auto/smart`	🔭 အရည်အသွေးကို ဦးစားပေးခြင်း + ပိုကောင်းသည့် model များ ရှာဖွေတွေ့ရှိရန် 10% စမ်းသပ်အသုံးပြုခြင်း
`auto/lkgp`	📌 နောက်ဆုံး ကောင်းမွန်စွာအလုပ်လုပ်ခဲ့ကြောင်း သိထားသည့် provider ကို ဆက်လက်အသုံးပြုရန် အတိအလင်းသတ်မှတ်ခြင်း
`auto/chaos`	🧪 model အစုတစ်ခုထံ အပြိုင်ဖြန့်ပို့သည် (provider တစ်ခုလျှင် တစ်ခု၊ မူလသတ်မှတ်ချက်အရ 5 ခု)၊ အဖြေတစ်ခုကို ပြန်ပေးသည်။ ချို့ယွင်းမှုတုပြုလုပ်ခြင်းမဟုတ်ဘဲ အစုအတွင်းရှိ model တစ်ခုစီအတွက် upstream call တစ်ခုစီ ပြုလုပ်သည်

## ### 🔀 သို့မဟုတ် ကိုယ်ပိုင်တည်ဆောက်ပါ — routing strategy 20 ခု strategy **20** ခုလုံးကို ကွန်ဘိုအဆင့်တစ်ခုချင်းစီတွင် လိုသလို ရောစပ်တွဲဖက်နိုင်သည်-

#	Strategy	လုပ်ဆောင်ပုံ
1	`priority`	ပထမ target ကို ဦးစားပေးသည့် အစဉ်လိုက်စာရင်း — တစ်ခုချင်းစီကို အပြည့်အဝအသုံးပြုပြီးမှ နောက်တစ်ခုသို့ ပြောင်းသည် 🥇
2	`fill-first`	နောက်တစ်ခုသို့ မပြောင်းမီ target တစ်ခုချင်းစီ၏ quota ကို အပြည့်အဝအသုံးပြုသည်
3	`weighted`	target တစ်ခုချင်းစီ၏ weight အလိုက် အလေးပေး ကျပန်းရွေးချယ်သည်
4	`round-robin`	target များကို အစဉ်လိုက် လှည့်ပတ်အသုံးပြုသည်
5	`p2c`	ရွေးချယ်စရာနှစ်ခုမှ ကျပန်းရွေးသည့် load balancing
6	`least-used`	လက်ရှိ load အနည်းဆုံးရှိသည့် target ကို ရွေးချယ်သည်
7	`random`	အညီအမျှဖြစ်နိုင်ခြေဖြင့် ကျပန်းရွေးချယ်သည် (ထပ်နေမှုများကို ဖယ်ရှားထားသည်)
8	`strict-random`	ထပ်မံရွေးချယ်မှုများကို မဖယ်ရှားဘဲ ကျပန်းရွေးချယ်သည် 🎲
9	`cost-optimized`	တိုက်ရိုက် catalog ဈေးနှုန်းများအရ request တစ်ခုလျှင် $ ကုန်ကျစရိတ်ကို အနည်းဆုံးဖြစ်စေသည် 💸
10	`headroom`	လက်ကျန် quota အများဆုံးရှိသည့် target ကို ရွေးချယ်သည်
11	`quota-weighted`	quota ကုန်ဆုံးသွားသည့် account များကို ကျော်ပြီးနောက် လက်ကျန် quota ÷ လုပ်ဆောင်နေဆဲ load အချိုးအစားအလိုက် ရွေးချယ်သည် — ရှိပြီးသား စကားဝိုင်းများကို မူလ target တွင် ဆက်လက်ထိန်းထားသည် ⚖️
12	`reset-window`	quota window အစောဆုံး reset ဖြစ်မည့် target ကို ဦးစားပေးသည်
13	`reset-aware`	quota reset အချိန်အလိုက် အဆင့်သတ်မှတ်သည် — window တိုသည်များကို ဦးစားပေးသည် 📊
14	`context-relay`	ရှည်လျားသော စကားဝိုင်းများအတွက် context ကို target များကြား လွှဲပြောင်းပေးသည် 🧠
15	`context-optimized`	လက်ရှိ context အရွယ်အစားနှင့် အသင့်တော်ဆုံး target ကို ရွေးချယ်သည်
16	`cache-optimized`	ပြန်လည်အသုံးပြုနိုင်သည့် prompt prefix တစ်ခုစီကို account တစ်ခုတည်းတွင် ဆက်လက်သတ်မှတ်ထားသည် — prompt-cache hit များကို အများဆုံးဖြစ်စေသည် 🎯
17	`lkgp`	နောက်ဆုံး ကောင်းမွန်စွာအလုပ်လုပ်ခဲ့သည့် လမ်းကြောင်း — နောက်ဆုံးအောင်မြင်ခဲ့သည့် provider ကို ဆက်လက်အသုံးပြုပြီး မအောင်မြင်ပါက စည်းမျဉ်းများအတိုင်း fallback လုပ်သည်
18	`auto`	ချိတ်ဆက်မှုတိုင်းအတွက် အချက် 16 ချက်ဖြင့် တိုက်ရိုက်ရမှတ်ပေးသည် 🤖
19	`fusion`	model အစုတစ်ခုထံ ဖြန့်ပို့ပြီး judge တစ်ခုက အဖြေတစ်ခုအဖြစ် ပေါင်းစပ်ပေးသည် 🧬
20	`pipeline`	အဆင့်များကို အစဉ်လိုက်ချိတ်ဆက်သည် — target တစ်ခုစီ၏ output ကို နောက်တစ်ခုထံ ပို့ပေးသည် 🔗

_{Auto-Combo အင်ဂျင်သည် အသုံးပြုနိုင်သည့် ရွေးချယ်စရာတိုင်းကို **အချက် 16 ချက်** (စနစ်အခြေအနေ၊ ခွဲတမ်း၊ ကုန်ကျစရိတ်၊ တုံ့ပြန်ချိန်၊ လုပ်ငန်းနှင့် ကိုက်ညီမှု၊ အရည်အသွေး၊ session ရရှိနိုင်မှု…) ဖြင့် အမှတ်ပေးသည် — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) ကို ကြည့်ပါ။} ## ### 🧱 ခံနိုင်ရည်ရှိမှုကို မူလကတည်းက ထည့်သွင်းတည်ဆောက်ထားသည် (သီးခြားအလွှာ 3 ခု)

OmniRoute ၏ ခံနိုင်ရည်ရှိမှု — အချင်းချင်း သီးခြားဖြစ်သော ကိုယ်တိုင်ပြန်လည်ပြုပြင်နိုင်သည့် အလွှာ 3 ခု၊ ချို့ယွင်းမှုတစ်မျိုးစီအတွက် သင့်တော်သောအလွှာ။ အလွှာ 1 provider circuit breaker (provider တစ်ခုလုံး)- 408/5xx တွင်သာ အလုပ်လုပ်ပြီး OAuth 8× / API-key 12× / local 2× ဟူသော သတ်မှတ်ချက်များရှိကာ 60s/30s/15s အကြာတွင် HALF-OPEN စမ်းသပ်မှုအဖြစ် ပြန်လည်သတ်မှတ်ပြီး လိုအပ်သည့်အချိန်မှသာ ပြန်လည်ရယူသည်။ OPEN ဖြစ်နေစဉ် combo သည် နောက် provider သို့ လမ်းကြောင်းပြောင်းပေးသည်။ အလွှာ 2 connection cooldown (key/account တစ်ခု)- OAuth အတွက် အခြေခံ 5s / API-key အတွက် 3s၊ တစ်ပြိုင်နက်တည်း အစုလိုက်ပြန်လည်ကြိုးစားခြင်းကို တားဆီးသည့် ကာကွယ်မှုနှင့်အတူ ×2 exponential backoff ကို အသုံးပြုသည်၊ 429 ဖြစ်လျှင် Retry-After ကို လိုက်နာပြီး အောင်မြင်ပါက error အခြေအနေအားလုံးကို ရှင်းလင်းသည်။ cooldown ဖြစ်နေသော key တစ်ခုကို ကျော်သွားသော်လည်း အခြား key များက ဆက်လက်ဝန်ဆောင်မှုပေးသည်။ အလွှာ 3 model lockout (model တစ်ခု)- model တစ်ခုချင်းစီ၏ 429၊ local 404 သို့မဟုတ် mode ငြင်းပယ်မှုများသည် ထို model တစ်ခုတည်းကိုသာ ပိတ်ဆို့ပြီး connection တစ်ခုလုံးကို မည်သည့်အခါမျှ မပိတ်ဆို့ပါ။ အဆုံးသတ်အခြေအနေများ (ပိတ်ပင်ခံရခြင်း၊ သက်တမ်းကုန်ခြင်း၊ credits ကုန်ဆုံးခြင်း) သည် operator က ကိုင်တွယ်ရန်ဖြစ်ပြီး cooldown များ မဟုတ်ပါ။

_{📖 [Auto-Combo အင်ဂျင်](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 လိုင်စင်ရရှိထားပြီး အများမြင်နိုင်စွာ ထိန်းသိမ်းဖွံ့ဖြိုးထားသည်။ ၎င်းက သင့်အချိန် သို့မဟုတ် ငွေကြေးကို ချွေတာပေးပါက လွတ်လပ်စွာ ဆက်လက်ရပ်တည်နိုင်ရန် သင့်နှင့်ကိုက်ညီသည့် နည်းလမ်းကို ရွေးချယ်ပံ့ပိုးနိုင်သည်။ ပံ့ပိုးကူညီမှုသည် လမ်းကြောင်းရွေးချယ်မှု ဦးစားပေးအစီအစဉ်ကို မည်သည့်အခါမျှ မသက်ရောက်ပါ၊ ၎င်းသည် အဆင့်သတ်မှတ်ချက်မဟုတ်ဘဲ မြင်သာမှုကိုသာ ဝယ်ယူခြင်းဖြစ်သည်။

⭐ Repo ကို ကြယ်ပေးပါ	အခမဲ့ — မြင်သာမှုကို အမှန်တကယ် အထောက်အကူပြုသည်	OmniRoute ကို ကြယ်ပေးပါ
🐙 GitHub Sponsors	တစ်ကြိမ်တည်း သို့မဟုတ် လစဉ် · ပလက်ဖောင်းအခကြေးငွေ လုံးဝမရှိ	github.com/sponsors/diegosouzapw
☕ Ko-fi	လျင်မြန်သော တစ်ကြိမ်တည်း အလှူငွေ၊ အလှူရှင်အတွက် စာရင်းသွင်းရန်မလို	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	သေးငယ်ပြီး အလွတ်သဘော ပံ့ပိုးမှု	buymeacoffee.com/diegosouzapw
🖐 Liberapay	ပုံမှန်ပေးချေမှု · အကျိုးအမြတ်မယူ · ပွင့်လင်းရင်းမြစ်	liberapay.com/diegosouzapw
🇧🇷 PIX (ဘရာဇီး)	ချက်ချင်း၊ အခကြေးငွေမရှိ	သော့နှင့် QR ကို အောက်တွင် ကြည့်ပါ
₿ ခရစ်ပတို	BTC · ETH · USDT-TRC20 · USDC-Solana	လိပ်စာများကို အောက်တွင် ကြည့်ပါ

**🇧🇷 PIX** — ချက်ချင်း၊ အခကြေးငွေမရှိ (ဘရာဇီး) OmniRoute PIX QR ကုဒ်

သော့ (ကျပန်း): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia-e-cola: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ ခရစ်ပတို — BTC · ETH · USDT-TRC20 · USDC-Solana (ဖြန့်ကြည့်ရန် နှိပ်ပါ)

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

_{⚠️ အကြွေစေ့တစ်မျိုးစီကို ဖော်ပြထားသည့် ကွန်ရက်ပေါ်တွင်သာ ပို့ပါ — မှားယွင်းသော ကွန်ရက်ပေါ်မှ ပို့ပါက ရန်ပုံငွေများ ဆုံးရှုံးနိုင်သည်။}

🐛 ချို့ယွင်းချက်တစ်ခု တွေ့ရှိပါသလား သို့မဟုတ် အကြံပြုချက်ရှိပါသလား။ [ဆွေးနွေးမှု](https://github.com/diegosouzapw/OmniRoute/discussions) တစ်ခု ဖွင့်ပါ။

ဆော့ဖ်ဝဲရေးသားသူ မှတ်စုများ: ဆော့ဖ်ဝဲရေးသားသူများ အဆင်ပြေစေရန် ပရောဂျက်သည် npm install/postinstall လုပ်ဆောင်စဉ် စက်တွင်း .env ဖိုင်တစ်ခုကို ထုတ်လုပ်နိုင်သည်။ ဤဖိုင်ကို .gitignore မှတစ်ဆင့် ရည်ရွယ်ချက်ရှိရှိ လျစ်လျူရှုထားပြီး (.gitignore ကို ကြည့်ပါ) မည်သည့်အခါမျှ commit မလုပ်ရပါ — မတော်တဆ commit လုပ်မိပါက ဖော်ထုတ်ခံထားရသည့် လျှို့ဝှက်ချက်များကို ပြောင်းလဲပြီး ဖိုင်ကို မှတ်တမ်းမှ ဖယ်ရှားပါ။ စက်တွင်း ပတ်ဝန်းကျင်ဖိုင်များနှင့် လျှို့ဝှက်ချက်များကို စီမံခန့်ခွဲရန် လမ်းညွှန်ချက်များအတွက် docs/DEVELOPER-ENVIRONMENT.md ကို ကြည့်ပါ။

## 📡 OmniRoute Radar အထက်တွင် မှတ်တမ်းပြုစုဖော်ပြထားပြီး pool အလိုက် ထပ်နေမှုများကို ဖယ်ရှားထားသည့် catalog မှ အဓိက free-tier ပမာဏသည် **တစ်လလျှင် token ~1.62B** အဖြစ် ဆက်လက်ရှိနေပါသည်။ ယာယီ provider signup credit များကြောင့် ပထမလတွင် သီးခြားစီ **~2.22B** အထိ တိုးမြင့်နိုင်ပါသည်။ Radar သည် OmniRoute release များကြားတွင် free-model ရရှိနိုင်မှုဆိုင်ရာ အချက်အလက်များကို ပိုမိုလတ်ဆတ်စွာ ရယူလိုသူများအတွက် စိတ်ကြိုက်ရွေးချယ်အသုံးပြုနိုင်သည့်၊ လက်မှတ်ရေးထိုးအတည်ပြုထားသော catalog overlay တစ်ခုဖြစ်ပါသည်။ community catalog နှင့် လက်ရှိရှိပြီးသား အခမဲ့ feature အားလုံးသည် ဆက်လက်၍ အခမဲ့ဖြစ်ပါသည်။ ပံ့ပိုးသူများသည် live catalog နှင့် ထပ်ဆောင်း provider အခွင့်အလမ်းများကို ရရှိနိုင်ပါသည်။ Provider များ၏ ရရှိနိုင်မှုအပေါ် မူတည်၍ ၎င်း၏ သီးခြားပြောင်းလဲနိုင်သော အမြင့်ဆုံးပမာဏမှာ **အများဆုံး တစ်လလျှင် token ခန့်မှန်းခြေ 3B** ဖြစ်ပါသည်။ ထိုအမြင့်ဆုံးပမာဏသည် အာမခံချက်မဟုတ်ပါ။ Provider များသည် quota၊ eligibility၊ model သို့မဟုတ် region များကို အချိန်မရွေး ပြောင်းလဲနိုင်ပါသည်။ Radar သည် opt-in ဖြစ်ပြီး GET-only ဖြစ်ပါသည်။ OmniRoute client သည် prompt များ၊ traffic၊ provider configuration၊ usage telemetry သို့မဟုတ် local announcement-dismiss state တို့ကို upload မလုပ်ပါ။ Eligibility နှင့် လက်ရှိ catalog အကြောင်းကို **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** တွင် လေ့လာနိုင်ပါသည်။

## ✨ ဘာအသစ်တွေရှိလဲ

> **v3.8.20 → v3.8.53** ကာလအတွင်းက ထူးခြားချက်များ။ မှတ်တမ်းအပြည့်အစုံကို [`CHANGELOG.md`](CHANGELOG.md) မှာ ကြည့်ပါ။ - **⚖️ `quota-weighted` routing** — ကွမ်ဘို မဟာဗျူဟာ ၂၀ ခုမြောက်က ကုန်ဆုံးသွားတဲ့ အကောင့်တွေကို ကျော်သွားပြီး၊ ကျန်တဲ့အကောင့်တွေကြားမှာ ကျန်ရှိတဲ့ quota ÷ in-flight load အချိုးအစားနဲ့ ရွေးချယ်ကာ ရှိပြီးသား စကားဝိုင်းတွေကို pin ထားဆဲဖြစ်သည်။ → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless မုဒ်** — `omniroute serve --headless` (သို့မဟုတ် `OMNIROUTE_HEADLESS=1`) က `/v1/*` proxy engine ကိုသာ run ပြီး dashboard နဲ့ dashboard-only subsystem တွေကိုပိတ်ထားသည်။ → [Headless Mode](docs/guides/HEADLESS.md) - **🔎 မော်ဒယ် ရှာဖွေတွေ့ရှိမှု** — `/v1/models` ကို capability, context, kind နဲ့ text ဖြင့် filter လုပ်နိုင်ပြီး၊ `POST /v1/models/query` က တူညီတဲ့ per-key visibility နဲ့ အတို deterministic shortlist တစ်ခုကို ပြန်ပေးသည်။ → [API Reference](docs/reference/API_REFERENCE.md) - **🔑 Per-key routing ထိန်းချုပ်မှု** — `forcedModel` ဖြင့် API key တစ်ခုကို မော်ဒယ် သို့မဟုတ် combo တစ်ခုသို့ pin လုပ်နိုင်ပြီး၊ key ရဲ့ မော်ဒယ်တွေနဲ့ combo တွေကို atomically ထည့်/ဖြုတ်နိုင်သည် (`/api/keys/{id}/access`)။ → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ ပိုသေးစိတ်တဲ့ PII ထိန်းချုပ်မှုများ** — type အလိုက် ရွေးချယ်နိုင်မှု၊ အတည်ပြုပြီးသော စိတ်ကြိုက် masking pattern ၂၀ ခုအထိနဲ့ type အလိုက် detection counter များ; masking ကိုယ်တိုင်ကတော့ opt-in အဖြစ်သာ ဆက်ရှိနေသည်။ → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 ဘာသာစကား ၆၇ ခု** — dashboard, docs mirror များနဲ့ CLI အတွက်၊ `npm run i18n:add-locale` က ဘာသာစကားတစ်ခုကို command တစ်ခုတည်းနဲ့ နေရာတိုင်းသို့ ထည့်ပေးသည်။ → [i18n Guide](docs/guides/I18N.md) - **🎛️ OmniConductor** — သင့် agent fleet သို့ inbound A2A delegation၊ Agent Card ပေါ်က Conductor skill များ၊ Faro push-to-talk voice chat ပါဝင်တဲ့ dashboard panel တစ်ခု။ → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptive admission & overload ကာကွယ်မှု** — heavyweight chat request တွေကို 503 မဖြစ်စေဘဲ queue ထဲတင်ပေးပြီး၊ connection တစ်ခုချင်းစီအတွက် atomic RPM rolling lease များ အသုံးပြုသည်။ → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Canonical `/v1/models` စီစဉ်မှု** — provider တစ်ခုချင်းစီအတွက် provider-အုပ်စုလိုက် ဆက်စပ် block တစ်ခုချင်း (combo တွေကို အရင် pin ထား)၊ catalog source အားလုံးမှာ တည်ငြိမ်နေသည်။ → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Compression ခိုင်မာစေခြင်း** — default-on inflation guard၊ DE / FR / JA + တရုတ် (wényán) အတွက် Caveman pack များ၊ Gradle & .NET အတွက် RTK filter များ။ → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 ရိုးသားတဲ့ flat-rate ကုန်ကျစရိတ်** — subscription / coding-plan provider တွေကို cost analytics မှာ **$0** အဖြစ် ဖော်ပြပြီး; budget, quota & routing ကတော့ ခန့်မှန်းချက်တွေ ဆက်လုပ်နေသည်။ → [API Reference](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share routing** — shared account တစ်ခုရဲ့ quota ကို pooled key တွေကြား မျှတစွာ ခွဲဝေပြီး၊ idle slice တွေကို အခြားသူများအား ငှားထားနိုင်အောင် work-conserving ဖြစ်သည်။ → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Command တစ်ခုတည်း CLI/agent setup** — register လုပ်ထားတဲ့ `setup-*` command ၁၅ ခု; `omniroute run` က CLI ၇ ခု (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ကို launch လုပ်သည်; `omniroute configure` က interactive provider+model picker နဲ့ per-context favorites ဖြင့် target ၁၁ ခုကို support လုပ်သည်။ → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Remote မုဒ်** — scoped token များ (`connect` / `contexts` / `tokens`) ဖြင့် remote OmniRoute ကို ထိန်းချုပ်နိုင်ပြီး၊ VPS install များအတွက် `antigravity` OAuth helper ပါ။ → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 ပိုဉာဏ်ရည်မြင့်တဲ့ auto-routing** — `auto/:` combo များ၊ **Fusion** (model panel + judge), task-aware routing, per-request model / mode / USD-budget override များ။ → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Pluggable compression** — composable engine ၁၂ ခု + Compression Studios: LLMLingua-2, two-tier Ultra, omniglyph, per-step fidelity gate, GCF v3.2, drag-reorder editor။ → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparent MITM decrypt (TPROXY)** — proxy env var တွေကို လျစ်လျူရှုတဲ့ CLI တွေကို ဖမ်းဆီးနိုင်ပြီး၊ per-SNI CA + trust-store installer ပါဝင်သည်။ → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 နေရာတိုင်းမှာ cost telemetry** — endpoint တိုင်းမှာ `X-OmniRoute-*` cost/usage header များ၊ cache-HIT savings header၊ per-key USD spend quota များ။ → [API Reference](docs/reference/API_REFERENCE.md) - **🧠 သင်ထိန်းချုပ်နိုင်တဲ့ memory** — default အဖြစ် ပိတ်ထား၊ opt-in int8 vector quantization + typed decay၊ per-request `x-omniroute-no-memory`။ → [Memory](docs/frameworks/MEMORY.md) - **🛡️ လုံခြုံမှု** — LLM route တိုင်းမှာ prompt-injection guard (red-team suite), opt-in credential-masking guardrail (ပေါက်ကြားသွားတဲ့ API key/secret တွေကို နှစ်ဘက်စလုံးမှာ redact လုပ်ပေး), အခမဲ့ DuckDuckGo last-resort web search, dashboard အတွက် optional OIDC login gate (password login ကတော့ အမြဲရနိုင်ဆဲ)။ → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ Endpoint အသစ်များ** — `/v1/ocr` (Mistral OCR) နဲ့ `/v1/audio/translations` (Whisper-style) တို့က media surface ကို ပြည့်စုံစေသည်။ → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 ပုံရိပ် / ဗီဒီယို / အသံ ထုတ်လုပ်မှု** — media အတွက် API တစ်ခုတည်း: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, ElevenLabs ကဲ့သို့ speech provider များ။ → [API Reference](docs/reference/API_REFERENCE.md) - **🌍 Deployment & ops** — reverse-proxy `basePath`, browser-language auto-detect, per-key device tracking, root-less MITM trust, zh-TW localization။ → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Provider နဲ့ agent ပိုများလာသည်** — cloud agent များ (Codex Cloud, Cursor, Devin, Jules), browser + OAuth login ပါတဲ့ Grok Build (xAI), Ollama first-class card, Claude Opus 5 & Sonnet 5, Kimi တရားဝင် မိတ်ဆွေဖက် (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… နဲ့ ပြန်လည်ဆန်းသစ်ထားတဲ့ **375-provider catalog**။ → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Routing ပွင့်လင်းမြင်သာမှု** — response တိုင်းမှာ ၎င်းကို ဝန်ဆောင်မှုပေးတဲ့ strategy/provider/latency ကို ဖော်ပြတဲ့ `X-OmniRoute-Decision` header ပါဝင်ပြီး၊ `cache-optimized` combo strategy အသစ် + Auto-Combo `cacheAffinity` factor က ထပ်လာတဲ့ request တွေကို cached prefix ကိုင်ဆောင်ထားတဲ့ connection ဆီ ပြန်ပို့ပေးသည်၊ read-only `/v1/auto-combo/{channel}/candidates` endpoint ကလည်း `auto/*` channel တစ်ခုရဲ့ live candidate pool ကို ဖော်ပြပေးသည်။ → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ ဒေသတွင်း စွမ်းဆောင်ရည်နှင့် အခြေခံအဆောက်အအုံ** — တစ်ချက်နှိပ်ရုံဖြင့် အသုံးပြုနိုင်သော local Redis၊ Cloudflare Workers / Deno Deploy relay deployer များ၊ ကြီးကြပ်ခံ embedded service များအဖြစ် ပါဝင်သော Bifrost နှင့် Mux။ → [Embedded ဝန်ဆောင်မှုများ](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 ထပ်ပါဝင်သောအရာများ** — plugin framework + marketplace၊ Omni/Agent/GitHub skills framework များ၊ Obsidian vault ပေါင်းစည်းမှု (MCP tool 22 ခု)၊ OpenAI-compatible Batch & Files API များ၊ semantic response cache၊ leaderboard များပါ gamification၊ ACP agent ရှာဖွေတွေ့ရှိမှု (built-in agent 15 ခု)၊ BigQuery သို့ စီစဉ်ထားသော log တင်ပို့မှု၊ `auto/chaos` parallel multi-model fan-out၊ Telegram bot တံတား၊ app အတွင်းရှိ version manager နှင့် LMArena-ELO free-provider အဆင့်သတ်မှတ်ချက်များ။ → [စာရွက်စာတမ်းများ](docs/README.md)

## 🤖 တွဲဖက်အသုံးပြုနိုင်သော CLI များနှင့် Coding Agent များ > Config တစ်ခုတည်း — `http://localhost:20128/v1` — ဖြင့် AI IDE သို့မဟုတ် CLI **တိုင်းကို** အခမဲ့နှင့် ကုန်ကျစရိတ်သက်သာသော မော်ဒယ်များပေါ်တွင် အသုံးပြုနိုင်သည်။

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

＋ အောက်ပါတို့နှင့်လည်း အလုပ်လုပ်သည် · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · OpenAI နှင့် တွဲဖက်အသုံးပြုနိုင်သော မည်သည့်ကိရိယာမဆို

_{📖 ကိရိယာ 37 ခုစလုံးအတွက် ကိရိယာတစ်ခုချင်းစီအလိုက် စနစ်ထည့်သွင်းမှု (CLI Code 27 ခု + CLI Agent 10 ခု) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode ပလပ်အင် → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**ပံ့ပိုးထားသည့် မည်သည့် CLI ကိုမဆို command တစ်ခုတည်းဖြင့် OmniRoute မှတစ်ဆင့် စတင်ပါ** — config ဖိုင်များ ရေးသားခြင်းမရှိဘဲ၊ လုပ်ငန်းစဉ်တစ်ခုချင်းစီအလိုက် အထောက်အထားများကို ထည့်သွင်းပေးပြီး Qwen/Gemini အတွက် တစ်ခါသုံး သီးခြား home ကို အသုံးပြုသည်- ```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 ကို အပြန်အလှန်ရွေးချယ်ပြီး ကိရိယာ၏ ကိုယ်ပိုင် config ကို ရေးသားပါ- omniroute configure codex # ထို့အပြင်- claude opencode qwen aider goose gemini cline continue kilo 5dive ``` command တိုင်းသည် လက်ရှိအသုံးပြုနေသော အဝေးထိန်း context (`omniroute connect `) ကို လိုက်နာပြီး၊ `--dry-run` သည် လုပ်ဆောင်ခြင်းမပြုမီ env/args အတိအကျကို အစမ်းကြည့်ရှုနိုင်စေကာ `--api-key-env NAME` သည် လျှို့ဝှက်ချက်များကို သင်၏ shell history ထဲ မဝင်စေရန် ကာကွယ်ပေးသည်။ → [CLI ပေါင်းစည်းမှုများ](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 AI ပံ့ပိုးပေးသူ 375 ခု — Catalog တွင် အခမဲ့ဟု မှတ်သားထားသော 153 ခု

> **မှတ်ပုံတင်ထားသော ပံ့ပိုးပေးသူ 375 ခု** သည် canonical chat, media, search, local, cloud-agent နှင့် system collection များတွင် ပါဝင်ပြီး **`hasFree: true` discovery metadata ကို ဆောင်ထားသော 153 ခု** အပါအဝင်ဖြစ်သည်။ chat model registry တွင် **ပံ့ပိုးပေးသူ 239 ခု / ထူးခြားသော provider-model စုံတွဲ 3,059 ခု / raw model ID 1,475 ခု** ပါဝင်သည်။ သီးခြားစီရှိသော free-budget catalog တွင် **model တစ်ခုချင်းစီအတွက် row 467 ခု**၊ **ပြန်လည်ဖြစ်ပေါ်နေသော pool 34 ခု** နှင့် **ပြန်လည်ဖြစ်ပေါ်/keyless အစဉ်အမြဲအခမဲ့ ပံ့ပိုးပေးသူ 51 ခု** ရှိသည်။ ဤသည်များမှာ ဒီဇိုင်းအရ ကွဲပြားသော denominator များဖြစ်သည်။ အဓိပ္ပာယ်ဖွင့်ဆိုချက်များနှင့် pool-deduped တွက်ချက်မှုများကို [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) နှင့် [Free Tiers](docs/reference/FREE_TIERS.md) တွင် ကြည့်ရှုနိုင်သည်။

### 🏢 အဓိက lab အားလုံး — endpoint တစ်ခုတည်းမှတဆင့်

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

_{…နှင့် အခြား 350+ ခုခန့် — icon တိုင်းသည် dashboard ၏ provider catalog မှ တိုက်ရိုက် resolve ဖြစ်နေသည်။ 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 အစဉ်အမြဲအခမဲ့ — $0၊ ကတ်မလို

OpenCode Zen _{DeepSeek V4, Nemotron 3 တိုကင်အကန့်အသတ်မရှိ}	Kilo Code _{Auto-router, 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 key မလိုအပ်}	Cloudflare AI _{မော်ဒယ် 50+ 10K neurons/နေ့}	NVIDIA NIM _{GLM, MiniMax ~40 RPM အခမဲ့}	Cerebras _{GLM 4.7, GPT-OSS တစ်ကြိမ်သာ $5 credit; ကတ်လိုအပ်သည်}	OpenRouter _{:free မော်ဒယ်များ +$10 → RPM ပိုမြင့်}

📖 စက်ဖြင့် ဖတ်ရှုနိုင်သော catalog အပြည့်အစုံ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ OmniRoute လည်ပတ်နိုင်သည့်နေရာ — နေရာတိုင်း

> အက်ပ်တစ်ခုတည်း၊ သင့်စက်၊ သင့်စည်းမျဉ်းများ။ ကမ္ဘာလုံးဆိုင်ရာ npm ထည့်သွင်းမှုမှ Termux မှတစ်ဆင့် **သင့်ဖုန်းပေါ်** အထိ။

ပလက်ဖောင်း	ထည့်သွင်းမှု	အဓိကအချက်များ
📦 npm (ကမ္ဘာလုံးဆိုင်ရာ)	`npm install -g omniroute`	command တစ်ခုတည်းဖြင့် မည်သည့် OS တွင်မဆို
🐳 Docker	`docker run … diegosouzapw/omniroute`	ဗိသုကာမျိုးစုံသုံး AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	မူရင်း window + system tray — Windows / macOS / Linux
🎩 Menu-bar (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	ဆာဗာကို ကြီးကြပ်ပြီး အလိုအလျောက်အပ်ဒိတ်လုပ်ပေးသည် — macOS
💪 ARM	မူရင်း `arm64`	Raspberry Pi၊ ARM ဆာဗာများ၊ Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	သင့်ဖုန်းပေါ်တွင် 24/7 လည်ပတ်ပြီး root မလိုပါ
📲 PWA	"ပင်မမျက်နှာပြင်သို့ ထည့်ရန်"	မျက်နှာပြင်အပြည့်၊ အော့ဖ်လိုင်း၊ browser မှ ထည့်သွင်းနိုင်မှု
🧩 OpenCode plugin	`@omniroute/opencode-provider`	မူရင်း OpenCode ပေါင်းစပ်မှု
🤖 VS Code Copilot Chat	OmniCopilot extension ကို ထည့်သွင်းပါ	မူရင်း Copilot Chat ရွေးချယ်ကိရိယာအတွင်းရှိ OmniRoute model အားလုံး — stable နှင့် Insiders
🛠️ source မှ	`npm install && npm run dev`	ပြင်ဆင်စမ်းသပ်ပြီး ပါဝင်ကူညီပါ

_{📖 [Docker လမ်းညွှန်](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Menu-bar tray](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 အသစ်: VS Code ၏ မူရင်း Copilot Chat အတွင်းရှိ OmniRoute

> sidebar အသစ်လည်း မလို၊ chat UI အသစ်လည်း မလိုပါ — OmniRoute က ဝန်ဆောင်မှုပေးသည့် model အားလုံးသည် > **သင်အသုံးပြုနေပြီးသား Copilot Chat model ရွေးချယ်ကိရိယာ** ထဲတွင် တိုက်ရိုက်ပေါ်လာပါသည်။ VS Code 1.122 မှစ၍ provider model များသည် > GitHub အကောင့်ဝင်ခြင်း သို့မဟုတ် Copilot subscription မပါဘဲ အလုပ်လုပ်ပါသည် — agent mode၊ tool calling နှင့် vision တို့ကို > အခမဲ့ အသုံးပြုနိုင်သည်။ **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** extension ကို ထည့်သွင်းပြီး သင့် OmniRoute ဆာဗာသို့ ညွှန်ပေးပါ (မူလတန်ဖိုးမှာ `localhost:20128`)၊ ထို့နောက် Copilot Chat → model ရွေးချယ်ကိရိယာ → **Model များကို စီမံရန်…** → **OmniRoute** ကို ဖွင့်ပါ။

Store	လင့်ခ်	တွဲဖက်အသုံးပြုနိုင်သည့်အရာများ
🧩 VS Code Marketplace	ထည့်သွင်းရန် →	VS Code — stable နှင့် Insiders
🔓 Open VSX Registry	ထည့်သွင်းရန် →	Cursor၊ Windsurf၊ VSCodium၊ Theia၊ code-server၊ Gitpod၊ Antigravity၊ Kiro…

Editor အတွင်းမှ **Extensions** မြင်ကွင်းကို ဖွင့်ပြီး **"OmniRoute"** ဟု ရှာကာ **ထည့်သွင်းရန်** ကို နှိပ်ပါ — store နှစ်ခုစလုံးတွင် အလုပ်လုပ်ပုံ အတူတူဖြစ်သည်။ Source၊ issue များနှင့် ဖြန့်ချိရေး runbook ကို [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) တွင် ရရှိနိုင်သည်။ _{📖 [VS Code Copilot Chat လမ်းညွှန်](docs/guides/VSCODE-COPILOT.md) — စနစ်ထည့်သွင်းမှု၊ ရွေးချယ်ကိရိယာတွင် ပြသသည့်အရာများ၊ tab တစ်ခုအတွင်းရှိ dashboard၊ ပြဿနာဖြေရှင်းခြင်း}

### 🎩 အသစ်: OmniRouteTray — menu bar တွင် အမြဲရှိနေမည့် သင့် gateway

> `omniroute serve` သည် အမြဲဖွင့်ထားသည့်အခါ အကောင်းဆုံး အလုပ်လုပ်ပါသည်။ **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > က ယင်းကို macOS အတွက် တစ်ခါသတ်မှတ်ပြီး စိတ်ချထားနိုင်သည့် menu-bar အက်ပ်အဖြစ် ပြောင်းလဲပေးသည်။ ၎င်းက ဆာဗာကို စတင်ပေးပြီး reboot လုပ်ပြီးနောက်တွင်လည်း > ဆက်လက်လည်ပတ်နေစေကာ လက်ရှိနေရာတွင် အပ်ဒိတ်လုပ်ပေးသည့်အပြင် သင့် live token budget ကို တစ်ချက်နှိပ်ရုံဖြင့် ကြည့်နိုင်စေသည် — **ဖွင့်ထားရမည့် > terminal window မလိုသလို `npm install -g omniroute` ကိုလည်း အမြဲစောင့်ကြည့်ပေးနေရန် မလိုပါ။** [Tauri v2](https://v2.tauri.app/) ဖြင့် တည်ဆောက်ထားပြီး (ပမာဏမှာ အနီးစပ်ဆုံးတွက်ချက်မှုအမှားလောက်သာရှိသည့် Rust core) ၎င်းတွင် ကိုယ်ပိုင် လက်မှတ်ထိုးထားသော Node 24 runtime ပါဝင်ကာ အက်ပ်ပိုင် OmniRoute ထည့်သွင်းမှုကို စီမံပေးသောကြောင့် သင့် ကမ္ဘာလုံးဆိုင်ရာ `node`/`bun` နှင့် မည်သည့်အခါမျှ ပဋိပက္ခမဖြစ်ပါ။ ၎င်းသည် **သင်၏ ရှိပြီးသား `~/.omniroute/` config နှင့် database ကို မျှဝေအသုံးပြုသည်** — ထို့ကြောင့် ၎င်းသည် သင်လည်ပတ်နေပြီးသား OmniRoute အတူတူပင်ဖြစ်ပြီး ဦးထုပ်တစ်လုံးသာ ဆောင်းထားခြင်းဖြစ်သည်။ 🎩

လုပ်ဆောင်ပေးသည့်အရာ	လုပ်ဆောင်ပုံ
🟢 ဆာဗာကို ကြီးကြပ်သည်	`omniroute serve` ကို စတင်ပြီး ထပ်တူ instance တစ်ခု ဖန်တီးမည့်အစား လည်ပတ်နေပြီးသား instance ကို အသုံးပြုသည်
📊 Live အသုံးပြုမှုကို တစ်ချက်ကြည့်နိုင်သည်	Provider quota bar များ၊ reset countdown များပါရှိသည့် Claude session/အပတ်စဉ် ကန့်သတ်ချက်များ၊ ရက် 30 ကုန်ကျစရိတ်ခွဲခြမ်းစိတ်ဖြာမှု
🔄 လက်ရှိနေရာတွင် အလိုအလျောက်အပ်ဒိတ်လုပ်သည်	အဆင့်လိုက်ထည့်သွင်းမှု၊ atomic swap၊ မအောင်မြင်ပါက rollback — နောက်ဆုံး release ကို အမြဲအသုံးပြုနိုင်သည်
🚀 အကောင့်ဝင်ချိန်တွင် စတင်သည်	အကောင့်ဝင်ချိန်တွင် စတင်ရန် ရွေးချယ်နိုင်သည်၊ tray တွင်သာရှိပြီး dock icon မပါပါ
🩺 Doctor နှင့် log များ	တစ်ချက်နှိပ်ရုံဖြင့် စစ်ဆေးရှာဖွေမှုများ ပြုလုပ်နိုင်ပြီး ဆာဗာ log များကို ဝင်ရောက်ကြည့်ရှုနိုင်သည်

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{ဒေါင်းလုဒ်ရယူလိုပါသလား။ နောက်ဆုံးထွက် .dmg ကို
Releases မှ ရယူပါ။ Source၊ issues နှင့် build
ဆိုင်ရာ စာရွက်စာတမ်းများကို zoispag/omniroute-tray တွင် ရရှိနိုင်ပါသည်။

💛 @zoispag မှ ဖန်တီးထားသော community project တစ်ခုဖြစ်ပြီး တရားဝင် OmniRoute release မဟုတ်ပါ။}

## 🔒 သီးသန့်ဖြစ်ပြီး Local-First

_{📖 [ခွင့်ပြုချက်သတ်မှတ်ခြင်း](docs/architecture/AUTHZ_GUIDE.md) · [အကာအကွယ်စည်းမျဉ်းများ](docs/security/GUARDRAILS.md) · [စည်းမျဉ်းလိုက်နာမှု](docs/security/COMPLIANCE.md)}

## 🔌 ပြည့်စုံသော CLI + A2A နှင့် MCP

> ဆာဗာအပြင် OmniRoute သည် **command 80+ ပါဝင်သော ပြည့်စုံသည့် command-line ထိန်းချုပ်ခန်း**တစ်ခုဖြစ်ပြီး၊ AI agent တစ်ခုက **ကိုယ်တိုင်** ထိန်းချုပ်မောင်းနှင်နိုင်စေရန် open agent protocol များလည်း ပါဝင်သည်။ ### ⌨️ တကယ့် CLI (`start` တစ်ခုတည်းသာ မဟုတ်ပါ) ```bash omniroute # gateway + dashboard ကို ဝန်ဆောင်မှုပေးရန် (port 20128) omniroute chat # အပြန်အလှန်တုံ့ပြန်နိုင်သော TUI chat client (slash: /model /combo /skill /memory) omniroute setup # လမ်းညွှန်ချက်ပါသော ပထမဆုံးအသုံးပြုမှု wizard omniroute doctor # provider များ၊ port များနှင့် native dependency များကို စစ်ဆေးဖော်ထုတ်ရန် ``` ### 🛰️ Remote mode — CLI ကို ဤနေရာတွင် အသုံးပြုပြီး OmniRoute ကို VPS ပေါ်တွင် လည်ပတ်ပါ OmniRoute ကို ဆာဗာတစ်ခုပေါ်တွင် လည်ပတ်နေပါသလား။ **တူညီသော CLI** ကို အသုံးပြုပြီး သင့် laptop မှ ထိန်းချုပ်ပါ။ Scope သတ်မှတ်ထားသော access token ဖြင့် တစ်ကြိမ် login ဝင်ပြီးနောက် command အားလုံးသည် remote ကို ဦးတည်လုပ်ဆောင်မည်ဖြစ်သည်။ ```bash omniroute connect 192.168.0.15 # password → scope သတ်မှတ်ထားသော token၊ context တစ်ခုအဖြစ် သိမ်းဆည်းသည် omniroute models # ← REMOTE server တွင် လုပ်ဆောင်သည် omniroute configure codex # ← remote model တစ်ခုကို ရွေးချယ်ပြီး local Codex profile တစ်ခုကို ရေးသားသည် omniroute tokens create --name ci --scope read # အခြားစက်များအတွက် ပိုမိုကန့်သတ်ထားသော token များ ထုတ်ပေးသည် omniroute contexts use default # ← local server သို့ ပြန်ပြောင်းသည် ``` Token များတွင် `read` / `write` / `admin` scope များ သတ်မှတ်ထားပြီး process စတင်ပေးသော route များကို loopback တွင်သာ ကန့်သတ်ထားသည်။ _{📖 [Remote Mode](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI ကို သရုပ်ပြသည့် လှုပ်ရှားနေသော terminal — omniroute providers list၊ omniroute combo list နှင့် omniroute health — command 89 ခုပါသော top-level မျက်နှာပြင်တစ်လျှောက် အလှည့်ကျပြသသည်: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 Agent တစ်ခုကို ချိတ်ဆက်ပါ — ထို့နောက် ၎င်းက OmniRoute ကို ကိုယ်တိုင်ထိန်းချုပ်နိုင်သည် OmniRoute ကို **MCP**၊ **A2A**၊ **REST API**၊ **webhooks** သို့မဟုတ် **remote CLI** မှတစ်ဆင့် ဖွင့်ပေးပါ — လုပ်ဆောင်နိုင်စွမ်းရှိသော မည်သည့် agent မဆို (သို့မဟုတ် သင့်ကိုယ်ပိုင် code) သည် routing၊ provider များ၊ combo များ၊ cache၊ compression နှင့် memory အပါအဝင် gateway တစ်ခုလုံးကို အလိုအလျောက် ထိန်းချုပ်နိုင်မည်ဖြစ်သည်။ အောက်ပါ HTTP endpoint များကို `http://localhost:20128` အောက်တွင် ဝန်ဆောင်မှုပေးထားသည်။

Interface	Endpoint / command	အသုံးပြုရန်
🧰 MCP (stdio)	`omniroute --mcp`	Claude Desktop၊ Cursor သို့မဟုတ် မည်သည့် MCP client နှင့်မဆို ချိတ်ဆက်ရန်
🌊 MCP (HTTP)	`/api/mcp/stream`	Remote MCP — tool 110 ခု၊ scope 33 ခု (အကောင်အထည်ဖော်ကန့်သတ်မှုကို ရွေးချယ်ဖွင့်နိုင်သည်)၊ audit trail အပြည့်အစုံ
📡 MCP (SSE)	`/api/mcp/sse`	Streaming MCP transport
🤝 A2A	`/.well-known/agent.json`	Agent အချင်းချင်း ဆက်သွယ်မှု၊ JSON-RPC 2.0 + SSE၊ skill 6 ခု
🌐 REST API	`/v1/*`	OpenAI နှင့် တွဲဖက်အသုံးပြုနိုင်သည် — chat၊ embedding များ၊ image များ၊ audio နှင့် OCR
🔔 Webhooks	`/api/webhooks`	Request / quota event များကို Slack၊ Discord၊ Telegram သို့မဟုတ် မည်သည့် URL သို့မဆို ပို့ရန်
🛰️ Remote CLI	`omniroute connect`	Scope သတ်မှတ်ထားသော access token များဖြင့် remote instance တစ်ခုကို ထိန်းချုပ်ရန်

```bash # Claude Code ကို MCP မှတစ်ဆင့် OmniRoute toolset အပြည့်အစုံ အသုံးပြုခွင့်ပေးရန်: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP Server](docs/frameworks/MCP-SERVER.md) · [A2A Server](docs/frameworks/A2A-SERVER.md) · [Agent Protocols](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Token 15–95% သက်သာစေပါသည် — အလိုအလျောက်

### 📖 အလုပ်လုပ်ပုံ — pipeline၊ ဗိသုကာပုံစံနှင့် သက်သာမှုတွက်ချက်နည်း

OmniRoute compression pipeline: ပုံဖော်ထားသော 10,000-token client request တစ်ခုသည် composable engine ၁၂ ခု — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra နှင့် OmniGlyph — ကို ဖြတ်သန်းသွားကာ မှတ်တမ်းတင်ထားသော stacked ဥပမာအရ provider ဆီသို့ token ခန့်မှန်း 1,080 ဖြင့် ရောက်ရှိနိုင်ပါသည်။ Structured content ကို preservation guard များနှင့် အဆင့်ချင်း fidelity gate များဖြင့် ကာကွယ်ထားပါသည်။ explicit lossy သို့မဟုတ် experimental mode များက အရည်အချင်းပြည့်မီသော content ကို ပြောင်းလဲနိုင်ပါသည်။

မူရင်း stacked combo သည် `RTK → Caveman` ကို run ပါသည်။ နှစ်ခုလုံးက tool/context payload တစ်ခုတည်းပေါ်တွင် လုပ်ဆောင်သောအခါ သက်သာမှုများ ပေါင်းစည်းကြီးထွားသွားပါသည်: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Code block များ၊ URL များ၊ JSON နှင့် structured data များကို preservation engine က **အမြဲတမ်း ကာကွယ်ပေးထားပါသည်**။ > **Token အနည်းငယ်နဲ့ အလုပ်လုံလောက်ရင် Token များများ ဘာလို့သုံးရမှာလဲ?** Request တိုင်းကို OmniRoute ၏ compression pipeline မှ **transparent** အနေဖြင့် ဖြတ်သန်းစေပါသည် — client ဘက်မှ ပြောင်းလဲမှုမလိုပါ။ ယခုအခါ၎င်းသည် အစဉ်အတိုင်း run ပြီး routing combo တစ်ခုချင်းစီအလိုက် mix & match လုပ်နိုင်သော **composable engine ၁၂ ခုပါ stack** ဖြစ်နေပါပြီ — [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) တို့၏ အကြံဉာဏ်များပေါ် အခြေခံထားပါသည်။ ### 🧱 Engine ၁၂ ခုပါ stack Engine များသည် pipeline အစဉ်အတိုင်း run ပါသည်။ တစ်ခုချင်းစီကို သီးခြားစီ on/off ပြောင်းနိုင်ပြီး combo အလိုက် configure လုပ်နိုင်ပါသည်:

#	Engine	လုပ်ဆောင်ချက်
1	Session-Dedup	Turn များအကြား ထပ်ခါထပ်ခါပါဝင်သော content ကို ဖယ်ထုတ်သည် (content-addressed, cross-turn)
2	CCR	Block ကြီးများကို retrieve marker များနောက်ကွယ်တွင် archive သိမ်းဆည်းထားပြီး လိုအပ်ချက်အလိုက် ပြန်လည်ခေါ်ယူသည်
3	Lite	Whitespace + image-URL ဖြတ်ထုတ်ခြင်း (latency သယ်ပေါ့သော baseline)
4	RTK	စမတ်ကျသော tool-result စစ်ထုတ်ခြင်း၊ dedup နှင့် truncation (command-aware)
5	Responses Tool Output	shell/patch/search/build output များအတွက် lossless-first JSON + ကန့်သတ်ထားသော diagnostic compression (Responses API)
6	Headroom	vendored GCF codec ဖြင့် JSON array များ၏ lossless tabular compaction (~30%)
7	Relevance	နောက်ဆုံး user query နှင့် ဆင်စဉ်းတွက်ချက်၍ extractive sentence scoring ပြုလုပ်သည်
8	Caveman	စည်းမျဉ်းအခြေခံ prose compression (output ပေါ်တွင် ~65–75%)
9	Aggressive	အနှစ်ချုပ်ခြင်း + turn အဟောင်းများ၏ တဖြည်းဖြည်း aging လုပ်ခြင်း
10	LLMLingua-2	MobileBERT ONNX မှတစ်ဆင့် ML semantic pruning — code-safe, async
11	Ultra	optional small-model (SLM) tier ပါဝင်သော heuristic token pruning
12	OmniGlyph	တိုင်းထွာအတည်ပြုပြီးသော Claude Fable 5 အတွက် direct Anthropic wire ပေါ်ရှိ experimental context-as-image encoding; GPT 5.6 transformers များက provider receipts မရရှိမချင်း fail-closed အနေအထားတွင် ဆက်လက်ရှိနေပါသည်။ Compression profile လေးမျိုး (aggressive default, balanced, coding-safe, passthrough) (အပြင်းထန်ဆုံး; opt-in)

Code block များ၊ URL များနှင့် structured data များကို **အမြဲတမ်း** byte-perfect အတိအကျ ထိန်းသိမ်းထားပါသည်။ **One-click preset များ**က engine များကို ပေါင်းစည်းပေးပါသည်:

Mode	သက်သာမှု	အသင့်တော်ဆုံး အသုံးပြုမှု
🪶 Lite	~15%	အမြဲဖွင့်ထားနိုင်သော ဘေးကင်းသော မူရင်းပြင်ဆင်ချက်
🪨 Standard (Caveman)	~30%	နေ့စဉ် coding လုပ်ငန်း
⚡ Aggressive	~50%	Tool အသုံးများသော session ရှည်ကြီးများ
🔥 Ultra	~75%	အမြင့်ဆုံး သက်သာမှု
🧰 RTK	60–90%	Shell/test/build/git output များ
🔗 Stacked (RTK → Caveman)	78–95%	ရောနှောနေသော prompt များ + tool log များ

**အစစ်အမှန်ဥပမာ — Standard mode:** > **မပြောင်းလဲခင် (69 token):** _"သင့် React component ပြန် render ဖြစ်နေရခြင်း အကြောင်းရင်းမှာ render cycle တစ်ခုချင်းစီမှာ object reference အသစ်တစ်ခုကို ဖန်တီးမိနေလို့ ဖြစ်နိုင်ပါတယ်။ Inline object ကို prop အဖြစ် pass လုပ်တဲ့အခါ React ရဲ့ shallow comparison က ၎င်းကို အကြိမ်တိုင်းမှာ object ကွဲတစ်ခုအဖြစ် မြင်သွားပြီး re-render ကို ဖြစ်စေပါတယ်။ အဲ့ဒီ object ကို memoize လုပ်ဖို့ useMemo ကို သုံးဖို့ အကြံပြုပါတယ်။"_ > > **ပြောင်းလဲပြီး (19 token):** _"Render တိုင်းမှာ object ref အသစ်။ Inline object prop = ref အသစ် = re-render။ useMemo နဲ့ wrap လုပ်ပါ။"_ > > **အဖြေအတူတူပဲ။ Token 72% ပိုနည်းသွားသည်။ တိကျမှုဆုံးရှုံးမှု သုည။** ✅ **PT-BR ဥပမာ — [Troglodita](https://github.com/leninejunior/troglodita) mode:** > **အရင် (tokens 42):** _"ပြဿနာက render cycle တစ်ခုချင်းစီတွင် object reference အသစ်တစ်ခု ဖန်တီးနေသောကြောင့် component သည် re-render ဖြစ်နေခြင်း ဖြစ်သည်။ useMemo ကို အသုံးပြုရန် အကြံပြုပါမည်။"_ > > **နောက်ပိုင်း (tokens 12):** _"Re-render: cycle တိုင်းတွင် ref အသစ် (inline object ပြန်ဖန်တီးနေ)။ `useMemo` သုံးပါ။"_ > > **အဖြေတူတူပဲ။ tokens ~70% လျော့နည်းသွား။ နည်းပညာဆိုင်ရာ တိကျမှု အပြည့်အဝရှိ။** ✅
### 🎚️ Engine များအပြင် — output style များ၊ adaptive dial နှင့် request တစ်ခုချင်းစီ ထိန်းချုပ်မှု အထက်ပါ engine 12 ခုသည် **ဝင်လာသော** အရာကို သေးငယ်စေသည်။ နောက်ထပ် layer သုံးခုက **မည်သို့**၊ **မည်သည့်အခါ** နှင့် **ထွက်လာသော** အရာကို ပုံဖော်ပေးသည်။ - **🪄 Output Styles** _(output-axis steering)_ — deterministic ဖြစ်ပြီး cache-လုံခြုံသော response-ပုံဖော်ညွှန်ကြားချက်များကို ထည့်သွင်းပေးသည်။ ပေါင်းစပ်အသုံးပြုနိုင်ပြီး တစ်ခုချင်းစီကို `lite` / `full` / `ultra` intensity ဖြင့် ချိန်ညှိနိုင်သည်။ style တစ်ခုထည့်ရန်မှာ registry entry တစ်ကြောင်းသာ လိုအပ်သည်။ - **Terse prose** — filler / article / hedging များကို ဖျက်ပြီး နည်းပညာဆိုင်ရာ အနှစ်သာရကို တိကျစွာ ထားရှိသည်။ - **Less code** — "lazy senior dev" YAGNI: အလုပ်လုပ်သော အသေးဆုံး ပြောင်းလဲမှု၊ မတောင်းဆိုထားသော scaffolding မပါ။ - **Ponytail (lazy senior dev)** — YAGNI ladder ကို တက်ပါ၊ root cause ကို ပြင်ပါ၊ အလုပ်လုပ်သော အသေးဆုံး diff။ - **I have ADHD (action-first)** — နောက်လုပ်ရပ်ကို ဦးဆောင်စေပါ၊ အဆင့်များကို နံပါတ်စဉ်ပါ၊ concrete နောက်အဆင့် တစ်ခုတည်း၊ preamble မပါ။ - **Terse CJK (文言)** — classical-Chinese ultra-terse style (`zh` အတွက် locale-gated)။ - **🎯 Adaptive context-budget** _(dial)_ — on/off token threshold တစ်ခုတည်းအစား **model ၏ context window ထဲ ကိုက်ညီစေရန်** အဈေးဆုံးနှင့် အဆုံးရှုံးမှုအနည်းဆုံး engine များကို လိုအပ်သလောက်သာ တိုးချဲ့အသုံးပြုသည်။ Policy: `reserve-output` (default, model-aware) · `percentage` · `absolute`။ Mode: `floor` (fit ကို အာမခံ) · `replace-autotrigger` (သင်၏ ရှင်းလင်းသော ရွေးချယ်မှုက အဓိကျ) · `off` (legacy threshold)။ - **🎛️ Compression ကို ဆုံးဖြတ်သောနေရာ** _(precedence, high → low)_ — per-request `x-omniroute-compression` header › routing-combo override › active named profile › adaptive / auto-trigger › panel default › off။ အသုံးပြုထားသော plan သည် `X-OmniRoute-Compression: ; source=` response header တွင် ပြန်လည်ထွက်ပေါ်သည်။ token threshold ဖြင့် auto-trigger လုပ်ပါ၊ adaptive dial ကို ဖွင့်ပါ၊ named profile ကို pin ချိတ်ပါ၊ request တစ်ခုချင်းအတွက် တစ်ခါတည်း သတ်မှတ်ပါ၊ သို့မဟုတ် routing combo တစ်ခုချင်းစီအတွက် pipeline တစ်ခု သတ်မှတ်ပါ — workload နှင့် ကိုက်ညီသောနည်းကို ရွေးပါ။ ပြောင်းလဲမှုတစ်ခုကို promote မလုပ်မီ opt-in offline **eval harness** (`npm run eval:compression`) က pinned corpus ပေါ်တွင် fidelity နှင့် savings ကို ရမှတ်ပေးသည်။ 📖 [`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) Install လုပ်ပြီး run ပါ** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` သို့မဟုတ် peer-dep warning များ တွေ့ရသလား။ [အန္တရာယ်မရှိပါ](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)။ > **npm 11 သို့မဟုတ် ထိုအထက် သုံးနေပါသလား။** npm သည် ခွင့်ပြုထားခြင်းမရှိလျှင် package lifecycle script များကို ပိတ်ဆို့နိုင်သည်။ OmniRoute ၏ `postinstall` (`node scripts/build/postinstall.mjs`) သည် ၎င်း၏ native runtime ဖိုင်များကို ပြင်ဆင်ရန် လိုအပ်သည်။ globally install လုပ်သည့်အခါ npm ၏ warning တွင် ဖော်ပြထားသော package များကို ခွင့်ပြုပါ။ OmniRoute 3.8.53 မှ ဖော်ပြသော 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 > ``` > > dependency list သည် release များအကြားတွင် ပြောင်းလဲနိုင်သည်။ npm မှ မတူညီသောစာရင်း ဖော်ပြလျှင် ထို warning မှ package အမည်များကို သုံးပါ။ package တစ်ခုကို ခွင့်ပြုခြင်းသည် ၎င်း၏ install script များ run ခွင့်ပြုခြင်း ဖြစ်သည်။ > **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 ဖြင့် eligible provider တစ်ခုကို ချိတ်ဆက်ပါ** Dashboard → **Providers** → လက်ရှိ terms နှင့် quota က သင်၏ use case နှင့် ကိုက်ညီသော provider တစ်ခုကို ရွေးပါ → ၎င်း၏ API key ကို ထည့်ပါ သို့မဟုတ် ၎င်း၏ account flow ကို ပြီးမြောက်အောင်လုပ်ပါ။ Free tier များသည် signup၊ approval သို့မဟုတ် payment method လိုအပ်နိုင်သည်။ [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) ကို ကြည့်ပါ။ key မလိုဘဲ အသုံးပြုနိုင်မှုကို အာမမခံနိုင်ပါ။ ထို့ပြင် `tos: avoid` ဟု မှတ်သားထားသော provider များကို default အားဖြင့် `auto` မှ ဖယ်ထုတ်ထားသည်။ **3) သင်၏ coding tool ကို ညွှန်ပါ** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) အလုပ်လုပ်ကြောင်း အတည်ပြုပါ** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` သင် ချိတ်ဆက်ထားသော model များ စာရင်းပြကို တွေ့ရပါမည်။ 🎉 ဒါပါပဲ — coding စလုပ်ပါ၊ OmniRoute က သင့်အတွက် auto-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 ``` ၎င်းတို့ကို `Authorization: Bearer ...` မထည့်နိုင်သော client များအတွက်သာ သုံးပါ။ Header auth သည် ပဓာနရွေးချယ်စရာ mode အဖြစ် ဆက်လက်ရှိနေပါသည်။
## 📦 ထပ်ဆောင်း ထည့်သွင်းနည်းများ — Docker၊ source၊ 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) ကို ကြည့်ပါ။ Image တွင် **`OMNIROUTE_MEMORY_MB=1024`** ကို သတ်မှတ်ထားသည်။ ၎င်းသည် dashboard နှင့် ပေါ့ပါးသော chat အတွက် လုံလောက်ပါသည်။ **Coding agent များ** (Claude Code၊ Codex၊ Grok၊ … မှ `POST /v1/responses`) သည် ပိုမိုကြီးမားသော V8 heap လိုအပ်ပြီး မလိုအပ်သလောက်နည်းပါက ရှည်လျားသော context နှစ်ခု ထပ်နေချိန်တွင် ~12 GiB ခန့်၌ process သည် `FATAL ERROR` ဖြစ်ပါမည်။ Container ကို heap ထက် ပိုကြီးအောင် သတ်မှတ်ပါ (native buffer များသည် V8 ပြင်ပတွင် ရှိသည်)။ | အသုံးပြုမှု | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) | | ------------------------------------------------------------- | ------------------------------- | ---------------------- | | Dashboard / ပေါ့ပါးသော chat | `1024` (image မူလသတ်မှတ်ချက်) | ≥2 g | | Coding agent တစ်ခု | `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 လမ်းညွှန် — runtime RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents) တွင် ကြည့်ပါ။ > **အကြိုဖြန့်ချိမှု Docker ချန်နယ်:** `diegosouzapw/omniroute:next` နှင့် > `diegosouzapw/omniroute:next-web` သည် လက်ရှိ မူလသတ်မှတ်ထားသော `release/v*` > branch ကို လိုက်နာသည်။ ပြောင်းလဲနိုင်သော ဤ tag များသည် မဖြန့်ချိရသေးသည့် ပြင်ဆင်ချက်များကို စမ်းသပ်ရန်သာ ရည်ရွယ်ပြီး > **production အတွက် ပံ့ပိုးမထားပါ**။ [Docker ဖြန့်ချိမှုချန်နယ်များ](docs/guides/DOCKER_GUIDE.md#release-channels) ကို > ကြည့်ပါ။ **🥟 Bun** ပုံမှန် `bun install` နှင့် global ထည့်သွင်းခြင်း (`bun install -g omniroute`) တို့ကို Bun runtime စစ်ဆေးမှုမှတစ်ဆင့် ပံ့ပိုးထားသည်- - **ပါဝင်ပြီးသား `bun:sqlite`**: Bun အောက်တွင် လုပ်ဆောင်နေချိန်၌ OmniRoute သည် Bun ၏ ပါဝင်ပြီးသား `bun:sqlite` driver ကို အသုံးပြုပြီး Node.js သို့မဟုတ် `sql.js` တွင် `better-sqlite3` ကို အစားထိုးအသုံးပြုသည်။ - **Development တွင် Webpack bundler အလိုအလျောက် ရွေးချယ်ခြင်း**: Development (`bun run dev`) သည် Bun ကို အလိုအလျောက် စစ်ဆေးသိရှိပြီး native V8 binding မကိုက်ညီမှုများကို ကာကွယ်ရန် Turbopack ကို ပိတ်ကာ Webpack ကို အသုံးပြုသည်။ Production build များ (`bun run build`) သည် Node တွင်ကဲ့သို့ `OMNIROUTE_USE_TURBOPACK` ကို အတိအကျ လိုက်နာသည်- မူလအနေဖြင့် Turbopack ကို အသုံးပြုပြီး Webpack ဖြင့် build လုပ်ရန် `OMNIROUTE_USE_TURBOPACK=0` ကို အသုံးပြုပါ (`Dockerfile.bun` က ၎င်းကို `--build-arg` အဖြစ် ဖော်ထုတ်ပေးထားသည်)။ - **Bun အတွက် သီးသန့် Dockerfile**: Native Bun production deployment များအတွက် အဆင့်များစွာပါဝင်သော `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`)။ ```bash # Bun ဖြင့် ထည့်သွင်းပြီး လုပ်ဆောင်ပါ bun install bun run dev ``` **🛠️ Source မှ** ```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 flake များကို အသုံးပြုခြင်း nix develop npm run dev # သို့မဟုတ် devbox ကို အသုံးပြုခြင်း devbox run npm run dev ``` 📖 [Docker လမ်းညွှန်](docs/guides/DOCKER_GUIDE.md) — Compose profile များ၊ Caddy HTTPS နှင့် Cloudflare tunnel များ။ **🦭 Podman** ```bash # 1. Bind-mount လုပ်မည့် data directory ကို ပြင်ဆင်ပါ mkdir -p data # 2. Linux + local rootless Podman အတွက်သာ (remote Podman Machine client တွင် လုံးဝအသုံးမပြုပါနှင့်): podman unshare chown 1000:1000 ./data # 3. Runtime အရိပ်အမြွက်ကို သတ်မှတ်ပြီး local Compose image ကို build လုပ်ကာ စတင်ပါ echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS သို့မဟုတ် Windows တွင် Podman သည် remote Podman Machine ကို အသုံးပြုသည်- `podman unshare` ကို ကျော်ပြီး [topology အလိုက် data directory လမ်းညွှန်ချက်](contrib/podman/README.md#data-directory-permissions-by-topology) ကို လိုက်နာပါ။ 📖 [Podman လမ်းညွှန်](contrib/podman/README.md) — Compose build များ၊ Podman Machine နှင့် Linux/systemd Quadlet တပ်ဆင်ခြင်း။ **⚡ ပိုမြန်ပြီး ပိုပေါ့ပါးသော ထည့်သွင်းမှု (native build ကို ကျော်ရန်)** Native SQLite engine (`better-sqlite3`) သည် **ရွေးချယ်နိုင်သော** dependency ဖြစ်သောကြောင့် global ထည့်သွင်းမှုသည် source မှ compile လုပ်ခြင်းကို စောင့်ဆိုင်း၍ ဘယ်သောအခါမျှ ပိတ်ဆို့မနေပါ- သင့် platform/Node နှင့် ကိုက်ညီသည့်အခါ ကြိုတင် build လုပ်ထားသော binary ကို အသုံးပြုပြီး၊ မကိုက်ညီပါက pure-JS engine (Node 22+ တွင် `node:sqlite`၊ သို့မဟုတ်ပါက ပူးတွဲပါဝင်သော `sql.js` WASM) သို့ မသိသာဘဲ အလိုအလျောက် ပြောင်းသုံးသည် — build tool များ မလိုအပ်ပါ။ ထည့်သွင်းပြီးနောက် native warm-up ကို လုံးဝကျော်ရန် (CI၊ headless သို့မဟုတ် နှေးကွေးသော စက်များ)- ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 သည်လည်း ၎င်းကို ကျော်သည် ``` အမြန်ဆုံး ထည့်သွင်းမှုများအတွက် **pnpm** ကို ဦးစားပေးပါ (content-addressed store + hard link များ — အထက်တွင် ကြည့်ပါ)။ Dashboard မပါသော headless runtime အတွက် အထက်ပါ Docker `base` profile သို့မဟုတ် [Termux လမ်းညွှန်](docs/guides/TERMUX_GUIDE.md) ကို အသုံးပြုပါ။ CLI နှင့် web dashboard ကို port တစ်ခုတည်းရှိ process တစ်ခုတည်းက ပံ့ပိုးပေးသောကြောင့် လက်ရှိတွင် သီးခြား CLI-only package မရှိပါ။

# 🎬 လက်တွေ့အသုံးပြုနေသော OmniRoute

## 📹 ဗီဒီယိုလမ်းညွှန်များ

_{2026-10-18 ရက်နေ့ရှိ ဒက်ရှ်ဘုတ်မှတ်တမ်း · မူရင်းကတ်တလောက်: YT 1.352 | TT 334 | IG 290 · လတ်ဆတ်မှု (ရက်): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — ကြည့်ရှုမှု 3,042,474 ကြိမ်}

🎬 #2 — Instagram
_{nnapier7 — ကြည့်ရှုမှု 1,454,535 ကြိမ်}

🎬 #3 — YouTube
_{Amidia AI & Tech — ကြည့်ရှုမှု 794,974 ကြိမ်}

🎬 #4 — Instagram
_{theopenstack — ကြည့်ရှုမှု 692,419 ကြိမ်}

🎬 #5 — TikTok
_{migue.baena — ကြည့်ရှုမှု 685,788 ကြိမ်}

**အဆင့်သတ်မှတ်ချက်အပြည့်အစုံ (ထပ်နေမှုများကို ဖယ်ရှားထားသော canonical URL များ၊ `v > 0`၊ ရောက်ရှိမှုအများဆုံး):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | 2026-10-18 ရက်နေ့ရှိ canonical မက်ထရစ်များ: **သီးခြားဗီဒီယို 1.976 ခု** · **သိရှိထားသော ကြည့်ရှုမှု 20.220.289 ကြိမ်** (`v > 0`) · **ကွန်ရက်အလိုက် ချန်နယ်/ပရိုဖိုင် 1.210 ခု**။ မူရင်းဒက်ရှ်ဘုတ်တွင် အတန်း 1.976 တန်း (YouTube 1.352 = ဗီဒီယိုအရှည် 740 ခု + Shorts 612 ခု · TikTok 334 ခု · Instagram 290 ခု) ပါဝင်သည်။ ဗီဒီယိုတစ်ခုစီအတွက် အများဆုံးကြည့်ရှုမှုအရေအတွက်ကို ထိန်းသိမ်းထားသည့် canonical URL ဖြင့် စံသတ်မှတ်ပြီးနောက် ထပ်နေသည့်အရာ တစ်ခုမျှ မကျန်တော့ပါ။ YouTube ဒေတာစုဆောင်းမှုကို 2026-10-13 ရက်နေ့တွင် ရပ်တန့်ထားသည် (14 မှ 18/10 အတွင်း API quota ကုန်ဆုံးသွားသောကြောင့်)။ TikTok/Instagram ဒေတာစုဆောင်းမှုကိုလည်း 2026-09-02 မှစ၍ ရပ်တန့်ထားသည် (ဒေတာစုဆောင်းရန် ခရက်ဒစ်မရှိသောကြောင့်)။ ဗီဒီယို 76 ခုအတွက် ကြည့်ရှုမှုအရေအတွက် မရှိသေးပါ။ > 🎬 **OmniRoute အကြောင်း ဗီဒီယိုတစ်ခု ဖန်တီးထားပါသလား။** လင့်ခ်နှင့်အတူ [ပြဿနာတစ်ခု](https://github.com/diegosouzapw/OmniRoute/issues/new) သို့မဟုတ် [ဆွေးနွေးမှုတစ်ခု](https://github.com/diegosouzapw/OmniRoute/discussions) ဖွင့်ပါ — ၎င်းကို ဤနေရာတွင် ဖော်ပြပေးပါမည်။

# 📧 အသိုင်းအဝိုင်းနှင့် အကူအညီ > အရာအားလုံးကို တစ်နေရာတည်းတွင် ရယူပါ — ထိန်းသိမ်းသူကို follow လုပ်ပါ၊ အသိုင်းအဝိုင်းနှင့် စကားပြောပါ သို့မဟုတ် ပြဿနာတစ်ခု ဖွင့်ပါ။ | ချန်နယ် | နေရာ / အသုံးပြုပုံ | | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | 💼 **LinkedIn** — ထိန်းသိမ်းသူကို စောင့်ကြည့်ရန် | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — ထုတ်ဝေမှုများနှင့် အကြံပြုချက်များအတွက် စောင့်ကြည့်ရန် | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 ကမ္ဘာတစ်ဝန်း** | [အဖွဲ့သို့ ဝင်ရောက်ရန်](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 ဘရာဇီး** | [အဖွဲ့သို့ ဝင်ရောက်ရန်](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **ဝဘ်ဆိုက်** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute အသိုင်းအဝိုင်း (အခမဲ့)** | [StHub ပေါ်တယ်](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **အရင်းအမြစ်ကုဒ်** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **ချို့ယွင်းချက်တစ်ခုကို တိုင်ကြားရန်** | [ပြဿနာတစ်ခု ဖွင့်ရန်](https://github.com/diegosouzapw/OmniRoute/issues) — `npm run system-info` ၏ ရလဒ်ကို ပူးတွဲပါ | | 🤝 **ပါဝင်ကူညီရန်** | [CONTRIBUTING.md](CONTRIBUTING.md) · [ဘရန်ချ်ခွဲခြင်းနှင့် ထုတ်ဝေမှုပုံစံ](docs/ops/BRANCHING_MODEL.md) · `good first issue` တစ်ခုကို ရွေးချယ်ပါ | | 💚 **ပရောဂျက်ကို ပံ့ပိုးရန်** | [ပံ့ပိုးနိုင်သည့် နည်းလမ်းများ ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ နည်းပညာ Stack

အလွှာ	နည်းပညာ
Runtime	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
ဘာသာစကား	TypeScript 6.0 — `src/` နှင့် `open-sse/` တစ်လျှောက်လုံး 100% TypeScript (v2.0 ကတည်းက core တွင် `any` လုံးဝမသုံး)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
ဒေတာဘေ့စ်	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — domain module 147 ခု၊ migration 209 ခု
မမ်မိုရီ	SQLite FTS5 full-text + int8-quantized vector embedding များ၊ typed decay
Schema များ	Zod 4 — MCP tool I/O အတည်ပြုစစ်ဆေးခြင်း + API contract များ
ပရိုတိုကောလ်များ	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Streaming	Server-Sent Events (SSE) + WebSocket bridge (`/v1/ws`)
Compression	engine 12 ခုပါ pipeline — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Auth နှင့် လုံခြုံရေး	OAuth 2.0 (PKCE) + JWT + API Keys + MCP scoped auth · သိုလှောင်ထားသောဒေတာအတွက် AES-256-GCM · DOMPurify
Stealth	wreq-js — JA3 / JA4 TLS fingerprint အယောင်ဆောင်ခြင်း၊ အဆင့် ၃ ဆင့် proxy
Resilience	Circuit breaker၊ exponential backoff၊ anti-thundering-herd၊ auto-combo self-healing
Logging	pino — request context ပါဝင်သော structured JSON log များ
စမ်းသပ်ခြင်း	Node.js test runner + Vitest — ခြေရင်းခံထားသော test file 7,800+ ကျော်တွင် static test declaration 56,000+ (unit, integration, E2E, security, ecosystem)
ပလက်ဖောင်းများ	Desktop (Electron) · Android (Termux) · PWA (မည်သည့် browser မှမဆို)
CI/CD	GitHub Actions — release အသစ်တိုင်းတွင် အလိုအလျောက် npm publish + Docker Hub
လင့်ခ်များ	ဝဘ်ဆိုဒ် · npm · Docker Hub

## 📖 စာရွက်စာတမ်းများ

### 📘 စတင်အသုံးပြုခြင်း

စာရွက်စာတမ်း	ဖော်ပြချက်
အသုံးပြုသူ လမ်းညွှန်	Provider များ၊ combo များ၊ CLI ပေါင်းစပ်မှု၊ deployment
တပ်ဆင်ခြင်း လမ်းညွှန်	အပြည့်အစုံ တပ်ဆင်နည်းများ၊ CLI tool config များ၊ protocol setup၊ timeout ချိန်ညှိခြင်း
CLI Tools လမ်းညွှန်	Claude Code၊ Codex၊ Cursor၊ Cline၊ OpenClaw၊ Kilo၊ Copilot တို့အတွက် tool တစ်ခုချင်းစီ setup
Remote Mode	Scoped access token များဖြင့် သင်၏ laptop CLI မှ အဝေးရှိ OmniRoute (VPS) ကို မောင်းနှင်ခြင်း
Claude Code Config	`launch` + model အလိုက် profile များဖြင့် Claude Code ကို OmniRoute (local/remote) သို့ ချိတ်ဆက်ခြင်း
အမြန်စတင်ခြင်း	3 ဆင့် install → connect → configure

### 🔧 လည်ပတ်မှုနှင့် Deployment

စာရွက်စာတမ်း	ဖော်ပြချက်
Docker လမ်းညွှန်	Docker run၊ Compose profile များ၊ Caddy HTTPS၊ tunnel များ၊ image tag များ
Podman လမ်းညွှန်	Quadlet systemd ပေါင်းစပ်မှု၊ podman-compose၊ SELinux
VM Deployment	ပြည့်စုံသော လမ်းညွှန်: VM + nginx + Cloudflare setup
Fly.io Deployment	Persistent storage ဖြင့် Fly.io သို့ deploy လုပ်ခြင်း
Termux လမ်းညွှန်	Termux မှတစ်ဆင့် Android တွင် OmniRoute ကို run ခြင်း
PWA လမ်းညွှန်	Progressive Web App တပ်ဆင်ခြင်း၊ caching၊ architecture
Uninstall လမ်းညွှန်	တပ်ဆင်နည်းအားလုံးအတွက် သန့်ရှင်းစွာ ဖယ်ရှားနည်း
Environment Config	အပြည့်အစုံ `.env` variable များနှင့် reference များ

### 🧠 အင်္ဂါရပ်များနှင့် Architecture

စာရွက်စာတမ်း	ဖော်ပြချက်
Architecture	စနစ် architecture၊ data flow နှင့် အတွင်းပိုင်းအလုပ်လုပ်ပုံများ
Compression လမ်းညွှန်	ရွေးချယ်မှု 7 ခု pipeline: off / lite / standard / aggressive / ultra / RTK / stacked
RTK Compression	Command-output compression၊ filter များ၊ trust၊ verify၊ raw-output ပြန်လည်ရယူခြင်း
Compression Engine များ	Caveman၊ RTK၊ stacked pipeline များ၊ dashboard/API/MCP surface များ
Compression Rules Format	Caveman နှင့် RTK filter များအတွက် JSON rule-pack schema များ
Compression Language Pack များ	ဘာသာစကား ရှာဖွေတွေ့ရှိခြင်းနှင့် Caveman rule-pack ရေးသားခြင်း
Resilience လမ်းညွှန်	Circuit breaker များ၊ cooldown များ၊ queue၊ anti-thundering herd၊ TLS spoofing
Auto-Combo Engine	16-factor scoring၊ mode pack များ၊ self-healing
Proxy လမ်းညွှန်	3-level proxy စနစ်၊ 1proxy marketplace၊ registry CRUD
Free Tier များ	စုပေါင်းဖော်ပြထားသော directory: စာရွက်စာတမ်းရှိ ထပ်တလဲလဲ pool 34 ခု / catalog ပြုလုပ်ထားသော free-tier entry 467 ခု
Features ပြခန်း	Screenshot များဖြင့် visual dashboard လေ့လာခရီးစဉ်
Codebase စာရွက်စာတမ်း	စတင်လေ့လာသူများအတွက် codebase လမ်းကြောင်းရှင်းလင်းချက်

### 🤖 Protocol များနှင့် API များ

စာရွက်စာတမ်း	ဖော်ပြချက်
API Reference	ဥပမာများနှင့်တကွ endpoint အားလုံး
OpenAPI Spec	OpenAPI 3.0 specification
MCP Server	MCP tool 110 ခု၊ IDE config များ၊ Python/TS/Go client များ
MCP Server လမ်းညွှန်	MCP တပ်ဆင်ခြင်း၊ transport များနှင့် tool reference
A2A Server	JSON-RPC 2.0 protocol၊ skill များ၊ streaming၊ task စီမံခန့်ခွဲမှု
A2A Server လမ်းညွှန်	A2A agent card၊ task များ၊ skill များနှင့် streaming

### 📋 ပရောဂျက်နှင့် အရည်အသွေး

စာရွက်စာတမ်း	ဖော်ပြချက်
ပါဝင်ကူညီခြင်း	ဖွံ့ဖြိုးတိုးတက်ရေး setup နှင့် လမ်းညွှန်ချက်များ
Branching နှင့် Release မော်ဒယ်	PR များ ပစ်မှတ်ထားရာနေရာ (`release/*`)၊ `main` နှင့် tag များ၏ အဓိပ္ပာယ်
ပြောင်းလဲမှုမှတ်တမ်း	ဗားရှင်းတစ်ခုချင်းစီ၏ release မှတ်တမ်းအပြည့်အစုံ
လုံခြုံရေးမူဝါဒ	အားနည်းချက်အစီရင်ခံခြင်းနှင့် လုံခြုံရေးလုပ်ထုံးလုပ်နည်းများ
i18n လမ်းညွှန်	ဘာသာစကား ၆၇ မျိုးပံ့ပိုးမှု၊ ဘာသာပြန်လုပ်ငန်းစဉ်၊ RTL
Release စစ်ဆေးစာရင်း	Release မလုပ်မီ အတည်ပြုစစ်ဆေးရန်အဆင့်များ
Coverage အစီအစဉ်	ခြေရာခံထားသော test ဖိုင် ၇,၈၀၀+ တွင်ရှိသော static test ကြေညာချက် ၅၆,၀၀၀+ အတွက် test coverage မဟာဗျူဟာ

# ⭐ ထိပ်တန်း ပါဝင်ကူညီသူများ > OmniRoute ကို စိတ်အားထက်သန်သော open-source အသိုင်းအဝိုင်းက ပုံဖော်ထားခြင်းဖြစ်သည်။ ဤပုဂ္ဂိုလ်များသည် ပရောဂျက်၏ အရည်အသွေး၊ တည်ငြိမ်မှုနှင့် လက်လှမ်းမီမှုကို တိုက်ရိုက်သက်ရောက်စေသည့် ထူးချွန်သော ပါဝင်ကူညီမှုများ ပြုလုပ်ခဲ့ကြသည်။ **ကျေးဇူးတင်ပါသည်။** ### Merged pull request အရေအတွက်အလိုက် ပြင်ပပါဝင်ကူညီသူများ

အဆင့်	ပါဝင်ကူညီသူ	Merged PRs	~ပြောင်းလဲသည့်စာကြောင်းများ
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{သန်းခေါင်စာရင်းကို 2026-10-18 15:09:09 UTC တွင် တိုက်ရိုက် release/v3.8.52 tip 656f01cb43 ဖြင့် ရယူခဲ့သည်။ စာမျက်နှာခွဲထားသော GitHub GraphQL သန်းခေါင်စာရင်းတွင် merged PR စုစုပေါင်း ၉,၁၉၁ ခုပါဝင်သည် — repository ပိုင်ရှင်မှ ၃,၈၃၄ ခု၊ Dependabot မှ ၂၂၉ ခု၊ အခြား bot/app များမှ ၆ ခု၊ ထို့နောက် မတူညီသောပါဝင်ကူညီသူ ၈၃၅ ဦးမှ ပြင်ပ PR ၅,၁၂၂ ခု ဖြစ်သည်။ "ပြောင်းလဲသည့်စာကြောင်းများ" ဆိုသည်မှာ GitHub additions + deletions ဖြစ်ပြီး ထုတ်လုပ်ထားသောဖိုင်များ၊ lockfile များ၊ catalog များ၊ ဘာသာပြန်များနှင့် စာရွက်စာတမ်းများ ပါဝင်သည်။ ၎င်းသည် ရေးသားထားသော LOC မဟုတ်ဘဲ churn ဖြစ်သည်။ PR ၄၉ ခုသည် GitHub diff စာကြောင်း ၅၀၀,၀၀၀ ကျော်အဖြစ်အစီရင်ခံထားသည် (ဥပမာအားဖြင့်၊ provider တစ်ခုတည်းထည့်သွင်းမှုဖြစ်သော #13399 တွင် ပြောင်းလဲသောဖိုင် ၂,၃၄၇ ဖိုင်စာရင်းပါဝင်သည်)၊ ၎င်းက အထက်ပါစုစုပေါင်းအချို့ကို ပိုမိုကြီးမားစေသည်။ ရတံ့သူများကို အဆင့်တူအဖြစ်အတူစာရင်းပြုစုထားသည်။} ### GitHub-attributed commit များ

Dizzle _{🥇 GitHub-attributed commit 367 ခု}	Bob.Hou _{🥈 GitHub-attributed commit 269 ခု}	Paijo _{🥉 GitHub-attributed commit 229 ခု}	backryun _{🏅 GitHub-attributed commit 202 ခု}	Paco Cartones _{🏅 GitHub-attributed commit 174 ခု}	Ravi Tharuma _{🏅 GitHub-attributed commit 126 ခု}
Markus Hartung _{🏅 GitHub-attributed commit 114 ခု}	Randi _{🏅 GitHub-attributed commit 108 ခု}	Jan Leon _{🏅 GitHub-attributed commit 87 ခု}	Chris _{🏅 GitHub-attributed commit 70 ခု}	Koosha Paridehpour _{🏅 GitHub-attributed commit 68 ခု}

_{2026-10-18 14:44:45 UTC တွင် ပြန်လည်စစ်ဆေးပြီး — release/v3.8.52 default branch အတွက် repository ၏ Contributors API က တင်ပြထားသော GitHub-attributed commit များဖြစ်သည်။ API က identity စုစုပေါင်း 849 ခု (အသုံးပြုသူ 429 ခု၊ bot 2 ခု၊ အမည်မသိ identity 418 ခု) ကို ပြန်ပေးခဲ့သည်။ ဤဇယားတွင် maintainer၊ bot များနှင့် အမည်မသိ identity များကို ဖယ်ထုတ်ထားပြီး ရလဒ်တူ ပြိုင်ဆိုင်မှုများကို ထိန်းသိမ်းထားပါသည်။ ၎င်းသည် အထက်ပါ merged-PR အဆင့်စာရင်းနှင့် အောက်ပါ Git-metadata သန်းခေါင်စာရင်းတို့နှင့် ကွာခြားပါသည်။} > 🙏 ဤ contributor များ၏ feature များ၊ bug fix များနှင့် infrastructure တိုးတက်မှုများသည် OmniRoute ကို ယုံကြည်စိတ်ချရပြီး feature ပြည့်စုံစေသည့် **အဓိကအစိတ်အပိုင်း** ဖြစ်ပါသည်။ Pull request တိုင်းလေ၊ test case တိုင်းလေ၊ i18n ဘာသာပြန်ဖိုင်တိုင်းလေ အရေးကြီးပါသည်။ Open source ဆိုသည်မှာ ၎င်းတို့ကဲ့သို့သော လူများက တည်ဆောက်ထားခြင်းဖြစ်ပါသည်။

---
## 💖 ပံ့ပိုးကူညီသူများ

မိမိတို့၏ ကိုယ်ပိုင်ငွေဖြင့် OmniRoute ကို ရန်ပုံငွေထောက်ပံ့ပေးကြသူများအား လှိုက်လှဲစွာ ကျေးဇူးတင်ရှိပါသည် — ပံ့ပိုးမှုတိုင်းက ဤပရောဂျက်ကို အခမဲ့၊ အမှီအခိုကင်းစွာနှင့် ဆက်လက်တိုးတက်စေရန် အထောက်အကူပြုပါသည်။

Andrew _{💛 လက်ရှိ လစဉ်ပံ့ပိုးသူ}	Vlad I _{💛 လက်ရှိ လစဉ်ပံ့ပိုးသူ}	小妍儿 _{💛 လက်ရှိ လစဉ်ပံ့ပိုးသူ}	Guilherme Costa _{💛 လက်ရှိ တစ်ကြိမ်တည်းပံ့ပိုးသူ}	Henrique Iurkiv _{💛 လက်ရှိ တစ်ကြိမ်တည်းပံ့ပိုးသူ}	Somesh Ghaturle _{💛 လက်ရှိ တစ်ကြိမ်တည်းပံ့ပိုးသူ}
Kolonie AI _{💛 ယခင် တစ်ကြိမ်တည်းပံ့ပိုးခဲ့သူ}	Prof. Igor Morais _{💛 ယခင် တစ်ကြိမ်တည်းပံ့ပိုးခဲ့သူ}	Pixma _{💛 ယခင် တစ်ကြိမ်တည်းပံ့ပိုးခဲ့သူ}	Paco Cartones _{💛 ယခင် တစ်ကြိမ်တည်းပံ့ပိုးခဲ့သူ}	longtao _{💛 ယခင် တစ်ကြိမ်တည်းပံ့ပိုးခဲ့သူ}

_{… ထို့အပြင် မိမိတို့၏ အမည်ကို သီးသန့်ထားလိုသူများလည်း ရှိပါသည် 💛} _{အများမြင်နိုင်သော GitHub Sponsors စာရင်းကို GitHub Sponsors GraphQL API မှတစ်ဆင့် 2026-10-18 တွင် ပြန်လည်အတည်ပြုခဲ့ပါသည်- စုစုပေါင်း ပံ့ပိုးမှု 14 ခုအနက် အများမြင်နိုင်သော ပံ့ပိုးမှု 11 ခု (လက်ရှိ 6 ခု၊ ယခင် 5 ခု) ရှိပါသည်။ အထက်ပါ လက်ရှိအခြေအနေ အညွှန်းများကို GitHub ၏ isActive အခြေအနေက သတ်မှတ်ပေးပါသည်။ ယခင်က အများမြင်နိုင်သော တစ်ကြိမ်တည်းပံ့ပိုးသူများကို ဆက်လက်ကျေးဇူးတင်ဖော်ပြထားပြီး သီးသန့်ပံ့ပိုးသူများ၏ အမည်များကို လျှို့ဝှက်ထားပါသည်။ Ko-fi၊ Buy Me a Coffee၊ Liberapay၊ PIX နှင့် ခရစ်ပတိုငွေကြေးဖြင့် လှူဒါန်းမှုများတွင် အများမြင်နိုင်သော ပံ့ပိုးသူမှတ်တမ်း မရှိသောကြောင့် ဤနေရာတွင် မဖော်ပြထားပါ။} 💖 ပံ့ပိုးသူတစ်ဦး ဖြစ်လာရန် → — ဒေါ်လာတိုင်းက OmniRoute ကို အခမဲ့နှင့် အမှီအခိုကင်းစွာ ဆက်လက်တည်ရှိစေပါသည်။

## 👥 ပံ့ပိုးသူ 900+ ဦး

[![ပံ့ပိုးသူများ](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-10-18 တွင် လက်ရှိ release/v3.8.52 ၏ နောက်ဆုံး commit ad160ab2d1 (commit 6,826 ခု) ကို စစ်ဆေးထားသည်- စံပြုထားသော လူသား Git identity 993 ခု ရှိပြီး 707 ခုသည် commit ရေးသားသူများအဖြစ် (ထိန်းသိမ်းသူအပါအဝင်) ပါဝင်ကာ 286 ခုသည် တိကျစွာဖော်ပြထားသော Co-authored-by trailer များတွင်သာ ပါဝင်သည်။ ဤစာရင်းကောက်ယူမှုတွင် .mailmap ကို အသုံးပြုထားပြီး အီးမေးလ်လိပ်စာများကို စာလုံးအကြီးအသေး မခွဲခြားဘဲ နှိုင်းယှဉ်ကာ တူညီသော handle ကို ဖော်ပြထားမှသာ ဂဏန်းပုံစံနှင့် သာမန် GitHub noreply လိပ်စာများကို ပေါင်းစည်းထားသည်။ bot/agent/service/placeholder identity 26 ခုကို ဖယ်ထုတ်ထားပြီး ဖော်ပြသည့်အမည်များ တူညီရုံဖြင့် သာမန်အီးမေးလ်လိပ်စာများကို ပေါင်းစည်းထားခြင်း မရှိပါ။ 2026-08-24 စစ်ဆေးမှုတွင် 639 ခုဟု ထုတ်ပြန်ခဲ့သည်။ ဤနည်းလမ်းကို ထိုစစ်ဆေးမှု၏ အခြေခံ ac02c5b42f တွင် ပြန်လည်လုပ်ဆောင်သောအခါ 619 ခုရရှိသောကြောင့် တိုးလာမှုသည် နည်းလမ်းပိုမိုလျော့ရဲလာခြင်းကြောင့် မဟုတ်ဘဲ ပံ့ပိုးသူအသစ်များကြောင့် ဖြစ်သည်။} ### ပံ့ပိုးနည်း 1. repository ကို fork လုပ်ပါ 2. `main` မှ မဟုတ်ဘဲ **လက်ရှိအသုံးပြုနေသော** `release/vX.Y.Z` ၏ နောက်ဆုံး commit မှ branch ခွဲပါ — [Branching & Release Model](docs/ops/BRANCHING_MODEL.md) ကို ကြည့်ပါ 3. သင်၏ feature branch ကို ဖန်တီးပါ (`git checkout -b feat/amazing-feature`) 4. သင်၏ ပြောင်းလဲမှုများကို commit လုပ်ပါ (`git commit -m 'feat: add amazing feature'`) 5. branch သို့ push လုပ်ပါ (`git push origin feat/amazing-feature`) 6. **base = အဆိုပါ `release/vX.Y.Z` branch** ဖြင့် Pull Request တစ်ခု ဖွင့်ပါ အသေးစိတ်လမ်းညွှန်ချက်များအတွက် [CONTRIBUTING.md](CONTRIBUTING.md) ကို ကြည့်ပါ။ ### ဗားရှင်းအသစ် ထုတ်ပြန်ခြင်း ```bash # release တစ်ခု ဖန်တီးပါ — 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 ၏ သီးခြားအစိတ်အပိုင်းတစ်ခုကို ပုံဖော်ပေးခဲ့ပါသည်။ ဤသည်မှာ ၎င်းတို့အားလုံးအတွက် ကျွန်ုပ်တို့၏ ကျေးဇူးတင်စကားဖြစ်ပါသည်။ 🙏 > ⭐ star အရေအတွက်များကို 2026 ခုနှစ်၊ အောက်တိုဘာလ 18 ရက်နေ့တွင် GitHub ၏ REST API မှတစ်ဆင့် အတည်ပြုထားပါသည် — ဤပရောဂျက်များကို star ပေးလိုက်ပါ။ အရေအတွက်များသည် ထိုရက်စွဲရှိ အတိအကျ snapshot ဖြစ်ပြီး ပုံမှန်အားဖြင့် ပြောင်းလဲသွားမည်ဖြစ်ပါသည်။ ### 🧬 မျိုးဆက်ရင်းမြစ်နှင့် gateway

ပရောဂျက်	⭐	OmniRoute ကို မည်သို့ စိတ်ကူးပေးခဲ့သနည်း
9router	31,004	ဤ fork ကို အခြေခံတည်ဆောက်ထားသော မူလပရောဂျက်ဖြစ်ပြီး — ဤနေရာတွင် multi-modal API များနှင့် အပြည့်အစုံ TypeScript ပြန်လည်ရေးသားမှုတို့ဖြင့် တိုးချဲ့ထားပါသည်။
CLIProxyAPI	55,591	ဤ JavaScript / TypeScript port အတွက် စိတ်ကူးရရှိစေခဲ့သော Go implementation ဖြစ်ပါသည်။
LiteLLM	61,482	၎င်း၏ အများပြည်သူသုံး pricing dataset က ကျွန်ုပ်တို့၏ ကုန်ကျစရိတ်ခြေရာခံခြင်း sync ကို ဒေတာပံ့ပိုးပေးပြီး ၎င်း၏ provider-normalization model က ကျွန်ုပ်တို့၏ routing ပုံစံကို လမ်းညွှန်ပေးခဲ့သော AI gateway ဖြစ်ပါသည်။
codex-chatgpt-web	14,526	browser-session၊ response-framing၊ usage နှင့် web-search adapter များအပါအဝင် vendored ChatGPT Web → Codex Responses bridge အဖြစ် ပြုပြင်အသုံးချထားသော MIT source ဖြစ်ပါသည်။
free-claude-code	61,430	stream recovery၊ no-thinking alias များ၊ fallback web search၊ sliding-window limit များ၊ log redaction နှင့် ပိုမိုခိုင်မာလုံခြုံစေသော launcher flow များထဲသို့ pattern များကို port လုပ်ထားပါသည်။
composer-api	346	Cursor Composer ၏ tool-choice၊ output-constraint နှင့် tool-commit pattern များကို native Cursor executor ထဲသို့ ပြုပြင်အသုံးချထားပါသည်။
codex-multi-auth	553	fresh-login နှင့် refresh-token rotation pattern များကို Codex OAuth reauthentication ထဲသို့ port လုပ်ထားပါသည်။
opencode-anthropic-auth	558	Claude Code-compatible transform default များနှင့် billing-header အပြုအမူကို OmniRoute ၏ config-driven bridge ထဲတွင် ယေဘုယျပုံစံဖြင့် အသုံးချထားပါသည်။
grok2api-merged	2	၎င်း၏ Grok model mapping များ၊ fake-TypeError Statsig generator၊ request နှင့် device default များ၊ NDJSON response processor တို့ကို OmniRoute ၏ Grok Web executor ထဲသို့ အဓိကအားဖြင့် ပြုပြင်အသုံးချထားပါသည်။
TQZHR/grok2api	706	grok2api-merged နောက်ကွယ်ရှိ အဓိက ဆင့်ကဲကုဒ်ရင်းမြစ်ဖြစ်ပြီး ၎င်း၏ model၊ header၊ payload၊ Statsig နှင့် processor implementation များကို Grok Web မျိုးဆက်ရင်းမြစ်တွင် ဆက်လက်ထိန်းသိမ်းထားပါသည်။
chenyme/grok2api	7,819	TQZHR နှင့် grok2api-merged မှတစ်ဆင့် ဆက်လက်သယ်ဆောင်လာသော Grok payload နှင့် device default များ၊ Statsig generator နှင့် `result.response` processor တို့အတွက် အခြေခံ MIT source ဖြစ်ပါသည်။
grok2api-pro	27	၎င်း၏ proxy-pool layer အတွက် grok2api-merged က အသိအမှတ်ပြုထားသော ဆင့်ကဲရင်းမြစ်တစ်ခုဖြစ်ပါသည်။ OmniRoute သည် ထိုမျိုးဆက်ရင်းမြစ်ဆိုင်ရာ အသိပေးချက်ကို ဆက်လက်ထိန်းသိမ်းထားသော်လည်း ၎င်း၏ ကန့်သတ်နယ်ပယ်ရှိ Grok Web executor တွင် proxy-pool port တစ်ခု ပါဝင်သည်ဟု မဆိုထားပါ။
GrokProxy	51	၎င်း၏ cookie ဖြင့် စစ်မှန်ကြောင်းအတည်ပြုထားသော Grok proxy နှင့် `result.response.token` streaming pattern က OmniRoute ၏ Grok Web transport ကို လမ်းညွှန်ပေးခဲ့ပါသည်။
GrokBridge	5	မူလ Grok Web implementation သည် ၎င်း၏ HTTP/browser upstream design ကို ကိုးကားအသုံးပြုခဲ့ပါသည်။ ၎င်း၏ direct HTTP path သည် GrokProxy မှ ဆင်းသက်လာသောကြောင့် သီးခြား code port တစ်ခုအဖြစ် မဆိုထားပါ။

### 🗜️ Context နှင့် token compression — engine များ

ပရောဂျက်	⭐	OmniRoute အတွက် မည်သို့ စိတ်ကူးရစေခဲ့သည်
Caveman	113,396	လူကြိုက်များခဲ့သည့် "စကားလုံးအနည်းငယ်နဲ့ အလုပ်ဖြစ်ရင် စကားလုံးအများကြီး ဘာလို့သုံးမလဲ" ပရောဂျက်ဖြစ်ပြီး ၎င်း၏ caveman စကားပြောပုံ အယူအဆက ကျွန်ုပ်တို့၏ စံချုံ့မှုမုဒ်နှင့် ဖြည့်စွက်စာသားဖယ်ရှားခြင်း/သိပ်သည်းအောင်ပြုလုပ်ခြင်း စည်းမျဉ်း 30+ ခုကို အခြေခံပံ့ပိုးပေးထားသည်။
RTK – Rust Token Killer	83,835	စွမ်းဆောင်ရည်မြင့် command output ချုံ့ခြင်းသည် ကျွန်ုပ်တို့၏ RTK engine၊ JSON filter DSL၊ မူရင်း output ပြန်လည်ရယူခြင်းနှင့် အဆင့်ဆင့်ပေါင်းစပ်ထားသော RTK → Caveman pipeline တို့ကို ဖန်တီးရန် စိတ်ကူးပေးခဲ့သည်။
headroom	75,741	ပြန်လည်ဖော်ထုတ်နိုင်သော context ချုံ့ခြင်း (SmartCrusher) သည် ကျွန်ုပ်တို့၏ `headroom` engine နှင့် `ccr` retrieve-marker pattern တို့အတွက် စိတ်ကူးပေးခဲ့သည်။
LLMLingua	6,757	Prompt ချုံ့ခြင်းဆိုင်ရာ သုတေသန (LLMLingua / LLMLingua-2) သည် ကျွန်ုပ်တို့၏ asynchronous၊ code-safe နှင့် fail-open ဖြစ်သော `llmlingua` engine အတွက် စိတ်ကူးပေးခဲ့သည်။
llmlingua-2-js	32	ကျွန်ုပ်တို့၏ LLMLingua engine အတွက် worker-thread backend အဖြစ် အသုံးပြုထားသည့် JS/ONNX port (MobileBERT / XLM-RoBERTa) ဖြစ်သည်။
Troglodita	50	PT-BR token ချုံ့ခြင်းသည် ကျွန်ုပ်တို့၏ pt-BR language pack ကို အားဖြည့်ပေးထားပြီး Brazilian-Portuguese သဒ္ဒါနှင့် ကိုက်ညီအောင် ချိန်ညှိထားသော pleonasm လျှော့ချခြင်းနှင့် ဖြည့်စွက်စာသားဖယ်ရှားခြင်းတို့ ပါဝင်သည်။
ponytail	166,731	လူကြိုက်များခဲ့သည့် "ပျင်းရိသော အကြီးတန်း developer" YAGNI-coder skill သည် ကျွန်ုပ်တို့၏ less-code Output Style အတွက် စိတ်ကူးပေးခဲ့သည်။ ၎င်းသည် _ထုတ်လုပ်လိုက်သည့်_ code ကို လျှော့ချပေးသော၊ အလုပ်ဖြစ်နိုင်သည့် အသေးဆုံးပြောင်းလဲမှုကို ဦးတည်စေသည့် ပုံစံဖြစ်ပြီး Caveman ၏ တိုတောင်းသော စကားပြေနှင့် output ဘက်ဆိုင်ရာ မျိုးတူဖြစ်သည်။
i-have-adhd	57,628	၎င်း၏ လုပ်ဆောင်ချက်ကို ဦးစားပေးပြီး ADHD နှင့် အဆင်ပြေသည့် တုံ့ပြန်မှုပုံစံကို ဘာသာစကားငါးမျိုးအတွက် OmniRoute ၏ တိုတောင်းကျစ်လျစ်သော output style အဖြစ် ပြောင်းလဲအသုံးချထားသည်။

### 🧩 ကျစ်လျစ်သော format များ၊ token သုတေသနနှင့် code-aware tooling

ပရောဂျက်	⭐	OmniRoute အတွက် မည်သို့ စိတ်ကူးရစေခဲ့သည်
TOON	25,509	Token-Oriented Object Notation ဖြစ်ပြီး ၎င်း၏ ကော်လံပုံစံ၊ header နှင့် row များ ပေါင်းစပ်ထားသော model က ကျွန်ုပ်တို့၏ tabular compaction အဆင့်ကို ပုံဖော်ပေးခဲ့သည်။
GCF – Graph Compact Format	59	၎င်း၏ ကျစ်လျစ်သော graph format နှင့် generic-profile design တို့က OmniRoute ၏ tabular compaction နှင့် Headroom codec format ကို ပုံဖော်ရာတွင် အထောက်အကူပြုခဲ့သည်။
gcf-typescript	4	Headroom generic-profile codec အဖြစ် တိုက်ရိုက်ထည့်သွင်းပြီး တိုးချဲ့ထားသည့် MIT TypeScript implementation ဖြစ်သည်။
token-optimizer-mcp	551	Brotli/SQLite cache နှင့် session တစ်ခုချင်းစီအလိုက် context-delta တို့သည် ကျွန်ုပ်တို့၏ `session-dedup` engine အတွက် စိတ်ကူးပေးခဲ့သည်။
token-savior	1,182	Bash output ကျစ်လျစ်အောင်ပြုလုပ်ခြင်းနှင့် MCP profile များသည် ကျွန်ုပ်တို့၏ ချုံ့ခြင်းမှ ရပ်တန့်ထွက်ခွာသည့် စည်းကမ်းနှင့် MCP tool-manifest လျှော့ချခြင်းတို့အတွက် စိတ်ကူးပေးခဲ့သည်။
token-saver	154	အကြောင်းအရာကို နားလည်ပြီး ဖိုင်အမျိုးအစားတစ်ခုချင်းစီအလိုက် output ချုံ့ခြင်းနှင့် ကျရှုံးမှုကို ထည့်သွင်းစဉ်းစားသော ရပ်တန့်ထွက်ခွာမှုတို့က ကျွန်ုပ်တို့၏ အမျိုးအစားအလိုက် dispatch နှင့် အနည်းဆုံးအကျိုးအမြတ်မရှိပါက ကျော်သွားခြင်းကို မှန်ကန်ကြောင်း အတည်ပြုပေးခဲ့သည်။
token-optimizer	2,595	"မမြင်ရသော token များကို ရှာပါ" ဟူသည့် ၎င်း၏ offload နှင့် ပြန်လည်ရယူနိုင်သော handle pattern က ကျွန်ုပ်တို့၏ CCR offload အယူအဆကို ပုံဖော်ပေးခဲ့သည်။
TokenMizer	33	ကျွန်ုပ်တို့၏ session-dedup design ကို ပုံဖော်ပေးခဲ့သည့် session-graph နှင့် turn အများအပြားကြား line-dedup blueprint ဖြစ်သည်။
OmniCompress	3	Rust columnar-JSON၊ content-addressed retrieve နှင့် message များကြား dedup တို့က ကျွန်ုပ်တို့၏ `headroom`/`ccr`/`session-dedup` engine design နှင့် cache တည်ငြိမ်မှုရှိသော "ချုံ့ထားသည့်ပုံစံသည် တည်နေရာအပေါ် မမူတည်ပါ" ဟူသည့် မပြောင်းလဲသောစည်းမျဉ်းကို မှန်ကန်ကြောင်း အတည်ပြုပေးခဲ့သည်။
mcp-compressor	133	MCP tool schema/ဖော်ပြချက် ချုံ့ခြင်းက ကျွန်ုပ်တို့၏ MCP tool-manifest cardinality လျှော့ချခြင်းကို ပုံဖော်ရာတွင် အထောက်အကူပြုခဲ့သည်။
RepoMapper	217	Aider ပုံစံ repo-map အဆင့်သတ်မှတ်ခြင်းက ကျွန်ုပ်တို့၏ repo-map / retrieval-ranking စူးစမ်းလေ့လာမှုကို ပုံဖော်ရာတွင် အထောက်အကူပြုခဲ့သည်။
quiet-shell-mcp	4	MCP ပေါ်ရှိ ကြေညာချက်အခြေပြု shell output လျှော့ချခြင်းက ကျွန်ုပ်တို့၏ ကြေညာချက်အခြေပြု bash output ကျစ်လျစ်အောင်ပြုလုပ်ခြင်းကို မှန်ကန်ကြောင်း အတည်ပြုပေးခဲ့သည်။
ts-morph	6,205	TypeScript Compiler API toolkit သည် string၊ template နှင့် regex literal များကို မပျက်စီးစေဘဲ ထိန်းသိမ်းပေးသော ကျွန်ုပ်တို့၏ parser အခြေပြု comment ဖယ်ရှားခြင်းအတွက် စိတ်ကူးပေးခဲ့သည်။

### 🧠 Memory နှင့် RAG

ပရောဂျက်	⭐	OmniRoute အတွက် လှုံ့ဆော်မှုပေးခဲ့ပုံ
Mem0	67,385	အလုံးစုံသုံးနိုင်သော မှတ်ဉာဏ်အလွှာ — ၎င်း၏ proxy-as-write/read-boundary မော်ဒယ်က ကျွန်ုပ်တို့၏ မှတ်ဉာဏ်တည်ဆောက်ပုံကို ပုံဖော်ပေးခဲ့သည်။
Letta (MemGPT)	25,179	အဆင့်လိုက် မှတ်ဉာဏ်ပါဝင်သည့် အခြေအနေထိန်းသိမ်းနိုင်သော agent များ — ကျွန်ုပ်တို့၏ Context Control & Recovery (CCR) အဆင့်လိုက်မော်ဒယ်အတွက် လှုံ့ဆော်မှုပေးခဲ့သည်။
WFGY	1,800	ထပ်တလဲလဲ ဖြစ်ပေါ်လေ့ရှိသော RAG/LLM ချို့ယွင်းမှုပုံစံ ၁၆ မျိုးပါဝင်သည့် ProblemMap အမျိုးအစားခွဲခြားမှု — ကျွန်ုပ်တို့၏ ပြဿနာဖြေရှင်းရေးလမ်းညွှန်တွင် အသုံးပြုသည့် ဘုံဝေါဟာရများ ဖြစ်သည်။

### 🛰️ အသွားအလာ စစ်ဆေးခြင်း၊ MITM နှင့် ပွင့်လင်းမြင်သာသော proxy

ပရောဂျက်	⭐	OmniRoute အတွက် လှုံ့ဆော်မှုပေးခဲ့ပုံ
llm-interceptor	79	coding-assistant ↔ LLM အသွားအလာကို MITM ဖြင့် ကြားဖြတ်ခြင်း/ခွဲခြမ်းစိတ်ဖြာခြင်းက အစောပိုင်း Traffic Inspector လိုအပ်ချက်များအတွက် အထောက်အကူပြုခဲ့သည်။ ယခင်က ဆင်းသက်ရယူထားသော module လေးခု — SSE ပေါင်းစည်းခြင်း၊ စကားဝိုင်းပုံစံ စံသတ်မှတ်ခြင်း၊ လျှို့ဝှက်ချက်များ ဖုံးကွယ်ခြင်းနှင့် header သန့်စင်ခြင်း — ကို အများပြည်သူသုံး protocol စံနှုန်းများအပေါ် အခြေခံ၍ သီးခြား clean-room အကောင်အထည်ဖော်မှုများဖြင့် အစားထိုးထားသည်။ host-passthrough မျက်နှာပြင်နှစ်ခုဖြစ်သည့် (`passthrough.ts` နှင့် `_internal/bypass.cjs`) သည် သီးခြားအမျိုးအစားခွဲထားသော OmniRoute အတွင်းပိုင်း အကောင်အထည်ဖော်မှုများအဖြစ် ဆက်လက်တည်ရှိပြီး ထိုအစားထိုးမှု၏ အစိတ်အပိုင်းအဖြစ် ပြန်လည်ရေးသားထားခြင်း မရှိပါ။
ProxyBridge	6,814	process တစ်ခုချင်းစီအလိုက် ပွင့်လင်းမြင်သာသော proxy လမ်းကြောင်းရွေးချယ်ခြင်း — ကျွန်ုပ်တို့၏ crash-safe MITM ဖယ်ရှားပိတ်သိမ်းမှု၊ socket idle-timeout များ၊ `/proc` process ချိတ်ဆက်သတ်မှတ်မှုနှင့် TPROXY ဖမ်းယူမှုတို့အတွက် လှုံ့ဆော်မှုပေးခဲ့သည်။

### 📚 မော်ဒယ်ဒေတာ၊ လေ့လာစောင့်ကြည့်နိုင်စွမ်းနှင့် UI

ပရောဂျက်	⭐	OmniRoute အတွက် လှုံ့ဆော်မှုပေးခဲ့ပုံ
models.dev	7,286	AI မော်ဒယ်သတ်မှတ်ချက်များ၊ ဈေးနှုန်းများနှင့် စွမ်းဆောင်ရည်များပါဝင်သည့် ပွင့်လင်းဒေတာဘေ့စ် — ကျွန်ုပ်တို့၏ မော်ဒယ်ကတ်တလောက်ထဲသို့ မူလစနစ်ဖြင့် ထပ်တူပြုထားသည်။
React Flow / xyflow	38,705	ကျွန်ုပ်တို့၏ အချိန်နှင့်တစ်ပြေးညီ Compression Studio နှင့် Combo/Routing Studio တို့ကို လည်ပတ်စေသည့် node အခြေပြု graph library ဖြစ်သည်။
LangGraph	43,443	LangGraph Studio ၏ တိုက်ရိုက် workflow-graph ပုံဖော်ပြသမှုက ကျွန်ုပ်တို့၏ Studios များရှိ အချိန်နှင့်တစ်ပြေးညီ cascade မြင်ကွင်းအတွက် လှုံ့ဆော်မှုပေးခဲ့သည်။
Langfuse	35,990	၎င်း၏ trace → span → generation လေ့လာစောင့်ကြည့်မှုပုံစံက ကျွန်ုပ်တို့၏ Compression Studio waterfall ကို ပုံဖော်ပေးခဲ့သည်။
Kiali	3,645	Istio service-mesh လေ့လာစောင့်ကြည့်နိုင်စွမ်း — Routing/Combo Studio ရှိ ကျွန်ုပ်တို့၏ circuit-breaker badge များနှင့် error-edge ရုပ်ပုံများအတွက် လှုံ့ဆော်မှုပေးခဲ့သည်။
lobe-icons	2,615	ကျွန်ုပ်တို့၏ dashboard တစ်လျှောက် provider icon များကို ပြသပေးသည့် AI/LLM အမှတ်တံဆိပ်လိုဂိုများ ဖြစ်သည်။
flag-icons	12,473	README ဘာသာစကားရွေးချယ်ကိရိယာတွင် အသုံးပြုသည့် MIT လိုင်စင်ရ SVG အလံများကို ပံ့ပိုးပေးသည်။

### 🛡️ လုံခြုံရေး

ပရောဂျက်	⭐	OmniRoute အတွက် လှုံ့ဆော်မှုပေးခဲ့ပုံ
awesome-secure-defaults	722	ကျွန်ုပ်တို့၏ လုံခြုံရေးရွေးချယ်မှုများကို လမ်းညွှန်ပေးသည့် မူလအတိုင်း လုံခြုံသော library များ၏ စိစစ်ရွေးချယ်ထားသော စာရင်းဖြစ်သည် (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)။

### 🧭 ဖြည့်စွက်အသုံးဝင်သော ကိရိယာများ

ပရောဂျက်	⭐	OmniRoute အတွက် လှုံ့ဆော်မှုပေးခဲ့ပုံ
ClawRouter	6,628	တောင်းဆိုချက် ထပ်နေမှုဖယ်ရှားခြင်း၊ အရေးပေါ် ကုန်ကျစရိတ်မရှိ fallback၊ ထည့်သွင်းချိတ်ဆက်နိုင်သော Auto-Combo မဟာဗျူဟာများနှင့် ဘာသာစကားစုံ ရည်ရွယ်ချက်အမျိုးအစားခွဲခြားမှုတို့အတွက် လှုံ့ဆော်မှုပေးခဲ့သည်။
Antigravity-Manager	32,333	၎င်း၏ အကောင့်အခြေအနေကို သိရှိနိုင်သော မော်ဒယ်ပြန်လည်ချိတ်ဆက်သတ်မှတ်မှု၊ executable လမ်းကြောင်းအတည်ပြုခြင်းနှင့် plan-label အပြုအမူတို့က OmniRoute ၏ Antigravity runtime အတွက် အထောက်အကူပြုခဲ့သည်။
vscode-antigravity-cockpit	4,850	၎င်း၏ ကျစ်လျစ်သော quota-reset နှစ်ပြန်ရေတွက်မှုပုံစံက OmniRoute ရှိ သက်ဆိုင်ရာ provider ကန့်သတ်ချက်ပြသမှုအတွက် လှုံ့ဆော်မှုပေးခဲ့သည်။
AionUi	33,611	၎င်း၏ ACP ချိတ်ဆက်မှုများက ထည့်သွင်းထားသော CLI agent များကို OmniRoute က အလိုအလျောက် ရှာဖွေသိရှိနိုင်စေရန် လှုံ့ဆော်မှုပေးခဲ့သည်။
CodexBar	22,616	Grok Build quota မျက်နှာပြင်ကို ဖော်ထုတ်ပေးခဲ့ပြီးနောက် OmniRoute က လက်ရှိအသုံးပြုနေသော wire format ကို သီးခြားအတည်ပြုကာ ပြင်ဆင်ခဲ့သည်။

## 📄 လိုင်စင် MIT လိုင်စင် - အသေးစိတ်အတွက် [LICENSE](LICENSE) ကို ကြည့်ပါ။ ---

**[⬆ အပေါ်ဆုံးသို့ ပြန်သွားရန်](#-omniroute)** · open-source AI အသိုင်းအဝိုင်းအတွက် ❤️ ဖြင့် တည်ဆောက်ထားပါသည်။ _{OmniRoute v3.8.53 · Node ≥22.22.2 · MIT License · omniroute.online}