# 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) · 🇲🇲 [my](../my/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) · 🇸🇰 [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 ද්වාරය **නිර්මාණය කළේ [Diego Souza](https://github.com/diegosouzapw)**

OmniRoute — කේතකරණය කිසිදා නවත්වන්න එපා. සෑම AI මෙවලමක්ම → එක් endpoint එකක් හරහා providers 388ක් — නොමිලේ 150කට වැඩි ප්රමාණයක්. Claude Code, Codex, Cursor, Cline, Copilot සහ Antigravity, ස්වයංක්රීය fallback සමඟ FREE Claude / GPT / Gemini වෙත. RTK + Caveman එකට ගොඩගැසූ සම්පීඩනය මඟින් tokens 15–95%ක් (~89% සාමාන්යයෙන්) ඉතිරි කරයි — සීමාවන්ට කිසිදා ළඟා නොවන්න. AI providers 388ක් · නොමිලේ tiers 150කට වැඩි ප්රමාණයක් · මසකට ~1.62B නොමිලේ tokens · routing strategies 20ක් · ආරම්භ කිරීමට $0.

## 💰 තෙවන පාර්ශ්ව නොමිලේ ස්ථර හරහා මසකට ~1.62B ටෝකන

> **ඔබේම provider ගිණුම් භාවිත කරන්න.** මෙය වෙන වෙනම සුදුසුකම් ලබන තෙවන පාර්ශ්ව නොමිලේ ස්ථරවල ඇස්තමේන්තුගත සමස්තයකි; OmniRoute වෙතින් ලැබෙන ටෝකන ප්රදානයක් නොවේ. ලියාපදිංචි වී, අවශ්ය නම් credentials ලබාගෙන, ඔබට භාවිත කළ හැකි providers සම්බන්ධ කරන්න; සෑම provider කෙනෙකුම තම සීමා, ලබාගත හැකි බව සහ නියමයන් පාලනය කරයි. > > නොමිලේ ස්ථර අතින් එකතු කිරීම අපහසුය — SDKs දුසිම් ගණනක්, rate limits දුසිම් ගණනක් සහ ඔබට සැබවින්ම කොපමණ ප්රමාණයක් තිබේද යන්න පිළිබඳ අදහසක් නැත. OmniRoute විසින් **නැවත නැවත භාවිත වන pool keys 34ක් හරහා නොමිලේ-ස්ථර entries 465ක්** ලේඛනගත කරයි. එමෙන්ම, **ප්රකාශිත ධනාත්මක මාසික budget එකක් ඇති pools 17කින් සහ එක් එක් model සඳහා වන Groq caps පහකින්** token headline එක ගණනය කරයි; shared pool මත පදනම්ව අනුපිටපත් ඉවත් කරයි. ප්රාදේශීය අනන්යතා පරීක්ෂාවකින් පසුව පමණක් විවෘත වන quotas (අද: ModelScope) වෙනම පෙන්වනු ලබන අතර, +~6M ප්රාදේශීය අනන්යතා සත්යාපනයට පිටුපසින් පවතින බැවින් headline එකට කිසිවිටෙක එකතු නොකරයි. ප්රතිඵලය dashboard හි (`/dashboard/free-tiers`) දිගටම දෘශ්යමාන වේ.

> සජීවී `/dashboard/free-tiers` පිටුවේ සජීවීකරණය කළ සාරාංශය. සම්පූර්ණ ක්රමවේදය (pool dedupe, credit tiers, provider terms): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{මෙම සංඛ්යා live catalog එකට සාපේක්ෂව සති දෙකකට වරක් නැවත විගණනය කරනු ලබන අතර **දෙපසටම වෙනස් වේ** — provider කෙනෙකු නොමිලේ ස්ථරයක් අවසන් කළහොත් සංඛ්යාව අඩුවෙයි; අලුත් එකක් එක් වූ විට එය ඉහළ යයි. අපි ප්රකාශ කරන්නේ 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) ### 💬 ප්රජාවට එක්වන්න **👋 maintainer අනුගමනය කරන්න — නව providers, releases සහ උපදෙස් පළමුව ලබාගන්න:** [![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 සහ සහාය → [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 | | 🧠 අනන්ය chat model IDs | 1320 | **1374** | 1491 | | 🖼️ මාදිලි සම්බන්ධකය | 🆕 දෘශ්ය + ශ්රව්ය + වීඩියෝ | ✓ | ✓ | | 📡 Radar නොමිලේ නාමාවලිය | 🆕 තෝරාගැනීමේ විකල්පය | ✓ | ✓ | | ⚖️ කෝටා-අනුවර්තී කාලසටහන්ගත කිරීම | 🆕 Quota-Share | ✓ | ✓ | | 📊 කෝටා ටෙලිමෙට්රි | 🆕 සජීවී | ✓ | ✓ | | 🧰 Headless මාදිලිය | — | — | 🆕 `serve --headless` | | 🛤️ LTS rail යටිතල පහසුකම් | — | — | 🆕 නිකුතු නාලිකා | | 🔎 ආකෘති සොයාගැනීමේ 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) [![බලපත්රය: 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
	🗜️ සම්පීඩනය	🖥️ එය ක්රියාත්මක වන ස්ථානය	🔒 පුද්ගලික
👀 එය බලන්න	🎬 ක්රියාකාරීව	✨ අලුත් දේ	🤖 අනුකූල CLIs
💚 සහාය	💚 සහාය / පරිත්යාග	💬 ප්රජාව	💖 අනුග්රාහකයන්
📦 ව්යාපෘතිය	🛠️ තාක්ෂණික තොගය	📖 ලේඛන	👥 දායකයන්

🌐 භාෂා 67කින්

## 🆓 ස්ථාපනය කර, provider එකක් සම්බන්ධ කර, පසුව එක් endpoint එකක් හරහා route කරන්න

පියවර තුනක්: OmniRoute ස්ථාපනය කර ආරම්භ කරන්න, ඔබේම ගිණුම හෝ API key භාවිතයෙන් සුදුසු provider එකක් සම්බන්ධ කරන්න, පසුව OmniRoute API key එකක් සහ model auto භාවිතයෙන් ඔබේ tool එක localhost:20128/v1 වෙත යොමු කරන්න. Routing ක්රියාවලිය පවතින සුදුසු සම්බන්ධතා සහ 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` සඳහා සුදුසු route එකක් අවශ්ය වේ. අලුතින් ස්ථාපනය කළ අවස්ථාවක සුදුසු keyless target කිසිවක් නොතිබිය හැකි අතර, keyless provider එකක් third-party clients ප්රතික්ෂේප කළ හැක. `tos: avoid` ලෙස සලකුණු කර ඇති providers, Kiro ඇතුළුව, පෙරනිමියෙන් automatic routing වෙතින් ඉවත් කර ඇත; ගිණුමක් සම්බන්ධ කිරීමෙන් එම සැකසුම වෙනස් නොවේ. provider එකක් තෝරා ගැනීමට පෙර [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) බලන්න.} _{📦 **Python, Node.js, PHP, සහ cURL** සඳහා copy-paste quickstart scripts → [`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 strategies 20ක්, circuit breakers, TLS stealth, MCP, A2A, guardrails) සුදුසු සහ සෞඛ්ය සම්පන්න target එකක් පවතින තාක් provider tiers 4ක් හරහා fallback විය හැක — Tier 1 Subscription, Tier 2 API Key, Tier 3 Cheap සහ Tier 4 Free.

## 🤝 අපගේ විවෘත මූලාශ්ර මිතුරන් විසින් සහය දක්වයි

> **විවෘත මූලාශ්ර මිතුරෙකු ලෙස සම්බන්ධ වීමට අවශ්යද?** මේවා විවෘත මූලාශ්රයට පිටුබලය දෙන සහ OmniRoute ඉදිරියට ගෙන යාමට උපකාර කරන සමාගම් වේ — ඔවුන් අපට ලබා දෙන සෑම ටෝකනයක්ම යන්නේ කොතැනටදැයි අපි ප්රසිද්ධියේ කියමු. සම්බන්ධ වන්න: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} මෙම ව්යාපෘතියට පිටුබලය දීම සඳහා අපගේ ආරම්භක විවෘත මූලාශ්ර මිතුරා වන Kimi (Moonshot AI) වෙත ස්තූතියි! Kimi යනු විවෘත-බර K2 සහ K3 මාදිලි පවුල් පිටුපස ඇති AI රසායනාගාරයයි — Kimi K3 1M-ටෝකන් සන්දර්භ කවුළුවක්, ස්වදේශීය දර්ශනයක් සහ දේශසීමා මට්ටමේ කේතීකරණයක් සංවෘත-මාදිලි මිල ගණන් වලින් කොටසකට ලබා දෙන අතර, Claude Code, Codex සහ OmniRoute සපයන සෑම කේතීකරණ මෙවලමක් සමඟම ක්රියා කරයි.

Kimi ගේ සහයෝගය බලගන්වන දේ: Kimi ගේ API ණය OmniRoute හි AI-සත්යාපිත නිකුත් කිරීමේ නල මාර්ගයට බලය සපයයි — නැව්ගත කිරීමට පෙර සෑම අදින්න ඉල්ලීමක්ම සමාලෝචනය කරන Kimi K3 විසින් බලගන්වන ලද ඒකාබද්ධ සත්යාපන අදියර — තවද දෛනික විශේෂාංග සංවර්ධනය. පළමු පන්තියේ Kimi සහයෝගය රේල් පීලි දෙකෙහිම නැව්ගත කරයි: සෘජු Kimi API (kimi-k3) සහ Kimi Code කේතීකරණ සැලැස්ම (OAuth සහ API යතුර). OmniRoute යනු Kimi ගේ සහයෝගය වැඩසටහනේ පළමු බ්රසීලියානු විවෘත මූලාශ්ර ව්යාපෘතිය ද වේ. 15% අමතර ණය සමඟ Kimi API යතුරක් ලබා ගන්න →

Cheaper Inference
_{cheaperinference.com} මෙම ව්යාපෘතියට පිටුබලය දීම සඳහා OmniRoute විවෘත මූලාශ්ර මිතුරෙකු වන Cheaper Inference වෙත ස්තූතියි! Cheaper Inference යනු Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok සහ MiniMax වැනි දේශසීමා මාදිලි 42ක් නැවත විකුණන පිරිවැය-ශ්රේණිගත ද්වාරයකි — එක් OpenAI-අනුකූල අවසාන ලක්ෂ්යයක් පිටුපස, එක් එක් ඉල්ලීම ලාභම සුදුසු සැපයුම්කරු වෙත යොමු කරමින් මාදිලි නිෂ්පාදකයාගේ ලැයිස්තු මිලට වඩා කිසි විටෙකත් අය නොකරයි.

OmniRoute හි පළමු පන්තියේ සහයෝගය: Chat Completions, ස්වදේශීය /v1/responses අවසාන ලක්ෂ්යය, දර්ශනය, මෙවලම් ඇමතීම සහ රූප මාදිලි 3ක් (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> ලෙස ළඟා විය හැක). API යතුරක් ලබා ගන්න →

_{aff=omniroute ලෙස ටැග් කර ඇති සබැඳි හවුල්කාර සබැඳි වේ. ඒවා ඔබට අමතර වියදමකින් තොරව ව්යාපෘතියට අරමුදල් සපයයි.}

_{🎟️ අනුබද්ධ ප්රවර්ධනය — අප අනුග්රහය නොදක්වන සැපයුම්කරුවන්ගෙන් නොමිලේ ලියාපදිංචි කූපන් පත් (පුළුල් කිරීමට ක්ලික් කරන්න)}

_{මෙම කොටස යොමු/කූපන් කේත සඳහා පමණි. අනුග්රාහක හවුල්කාරිත්වයන් ඉහත 🤝 අපගේ විවෘත මූලාශ්ර මිතුරන් විසින් සහය දක්වයි හි ඇත. OmniRoute හට මෙහි ලැයිස්තුගත කර ඇති සැපයුම්කරුවන් සමඟ කිසිදු අනුග්රාහකත්වයක් හෝ හවුල්කාරිත්වයක් නොමැත — මේවා ඕනෑම කෙනෙකුට භාවිතා කළ හැකි පොදු කූපන් පත් වේ.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — අනුබද්ධ ලියාපදිංචිය · ලියාපදිංචියේදී $100 නොමිලේ ණය (නොමිලේ සේවාදායකය, ඉහළ ප්රමාදයක් අපේක්ෂා කරන්න — පරීක්ෂා කිරීම සඳහා හොඳම, නිෂ්පාදනය සඳහා නොවේ). v3.8.50 සිට OmniRoute හි පළමු පන්තියේ සහයෝගය: Chat Completions, Anthropic-අනුකූල වයර් ආකෘතිය සහ OpenAI-අනුකූල මාර්ගය. පවතින මාදිලි අතර claude-opus-4-8, claude-opus-5, gpt-5.6-sol සහ තවත් බොහෝ දේ ඇතුළත් වේ. ඔබේ $100 ලබා ගන්න →}

_{⚠️ අනුබද්ධ සබැඳිය — OmniRoute හට මෙම සැපයුම්කරු සමඟ කිසිදු අනුග්රාහකත්වයක් හෝ හවුල්කාරිත්වයක් නොමැත.}

_{OmniRoute භාවිතා කරන්නන්ට ප්රතිලාභ ලබා දෙන ත්යාගශීලී නොමිලේ ලියාපදිංචි කූපනයක් සහිත තවත් සැපයුම්කරුවෙකු දන්නවාද? ගැටලුවක් විවෘත කරන්න, අපි එය මෙහි එක් කරන්නෙමු.}

## 🎯 Combos — ප්රමුඛතම විශේෂාංගය

combo මාර්ගගත කිරීමේ උපායමාර්ග 20න් 18ක් සඳහා සජීවීකරණය කළ උදාහරණ — එක් උපායමාර්ගයකට එක් ටයිලයක් බැගින්: 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ම විස්තර කර ඇත.

> **combo** එකක් යනු OmniRoute විසින් **ස්වයංක්රීයව** මාර්ගගත කරන මාදිලි දාමයකි. කෝටාව අවසන් වුවහොත්, සැපයුම්කරුවෙකු අසාර්ථක වුවහොත්, හෝ පිරිවැය ඉහළ ගියහොත්, combo එකට ඊළඟ සුදුසු සහ ක්රියාකාරී මාදිලිය වෙත මාරු විය හැක. 🛡️ ### ⚡ වින්යාස කිරීමක් අවශ්ය නැත — `auto` භාවිත කරන්න combo එකක් සෑදීමට අවශ්ය නැත. ඔබේ මාදිලිය `auto` (හෝ එහි ප්රභේදයක්) ලෙස සකසන්න, එවිට OmniRoute ඔබ සම්බන්ධ කර ඇති සැපයුම්කරුවන්ගෙන් සජීවීව ලකුණු කරන අතථ්ය combo එකක් ගොඩනඟයි:

මාදිලි ID	එය ප්රශස්ත කරන්නේ කුමක් සඳහාද
`auto`	🎯 සමබර පෙරනිමිය (LKGP — අවසන් වරට සාර්ථක වූ ඔබේ සැපයුම්කරු සමඟ දිගටම රැඳෙයි)
`auto/coding`	🧑💻 කේත ජනනය සඳහා ගුණාත්මකභාවයට ප්රමුඛත්වය දෙන බර තැබීම්
`auto/fast`	⚡ අඩුම ප්රමාදය පළමුව
`auto/cheap`	💰 ටෝකනයකට අඩුම මිල පළමුව
`auto/subscription`	🎟️ ඔබ දැනටමත් ගෙවන දායකත්ව කෝටාව පමණි — අසාර්ථක වූ විට වසා දමයි, කිසිවිටෙකත් ගාස්තු අය කරන විකල්පයකට මාරු නොවේ (මාර්ගෝපදේශය)
`auto/thrifty`	🪜 පළමුව සැලසුමේ කෝටාව, ඉන්පසු අඩුම මිල ගෙවුම් විකල්ප වෙත වරකට එක් පියවර බැගින් — සැලසුම යළි සැකසුණු පසු නැවත එයට පැමිණෙයි (මාර්ගෝපදේශය)
`auto/offline`	🔋 වැඩිම කෝටා / අනුපාත-සීමා අතිරික්තය පළමුව
`auto/smart`	🔭 ගුණාත්මකභාවයට ප්රමුඛත්වය + වඩා හොඳ මාදිලි සොයාගැනීමට 10%ක ගවේෂණයක්
`auto/lkgp`	📌 අවසන් වරට සාර්ථක වූ සැපයුම්කරු වෙත රැඳී සිටීම පැහැදිලිව නියම කරයි
`auto/chaos`	🧪 මාදිලි මණ්ඩලයක් වෙත සමාන්තරව ඉල්ලීම් යවයි (සැපයුම්කරුවෙකුට එක බැගින්, පෙරනිමියෙන් 5ක්), එක් පිළිතුරක් ලබා දෙයි; දෝෂ කෘත්රිමව ඇති කිරීමක් නොව, මණ්ඩලයේ එක් මාදිලියකට එක් upstream ඇමතුමකි

## ### 🔀 නැතහොත් ඔබේම එකක් සාදන්න — මාර්ගගත කිරීමේ උපායමාර්ග 20ක් **20**ම උපායමාර්ග — එක් එක් combo පියවර සඳහා කැමති ආකාරයට මිශ්ර කර ගළපන්න:

#	උපායමාර්ගය	එය කරන දේ
1	`priority`	පළමු ඉලක්කයට ප්රමුඛත්වය දෙන අනුපිළිවෙළ ලැයිස්තුව — ඊළඟට යාමට පෙර එක් එක් ඉලක්කය සම්පූර්ණයෙන් භාවිත කරයි 🥇
2	`fill-first`	ඊළඟට යාමට පෙර එක් එක් ඉලක්කයේ කෝටාව සම්පූර්ණයෙන් භාවිත කරයි
3	`weighted`	එක් එක් ඉලක්කයේ බර අනුව බරිත අහඹු තේරීමක් කරයි
4	`round-robin`	අනුපිළිවෙළින් ඉලක්ක හරහා චක්රීයව ගමන් කරයි
5	`p2c`	විකල්ප දෙකක බලය මත පදනම් වූ අහඹු භාර සමතුලිතකරණය
6	`least-used`	දැනට අඩුම භාරය ඇති ඉලක්කය තෝරයි
7	`random`	සමාන සම්භාවිතාවකින් අහඹු තේරීමක් කරයි (අනුපිටපත් ඉවත් කර ඇත)
8	`strict-random`	පුනරාවර්තන අනුපිටපත් ඉවත් නොකර අහඹු ලෙස තෝරයි 🎲
9	`cost-optimized`	සජීවී නාමාවලි මිලකරණය මත පදනම්ව ඉල්ලීමකට වැය වන $ අවම කරයි 💸
10	`headroom`	වැඩිම ඉතිරි කෝටාව ඇති ඉලක්කය තෝරයි
11	`quota-weighted`	අවසන් වූ ගිණුම් මඟ හැර, ඉතිරි කෝටාව ÷ ක්රියාත්මක භාරයට සමානුපාතිකව තෝරයි — පවතින සංවාද එකම ඉලක්කයට ස්ථාවරව තබයි ⚖️
12	`reset-window`	කෝටා කාල කවුළුව ඉක්මනින්ම යළි සැකසෙන ඉලක්කයට ප්රමුඛත්වය දෙයි
13	`reset-aware`	කෝටාව යළි සැකසෙන වේලාව අනුව ශ්රේණිගත කරයි — කෙටි කාල කවුළු පළමුව 📊
14	`context-relay`	දිගු සංවාද සඳහා ඉලක්ක අතර සන්දර්භය භාර දෙයි 🧠
15	`context-optimized`	වත්මන් සන්දර්භ ප්රමාණයට වඩාත් ගැළපෙන ඉලක්කය තෝරයි
16	`cache-optimized`	නැවත භාවිත කළ හැකි එක් එක් prompt උපසර්ගය එකම ගිණුමට ස්ථාවර කරයි — prompt-cache ගැළපීම් උපරිම කරයි 🎯
17	`lkgp`	අවසන් වරට සාර්ථක වූ මාර්ගය — අවසන් සාර්ථක සැපයුම්කරු වෙත ස්ථාවර කර, ඉන්පසු නීති මත පදනම් වූ විකල්ප වෙත මාරු වෙයි
18	`auto`	සෑම සම්බන්ධතාවක් පුරාම සාධක 16ක සජීවී ලකුණුකරණය 🤖
19	`fusion`	මාදිලි මණ්ඩලයක් වෙත ඉල්ලීම් යවා + විනිශ්චයකරුවෙකු එක් පිළිතුරක් සංස්ලේෂණය කරයි 🧬
20	`pipeline`	පියවර දාමගත කරයි — එක් එක් ඉලක්කයේ ප්රතිදානය ඊළඟ ඉලක්කයට ආදානය කරයි 🔗

_{Auto-Combo එන්ජිම සෑම අපේක්ෂකයෙකුම **සාධක 16ක්** (සෞඛ්යය, කෝටාව, පිරිවැය, ප්රමාදය, කාර්ය ගැළපීම, ගුණාත්මකභාවය, සැසි ලබාගත හැකි බව…) මත ලකුණු කරයි — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md) බලන්න.} ## ### 🧱 ඔරොත්තු දීමේ හැකියාව අන්තර්ගතව ඇත (ස්වාධීන ස්ථර 3ක්)

OmniRoute ඔරොත්තු දීමේ හැකියාව — ස්වාධීන ස්වයං-ප්රතිසාධන ස්ථර 3ක්, නිවැරදි අසාර්ථකත්වයට නිවැරදි ස්ථරය. ස්ථරය 1 සපයන්නාගේ පරිපථ බිඳිනය (සම්පූර්ණ සපයන්නා): 408/5xx මත පමණක් ක්රියාත්මක වේ, සීමා OAuth 8× / API-key 12× / local 2×, 60s/30s/15s කින් HALF-OPEN පරීක්ෂණයකට යළි සකසයි, අවශ්ය වූ විට ප්රතිසාධනය කරයි; OPEN තත්ත්වයේදී combo ඊළඟ සපයන්නා වෙත නැවත මාර්ගගත කරයි. ස්ථරය 2 සම්බන්ධතා විරාමය (එක් යතුරක්/ගිණුමක්): මූලිකව OAuth සඳහා 5s / API-key සඳහා 3s, එකවර ඉල්ලීම් ගොන්නක් ඇතිවීම වැළැක්වීමේ ආරක්ෂණයක් සමඟ ඝාතීය ×2 පසුබැසීම, 429 සඳහා Retry-After අගය පිළිපදියි, සාර්ථකත්වයකදී සියලු දෝෂ තත්ත්ව ඉවත් කරයි; එක් විරාමගත යතුරක් මඟහරින අතර අනෙකුත් යතුරු දිගටම සේවය සපයයි. ස්ථරය 3 ආකෘති අගුලු දැමීම (එක් ආකෘතියක්): එක් එක් ආකෘතියට අදාළ 429, local 404 හෝ ප්රකාර ප්රතික්ෂේප කිරීම් එම ආකෘතිය පමණක් අගුලු දමයි — කිසිවිටෙකත් සම්පූර්ණ සම්බන්ධතාව නොවේ. අවසාන තත්ත්ව (තහනම් කළ, කල් ඉකුත් වූ, බැර අවසන් වූ) ක්රියාකරු සඳහා වන අතර, විරාම සඳහා නොවේ.

_{📖 [Auto-Combo එන්ජිම](docs/routing/AUTO-COMBO.md) · [ඔරොත්තු දීමේ මාර්ගෝපදේශය](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 OmniRoute වෙනස් කරන්නේ කුමක්ද

_{📊 9router, OpenRouter, CLIProxyAPI සහ LiteLLM සමඟ සසඳන සම්පූර්ණ methodology සහ එක් එක් විශේෂාංගයේ විස්තර → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 OmniRoute සඳහා සහාය වන්න OmniRoute MIT බලපත්රය යටතේ පවතින අතර විවෘතව නඩත්තු කෙරේ. එය ඔබේ කාලය හෝ මුදල් ඉතිරි කරන්නේ නම්, එහි ස්වාධීනත්වය පවත්වා ගැනීමට ඔබට ගැළපෙන ඕනෑම ක්රමයක් තෝරාගන්න. අනුග්රාහකත්වය කිසිවිටෙකත් මාර්ගගත කිරීමේ ප්රමුඛතාවට බලපාන්නේ නැත; එය ලබා දෙන්නේ දෘශ්යතාව මිස ශ්රේණිගත කිරීමක් නොවේ.

⭐ Repo එකට Star එකක් දෙන්න	නොමිලේ — දෘශ්යතාව වැඩි කිරීමට සැබවින්ම උපකාරී වේ	OmniRoute වෙත Star එකක් දෙන්න
🐙 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 පිටපත් කර අලවන්න: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ ක්රිප්ටෝ — BTC · ETH · USDT-TRC20 · USDC-Solana (දිගහැරීමට ක්ලික් කරන්න)

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

_{⚠️ සෑම කාසියක්ම පෙන්වා ඇති ජාලය ඔස්සේ පමණක් යවන්න — වැරදි ජාලයක් ඔස්සේ යැවීමෙන් අරමුදල් අහිමි විය හැක.}

🐛 දෝෂයක් හමු වූවාද, නැතිනම් ප්රතිචාරයක් තිබේද? [Discussion](https://github.com/diegosouzapw/OmniRoute/discussions) එකක් විවෘත කරන්න.

සංවර්ධක සටහන්: සංවර්ධක පහසුව සඳහා ව්යාපෘතිය npm install/postinstall අතරතුර දේශීය .env ගොනුවක් ජනනය කළ හැක. මෙම ගොනුව හිතාමතාම .gitignore හරහා නොසලකා හරින අතර (.gitignore බලන්න) එය කිසිවිටෙකත් commit නොකළ යුතුය — එය අහම්බෙන් commit කළේ නම්, නිරාවරණය වූ රහස් සියල්ල වෙනස් කර ගොනුව ඉතිහාසයෙන් ඉවත් කරන්න. දේශීය environment ගොනු සහ රහස් කළමනාකරණය කිරීම පිළිබඳ මාර්ගෝපදේශ සඳහා docs/DEVELOPER-ENVIRONMENT.md බලන්න.

## 📡 OmniRoute Radar ඉහත ලේඛනගත කර ඇති, සංචිතය අනුව අනුපිටපත් ඉවත් කළ නාමාවලියෙන් ලැබෙන ප්රධාන නොමිලේ-ස්ථර අගය **මසකට ටෝකන ~1.62B** ලෙසම පවතී. තාවකාලික සැපයුම්කරු ලියාපදිංචි වීමේ බැර මඟින් පළමු මාසයේ අගය වෙනමම **~2.22B** දක්වා ඉහළ නැංවිය හැක. Radar යනු OmniRoute නිකුතු අතරතුර නොමිලේ මාදිලි පිළිබඳ වඩාත් නවතම ලබාගත හැකි තොරතුරු අවශ්ය අය සඳහා වන, විකල්ප සහ අත්සන් කළ නාමාවලි අතිරේකයකි; ප්රජා නාමාවලිය සහ දැනට පවතින සෑම නොමිලේ විශේෂාංගයක්ම නොමිලේම පවතී. සහායකයින්ට සජීවී නාමාවලිය සහ අතිරේක සැපයුම්කරු අවස්ථා ලබාගත හැක. එහි වෙනම, වෙනස් විය හැකි උපරිම සීමාව සැපයුම්කරුවන්ගේ ලබාගත හැකිභාවය මත පදනම්ව **උපරිම වශයෙන් මසකට ටෝකන බිලියන 3ක් පමණ** වේ. එම සීමාව සහතිකයක් නොවේ: සැපයුම්කරුවන්ට ඕනෑම වේලාවක කෝටා, සුදුසුකම්, මාදිලි හෝ කලාප වෙනස් කළ හැක. Radar භාවිතය තෝරාගත හැකි අතර එය GET සඳහා පමණි. OmniRoute සේවාලාභියා ප්රේරක, ගමනාගමනය, සැපයුම්කරු වින්යාසය, භාවිත දුරමිතිය හෝ දේශීය නිවේදන-ඉවතලීමේ තත්ත්වය උඩුගත නොකරයි. සුදුසුකම් සහ වත්මන් නාමාවලිය පිළිබඳව **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** වෙතින් දැනගන්න.

## ✨ අලුතින් එක් වූ දෑ

> **v3.8.20 → v3.8.54** අතර මෑතකාලීන ප්රධාන වෙනස්කම්. සම්පූර්ණ ඉතිහාසය [`CHANGELOG.md`](CHANGELOG.md) හි ඇත. - **⚖️ `quota-weighted` routing** — 20 වැනි combo උපායමාර්ගය quota අවසන් වූ ගිණුම් මඟහැර, ඉතිරි quota ÷ ක්රියාත්මක ඉල්ලීම් ප්රමාණයට සමානුපාතිකව ඉතිරි ගිණුම් අතරින් තෝරයි; පවතින සංවාද එම ගිණුම්වලටම බැඳී පවතී. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless mode** — `omniroute serve --headless` (හෝ `OMNIROUTE_HEADLESS=1`) මඟින් `/v1/*` proxy engine එක පමණක් ක්රියාත්මක කරයි; dashboard සහ dashboard-පමණක් වන උපපද්ධති අක්රිය කරයි. → [Headless Mode](docs/guides/HEADLESS.md) - **🔎 Model discovery** — `/v1/models` මඟින් capability, context, kind සහ text අනුව පෙරහන් කරයි; `POST /v1/models/query` මඟින් එක් එක් key සඳහා පවතින දෘශ්යතාවම භාවිත කරමින් කෙටි, නිශ්චිත shortlist එකක් ලබා දෙයි. → [API Reference](docs/reference/API_REFERENCE.md) - **🔑 Per-key routing control** — `forcedModel` සමඟ API key එකක් එක් model එකකට හෝ combo එකකට pin කරන්න; key එකක models සහ combos පරමාණුකව එක් කරන්න හෝ ඉවත් කරන්න (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ වඩාත් සියුම් PII controls** — වර්ගය අනුව තේරීම, වලංගු කළ custom masking patterns 20ක් දක්වා සහ වර්ගය අනුව detection counters; masking ස්වයංක්රීයව සක්රිය නොවී opt-in ලෙසම පවතී. → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 භාෂා 67ක්** — dashboard, docs mirrors සහ CLI සඳහා; `npm run i18n:add-locale` මඟින් එක් command එකකින් සෑම ස්ථානයකටම භාෂාවක් එක් කරයි. → [i18n Guide](docs/guides/I18N.md) - **🎛️ OmniConductor** — ඔබේ agent fleet වෙත inbound A2A delegation, Agent Card මත Conductor skills සහ Faro push-to-talk voice chat සහිත dashboard panel එකක්. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptive admission & overload protection** — විශාල chat requests 503 ලබාදීම වෙනුවට queue කෙරේ; එක් එක් connection එකකට atomic RPM rolling leases භාවිත වේ. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Canonical `/v1/models` ordering** — එක් provider එකකට එක් අඛණ්ඩ provider-grouped block එකක් (combos පළමුව pin කර ඇත); සෑම catalog source එකක් හරහාම ස්ථාවරව පවතී. → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Compression hardening** — පෙරනිමියෙන් සක්රිය inflation guard, DE / FR / JA සහ Chinese (wényán) සඳහා Caveman packs, Gradle සහ .NET සඳහා RTK filters. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 අවංක flat-rate පිරිවැය** — subscription / coding-plan providers පිරිවැය analytics තුළ **$0** ලෙස පෙන්වයි; budget, quota සහ routing තවදුරටත් ඇස්තමේන්තු කරයි. → [API Reference](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share routing** — pooled keys අතර shared account එකක quota සාධාරණව බෙදයි; idle slices ණයට ලබා දෙන බැවින් සම්පත් නිෂ්ක්රීයව නොපවතී. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 එක් command එකකින් CLI/agent සැකසුම** — ලියාපදිංචි `setup-*` commands 15ක්; `omniroute run` මඟින් CLIs 7ක් (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ආරම්භ කරයි; `omniroute configure` මඟින් interactive provider+model picker එකක් සහ එක් එක් context සඳහා favorites සමඟ targets 11කට සහාය දක්වයි. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Remote mode** — scoped tokens (`connect` / `contexts` / `tokens`) සමඟ දුරස්ථ OmniRoute එකක් පාලනය කරන්න; VPS installs සඳහා `antigravity` OAuth helper එකක්ද ඇත. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 වඩාත් බුද්ධිමත් auto-routing** — `auto/:` combos, **Fusion** (model panel + judge), task-aware routing, එක් එක් request සඳහා model / mode / USD-budget overrides. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Pluggable compression** — composable engines 12ක් සහ 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 env vars නොසලකා හරින CLIs capture කිරීම, එක් එක් SNI සඳහා CA සහ trust-store installer සමඟ. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 සෑම තැනකම Cost telemetry** — සෑම endpoint එකකම `X-OmniRoute-*` cost/usage headers, cache-HIT savings header සහ එක් එක් key සඳහා USD spend quotas. → [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) - **🛡️ Security** — සෑම LLM route එකකම prompt-injection guard (red-team suite), opt-in credential-masking guardrail (දිශා දෙකෙහිම කාන්දු වූ API keys/secrets redacts කරයි), අවසාන විකල්පයක් ලෙස නොමිලේ DuckDuckGo web search සහ dashboard සඳහා optional OIDC login gate එකක් (password login සෑමවිටම ලබාගත හැක). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ නව endpoints** — `/v1/ocr` (Mistral OCR) සහ `/v1/audio/translations` (Whisper-style) මඟින් media surface එක සම්පූර්ණ කරයි. → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 Image / video / audio generation** — media සඳහා එක් API එකක්: xAI Grok Imagine සහ Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind සහ ElevenLabs වැනි speech providers. → [API Reference](docs/reference/API_REFERENCE.md) - **🌍 Deployment & ops** — reverse-proxy `basePath`, browser-language auto-detect, එක් එක් key සඳහා device tracking, root-less MITM trust, zh-TW localization. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 තවත් providers සහ agents** — cloud agents (Codex Cloud, Cursor, Devin, Jules), browser + OAuth login සහිත Grok Build (xAI), පළමු පන්තියේ card එකක් ලෙස Ollama, Claude Opus 5 සහ Sonnet 5, Kimi official partnership (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… සහ යාවත්කාලීන කළ **388-provider catalog** එකක්. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Routing transparency** — සෑම response එකක්ම එය සේවය කළ strategy/provider/latency නම් කරන `X-OmniRoute-Decision` header එකක් රැගෙන එයි; නව `cache-optimized` combo strategy එක සහ Auto-Combo `cacheAffinity` factor එක මඟින් නැවත නැවත එන requests cached prefix එක රඳවාගෙන සිටින connection වෙත යොමු කරයි; read-only `/v1/auto-combo/{channel}/candidates` endpoint එකක් `auto/*` channel එකක සජීවී candidate pool එක හෙළි කරයි. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ දේශීය කාර්යසාධනය සහ යටිතල පහසුකම්** — එක් ක්ලික් කිරීමකින් දේශීය Redis, Cloudflare Workers / Deno Deploy relay deployers, අධීක්ෂණය යටතේ ක්රියාත්මක වන embedded services ලෙස Bifrost සහ Mux. → [Embedded Services](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 මෙහිම ඇතුළත්** — ප්ලගින framework එකක් සහ marketplace එකක්, Omni/Agent/GitHub skills frameworks, Obsidian vault ඒකාබද්ධකරණය (MCP tools 22ක්), OpenAI-compatible Batch & Files APIs, semantic response cache, leaderboards සහිත gamification, ACP agent discovery (built-in agents 15ක්), BigQuery වෙත නියමිත වේලාවට log export කිරීම, `auto/chaos` සමාන්තර multi-model fan-out, Telegram bot bridge එකක්, යෙදුම තුළම version manager එකක් සහ LMArena-ELO නොමිලේ සැපයුම්කරුවන්ගේ rankings. → [ලේඛන](docs/README.md)

## 🤖 අනුකූල CLI සහ කේතකරණ නියෝජිතයන් > එක් වින්යාසයක් — `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-අනුකූල මෙවලමක්

_{📖 සියලුම මෙවලම් 39 සඳහා පරිගණක අනුව සැකසුම (CLI කේත 28ක් + CLI නියෝජිතයන් 11ක්) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode ප්ලගිනය → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**ඕනෑම සහාය දක්වන CLI එකක් OmniRoute හරහා එකම විධානයකින් ආරම්භ කරන්න** — වින්යාස ගොනු ලියන්නේ නැත, අක්රිය පරිගණකයකට සත්යාපන තොරතුරු ඇතුළත් කරයි, Qwen/Gemini සඳහා තාවකාලික වෙන්කළ මුල්ගෙදරක්: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # නැතහොත් සැපයුම්කරු+ආදර්ශය අතුරින් තෝරා, මෙවලමේම වින්යාසය ලියන්න: omniroute configure codex # මෙයද: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` සෑම විධානයක්ම ක්රියාකාරී දුරස්ථ ප්රසංගය ගෞරවයෙන් පිළිපදියි (`omniroute connect `), `--dry-run` යනුයේ නිශ්චිත පරිසරය/තර්කයන් ක්රියාත්මක නොකර පෙරදසුනකි, සහ `--api-key-env NAME` මඟින් රහස් ඔබේ shell ඉතිහාසයෙන් වෙන් කරයි. → [CLI ඒකාබද්ධතා](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 AI සපයන්නන් 388ක් — නාමාවලි-සලකුණු කළ නොමිලේ සපයන්නන් 153ක්

> **ලියාපදිංචි කළ සපයන්නන් 388ක්** canonical chat, media, search, local, cloud-agent සහ system එකතු හරහා, **`hasFree: true` සොයාගැනීමේ metadata සහිත සපයන්නන් 153ක්** ඇතුළුව. Chat model registry එකේ **සපයන්නන් 239ක් / වෙනස් provider-model යුගල 3,059ක් / raw model IDs 1,475ක්** අඩංගු වේ; වෙනම free-budget catalog එකේ **එක් model එකකට පේළි 471ක්**, **නැවත නැවත ලැබෙන pools 34ක්** සහ **නැවත නැවත ලැබෙන/keyless සදාකාලික නොමිලේ සපයන්නන් 52ක්** ඇත. මේවා සැලසුම් සහගතව වෙනස් denominator වේ; අර්ථ දැක්වීම් සහ pool-deduped ගණනය කිරීම් [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) සහ [Free Tiers](docs/reference/FREE_TIERS.md) තුළ ඇත.

### 🏢 සියලුම ප්රධාන AI ආයතන — එක් 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 _{ස්වයංක්රීය රවුටරය, Tencent Hy3 සදහටම නොමිලේ}	Requesty _{GPT-OSS 120B, Nemotron සදහටම නොමිලේ}	SiliconFlow _{DeepSeek V3.2 / R1 නොමිලේ මට්ටම}	Z.AI GLM _{GLM-4.7 / 4.5-Flash සදහටම නොමිලේ}	Baidu ERNIE _{ERNIE 4.0 සදහටම නොමිලේ}
Qoder AI _{Qwen3-Max, Kimi-K2 සීමාවකින් තොරව නොමිලේ}	Pollinations _{GPT, Llama, Claude යතුරක් අවශ්ය නැත}	Cloudflare AI _{ආකෘති 50+ දිනකට නියුරෝන 10K}	NVIDIA NIM _{GLM, MiniMax නොමිලේ ~40 RPM}	Cerebras _{GLM 4.7, GPT-OSS එක්වරක් සඳහා $5 ණය; කාඩ්පත අවශ්යයි}	OpenRouter _{:free ආකෘති +$10 → ඉහළ RPM}

📖 සම්පූර්ණ යන්ත්ර-කියවිය හැකි නාමාවලිය → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ OmniRoute ධාවනය වන තැන - ඕනෑම තැනක

> එකම යෙදුම, ඔබේ යන්ත්‍රය, ඔබේ නීති. ගෝලීය npm ස්ථාපනයක සිට** ඔබගේ දුරකථනය** Termux හරහා. ස්ථාපනය කරයි ගොඩනැගීම තැටි — Windows / macOS / Linux bar (OmniRouteTray)macOS, 24/7, no වෙතින් ස්ථාපනය කළ හැකිය — stable & Insiders දායක වන්න

වේදිකාව	ස්ථාපනය කරන්න	ඉස්මතු කිරීම්
📦 npm (ගෝලීය)	`npm ස්ථාපනය -g omniroute`	එක් විධානයක්, ඕනෑම OS
⚡ Bun (ගෝලීය)	`bun add -g omniroute`	එකම රෙජිස්ට්‍රි ටාබෝල්, වේගවත්
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ ඩෙස්ක්ටොප්Electron)	`npm ධාවනය ඉලෙක්ට්‍රෝනය`	ස්වදේශීය කවුළුව +
🎩 Menu	`brew ස්ථාපනය --cask zoispag/tap/omniroute-tray`	අධීක්ෂණය & ස්වයංක්‍රීයව සේවාදායකය යාවත්කාලීන කරයි
💪 ARM	ස්වදේශීය `arm64`	Raspberry Pi, ARM සේවාදායකයන්, Apple Silicon
📱 Android (Termux)	`pkg ස්ථාපනය nodejs && npx -y omniroute`	ඔබේ දුරකථනයේ ධාවනය
📲 PWA	"මුල් තිරයට එක් කරන්න"	සම්පූර්ණ තිරය, නොබැඳි, බ්‍රව්සරය
🧩 OpenCode ප්ලගිනය	`@omniroute/opencode-provider`	ස්වදේශීය OpenCode ඒකාබද්ධ කිරීම
🤖 VS Code Copilot Chat	ස්ථාපනය OmniCopilot zql	ස්වදේශීය Copilot Chat picker හි ඇති සෑම OmniRoute
🛠️ මූලාශ්‍රයෙන්	`npm ස්ථාපනය කරන්න && npm ධාවනය කරන්න dev`	එය මත හැක් කරන්න,

_{📖 [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 කේතයේ ස්වදේශික Copilot කතාබස්

> නව පැති තීරුවක් නැත, නව කතාබස් UI නැත - සෑම මාදිලියක්ම OmniRoute සේවා සපයනු ලැබේ**Copilot Chat model picker ඔබ දැනටමත් භාවිතා කරයි** . VS කේතය 1.122 සිට, සපයන්නාගේ ආකෘති GitHub පුරනය වීමක් හෝ Copilot දායකත්වයක් නොමැතිව ක්‍රියා කරයි - නියෝජිත මාදිලිය, මෙවලම් ඇමතුම් සහ දැක්ම, නොමිලේ. ස්ථාපනය කරන්න** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** දිගුව, එය ඔබගේ OmniRoute සේවාදායකය වෙත යොමු කරන්න (පෙරනිමි `localhost:20128` වෙත ), ඉන්පසු Copilot Chat → මාදිලි පිකර් → විවෘත කරන්න** ආකෘති කළමනාකරණය කරන්න...** →**OmniRoute** . සමඟ ක්‍රියා කරයි < td පෙළගස්වන්න ="වමට">VS කේතය —& Insiders Kiro

Store	Link
🧩 VS Code Marketplace	ස්ථාපනය කරන්න →
🔓 විවෘත VSX රෙජිස්ට්‍රිය	ස්ථාපනය කරන්න →<>= වමට"CursorAntigravity

සංස්කාරකය ඇතුළත සිට: විවෘත කරන්න** දිගු** බලන්න, සොයන්න** "OmniRoute"** , ක්ලික් කරන්න** ස්ථාපනය කරන්න** - වෙළඳසැල් දෙකෙහිම එකම ආකාරයකින් ක්රියා කරයි. මූලාශ්‍රය, ගැටළු සහ ප්‍රකාශන ධාවන පොත සජීවීව [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Code Copilot Chat guide](docs/guides/VSCODE-COPILOT.md) — පිහිටුවීම, පිකර් පෙන්වන දේ, dashboard-in-a-tab, දෝශ නිරාකරණ}

### 🎩 නව: OmniRouteTray — ඔබේ දොරටුව, මෙනු තීරුවේ ජීවත් වේ

> `omniroute serve` එය සැමවිටම ක්‍රියාත්මක වන විට වඩාත් සතුටු වේ.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** එය macOS සඳහා set-and-Forget menu-bar යෙදුමක් බවට පත් කරයි: එය සේවාදායකය ආරම්භ කරයි, නැවත පණගැන්වීම් හරහා එය සජීවීව තබා ගනී, එය යාවත්කාලීන කරයි, සහ ඔබේ සජීවී ටෝකන් අයවැය එක ක්ලික් එකකින් තබන්න -** ටර්මිනල් කවුළුවක් විවෘතව නැත, බබා බලාගැනීමට `npm install -g omniroute` නැත.** [Tauri v2](https://v2.tauri.app/) (වටකුරු දෝෂයක ප්‍රමාණයේ රස්ට් හරයක්) සමඟින් ගොඩනගා ඇති එය එහිම අත්සන් කරන ලද Node 24 ධාවන කාලය නැව්ගත කරන අතර යෙදුම සතු OmniRoute ස්ථාපනයක් කළමනාකරණය කරයි, එබැවින් එය කිසි විටෙකත් ඔබේ ගෝලීය `node`/`bun` සමඟ සටන් නොකරයි. එය** ඔබගේ පවතින `~/.omniroute/` වින්‍යාසය සහ දත්ත සමුදාය බෙදා ගනී** — එබැවින් ඔබ දැනටමත් තොප්පියක් දමාගෙන ධාවනය කර ඇති OmniRoute එයම වේ. 🎩 අනුපිටපත් කිරීම වෙනුවට දැනටමත් ධාවනය වන අවස්ථාවක් අනුගමනය කරයි

එය කරන්නේ කුමක්ද	කෙසේද
🟢 සේවාදායකය අධීක්‍ෂණය කරයි	Spawns `omniroute serve` , එය
📊 බැලූ බැල්මට සජීවී භාවිතය	සපයන්නාගේ කෝටා තීරු, යළි පිහිටුවීමේ ගණන් කිරීම් සමඟ Claude session/weekly සීමාවන්, දින 30 පිරිවැය බිඳ වැටීම
🔄 ස්ථානයේ ස්වයං-යාවත්කාලීන කිරීම්	අදියර ස්ථාපනය, පරමාණු හුවමාරුව, අසාර්ථක වූ විට ආපසු හැරීම - සෑම විටම නවතම නිකුතුවේ
🚀 පුරනය වීමේදී ආරම්භ කරන්න	ලොගින් වීමේදී විකල්ප දියත් කිරීම; tray-only, no dock icon
🩺 Doctor & logs	එක්-ක්ලික් රෝග විනිශ්චය සහ සේවාදායක ලොග් ප්‍රවේශය

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{බාගත කිරීමට කැමතිද? නවතම .dmg ලබා ගන්න
නිකුත් කරයි. මූලාශ්රය, ගැටළු සහ ගොඩනැගීම
docs zoispag/omniroute-tray හි ජීවත් වේ.

💛 @zoispag විසින් ප්‍රජා ව්‍යාපෘතියක් — නිල OmniRoute නිකුතුවක් නොවේ.}

## 🔒 පුද්ගලිකත්වය සුරකින සහ දේශීයත්වයට ප්රමුඛත්වය දෙන

_{📖 [අවසරකරණය](docs/architecture/AUTHZ_GUIDE.md) · [ආරක්ෂක සීමා](docs/security/GUARDRAILS.md) · [අනුකූලතාව](docs/security/COMPLIANCE.md)}

## 🔌 සම්පූර්ණ CLI + A2A සහ MCP

> සේවාදායකයට අමතරව, OmniRoute යනු **විධාන 80කට වැඩි ගණනක්** සහිත **සම්පූර්ණ විධාන පේළි පාලක මැදිරියක්** වන අතර, AI නියෝජිතයෙකුට එය **ස්වයංක්රීයව** පාලනය කිරීමට හැකි විවෘත නියෝජිත ප්රොටෝකෝල ද සපයයි. ### ⌨️ සැබෑ CLI එකක් (`start` පමණක් නොවේ) ```bash omniroute # gateway + dashboard සපයයි (port 20128) omniroute chat # අන්තර්ක්රියාකාරී TUI කතාබස් සේවාලාභියා (slash: /model /combo /skill /memory) omniroute setup # මඟපෙන්වන පළමු ධාවන විශාරදය omniroute doctor # providers, ports, native deps විනිශ්චය කරයි ``` ### 🛰️ දුරස්ථ ප්රකාරය — CLI එක මෙහි ධාවනය කර, OmniRoute VPS එකක ධාවනය කරන්න OmniRoute සේවාදායකයක තිබේද? **එම CLI එකෙන්ම** ඔබේ ලැප්ටොප් පරිගණකයෙන් එය පාලනය කරන්න. විෂයපථගත ප්රවේශ ටෝකනයක් සමඟ එක් වරක් පිවිසෙන්න; ඉන්පසු සෑම විධානයක්ම දුරස්ථ සේවාදායකය ඉලක්ක කරයි. ```bash omniroute connect 192.168.0.15 # මුරපදය → විෂයපථගත ටෝකනය, context එකක් ලෙස සුරකියි omniroute models # ← දුරස්ථ සේවාදායකයට එරෙහිව ධාවනය වේ omniroute configure codex # ← දුරස්ථ model එකක් තෝරා, දේශීය Codex profile එකක් ලියයි omniroute tokens create --name ci --scope read # වෙනත් යන්ත්ර සඳහා වඩා සීමිත ටෝකන නිකුත් කරයි omniroute contexts use default # ← නැවත දේශීය සේවාදායකයට මාරු වේ ``` ටෝකන `read` / `write` / `admin` ලෙස විෂයපථගත කර ඇත; ක්රියාවලි ආරම්භ කරන මාර්ග loopback සඳහා පමණක් සීමා වේ. _{📖 [දුරස්ථ ප්රකාරය](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI එක නිරූපණය කරන සජීවී terminal ආදර්ශනය — omniroute providers list, omniroute combo list සහ omniroute health — විධාන 89ක ඉහළ මට්ටමේ පරාසය හරහා මාරුවෙමින්: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 නියෝජිතයෙකු සම්බන්ධ කරන්න — එවිට එය OmniRoute ස්වයංක්රීයව පාලනය කරයි OmniRoute **MCP**, **A2A**, **REST API**, **webhooks** හෝ **දුරස්ථ CLI** එකක් හරහා නිරාවරණය කරන්න — හැකියාව ඇති ඕනෑම නියෝජිතයෙකුට (හෝ ඔබේම කේතයට) සම්පූර්ණ gateway එකේ යතුරු ලැබේ: routing, providers, combos, cache, compression, memory — ස්වයංක්රීයව. පහත HTTP endpoints `http://localhost:20128` යටතේ සපයනු ලැබේ.

අතුරුමුහුණත	Endpoint / විධානය	භාවිතය
🧰 MCP (stdio)	`omniroute --mcp`	Claude Desktop, Cursor හෝ ඕනෑම MCP සේවාලාභියෙකුට සම්බන්ධ කරන්න
🌊 MCP (HTTP)	`/api/mcp/stream`	දුරස්ථ MCP — මෙවලම් 110ක්, විෂයපථ 33ක් (බලාත්මක කිරීම තේරීමෙන් සක්රිය කළ යුතුය), සම්පූර්ණ විගණන සටහන
📡 MCP (SSE)	`/api/mcp/sse`	ප්රවාහ MCP ප්රවාහනය
🤝 A2A	`/.well-known/agent.json`	නියෝජිතයාගෙන් නියෝජිතයාට, JSON-RPC 2.0 + SSE, කුසලතා 6ක්
🌐 REST API	`/v1/*`	OpenAI-අනුකූලයි — කතාබස්, embeddings, රූප, ශ්රව්ය, OCR
🔔 Webhooks	`/api/webhooks`	ඉල්ලීම් / quota සිදුවීම් Slack, Discord, Telegram හෝ ඕනෑම URL එකකට යවන්න
🛰️ දුරස්ථ CLI	`omniroute connect`	විෂයපථගත ප්රවේශ ටෝකන සමඟ දුරස්ථ instance එකක් පාලනය කරන්න

```bash # MCP හරහා Claude Code වෙත සම්පූර්ණ OmniRoute මෙවලම් කට්ටලය ලබා දෙන්න: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP සේවාදායකය](docs/frameworks/MCP-SERVER.md) · [A2A සේවාදායකය](docs/frameworks/A2A-SERVER.md) · [නියෝජිත ප්රොටෝකෝල](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ ටෝකන 15–95% ඉතිරි කරන්න — ස්වයංක්රීයව

### 📖 මෙය ක්රියා කරන ආකාරය — pipeline, architecture සහ ඉතිරි කිරීම් ගණිතය

OmniRoute compression pipeline: සංරචක කළ හැකි එන්ජින් 12ක් හරහා ගමන් කරන 10,000-token client request එකක් — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra සහ OmniGlyph — ලේඛනගත stacked උදාහරණයේදී ටෝකන 1,080ක් පමණ දක්වා අඩු වී provider වෙත ළඟා විය හැක. සංරචිත අන්තර්ගතය preservation guards සහ එක් එක් පියවරේ fidelity gates මඟින් ආරක්ෂා කරයි; පැහැදිලිව lossy හෝ experimental modes මඟින් සුදුසු අන්තර්ගතය පරිවර්තනය කළ හැක.

පෙරනිමි 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 එක අනුව මිශ්ර කර තෝරාගත හැකි **සංරචක කළ හැකි එන්ජින් 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) වෙතින් ලැබුණු අදහස් මත ගොඩනගා ඇත. ### 🧱 එන්ජින් 12ක stack එක එන්ජින් pipeline අනුපිළිවෙළට ක්රියා කරයි; සෑම එකක්ම වෙන වෙනම සක්රිය/අක්රිය කළ හැකි අතර එක් එක් combo එක සඳහා වින්යාස කළ හැක:

#	Engine	එය කරන දේ
1	Session-Dedup	turns අතර නැවත නැවත දිස්වන අන්තර්ගතය ඉවත් කරයි (content-addressed, cross-turn)
2	CCR	විශාල blocks retrieve markers පිටුපස archive කර, අවශ්ය වූ විට ලබාගනී
3	Lite	Whitespace + image-URL trimming (latency-light baseline)
4	RTK	Smart tool-result filtering, dedup සහ truncation (command-aware)
5	Responses Tool Output	shell/patch/search/build outputs සඳහා lossless-first JSON + සීමා කළ diagnostic compression (Responses API)
6	Headroom	vendored GCF codec එකක් හරහා JSON arrays හි lossless tabular compaction (~30%)
7	Relevance	අවසන් user query එකට සාපේක්ෂව extractive sentence scoring
8	Caveman	Rule-based prose compression (output මත ~65–75%)
9	Aggressive	පැරණි turns සඳහා 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 සඳහා experimental context-as-image encoding; provider receipts ලැබෙන තෙක් GPT 5.6 transformers fail-closed වේ. compression profiles හතරක් (aggressive default, balanced, coding-safe, passthrough) (වඩාත් aggressive; opt-in)

Code blocks, URLs සහ structured data **සෑම විටම byte-perfect ලෙස සංරක්ෂණය කෙරේ**. **One-click presets** මඟින් එන්ජින් ඒකාබද්ධ කරයි:

Mode	ඉතිරි කිරීම්	වඩාත් සුදුසු
🪶 Lite	~15%	සෑම විටම ක්රියාත්මක ආරක්ෂිත පෙරනිමිය
🪨 Standard (Caveman)	~30%	දෛනික coding
⚡ Aggressive	~50%	දිගු tool-heavy sessions
🔥 Ultra	~75%	උපරිම ඉතිරි කිරීම්
🧰 RTK	60–90%	Shell/test/build/git output
🔗 Stacked (RTK → Caveman)	78–95%	මිශ්ර prompts + tool logs

**සැබෑ උදාහරණය — Standard mode:** > **පෙර (ටෝකන 69):** _"ඔබේ React component එක නැවත render වීමට හේතුව, එක් එක් render cycle එකේදී ඔබ නව object reference එකක් නිර්මාණය කිරීම විය හැක. Inline object එකක් prop එකක් ලෙස යවන විට, React හි shallow comparison එක සෑම අවස්ථාවකම එය වෙනස් object එකක් ලෙස දකින අතර, එමඟින් නැවත render වීමක් සිදු වේ. Object එක memoize කිරීමට useMemo භාවිත කරන ලෙස මම නිර්දේශ කරමි."_ > > **පසු (ටෝකන 19):** _"සෑම render එකකදීම නව object ref එකක්. Inline object prop = නව ref = නැවත render. useMemo තුළ wrap කරන්න."_ > > **එකම පිළිතුර. ටෝකන 72%කින් අඩුයි. නිරවද්යතාවේ කිසිදු අලාභයක් නැත.** ✅ **PT-BR උදාහරණය — [Troglodita](https://github.com/leninejunior/troglodita) mode:** > **පෙර (42 tokens):** _"සෑම render චක්රයකදීම නව object reference එකක් නිර්මාණය වන නිසා component එක නැවත render වීමයි ගැටලුව. `useMemo` භාවිත කිරීම මම නිර්දේශ කරමි."_ > > **පසු (12 tokens):** _"Re-render: සෑම චක්රයකදීම නව ref එකක් (inline object නැවත නිර්මාණය වේ). `useMemo` භාවිත කරන්න."_ > > **එකම පිළිතුර. ~70% අඩු tokens. තාක්ෂණික නිරවද්යතාව නොවෙනස්ව.** ✅
### 🎚️ එන්ජින්වලින් ඔබ්බට — output styles, අනුවර්තන dial එක සහ එක් ඉල්ලීමකට පාලනය ඉහත එන්ජින් 12, ඇතුළට යන දේ හැකිළවයි. තවත් ස්ථර තුනක් පිටතට එන දේ **කෙසේද**, **කවදාද**, සහ කුමක්ද යන්න හැඩගස්වයි: - **🪄 Output Styles** _(output-axis steering)_ — නිශ්චිත, cache-safe ප්රතිචාර-හැඩගැස්වීමේ උපදෙස් ඇතුළත් කරයි; එකට භාවිත කළ හැකි අතර, සෑම එකක්ම `lite` / `full` / `ultra` තීව්රතා මට්ටම්වලින් ලබා ගත හැක. Style එකක් එක් කිරීම එක් පේළියක registry entry එකකි: - **Terse prose** — පිරවුම් වචන / articles / අවිනිශ්චිතතා ඉවත් කරයි; තාක්ෂණික අන්තර්ගතයේ නිරවද්යතාව රඳවා ගනී. - **Less code** — "lazy senior dev" YAGNI: ක්රියාත්මක වන කුඩාම වෙනස, ඉල්ලා නොසිටි scaffolding නොමැත. - **Ponytail (lazy senior dev)** — YAGNI පියවරෙන් පියවර ඉදිරියට ගොස්, මූලික හේතුව විසඳා, ක්රියාත්මක වන කුඩාම diff එක ලබා දෙයි. - **I have ADHD (action-first)** — ඊළඟ ක්රියාව මුලින් ඉදිරිපත් කරයි, පියවර අංකනය කරයි, එක් නිශ්චිත ඊළඟ පියවරක් ලබා දෙයි, preamble නොමැත. - **Terse CJK (文言)** — සම්භාව්ය-චීන අතිශය සංක්ෂිප්ත ශෛලිය (`zh` වෙත locale-gated). - **🎯 Adaptive context-budget** _(dial එක)_ — එක් on/off token සීමාවක් වෙනුවට, model එකේ context window එකට ගැළපෙන තෙක් අවශ්ය ප්රමාණයට පමණක්, අඩුම වියදම් සහිත හා අඩුම තොරතුරු-අලාභයක් ඇති engines උසස් කරයි. ප්රතිපත්තිය: `reserve-output` (පෙරනිමිය, model-aware) · `percentage` · `absolute`. Mode එක: `floor` (ගැළපීම සහතික කරයි) · `replace-autotrigger` (ඔබේ පැහැදිලි තේරීම ජය ගනී) · `off` (පැරණි threshold). - **🎛️ Where compression is decided** _(precedence, high → low)_ — එක්-ඉල්ලීමකට `x-omniroute-compression` header › routing-combo override › සක්රිය named profile › adaptive / auto-trigger › panel default › off. යෙදූ plan එක `X-OmniRoute-Compression: ; source=` response header එක තුළ නැවත ලබා දෙයි. Token threshold එක මත auto-trigger කරන්න, adaptive dial එක සක්රිය කරන්න, named profile එකක් pin කරන්න, එක් ඉල්ලීමකට එක් වරක් සැකසුමක් යොදන්න, නැතහොත් එක් එක් routing combo එකකට pipeline එකක් පවරන්න — workload එකට ගැළපෙන ඕනෑම ක්රමයක් භාවිත කරන්න. වෙනසක් promote කිරීමට පෙර, opt-in offline **eval harness** (`npm run eval:compression`) මඟින් pin කළ 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) ස්ථාපනය කර ධාවනය කරන්න** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` හෝ peer-dep warnings පෙනෙනවාද? [ඒවා හානිකර නොවේ](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **npm 11 හෝ ඊට පසු version එකක් භාවිත කරනවාද?** ඒවාට අවසර දී නොමැති නම් npm package lifecycle scripts අවහිර කළ හැක. OmniRoute හි `postinstall` (`node scripts/build/postinstall.mjs`) එහි native runtime files සූදානම් කිරීමට අවශ්ය වේ. globally ස්ථාපනය කරන විට npm warning එකේ නම් කර ඇති packages වලට අවසර දෙන්න. OmniRoute 3.8.54 මඟින් වාර්තා කරන package set එක සඳහා: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > අනාගත global installs සඳහා මෙම 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 > ``` > > Releases අතර dependency list එක වෙනස් විය හැක; npm වෙනස් list එකක් වාර්තා කළහොත්, එම warning එකේ ඇති package names භාවිත කරන්න. Package එකකට අවසර දීමෙන් එහි install scripts ධාවනය කිරීමට ඉඩ ලැබේ. > **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) ඔබේම ගිණුම භාවිත කර සුදුසු provider එකක් සම්බන්ධ කරන්න** Dashboard → **Providers** → ඔබේ භාවිත අවශ්යතාවට ගැළපෙන වත්මන් terms සහ quota සහිත provider එකක් තෝරන්න → එහි API key එක එක් කරන්න හෝ account flow එක සම්පූර්ණ කරන්න. Free tiers සඳහා signup, approval හෝ payment method එකක් අවශ්ය විය හැක. [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md) සමාලෝචනය කරන්න; keyless availability සහතික නොවේ, සහ `tos: avoid` ලෙස සලකුණු කළ providers පෙරනිමියෙන් `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" ``` ඔබට සම්බන්ධ කළ models ලැයිස්තුගත වී ඇති බව පෙනෙනු ඇත. 🎉 එපමණයි — coding ආරම්භ කරන්න, OmniRoute ඔබ වෙනුවෙන් ස්වයංක්රීයව 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 ...` එක් කළ නොහැකි clients සඳහා පමණි. 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 agents** (Claude Code, Codex, Grok, … වෙතින් `POST /v1/responses`) සඳහා වඩා විශාල V8 heap එකක් අවශ්ය වේ; එසේ නොමැතිව දිගු contexts දෙකක් එකිනෙක අතිච්ඡාදනය වන විට ~12 GiB දී process එක `FATAL ERROR` සමඟ අසාර්ථක වේ. Container එක heap එකට වඩා විශාල ලෙස සකසන්න (native buffers 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 එක අනුගමනය කරයි. මෙම වෙනස් කළ හැකි tags නිකුත් නොකළ නිවැරදි කිරීම් පරීක්ෂා කිරීම සඳහා පමණක් අදහස් කර ඇති අතර > ඒවා **production සඳහා සහය නොදක්වයි**. බලන්න: > [Docker නිකුතු නාලිකා](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Bun runtime හඳුනාගැනීම හරහා සම්මත `bun install` සහ global ස්ථාපනය (`bun install -g omniroute`) සඳහා සහය දක්වයි: - **අන්තර්ගත `bun:sqlite`**: Bun යටතේ ක්රියාත්මක වන විට OmniRoute විසින් Bun හි අන්තර්ගත `bun:sqlite` driver එක භාවිත කරන අතර, Node.js මතදී `better-sqlite3` හෝ `sql.js` වෙත යොමු වේ. - **dev හි ස්වයංක්රීය Webpack bundler තේරීම**: Development (`bun run dev`) විසින් Bun ස්වයංක්රීයව හඳුනාගෙන native V8 binding නොගැළපීම් වැළැක්වීම සඳහා Turbopack අක්රිය කර Webpack භාවිත කරයි. Production builds (`bun run build`) Node මත මෙන්ම `OMNIROUTE_USE_TURBOPACK` නිශ්චිතවම අනුගමනය කරයි: පෙරනිමියෙන් Turbopack ද, Webpack සමඟ build කිරීමට `OMNIROUTE_USE_TURBOPACK=0` ද භාවිත වේ (`Dockerfile.bun` එය `--build-arg` එකක් ලෙස නිරාවරණය කරයි). - **කැපවූ Bun Dockerfile**: Native Bun production deployments සඳහා බහු-අදියර `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 flakes භාවිතයෙන් nix develop npm run dev # නැතහොත් devbox භාවිතයෙන් devbox run npm run dev ``` 📖 [Docker මාර්ගෝපදේශය](docs/guides/DOCKER_GUIDE.md) — Compose profiles, Caddy HTTPS, Cloudflare tunnels. **🦭 Podman** ```bash # 1. Bind-mount කළ data directory එක සූදානම් කරන්න mkdir -p data # 2. Linux + දේශීය rootless Podman සඳහා පමණි (remote Podman Machine client එකක් සඳහා කිසිවිටෙකත් නොවේ): podman unshare chown 1000:1000 ./data # 3. Runtime hint එක සකසා, දේශීය 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 builds, Podman Machine, සහ Linux/systemd Quadlet සැකසුම. **⚡ වේගවත් / සැහැල්ලු ස්ථාපනයක් (native build එක මඟහරින්න)** Native SQLite engine එක (`better-sqlite3`) **විකල්ප** dependency එකක් වන බැවින්, global ස්ථාපනයක් source වෙතින් compile කිරීම නිසා කිසිවිටෙකත් අවහිර නොවේ: ඔබගේ platform/Node සමඟ ගැළපෙන විට එය පෙර-build කළ binary එකක් භාවිත කරන අතර, එසේ නොමැති නම් පිරිසිදු-JS engine එකකට විනිවිද පෙනෙන ලෙස යොමු වේ (Node 22+ මත `node:sqlite`, නැතිනම් bundle කළ `sql.js` WASM) — build tools අවශ්ය නොවේ. ස්ථාපනයෙන් පසු සිදු වන native warm-up එක සම්පූර්ණයෙන්ම මඟහැරීමට (CI, headless, හෝ මන්දගාමී යන්ත්ර): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 ද එය මඟහරියි ``` වේගවත්ම ස්ථාපන සඳහා **pnpm** වඩාත් සුදුසුය (content-addressed store + hard links — ඉහත බලන්න). 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}

**සම්පූර්ණ ශ්රේණිගත කිරීම (අනුපිටපත් ඉවත් කළ කැනොනිකල් URLs, `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 දින කැනොනිකල් ප්රමිතික: **අද්විතීය වීඩියෝ 1.976ක්** · **දන්නා නැරඹීම් 20.220.289ක්** (`v > 0`) · **ජාලය අනුව නාලිකා/පැතිකඩ 1.210ක්**. අමු උපකරණ පුවරුවේ පේළි 1.976ක් ඇත (YouTube 1.352 = දිගු වීඩියෝ 740 + Shorts 612 · TikTok 334 · Instagram 290); එක් වීඩියෝවකට ඉහළම ගණන රඳවා ගන්නා කැනොනිකල් URL අනුව සාමාන්යකරණය කිරීමෙන් පසු කිසිදු අනුපිටපතක් ඉතිරි නොවීය. YouTube දත්ත රැස් කිරීම 2026-10-13 දින සිට අත්හිටුවා ඇත (14 සිට 18/10 දක්වා API කෝටාව අවසන් වී ඇත), එමෙන්ම TikTok/Instagram දත්ත රැස් කිරීම 2026-09-02 සිට අත්හිටුවා ඇත (දත්ත රැස් කිරීමේ ණය නොමැති බැවින්); වීඩියෝ 76කට තවමත් නැරඹීම් ගණනක් නොමැත. > 🎬 **OmniRoute ගැන වීඩියෝවක් සෑදුවාද?** සබැඳිය සමඟ [ගැටලුවක්](https://github.com/diegosouzapw/OmniRoute/issues/new) හෝ [සාකච්ඡාවක්](https://github.com/diegosouzapw/OmniRoute/discussions) විවෘත කරන්න — අපි එය මෙහි විශේෂයෙන් පෙන්වන්නෙමු.

# 📧 ප්රජාව සහ උදව් > සියල්ල එකම ස්ථානයක — නඩත්තුකරු අනුගමනය කරන්න, ප්රජාව සමඟ කතාබස් කරන්න, නැතහොත් ගැටලුවක් විවෘත කරන්න. | නාලිකාව | කොතැනද / කෙසේද | | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------- | | 💼 **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 අනුග්රාහකයෝ](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/` පුරා 100% TypeScript (v2.0 සිට core තුළ `any` ශුන්යයි)
රාමුව	Next.js 16 + React 19 + Tailwind CSS 4
දත්ත සමුදාය	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — domain මොඩියුල 147ක්, migrations 233ක්
මතකය	SQLite FTS5 පූර්ණ-පාඨ + int8-quantized vector embeddings, වර්ගීකරණය කළ ක්ෂය වීම
ස්කීමා	Zod 4 — MCP මෙවලම් I/O වලංගුකරණය + API ගිවිසුම්
ප්රොටෝකෝල	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කට වැඩි ප්රමාණයක් පුරා ස්ථිතික පරීක්ෂණ ප්රකාශන 60,000කට වැඩියි (unit, integration, E2E, security, ecosystem)
වේදිකා	ඩෙස්ක්ටොප් (Electron) · Android (Termux) · PWA (ඕනෑම බ්රවුසරයක්)
CI/CD	GitHub Actions — release අවස්ථාවේ ස්වයංක්රීය npm publish + Docker Hub
සබැඳි	වෙබ් අඩවිය · npm · Docker Hub

## 📖 ලේඛන

### 📘 ආරම්භ කිරීම

ලේඛනය	විස්තරය
පරිශීලක මාර්ගෝපදේශය	Providers, combos, CLI ඒකාබද්ධ කිරීම, යෙදවීම
සැකසුම් මාර්ගෝපදේශය	සම්පූර්ණ ස්ථාපන ක්රම, CLI මෙවලම් වින්යාස, ප්රොටෝකෝල සැකසුම, කාලය ඉක්මවා යාම සකස් කිරීම
CLI මෙවලම් මාර්ගෝපදේශය	Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot සඳහා එක් එක් මෙවලමට අදාළ සැකසුම
දුරස්ථ ප්රකාරය	විෂය පථයට සීමා කළ ප්රවේශ ටෝකන භාවිතයෙන් ඔබේ ලැප්ටොප් CLI හරහා දුරස්ථ OmniRoute (VPS) පාලනය කිරීම
Claude Code වින්යාසය	`launch` + එක් එක් මාදිලිය සඳහා පැතිකඩ භාවිතයෙන් Claude Code OmniRoute (දේශීය/දුරස්ථ) වෙත යොමු කිරීම
ඉක්මන් ආරම්භය	පියවර 3ක ස්ථාපනය → සම්බන්ධ කිරීම → වින්යාස කිරීම

### 🔧 මෙහෙයුම් සහ යෙදවීම

ලේඛනය	විස්තරය
Docker මාර්ගෝපදේශය	Docker ධාවනය, Compose පැතිකඩ, Caddy HTTPS, ටනල්, image ටැග
Podman මාර්ගෝපදේශය	Quadlet systemd ඒකාබද්ධ කිරීම, podman-compose, SELinux
VM යෙදවීම	සම්පූර්ණ මාර්ගෝපදේශය: VM + nginx + Cloudflare සැකසුම
Fly.io යෙදවීම	ස්ථිර ගබඩාවක් සමඟ Fly.io වෙත යෙදවීම
Termux මාර්ගෝපදේශය	Termux හරහා Android මත OmniRoute ධාවනය කිරීම
PWA මාර්ගෝපදේශය	Progressive Web App ස්ථාපනය, caching, ගෘහ නිර්මාණය
අස්ථාපන මාර්ගෝපදේශය	සියලුම ස්ථාපන ක්රම සඳහා පිරිසිදු ඉවත් කිරීම
පරිසර වින්යාසය	සම්පූර්ණ `.env` විචල්ය සහ යොමු

### 🧠 විශේෂාංග සහ ගෘහ නිර්මාණය

ලේඛනය	විස්තරය
ගෘහ නිර්මාණය	පද්ධති ගෘහ නිර්මාණය, දත්ත ප්රවාහය සහ අභ්යන්තර ක්රියාකාරිත්වය
සම්පීඩන මාර්ගෝපදේශය	විකල්ප 7ක pipeline: off / lite / standard / aggressive / ultra / RTK / stacked
RTK සම්පීඩනය	විධාන ප්රතිදාන සම්පීඩනය, පෙරහන්, විශ්වාසය, verify, raw-output ප්රතිසාධනය
සම්පීඩන එන්ජින්	Caveman, RTK, stacked pipelines, dashboard/API/MCP අතුරුමුහුණත්
සම්පීඩන රීති ආකෘතිය	Caveman සහ RTK පෙරහන් සඳහා JSON rule-pack schemas
සම්පීඩන භාෂා පැකේජ	භාෂා හඳුනාගැනීම සහ Caveman rule-pack නිර්මාණය
ප්රතිරෝධකතා මාර්ගෝපදේශය	Circuit breakers, cooldowns, පෝලිම, anti-thundering herd, TLS spoofing
ස්වයංක්රීය Combo එන්ජිම	සාධක 16ක ලකුණුකරණය, mode packs, ස්වයං-සුවය
Proxy මාර්ගෝපදේශය	මට්ටම් 3ක proxy පද්ධතිය, 1proxy වෙළඳපොළ, registry CRUD
නොමිලේ මට්ටම්	ඒකාබද්ධ නාමාවලිය: ලේඛනගත පුනරාවර්තන pools 34ක් / නාමාවලිගත නොමිලේ මට්ටම් ඇතුළත් කිරීම් 465ක්
විශේෂාංග ගැලරිය	තිර රූ සමඟ දෘශ්ය dashboard සංචාරය
Codebase ලේඛනගත කිරීම	ආරම්භකයන්ට හිතකර codebase විස්තරාත්මක සංචාරය

### 🤖 ප්රොටෝකෝල සහ API

ලේඛනය	විස්තරය
API යොමුව	උදාහරණ සමඟ සියලුම endpoints
OpenAPI පිරිවිතරය	OpenAPI 3.0 පිරිවිතරය
MCP Server	MCP මෙවලම් 110ක්, IDE වින්යාස, Python/TS/Go clients
MCP Server මාර්ගෝපදේශය	MCP ස්ථාපනය, transports සහ මෙවලම් යොමුව
A2A Server	JSON-RPC 2.0 ප්රොටෝකෝලය, කුසලතා, streaming, කාර්ය කළමනාකරණය
A2A Server මාර්ගෝපදේශය	A2A agent card, කාර්ය, කුසලතා සහ streaming

### 📋 ව්යාපෘතිය සහ ගුණාත්මකභාවය

ලේඛනය	විස්තරය
දායකත්වය	සංවර්ධන සැකසුම සහ මාර්ගෝපදේශ
ශාඛාකරණ සහ නිකුතු ආකෘතිය	PR ඉලක්ක කරන්නේ කොතැනටද (`release/*`), `main` සහ ටැග් වලින් අදහස් කරන්නේ කුමක්ද
වෙනස්කම් ලේඛනය	එක් එක් අනුවාදයට අදාළ සම්පූර්ණ නිකුතු ඉතිහාසය
ආරක්ෂක ප්රතිපත්තිය	අවදානම් වාර්තාකරණය සහ ආරක්ෂක භාවිතයන්
i18n මාර්ගෝපදේශය	භාෂා 67ක් සඳහා සහාය, පරිවර්තන කාර්යප්රවාහය, RTL
නිකුතු පිරික්සුම් ලැයිස්තුව	නිකුතුවට පෙර වලංගුකරණ පියවර
ආවරණ සැලැස්ම	පරීක්ෂණ ගොනු 8,400කට වැඩි ප්රමාණයක් හරහා ස්ථිතික පරීක්ෂණ ප්රකාශන 60,000කට වැඩි සංඛ්යාවක් සඳහා පරීක්ෂණ ආවරණ උපායමාර්ගය

# ⭐ ප්රමුඛ දායකයින් > OmniRoute නිර්මාණය වී ඇත්තේ උද්යෝගිමත් විවෘත මූලාශ්ර ප්රජාවක් විසිනි. මෙම පුද්ගලයන් ව්යාපෘතියේ ගුණාත්මකභාවය, ස්ථායීතාව සහ ප්රවේශය කෙරෙහි සෘජුවම බලපාන සුවිශේෂී දායකත්වයන් ලබා දී ඇත. **ස්තුතියි.** ### ඒකාබද්ධ කළ 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ක්, Dependabot විසින් 240ක්, අනෙකුත් bot/app මගින් 6ක් සහ විවිධ දායකයින් 883 දෙනෙකුගෙන් ලැබුණු බාහිර PR 5,571ක්. “වෙනස් කළ පේළි” යනු GitHub එකතුකිරීම් + මකාදැමීම් වන අතර ජනනය කළ ගොනු, lockfile, නාමාවලි, පරිවර්තන සහ ලේඛන ද ඇතුළත් වේ; එය ලියන ලද LOC නොව, සිදුවූ වෙනස්කම් ප්රමාණයයි. PR 53ක GitHub diff පේළි 500,000කට වැඩි බව වාර්තා කර ඇත (උදාහරණයක් ලෙස #13399 හි එක් provider එකක් එක් කිරීමකදී වෙනස් කළ ගොනු 2,347ක් ලැයිස්තුගත කර ඇත), එමඟින් ඉහත එකතුවල කිහිපයක් ඉහළ යයි. සමාන ස්ථාන එකට ශ්රේණිගත කර ඇත.} ### GitHub වෙත ආරෝපිත commits

Dizzle _{🥇 GitHub වෙත ආරෝපිත commits 418}	Bob.Hou _{🥈 GitHub වෙත ආරෝපිත commits 294}	Paijo _{🥉 GitHub වෙත ආරෝපිත commits 229}	Paco Cartones _{🏅 GitHub වෙත ආරෝපිත commits 222}	backryun _{🏅 GitHub වෙත ආරෝපිත commits 202}	Jan Leon _{🏅 GitHub වෙත ආරෝපිත commits 134}
Ravi Tharuma _{🏅 GitHub වෙත ආරෝපිත commits 126}	Markus Hartung _{🏅 GitHub වෙත ආරෝපිත commits 115}	Randi _{🏅 GitHub වෙත ආරෝපිත commits 108}	Chris _{🏅 GitHub වෙත ආරෝපිත commits 70}	WebPerson _{🏅 GitHub වෙත ආරෝපිත commits 68}	Koosha Paridehpour _{🏅 GitHub වෙත ආරෝපිත commits 68}

_{2026-11-03 02:09:16 UTC දී නැවත පරීක්ෂා කරන ලදී: release/v3.8.53 පෙරනිමි ශාඛාව සඳහා repository Contributors API මඟින් වාර්තා කරන ලද GitHub වෙත ආරෝපිත commits. API මඟින් identities 903ක් (පරිශීලකයන් 429ක්, bots 2ක්, නිර්නාමික identities 472ක්) ආපසු ලබා දුන්නේය; මෙම වගුව maintainer, bots සහ නිර්නාමික identities ඉවත් කර, තරගයේ සම තත්ත්වයන් රඳවා ගනී. මෙය ඉහත merged-PR ranking එකෙන් මෙන්ම පහත Git-metadata census එකෙන්ද වෙනස් වේ.} > 🙏 මෙම දායකයින්ගේ විශේෂාංග, දෝෂ නිවැරදි කිරීම් සහ infrastructure වැඩිදියුණු කිරීම්, OmniRoute විශ්වාසදායක සහ විශේෂාංගවලින් සපිරි එකක් බවට පත් කරන දේවල **මූලික කොටසකි**. සෑම pull request එකක්ම, සෑම test case එකක්ම සහ සෑම i18n translation file එකක්ම වැදගත් වේ. Open source ගොඩනගන්නේ ඔවුන් වැනි පුද්ගලයන් විසිනි.

---
## 💖 අනුග්රාහකයින්

තමන්ගේම මුදලින් OmniRoute සඳහා අරමුදල් සපයන පුද්ගලයින්ට හෘදයාංගම ස්තුතිය — සෑම දායකත්වයක්ම ව්යාපෘතිය නොමිලේ, ස්වාධීනව සහ අඛණ්ඩව ඉදිරියට ගෙන යාමට උපකාරී වේ.

Andrew _{💛 සක්රිය මාසික අනුග්රාහකයෙකි}	Vlad I _{💛 සක්රිය මාසික අනුග්රාහකයෙකි}	小妍儿 _{💛 සක්රිය මාසික අනුග්රාහකයෙකි}	Guilherme Costa _{💛 සක්රිය එක්වරක් පමණක් දායක වූ අනුග්රාහකයෙකි}	Henrique Iurkiv _{💛 සක්රිය එක්වරක් පමණක් දායක වූ අනුග්රාහකයෙකි}	Somesh Ghaturle _{💛 සක්රිය එක්වරක් පමණක් දායක වූ අනුග්රාහකයෙකි}
Kolonie AI _{💛 අතීතයේ එක්වරක් පමණක් දායක වූ ආධාරකරුවෙකි}	Prof. Igor Morais _{💛 අතීතයේ එක්වරක් පමණක් දායක වූ ආධාරකරුවෙකි}	Pixma _{💛 අතීතයේ එක්වරක් පමණක් දායක වූ ආධාරකරුවෙකි}	Paco Cartones _{💛 අතීතයේ එක්වරක් පමණක් දායක වූ ආධාරකරුවෙකි}	longtao _{💛 අතීතයේ එක්වරක් පමණක් දායක වූ ආධාරකරුවෙකි}

_{… සහ පුද්ගලිකව සිටීමට කැමති අනෙකුත් අය 💛} _{පොදු GitHub Sponsors තොරතුරු 2026-10-18 දින GitHub Sponsors GraphQL API හරහා නැවත සත්යාපනය කරන ලදී: සමස්ත අනුග්රාහකත්ව 14 න් පොදු අනුග්රාහකත්ව 11 ක් (සක්රිය 6 ක්, අතීත 5 ක්) වේ. ඉහත සක්රිය ලේබල තීරණය කරනු ලබන්නේ GitHub හි isActive තත්ත්වය මඟිනි; අතීතයේ එක්වරක් පමණක් දායක වූ පොදු ආධාරකරුවන්ට දිගටම ස්තුතිය පළ කෙරෙන අතර, පුද්ගලික අනුග්රාහකයින් නිර්නාමිකව තබා ඇත. Ko-fi, Buy Me a Coffee, Liberapay, PIX සහ ක්රිප්ටෝ පරිත්යාග සඳහා පොදු අනුග්රාහක වාර්තාවක් නොමැති බැවින් ඒවා ලැයිස්තුගත කර නොමැත.} 💖 අනුග්රාහකයෙකු වන්න → — සෑම ඩොලරයක්ම OmniRoute නොමිලේ සහ ස්වාධීනව පවත්වාගෙන යාමට උපකාරී වේ.

## 👥 1,000+ දායකයින්

[![දායකයින්](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-11-02 දින සජීවී release/v3.8.53 ටිප් එකේ 1c7135e0fb (කමිට් 7,972) විගණනය කරන ලදී: සාමාන්යකරණය කළ මානව Git අනන්යතා 1,074ක් — 759ක් කමිට් කර්තෘවරුන් ලෙස (නඩත්තුකරු ද ඇතුළුව) පෙනී සිටින අතර 315ක් පැහැදිලි Co-authored-by ට්රේලර්වල පමණක් පෙනී සිටී. මෙම ගණනය .mailmap යොදයි, ඊමේල් ලිපින අකුරු විශාලත්වය නොසලකා සසඳයි, සංඛ්යාත්මක සහ සාමාන්ය GitHub noreply ලිපින එකම හෑන්ඩලය සංකේතවත් කරන විට පමණක් ඒකාබද්ධ කරයි, bot/agent/service/placeholder අනන්යතා 29ක් බැහැර කරයි, සහ පෙන්වන නම් ගැළපෙන පමණින් සාමාන්ය ඊමේල් ලිපින ඒකාබද්ධ නොකරයි. 2026-08-24 විගණනයේ 639ක් ප්රකාශයට පත් කර තිබූ අතර; එම විගණනයේ මූලික ac02c5b42f මත මෙම ක්රමය නැවත ධාවනය කළ විට 619ක් ලැබේ, එබැවින් වැඩිවීම සිදුවී ඇත්තේ නව දායකයින් නිසා මිස ලිහිල් ක්රමයක් නිසා නොවේ.} ### දායක වන්නේ කෙසේද 1. නිධිය Fork කරන්න 2. **ක්රියාකාරී** `release/vX.Y.Z` ටිප් එකෙන් (`main` වෙතින් නොවේ) බ්රාන්ච් එකක් සාදන්න — [බ්රාන්ච් කිරීමේ සහ නිකුත් කිරීමේ ආකෘතිය](docs/ops/BRANCHING_MODEL.md) බලන්න 3. ඔබේ විශේෂාංග බ්රාන්ච් එක සාදන්න (`git checkout -b feat/amazing-feature`) 4. ඔබේ වෙනස්කම් කමිට් කරන්න (`git commit -m 'feat: add amazing feature'`) 5. බ්රාන්ච් එකට push කරන්න (`git push origin feat/amazing-feature`) 6. **base = එම `release/vX.Y.Z` බ්රාන්ච් එක** ලෙස Pull Request එකක් විවෘත කරන්න විස්තරාත්මක මාර්ගෝපදේශ සඳහා [CONTRIBUTING.md](CONTRIBUTING.md) බලන්න. ### නව අනුවාදයක් නිකුත් කිරීම ```bash # නිකුතුවක් සාදන්න — npm publish ස්වයංක්රීයව සිදු වේ VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 තරු

## 🌍 ස්ටාර්මැපර්

## 🙏 ස්තූතිය

OmniRoute දැවැන්තයන්ගේ උරහිස් මත ගොඩනැගී ඇත. එය **[9router](https://github.com/decolua/9router)** හි fork එකක් ලෙසත්, Go ව්යාපෘතියක් වන **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** හි TypeScript port එකක් ලෙසත් ආරම්භ විය — ඉන්පසු පහත දැක්වෙන සෑම උප පද්ධතියක්ම ඊට පෙර එම කාර්යය සිදු කළ open-source ව්යාපෘතියකින් ආභාසය ලැබීය. ඒ සෑම එකක්ම OmniRoute හි නිශ්චිත කොටසක් හැඩගස්වා ඇත. මේ සියල්ලටම අපගේ ස්තූතියයි. 🙏 > ⭐ තරු ගණන් 2026 නොවැම්බර් 3 දින GitHub හි REST API වෙතින් සත්යාපනය කරන ලදී — මෙම ව්යාපෘතිවලට ගොස් තරුවක් ලබා දෙන්න. ගණන් නිශ්චිත දිනක ලබාගත් snapshot එකක් වන අතර ස්වභාවිකවම වෙනස් වේ. ### 🧬 වංශාවලිය සහ gateway

ව්යාපෘතිය	⭐	එය OmniRoute වෙත ලබා දුන් ආභාසය
9router	31,861	මෙම fork එක ගොඩනගා ඇති මුල් ව්යාපෘතිය — මෙහිදී multi-modal APIs සහ සම්පූර්ණ TypeScript rewrite එකකින් පුළුල් කර ඇත.
CLIProxyAPI	57,329	මෙම JavaScript / TypeScript port එකට ආභාසය ලබා දුන් Go implementation එක.
LiteLLM	62,580	පොදු pricing dataset එක අපගේ වියදම්-අධීක්ෂණ synchronization සඳහා සපයන, සහ එහි provider-normalization ආකෘතිය අපගේ routing සඳහා මඟපෙන්වූ AI gateway එක.
codex-chatgpt-web	15,435	browser-session, response-framing, usage සහ web-search adapters ඇතුළුව, vendored ChatGPT Web → Codex Responses bridge එකට අනුවර්තනය කළ MIT source එක.
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	Codex OAuth reauthentication වෙත port කළ fresh-login සහ refresh-token rotation රටා.
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	Grok payload සහ device defaults, Statsig generator සහ TQZHR සහ grok2api-merged හරහා ගෙන ආ `result.response` processor සඳහා වූ මූලික MIT source එක.
grok2api-pro	27	එහි proxy-pool layer සඳහා grok2api-merged විසින් සඳහන් කරන 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	එහි HTTP/browser upstream සැලසුම මුල් Grok Web implementation සඳහා පරිශීලනය කරන ලදී; එහි direct HTTP path එක GrokProxy වෙතින් ව්යුත්පන්න වන බැවින්, ස්වාධීන code port එකක් ඇති බව ප්රකාශ නොකරයි.

### 🗜️ Context සහ token compression — engines

ව්යාපෘතිය	⭐	එය OmniRoute වෙත ආභාසය ලබා දුන් ආකාරය
Caveman	116,957	වයිරල් වූ "why use many token when few token do trick" ව්යාපෘතිය — එහි caveman-සන්නිවේදන දර්ශනය අපගේ සම්මත සම්පීඩන මාදිලිය සහ filler/condensation නීති 30කට වැඩි ගණනක් බලගන්වයි.
RTK – Rust Token Killer	85,350	ඉහළ-කාර්යසාධන command-output සම්පීඩනය — එය අපගේ RTK එන්ජිම, JSON filter DSL, raw-output recovery සහ එකිනෙක මත ගොඩනැගූ RTK → Caveman pipeline සඳහා ආභාසය ලබා දුන්නේය.
headroom	78,672	ප්රතිවර්තනය කළ හැකි context-compression (SmartCrusher) — එය අපගේ `headroom` එන්ජිම සහ `ccr` retrieve-marker රටාව සඳහා ආභාසය ලබා දුන්නේය.
LLMLingua	6,797	Prompt-compression පර්යේෂණය (LLMLingua / LLMLingua-2) — එය අපගේ asynchronous, code-safe, fail-open `llmlingua` එන්ජිම සඳහා ආභාසය ලබා දුන්නේය.
llmlingua-2-js	33	අපගේ LLMLingua එන්ජිම සඳහා worker-thread backend ලෙස භාවිත කරන JS/ONNX port එක (MobileBERT / XLM-RoBERTa).
Troglodita	50	PT-BR token සම්පීඩනය — බ්රසීලියානු-පෘතුගීසි ව්යාකරණයට සකස් කළ pleonasm අඩු කිරීම සහ filler ඉවත් කිරීම මඟින් අපගේ pt-BR language pack එක බලගන්වයි.
ponytail	182,929	වයිරල් වූ "lazy senior dev" YAGNI-coder skill එක — එය අපගේ less-code Output Style සඳහා ආභාසය ලබා දුන්නේය: Caveman හි සංක්ෂිප්ත prose සඳහා output-axis සහෝදරයා වන, _generated_ code අඩු කරන smallest-working-change steering එක.
i-have-adhd	59,838	එහි action-first, ADHD-friendly response style එක භාෂා පහක් පුරා OmniRoute හි සංක්ෂිප්ත output style එකට අනුව සකස් කරන ලදී.

### 🧩 සංක්ෂිප්ත ආකෘති, token පර්යේෂණය සහ code-aware මෙවලම්

ව්යාපෘතිය	⭐	එය 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 + per-session context-delta — එය අපගේ `session-dedup` එන්ජිම සඳහා ආභාසය ලබා දුන්නේය.
token-savior	1,203	Bash-output compaction + MCP profiles — එය අපගේ compression bail-out discipline සහ 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	"Find the ghost tokens" — එහි offload + recoverable-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` එන්ජින් සැලසුම සහ cache-stable "compressed form is 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 literals ආරක්ෂා කරමින් comments ඉවත් කරන අපගේ parser-based ක්රමයට ආභාසය ලබා දුන්නේය.

### 🧠 මතකය සහ RAG

ව්යාපෘතිය	⭐	එය OmniRoute වෙත ආභාසය ලබා දුන් ආකාරය
Mem0	68,294	විශ්වීය මතක ස්තරය — එහි proxy-as-write/read-boundary ආකෘතිය අපගේ මතක වාස්තු විද්යාව හැඩගැස්වීය.
Letta (MemGPT)	25,321	ස්තරගත මතකයක් සහිත තත්ත්වවත් agents — අපගේ Context Control & Recovery (CCR) ස්තරගත ආකෘතියට ආභාසය ලබා දුන්නේය.
WFGY	1,804	නැවත නැවත සිදුවන RAG/LLM අසාර්ථකතා මාදිලි 16ක ProblemMap වර්ගීකරණය — අපගේ දෝෂ නිරාකරණ මාර්ගෝපදේශයේ හවුල් පාරිභාෂික වචන මාලාවයි.

### 🛰️ ගමනාගමන පරීක්ෂාව, MITM සහ පාරදෘශ්ය proxy

ව්යාපෘතිය	⭐	එය OmniRoute වෙත ආභාසය ලබා දුන් ආකාරය
llm-interceptor	81	coding-assistant ↔ LLM ගමනාගමනයේ MITM interception/analysis මඟින් මුල් Traffic Inspector අවශ්යතා පිළිබඳ අවබෝධයක් ලබා දුන්නේය. මීට පෙර ව්යුත්පන්න කළ modules හතරක් — SSE merging, conversation normalization, secret masking සහ header sanitization — පොදු protocol ප්රමිතීන් මත පදනම් වූ ස්වාධීන clean-room implementations මඟින් ප්රතිස්ථාපනය කර ඇත. host-passthrough surfaces දෙක (`passthrough.ts` සහ `_internal/bypass.cjs`) OmniRoute-අභ්යන්තර implementations ලෙස ස්වාධීනව වර්ගීකරණය කර ඇති අතර, එම ප්රතිස්ථාපනයේ කොටසක් ලෙස ඒවා නැවත ලියා නොමැත.
ProxyBridge	6,978	එක් එක් process එක අනුව සිදුකරන පාරදෘශ්ය proxy routing — crash-safe MITM teardown, socket idle-timeouts, `/proc` process attribution සහ TPROXY capture සඳහා ආභාසය ලබා දුන්නේය.

### 📚 ආකෘති දත්ත, නිරීක්ෂණ හැකියාව සහ UI

ව්යාපෘතිය	⭐	එය OmniRoute වෙත ආභාසය ලබා දුන් ආකාරය
models.dev	7,486	AI ආකෘති පිරිවිතර, මිලකරණය සහ හැකියාවන් පිළිබඳ විවෘත දත්ත සමුදාය — අපගේ model catalog වෙත ස්වදේශීයව සමමුහුර්ත කර ඇත.
React Flow / xyflow	38,874	අපගේ තත්ය-කාලීන Compression Studio සහ Combo/Routing Studio බලගන්වන node-පාදක graph library එකයි.
LangGraph	44,349	LangGraph Studio හි සජීවී workflow-graph දෘශ්යකරණය අපගේ Studios හි තත්ය-කාලීන cascade view සඳහා ආභාසය ලබා දුන්නේය.
Langfuse	36,907	එහි trace → span → generation observability ආකෘතිය අපගේ Compression Studio waterfall එක හැඩගැස්වීය.
Kiali	3,647	Istio service-mesh observability — Routing/Combo Studio හි අපගේ circuit-breaker badges සහ error-edge visuals සඳහා ආභාසය ලබා දුන්නේය.
lobe-icons	2,666	අපගේ dashboard පුරා provider icons ලෙස දර්ශනය වන AI/LLM brand logos සපයයි.
flag-icons	12,499	README භාෂා තේරීම සඳහා භාවිත කරන MIT-licensed SVG flags සපයයි.

### 🛡️ ආරක්ෂාව

ව්යාපෘතිය	⭐	එය OmniRoute වෙත ආභාසය ලබා දුන් ආකාරය
awesome-secure-defaults	723	ආරක්ෂිත-පෙරනිමි libraries පිළිබඳ සම්පාදිත ලැයිස්තුවක් වන අතර, එය අපගේ ආරක්ෂක තේරීම් (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink) සඳහා මාර්ගෝපදේශ සපයයි.

### 🧭 අනුපූරක මෙවලම්

ව්යාපෘතිය	⭐	එය OmniRoute වෙත ආභාසය ලබා දුන් ආකාරය
ClawRouter	6,649	request deduplication, emergency zero-cost fallback, pluggable Auto-Combo strategies සහ බහුභාෂා intent classification සඳහා ආභාසය ලබා දුන්නේය.
Antigravity-Manager	32,785	එහි account-aware model remapping, executable-path validation සහ plan-label හැසිරීම OmniRoute හි Antigravity runtime සඳහා තොරතුරු සැපයීය.
vscode-antigravity-cockpit	4,852	එහි සංක්ෂිප්ත quota-reset countdown ආකෘතිය OmniRoute හි අදාළ provider-limit display සඳහා ආභාසය ලබා දුන්නේය.
AionUi	33,996	එහි ACP integrations මඟින් ස්ථාපිත CLI agents ස්වයංක්රීයව හඳුනාගැනීම සඳහා OmniRoute වෙත ආභාසය ලබා දුන්නේය.
CodexBar	22,955	Grok Build quota surface හඳුනාගත් අතර, OmniRoute පසුව live wire format එක ස්වාධීනව සත්යාපනය කර නිවැරදි කළේය.

## 📄 බලපත්රය MIT බලපත්රය - විස්තර සඳහා [LICENSE](LICENSE) බලන්න. ---

**[⬆ ඉහළට ආපසු](#-omniroute)** · විවෘත මූලාශ්ර AI ප්රජාව සඳහා ❤️ සමඟ නිර්මාණය කරන ලදී. _{නිර්මාණය කළේ Diego Souza විසිනි · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT බලපත්රය · omniroute.online}