# 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 ද්වාරය

OmniRoute — කේත ලිවීම කිසිදා නවත්වන්න එපා. සෑම AI මෙවලමක්ම → සැපයුම්කරුවන් 372ක් — නොමිලේ 150කට වැඩි ප්රමාණයක් — එක් අන්ත ලක්ෂ්යයක් හරහා. Claude Code, Codex, Cursor, Cline, Copilot සහ Antigravity ස්වයංක්රීය විකල්ප මාරුව සමඟ නොමිලේ Claude / GPT / Gemini වෙත සම්බන්ධ කරයි. RTK + Caveman ඒකාබද්ධ සම්පීඩනය ටෝකනවලින් 15–95%ක් (සාමාන්යයෙන් ~89%ක්) ඉතිරි කරයි — කිසිදා සීමාවලට ළඟා නොවන්න. AI සැපයුම්කරුවන් 372ක් · නොමිලේ ස්ථර 150කට වැඩි ප්රමාණයක් · මසකට නොමිලේ ටෝකන බිලියන ~1.62ක් · මාර්ගගත කිරීමේ උපායමාර්ග 19ක් · ආරම්භ කිරීමට $0යි.

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

> **ඔබගේම සපයන්නන්ගේ ගිණුම් රැගෙන එන්න.** මෙය OmniRoute වෙතින් ලැබෙන ටෝකන ප්රදානයක් නොව, වෙන වෙනම සුදුසුකම් ලබන තෙවන පාර්ශ්වීය නොමිලේ ස්ථරවල ඇස්තමේන්තුගත සමස්තයකි. ලියාපදිංචි වී, අවශ්ය තැන්වල අක්තපත්ර ලබාගෙන, ඔබට භාවිත කළ හැකි සපයන්නන් සම්බන්ධ කරන්න; එක් එක් සපයන්නා තම සීමා, ලබාගත හැකි බව සහ කොන්දේසි පාලනය කරයි. > > නොමිලේ ස්ථර අතින් එකට ගොඩගැසීම වෙහෙසකරයි — SDK දුසිම් ගණනක්, අනුපාත සීමා දුසිම් ගණනක්, සහ ඔබට ඇත්ත වශයෙන්ම කොපමණ තිබේදැයි කිසිදු අදහසක් නැත. OmniRoute විසින් **නැවත නැවත ලැබෙන pool key 35ක් හරහා නොමිලේ-ස්ථර ඇතුළත් කිරීම් 489ක්** නාමාවලිගත කරන අතර, බෙදාගත් pool අනුව අනුපිටපත් ඉවත් කර, **ප්රකාශිත ධනාත්මක මාසික අයවැයක් සහිත pool 17 සහ එක් එක් model සඳහා වූ Groq සීමා පහකින්** ටෝකන ශීර්ෂ අගය ගණනය කරයි. ප්රාදේශීය අනන්යතා පරීක්ෂාවකින් පසුව පමණක් විවෘත වන quotas (අද වන විට: ModelScope) වෙනම පෙන්වනු ලැබේ—ප්රාදේශීය අනන්යතා සත්යාපනයට පිටුපසින් +~6M—සහ කිසිවිටෙකත් ශීර්ෂ අගයට එකතු නොකෙරේ. ප්රතිඵලය උපකරණ පුවරුවේ (`/dashboard/free-tiers`) දිගටම දෘශ්යමාන වේ.

OmniRoute නොමිලේ-ස්ථර අයවැය කාඩ්පත: ස්ථාවරව මසකට නොමිලේ ටෝකන ~1.62Bක්, ලියාපදිංචි වීමේ credits සමඟ පළමු මාසයේ ~2.22Bක් දක්වා, එක් endpoint එකක් පිටුපස නාමාවලිගත නොමිලේ-ස්ථර ඇතුළත් කිරීම් 489ක් ආවරණය කරන ලේඛනගත නැවත නැවත ලැබෙන pool key 35කින්. අවංක pool-අනුපිටපත්-ඉවත් කළ ගණනය — ප්රකාශිත ධනාත්මක මාසික ටෝකන අයවැයක් සහිත නැවත නැවත ලැබෙන pool 17ක් සහ එක් එක් model සඳහා වූ Groq සීමා පහක් ඇතුළුව, සෑම බෙදාගත් pool එකක්ම එක් වරක් පමණක් ගණන් කෙරේ; කොන්දේසි-අවදානම් නාමාවලියේ සපයන්නන් 13 දෙනෙකු භාවිතයෙන් වළකින්න ලෙස සලකුණු කර ඇති බැවින් ඔබට තීරණය කළ හැක. අයවැය තීරුවට Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (එක් එක් model සඳහා සීමා පහක්) සහ කුඩා pool ද, පළමු මාසයේ ලියාපදිංචි වීමේ credits ද ඇතුළත් වන අතර, සදාකාලිකව නොමිලේ ලබාදෙන ටෝකන සීමාවක් නොමැති සපයන්නන් වෙනම මතුකර පෙන්වන බැවින් ඔවුන් කිසිවිටෙකත් ශීර්ෂ අගය කෘත්රිමව වැඩි නොකරයි. සජීවීව භාවිත කළ/ඉතිරි ප්රමාණය /dashboard/free-tiers හි.

> සජීවී `/dashboard/free-tiers` පිටුවේ සජීවීකරණය කළ සාරාංශය. සම්පූර්ණ ක්රමවේදය (pool අනුපිටපත් ඉවත් කිරීම, credit ස්ථර, සපයන්නන්ගේ කොන්දේසි): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{මෙම සංඛ්යා සජීවී නාමාවලියට සාපේක්ෂව සෑම සති දෙකකට වරක් නැවත විගණනය කෙරෙන අතර **දෙපැත්තටම වෙනස් වේ** — සපයන්නෙකු නොමිලේ ස්ථරයක් අවසන් කළ විට සංඛ්යාව පහත වැටේ; අලුත් එකක් පැමිණි විට එය ඉහළ යයි. අපි ප්රකාශයට පත් කරන්නේ නාමාවලිය ඇත්ත වශයෙන්ම ගණනය කරන අගය මිස, ඉහළට වට කළ හොඳම අවස්ථාවක් නොවේ.}

⭐ OMNIROUTE ඔබට මුදල් ඉතිරි කර ඔබේ කාර්යය පහසු කර ගැනීමට උපකාරී වූයේ නම් repository එකට තරුවක් ලබා දෙන්න.

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

[![තරු ඉතිහාස ශ්රේණිය](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) ### 💬 ප්රජාවට එක්වන්න **👋 නඩත්තුකරු අනුගමනය කරන්න — නව සපයන්නන්, නිකුතු සහ ඉඟි පළමුව ලබාගන්න:** [![LinkedIn හි Diego අනුගමනය කරන්න](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![GitHub හි @diegosouzapw අනුගමනය කරන්න](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 ගෝලීය](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 බ්රසීලය](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![වෙබ් අඩවිය](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **ප්රශ්න, සපයන්නන් පිළිබඳ ඉඟි, ඉදිරි සැලැස්ම සහ සහාය → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 ගෝලීය](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 බ්රසීලය](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [ද්වාරය](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 ගේට්වේ එක අඛණ්ඩව වර්ධනය වෙමින් පවතී

| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | ---------------------------------- | :------------------------: | :---------: | :-------------------: | | 🌐 සැපයුම්කරුවන් | 352 | **358** | 372 | | 🧠 අනන්ය චැට් මාදිලි ID | 1320 | **1374** | 1443 | | 🖼️ මාදිලිත්ව පාලම | 🆕 දෘශ්ය + ශ්රව්ය + වීඩියෝ | ✓ | ✓ | | 📡 Radar නොමිලේ නාමාවලිය | 🆕 තෝරා සක්රිය කළ හැකි | ✓ | ✓ | | ⚖️ කෝටා-සංවේදී උපලේඛනගත කිරීම | 🆕 Quota-Share | ✓ | ✓ | | 📊 කෝටා ටෙලිමෙට්රි | 🆕 සජීවී | ✓ | ✓ | | 🧰 Headless මාදිලිය | — | — | 🆕 `serve --headless` | | 🛤️ LTS දුම්රිය මාර්ග යටිතල පහසුකම් | — | — | 🆕 නිකුතු නාලිකා | **→ [මාර්ග සිතියම](ROADMAP.md) — `v3.9.0 LTS` වෙත දුම්රිය මාර්ගයේ ගමන් කරමින්**

## 🧩 ලබා ගත හැකිය [![npm අනුවාදය](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM මාසික බාගැනීම්](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![බලපත්රය: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker බාගැනීම්](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron බාගැනීම්](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 ආරම්භය	🚀 ඉක්මන් ආරම්භය	📦 ස්ථාපනය	🆓 වින්යාස රහිතයි
💡 ඉගෙන ගන්න	💥 පොරොන්දුව	🤔 OmniRoute තෝරාගන්නේ ඇයි	🏆 සුවිශේෂී වන්නේ කුමක්ද
⚙️ විශේෂාංග	🎯 සංයෝජන	🌐 සැපයුම්කරුවන්	🔌 CLI & MCP
	🗜️ සම්පීඩනය	🖥️ එය ක්රියාත්මක වන ස්ථාන	🔒 පෞද්ගලිකයි
👀 එය බලන්න	🎬 ක්රියාත්මක වන ආකාරය	✨ අලුත් දේ	🤖 අනුකූල CLI
💚 සහාය	💚 සහාය / පරිත්යාග	💬 ප්රජාව	💖 අනුග්රාහකයින්
📦 ව්යාපෘතිය	🛠️ තාක්ෂණික එකතුව	📖 ලේඛන	👥 දායකයින්

🌐 භාෂා 67කින්

## 🆓 ස්ථාපනය කරන්න, සැපයුම්කරුවෙකු සම්බන්ධ කරන්න, ඉන්පසු එක් අන්ත ලක්ෂ්යයක් හරහා මාර්ගගත කරන්න

පියවර තුනක්: OmniRoute ස්ථාපනය කර ආරම්භ කරන්න, ඔබේම ගිණුම හෝ API යතුර භාවිතයෙන් සුදුසුකම් ලත් සැපයුම්කරුවෙකු සම්බන්ධ කරන්න, ඉන්පසු OmniRoute API යතුරක් සහ auto මාදිලිය භාවිත කරමින් ඔබේ මෙවලම localhost:20128/v1 වෙත යොමු කරන්න. මාර්ගගත කිරීම රඳා පවතින්නේ පවතින සුදුසුකම් ලත් සම්බන්ධතා සහ සැපයුම්කරුගේ සීමාවන් මතය.

```bash # සැපයුම්කරුවෙකු සම්බන්ධ කිරීමෙන් පසු, Dashboard → Endpoints වෙතින් ඔබේ OmniRoute යතුර පිටපත් කරගන්න: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` සඳහා සුදුසුකම් ලත් මාර්ගයක් අවශ්ය වේ. නැවුම් ස්ථාපනයක සුදුසුකම් ලත් යතුරු රහිත ඉලක්ක කිසිවක් නොතිබිය හැකි අතර, යතුරු රහිත සැපයුම්කරුවෙකු තෙවන පාර්ශ්ව සේවාලාභීන් ප්රතික්ෂේප කළ හැක. OpenCode Free සහ Kiro ඇතුළුව `tos: avoid` ලෙස සලකුණු කර ඇති සැපයුම්කරුවන් පෙරනිමියෙන් ස්වයංක්රීය මාර්ගගත කිරීමෙන් බැහැර කර ඇත; ගිණුමක් සම්බන්ධ කිරීමෙන් එම සැකසුම අතික්රමණය නොවේ. සැපයුම්කරුවෙකු තෝරාගැනීමට පෙර [නොමිලේ ස්ථර මාර්ගෝපදේශය](docs/getting-started/FREE-TIERS-GUIDE.md) බලන්න.} _{📦 **Python, Node.js, PHP, සහ cURL** සඳහා පිටපත් කර අලවන ඉක්මන්-ආරම්භක ස්ක්රිප්ට් → [`examples/quickstart/`](examples/quickstart/)}

# 💥 පොරොන්දුව

# 🤔 OmniRoute භාවිත කළ යුත්තේ ඇයි?

OmniRoute තෝරාගන්නේ ඇයි — dashboards 10ක්, අක්රිය API යතුරු සහ අනපේක්ෂිත බිල්පත් අතර මාරු වෙමින් සිටීම නවත්වන්න. දෛනික ගැටලු දහයක් සහ ඒවායේ විසඳුම්: භාවිත නොකරම කෝටාව කල් ඉකුත් වීම → දායකත්වයන්ගෙන් උපරිම ප්රයෝජන ගන්න; කේතනය අතරතුර අනුපාත සීමා ඇතිවීම → ස්ථර 4ක ස්වයංක්රීය විකල්ප මාරුව (Subscription → API → Cheap → Free); මෙවලම් ප්රතිදාන ටෝකන පරිභෝජනය කිරීම → RTK + Caveman සම්පීඩනය (15–95%); මිල අධික APIs → පිරිවැය-ප්රශස්ත කළ මාර්ගගත කිරීම; සෑම මෙවලමකටම වෙනම පිහිටුවීමක් → එක් අන්ත ලක්ෂ්යයක්, එක් dashboard එකක්; AI අවහිර වීම → මට්ටම් 3ක proxy + TLS stealth; අක්රිය යතුරු → ස්තර 3ක ඔරොත්තු දීමේ හැකියාව (circuit breakers, යතුරු cooldown, මාදිලි lockout); කණ්ඩායමක් එක් දායකත්වයක් බෙදාගැනීම → සාධාරණ-කොටස් කෝටා සහිත යතුරු සංචිත; prompts වෙනත් අයෙකුගේ cloud එක හරහා යාම → AES-256-GCM සංකේතනය කළ යතුරු සමඟ local-first; වියදම් පිළිබඳ දෘශ්යතාවක් නොමැති වීම → සජීවී විශ්ලේෂණ (භාවිතය, කෝටාව, ඉතිරිකිරීම්, p95 ප්රමාදය).

OmniRoute ඉල්ලීම් ප්රවාහය: ඔබේ IDE හෝ CLI (Claude Code, Cursor, Cline…) එක් දේශීය අන්ත ලක්ෂ්යයක් (http://localhost:20128/v1) අමතයි; සුදුසුකම් ලත් සෞඛ්ය සම්පන්න ඉලක්කයක් පවතින තාක් OmniRoute Smart Router (RTK + Caveman සම්පීඩනය, මාර්ගගත කිරීමේ උපායමාර්ග 19ක්, circuit breakers, TLS stealth, MCP, A2A, guardrails) සැපයුම්කරු ස්ථර 4ක් හරහා විකල්ප මාරු කළ හැක — ස්ථරය 1 Subscription, ස්ථරය 2 API Key, ස්ථරය 3 Cheap සහ ස්ථරය 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 මාර්ගගත කිරීමේ උපායමාර්ග 19ම සජීවීකරණය කර ඇත — එක් උපායමාර්ගයකට එක් ටයිලයක් බැගින්: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. එක් එක් උපායමාර්ගය කරන්නේ කුමක්දැයි දැන ගැනීමට ඉහත වගුව බලන්න.

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

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

## ### 🔀 නැතහොත් ඔබේම එක ගොඩනඟන්න — මාර්ගගත කිරීමේ උපායමාර්ග 19ක් උපායමාර්ග **19ම** — සෑම 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	`reset-window`	කෝටා කවුළුව ඉක්මනින්ම යළි සකසන ඉලක්කයට ප්රමුඛත්වය දෙයි
12	`reset-aware`	කෝටාව යළි සැකසෙන වේලාව අනුව ශ්රේණිගත කරයි — කෙටි කවුළු පළමුව 📊
13	`context-relay`	දිගු සංවාද සඳහා ඉලක්ක අතර සන්දර්භය පවරයි 🧠
14	`context-optimized`	වත්මන් සන්දර්භ ප්රමාණයට වඩාත්ම ගැළපෙන ඉලක්කය තෝරයි
15	`cache-optimized`	නැවත භාවිත කළ හැකි සෑම prompt උපසර්ගයක්ම එකම ගිණුමට සම්බන්ධ කරයි — prompt-cache ගැළපීම් උපරිම කරයි 🎯
16	`lkgp`	අවසන් වරට සාර්ථක වූ මාර්ගය — අවසන් සාර්ථක සැපයුම්කරුට සම්බන්ධ වී සිටින අතර, එය අසාර්ථක වුවහොත් රීති වෙත ආපසු යයි
17	`auto`	සෑම සම්බන්ධතාවක් පුරාම සාධක 16ක සජීවී ලකුණු කිරීම 🤖
18	`fusion`	මාදිලි මණ්ඩලයකට බෙදා හරියි + විනිශ්චයකරුවකු එක් පිළිතුරක් සංශ්ලේෂණය කරයි 🧬
19	`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×, HALF-OPEN පරීක්ෂණයකට 60s/30s/15s තුළ යළි සකසයි, අවශ්ය වූ විට පමණක් ප්රතිසාධනය කරයි; OPEN තත්ත්වයේදී combo එක ඊළඟ සැපයුම්කරු වෙත යළි මාර්ගගත කරයි. ස්ථරය 2 සම්බන්ධතා විරාමය (එක් යතුරක්/ගිණුමක්): මූලිකව OAuth සඳහා 5s / API-key සඳහා 3s, එකවර ඉල්ලීම් රැල්ලක් ඇතිවීම වැළැක්වීමේ ආරක්ෂණයක් සහිත ඝාතීය ×2 පසුබැසීම, 429 මඟින් Retry-After අගය පිළිපදියි, සාර්ථකත්වය සියලු දෝෂ තත්ත්ව ඉවත් කරයි; විරාමයක පවතින එක් යතුරක් මඟහරින අතර අනෙකුත් සමාන යතුරු දිගටම සේවය සපයයි. ස්ථරය 3 ආකෘති අගුලු දැමීම (එක් ආකෘතියක්): එක් එක් ආකෘතියට අදාළ 429, local 404 හෝ ප්රකාර ප්රතික්ෂේප කිරීම් අගුලු දමන්නේ එම ආකෘතිය පමණි — කිසිවිටෙකත් සම්පූර්ණ සම්බන්ධතාව නොවේ. අවසාන තත්ත්ව (තහනම් කළ, කල් ඉකුත් වූ, ණය අවසන් වූ) විරාම සඳහා නොව ක්රියාකරු සඳහා වේ.

_{📖 [ස්වයංක්රීය-සංයෝජන එන්ජිම](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 එකට 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.50** වෙතින් මෑතකාලීන විශේෂාංග. සම්පූර්ණ ඉතිහාසය [`CHANGELOG.md`](CHANGELOG.md) හි ඇත. - **🎛️ OmniConductor** — ඔබේ agent සමූහය වෙත එන A2A කාර්ය පැවරීම, Agent Card හි Conductor කුසලතා සහ Faro push-to-talk හඬ සංවාදය සහිත dashboard පැනලයක්. → [A2A සේවාදායකය](docs/frameworks/A2A-SERVER.md) - **🛂 අනුවර්තී ප්රවේශය සහ අධිභාර ආරක්ෂාව** — බරැති chat ඉල්ලීම් 503 ප්රතිචාර ලබා දීම වෙනුවට පෝලිම්ගත වන අතර, සෑම සම්බන්ධතාවක් සඳහාම atomic RPM rolling leases භාවිත වේ. → [ප්රත්යස්ථතා මාර්ගෝපදේශය](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ සම්මත `/v1/models` අනුපිළිවෙළ** — සෑම සැපයුම්කරුවකු සඳහාම එක දිගට පිහිටි, සැපයුම්කරු අනුව සමූහගත කළ block එකක් (combos පළමුව pin කර ඇත), සෑම catalog මූලාශ්රයක් පුරාම ස්ථාවරව. → [API යොමුව](docs/reference/API_REFERENCE.md) - **🗜️ සම්පීඩන ශක්තිමත් කිරීම** — පෙරනිමියෙන් සක්රිය inflation guard එකක්, DE / FR / JA + චීන (wényán) සඳහා Caveman packs සහ Gradle හා .NET සඳහා RTK filters. → [සම්පීඩනය](docs/compression/COMPRESSION_ENGINES.md) - **💸 අවංක ස්ථාවර ගාස්තු පිරිවැය** — subscription / coding-plan සැපයුම්කරුවන්ගේ පිරිවැය විශ්ලේෂණවල **$0** ලෙස පෙන්වයි; budget, quota සහ routing තවදුරටත් ඇස්තමේන්තු කරයි. → [API යොමුව](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share routing** — එකම ගිණුමක quota එක pooled keys අතර සාධාරණව බෙදන අතර, නිෂ්ක්රීය කොටස් පිටතට ලබා දෙන බැවින් වැඩ සංරක්ෂණය වේ. → [ප්රත්යස්ථතා මාර්ගෝපදේශය](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 එක් විධානයකින් CLI/agent සැකසුම** — ලියාපදිංචි `setup-*` විධාන 13ක්; `omniroute run` මඟින් CLIs 7ක් (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) දියත් කරයි; `omniroute configure` අන්තර්ක්රියාකාරී provider+model තේරීමක් සහ එක් එක් context සඳහා favorites සමඟ targets 10කට සහාය දක්වයි. → [CLI ඒකාබද්ධ කිරීම්](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ දුරස්ථ මාදිලිය** — සීමා කළ tokens (`connect` / `contexts` / `tokens`) සහ VPS ස්ථාපන සඳහා `antigravity` OAuth සහායකයක් භාවිතයෙන් දුරස්ථ OmniRoute එකක් පාලනය කරන්න. → [දුරස්ථ මාදිලිය](docs/guides/REMOTE-MODE.md) - **🧭 වඩා බුද්ධිමත් ස්වයංක්රීය routing** — `auto/:` combos, **Fusion** (model panel + judge), කාර්යයට අනුව routing කිරීම සහ එක් එක් ඉල්ලීම සඳහා model / mode / USD-budget overrides. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ ප්ලග් කළ හැකි සම්පීඩනය** — සංයෝජනය කළ හැකි engines 12ක් + Compression Studios: LLMLingua-2, two-tier Ultra, omniglyph, එක් එක් පියවර සඳහා fidelity gate, GCF v3.2 සහ drag-reorder editor. → [සම්පීඩනය](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ පාරදෘශ්ය MITM විකේතනය (TPROXY)** — එක් එක් SNI සඳහා CA එකක් සහ trust-store installer එකක් සමඟ proxy env vars නොසලකා හරින CLIs ග්රහණය කරයි. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 සෑම තැනකම පිරිවැය telemetry** — සෑම endpoint එකකම `X-OmniRoute-*` පිරිවැය/භාවිත headers, cache-HIT ඉතිරි කිරීමේ header සහ එක් එක් key සඳහා USD වියදම් quotas. → [API යොමුව](docs/reference/API_REFERENCE.md) - **🧠 ඔබ පාලනය කරන මතකය** — පෙරනිමියෙන් අක්රියයි; කැමැත්තෙන් සක්රිය කළ හැකි int8 vector quantization + typed decay සහ එක් එක් ඉල්ලීම සඳහා `x-omniroute-no-memory`. → [මතකය](docs/frameworks/MEMORY.md) - **🛡️ ආරක්ෂාව** — සෑම LLM route එකකම prompt-injection guard එකක් (red-team suite), කැමැත්තෙන් සක්රිය කළ හැකි credential-masking guardrail එකක් (දෙපසටම කාන්දු වූ API keys/secrets සඟවයි), නොමිලේ DuckDuckGo අවසාන විකල්ප web search එකක් සහ dashboard සඳහා විකල්ප OIDC login gate එකක් (password login සැමවිටම ලබා ගත හැක). → [ආරක්ෂක සීමා](docs/security/GUARDRAILS.md) - **🖼️ නව endpoints** — `/v1/ocr` (Mistral OCR) සහ `/v1/audio/translations` (Whisper-style) මඟින් media surface එක සම්පූර්ණ කරයි. → [API යොමුව](docs/reference/API_REFERENCE.md) - **🎨 රූප / වීඩියෝ / ශ්රව්ය උත්පාදනය** — මාධ්ය සඳහා එක් API එකක්: xAI Grok Imagine සහ Novita AI වීඩියෝ, ComfyUI, Magnific, Adobe Firefly, Segmind සහ ElevenLabs වැනි කථන සැපයුම්කරුවන්. → [API යොමුව](docs/reference/API_REFERENCE.md) - **🌍 යෙදවීම සහ මෙහෙයුම්** — reverse-proxy `basePath`, browser භාෂාව ස්වයංක්රීයව හඳුනාගැනීම, එක් එක් key සඳහා device tracking, root රහිත MITM trust සහ zh-TW localization. → [පරිසරය](docs/reference/ENVIRONMENT.md) - **🤝 තවත් සැපයුම්කරුවන් සහ agents** — cloud agents (Codex Cloud, Cursor, Devin, Jules), browser + OAuth login සහිත Grok Build (xAI), පූර්ණ සහාය සහිත Ollama card, Claude Opus 5 සහ Sonnet 5, Kimi නිල හවුල්කාරිත්වය (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… සහ නැවුම් කළ **සැපයුම්කරුවන් 352ක catalog එකක්**. → [සැපයුම්කරුවන්](docs/reference/PROVIDER_REFERENCE.md) - **📡 Routing පාරදෘශ්යතාව** — සෑම ප්රතිචාරයකම එය සේවය කළ strategy/provider/latency නම් කරන `X-OmniRoute-Decision` header එකක් ඇත; නව `cache-optimized` combo strategy එකක් + Auto-Combo `cacheAffinity` factor එකක් මඟින් නැවත පැමිණෙන ඉල්ලීම් cached prefix එක දරන සම්බන්ධතාව වෙත යොමු කරයි; read-only `/v1/auto-combo/{channel}/candidates` endpoint එකක් `auto/*` channel එකක සජීවී candidate pool එක නිරාවරණය කරයි. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ දේශීය කාර්යසාධනය සහ යටිතල පහසුකම්** — එක් click එකකින් දේශීය 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 ඒකාබද්ධ කිරීම (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 නොමිලේ-සැපයුම්කරු ශ්රේණිගත කිරීම්. → [ලේඛන](docs/README.md)

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

_{📖 මෙවලම් 36 ම (CLI Code 26 ක් + CLI Agents 10 ක්) සඳහා එක් එක් මෙවලමට අදාළ සැකසුම් → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode ප්ලගිනය → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**එක් විධානයකින් OmniRoute හරහා සහාය දක්වන ඕනෑම CLI එකක් දියත් කරන්න** — වින්යාස ගොනු කිසිවක් ලියනු නොලැබේ, එක් එක් ක්රියාවලියට අක්තපත්ර ඇතුළත් කෙරෙන අතර, Qwen/Gemini සඳහා තාවකාලික හුදකලා 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 අන්තර්ක්රියාකාරීව තෝරා මෙවලමේම වින්යාසය ලියන්න: omniroute configure codex # මේවාද ඇත: claude opencode qwen aider goose gemini cline continue kilo ``` සෑම විධානයක්ම සක්රිය දුරස්ථ සන්දර්භයට (`omniroute connect `) අනුකූල වන අතර, `--dry-run` ක්රියාත්මක නොකර නිශ්චිත env/args පෙරදසුන් කරයි, තවද `--api-key-env NAME` මඟින් රහස් ඔබේ shell ඉතිහාසයෙන් බැහැරව තබයි. → [CLI ඒකාබද්ධ කිරීම්](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 AI සපයන්නන් 372ක් — නාමාවලියෙහි නොමිලේ ලෙස සලකුණු කළ 154ක්

> **ලියාපදිංචි කළ සපයන්නන් 372ක්** සම්මත කතාබස්, මාධ්ය, සෙවුම්, දේශීය, cloud-agent සහ පද්ධති එකතු හරහා පවතින අතර, ඒවායින් **154ක් `hasFree: true` සොයාගැනීමේ පාර-දත්ත දරයි**. කතාබස් ආකෘති ලේඛනය **සපයන්නන් 237ක් / වෙනස් සපයන්නා-ආකෘති යුගල 3,009ක් / අමු ආකෘති ID 1,443ක්** ආවරණය කරයි; වෙනම නොමිලේ අයවැය නාමාවලියෙහි **එක් එක් ආකෘතිය සඳහා පේළි 491ක්**, **පුනරාවර්තන සංචිත 35ක්** සහ **පුනරාවර්තන/යතුරු-රහිත සදාකාලික නොමිලේ සපයන්නන් 54ක්** ඇත. සැලසුම අනුව මේවා වෙනස් හරයන් වේ; අර්ථදැක්වීම් සහ සංචිත-අනුපිටපත් ඉවත් කළ ගණනය කිරීම් [සපයන්නන් පිළිබඳ යොමුව](docs/reference/PROVIDER_REFERENCE.md) සහ [නොමිලේ ස්තර](docs/reference/FREE_TIERS.md) තුළ ඇත.

### 🏢 සෑම ප්රධාන විද්යාගාරයක්ම — එක් අන්ත ලක්ෂ්යයක් හරහා

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

_{…සහ තවත් 330කට අධික සංඛ්යාවක් — සෑම නිරූපකයක්ම උපකරණ පුවරුවේ සපයන්නන්ගේ නාමාවලියෙන් සජීවීව ලබාගැනේ. 📖 [සපයන්නන් පිළිබඳ යොමුව](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 සදාකාලිකව නොමිලේ — $0, කාඩ්පතක් අවශ්ය නැත

OpenCode Zen _{DeepSeek V4, Nemotron 3 ටෝකන් සීමාවක් නැත}	Kilo Code _{ස්වයංක්රීය රවුටරය, Tencent Hy3 සදහටම නොමිලේ}	Requesty _{GPT-OSS 120B, Nemotron සදහටම නොමිලේ}	SiliconFlow _{DeepSeek V3.2 / R1 නොමිලේ ස්තරය}	Z.AI GLM _{GLM-4.7 / 4.5-Flash සදහටම නොමිලේ}	Baidu ERNIE _{ERNIE 4.0 සදහටම නොමිලේ}
Qoder AI _{Qwen3-Max, Kimi-K2 සීමාවකින් තොරව නොමිලේ}	Pollinations _{GPT, Llama, Claude යතුරක් අවශ්ය නොවේ}	Cloudflare AI _{මාදිලි 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 හරහා **ඔබේ දුරකථනය** දක්වා.

වේදිකාව	ස්ථාපනය	විශේෂාංග
📦 npm (ගෝලීය)	`npm install -g omniroute`	එක් විධානයක්, ඕනෑම මෙහෙයුම් පද්ධතියක්
🐳 Docker	`docker run … diegosouzapw/omniroute`	බහු-ගෘහනිර්මාණ සහාය AMD64 + ARM64
🖥️ ඩෙස්ක්ටොප් (Electron)	`npm run electron:build`	ස්වදේශීය කවුළුව + පද්ධති තැටිය — Windows / macOS / Linux
🎩 මෙනු තීරුව (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	සේවාදායකය අධීක්ෂණය කර ස්වයංක්රීයව යාවත්කාලීන කරයි — macOS
💪 ARM	ස්වදේශීය `arm64`	Raspberry Pi, ARM සේවාදායක, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	ඔබේ දුරකථනයේම 24/7 ක්රියාත්මක වේ, root අවශ්ය නැත
📲 PWA	"මුල් තිරයට එක් කරන්න"	පූර්ණ තිරය, නොබැඳි ක්රියාකාරිත්වය, බ්රවුසරයෙන් ස්ථාපනය කළ හැකිය
🧩 OpenCode ප්ලගිනය	`@omniroute/opencode-provider`	ස්වදේශීය OpenCode ඒකාබද්ධ කිරීම
🤖 VS Code Copilot Chat	OmniCopilot දිගුව ස්ථාපනය කරන්න	ස්වදේශීය Copilot Chat තේරීම්කාරකය තුළ සෑම OmniRoute ආකෘතියක්ම — ස්ථාවර & Insiders
🛠️ මූලාශ්රයෙන්	`npm install && npm run 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)}

### 🧩 නව: VS Code හි ස්වදේශීය Copilot Chat තුළ OmniRoute

> නව පැති තීරුවක් නැත, නව සංවාද අතුරුමුහුණතක් නැත — OmniRoute සපයන සෑම ආකෘතියක්ම ඔබ දැනටමත් භාවිත කරන > **Copilot Chat ආකෘති තේරීම්කාරකය තුළම** දිස් වේ. VS Code 1.122 සිට, සපයන්නාගේ ආකෘති > GitHub පිවිසුමක් හෝ Copilot දායකත්වයක් නොමැතිව ක්රියා කරයි — නියෝජිත ප්රකාරය, මෙවලම් ඇමතීම සහ දෘශ්ය හැකියාවන්, > නොමිලේ. **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** දිගුව ස්ථාපනය කර, එය ඔබේ OmniRoute සේවාදායකය වෙත යොමු කරන්න (පෙරනිමිය `localhost:20128`), ඉන්පසු Copilot Chat → ආකෘති තේරීම්කාරකය → **ආකෘති කළමනාකරණය කරන්න…** → **OmniRoute** විවෘත කරන්න.

ගබඩාව	සබැඳිය	ක්රියා කරන්නේ
🧩 VS Code Marketplace	ස්ථාපනය කරන්න →	VS Code — ස්ථාවර & Insiders
🔓 Open VSX Registry	ස්ථාපනය කරන්න →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

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

### 🎩 නව: OmniRouteTray — මෙනු තීරුවේ පවතින ඔබේ ද්වාරය

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

එය කරන දේ	කරන ආකාරය
🟢 සේවාදායකය අධීක්ෂණය කරයි	`omniroute serve` ආරම්භ කරයි, එය අනුපිටපත් කිරීම වෙනුවට දැනටමත් ක්රියාත්මක වන අවස්ථාවක් භාරගනී
📊 සජීවී භාවිතය එක් බැල්මකින්	සපයන්නාගේ කෝටා තීරු, යළි සැකසීමේ ගණන් බැසීම් සහිත Claude සැසි/සතිපතා සීමා, දින 30ක පිරිවැය විශ්ලේෂණය
🔄 එම ස්ථානයේම ස්වයංක්රීයව යාවත්කාලීන කරයි	අදියරගත ස්ථාපනය, පරමාණුක හුවමාරුව, අසාර්ථක වූ විට ආපසු පෙරළීම — සැමවිටම නවතම නිකුතුවේ
🚀 පිවිසීමේදී ආරම්භ කරන්න	පිවිසීමේදී විකල්ප ආරම්භ කිරීම; තැටියේ පමණක්, dock නිරූපකයක් නැත
🩺 පරීක්ෂාව & ලොග්	එක් ක්ලික් කිරීමකින් රෝග විනිශ්චය සහ සේවාදායක ලොග් වෙත ප්රවේශය

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{බාගත කිරීමක් කැමතිද? නවතම .dmg ගොනුව
නිකුතු වෙතින් ලබාගන්න. මූලාශ්ර කේතය, ගැටලු සහ ගොඩනැගීමේ
ලේඛන 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 # ද්වාරය + උපකරණ පුවරුව සපයන්න (port 20128) omniroute chat # අන්තර්ක්රියාකාරී TUI සංවාද සේවාලාභියා (slash: /model /combo /skill /memory) omniroute setup # මාර්ගෝපදේශිත පළමු-ධාවන විශාරදය omniroute doctor # සැපයුම්කරුවන්, ports සහ native dependencies රෝග නිර්ණය කරන්න ``` ### 🛰️ දුරස්ථ ප්රකාරය — CLI එක මෙහි ධාවනය කර, OmniRoute VPS එකක ධාවනය කරන්න OmniRoute සේවාදායකයක තිබේද? **එම CLI එකම** භාවිතයෙන් ඔබේ ලැප්ටොප් පරිගණකයෙන් එය මෙහෙයවන්න. විෂයපථගත ප්රවේශ token එකක් සමඟ එක් වරක් පිවිසෙන්න; ඉන්පසු සෑම විධානයක්ම දුරස්ථ පද්ධතිය ඉලක්ක කරයි. ```bash omniroute connect 192.168.0.15 # මුරපදය → විෂයපථගත token එක, context එකක් ලෙස සුරැකේ omniroute models list # ← දුරස්ථ සේවාදායකයට එරෙහිව ධාවනය වේ omniroute configure codex # ← දුරස්ථ model එකක් තෝරා, දේශීය Codex profile එකක් ලියයි omniroute tokens create --name ci --scope read # වෙනත් යන්ත්ර සඳහා වඩාත් සීමිත tokens නිකුත් කරන්න omniroute contexts use default # ← නැවත දේශීය සේවාදායකයට මාරු වන්න ``` Tokens `read` / `write` / `admin` ලෙස විෂයපථගත කර ඇත; ක්රියාවලි ආරම්භ කරන routes loopback සඳහා පමණක් සීමා වේ. _{📖 [දුරස්ථ ප්රකාරය](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI එක නිරූපණය කරන සජීවී terminal demo එකක් — omniroute providers list, omniroute combo list සහ omniroute health — විධාන 86කින් යුත් ඉහළ-මට්ටමේ පරාසය හරහා මාරුවෙමින්: 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 ස්වයංව පාලනය කරයි **MCP**, **A2A**, **REST API** එකක්, **webhooks** හෝ **දුරස්ථ CLI** එකක් හරහා OmniRoute නිරාවරණය කරන්න — හැකියාව ඇති ඕනෑම නියෝජිතයෙකුට (හෝ ඔබේම code එකට) සමස්ත ද්වාරයම ස්වයංක්රීයව පාලනය කිරීමේ හැකියාව ලැබේ: 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`	විෂයපථගත ප්රවේශ tokens සමඟ දුරස්ථ 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%ක් ඉතිරි කරන්න — ස්වයංක්රීයව

### 📖 එය ක්රියා කරන ආකාරය — නළ මාර්ගය, ගෘහ නිර්මාණය සහ ඉතිරිකිරීම් ගණනය

OmniRoute සම්පීඩන නළ මාර්ගය: ටෝකන 10,000ක නිදර්ශනාත්මක සේවාලාභී ඉල්ලීමක් — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra සහ OmniGlyph යන සංයෝජනය කළ හැකි එන්ජින් 12ක් හරහා ගමන් කර — ලේඛනගත ගොඩගැසූ උදාහරණයේදී ටෝකන 1,080ක් පමණ සමඟ සැපයුම්කරු වෙත ළඟා විය හැක. සංරක්ෂණ ආරක්ෂක සහ එක් එක් පියවරේ විශ්වාසනීයතා ද්වාර මඟින් ව්යුහගත අන්තර්ගතය ආරක්ෂා කෙරේ; පැහැදිලිව තෝරාගත් හානිදායක හෝ පර්යේෂණාත්මක ආකාර මඟින් සුදුසු අන්තර්ගතය පරිවර්තනය කළ හැක.

පෙරනිමි ගොඩගැසූ සංයෝජනය `RTK → Caveman` ධාවනය කරයි. දෙකම එකම මෙවලම්/සන්දර්භ payload එකක් මත ක්රියා කරන විට, ඉතිරිකිරීම් සංයුක්ත වේ: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` කේත කොටස්, URLs, JSON සහ ව්යුහගත දත්ත සංරක්ෂණ එන්ජිම මඟින් **සැමවිටම ආරක්ෂා කෙරේ**. > **ටෝකන කිහිපයකින් කාර්යය කළ හැකි විට ටෝකන බොහොමයක් භාවිත කරන්නේ ඇයි?** සෑම ඉල්ලීමක්ම OmniRoute හි සම්පීඩන නළ මාර්ගය හරහා **විනිවිදභාවයෙන්** ගමන් කරයි — සේවාලාභී වෙනස්කම් අවශ්ය නොවේ. දැන් එය අනුපිළිවෙළින් ධාවනය වන සහ එක් එක් මාර්ගගත කිරීමේ සංයෝජනයට අනුව මිශ්ර කර ගැළපිය හැකි **සංයෝජනය කළ හැකි එන්ජින් 12ක ගොඩකි** — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), සහ [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) වෙතින් ලැබුණු අදහස් මත ගොඩනැඟී ඇත. ### 🧱 එන්ජින් 12ක ගොඩ එන්ජින් නළ මාර්ග අනුපිළිවෙළට ධාවනය වේ; එක් එක් එන්ජිම සෑම සංයෝජනයක් සඳහාම ස්වාධීනව සක්රිය/අක්රිය කර වින්යාස කළ හැක:

#	එන්ජිම	එය කරන දේ
1	Session-Dedup	වාර අතර නැවත නැවත පෙනෙන අන්තර්ගතය ඉවත් කරයි (අන්තර්ගත-ලිපිනගත, වාර-හරහා)
2	CCR	විශාල කොටස් නැවත ලබාගැනීමේ සලකුණු පසුපස සංරක්ෂණය කර, අවශ්ය විට ලබාගනී
3	Lite	හිස් අවකාශ + රූප-URL කප්පාදුව (අඩු ප්රමාද මූලික මට්ටම)
4	RTK	බුද්ධිමත් මෙවලම්-ප්රතිඵල පෙරීම, අනුපිටපත් ඉවත් කිරීම සහ කප්පාදුව (විධාන-දැනුවත්)
5	Responses Tool Output	shell/patch/search/build ප්රතිදාන සඳහා අලාභ රහිත-ප්රමුඛ JSON + සීමා කළ රෝගනිශ්චය සම්පීඩනය (Responses API)
6	Headroom	අන්තර්ගත කළ GCF codec එකක් හරහා JSON arrays අලාභ රහිතව වගු ආකාරයට සංයුක්ත කිරීම (~30%)
7	Relevance	අවසාන පරිශීලක විමසුමට සාපේක්ෂව උද්ධරණාත්මක වාක්ය ලකුණු කිරීම
8	Caveman	රීති-පාදක ගද්ය සම්පීඩනය (ප්රතිදානයේ ~65–75%)
9	Aggressive	පැරණි වාරවල සාරාංශකරණය + ක්රමික වයස්ගත කිරීම
10	LLMLingua-2	MobileBERT ONNX හරහා ML අර්ථකථන කප්පාදුව — කේත-ආරක්ෂිත, අසමමුහුර්ත
11	Ultra	විකල්ප කුඩා-මාදිලි (SLM) ස්තරයක් සහිත හියුරිස්ටික් ටෝකන කප්පාදුව
12	OmniGlyph	සෘජු Anthropic සම්බන්ධතාවය මත මිනුම් කළ Claude Fable 5 සඳහා පර්යේෂණාත්මක සන්දර්භය-රූපයක්-ලෙස කේතනය කිරීම; සැපයුම්කරුගේ රිසිට්පත් ලැබෙන තෙක් GPT 5.6 transformers අසාර්ථක වූ විට වසා තබයි. සම්පීඩන පැතිකඩ හතරක් (පෙරනිමියෙන් aggressive, balanced, coding-safe, passthrough) (වඩාත්ම ආක්රමණශීලී; තෝරා සක්රිය කළ යුතුය)

කේත කොටස්, URLs සහ ව්යුහගත දත්ත **සැමවිටම බයිට් මට්ටමින් නිවැරදිව සංරක්ෂණය කෙරේ**. **එක්-ක්ලික් පෙරසැකසුම්** මඟින් එන්ජින් ඒකාබද්ධ කරයි:

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

**සැබෑ උදාහරණයක් — Standard ආකාරය:** > **පෙර (ටෝකන 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) ආකාරය:** > **පෙර (ටෝකන 42):** _"ගැටලුව වන්නේ සෑම රෙන්ඩර් කිරීමේ චක්රයකදීම නව object reference එකක් නිර්මාණය වන නිසා component එක නැවත රෙන්ඩර් වීමයි. මම useMemo භාවිත කිරීමට නිර්දේශ කරමි."_ > > **පසු (ටෝකන 12):** _"නැවත රෙන්ඩර් වීම: සෑම චක්රයකදීම නව ref එකක් (inline object එක නැවත නිර්මාණය වේ). `useMemo` භාවිත කරන්න."_ > > **එකම පිළිතුර. ටෝකන ~70%ක් අඩුයි. තාක්ෂණික නිරවද්යතාව නොවෙනස්.** ✅
### 🎚️ එන්ජින්වලින් ඔබ්බට — ප්රතිදාන ශෛලීන්, අනුවර්තී ඩයලය සහ එක් එක් ඉල්ලීම සඳහා පාලනය ඉහත එන්ජින් 12 මඟින් **ඇතුළට යන** දේ කුඩා කරයි. තවත් ස්තර තුනක් මඟින් **කෙසේද**, **කවදාද**, සහ **පිටතට එන්නේ කුමක්ද** යන්න හැඩගස්වයි: - **🪄 ප්රතිදාන ශෛලීන්** _(ප්රතිදාන අක්ෂය මෙහෙයවීම)_ — නිශ්චිත සහ cache-ආරක්ෂිත ප්රතිචාර-හැඩගැස්වීමේ උපදෙස් ඇතුළත් කරයි; ඒවා එකට යෙදිය හැකි අතර, එක් එක් ශෛලියට `lite` / `full` / `ultra` තීව්රතාවක් ඇත. ශෛලියක් එක් කිරීමට අවශ්ය වන්නේ registry එකට එක් පේළියක් එක් කිරීම පමණි: - **සංක්ෂිප්ත ගද්යය** — අතිරේක වචන / articles / අවිනිශ්චිත ප්රකාශ ඉවත් කරයි; තාක්ෂණික අන්තර්ගතය නිවැරදිව තබා ගනී. - **අඩු code** — "කම්මැලි ජ්යේෂ්ඨ සංවර්ධක" YAGNI: ක්රියාත්මක වන කුඩාම වෙනස, ඉල්ලා නැති scaffolding නැත. - **Ponytail (කම්මැලි ජ්යේෂ්ඨ සංවර්ධක)** — YAGNI ඉණිමඟ ඔස්සේ ඉහළට ගොස්, මූලික හේතුව නිවැරදි කර, ක්රියාත්මක වන කුඩාම diff එක යොදයි. - **මට ADHD තිබේ (ක්රියාව පළමුව)** — ඊළඟ ක්රියාව මුලින්ම, පියවර අංකනය කර, එක් නිශ්චිත ඊළඟ පියවරක් ලබා දෙයි, පෙරවදනක් නැත. - **සංක්ෂිප්ත CJK (文言)** — සම්භාව්ය චීන අතිශය සංක්ෂිප්ත ශෛලිය (`zh` locale එකට පමණක් සීමා කර ඇත). - **🎯 අනුවර්තී context-budget** _(ඩයලය)_ — එක් on/off ටෝකන සීමාවක් භාවිත කිරීම වෙනුවට, **මොඩලයේ context window එකට ගැළපීමට** අවශ්ය තරමට පමණක් අඩුම වියදම් සහිත, අවම තොරතුරු-හානියක් ඇති එන්ජින් ක්රමයෙන් යොදයි. ප්රතිපත්තිය: `reserve-output` (පෙරනිමි, මොඩලය පිළිබඳ දැනුවත්) · `percentage` · `absolute`. ප්රකාරය: `floor` (ගැළපීම සහතික කරයි) · `replace-autotrigger` (ඔබේ පැහැදිලි තේරීමට ප්රමුඛත්වය ලැබේ) · `off` (පැරණි threshold ක්රමය). - **🎛️ සම්පීඩනය තීරණය වන තැන** _(ප්රමුඛතා අනුපිළිවෙළ, ඉහළ → පහළ)_ — එක් එක් ඉල්ලීමේ `x-omniroute-compression` header එක › routing-combo override එක › සක්රිය නම් කළ profile එක › adaptive / auto-trigger › panel පෙරනිමිය › off. යෙදූ සැලැස්ම `X-OmniRoute-Compression: ; source=` ප්රතිචාර header එකෙහි නැවත දක්වයි. ටෝකන සීමාව අනුව auto-trigger කරන්න, adaptive dial එක ක්රියාත්මක කරන්න, නම් කළ profile එකක් ස්ථිර කරන්න, එක් ඉල්ලීමක් සඳහා පමණක් සැකසුමක් යොදන්න, හෝ එක් එක් routing combo එකට pipeline එකක් පවරන්න — කාර්ය භාරයට ගැළපෙන විකල්පය භාවිත කරන්න. වෙනසක් ප්රවර්ධනය කිරීමට පෙර, opt-in offline **eval harness** එකක් (`npm run eval:compression`) මඟින් ස්ථිර කළ corpus එකක් මත නිරවද්යතාව හා ඉතිරිය ඇගයීමට ලක් කරයි. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ ඉක්මන් ආරම්භය

**1) ස්ථාපනය කර ධාවනය කරන්න** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` හෝ peer-dep අනතුරු ඇඟවීම් පෙනෙනවාද? [ඒවා හානිකර නොවේ](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **npm 11 හෝ පසු අනුවාදයක් භාවිත කරනවාද?** අවසර දී නොමැති නම් npm විසින් package lifecycle scripts අවහිර කළ හැක. OmniRoute හි native runtime ගොනු සූදානම් කිරීමට එහි `postinstall` (`node scripts/build/postinstall.mjs`) අවශ්ය වේ. ගෝලීයව ස්ථාපනය කරන විට npm අනතුරු ඇඟවීමේ නම් කර ඇති packages සඳහා අවසර දෙන්න. OmniRoute 3.8.51 විසින් වාර්තා කරන ලද package කට්ටලය සඳහා: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > ඉදිරි ගෝලීය ස්ථාපනයන් සඳහා මෙම allowlist එක නැවත භාවිත කිරීමට, එය එක් වරක් configure කර, පසුව සාමාන්ය පරිදි ස්ථාපනය කරන්න: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > නිකුතු අතර dependency ලැයිස්තුව වෙනස් විය හැක; npm වෙනත් ලැයිස්තුවක් වාර්තා කරන්නේ නම්, එම අනතුරු ඇඟවීමේ ඇති package නම් භාවිත කරන්න. package එකකට අවසර දීමෙන් එහි install scripts ධාවනය කිරීමට ඉඩ ලැබේ. > **Gemini Web හෝ වෙනත් web-cookie provider එකක් භාවිත කරනවාද?** npm package එකට > Playwright ඇතුළත් නමුත් එහි Chromium binary එක ඇතුළත් නොවේ. පළමු web-provider ඉල්ලීම කිරීමට පෙර > [Playwright Chromium සැකසුම](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > පිළිබඳ සටහන බලන්න. Dashboard එක `http://localhost:20128` හිද · API එක `http://localhost:20128/v1` හිද ඇත. **2) ඔබේම ගිණුම භාවිත කර සුදුසු provider එකක් සම්බන්ධ කරන්න** Dashboard → **Providers** → වර්තමාන නියමයන් සහ quota එක ඔබේ භාවිත අවශ්යතාවට ගැළපෙන provider එකක් තෝරන්න → එහි API key එක එක් කරන්න හෝ එහි account flow එක සම්පූර්ණ කරන්න. Free tiers සඳහා ලියාපදිංචිය, අනුමැතිය, හෝ ගෙවීම් ක්රමයක් අවශ්ය විය හැක. [Free Tiers මාර්ගෝපදේශය](docs/getting-started/FREE-TIERS-GUIDE.md) සමාලෝචනය කරන්න; keyless ලබාගත හැකි බව සහතික කර නැති අතර, `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 තවමත් වඩාත් කැමති ක්රමයයි.
## 📦 තවත් ස්ථාපන ක්රම — 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-08-24 දින පැනලයේ ස්නැප්ෂොට් එක · අමු නාමාවලිය: YT 809 | TT 137 | IG 124 · නැවුම් බව (දින): YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — නැරඹීම් 3,042,474}

🎬 #2 — Instagram
_{theopenstack — නැරඹීම් 692,419}

🎬 #3 — TikTok
_{milesreevesai — නැරඹීම් 620,400}

🎬 #4 — YouTube
_{Vaibhav Sisinty — නැරඹීම් 391,109}

🎬 #5 — Instagram
_{buildwithai.club — නැරඹීම් 347,652}

**සම්පූර්ණ ශ්රේණිගත කිරීම (අනුපිටපත් ඉවත් කළ කැනොනිකල් URLs, `v > 0`, ඉහළම ප්රවේශය):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube කෙටි වීඩියෝ](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | 2026-08-24 දින කැනොනිකල් ප්රමිතික: **අද්විතීය වීඩියෝ 1.029ක්** · **දන්නා නැරඹීම් 11.132.922ක්** (`v > 0`) · **ජාලය අනුව නාලිකා/පැතිකඩ 639ක්**. අමු පැනලයෙහි පේළි 1.070ක් අඩංගුය; Instagram අනුපිටපත් 41ක් කැනොනිකල් URL අනුව සාමාන්යකරණය කර, එක් වීඩියෝවකට වැඩිම ගණන රඳවා තබා ඇත. > 🎬 **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 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/` පුරා 100% TypeScript (v2.0 සිට මූලික කොටසෙහි `any` කිසිවක් නැත)
රාමුව	Next.js 16 + React 19 + Tailwind CSS 4
දත්ත සමුදාය	better-sqlite3 (SQLite, WAL ජර්නලකරණය) + LowDB (පැරණි JSON) — වසම් මොඩියුල 137ක්, සංක්රමණ 202ක්
මතකය	SQLite FTS5 පූර්ණ-පෙළ + int8-ප්රමාණීකෘත දෛශික කාවැද්දීම්, වර්ගගත ක්ෂයවීම
ස්කීමා	Zod 4 — MCP මෙවලම් I/O වලංගුකරණය + API ගිවිසුම්
ප්රොටෝකෝල	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
ප්රවාහනය	Server-Sent Events (SSE) + WebSocket පාලම (`/v1/ws`)
සම්පීඩනය	එන්ජින් 12ක නළමාර්ගය — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
සත්යාපනය සහ ආරක්ෂාව	OAuth 2.0 (PKCE) + JWT + API යතුරු + MCP විෂයපථගත සත්යාපනය · නිශ්චල අවස්ථාවේ AES-256-GCM · DOMPurify
රහසිගතභාවය	wreq-js — JA3 / JA4 TLS ඇඟිලි සලකුණු අනුකරණය, මට්ටම් 3ක ප්රොක්සිය
ප්රත්යස්ථතාව	පරිපථ බිඳිනය, ඝාතීය පසුබැසීම, සමූහ ඉල්ලීම් වැළැක්වීම, ස්වයංක්රීය-සංයෝජන ස්වයං-ප්රතිසාධනය
ලොග්කරණය	pino — ඉල්ලීම් සන්දර්භය සහිත ව්යුහගත JSON ලොග්
පරීක්ෂණ	Node.js පරීක්ෂණ ධාවකය + Vitest — නිරීක්ෂණය කරන පරීක්ෂණ ගොනු 5,100කට වැඩි සංඛ්යාවක් පුරා ස්ථිතික පරීක්ෂණ ප්රකාශන 39,000කට වැඩි සංඛ්යාවක් (ඒකක, ඒකාබද්ධ, E2E, ආරක්ෂක, පරිසර පද්ධති)
වේදිකා	ඩෙස්ක්ටොප් (Electron) · Android (Termux) · PWA (ඕනෑම බ්රවුසරයක්)
CI/CD	GitHub Actions — නිකුතුවේදී ස්වයංක්රීය npm ප්රකාශනය + Docker Hub
සබැඳි	වෙබ් අඩවිය · npm · Docker Hub

## 📖 ප්රලේඛනය

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

ලේඛනය	විස්තරය
පරිශීලක මාර්ගෝපදේශය	සපයන්නන්, සංයෝජන, 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, උමං, පිළිබිඹු ටැග
Podman මාර්ගෝපදේශය	Quadlet systemd ඒකාබද්ධ කිරීම, podman-compose, SELinux
VM යෙදවීම	සම්පූර්ණ මාර්ගෝපදේශය: VM + nginx + Cloudflare පිහිටුවීම
Fly.io යෙදවීම	ස්ථිර ආචයනය සමඟ Fly.io වෙත යොදවන්න
Termux මාර්ගෝපදේශය	Termux හරහා Android මත OmniRoute ධාවනය කරන්න
PWA මාර්ගෝපදේශය	ප්රගතිශීලී වෙබ් යෙදුම් ස්ථාපනය, හැඹිලිගත කිරීම, ගෘහනිර්මාණය
අස්ථාපන මාර්ගෝපදේශය	සියලු ස්ථාපන ක්රම සඳහා පිරිසිදු ඉවත් කිරීම
පරිසර වින්යාසය	සම්පූර්ණ `.env` විචල්ය සහ යොමු

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

ලේඛනය	විස්තරය
ගෘහනිර්මාණය	පද්ධති ගෘහනිර්මාණය, දත්ත ප්රවාහය සහ අභ්යන්තර ක්රියාකාරීත්වය
සම්පීඩන මාර්ගෝපදේශය	විකල්ප 7ක නළමාර්ගය: අක්රිය / සැහැල්ලු / සම්මත / ආක්රමණශීලී / අතිශය / RTK / ගොඩගැසූ
RTK සම්පීඩනය	විධාන-ප්රතිදාන සම්පීඩනය, පෙරහන්, විශ්වාසය, සත්යාපනය, අමු-ප්රතිදාන ප්රතිසාධනය
සම්පීඩන එන්ජින්	Caveman, RTK, ගොඩගැසූ නළමාර්ග, උපකරණ පුවරු/API/MCP අතුරුමුහුණත්
සම්පීඩන රීති ආකෘතිය	Caveman සහ RTK පෙරහන් සඳහා JSON රීති-ඇසුරුම් පරිපාටි
සම්පීඩන භාෂා ඇසුරුම්	භාෂා හඳුනාගැනීම සහ Caveman රීති-ඇසුරුම් සම්පාදනය
ප්රත්යස්ථතා මාර්ගෝපදේශය	පරිපථ බිඳිනයන්, සිසිලන කාල, පෝලිම, සාමූහික හදිසි ඉල්ලීම් වැළැක්වීම, TLS ව්යාජකරණය
ස්වයංක්රීය-සංයෝජන එන්ජිම	සාධක 16ක ලකුණුකරණය, ප්රකාර ඇසුරුම්, ස්වයං-ප්රතිසාධනය
ප්රොක්සි මාර්ගෝපදේශය	මට්ටම් 3ක ප්රොක්සි පද්ධතිය, 1proxy වෙළඳපොළ, ලේඛනාගාර CRUD
නොමිලේ ස්ථර	ඒකාබද්ධ නාමාවලිය: ලේඛනගත පුනරාවර්තන සංචිත 35ක් / නාමාවලිගත නොමිලේ-ස්ථර ඇතුළත් කිරීම් 489ක්
විශේෂාංග ගැලරිය	තිර දසුන් සහිත දෘශ්ය උපකරණ පුවරු සංචාරය
කේත පදනම් ප්රලේඛනය	ආරම්භකයින්ට හිතකර කේත පදනම් මඟපෙන්වීම

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

ලේඛනය	විස්තරය
API යොමුව	උදාහරණ සහිත සියලු අන්ත ලක්ෂ්ය
OpenAPI පිරිවිතර	OpenAPI 3.0 පිරිවිතර
MCP සේවාදායකය	MCP මෙවලම් 110ක්, IDE වින්යාස, Python/TS/Go සේවාලාභීන්
MCP සේවාදායක මාර්ගෝපදේශය	MCP ස්ථාපනය, ප්රවාහන ක්රම සහ මෙවලම් යොමුව
A2A සේවාදායකය	JSON-RPC 2.0 ප්රොටෝකෝලය, කුසලතා, ප්රවාහකරණය, කාර්ය කළමනාකරණය
A2A සේවාදායක මාර්ගෝපදේශය	A2A නියෝජිත කාඩ්පත, කාර්ය, කුසලතා සහ ප්රවාහකරණය

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

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

# ⭐ ප්රමුඛ දායකයින් > OmniRoute හැඩගැසෙන්නේ උද්යෝගිමත් විවෘත-මූලාශ්ර ප්රජාවක් විසිනි. මෙම පුද්ගලයින් ව්යාපෘතියේ ගුණාත්මකභාවය, ස්ථාවරත්වය සහ ව්යාප්තිය කෙරෙහි සෘජුවම බලපාන සුවිශේෂී දායකත්වයන් ලබා දී ඇත. **ස්තුතියි.** ### ඒකාබද්ධ කළ pull request සංඛ්යාව අනුව බාහිර දායකයින්

ස්ථානය	දායකයා	ඒකාබද්ධ කළ PR	~වෙනස් කළ පේළි
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{2026-08-24 05:26:03 UTC දක්වා වූ ඒකාබද්ධ කිරීම් සමඟ, සජීවී release/v3.8.50 අග්රය වන dafb4ae808 හිදී ස්ථිතික කර ඇත. පිටුගත කළ GitHub GraphQL සංගණනයෙහි ඒකාබද්ධ කළ PR 5,911ක් අඩංගු වේ: ඉන් 2,707ක් ගබඩා හිමිකරුගෙන්ද, 179ක් Dependabot වෙතින්ද, 3,025ක් වෙනස් දායකයින් 535 දෙනෙකුගෙන් ලැබුණු බාහිර PR ද වේ. “වෙනස් කළ පේළි” යනු GitHub එක් කිරීම් + මකා දැමීම් වන අතර, ජනනය කළ ගොනු, lockfile, නාමාවලි, පරිවර්තන සහ ලේඛනද ඊට ඇතුළත් වේ; එය වෙනස්කම් ප්රමාණය මිස කර්තෘ විසින් ලියන ලද LOC නොවේ. කඩඉමේ ඇති සම ස්ථාන රඳවා ඇත.} ### GitHub වෙත ආරෝපිත commit

backryun _{🥇 GitHub වෙත ආරෝපිත commits 220ක්}	Paijo _{🥈 GitHub වෙත ආරෝපිත commits 219ක්}	Randi _{🥉 GitHub වෙත ආරෝපිත commits 108ක්}	Ravi Tharuma _{🏅 GitHub වෙත ආරෝපිත commits 81ක්}	Chris _{🏅 GitHub වෙත ආරෝපිත commits 70ක්}	Markus Hartung _{🏅 GitHub වෙත ආරෝපිත commits 69ක් · #6 සම තැන}
Dizzle _{🏅 GitHub වෙත ආරෝපිත commits 69ක් · #6 සම තැන}	Jan Leon _{🏅 GitHub වෙත ආරෝපිත commits 64ක්}	zenobit _{🏅 GitHub වෙත ආරෝපිත commits 62ක්}	Bob.Hou _{🏅 GitHub වෙත ආරෝපිත commits 51ක් · #10 සම තැන}	Xiangzhe _{🏅 GitHub වෙත ආරෝපිත commits 51ක් · #10 සම තැන}

_{2026-08-24 06:14:31 UTC දී නැවත පරීක්ෂා කරන ලදී: release/v3.8.50 පෙරනිමි ශාඛාව සඳහා repository Contributors API මඟින් වාර්තා කළ GitHub වෙත ආරෝපිත commits. API මඟින් අනන්යතා 525ක් (පරිශීලකයන් 415ක්, bots 2ක්, නිර්නාමික 108ක්) ලබා දෙන ලදී; මෙම වගුව නඩත්තුකරු, bots සහ නිර්නාමික අනන්යතා බැහැර කරන අතර තරගයේ සම ස්ථාන රඳවා ගනී. මෙය ඉහත ඇති ඒකාබද්ධ කළ PR ශ්රේණිගත කිරීමෙන් සහ පහත ඇති පුද්ගලයන් 639 දෙනෙකුගෙන් යුත් Git-metadata සංගණනයෙන් වෙනස් වේ.} > 🙏 මෙම දායකයන්ගේ විශේෂාංග, දෝෂ නිවැරදි කිරීම් සහ යටිතල පහසුකම් වැඩිදියුණු කිරීම් OmniRoute විශ්වාසදායක සහ විශේෂාංගවලින් පොහොසත් කරන දෙයෙහි **මූලික කොටසකි**. සෑම pull request එකක්ම, සෑම test case එකක්ම සහ සෑම i18n පරිවර්තන ගොනුවක්ම වැදගත් වේ. විවෘත මූලාශ්ර ගොඩනඟනු ලබන්නේ ඔවුන් වැනි පුද්ගලයන් විසිනි.

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

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

Andrew
_{💛 සක්රිය මාසික අනුග්රාහකයෙකි}

Vlad I
_{💛 සක්රිය මාසික අනුග්රාහකයෙකි}

Paco Cartones
_{💛 සක්රිය එක්වරක් පමණක් දායක වූ අනුග්රාහකයෙකි}

Prof. Igor Morais
_{💛 පෙර එක්වරක් පමණක් දායක වූ සහායකයෙකි}

longtao
_{💛 පෙර එක්වරක් පමණක් දායක වූ සහායකයෙකි}

_{… සහ පෞද්ගලිකව සිටීමට කැමති අනෙකුත් අය 💛} _{පොදු GitHub Sponsors 2026-08-24 දින නැවත වලංගු බව තහවුරු කරන ලදී. ඉහත සක්රිය ලේබල තීරණය කරන්නේ GitHub හි activeOnly තත්ත්වයයි; මීට පෙර හෙළිදරව් කළ, එක්වරක් පමණක් දායක වූ පොදු සහායකයින්ට දිගටම ස්තුතිය පළ කරන අතර, පෞද්ගලික අනුග්රාහකයින් නිර්නාමිකව පවතී.} 💖 අනුග්රාහකයෙකු වන්න → — සෑම ඩොලරයක්ම OmniRoute නොමිලේ සහ ස්වාධීනව පවත්වාගෙන යයි.

## 👥 දායකයින් 600කට වැඩි පිරිසක්

[![දායකයින්](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{ස්ථාවර කළ මූලික ac02c5b42f හිදී 2026-08-24 දින විගණනය කර, සජීවී release/v3.8.50 හි අවසන් dafb4ae808 මත නැවත පරීක්ෂා කරන ලදී: සාමාන්යකරණය කළ මානව Git අනන්යතා 639ක් — 407ක් commit කතුවරුන් ලෙස (නඩත්තුකරු ද ඇතුළුව) දිස්වන අතර, 232ක් දිස්වන්නේ පැහැදිලි Co-authored-by පසු සටහන්වල පමණි. මෙම සංගණනය GitHub noreply හැසිරවීම් සාමාන්යකරණය කරයි, bot/agent/service/placeholder අනන්යතා 26ක් බැහැර කරයි, සහ ඒවායේ ප්රදර්ශන නාම ගැළපෙන නිසා පමණක් සාමාන්ය විද්යුත් තැපැල් ලිපින ඒකාබද්ධ නොකරයි.} ### දායක වන ආකාරය 1. ගබඩාව fork කරන්න 2. **සක්රිය** `release/vX.Y.Z` අවසන් ලක්ෂ්යයෙන් (`main` වෙතින් නොව) ශාඛාවක් සාදන්න — [ශාඛාකරණ සහ නිකුතු ආකෘතිය](docs/ops/BRANCHING_MODEL.md) බලන්න 3. ඔබේ විශේෂාංග ශාඛාව සාදන්න (`git checkout -b feat/amazing-feature`) 4. ඔබේ වෙනස්කම් commit කරන්න (`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 එකක් ලෙස ආරම්භ විය — එතැන් පටන්, පහත දැක්වෙන සෑම උපපද්ධතියක්ම මුලින්ම එම ජයග්රහණය අත්කරගත් විවෘත මූලාශ්ර ව්යාපෘතියකින් ආභාසය ලැබීය. ඒ සෑම එකක්ම OmniRoute හි නිශ්චිත කොටසක් හැඩගැස්වීය. මේ ඒ සියල්ලටම අපගේ ස්තුතියයි. 🙏 > ⭐ තරු සංඛ්යා 2026 අගෝස්තු 24 දින GitHub හි REST API වෙතින් සත්යාපනය කරන ලදී — ගොස් මෙම ව්යාපෘතිවලට තරුවක් ලබා දෙන්න. මෙම සංඛ්යා නිශ්චිත දිනයකට අදාළ නිරවද්ය සැණරුවක් වන අතර කාලයත් සමඟ ස්වාභාවිකවම වෙනස් වනු ඇත. ### 🧬 පෙළපත සහ ද්වාරය

ව්යාපෘතිය	⭐	එය OmniRoute සඳහා ආභාසය ලබා දුන් ආකාරය
9router	26,161	මෙම fork එක ගොඩනඟා ඇති මුල් ව්යාපෘතියයි — මෙහිදී බහු-මාදිලි APIs සහ සම්පූර්ණ TypeScript නැවත ලිවීමක් සමඟ පුළුල් කර ඇත.
CLIProxyAPI	48,497	මෙම JavaScript / TypeScript port එකට ආභාසය ලබා දුන් Go ක්රියාත්මක කිරීම.
LiteLLM	57,100	එහි පොදු මිලකරණ දත්ත කට්ටලය අපගේ පිරිවැය-ලුහුබැඳීමේ සමමුහුර්තකරණයට දත්ත සපයන අතර, එහි සැපයුම්කරු-සාමාන්යකරණ ආකෘතිය අපගේ මාර්ගගත කිරීම හැඩගැස්වූ AI ද්වාරය.
codex-chatgpt-web	1,410	බ්රවුසර සැසිය, ප්රතිචාර රාමුකරණය, භාවිතය සහ වෙබ්-සෙවුම් ඇඩැප්ටර ඇතුළුව, vendored ChatGPT Web → Codex Responses සම්බන්ධකයට අනුවර්තනය කළ MIT මූලාශ්රය.
free-claude-code	48,112	ප්රවාහ ප්රතිසාධනය, no-thinking අන්වර්ථ නාම, අසාර්ථක වූ විට භාවිත වන වෙබ් සෙවුම, sliding-window සීමා, ලොග් සංවේදී දත්ත සැඟවීම සහ දැඩි කළ ආරම්භක ප්රවාහ වෙත port කළ රටා.
composer-api	322	ස්වදේශීය Cursor executor එකට අනුවර්තනය කළ Cursor Composer මෙවලම්-තේරීමේ, ප්රතිදාන-සීමාකරණ සහ මෙවලම්-තහවුරු කිරීමේ රටා.
codex-multi-auth	457	Codex OAuth නැවත සත්යාපනය වෙත port කළ නැවුම්-පිවිසුම් සහ refresh-token භ්රමණ රටා.
opencode-anthropic-auth	510	OmniRoute හි වින්යාසය-මඟින්-පාලනය වන සම්බන්ධකය තුළ සාමාන්යකරණය කළ Claude Code-අනුකූල පරිවර්තන පෙරනිමි සහ බිල්පත්-ශීර්ෂක හැසිරීම.
grok2api-merged	2	එහි Grok ආකෘති සිතියම්කරණ, ව්යාජ-TypeError Statsig ජනකය, ඉල්ලීම් සහ උපාංග පෙරනිමි, සහ NDJSON ප්රතිචාර සකසනය OmniRoute හි Grok Web executor එකට සැලකිය යුතු ලෙස අනුවර්තනය කරන ලදී.
TQZHR/grok2api	705	grok2api-merged පිටුපස ඇති ප්රධාන සංක්රාන්තික කේත මූලාශ්රය; එහි ආකෘති, ශීර්ෂක, payload, Statsig සහ සකසන ක්රියාත්මක කිරීම් Grok Web පෙළපත තුළ සුරැකී ඇත.
chenyme/grok2api	7,520	TQZHR සහ grok2api-merged හරහා ඉදිරියට ගෙන ආ Grok payload සහ උපාංග පෙරනිමි, Statsig ජනකය, සහ `result.response` සකසනය සඳහා වන යටිතල MIT මූලාශ්රය.
grok2api-pro	27	එහි proxy-pool ස්තරය සඳහා grok2api-merged විසින් ගෞරවය පිරිනැමූ සංක්රාන්තික මූලාශ්රයක්; OmniRoute එම පෙළපත් නිවේදනය සුරකින නමුත්, එහි සීමා කළ Grok Web executor එක තුළ proxy-pool port එකක් ඇති බවට හිමිකම් නොකියයි.
GrokProxy	50	එහි cookie-සත්යාපිත Grok proxy සහ `result.response.token` ප්රවාහ රටාව OmniRoute හි Grok Web ප්රවාහනය හැඩගැස්වීය.
GrokBridge	5	මුල් Grok Web ක්රියාත්මක කිරීම එහි HTTP/බ්රවුසර upstream සැලසුම විමසා බැලීය; එහි සෘජු HTTP මාර්ගය GrokProxy වෙතින් ව්යුත්පන්න වන බැවින්, ස්වාධීන කේත port එකක් ලෙස හිමිකම් නොකියයි.
grok-web-api	14	එහි Rust `ChatOptions` සහ ප්රතිචාර-ආවරණ schemas OmniRoute හි TypeScript Grok ඉල්ලීම් සහ ප්රවාහ-ප්රතිචාර වර්ග හැඩගැස්වීය.

### 🗜️ සන්දර්භ සහ token සම්පීඩනය — එන්ජින්

ව්යාපෘතිය	⭐	එය OmniRoute සඳහා ආභාසය ලබා දුන් ආකාරය
Caveman	100,538	ජනප්රිය වූ "වචන ඒකක ස්වල්පයකින් වැඩේ වෙනවා නම් බොහෝ වචන ඒකක භාවිත කරන්නේ ඇයි" ව්යාපෘතිය — එහි ගුහාමානව කථන දර්ශනය අපගේ සම්මත සම්පීඩන ප්රකාරයට සහ පිරවුම්/සංක්ෂේපණ නීති 30කට වැඩි ගණනකට බලය සපයයි.
RTK – Rust Token Killer	77,185	ඉහළ කාර්යසාධනයක් සහිත විධාන-ප්රතිදාන සම්පීඩනය — අපගේ RTK එන්ජිම, JSON පෙරහන් DSL, අමු ප්රතිදාන ප්රතිසාධනය සහ ස්තරගත RTK → Caveman නළමඟ සඳහා ආභාසය ලබා දුන්නේය.
headroom	67,310	ප්රතිවර්ත්ය සන්දර්භ-සම්පීඩනය (SmartCrusher) — අපගේ `headroom` එන්ජිම සහ `ccr` ප්රතිසාධන-සලකුණු රටාව සඳහා ආභාසය ලබා දුන්නේය.
LLMLingua	6,598	ප්රේරක-සම්පීඩන පර්යේෂණය (LLMLingua / LLMLingua-2) — අපගේ අසමමුහුර්ත, කේත-ආරක්ෂිත, විවෘතව අසාර්ථක වන `llmlingua` එන්ජිම සඳහා ආභාසය ලබා දුන්නේය.
llmlingua-2-js	31	අපගේ LLMLingua එන්ජිම සඳහා worker-thread පසුඅන්තය ලෙස භාවිත කරන JS/ONNX පෝට් එක (MobileBERT / XLM-RoBERTa).
Troglodita	40	PT-BR වචන ඒකක සම්පීඩනය — අපගේ pt-BR භාෂා පැකේජයට බලය සපයයි: බ්රසීලියානු-පෘතුගීසි ව්යාකරණයට ගැළපෙන ලෙස සකස් කළ අතිරික්ත ප්රකාශන අඩු කිරීම සහ පිරවුම් ඉවත් කිරීම.
ponytail	108,957	ජනප්රිය වූ "කම්මැලි ජ්යෙෂ්ඨ සංවර්ධක" YAGNI කේතකරණ හැකියාව — අපගේ less-code ප්රතිදාන ශෛලිය සඳහා ආභාසය ලබා දුන්නේය: _ජනනය කරන_ කේතය අඩු කරන, ක්රියාකරන කුඩාම වෙනස වෙත මෙහෙයවීම (Caveman හි සංක්ෂිප්ත ගද්යයට ප්රතිදාන-අක්ෂයේ සමප්රභවයා).
i-have-adhd	23,526	එහි ක්රියාව-ප්රමුඛ, ADHD-හිතකාමී ප්රතිචාර ශෛලිය භාෂා පහක් පුරා OmniRoute හි සංක්ෂිප්ත ප්රතිදාන ශෛලියට අනුවර්තනය කරන ලදී.

### 🧩 සංක්ෂිප්ත ආකෘති, වචන ඒකක පර්යේෂණ සහ කේත-සංවේදී මෙවලම්

ව්යාපෘතිය	⭐	එය OmniRoute සඳහා ආභාසය ලබා දුන් ආකාරය
TOON	25,233	වචන ඒකක-අභිමුඛ වස්තු අංකනය — එහි තීරුමය, ශීර්ෂක-සහ-පේළි ආකෘතිය අපගේ වගුමය සංක්ෂිප්තකරණ අදියර හැඩගැස්වීය.
GCF – Graph Compact Format	41	එහි සංක්ෂිප්ත ප්රස්තාර ආකෘතිය සහ සාමාන්ය-පැතිකඩ සැලසුම OmniRoute හි වගුමය සංක්ෂිප්තකරණයට සහ Headroom කෝඩෙක් ආකෘතියට මඟ පෙන්වීය.
gcf-typescript	4	Headroom සාමාන්ය-පැතිකඩ කෝඩෙක් එක ලෙස සෘජුවම ව්යාපෘතිය තුළට ඇතුළත් කර විස්තාරණය කළ MIT TypeScript ක්රියාත්මක කිරීම.
token-optimizer-mcp	494	Brotli/SQLite හැඹිලිය + සැසියකට සන්දර්භ-වෙනස — අපගේ `session-dedup` එන්ජිම සඳහා ආභාසය ලබා දුන්නේය.
token-savior	1,122	Bash-ප්රතිදාන සංක්ෂිප්තකරණය + MCP පැතිකඩ — අපගේ සම්පීඩන අත්හැරීමේ විනය සහ MCP මෙවලම්-ප්රකාශිත අඩු කිරීම සඳහා ආභාසය ලබා දුන්නේය.
token-saver	138	අසාර්ථකත්වය පිළිබඳ අවබෝධයක් සහිත අත්හැරීම සමඟ, ගොනු වර්ගයකට අදාළ අන්තර්ගත-සංවේදී ප්රතිදාන සම්පීඩනය — අපගේ වර්ගය අනුව යොමු කිරීම සහ අවම-ලාභ මඟහැරීම තහවුරු කළේය.
token-optimizer	1,951	"අදිසි වචන ඒකක සොයන්න" — එහි පිටතට පැවරීමේ + ප්රතිසාධනය කළ හැකි හැන්ඩ්ල් රටාව අපගේ CCR පිටතට පැවරීමේ චින්තනයට මඟ පෙන්වීය.
TokenMizer	28	අපගේ session-dedup සැලසුමට මඟ පෙන්වූ සැසි-ප්රස්තාර + වාර අතර පේළි-අනුපිටපත් ඉවත් කිරීමේ සැලැස්මක්.
OmniCompress	3	Rust තීරුමය-JSON + අන්තර්ගතය අනුව ආමන්ත්රණය කළ ප්රතිසාධනය + පණිවිඩ අතර අනුපිටපත් ඉවත් කිරීම — අපගේ `headroom`/`ccr`/`session-dedup` එන්ජින් සැලසුම සහ හැඹිලි-ස්ථායී "සම්පීඩිත ආකෘතිය පිහිටීමෙන් ස්වායත්තය" යන අපරිවර්තකය තහවුරු කළේය.
mcp-compressor	113	MCP මෙවලම්-ස්කීමා/විස්තර සම්පීඩනය — අපගේ MCP මෙවලම්-ප්රකාශිත කාඩිනැලිටි අඩු කිරීමට මඟ පෙන්වීය.
RepoMapper	197	Aider-ශෛලියේ ගබඩා-සිතියම් ශ්රේණිගත කිරීම — අපගේ ගබඩා-සිතියම් / ප්රතිසාධන-ශ්රේණිගත කිරීමේ ගවේෂණයට මඟ පෙන්වීය.
quiet-shell-mcp	4	MCP හරහා ප්රකාශනමය shell-ප්රතිදාන අඩු කිරීම — අපගේ ප්රකාශනමය bash-ප්රතිදාන සංක්ෂිප්තකරණය තහවුරු කළේය.
ts-morph	6,162	TypeScript Compiler API මෙවලම් කට්ටලය — string, template සහ regex literals සුරකින අපගේ parser-පාදක අදහස් ඉවත් කිරීම සඳහා ආභාසය ලබා දුන්නේය.

### 🧠 මතකය සහ RAG

ව්යාපෘතිය	⭐	එය OmniRoute සඳහා ආභාසය ලබා දුන් ආකාරය
Mem0	63,902	සාර්වත්රික මතක ස්තරය — එහි proxy-as-write/read-boundary ආකෘතිය අපගේ මතක ගෘහනිර්මාණය හැඩගැස්වීය.
Letta (MemGPT)	24,382	ස්තරගත මතකය සහිත තත්ත්වය රඳවාගන්නා නියෝජිතයන් — අපගේ Context Control & Recovery (CCR) ස්තරගත ආකෘතිය සඳහා ආභාසය ලබා දුන්නේය.
WFGY	1,781	නැවත නැවත ඇතිවන RAG/LLM අසාර්ථකත්ව ආකාර 16ක් සඳහා වන ProblemMap වර්ගීකරණය — අපගේ දෝෂ නිරාකරණ මාර්ගෝපදේශයේ භාවිත වන පොදු පාරිභාෂික පද මාලාවයි.

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

ව්යාපෘතිය	⭐	එය OmniRoute සඳහා ආභාසය ලබා දුන් ආකාරය
llm-interceptor	66	කේතකරණ සහායක ↔ LLM තදබදයේ MITM අන්තර්ග්රහණය/විශ්ලේෂණය මුල් Traffic Inspector අවශ්යතා නිර්ණය කිරීමට දායක විය. පෙර ව්යුත්පන්න කර තිබූ මොඩියුල හතරක් — SSE ඒකාබද්ධ කිරීම, සංවාද සාමාන්යකරණය, රහස් ආවරණය සහ header පිරිසිදු කිරීම — පොදු protocol ප්රමිතීන් මත පදනම් වූ ස්වාධීන clean-room ක්රියාත්මක කිරීම් මඟින් ප්රතිස්ථාපනය කර ඇත. host-passthrough අතුරුමුහුණත් දෙක (`passthrough.ts` සහ `_internal/bypass.cjs`) ස්වාධීනව වර්ගීකරණය කරන ලද OmniRoute-අභ්යන්තර ක්රියාත්මක කිරීම් ලෙස පවතී; එම ප්රතිස්ථාපනයේ කොටසක් ලෙස ඒවා නැවත ලියනු ලැබුවේ නැත.
ProxyBridge	5,995	එක් එක් ක්රියාවලිය සඳහා පාරදෘශ්ය proxy මාර්ගගත කිරීම — අපගේ බිඳවැටීම්-ආරක්ෂිත MITM විසුරුවා හැරීම, socket අක්රියතා කාලසීමා, `/proc` ක්රියාවලි ආරෝපණය සහ TPROXY ග්රහණය සඳහා ආභාසය ලබා දුන්නේය.

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

ව්යාපෘතිය	⭐	එය OmniRoute සඳහා ආභාසය ලබා දුන් ආකාරය
models.dev	6,555	AI ආකෘති පිරිවිතර, මිලකරණය සහ හැකියාවන් පිළිබඳ විවෘත දත්ත සමුදාය — අපගේ ආකෘති නාමාවලිය වෙත ස්වදේශීයව සමමුහුර්ත කර ඇත.
React Flow / xyflow	38,108	අපගේ තත්යකාලීන Compression Studio සහ Combo/Routing Studio බලගන්වන node-පාදක graph පුස්තකාලයයි.
LangGraph	40,314	LangGraph Studioහි සජීවී workflow-graph දෘශ්යකරණය අපගේ Studiosවල තත්යකාලීන cascade දසුන සඳහා ආභාසය ලබා දුන්නේය.
Langfuse	33,592	එහි trace → span → generation නිරීක්ෂණ ආකෘතිය අපගේ Compression Studio waterfall දසුන හැඩගැස්වීය.
Kiali	3,631	Istio service-mesh නිරීක්ෂණ හැකියාව — Routing/Combo Studio තුළ අපගේ circuit-breaker ලාංඡන සහ දෝෂ-edge දෘශ්ය සඳහා ආභාසය ලබා දුන්නේය.
lobe-icons	2,428	අපගේ උපකරණ පුවරුව පුරා සැපයුම්කරු අයිකන පෙන්වන AI/LLM සන්නාම ලාංඡන.
flag-icons	12,354	README භාෂා තේරීම මඟින් භාවිත කරන MIT-බලපත්රලාභී SVG ධජ සපයයි.

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

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

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

ව්යාපෘතිය	⭐	එය OmniRoute සඳහා ආභාසය ලබා දුන් ආකාරය
ClawRouter	6,564	ඉල්ලීම් අනුපිටපත් ඉවත් කිරීම, හදිසි ශුන්ය-පිරිවැය විකල්ප මාර්ගය, සම්බන්ධ කළ හැකි Auto-Combo උපායමාර්ග සහ බහුභාෂා අභිප්රාය වර්ගීකරණය සඳහා ආභාසය ලබා දුන්නේය.
Antigravity-Manager	30,652	එහි ගිණුම්-දැනුවත් ආකෘති නැවත සිතියම්ගත කිරීම, ක්රියාත්මක කළ හැකි ගොනු මාර්ග සත්යාපනය සහ සැලසුම්-label හැසිරීම OmniRouteහි Antigravity runtime සඳහා මඟ පෙන්වීය.
vscode-antigravity-cockpit	4,817	එහි සංක්ෂිප්ත quota-reset පසුගණන් ආකෘතිය OmniRouteහි අදාළ සැපයුම්කරු-සීමා සංදර්ශකය සඳහා ආභාසය ලබා දුන්නේය.
AionUi	32,230	එහි ACP ඒකාබද්ධ කිරීම් OmniRouteහි ස්ථාපිත CLI නියෝජිතයන් ස්වයංක්රීයව හඳුනාගැනීම සඳහා ආභාසය ලබා දුන්නේය.
CodexBar	20,507	Grok Build quota අතුරුමුහුණත හඳුනාගත්තේය; ඉන්පසු OmniRoute සජීවී wire format එක ස්වාධීනව සත්යාපනය කර නිවැරදි කළේය.

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

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