# 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 **ဖန်တီးသူ [Diego Souza](https://github.com/diegosouzapw)**

OmniRoute — ကုဒ်ရေးသားခြင်းကို မရပ်တန့်ပါနှင့်။ AI tool တိုင်း → provider 388 ခု — အခမဲ့ 150+ ခု — endpoint တစ်ခုတည်းမှတစ်ဆင့်။ Claude Code၊ Codex၊ Cursor၊ Cline၊ Copilot နှင့် Antigravity ကို အလိုအလျောက် fallback ဖြင့် အခမဲ့ Claude / GPT / Gemini သို့ ချိတ်ဆက်အသုံးပြုနိုင်သည်။ RTK + Caveman ပေါင်းစပ် compression သည် token 15–95% (~89% ပျမ်းမျှ) ချွေတာပေးသောကြောင့် ကန့်သတ်ချက်များကို မည်သည့်အခါမျှ မထိတွေ့ရပါ။ AI provider 388 ခု · အခမဲ့ tier 150+ ခု · ~1.62B အခမဲ့ token/mo · routing strategy 20 ခု · စတင်ရန် $0.

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

> **သင့်ကိုယ်ပိုင် provider အကောင့်များကို အသုံးပြုပါ။** ဤပမာဏသည် သီးခြားအသုံးပြုခွင့်ရသော third-party free tier များကို စုစုပေါင်း ခန့်မှန်းထားခြင်းသာဖြစ်ပြီး OmniRoute မှ ပေးအပ်သော token ထောက်ပံ့ငွေ မဟုတ်ပါ။ လိုအပ်ပါက စာရင်းသွင်းပြီး အထောက်အထားများရယူကာ သင်အသုံးပြုနိုင်သော provider များကို ချိတ်ဆက်ပါ။ Provider တစ်ခုချင်းစီသည် ၎င်းတို့၏ ကန့်သတ်ချက်များ၊ ရရှိနိုင်မှုနှင့် သတ်မှတ်ချက်များကို ကိုယ်တိုင်ထိန်းချုပ်ပါသည်။ > > Free tier များကို ကိုယ်တိုင်ပေါင်းစပ်အသုံးပြုခြင်းသည် ခက်ခဲပါသည် — SDK များ ဒါဇင်နှင့်ချီ၊ rate limit များ ဒါဇင်နှင့်ချီရှိသည့်အပြင် မိမိတွင် အမှန်တကယ် မည်မျှရှိသည်ကိုလည်း မသိနိုင်ပါ။ OmniRoute သည် **34 ခုသော ထပ်တလဲလဲအသုံးပြုသည့် pool key များအတွင်း free-tier entry 465 ခုကို စာရင်းပြုစုထားပြီး၊ ထုတ်ပြန်ထားသော အပြုသဘောဆောင်သည့် လစဉ်ဘတ်ဂျက်ရှိသော pool 17 ခုနှင့် model တစ်ခုချင်းစီအလိုက် Groq cap 5 ခုမှ token ပမာဏကို တွက်ချက်ပါသည်**။ Shared pool တစ်ခုချင်းစီကို တစ်ကြိမ်သာ ရေတွက်ထားပါသည်။ ဒေသအလိုက် identity စစ်ဆေးပြီးမှသာ ဖွင့်ပေးသည့် quota များ (ယနေ့တွင် ModelScope) ကို သီးခြားဖော်ပြထားပြီး၊ ဒေသဆိုင်ရာ identity အတည်ပြုချက်နောက်တွင် +~6M အဖြစ် ထည့်သွင်းပြသသော်လည်း headline တွင် မပေါင်းထည့်ပါ။ ရလဒ်ကို dashboard (`/dashboard/free-tiers`) တွင် ဆက်လက်မြင်တွေ့နိုင်ပါသည်။

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

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

[![Stars](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Star History Rank](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 များနှင့် အကြံပြုချက်များကို အရင်ဆုံး ရယူပါ။** [![Follow Diego on LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Follow @diegosouzapw on GitHub](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) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **မေးခွန်းများ၊ provider အကြံပြုချက်များ၊ 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.54+` | | -------------------------------------------------- | :-------------------------: | :---------: | :------------------------: | | 🌐 ပံ့ပိုးသူများ | 352 | **358** | 388 | | 🧠 ထူးခြားသော စကားပြောမော်ဒယ် ID များ | 1320 | **1374** | 1491 | | 🖼️ မီဒီယာအမျိုးအစား ချိတ်ဆက်တံတား | 🆕 အမြင် + အသံ + ဗီဒီယို | ✓ | ✓ | | 📡 Radar အခမဲ့ကတ်တလောက် | 🆕 ရွေးချယ်အသုံးပြုနိုင်သည် | ✓ | ✓ | | ⚖️ Quota ကိုထည့်သွင်းစဉ်းစားသော အချိန်ဇယားဆွဲခြင်း | 🆕 Quota-Share | ✓ | ✓ | | 📊 Quota တယ်လီမက်ထရီ | 🆕 တိုက်ရိုက် | ✓ | ✓ | | 🧰 Headless မုဒ် | — | — | 🆕 `serve --headless` | | 🛤️ LTS rail အခြေခံအဆောက်အအုံ | — | — | 🆕 ဖြန့်ချိမှု ချန်နယ်များ | | 🔎 မော်ဒယ်ရှာဖွေမှု API | — | — | 🆕 `/v1/models/query` | **→ [လမ်းပြမြေပုံ](ROADMAP.md) — `v3.9.0 LTS` သို့ rail ပေါ်မှ ဆက်လက်ခရီးနှင်ခြင်း**

## 🧩 ရရှိနိုင်မှု [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Monthly](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) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker Pulls](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron Downloads](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

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

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

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

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

```bash # ပံ့ပိုးသူတစ်ခုကို ချိတ်ဆက်ပြီးနောက်၊ 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` သည် သတ်မှတ်ချက်နှင့်ကိုက်ညီသော route တစ်ခု လိုအပ်သည်။ အသစ်ထည့်သွင်းထားသော စနစ်တွင် သတ်မှတ်ချက်နှင့်ကိုက်ညီသည့် keyless target မရှိနိုင်သကဲ့သို့ keyless ပံ့ပိုးသူသည် ပြင်ပ client များကို ငြင်းပယ်နိုင်သည်။ Kiro အပါအဝင် `tos: avoid` ဟု သတ်မှတ်ထားသော ပံ့ပိုးသူများကို ပုံမှန်အားဖြင့် အလိုအလျောက်လမ်းကြောင်းပို့ခြင်းမှ ဖယ်ထုတ်ထားသည်။ အကောင့်တစ်ခုကို ချိတ်ဆက်ခြင်းသည် ထိုသတ်မှတ်ချက်ကို အလိုအလျောက် မပြောင်းလဲပါ။ ပံ့ပိုးသူတစ်ခုကို ရွေးချယ်ခြင်းမပြုမီ [အခမဲ့အဆင့်များ လမ်းညွှန်](docs/getting-started/FREE-TIERS-GUIDE.md) ကို ကြည့်ပါ။} _{📦 **Python, Node.js, PHP နှင့် cURL** အတွက် ကူးယူပြီး တိုက်ရိုက်အသုံးပြုနိုင်သော 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 များ) သည် သတ်မှတ်ချက်နှင့်ကိုက်ညီပြီး ကျန်းမာနေသော target တစ်ခု ရှိနေသရွေ့ ပံ့ပိုးသူအဆင့် 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.54** အတွင်း မကြာသေးမီက ထည့်သွင်းထားသည့် အထူးအချက်များ။ မှတ်တမ်းအပြည့်အစုံကို [`CHANGELOG.md`](CHANGELOG.md) တွင် ကြည့်ရှုနိုင်သည်။ - **⚖️ `quota-weighted` လမ်းကြောင်းရွေးချယ်မှု** — ၂၀ ခုမြောက် combo မဟာဗျူဟာသည် quota ကုန်ဆုံးနေသော account များကို ကျော်ပြီး ကျန် account များအကြား လက်ကျန် quota ÷ လုပ်ဆောင်နေဆဲ load အချိုးအစားအတိုင်း ရွေးချယ်ပေးသည်။ ရှိပြီးသား conversation များကို သက်ဆိုင်ရာ account တွင် ဆက်လက်ချိတ်ဆက်ထားသည်။ → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless mode** — `omniroute serve --headless` (သို့မဟုတ် `OMNIROUTE_HEADLESS=1`) သည် `/v1/*` proxy engine တစ်ခုတည်းကိုသာ လုပ်ဆောင်ပြီး dashboard နှင့် dashboard သီးသန့် subsystem များကို ပိတ်ထားသည်။ → [Headless Mode](docs/guides/HEADLESS.md) - **🔎 Model ရှာဖွေခြင်း** — `/v1/models` သည် capability၊ context၊ kind နှင့် စာသားအလိုက် filter လုပ်ပေးပြီး `POST /v1/models/query` သည် key တစ်ခုချင်းစီအလိုက် တူညီသော မြင်နိုင်ခွင့်ဖြင့် တိုတောင်းပြီး deterministic ဖြစ်သော shortlist ကို ပြန်ပေးသည်။ → [API Reference](docs/reference/API_REFERENCE.md) - **🔑 Key တစ်ခုချင်းစီအလိုက် လမ်းကြောင်းထိန်းချုပ်မှု** — API key တစ်ခုကို `forcedModel` ဖြင့် model တစ်ခု သို့မဟုတ် combo တစ်ခုသို့ ချိတ်ထားနိုင်ပြီး key တစ်ခု၏ model များနှင့် combo များကို atomically ထည့်သွင်းခြင်း သို့မဟုတ် ဖယ်ရှားခြင်း ပြုလုပ်နိုင်သည် (`/api/keys/{id}/access`)။ → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ ပိုမိုအသေးစိတ်သော PII ထိန်းချုပ်မှုများ** — အမျိုးအစားအလိုက် ရွေးချယ်နိုင်ခြင်း၊ validation ပြုလုပ်ထားသော custom masking pattern ၂၀ ခုအထိနှင့် အမျိုးအစားအလိုက် detection counter များ ပါဝင်သည်။ masking ကိုမူ ပုံမှန်အားဖြင့် ပိတ်ထားဆဲဖြစ်သည်။ → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 ဘာသာစကား ၆၇ မျိုး** — dashboard၊ docs mirror များနှင့် CLI တွင် အသုံးပြုနိုင်ပြီး `npm run i18n:add-locale` တစ်ကြိမ်တည်းဖြင့် နေရာတိုင်းတွင် ဘာသာစကားတစ်ခု ထည့်သွင်းနိုင်သည်။ → [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) - **🛂 လိုက်လျောညီထွေသော admission နှင့် overload ကာကွယ်မှု** — အရင်းအမြစ်များစွာလိုအပ်သော chat request များသည် 503 ပြန်ပေးမည့်အစား queue ထဲသို့ ဝင်သွားပြီး connection တစ်ခုချင်းစီအတွက် atomic RPM rolling lease များကို အသုံးပြုသည်။ → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Canonical `/v1/models` အစီအစဉ်** — provider တစ်ခုစီအတွက် provider အလိုက် စုစည်းထားသော ဆက်တိုက် block တစ်ခုစီသာ ရှိပြီး combo များကို အစတွင် ဦးစားပေးထားသည်။ catalog source တိုင်းတွင် တည်ငြိမ်စွာ တူညီနေသည်။ → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Compression ပိုမိုခိုင်မာစေခြင်း** — 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 လမ်းကြောင်းရွေးချယ်မှု** — shared account တစ်ခု၏ quota ကို pooled key များအကြား မျှတစွာ ခွဲဝေပေးပြီး idle ဖြစ်နေသော slice များကို ချေးငှားပေးနိုင်သဖြင့် အရင်းအမြစ်အသုံးချမှုကို မပျက်စေပါ။ → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Command တစ်ခုတည်းဖြင့် CLI/agent တပ်ဆင်ခြင်း** — `setup-*` command ၁၅ ခုကို register ပြုလုပ်ထားသည်။ `omniroute run` သည် CLI ၇ ခု (Claude Code၊ Codex၊ Aider၊ Goose၊ OpenCode၊ Qwen Code၊ Gemini CLI) ကို စတင်ပေးသည်။ `omniroute configure` သည် target ၁၁ ခုကို interactive provider+model picker နှင့် context တစ်ခုချင်းစီအလိုက် favorites များဖြင့် ပံ့ပိုးပေးသည်။ → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Remote mode** — scoped token များ (`connect` / `contexts` / `tokens`) ဖြင့် အဝေးရှိ OmniRoute ကို ထိန်းချုပ်နိုင်ပြီး VPS install များအတွက် `antigravity` OAuth helper ပါဝင်သည်။ → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 ပိုမိုထက်မြက်သော auto-routing** — `auto/:` combo များ၊ **Fusion** (model panel + judge)၊ task-aware routing နှင့် request တစ်ခုချင်းစီအလိုက် model / mode / USD-budget override များကို ပံ့ပိုးသည်။ → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ ထည့်သွင်းချိတ်ဆက်နိုင်သော compression** — ပေါင်းစပ်အသုံးပြုနိုင်သော engine ၁၂ ခုနှင့် Compression Studios ပါဝင်ပြီး LLMLingua-2၊ two-tier Ultra၊ omniglyph၊ step တစ်ခုချင်းစီအလိုက် fidelity gate၊ GCF v3.2 နှင့် drag-reorder editor တို့ကို ပံ့ပိုးသည်။ → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ ပွင့်လင်းမြင်သာသော MITM decrypt (TPROXY)** — proxy environment variable များကို လျစ်လျူရှုသော capture CLI များအတွက် per-SNI CA နှင့် trust-store installer ပါဝင်သည်။ → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 နေရာတိုင်းတွင် ကုန်ကျစရိတ် telemetry** — endpoint တိုင်းတွင် `X-OmniRoute-*` cost/usage header များ၊ cache-HIT savings header နှင့် key တစ်ခုချင်းစီအလိုက် USD spend quota များ ပါဝင်သည်။ → [API Reference](docs/reference/API_REFERENCE.md) - **🧠 သင်ကိုယ်တိုင် ထိန်းချုပ်နိုင်သော Memory** — ပုံမှန်အားဖြင့် ပိတ်ထားပြီး opt-in int8 vector quantization နှင့် typed decay၊ 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 များကို ဖုံးကွယ်ပေးခြင်း)၊ အခမဲ့ 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 လုပ်ဆောင်ချက်များကို ပိုမိုပြည့်စုံစေသည်။ → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 Image / video / audio ထုတ်လုပ်ခြင်း** — 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 အလိုအလျောက်ရှာဖွေခြင်း၊ 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)၊ first-class card အဖြစ် Ollama၊ Claude Opus 5 နှင့် Sonnet 5၊ Kimi official partnership (Code/Web/Moonshot)၊ Zed၊ Requesty၊ SenseNova၊ Yuanbao၊ Agnes AI… နှင့် ပြန်လည်မွမ်းမံထားသော **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 တစ်ခု၏ လက်ရှိ candidate pool ကို ဖော်ပြပေးသည်။ → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Local စွမ်းဆောင်ရည်နှင့် အခြေခံအဆောက်အအုံ** — တစ်ချက်နှိပ်ရုံဖြင့် local Redis၊ Cloudflare Workers / Deno Deploy relay deployers၊ ကြီးကြပ်စီမံထားသော embedded services များအဖြစ် Bifrost နှင့် Mux။ → [Embedded Services](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 အထုပ်ထဲတွင် ပါဝင်သည့်အရာများ** — plugin framework နှင့် marketplace၊ Omni/Agent/GitHub skills frameworks၊ Obsidian vault ပေါင်းစည်းမှု (22 MCP tools)၊ OpenAI-compatible Batch နှင့် Files APIs၊ semantic response cache၊ leaderboard များပါဝင်သော gamification၊ ACP agent ရှာဖွေမှု (built-in agents 15 ခု)၊ BigQuery သို့ အချိန်ဇယားဖြင့် log export ပြုလုပ်မှု၊ `auto/chaos` parallel multi-model fan-out၊ Telegram bot bridge၊ app အတွင်း version manager နှင့် LMArena-ELO အခမဲ့ 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-compatible tool မဆို

_{📖 CLI ကုဒ် ၃၉ ခု (CLI Code ၂၈ ခု + CLI Agent ၁၁ ခု) အားလုံးအတွက် tool တစ်ခုချင်းစီအလိုက် ပြင်ဆင်သတ်မှတ်ခြင်း → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode plugin → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

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

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

> **မှတ်ပုံတင်ထားသော ပံ့ပိုးသူ 388 ခု** ကို canonical chat၊ media၊ search၊ local၊ cloud-agent နှင့် system collection များအနှံ့ တွေ့ရပြီး၊ ၎င်းတို့အနက် **`hasFree: true` ရှာဖွေတွေ့ရှိမှု metadata ပါဝင်သော 153 ခု** ရှိသည်။ Chat model registry တွင် **ပံ့ပိုးသူ 239 ခု / ကွဲပြားသော provider-model pair 3,059 ခု / မူရင်း model ID 1,475 ခု** ပါဝင်သည်။ သီးခြား free-budget catalog တွင် **per-model row 471 ခု**၊ **ထပ်တလဲလဲအသုံးပြုနိုင်သော pool 34 ခု** နှင့် **ထပ်တလဲလဲအသုံးပြုနိုင်ပြီး key မလိုသော အမြဲတမ်းအခမဲ့ ပံ့ပိုးသူ 52 ခု** ပါဝင်သည်။ ဤကိန်းဂဏန်းများသည် ရည်ရွယ်ချက်ရှိရှိ denominator မတူညီကြခြင်းဖြစ်ပြီး၊ အဓိပ္ပာယ်ဖွင့်ဆိုချက်များနှင့် pool များကို ထပ်မတွက်ဘဲ တွက်ချက်ထားသော အချက်အလက်များကို [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 မှ တိုက်ရိုက်ဖြေရှင်းပြသပေးသည်။ 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 အမြဲတမ်းအခမဲ့ — $0၊ ကတ်မလိုပါ

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

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

## 🖥️ Where OmniRoute Runs — နေရာတိုင်း

> တူညီသောအက်ပ်၊ သင့်စက်၊ သင်၏စည်းမျဉ်းများ။ Global npm မှ install လုပ်လိုက်ပါ။** သင့်ဖုန်း** Termux မှတဆင့် ထည့်သွင်းမှု ပိုမြန်သည်

ပလပ်ဖောင်း	Install	ပေါ်လွင်ချက်များ
📦 npm (global)	`npm install -g omniroute`	အမိန့်တစ်ခု၊ မည်သည့် OS
⚡ Bun (global)	`bun add -g omniroute`	တူညီသော registry tarball၊
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm လည်ပတ်သော အီလက်ထရွန်`	မူလဝင်းဒိုး + စနစ်ဗန်း — Windows / macOS / Linux
🎩 ဘား (OmniRouteTray)	`ချက်ချက်ထည့်သွင်းခြင်း --cask zoispag/tap/omniroute-tray`	ကြီးကြပ်သည် & ဆာဗာကို အလိုအလျောက်အပ်ဒိတ်လုပ်သည် — macOS
💪 ARM	ဇာတိ `arm64`	Raspberry Pi၊ ARM ဆာဗာများ၊ Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	သင့်ဖုန်းတွင် , 24/7, အမြစ်မရှိ
📲 PWA	"ပင်မစခရင်သို့ ပေါင်းထည့်ရန်"	မျက်နှာပြင်အပြည့်၊ အော့ဖ်လိုင်း၊ ဘရောင်ဇာမှ ထည့်သွင်းနိုင်သော
🧩 OpenCode ပလပ်အင်	`@omniroute/opencode-provider`	ဇာတိ OpenCode ပေါင်းစပ်မှု
🤖 VS Code Copilot Chat	ထည့်သွင်းပါ OmniCopilot တိုးချဲ့မှု	ဇာတိ Copilot ချတ်ရွေးချယ်မှုတွင် OmniRoute မော်ဒယ်တိုင်း — တည်ငြိမ် & အတွင်းလူ
🛠️ From source	`npm install && npm run dev`	၎င်းကို Hack ပါ၊ ပါဝင်ကူညီပါ

_{📖 [Docker လမ်းညွှန်](docs/guides/DOCKER_GUIDE.md) · [ဒက်စ်တော့](electron/README.md) · [မီနူးဘားဗန်း](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

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

> ဘေးဘားအသစ်မရှိ၊ ချတ် UI အသစ်မရှိပါ — မော်ဒယ် OmniRoute တိုင်းသည် ညာဘက်တွင် ပေါ်လာသည်။** သင်အသုံးပြုပြီးသားCopilot Chat မော်ဒယ်ရွေးချယ်မှု** . VS ကုဒ် 1.122 မှစ၍၊ ဝန်ဆောင်မှုပေးသူမော်ဒယ်များသည် GitHub အကောင့်ဝင်ခြင်း သို့မဟုတ် Copilot စာရင်းသွင်းခြင်းမရှိဘဲ — အေးဂျင့်မုဒ်၊ ကိရိယာခေါ်ဆိုမှုနှင့် အမြင်တို့ကို အခမဲ့လုပ်ဆောင်သည်။ တပ်ဆင်ပါ။** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** တိုးချဲ့မှု၊ ၎င်းကို သင်၏ OmniRoute ဆာဗာတွင် ညွှန်ပြပါ (မူလ `localhost:20128` သို့) ထို့နောက် Copilot Chat → မော်ဒယ်ရွေးချယ်သူ → ဖွင့်ပါ။** မော်ဒယ်များကို စီမံပါ...** →**OmniRoute** . ဖြင့် အလုပ်လုပ်သည် < td align ="left">VS Code — တည်ငြိမ် & လူ< td align ="left">Cursor, Windsurf, VSCodium, Theia code-server Gitpod, Antigravity, Kiro…

	ခ်
🧩 VS Code Marketplace	Install →
🔓 VSX Registry ကိုဖွင့်ပါ	Install →

တည်းဖြတ်သူအတွင်းမှ၊ ကိုဖွင့်ပါ။** တိုးချဲ့မှုများ** ကြည့်ရှုပါ၊ ရှာဖွေပါ။** "OmniRoute"** နှိပ်ပါ။** တပ်ဆင်ပါ။** - စတိုးဆိုင်နှစ်ခုလုံးတွင် တူညီသောနည်းလမ်းဖြင့် လုပ်ဆောင်သည်။ အရင်းအမြစ်၊ ပြဿနာများနှင့် ထုတ်ဝေခြင်းဆိုင်ရာ စာအုပ်ကို [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) တွင် တိုက်ရိုက်ထုတ်လွှင့်သည်။ _{📖 [VS ကုဒ် Copilot ချတ်လမ်းညွှန်](docs/guides/VSCODE-COPILOT.md) — စနစ်ထည့်သွင်းမှု၊ ရွေးချယ်မှုပြသသည့်အရာ၊ ဒက်ရှ်ဘုတ်-တစ်ဘ်တစ်ဘ်၊} ပြဿနာဖြေရှင်းခြင်း

### 🎩 အသစ်- OmniRouteTray — မီနူးဘားတွင်နေထိုင်သော သင်၏တံခါးပေါက်

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

ဘာလုပ်တာလဲ	ဘယ်လို
🟢 ဆာဗာ	Spawns `omniroute ဝန်ဆောင်မှု`
📊 အကြည့်တစ်ချက်တွင် တိုက်ရိုက်အသုံးပြုမှု	ဝန်ဆောင်မှုပေးသူ ခွဲတမ်းဘားများ၊ Claude session/weekly န့်သတ်ချက်များကို ပြန်လည်သတ်မှတ်ခြင်းဖြင့် ရေတွက်ခြင်းများ၊ ရက် 30 ကြာ ကုန်ကျစရိတ်ခွဲခြမ်းစိတ်ဖြာ
🔄	နေရာတွင် အလိုအလျောက် အပ်ဒိတ်များ အဆင့်ဆင့် တပ်ဆင်ခြင်း၊ အနုမြူ လဲလှယ်ခြင်း၊ ပျက်ကွက်ခြင်းအပေါ် ပြန်လှည့်ခြင်း — အမြဲတမ်း နောက်ဆုံးထွက်ရှိ
🚀 လော့ဂ်အင်တွင် စတင်ပါ	လော့ဂ်အင်တွင် ရွေးချယ်နိုင်သော စတင်ပါ။ tray-only၊ dock icon
🩺 ဆရာဝန် & မှတ်တမ်းများ	တစ်ချက်နှိပ်ရုံဖြင့် ရောဂါရှာဖွေခြင်းနှင့် ဆာဗာမှတ်တမ်းဝင်ရောက်ခြင်း

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

💛 @zoispag မှ ကွန်မြူနတီပရောဂျက်တစ်ခု — တရားဝင် OmniRoute ထုတ်ဝေမှုမဟုတ်ပါ။}

## 🔒 သီးသန့်ဖြစ်ပြီး 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)}

## 🗜️ တိုကင် 15–95% ချွေတာခြင်း — အလိုအလျောက်

### 📖 အလုပ်လုပ်ပုံ — pipeline၊ architecture နှင့် ချွေတာမှုတွက်ချက်ပုံ

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

ပုံမှန် stacked combo သည် `RTK → Caveman` ကို လုပ်ဆောင်သည်။ နှစ်ခုစလုံးသည် တူညီသော 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 blocks၊ URLs၊ JSON နှင့် structured data များကို preservation engine က **အမြဲတမ်း ကာကွယ်ထားသည်**။ > **တိုကင်အများကြီးသုံးစရာမလိုဘဲ တိုကင်အနည်းငယ်နဲ့ အလုပ်ဖြစ်နိုင်တဲ့အခါ ဘာကြောင့် အများကြီးသုံးမလဲ?** Request တိုင်းသည် client ပြောင်းလဲရန်မလိုဘဲ OmniRoute ၏ compression pipeline ကို **ပွင့်လင်းမြင်သာစွာ** ဖြတ်သန်းသည်။ ယခုအခါ ၎င်းသည် အစဉ်လိုက်လုပ်ဆောင်ပြီး routing combo တစ်ခုချင်းစီအလိုက် ရောစပ်ရွေးချယ်အသုံးပြုနိုင်သော **ပေါင်းစပ်အသုံးပြုနိုင်သည့် engine 12 ခု၏ 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 12 ခု၏ stack Engine များသည် pipeline အစီအစဉ်အတိုင်း လုပ်ဆောင်ပြီး တစ်ခုချင်းစီကို သီးခြားဖွင့်/ပိတ်နိုင်သကဲ့သို့ combo တစ်ခုချင်းစီအလိုက် ပြင်ဆင်သတ်မှတ်နိုင်သည်-

#	Engine	လုပ်ဆောင်ချက်
1	Session-Dedup	Turn များအကြား ထပ်ခါတလဲလဲဖြစ်နေသော content ကို ဖယ်ရှားသည် (content-addressed၊ cross-turn)
2	CCR	ကြီးမားသော block များကို retrieve marker များနောက်တွင် သိမ်းဆည်းပြီး လိုအပ်သည့်အခါမှ ရယူသည်
3	Lite	Whitespace နှင့် image-URL ဖြတ်တောက်ခြင်း (latency-light baseline)
4	RTK	ထက်မြက်သော tool-result filtering၊ 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 နှင့် နှိုင်းယှဉ်၍ sentence scoring ပြုလုပ်ကာ extract လုပ်သည်
8	Caveman	စည်းမျဉ်းအခြေပြု prose compression (output ပေါ်တွင် ~65–75%)
9	Aggressive	အဟောင်း turn များကို summarization နှင့် progressive aging ပြုလုပ်သည်
10	LLMLingua-2	MobileBERT ONNX မှတစ်ဆင့် ML semantic pruning ပြုလုပ်သည် — code-safe၊ async
11	Ultra	ရွေးချယ်အသုံးပြုနိုင်သော small-model (SLM) tier ပါဝင်သည့် heuristic token pruning
12	OmniGlyph	Direct Anthropic wire ပေါ်တွင် တိုင်းတာထားသော Claude Fable 5 အတွက် context-as-image encoding ကို စမ်းသပ်အသုံးပြုခြင်း၊ GPT 5.6 transformers များသည် provider receipts ရရှိသည်အထိ fail-closed အဖြစ် ဆက်လက်ထားရှိသည်။ Compression profile လေးမျိုး (aggressive default၊ balanced၊ coding-safe၊ passthrough) (အပြင်းထန်ဆုံး၊ opt-in)

Code blocks၊ URLs နှင့် structured data များကို **byte-perfect အတိုင်း အမြဲထိန်းသိမ်းထားသည်**။ **တစ်ချက်နှိပ် 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 ခု):** _"သင့် React component က ပြန်လည် render ဖြစ်နေသည့်အကြောင်းရင်းမှာ render cycle တစ်ခုချင်းစီတွင် object reference အသစ်တစ်ခု ဖန်တီးနေခြင်း ဖြစ်နိုင်ချေများသည်။ Inline object တစ်ခုကို prop အဖြစ်ပေးသောအခါ React ၏ shallow comparison က ၎င်းကို အကြိမ်တိုင်း မတူညီသော object တစ်ခုအဖြစ် မြင်သောကြောင့် re-render ဖြစ်စေသည်။ Object ကို memoize ပြုလုပ်ရန် useMemo အသုံးပြုရန် အကြံပြုပါသည်။"_ > > **လုပ်ဆောင်ပြီး (တိုကင် 19 ခု):** _"Render တစ်ကြိမ်စီတွင် object ref အသစ်။ Inline object prop = ref အသစ် = re-render။ useMemo ဖြင့် wrap လုပ်ပါ။"_ > > **အဖြေတူညီသည်။ တိုကင် 72% လျော့နည်းသည်။ တိကျမှုပျောက်ဆုံးမှု သုည။** ✅ **PT-BR ဥပမာ — [Troglodita](https://github.com/leninejunior/troglodita) mode:** > **အရင် (တိုကင် ၄၂ ခု):** _"ပြဿနာက component ဟာ render cycle တိုင်းမှာ object reference အသစ်တစ်ခု ဖန်တီးနေတဲ့အတွက် ပြန်လည် render လုပ်နေခြင်း ဖြစ်ပါတယ်။ `useMemo` ကို အသုံးပြုဖို့ အကြံပြုပါတယ်။"_ > > **နောက် (တိုကင် ၁၂ ခု):** _"ပြန်လည် render: cycle တိုင်း ref အသစ် (inline object ပြန်လည်ဖန်တီးထားသည်)။ `useMemo` အသုံးပြုပါ။"_ > > **တူညီသောအဖြေ။ တိုကင် ၇၀% ခန့် လျော့နည်းသည်။ နည်းပညာပိုင်းဆိုင်ရာ တိကျမှု မပြောင်းလဲပါ။** ✅
### 🎚️ အင်ဂျင်များအပြင် — output styles၊ adaptive dial နှင့် request တစ်ခုချင်းစီ ထိန်းချုပ်မှု အထက်ပါ အင်ဂျင် ၁၂ ခုက **ဝင်လာသည့်အရာ** ကို ချုံ့ပေးသည်။ ထပ်ဆင့်အလွှာ ၃ ခုက **မည်သို့**၊ **မည်သည့်အချိန်တွင်** နှင့် မည်သည့်အရာ **ထွက်လာမည်** ကို ပုံဖော်ပေးသည်- - **🪄 Output Styles** _(output-axis steering)_ — တိကျစွာ ထပ်တလဲလဲရနိုင်ပြီး cache-safe ဖြစ်သော response ပုံဖော်ညွှန်ကြားချက်များကို ထည့်သွင်းပေးသည်။ ပေါင်းစပ်အသုံးပြုနိုင်ပြီး တစ်ခုချင်းစီကို `lite` / `full` / `ultra` ပြင်းအားများဖြင့် သတ်မှတ်နိုင်သည်။ Style ထည့်သွင်းရန် registry entry တစ်ကြောင်းသာ လိုအပ်သည်- - **Terse prose** — ဖြည့်စွက်စကားလုံးများ / articles / မသေချာမှုဖော်ပြချက်များကို ဖယ်ရှားပြီး နည်းပညာဆိုင်ရာ အကြောင်းအရာကို တိကျစွာ ထိန်းသိမ်းပါ။ - **Less code** — "ပျင်းရိသော senior dev" YAGNI: အလုပ်လုပ်နိုင်သည့် အပြောင်းအလဲအသေးဆုံးကိုသာ ပြုလုပ်ပြီး မတောင်းဆိုထားသော scaffolding မထည့်ပါနှင့်။ - **Ponytail (lazy senior dev)** — YAGNI အဆင့်များအတိုင်း တက်လှမ်းကာ အခြေခံအကြောင်းရင်းကို ဖြေရှင်းပြီး အလုပ်လုပ်နိုင်သည့် diff အသေးဆုံးကို ပြုလုပ်ပါ။ - **I have ADHD (action-first)** — နောက်တစ်ဆင့် လုပ်ဆောင်ချက်ကို ဦးစွာဖော်ပြပြီး အဆင့်များကို နံပါတ်တပ်ပါ။ လက်တွေ့လုပ်ဆောင်နိုင်သော နောက်တစ်ဆင့်တစ်ခုသာ ထားရှိပြီး အကြိုရှင်းလင်းချက် မထည့်ပါနှင့်။ - **Terse CJK (文言)** — ရှေးဟောင်းတရုတ်ဘာသာစကားပုံစံ အလွန်တိုတောင်းသော style (`zh` locale အတွက်သာ သတ်မှတ်ထားသည်)။ - **🎯 Adaptive context-budget** _(dial)_ — ဖွင့်/ပိတ်နိုင်သော token threshold တစ်ခုတည်းအစား context window အတွင်း **အံဝင်ရန်** လိုအပ်သလောက်သာ ကုန်ကျစရိတ်အနည်းဆုံးနှင့် အချက်အလက်ဆုံးရှုံးမှုအနည်းဆုံး အင်ဂျင်များကို အဆင့်မြှင့်အသုံးပြုသည်။ Policy: `reserve-output` (ပုံမှန်၊ model-aware) · `percentage` · `absolute`။ Mode: `floor` (အံဝင်မှုကို အာမခံသည်) · `replace-autotrigger` (သင်ကိုယ်တိုင် ရွေးချယ်ထားမှုက အနိုင်ရသည်) · `off` (ယခင် threshold)။ - **🎛️ Compression ကို ဆုံးဖြတ်သည့်နေရာ** _(ဦးစားပေးအဆင့်၊ မြင့်မှနိမ့်သို့)_ — 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 တစ်ခုကို သတ်မှတ်ပါ၊ request တစ်ခုအတွက်သာ တစ်ကြိမ်သုံး သတ်မှတ်ပါ၊ သို့မဟုတ် routing combo တစ်ခုချင်းစီအတွက် pipeline သတ်မှတ်ပါ — workload နှင့် ကိုက်ညီသည့်နည်းကို ရွေးချယ်နိုင်သည်။ ရွေးချယ်အသုံးပြုနိုင်သော offline **eval harness** (`npm run eval:compression`) သည် ပြောင်းလဲမှုတစ်ခုကို တရားဝင်အသုံးမပြုမီ သတ်မှတ်ထားသော 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) ထည့်သွင်းပြီး run လုပ်ပါ** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` သို့မဟုတ် peer-dep warnings တွေ့ပါသလား။ [၎င်းတို့သည် အန္တရာယ်မရှိပါ](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)။ > **npm 11 သို့မဟုတ် နောက်ပိုင်းကို အသုံးပြုနေပါသလား။** ခွင့်ပြုထားခြင်းမရှိပါက npm သည် package lifecycle scripts များကို ပိတ်ဆို့နိုင်သည်။ OmniRoute ၏ `postinstall` (`node scripts/build/postinstall.mjs`) သည် ၎င်း၏ native runtime files များကို ပြင်ဆင်ရန် လိုအပ်သည်။ Global အနေဖြင့် ထည့်သွင်းသည့်အခါ npm warning တွင် ဖော်ပြထားသော package များကို ခွင့်ပြုပါ။ OmniRoute 3.8.54 က ဖော်ပြထားသော package အစုအတွက်- > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > နောင် global installs များအတွက် ဤ allowlist ကို ပြန်လည်အသုံးပြုရန် တစ်ကြိမ် configure လုပ်ပြီးနောက် ပုံမှန်အတိုင်း ထည့်သွင်းပါ- > > ```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 တစ်ခုကို ဖော်ပြပါက ထို warning ထဲရှိ package အမည်များကို အသုံးပြုပါ။ Package တစ်ခုကို ခွင့်ပြုခြင်းသည် ၎င်း၏ install scripts များကို 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 ဖြင့် သင့်အသုံးပြုမှုနှင့် ကိုက်ညီသော provider တစ်ခုကို ချိတ်ဆက်ပါ** Dashboard → **Providers** → လက်ရှိစည်းမျဉ်းများနှင့် quota သည် သင့်အသုံးပြုမှုနှင့် ကိုက်ညီသော provider ကို ရွေးချယ်ပါ → ၎င်း၏ API key ကို ထည့်ပါ သို့မဟုတ် account flow ကို ပြီးဆုံးအောင် လုပ်ပါ။ Free tier များတွင် signup၊ approval သို့မဟုတ် payment method လိုအပ်နိုင်သည်။ [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) ကို ပြန်လည်သုံးသပ်ပါ။ keyless availability ကို အာမမခံနိုင်ပါ။ `tos: avoid` ဟု အမှတ်အသားပြုထားသော provider များကို ပုံမှန်အားဖြင့် `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 headers များ ပေးပို့၍မရပါက OmniRoute သည် tokenized compatibility aliases များကိုလည်း ပံ့ပိုးပေးသည်- ```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) |

---

## 🛠️ နည်းပညာအစုအဝေး

အလွှာ	နည်းပညာ
လုပ်ဆောင်မှုပတ်ဝန်းကျင်	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
ဘာသာစကား	TypeScript 6.0 — `src/` နှင့် `open-sse/` တစ်လျှောက် TypeScript 100% (v2.0 မှစ၍ core တွင် `any` လုံးဝမရှိ)
ဖရိမ်းဝေါ့ခ်	Next.js 16 + React 19 + Tailwind CSS 4
ဒေတာဘေ့စ်	better-sqlite3 (SQLite၊ WAL မှတ်တမ်းရေးသားခြင်း) + LowDB (JSON အမွေအနှစ်စနစ်) — ဒိုမိန်းမော်ဂျူး 147 ခု၊ မိုင်ဂရေးရှင်း 233 ခု
မှတ်ဉာဏ်	SQLite FTS5 စာသားအပြည့်အစုံရှာဖွေမှု + int8-quantized vector embeddings၊ အမျိုးအစားသတ်မှတ်ထားသော decay
စကီးမားများ	Zod 4 — MCP tool I/O validation + API contracts
ပရိုတိုကောများ	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
စီးကြောင်းပို့ခြင်း	Server-Sent Events (SSE) + WebSocket bridge (`/v1/ws`)
ချုံ့ခြင်း	အင်ဂျင် 12 ခုပါ pipeline — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
အထောက်အထားပြခြင်း & လုံခြုံရေး	OAuth 2.0 (PKCE) + JWT + API Keys + MCP scoped auth · AES-256-GCM at rest · DOMPurify
လျှို့ဝှက်ဖုံးကွယ်မှု	wreq-js — JA3 / JA4 TLS fingerprint impersonation၊ အဆင့် 3 ဆင့်ပါ proxy
ခံနိုင်ရည်ရှိမှု	Circuit breaker၊ exponential backoff၊ anti-thundering-herd၊ auto-combo self-healing
မှတ်တမ်းတင်ခြင်း	pino — request context ပါဝင်သော ဖွဲ့စည်းပုံတကျ JSON မှတ်တမ်းများ
စမ်းသပ်ခြင်း	Node.js test runner + Vitest — စောင့်ကြည့်မှတ်တမ်းတင်ထားသော စမ်းသပ်ဖိုင် 8,400 ကျော်အတွင်း static test declarations 60,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 ပေါင်းစည်းမှု၊ ဖြန့်ချိခြင်း
တပ်ဆင်သတ်မှတ်ခြင်းလမ်းညွှန်	တပ်ဆင်နည်းလမ်းများအပြည့်အစုံ၊ CLI tool configurations၊ protocol setup၊ timeout ချိန်ညှိခြင်း
CLI Tools လမ်းညွှန်	Claude Code၊ Codex၊ Cursor၊ Cline၊ OpenClaw၊ Kilo၊ Copilot တစ်ခုချင်းစီအတွက် တပ်ဆင်သတ်မှတ်ခြင်း
အဝေးမှ လုပ်ဆောင်မှုမုဒ်	သတ်မှတ်နယ်ပယ်အတွင်း access token များမှတစ်ဆင့် laptop CLI ဖြင့် အဝေးရှိ OmniRoute (VPS) ကို ထိန်းချုပ်ခြင်း
Claude Code သတ်မှတ်ချက်	`launch` နှင့် model တစ်ခုချင်းစီအတွက် profiles များကို အသုံးပြု၍ Claude Code ကို OmniRoute (local/remote) သို့ ချိတ်ဆက်ခြင်း
အမြန်စတင်ခြင်း	အဆင့် ၃ ဆင့်ဖြင့် တပ်ဆင်ခြင်း → ချိတ်ဆက်ခြင်း → သတ်မှတ်ခြင်း

### 🔧 လုပ်ငန်းဆောင်ရွက်မှုနှင့် ဖြန့်ချိခြင်း

စာရွက်စာတမ်း	ဖော်ပြချက်
Docker လမ်းညွှန်	Docker run၊ Compose profiles၊ Caddy HTTPS၊ tunnels၊ image tags
Podman လမ်းညွှန်	Quadlet systemd ပေါင်းစည်းမှု၊ podman-compose၊ SELinux
VM ဖြန့်ချိခြင်း	လမ်းညွှန်အပြည့်အစုံ - VM + nginx + Cloudflare တပ်ဆင်သတ်မှတ်ခြင်း
Fly.io ဖြန့်ချိခြင်း	အမြဲတမ်းသိမ်းဆည်းမှုဖြင့် Fly.io သို့ ဖြန့်ချိခြင်း
Termux လမ်းညွှန်	Termux မှတစ်ဆင့် Android ပေါ်တွင် OmniRoute ကို လုပ်ဆောင်ခြင်း
PWA လမ်းညွှန်	Progressive Web App တပ်ဆင်ခြင်း၊ caching၊ architecture
ဖယ်ရှားခြင်းလမ်းညွှန်	တပ်ဆင်နည်းလမ်းအားလုံးအတွက် သန့်ရှင်းစွာ ဖယ်ရှားခြင်း
Environment သတ်မှတ်ချက်	`.env` variables နှင့် references အပြည့်အစုံ

### 🧠 လုပ်ဆောင်ချက်များနှင့် ဖွဲ့စည်းပုံ

စာရွက်စာတမ်း	ဖော်ပြချက်
ဖွဲ့စည်းပုံ	စနစ်ဖွဲ့စည်းပုံ၊ ဒေတာစီးဆင်းမှုနှင့် အတွင်းပိုင်းလုပ်ဆောင်ပုံ
ချုံ့ခြင်းလမ်းညွှန်	ရွေးချယ်စရာ ၇ မျိုးပါ pipeline - off / lite / standard / aggressive / ultra / RTK / stacked
RTK ချုံ့ခြင်း	Command-output ချုံ့ခြင်း၊ filters၊ ယုံကြည်စိတ်ချရမှု၊ အတည်ပြုခြင်း၊ raw-output ပြန်လည်ရယူခြင်း
ချုံ့ခြင်းအင်ဂျင်များ	Caveman၊ RTK၊ stacked pipelines၊ dashboard/API/MCP surfaces
ချုံ့ခြင်းစည်းမျဉ်းပုံစံ	Caveman နှင့် RTK filters များအတွက် JSON rule-pack schemas
ချုံ့ခြင်းဘာသာစကားပက်များ	ဘာသာစကားရှာဖွေခြင်းနှင့် Caveman rule-pack ရေးသားခြင်း
ခံနိုင်ရည်ရှိမှုလမ်းညွှန်	Circuit breakers၊ cooldowns၊ queue၊ anti-thundering herd၊ TLS spoofing
အလိုအလျောက် Combo အင်ဂျင်	အချက် ၁၆ ချက်အပေါ် အမှတ်ပေးခြင်း၊ mode packs၊ ကိုယ်တိုင်ပြန်လည်ပြုပြင်ခြင်း
Proxy လမ်းညွှန်	အဆင့် ၃ ဆင့်ပါ proxy စနစ်၊ 1proxy marketplace၊ registry CRUD
အခမဲ့အဆင့်များ	စုစည်းထားသော လမ်းညွှန် - မှတ်တမ်းတင်ထားသည့် ထပ်တလဲလဲအသုံးပြုနိုင်သော pools ၃၄ ခု / catalog ပြုလုပ်ထားသည့် free-tier entries ၄၆၅ ခု
လုပ်ဆောင်ချက်များပြခန်း	screenshots များဖြင့် dashboard ကို အမြင်အာရုံဖြင့် လေ့လာခြင်း
Codebase စာရွက်စာတမ်း	စတင်လေ့လာသူများအတွက် နားလည်လွယ်သော codebase လေ့လာချက်

### 🤖 Protocols နှင့် APIs

စာရွက်စာတမ်း	ဖော်ပြချက်
API ကိုးကားချက်	ဥပမာများနှင့်အတူ endpoints အားလုံး
OpenAPI သတ်မှတ်ချက်	OpenAPI 3.0 သတ်မှတ်ချက်
MCP Server	MCP tools ၁၁၀ ခု၊ IDE configurations၊ Python/TS/Go clients
MCP Server လမ်းညွှန်	MCP တပ်ဆင်ခြင်း၊ transports နှင့် tool ကိုးကားချက်
A2A Server	JSON-RPC 2.0 protocol၊ skills၊ streaming၊ task mgmt
A2A Server လမ်းညွှန်	A2A agent card၊ tasks၊ skills နှင့် streaming

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

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

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

အဆင့်	ပံ့ပိုးကူညီသူ	ပေါင်းစည်းပြီး PR များ	~ပြောင်းလဲထားသော လိုင်းများ
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{2026-11-03 03:01:19 UTC တွင် တိုက်ရိုက် release/v3.8.53 tip 05bc048d6c ဖြင့် ကောက်ယူထားသော စာရင်းဖြစ်ပါသည်။ စာမျက်နှာခွဲထားသော GitHub GraphQL စာရင်းတွင် ပေါင်းစည်းပြီး PR စုစုပေါင်း 9,947 ခု ပါဝင်သည်။ ၎င်းတို့အနက် 4,130 ခုမှာ repository ပိုင်ရှင်ထံမှ၊ 240 ခုမှာ Dependabot ထံမှ၊ 6 ခုမှာ အခြား bot/app များထံမှ ဖြစ်ပြီး၊ ပြင်ပပံ့ပိုးကူညီသူ 883 ဦးထံမှ ပြင်ပ PR 5,571 ခု ပါဝင်ပါသည်။ “ပြောင်းလဲထားသော လိုင်းများ” သည် GitHub ၏ ထည့်သွင်းမှုများ + ဖျက်ပယ်မှုများကို ဆိုလိုပြီး generated ဖိုင်များ၊ lockfiles၊ catalogs၊ ဘာသာပြန်များနှင့် documentation များလည်း ပါဝင်သည်။ ၎င်းသည် ရေးသားသူ၏ LOC မဟုတ်ဘဲ ပြောင်းလဲမှုအရေအတွက် ဖြစ်ပါသည်။ PR 53 ခုတွင် GitHub diff များသည် လိုင်း 500,000 ကျော်ရှိကြောင်း ဖော်ပြထားသည် (ဥပမာ #13399 တွင် provider တစ်ခုတည်း ထည့်သွင်းထားသော်လည်း ပြောင်းလဲထားသော ဖိုင် 2,347 ခုကို ဖော်ပြထားသည်)။ ထို့ကြောင့် အထက်ပါ စုစုပေါင်းအချို့မှာ မြင့်တက်နေပါသည်။ အဆင့်တူသူများကို အတူတကွ အဆင့်သတ်မှတ်ထားပါသည်။} ### GitHub မှ သတ်မှတ်ပေးထားသော commit များ

Dizzle _{🥇 GitHub မှ သတ်မှတ်ပေးထားသော commit 418 ခု}	Bob.Hou _{🥈 GitHub မှ သတ်မှတ်ပေးထားသော commit 294 ခု}	Paijo _{🥉 GitHub မှ သတ်မှတ်ပေးထားသော commit 229 ခု}	Paco Cartones _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 222 ခု}	backryun _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 202 ခု}	Jan Leon _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 134 ခု}
Ravi Tharuma _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 126 ခု}	Markus Hartung _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 115 ခု}	Randi _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 108 ခု}	Chris _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 70 ခု}	WebPerson _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 68 ခု}	Koosha Paridehpour _{🏅 GitHub မှ သတ်မှတ်ပေးထားသော commit 68 ခု}

_{2026-11-03 02:09:16 UTC တွင် ပြန်လည်စစ်ဆေးထားသည်။ GitHub ၏ Contributors API က မူရင်း release/v3.8.53 branch အတွက် အစီရင်ခံထားသော GitHub မှ သတ်မှတ်ပေးထားသည့် commit များ ဖြစ်သည်။ API က identity 903 ခု (အသုံးပြုသူ 429 ဦး၊ bot 2 ခု၊ အမည်မဖော်သူ 472 ဦး) ကို ပြန်ပေးခဲ့သည်။ ဤဇယားတွင် maintainer၊ bot များနှင့် အမည်မဖော်သူ identity များကို ဖယ်ရှားထားပြီး အဆင့်တူရလဒ်များကို ထိန်းသိမ်းထားသည်။ ၎င်းသည် အထက်ပါ merged-PR အဆင့်သတ်မှတ်ချက်နှင့် အောက်ပါ Git-metadata census နှစ်ခုစလုံးမှ သီးခြားဖြစ်သည်။} > 🙏 ဤ contributor များ၏ feature များ၊ bug ပြင်ဆင်မှုများနှင့် 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 ကို အခမဲ့နှင့် အမှီအခိုကင်းစွာ ဆက်လက်တည်ရှိစေပါသည်။

## 👥 ပံ့ပိုးသူ ၁,၀၀၀ ကျော်

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-11-02 တွင် live release/v3.8.53 tip 1c7135e0fb (commit ၇,၉၇၂ ခု) ကို စစ်ဆေးခဲ့သည် — ပုံမှန်ပြုထားသော လူသား Git အထောက်အထား ၁,၀၇၄ ခု ရှိပြီး ၇၅၉ ခုသည် commit author များအဖြစ် (maintainer အပါအဝင်) ပေါ်လာကာ ၃၁၅ ခုသည် Co-authored-by trailer များတွင်သာ ပါဝင်သည်။ ဤစာရင်းကောက်ယူမှုတွင် .mailmap ကို အသုံးပြုထားပြီး e-mail လိပ်စာများကို စာလုံးအကြီးအသေးမခွဲခြားဘဲ နှိုင်းယှဉ်ထားသည်။ ဂဏန်းပါသော GitHub noreply လိပ်စာနှင့် ရိုးရိုး GitHub noreply လိပ်စာတို့သည် တူညီသော handle ကို ဖော်ပြသည့်အခါတွင်သာ ပေါင်းစည်းထားသည်။ bot/agent/service/placeholder အထောက်အထား ၂၉ ခုကို ဖယ်ထုတ်ထားပြီး display name တူညီရုံမျှဖြင့် ပုံမှန် e-mail လိပ်စာများကို မပေါင်းစည်းထားပါ။ 2026-08-24 စစ်ဆေးမှုတွင် ၆၃၉ ခုကို ထုတ်ပြန်ခဲ့သည်။ ထိုစစ်ဆေးမှု၏ အခြေခံ ac02c5b42f ပေါ်တွင် ဤနည်းလမ်းကို ပြန်လည်အသုံးပြုသောအခါ ၆၁၉ ခု ရရှိသဖြင့် တိုးလာခြင်းသည် နည်းလမ်းကို ပိုမိုလျော့ရဲစွာ အသုံးပြုခြင်းကြောင့်မဟုတ်ဘဲ ပံ့ပိုးသူအသစ်များကြောင့် ဖြစ်သည်။} ### ပံ့ပိုးရန် နည်းလမ်း 1. Repository ကို fork လုပ်ပါ 2. **လက်ရှိ** `release/vX.Y.Z` tip မှ branch ခွဲပါ (`main` မဟုတ်ပါ) — [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) ကို ကြည့်ပါ။ ### Version အသစ် ထုတ်ဝေခြင်း ```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 အရေအတွက်များကို GitHub ၏ REST API မှ 2026 ခုနှစ် နိုဝင်ဘာလ 3 ရက်နေ့တွင် အတည်ပြုထားပါသည် — ဤပရောဂျက်များကို star ပေးလိုက်ပါ။ အရေအတွက်များသည် သတ်မှတ်ရက်စွဲအလိုက် အတိအကျမှတ်တမ်းတင်ထားခြင်းဖြစ်ပြီး သဘာဝအတိုင်း ပြောင်းလဲနိုင်ပါသည်။ ### 🧬 မျိုးရိုးနှင့် gateway

ပရောဂျက်	⭐	OmniRoute အပေါ် လှုံ့ဆော်ပေးခဲ့ပုံ
9router	31,861	ဤ fork ကို တည်ဆောက်ထားသည့် မူလပရောဂျက်ဖြစ်ပြီး — ဤနေရာတွင် multi-modal APIs များနှင့် TypeScript ဖြင့် အပြည့်အဝ ပြန်လည်ရေးသားမှုကို ထပ်မံတိုးချဲ့ထားပါသည်။
CLIProxyAPI	57,329	ဤ JavaScript / TypeScript port အတွက် လှုံ့ဆော်မှုပေးခဲ့သော Go implementation ဖြစ်ပါသည်။
LiteLLM	62,580	ကျွန်ုပ်တို့၏ ကုန်ကျစရိတ်ခြေရာခံမှု sync အတွက် အများပြည်သူသုံး pricing dataset ကို ပံ့ပိုးပေးပြီး၊ provider-normalization model မှာ ကျွန်ုပ်တို့၏ routing ကို လမ်းညွှန်ပေးခဲ့သော AI gateway ဖြစ်ပါသည်။
codex-chatgpt-web	15,435	Vendored ChatGPT Web → Codex Responses bridge တွင် အသုံးပြုထားသော MIT source ဖြစ်ပြီး browser-session၊ response-framing၊ usage နှင့် web-search adapters များအပါအဝင် ဖြစ်ပါသည်။
free-claude-code	65,966	Stream recovery၊ no-thinking aliases၊ fallback web search၊ sliding-window limits၊ log redaction နှင့် ပိုမိုလုံခြုံခိုင်မာသော launcher flows များတွင် ၎င်း၏ပုံစံများကို port ပြုလုပ်အသုံးချထားပါသည်။
composer-api	347	Cursor Composer ၏ tool-choice၊ output-constraint နှင့် tool-commit ပုံစံများကို native Cursor executor အတွက် လိုက်လျောညီထွေ ပြုပြင်အသုံးချထားပါသည်။
codex-multi-auth	561	Fresh-login နှင့် refresh-token rotation ပုံစံများကို Codex OAuth reauthentication အတွင်း port ပြုလုပ်အသုံးချထားပါသည်။
opencode-anthropic-auth	562	Claude Code-compatible transform defaults နှင့် billing-header အပြုအမူများကို OmniRoute ၏ config-driven bridge အတွင်း ယေဘုယျပုံစံအဖြစ် အသုံးချထားပါသည်။
grok2api-merged	2	၎င်း၏ Grok model mappings၊ fake-TypeError Statsig generator၊ request နှင့် device defaults များ၊ NDJSON response processor တို့ကို OmniRoute ၏ Grok Web executor အတွင်း အဓိကအတိုင်းအတာဖြင့် ပြုပြင်အသုံးချထားပါသည်။
TQZHR/grok2api	707	grok2api-merged ၏ အဓိက transitive code source ဖြစ်ပြီး၊ ၎င်း၏ model၊ header၊ payload၊ Statsig နှင့် processor implementations များကို Grok Web မျိုးရိုးအတွင်း ထိန်းသိမ်းထားပါသည်။
chenyme/grok2api	7,874	TQZHR နှင့် grok2api-merged တို့မှတစ်ဆင့် ဆက်လက်ပါဝင်လာသော Grok payload နှင့် device defaults များ၊ Statsig generator နှင့် `result.response` processor တို့အတွက် အခြေခံ MIT source ဖြစ်ပါသည်။
grok2api-pro	27	၎င်း၏ proxy-pool layer အတွက် grok2api-merged က credit ပေးထားသော transitive source ဖြစ်ပါသည်။ OmniRoute သည် ထိုမျိုးရိုးအသိအမှတ်ပြုချက်ကို ထိန်းသိမ်းထားသော်လည်း ၎င်း၏ ကန့်သတ်ထားသော Grok Web executor အတွင်း proxy-pool port ပါဝင်သည်ဟု မဆိုထားပါ။
GrokProxy	52	၎င်း၏ cookie-authenticated Grok proxy နှင့် `result.response.token` streaming ပုံစံတို့က OmniRoute ၏ Grok Web transport ကို လမ်းညွှန်ပေးခဲ့ပါသည်။
GrokBridge	5	မူလ Grok Web implementation ၏ HTTP/browser upstream ဒီဇိုင်းကို လေ့လာအသုံးပြုခဲ့ပါသည်။ ၎င်း၏ direct HTTP path သည် GrokProxy မှ ဆင်းသက်လာသောကြောင့် သီးခြား code port တစ်ခုအဖြစ် မဆိုထားပါ။

### 🗜️ Context နှင့် token compression — engines

ပရောဂျက်	⭐	OmniRoute ကို လှုံ့ဆော်ပေးခဲ့ပုံ
Caveman	116,957	ဗိုင်းရပ်စ်သဖွယ် ပျံ့နှံ့ခဲ့သော "တိုကင်အနည်းငယ်နဲ့ ဘာကြောင့် များများသုံးမလဲ၊ အလုပ်ဖြစ်တယ်" ပရောဂျက် — ၎င်း၏ caveman စကားပြောအတွေးအခေါ်က ကျွန်ုပ်တို့၏ စံချုံ့မှုမုဒ်နှင့် filler/condensation စည်းမျဉ်း ၃၀ ကျော်ကို အားဖြည့်ပေးသည်။
RTK – Rust Token Killer	85,350	စွမ်းဆောင်ရည်မြင့် command-output ချုံ့မှု — ကျွန်ုပ်တို့၏ RTK engine၊ JSON filter DSL၊ raw-output recovery နှင့် အဆင့်ဆင့် RTK → Caveman pipeline ကို လှုံ့ဆော်ပေးခဲ့သည်။
headroom	78,672	ပြန်လည်ပြင်ဆင်နိုင်သော context-compression (SmartCrusher) — ကျွန်ုပ်တို့၏ `headroom` engine နှင့် `ccr` retrieve-marker ပုံစံကို လှုံ့ဆော်ပေးခဲ့သည်။
LLMLingua	6,797	Prompt-compression သုတေသန (LLMLingua / LLMLingua-2) — ကျွန်ုပ်တို့၏ asynchronous၊ code-safe၊ fail-open `llmlingua` engine ကို လှုံ့ဆော်ပေးခဲ့သည်။
llmlingua-2-js	33	ကျွန်ုပ်တို့၏ LLMLingua engine အတွက် worker-thread backend အဖြစ် အသုံးပြုသော JS/ONNX port (MobileBERT / XLM-RoBERTa) ဖြစ်သည်။
Troglodita	50	PT-BR တိုကင်ချုံ့မှု — ဘရာဇီးလ်ပေါ်တူဂီသဒ္ဒါအတွက် ချိန်ညှိထားသော pleonasm လျှော့ချမှုနှင့် filler ဖယ်ရှားမှုတို့ပါဝင်သည့် ကျွန်ုပ်တို့၏ pt-BR language pack ကို အားဖြည့်ပေးသည်။
ponytail	182,929	ဗိုင်းရပ်စ်သဖွယ် ပျံ့နှံ့ခဲ့သော "ပျင်းရိသည့် senior dev" YAGNI-coder skill — ကျွန်ုပ်တို့၏ less-code Output Style ကို လှုံ့ဆော်ပေးခဲ့သည်။ ၎င်းသည် Caveman ၏ တိုတောင်းသော prose ၏ output-axis အလားတူဖြစ်ပြီး၊ _ထုတ်လုပ်ထားသော_ code ကို လျှော့ချသည့် အလုပ်လုပ်နိုင်သော ပြောင်းလဲမှုအသေးဆုံးကို ဦးတည်စေသည်။
i-have-adhd	59,838	၎င်း၏ action-first၊ ADHD-friendly တုံ့ပြန်မှုပုံစံကို OmniRoute ၏ ဘာသာစကားငါးမျိုးအတွက် တိုတောင်းသော output style အဖြစ် ပြုပြင်အသုံးချထားသည်။

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

ပရောဂျက်	⭐	OmniRoute ကို လှုံ့ဆော်ပေးခဲ့ပုံ
TOON	25,602	Token-Oriented Object Notation — ၎င်း၏ columnar၊ header-plus-rows မော်ဒယ်က ကျွန်ုပ်တို့၏ tabular compaction အဆင့်ကို ပုံဖော်ပေးခဲ့သည်။
GCF – Graph Compact Format	61	၎င်း၏ compact graph format နှင့် generic-profile ဒီဇိုင်းက OmniRoute ၏ tabular compaction နှင့် Headroom codec format ကို အထောက်အကူပြုခဲ့သည်။
gcf-typescript	4	Headroom generic-profile codec အဖြစ် တိုက်ရိုက် vendored လုပ်ပြီး တိုးချဲ့ထားသော MIT TypeScript implementation ဖြစ်သည်။
token-optimizer-mcp	566	Brotli/SQLite cache နှင့် session တစ်ခုချင်းစီအလိုက် context-delta — ကျွန်ုပ်တို့၏ `session-dedup` engine ကို လှုံ့ဆော်ပေးခဲ့သည်။
token-savior	1,203	Bash-output compaction နှင့် MCP profiles — ကျွန်ုပ်တို့၏ compression bail-out စည်းကမ်းနှင့် MCP tool-manifest reduction ကို လှုံ့ဆော်ပေးခဲ့သည်။
token-saver	162	အကြောင်းအရာကို သိရှိနားလည်သော၊ file-type တစ်မျိုးချင်းစီအလိုက် output compression နှင့် failure-aware bail-out — ကျွန်ုပ်တို့၏ per-type dispatch နှင့် minimum-gain skip ကို အတည်ပြုပေးခဲ့သည်။
token-optimizer	2,853	"တစ္ဆေတိုကင်များကို ရှာဖွေပါ" — ၎င်း၏ offload နှင့် ပြန်လည်ရယူနိုင်သော handle ပုံစံက ကျွန်ုပ်တို့၏ CCR offload အတွေးအခေါ်ကို အထောက်အကူပြုခဲ့သည်။
TokenMizer	34	ကျွန်ုပ်တို့၏ session-dedup ဒီဇိုင်းကို အထောက်အကူပြုခဲ့သော session-graph နှင့် cross-turn line-dedup blueprint ဖြစ်သည်။
OmniCompress	3	Rust columnar-JSON၊ content-addressed retrieve နှင့် cross-message dedup — ကျွန်ုပ်တို့၏ `headroom`/`ccr`/`session-dedup` engine ဒီဇိုင်းနှင့် cache-stable "compressed form သည် position-independent ဖြစ်သည်" invariant ကို အတည်ပြုပေးခဲ့သည်။
mcp-compressor	140	MCP tool-schema/description compression — ကျွန်ုပ်တို့၏ MCP tool-manifest cardinality reduction ကို အထောက်အကူပြုခဲ့သည်။
RepoMapper	218	Aider-style repo-map ranking — ကျွန်ုပ်တို့၏ repo-map / retrieval-ranking စူးစမ်းလေ့လာမှုကို အထောက်အကူပြုခဲ့သည်။
quiet-shell-mcp	4	MCP ပေါ်ရှိ declarative shell-output reduction — ကျွန်ုပ်တို့၏ declarative bash-output compaction ကို အတည်ပြုပေးခဲ့သည်။
ts-morph	6,222	TypeScript Compiler API toolkit — string၊ template နှင့် regex literal များကို မထိခိုက်စေဘဲ comment ဖယ်ရှားသည့် parser-based နည်းလမ်းကို လှုံ့ဆော်ပေးခဲ့သည်။

### 🧠 မှတ်ဉာဏ်နှင့် RAG

ပရောဂျက်	⭐	OmniRoute ကို လှုံ့ဆော်ပေးခဲ့ပုံ
Mem0	68,294	အထွေထွေသုံး မမ်မိုရီအလွှာ — proxy ကို write/read နယ်နိမိတ်အဖြစ် အသုံးပြုသည့် မော်ဒယ်က ကျွန်ုပ်တို့၏ မမ်မိုရီဗိသုကာကို ပုံဖော်ပေးခဲ့သည်။
Letta (MemGPT)	25,321	အဆင့်ခွဲထားသော မမ်မိုရီပါဝင်သည့် stateful agent များ — ကျွန်ုပ်တို့၏ Context Control & Recovery (CCR) အဆင့်ခွဲမော်ဒယ်ကို လှုံ့ဆော်ပေးခဲ့သည်။
WFGY	1,804	ထပ်တလဲလဲ ဖြစ်ပေါ်သော RAG/LLM ချို့ယွင်းမှုအမျိုးအစား ၁၆ မျိုး၏ ProblemMap အမျိုးအစားခွဲစနစ် — ကျွန်ုပ်တို့၏ troubleshooting လမ်းညွှန်တွင် အသုံးပြုသည့် မျှဝေထားသော ဝေါဟာရစု။

### 🛰️ Traffic စစ်ဆေးခြင်း၊ MITM နှင့် transparent proxy

ပရောဂျက်	⭐	OmniRoute ကို လှုံ့ဆော်ပေးခဲ့ပုံ
llm-interceptor	81	coding-assistant ↔ LLM traffic ကို MITM ကြားဖြတ်စစ်ဆေးခြင်း/ခွဲခြမ်းစိတ်ဖြာခြင်းက အစောပိုင်း Traffic Inspector လိုအပ်ချက်များကို သတ်မှတ်ရာတွင် အထောက်အကူပြုခဲ့သည်။ ယခင်က ဆင်းသက်ဖော်ထုတ်ထားသော မော်ဂျူးလေးခု — SSE ပေါင်းစည်းခြင်း၊ conversation normalization၊ secret ဖုံးကွယ်ခြင်းနှင့် header သန့်စင်ခြင်း — ကို အများပြည်သူသုံး protocol စံနှုန်းများအပေါ် အခြေခံသည့် သီးခြား clean-room အကောင်အထည်ဖော်မှုများဖြင့် အစားထိုးပြီးဖြစ်သည်။ host-passthrough မျက်နှာပြင်နှစ်ခု (`passthrough.ts` နှင့် `_internal/bypass.cjs`) သည် OmniRoute အတွင်းပိုင်း သီးခြားအကောင်အထည်ဖော်မှုများအဖြစ် ဆက်လက်ရှိနေပြီး၊ ထိုအစားထိုးမှု၏ အစိတ်အပိုင်းအဖြစ် ပြန်လည်ရေးသားထားခြင်း မရှိပါ။
ProxyBridge	6,978	လုပ်ငန်းစဉ်တစ်ခုချင်းစီအလိုက် transparent proxy လမ်းကြောင်းသတ်မှတ်ခြင်း — ပျက်စီးမှုဒဏ်ခံနိုင်သော MITM ဖြုတ်ချခြင်း၊ socket idle-timeout များ၊ `/proc` လုပ်ငန်းစဉ် attribution နှင့် TPROXY capture တို့ကို လှုံ့ဆော်ပေးခဲ့သည်။

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

ပရောဂျက်	⭐	OmniRoute ကို လှုံ့ဆော်ပေးခဲ့ပုံ
models.dev	7,486	AI မော်ဒယ်သတ်မှတ်ချက်များ၊ ဈေးနှုန်းများနှင့် စွမ်းဆောင်ရည်များ၏ အများပြည်သူသုံး ဒေတာဘေ့စ် — ကျွန်ုပ်တို့၏ မော်ဒယ်ကတ်တလောက်ထဲသို့ မူရင်းအတိုင်း ထပ်တူပြုထားသည်။
React Flow / xyflow	38,874	ကျွန်ုပ်တို့၏ အချိန်နှင့်တစ်ပြေးညီ Compression Studio နှင့် Combo/Routing Studio တို့ကို အားဖြည့်ပေးသည့် node အခြေပြု graph library။
LangGraph	44,349	LangGraph Studio ၏ တိုက်ရိုက် workflow-graph မြင်ကွင်းက ကျွန်ုပ်တို့၏ Studios များရှိ အချိန်နှင့်တစ်ပြေးညီ cascade မြင်ကွင်းကို လှုံ့ဆော်ပေးခဲ့သည်။
Langfuse	36,907	၎င်း၏ trace → span → generation စောင့်ကြည့်နိုင်မှုမော်ဒယ်က ကျွန်ုပ်တို့၏ Compression Studio waterfall ကို ပုံဖော်ပေးခဲ့သည်။
Kiali	3,647	Istio service-mesh စောင့်ကြည့်နိုင်မှု — Routing/Combo Studio အတွင်းရှိ ကျွန်ုပ်တို့၏ circuit-breaker badge များနှင့် error-edge မြင်ကွင်းများကို လှုံ့ဆော်ပေးခဲ့သည်။
lobe-icons	2,666	ကျွန်ုပ်တို့၏ dashboard တစ်လျှောက် provider အိုင်ကွန်များအဖြစ် ဖော်ပြသည့် AI/LLM brand logo များ။
flag-icons	12,499	README language selector က အသုံးပြုသည့် MIT လိုင်စင်ရ SVG အလံများကို ပံ့ပိုးပေးသည်။

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

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

### 🧭 ဖြည့်စွက်ကိရိယာများ

ပရောဂျက်	⭐	OmniRoute ကို လှုံ့ဆော်ပေးခဲ့ပုံ
ClawRouter	6,649	request deduplication၊ အရေးပေါ် zero-cost fallback၊ ချိတ်ဆက်အသုံးပြုနိုင်သော Auto-Combo မဟာဗျူဟာများနှင့် ဘာသာစကားစုံ intent classification တို့ကို လှုံ့ဆော်ပေးခဲ့သည်။
Antigravity-Manager	32,785	၎င်း၏ account-aware မော်ဒယ်ပြန်လည်မြေပုံချခြင်း၊ executable-path အတည်ပြုခြင်းနှင့် plan-label အပြုအမူတို့က OmniRoute ၏ Antigravity runtime ကို လမ်းညွှန်ပေးခဲ့သည်။
vscode-antigravity-cockpit	4,852	၎င်း၏ ကျစ်လစ်သော quota-reset countdown ပုံစံက OmniRoute ရှိ သက်ဆိုင်ရာ provider-limit ဖော်ပြမှုကို လှုံ့ဆော်ပေးခဲ့သည်။
AionUi	33,996	၎င်း၏ ACP integration များက ထည့်သွင်းထားသော CLI agent များကို OmniRoute က အလိုအလျောက် ရှာဖွေတွေ့ရှိနိုင်ရန် လှုံ့ဆော်ပေးခဲ့သည်။
CodexBar	22,955	Grok Build quota မျက်နှာပြင်ကို ဖော်ထုတ်ပေးခဲ့သည်။ ထို့နောက် OmniRoute က live wire format ကို သီးခြားအတည်ပြုပြီး ပြင်ဆင်ခဲ့သည်။

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

**[⬆ အပေါ်သို့ ပြန်သွားရန်](#-omniroute)** · အဖွင့်အရင်းအမြစ် AI အသိုင်းအဝိုင်းအတွက် ❤️ ဖြင့် တည်ဆောက်ထားသည်။ _{Diego Souza မှ ဖန်တီးသည် · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT လိုင်စင် · omniroute.online}