## 💰 மூன்றாம் தரப்பு இலவச அடுக்குகள் முழுவதும் ~1.62B டோக்கன்கள் / மாதம்
> **உங்கள் சொந்த வழங்குநர் கணக்குகளைக் கொண்டு வாருங்கள்.** இது தனித்தனியாகத் தகுதிபெறும் மூன்றாம் தரப்பு இலவச அடுக்குகளின் மதிப்பிடப்பட்ட மொத்தமாகும்; OmniRoute வழங்கும் டோக்கன் மானியம் அல்ல. பதிவுசெய்து, தேவையான இடங்களில் நற்சான்றுகளைப் பெற்று, நீங்கள் பயன்படுத்தக்கூடிய வழங்குநர்களை இணைக்கவும்; ஒவ்வொரு வழங்குநரும் அதன் வரம்புகள், கிடைக்கும் தன்மை மற்றும் விதிமுறைகளைக் கட்டுப்படுத்துகிறது.
>
> இலவச அடுக்குகளை கைமுறையாக ஒன்றிணைப்பது கடினமானது — டஜன் கணக்கான SDK-கள், டஜன் கணக்கான வீத வரம்புகள், மேலும் உண்மையில் உங்களிடம் எவ்வளவு உள்ளது என்பதே தெரியாது. OmniRoute, **மீண்டும் நிகழும் 35 pool key-களில் உள்ள 489 இலவச-அடுக்கு பதிவுகளை** பட்டியலிட்டு, பகிரப்பட்ட pool அடிப்படையில் நகல்களை நீக்கி, **வெளியிடப்பட்ட நேர்மறையான மாதாந்திர பட்ஜெட்டைக் கொண்ட 17 pool-கள் மற்றும் ஒரு model-க்கு ஐந்து Groq உச்சவரம்புகளிலிருந்து** டோக்கன் மொத்தத்தைக் கணக்கிடுகிறது. பிராந்திய அடையாளச் சரிபார்ப்புக்குப் பிறகு மட்டுமே திறக்கப்படும் ஒதுக்கீடுகள் (தற்போது: ModelScope) தனியாகக் காட்டப்படுகின்றன; பிராந்திய அடையாளச் சரிபார்ப்பிற்குப் பின்னால் +~6M உள்ளது, அது முதன்மை மொத்தத்தில் ஒருபோதும் சேர்க்கப்படாது. அதன் முடிவு டாஷ்போர்டில் (`/dashboard/free-tiers`) தொடர்ந்து காணக்கூடியதாக இருக்கும்.
> நேரலை `/dashboard/free-tiers` பக்கத்தின் அனிமேஷன் செய்யப்பட்ட சுருக்கம். முழுமையான வழிமுறை (pool நகல் நீக்கம், கிரெடிட் அடுக்குகள், வழங்குநர் விதிமுறைகள்): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> இந்த எண்ணிக்கைகள் நேரலைப் பட்டியலுடன் ஒப்பிட்டு ஒவ்வொரு இரண்டு வாரங்களுக்கும் மறுதணிக்கை செய்யப்படுகின்றன, மேலும் அவை **இரு திசைகளிலும் மாறும்** — ஒரு வழங்குநர் இலவச அடுக்கை நிறுத்தினால் எண்ணிக்கை குறையும்; புதிய ஒன்று சேர்ந்தால் அது உயரும். பட்டியல் உண்மையில் கணக்கிடுவதையே நாங்கள் வெளியிடுகிறோம்; மேல்நோக்கி வட்டமிடப்பட்ட மிகச் சிறந்த சாத்தியமான மதிப்பை ஒருபோதும் வெளியிடுவதில்லை.
⭐ OMNIROUTE பணத்தைச் சேமிக்கவும் உங்கள் வேலையை எளிதாக்கவும் உதவியிருந்தால் repo-க்கு Star அளியுங்கள்.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 சமூகத்தில் இணையுங்கள்
**👋 பராமரிப்பாளரைப் பின்தொடருங்கள் — புதிய வழங்குநர்கள், வெளியீடுகள் மற்றும் உதவிக்குறிப்புகளை முதலில் பெறுங்கள்:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**கேள்விகள், வழங்குநர் உதவிக்குறிப்புகள், செயல்திட்டம் மற்றும் ஆதரவு → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 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)**
## 📈 கேட்வே தொடர்ந்து வளர்கிறது
## 🆓 நிறுவி, ஒரு வழங்குநரை இணைத்து, பின்னர் ஒரே எண்ட்பாயிண்ட் வழியாக ரூட் செய்யுங்கள்
```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?
## 🤝 எங்கள் திறந்த மூல நண்பர்களால் ஆதரிக்கப்படுகிறது
> **திறந்த மூல நண்பராக சேர விரும்புகிறீர்களா?** இவை திறந்த மூலத்தை ஆதரிக்கும் நிறுவனங்கள் மற்றும் ஆம்னிரூட்டை தொடர்ந்து இயங்க உதவுகின்றன — மேலும் அவர்கள் எங்களுக்கு வழங்கும் ஒவ்வொரு டோக்கனும் எங்கு செல்கிறது என்பதை நாங்கள் பகிரங்கமாக கூறுகிறோம். தொடர்பு கொள்ளவும்: [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 விசை). Kimi இன் ஆதரவு திட்டத்தில் முதல் பிரேசிலிய திறந்த மூல திட்டமும் OmniRoute ஆகும். 15% கூடுதல் கிரெடிட்களுடன் Kimi API விசையைப் பெறுங்கள் →
Cheaper Inference cheaperinference.com
இந்த திட்டத்தை ஆதரித்த OmniRoute திறந்த மூல நண்பரான Cheaper Inference க்கு நன்றி! Cheaper Inference என்பது ஒரு செலவு-தரவரிசைப்படுத்தப்பட்ட நுழைவாயில் ஆகும், இது 42 முன்னணி மாடல்களை மறுவிற்பனை செய்கிறது — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok மற்றும் MiniMax — ஒரு 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 இலவச கிரெடிட்கள் (இலவச சர்வர், அதிக தாமதத்தை எதிர்பார்க்கலாம் — சோதனைக்கு சிறந்தது, உற்பத்திக்கு அல்ல). OmniRoute இல் v3.8.50 முதல் முதல்-வகுப்பு ஆதரவு: Chat Completions, Anthropic-இணக்கமான கம்பி வடிவம் மற்றும் OpenAI-இணக்கமான பாதை. கிடைக்கும் மாடல்களில் claude-opus-4-8, claude-opus-5, gpt-5.6-sol மற்றும் பல அடங்கும். $100 ஐப் பெறுங்கள் →
⚠️ துணை இணைப்பு — OmniRoute இந்த வழங்குநருடன் எந்த ஸ்பான்சர்ஷிப் அல்லது கூட்டாண்மையையும் கொண்டிருக்கவில்லை.
OmniRoute பயனர்களுக்கு பயனளிக்கும் ஒரு தாராளமான இலவச பதிவு கூப்பனுடன் மற்றொரு வழங்குநரைத் தெரியுமா? ஒரு சிக்கலைத் திறந்து, அதை இங்கே சேர்ப்போம்.
## 🎯 காம்போக்கள் — முதன்மை அம்சம்
> ஒரு **காம்போ** என்பது OmniRoute **தானாகவே** வழிச்செலுத்தும் மாடல்களின் சங்கிலியாகும். ஒதுக்கீடு தீர்ந்துவிட்டாலோ, வழங்குநர் செயலிழந்தாலோ அல்லது செலவுகள் திடீரென அதிகரித்தாலோ, காம்போ அடுத்த தகுதிவாய்ந்த, சீராக இயங்கும் மாடலுக்கு நகர முடியும். 🛡️
### ⚡ உள்ளமைவு தேவையில்லை — `auto`-ஐ மட்டும் பயன்படுத்தவும்
காம்போவை உருவாக்கத் தேவையில்லை. உங்கள் மாடலை `auto` (அல்லது அதன் ஒரு மாற்று) என அமைக்கவும்; இணைக்கப்பட்டுள்ள உங்கள் வழங்குநர்களிலிருந்து OmniRoute ஒரு மெய்நிகர் காம்போவை உருவாக்கி, நேரடியாக மதிப்பிடும்:
மாடல் ID
இது எதற்காக உகப்பாக்கப்படுகிறது
auto
🎯 சமநிலையான இயல்புநிலை (LKGP — கடைசியாகச் சிறப்பாகச் செயல்பட்ட உங்கள் வழங்குநரையே தொடர்ந்து பயன்படுத்தும்)
auto/coding
🧑💻 குறியீடு உருவாக்குவதற்கான தரத்திற்கு முன்னுரிமையளிக்கும் எடைகள்
auto/fast
⚡ மிகக் குறைந்த தாமதத்திற்கு முதல் முன்னுரிமை
auto/cheap
💰 ஒரு டோக்கனுக்கான மிகக் குறைந்த செலவுக்கு முதல் முன்னுரிமை
auto/offline
🔋 அதிக ஒதுக்கீடு / விகித வரம்பு இருப்பிற்கு முதல் முன்னுரிமை
auto/smart
🔭 தரத்திற்கு முன்னுரிமை + சிறந்த மாடல்களைக் கண்டறிய 10% ஆய்வு
auto/lkgp
📌 கடைசியாகச் சிறப்பாகச் செயல்பட்ட வழங்குநரைத் தொடர்ந்து பயன்படுத்துவதற்கான வெளிப்படையான அமைப்பு
auto/chaos
🧪 மாடல்களின் குழுவிற்கான இணையான விரிவாக்கம் (ஒவ்வொரு வழங்குநருக்கும் ஒன்று, இயல்பாக 5), ஓர் பதிலைத் திருப்பியளிக்கும்; குழுவிலுள்ள ஒவ்வொரு மாடலுக்கும் ஓர் மேல்நிலை அழைப்பு, இது பிழை உட்செலுத்தல் அல்ல
##
### 🔀 அல்லது உங்களுக்கானதை உருவாக்குங்கள் — 19 வழிச்செலுத்தல் உத்திகள்
**19** உத்திகளையும் ஒவ்வொரு காம்போ படிநிலையிலும் கலந்து பொருத்தலாம்:
#
உத்தி
இது என்ன செய்கிறது
1
priority
முதல் இலக்கிற்கு முன்னுரிமையளிக்கும் வரிசைப்படுத்தப்பட்ட பட்டியல் — அடுத்ததற்குச் செல்லும் முன் ஒவ்வொன்றையும் முழுமையாகப் பயன்படுத்தும் 🥇
2
fill-first
அடுத்த இலக்கிற்குச் செல்லும் முன் ஒவ்வொரு இலக்கின் ஒதுக்கீட்டையும் முழுமையாகப் பயன்படுத்தும்
3
weighted
ஒவ்வொரு இலக்கின் எடையின் அடிப்படையிலான எடையிட்ட சீரற்ற தேர்வு
4
round-robin
இலக்குகளை வரிசையாகச் சுழற்சி முறையில் பயன்படுத்தும்
5
p2c
இரண்டு தேர்வுகளின் சக்தியைப் பயன்படுத்தும் சீரற்ற சுமை சமநிலைப்படுத்தல்
6
least-used
தற்போது மிகக் குறைந்த சுமையைக் கொண்ட இலக்கைத் தேர்ந்தெடுக்கும்
7
random
சீரான சீரற்ற தேர்வு (நகல்கள் நீக்கப்படும்)
8
strict-random
மீள்தோன்றல்களை நகல் நீக்கம் செய்யாமல் சீரற்ற முறையில் தேர்ந்தெடுக்கும் 🎲
9
cost-optimized
நேரடி பட்டியல் விலையிடலின் அடிப்படையில் ஒரு கோரிக்கைக்கான $ செலவைக் குறைக்கும் 💸
10
headroom
அதிக மீதமுள்ள ஒதுக்கீட்டைக் கொண்ட இலக்கைத் தேர்ந்தெடுக்கும்
11
reset-window
ஒதுக்கீட்டுச் சாளரம் மிக விரைவில் மீட்டமைக்கப்படும் இலக்கிற்கு முன்னுரிமை அளிக்கும்
12
reset-aware
ஒதுக்கீட்டு மீட்டமைப்பு நேரத்தின்படி தரவரிசைப்படுத்தும் — குறுகிய சாளரங்களுக்கு முதல் முன்னுரிமை 📊
13
context-relay
நீண்ட உரையாடல்களுக்காக இலக்குகளுக்கிடையே சூழலைக் கைமாற்றும் 🧠
14
context-optimized
தற்போதைய சூழல் அளவிற்கு மிகப் பொருத்தமானதைத் தேர்ந்தெடுக்கும்
15
cache-optimized
மீண்டும் பயன்படுத்தக்கூடிய ஒவ்வொரு அறிவுறுத்தல் முன்னொட்டையும் அதே கணக்குடன் நிலைநிறுத்தும் — அறிவுறுத்தல் தற்காலிகச் சேமிப்பு பொருத்தங்களைக் கூடியபட்சமாக்கும் 🎯
16
lkgp
கடைசியாகச் சிறப்பாகச் செயல்பட்ட பாதை — கடைசியாக வெற்றிபெற்ற வழங்குநருடன் நிலைநிறுத்தி, பின்னர் விதிகளுக்குப் பின்னடையும்
17
auto
ஒவ்வொரு இணைப்பிலும் 16 காரணிகளைக் கொண்ட நேரடி மதிப்பீடு 🤖
18
fusion
மாடல்களின் குழுவிற்கு விரிவாக்கும் + ஒரு தீர்ப்பாளர் ஒரே பதிலை ஒருங்கிணைப்பார் 🧬
19
pipeline
படிநிலைகளைச் சங்கிலியாக்கும் — ஒவ்வொரு இலக்கின் வெளியீடும் அடுத்ததற்கு உள்ளீடாகும் 🔗
Auto-Combo இயந்திரம் ஒவ்வொரு சாத்தியமான தேர்வையும் **16 காரணிகளின்** அடிப்படையில் மதிப்பிடுகிறது (ஆரோக்கியம், ஒதுக்கீடு, செலவு, தாமதம், பணிப் பொருத்தம், தரம், அமர்வு கிடைக்கும் தன்மை…) — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)-ஐப் பார்க்கவும்.
##
### 🧱 மீள்திறன் இயல்பாகவே உள்ளமைக்கப்பட்டுள்ளது (3 சுயாதீன அடுக்குகள்)
📖 [தானியங்கு-Combo இயந்திரம்](docs/routing/AUTO-COMBO.md) · [மீள்திறன் வழிகாட்டி](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute-ஐத் தனித்துவப்படுத்துவது எது
📊 முழுமையான வழிமுறை & 9router, OpenRouter, CLIProxyAPI & LiteLLM ஆகியவற்றுடனான ஒவ்வொரு அம்சத்திற்குமான விரிவான ஒப்பீடு → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRoute-ஐ ஆதரிக்கவும்
OmniRoute MIT உரிமம் பெற்றது மற்றும் வெளிப்படையாகப் பராமரிக்கப்படுகிறது. இது உங்கள் நேரத்தையோ பணத்தையோ சேமித்தால், இதைச் சுயாதீனமாக வைத்திருக்க உதவும் வழிகள் இங்கே உள்ளன — உங்களுக்கு ஏற்றதைத் தேர்ந்தெடுக்கவும். ஆதரவுத்தொகை ஒருபோதும் வழிச்செலுத்தல் முன்னுரிமையைப் பாதிக்காது; அது தரவரிசையை அல்ல, பார்வைத்தன்மையையே வழங்குகிறது.
⚠️ ஒவ்வொரு நாணயத்தையும் காட்டப்பட்டுள்ள நெட்வொர்க்கில் மட்டுமே அனுப்பவும் — தவறான நெட்வொர்க்கில் அனுப்பினால் நிதியை இழக்க நேரிடலாம்.
🐛 பிழையைக் கண்டீர்களா அல்லது கருத்து உள்ளதா? ஒரு [கலந்துரையாடலை](https://github.com/diegosouzapw/OmniRoute/discussions) தொடங்கவும்.
டெவலப்பர் குறிப்புகள்: டெவலப்பர்களின் வசதிக்காக, npm install/postinstall நடைபெறும்போது திட்டம் ஓர் உள்ளூர் .env கோப்பை உருவாக்கக்கூடும். இந்தக் கோப்பு திட்டமிட்டே .gitignore வழியாகப் புறக்கணிக்கப்படுகிறது (.gitignore-ஐப் பார்க்கவும்); இதை ஒருபோதும் கமிட் செய்யக்கூடாது — தவறுதலாகக் கமிட் செய்யப்பட்டால், வெளிப்பட்ட ரகசியங்கள் அனைத்தையும் மாற்றி, வரலாற்றிலிருந்து அந்தக் கோப்பை அகற்றவும். உள்ளூர் சூழல் கோப்புகள் மற்றும் ரகசியங்களை நிர்வகிப்பதற்கான வழிகாட்டுதலுக்கு docs/DEVELOPER-ENVIRONMENT.md-ஐப் பார்க்கவும்.
## 📡 OmniRoute Radar
மேலே ஆவணப்படுத்தப்பட்ட, பகிரப்பட்ட தொகுப்புகளில் உள்ள நகல்களை நீக்கிய பட்டியலிலிருந்து கிடைக்கும் முக்கிய இலவச அடுக்கு அளவு **~1.62B டோக்கன்கள்/மாதம்** ஆகவே உள்ளது. வழங்குநர்களின் தற்காலிகப் பதிவுச் சலுகைகள் முதல்
மாதத்திற்கான அளவைத் தனியாக **~2.22B** வரை உயர்த்தக்கூடும். OmniRoute வெளியீடுகளுக்கு இடைப்பட்ட காலத்தில்
இலவச மாடல்களின் கிடைப்புநிலை குறித்த புதிய தகவல்களை விரும்புபவர்களுக்காக Radar ஒரு விருப்பத் தேர்வாகக் கிடைக்கும், கையொப்பமிடப்பட்ட பட்டியல் மேலடுக்காகும்; சமூகப் பட்டியலும் ஏற்கெனவே உள்ள ஒவ்வொரு இலவச
அம்சமும் தொடர்ந்து இலவசமாகவே இருக்கும்.
ஆதரவாளர்கள் நேரடிப் பட்டியலையும் கூடுதல் வழங்குநர் வாய்ப்புகளையும் பெறலாம். வழங்குநர்களின் கிடைப்புநிலையைப் பொறுத்து, இதன் தனியான,
மாற்றத்தக்க உச்சவரம்பு **அதிகபட்சமாகச் சுமார் 3B டோக்கன்கள்/மாதம்** ஆகும்.
இந்த உச்சவரம்பிற்கு உத்தரவாதம் இல்லை: வழங்குநர்கள் ஒதுக்கீடுகள், தகுதித் தேவைகள், மாடல்கள் அல்லது பிராந்தியங்களை
எந்த நேரத்திலும் மாற்றலாம்.
Radar-ஐப் பயன்படுத்தத் தனியாகச் சம்மதிக்க வேண்டும்; இது GET கோரிக்கைகளை மட்டுமே பயன்படுத்துகிறது. OmniRoute கிளையன்ட் ப்ராம்ப்ட்கள், போக்குவரத்து, வழங்குநர்
உள்ளமைவு, பயன்பாட்டுத் தொலைஅளவீடு அல்லது அறிவிப்புகளை நிராகரித்த உள்ளூர் நிலை ஆகியவற்றைப் பதிவேற்றாது. தகுதித் தேவைகளையும்
தற்போதைய பட்டியலையும் **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**-இல் அறிந்துகொள்ளுங்கள்.
## ✨ புதிதாக என்ன உள்ளது
> **v3.8.20 → v3.8.50** பதிப்புகளின் சமீபத்திய சிறப்பம்சங்கள். முழு வரலாறு [`CHANGELOG.md`](CHANGELOG.md)-இல் உள்ளது.
- **🎛️ OmniConductor** — உங்கள் agent குழுவிற்கு உள்வரும் A2A பணிப் பகிர்வு, Agent Card-இல் Conductor திறன்கள் மற்றும் Faro push-to-talk குரல் அரட்டையுடன் கூடிய dashboard panel. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 தகவமைவு அனுமதி & அதிகச் சுமைப் பாதுகாப்பு** — அதிக வளம் தேவைப்படும் chat கோரிக்கைகள் 503 பிழையை வழங்குவதற்குப் பதிலாக வரிசைப்படுத்தப்படுகின்றன; ஒவ்வொரு connection-க்கும் atomic RPM rolling lease-கள் வழங்கப்படுகின்றன. → [மீள்திறன் வழிகாட்டி](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ நியமமான `/v1/models` வரிசைப்படுத்தல்** — ஒவ்வொரு provider-க்கும் தொடர்ச்சியான, provider அடிப்படையில் தொகுக்கப்பட்ட ஒரே block (combos முதலில் நிலைநிறுத்தப்படும்); ஒவ்வொரு catalog மூலத்திலும் நிலையானது. → [API குறிப்பேடு](docs/reference/API_REFERENCE.md)
- **🗜️ சுருக்கப் பாதுகாப்பை வலுப்படுத்துதல்** — இயல்பாகச் செயல்படும் inflation guard, DE / FR / JA + Chinese (wényán)-க்கான Caveman packs, Gradle & .NET-க்கான RTK filters. → [சுருக்கம்](docs/compression/COMPRESSION_ENGINES.md)
- **💸 நேர்மையான நிலையான கட்டணச் செலவு** — subscription / coding-plan provider-கள் செலவுப் பகுப்பாய்வில் **$0** எனக் காட்டப்படுகின்றன; budget, quota & routing தொடர்ந்து மதிப்பிடுகின்றன. → [API குறிப்பேடு](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share routing** — பகிரப்பட்ட account-இன் quota-வை pooled key-கள் முழுவதும் நியாயமாகப் பிரிக்கிறது; பயன்படாத பங்குகள் பிறருக்குக் கடனாக வழங்கப்படுவதால் வேலைத் திறன் பாதுகாக்கப்படுகிறது. → [மீள்திறன் வழிகாட்டி](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 ஒரே command-இல் CLI/agent அமைப்பு** — பதிவுசெய்யப்பட்ட 13 `setup-*` command-கள்; `omniroute run` 7 CLI-களைத் தொடங்குகிறது (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` ஊடாடும் provider+model தேர்வி மற்றும் ஒவ்வொரு context-க்குமான விருப்பங்களுடன் 10 target-களை ஆதரிக்கிறது. → [CLI ஒருங்கிணைப்புகள்](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ தொலைநிலைப் பயன்முறை** — வரம்பிடப்பட்ட token-கள் (`connect` / `contexts` / `tokens`) மற்றும் VPS நிறுவல்களுக்கான `antigravity` OAuth உதவியுடன் தொலைநிலை OmniRoute-ஐ இயக்குங்கள். → [தொலைநிலைப் பயன்முறை](docs/guides/REMOTE-MODE.md)
- **🧭 மேலும் நுண்ணறிவான தானியங்கி routing** — `auto/:` combos, **Fusion** (model panel + judge), task-aware routing, ஒவ்வொரு கோரிக்கைக்குமான model / mode / USD-budget override-கள். → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ இணைக்கக்கூடிய சுருக்கம்** — ஒன்றிணைத்துப் பயன்படுத்தக்கூடிய 12 engine-கள் + Compression Studios: LLMLingua-2, இரு-அடுக்கு Ultra, omniglyph, ஒவ்வொரு படிநிலைக்குமான fidelity gate, GCF v3.2, இழுத்து மறுவரிசைப்படுத்தும் editor. → [சுருக்கம்](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ வெளிப்படையான MITM decrypt (TPROXY)** — proxy env var-களைப் புறக்கணிக்கும் CLI-களை, ஒவ்வொரு SNI-க்குமான CA + trust-store installer மூலம் capture செய்கிறது. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 எங்கும் செலவு telemetry** — ஒவ்வொரு endpoint-இலும் `X-OmniRoute-*` செலவு/பயன்பாட்டு header-கள், cache-HIT சேமிப்பு header, ஒவ்வொரு key-க்குமான USD செலவுக் quota-க்கள். → [API குறிப்பேடு](docs/reference/API_REFERENCE.md)
- **🧠 உங்கள் கட்டுப்பாட்டிலுள்ள memory** — இயல்பாக முடக்கப்பட்டுள்ளது; விருப்பத்தேர்வாக int8 vector quantization + typed decay, ஒவ்வொரு கோரிக்கைக்குமான `x-omniroute-no-memory`. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ பாதுகாப்பு** — ஒவ்வொரு LLM route-இலும் prompt-injection guard (red-team suite), விருப்பத்தேர்வான credential-masking guardrail (இரு திசைகளிலும் கசிந்த API key-கள்/secret-களை மறைக்கிறது), இலவச DuckDuckGo இறுதி வாய்ப்பு web search மற்றும் dashboard-க்கான விருப்பத்தேர்வான OIDC login gate (password login எப்போதும் கிடைக்கும்). → [Guardrail-கள்](docs/security/GUARDRAILS.md)
- **🖼️ புதிய endpoint-கள்** — `/v1/ocr` (Mistral OCR) மற்றும் `/v1/audio/translations` (Whisper-style) ஆகியவை media வசதிகளை முழுமைப்படுத்துகின்றன. → [API குறிப்பேடு](docs/reference/API_REFERENCE.md)
- **🎨 படம் / காணொளி / ஒலி உருவாக்கம்** — media-விற்கான ஒரே API: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind மற்றும் ElevenLabs போன்ற speech provider-கள். → [API குறிப்பேடு](docs/reference/API_REFERENCE.md)
- **🌍 Deployment & செயல்பாடுகள்** — reverse-proxy `basePath`, browser-language தானியங்கிக் கண்டறிதல், ஒவ்வொரு key-க்குமான device tracking, root இல்லாத MITM trust, zh-TW localization. → [சூழல்](docs/reference/ENVIRONMENT.md)
- **🤝 மேலும் பல provider-கள் & agent-கள்** — cloud agent-கள் (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-provider catalog**. → [Provider-கள்](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Routing வெளிப்படைத்தன்மை** — ஒவ்வொரு response-உம் அதனை வழங்கிய strategy/provider/latency-ஐக் குறிப்பிடும் `X-OmniRoute-Decision` header-ஐக் கொண்டுள்ளது; புதிய `cache-optimized` combo strategy + Auto-Combo `cacheAffinity` factor, cached prefix-ஐ வைத்திருக்கும் connection-க்கு மீண்டும் வரும் கோரிக்கைகளைத் திருப்பி அனுப்புகின்றன; மேலும் read-only `/v1/auto-combo/{channel}/candidates` endpoint ஓர் `auto/*` channel-இன் நிகழ்நேர candidate pool-ஐ வெளிப்படுத்துகிறது. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ உள்ளூர் செயல்திறன் & உள்கட்டமைப்பு** — ஒரே click-இல் local Redis, Cloudflare Workers / Deno Deploy relay deployer-கள், மேற்பார்வையிடப்படும் embedded service-களாக Bifrost & Mux. → [Embedded Service-கள்](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 தொகுப்பில் மேலும் உள்ளவை** — plugin framework + marketplace, Omni/Agent/GitHub skills framework-கள், Obsidian vault integration (22 MCP tool-கள்), OpenAI-compatible Batch & Files API-கள், semantic response cache, leaderboard-களுடன் gamification, ACP agent discovery (உள்ளமைந்த 15 agent-கள்), BigQuery-க்குத் திட்டமிடப்பட்ட log export, `auto/chaos` parallel multi-model fan-out, Telegram bot bridge, பயன்பாட்டிற்குள் version manager மற்றும் LMArena-ELO இலவச-provider ranking-கள். → [ஆவணங்கள்](docs/README.md)
## 🤖 இணக்கமான CLI-களும் குறியீட்டாக்க முகவர்களும்
> ஒரே உள்ளமைவு — `http://localhost:20128/v1` — மூலம் **ஒவ்வொரு** AI IDE அல்லது CLI-யும் இலவச மற்றும் குறைந்த செலவு மாதிரிகளில் இயங்கும்.
📖 அனைத்து 36 கருவிகளுக்குமான தனித்தனிக் கருவி அமைப்பு (26 CLI Code கருவிகள் + 10 CLI Agents) → [`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 தற்காலிகமான தனிமைப்படுத்தப்பட்ட 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"
# அல்லது வழங்குநர்+மாதிரியை ஊடாடும் முறையில் தேர்ந்தெடுத்து, கருவியின் சொந்த உள்ளமைவை எழுதுங்கள்:
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)
## 🌐 372 AI வழங்குநர்கள் — 154 இலவசம் எனப் பட்டியலில் குறிக்கப்பட்டவை
> நியமன chat, media, search, local, cloud-agent மற்றும் system தொகுப்புகள் முழுவதிலும் **372 பதிவுசெய்யப்பட்ட வழங்குநர்கள்** உள்ளனர்; இவர்களில் **154 வழங்குநர்கள் `hasFree: true` கண்டறிதல் மெட்டாடேட்டாவைக் கொண்டுள்ளனர்**. chat model பதிவகம் **237 வழங்குநர்கள் / 3,009 தனித்துவமான வழங்குநர்-model இணைகள் / 1,443 மூல model ID-கள்** ஆகியவற்றை உள்ளடக்குகிறது; தனியான இலவச-பட்ஜெட் பட்டியலில் **491 ஒவ்வொரு-model வரிசைகள்**, **35 தொடர்ச்சியான தொகுப்புகள்** மற்றும் **54 தொடர்ச்சியான/API key தேவையற்ற, என்றும் இலவசமான வழங்குநர்கள்** உள்ளனர். இவை வடிவமைப்பின்படியே வெவ்வேறு கணக்கீட்டு அடிப்படைகளைக் கொண்டவை; வரையறைகளும் தொகுப்பு-நகல்நீக்கம் செய்யப்பட்ட கணக்கீடுகளும் [வழங்குநர் குறிப்பு](docs/reference/PROVIDER_REFERENCE.md) மற்றும் [இலவச அடுக்குகள்](docs/reference/FREE_TIERS.md) ஆகியவற்றில் உள்ளன.
### 🏢 ஒவ்வொரு முக்கிய ஆய்வகமும் — ஒரே endpoint வழியாக
### 🧩 புதியது: VS Code-இன் இயல்புநிலை Copilot Chat-க்குள் OmniRoute
> புதிய பக்கப்பட்டி இல்லை, புதிய அரட்டை UI இல்லை — OmniRoute வழங்கும் ஒவ்வொரு மாதிரியும் நீங்கள்
> **ஏற்கனவே பயன்படுத்தும் Copilot Chat மாதிரித் தேர்வியிலேயே** தோன்றும். VS Code 1.122 முதல், வழங்குநர் மாதிரிகள்
> GitHub உள்நுழைவு அல்லது Copilot சந்தா இல்லாமலேயே செயல்படும் — முகவர் பயன்முறை, கருவி அழைப்பு மற்றும் பார்வைத் திறன்
> அனைத்தும் இலவசம்.
**[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** நீட்சியை நிறுவி, அதை உங்கள் OmniRoute சேவையகத்துடன்
(இயல்புநிலை `localhost:20128`) இணைக்கவும்; பிறகு Copilot Chat → மாதிரித் தேர்வி
→ **மாதிரிகளை நிர்வகி…** → **OmniRoute** என்பதைத் திறக்கவும்.
திருத்திக்குள்ளிருந்து: **நீட்சிகள்** காட்சியைத் திறந்து, **"OmniRoute"** எனத் தேடி, **நிறுவு** என்பதைக் கிளிக் செய்யவும்
— இரு களஞ்சியங்களிலும் ஒரே விதமாகச் செயல்படும். மூலக் குறியீடு, சிக்கல்கள் மற்றும் வெளியீட்டு வழிகாட்டி ஆகியவை
[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-க்கான ஒருமுறை அமைத்துவிட்டு மறந்துவிடக்கூடிய மெனுப் பட்டிச் செயலியாக மாற்றுகிறது: இது சேவையகத்தைத் தொடங்கி, மறுதொடக்கங்களுக்குப்
> பிறகும் தொடர்ந்து இயங்கச் செய்து, அதே இடத்தில் புதுப்பித்து, உங்கள் நிகழ்நேர டோக்கன் வரம்பை ஒரே கிளிக்கில் அணுகச் செய்கிறது — **திறந்த
> terminal சாளரம் தேவையில்லை, `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 வெளியீடு அல்ல.
> சேவையகத்தைத் தாண்டி, OmniRoute என்பது **80+ கட்டளைகளைக்** கொண்ட ஒரு **முழுமையான கட்டளை-வரி கட்டுப்பாட்டு மையம்**; மேலும், ஒரு AI முகவர் இதை **தானாகவே** இயக்குவதற்கான திறந்த முகவர் நெறிமுறைகளையும் கொண்டுள்ளது.
### ⌨️ ஓர் உண்மையான CLI (`start` மட்டும் அல்ல)
```bash
omniroute # நுழைவாயில் + கட்டுப்பாட்டுப் பலகையை வழங்கும் (port 20128)
omniroute chat # ஊடாடும் TUI அரட்டை கிளையன்ட் (slash: /model /combo /skill /memory)
omniroute setup # வழிகாட்டப்பட்ட முதல்-இயக்க வழிகாட்டி
omniroute doctor # வழங்குநர்கள், போர்ட்கள், இயல்நிலை சார்புகளைக் கண்டறியும்
```
### 🛰️ தொலைநிலை முறை — CLI-ஐ இங்கே இயக்கி, OmniRoute-ஐ VPS-இல் இயக்குங்கள்
சேவையகத்தில் OmniRoute உள்ளதா? **அதே CLI** மூலம் உங்கள் மடிக்கணினியிலிருந்து அதை இயக்குங்கள். வரம்பிடப்பட்ட அணுகல் டோக்கனுடன் ஒருமுறை உள்நுழையுங்கள்;
அதன்பின் ஒவ்வொரு கட்டளையும் தொலைநிலையை இலக்காகக் கொள்ளும்.
```bash
omniroute connect 192.168.0.15 # கடவுச்சொல் → வரம்பிடப்பட்ட டோக்கன், ஒரு சூழலாகச் சேமிக்கப்படும்
omniroute models list # ← தொலைநிலைச் சேவையகத்திற்கு எதிராக இயங்கும்
omniroute configure codex # ← தொலைநிலை மாதிரியைத் தேர்ந்தெடுத்து, உள்ளமை Codex சுயவிவரத்தை எழுதும்
omniroute tokens create --name ci --scope read # பிற கணினிகளுக்காகக் குறுகிய வரம்புள்ள டோக்கன்களை உருவாக்கும்
omniroute contexts use default # ← உள்ளமைச் சேவையகத்திற்குத் திரும்பும்
```
டோக்கன்கள் `read` / `write` / `admin` என வரம்பிடப்பட்டுள்ளன; செயல்முறைகளைத் தொடங்கும் வழித்தடங்கள் loopback-க்கு மட்டும் வரையறுக்கப்பட்டுள்ளன.
📖 [தொலைநிலை முறை](docs/guides/REMOTE-MODE.md)
### 🤝 ஒரு முகவரை இணையுங்கள் — அது OmniRoute-ஐத் தானே கட்டுப்படுத்தும்
OmniRoute-ஐ **MCP**, **A2A**, ஒரு **REST API**, **webhooks** அல்லது ஒரு **தொலைநிலை CLI** வழியாக வெளிப்படுத்துங்கள் — திறன்மிக்க எந்த முகவரும் (அல்லது உங்கள் சொந்தக் குறியீடும்) முழு நுழைவாயிலையும் கட்டுப்படுத்தும் அணுகலைப் பெறும்: வழித்தட அமைப்பு, வழங்குநர்கள், கூட்டமைப்புகள், தற்காலிகச் சேமிப்பு, சுருக்கம், நினைவகம் — அனைத்தும் தன்னிச்சையாக. கீழேயுள்ள HTTP முனைப்புள்ளிகள் `http://localhost:20128`-இன் கீழ் வழங்கப்படுகின்றன.
இடைமுகம்
முனைப்புள்ளி / கட்டளை
இதற்குப் பயன்படுத்துங்கள்
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor அல்லது எந்த MCP கிளையன்டிலும் இணைக்கவும்
🌊 MCP (HTTP)
/api/mcp/stream
தொலைநிலை MCP — 110 கருவிகள், 33 வரம்புகள் (அமலாக்கம் விருப்பத்தேர்வு), முழுமையான தணிக்கைத் தடம்
கோரிக்கை / ஒதுக்கீட்டு நிகழ்வுகளை Slack, Discord, Telegram அல்லது எந்த URL-க்கும் அனுப்புங்கள்
🛰️ தொலைநிலை CLI
omniroute connect
வரம்பிடப்பட்ட அணுகல் டோக்கன்களுடன் தொலைநிலை நிகழ்வை இயக்குங்கள்
```bash
# MCP வழியாக முழுமையான OmniRoute கருவித்தொகுப்பை Claude Code-க்கு வழங்குங்கள்:
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% டோக்கன்களைச் சேமியுங்கள் — தானாகவே
### 📖 இது எவ்வாறு செயல்படுகிறது — பைப்லைன், கட்டமைப்பு & சேமிப்புக் கணக்கீடு
இயல்புநிலை அடுக்கப்பட்ட சேர்க்கை `RTK → Caveman` என்பதை இயக்குகிறது. இரண்டும் ஒரே கருவி/சூழல் பேலோடில் செயல்படும்போது, சேமிப்புகள் கூட்டுப் பெருக்கமாக அதிகரிக்கின்றன:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
குறியீட்டுத் தொகுதிகள், 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
பெரிய தொகுதிகளை மீட்டெடுப்புக் குறிகளுக்குப் பின்னால் காப்பகப்படுத்தி, தேவைக்கேற்ப பெறுகிறது
பழைய உரையாடல் சுற்றுகளின் சுருக்கமாக்கல் + படிப்படியான காலாவதியாக்கல்
10
LLMLingua-2
MobileBERT ONNX வழியாக ML சொற்பொருள் கிளைநீக்கம் — குறியீட்டுக்குப் பாதுகாப்பானது, ஒத்திசைவற்றது
11
Ultra
விருப்பத்திற்குரிய சிறிய-மாதிரி (SLM) அடுக்குடன் கூடிய தோராய டோக்கன் கிளைநீக்கம்
12
OmniGlyph
நேரடி Anthropic இணைப்பில் அளவிடப்பட்ட Claude Fable 5-க்கான பரிசோதனைச் சூழல்-படமாகக் குறியாக்கம்; வழங்குநர் ரசீதுகள் கிடைக்கும் வரை GPT 5.6 டிரான்ஸ்ஃபார்மர்கள் பாதுகாப்பாக மறுக்கும் நிலையிலேயே இருக்கும். நான்கு சுருக்கச் சுயவிவரங்கள் (இயல்பாக aggressive, balanced, coding-safe, passthrough) (மிகவும் தீவிரமானது; விருப்பத் தேர்வாக மட்டும்)
குறியீட்டுத் தொகுதிகள், URLs மற்றும் கட்டமைக்கப்பட்ட தரவு ஆகியவை பைட் அளவில் துல்லியமாக **எப்போதும் பாதுகாக்கப்படுகின்றன**. **ஒரே கிளிக்கில் தேர்ந்தெடுக்கக்கூடிய முன்னமைவுகள்** என்ஜின்களை ஒருங்கிணைக்கின்றன:
முறை
சேமிப்பு
இதற்கு மிகவும் ஏற்றது
🪶 Lite
~15%
எப்போதும் இயக்கத்தில் இருக்கும் பாதுகாப்பான இயல்புநிலை
🪨 Standard (Caveman)
~30%
தினசரி குறியீட்டாக்கம்
⚡ Aggressive
~50%
கருவிகள் அதிகம் பயன்படுத்தப்படும் நீண்ட அமர்வுகள்
🔥 Ultra
~75%
அதிகபட்ச சேமிப்பு
🧰 RTK
60–90%
ஷெல்/சோதனை/பில்ட்/git வெளியீடு
🔗 Stacked (RTK → Caveman)
78–95%
கலப்பு ப்ராம்ப்ட்கள் + கருவிப் பதிவுகள்
**உண்மையான எடுத்துக்காட்டு — Standard முறை:**
> **முன்பு (69 டோக்கன்கள்):** _"உங்கள் React காம்போனென்ட் மீண்டும் ரெண்டர் ஆவதற்கான காரணம், ஒவ்வொரு ரெண்டர் சுழற்சியிலும் நீங்கள் ஒரு புதிய ஆப்ஜெக்ட் குறிப்பை உருவாக்குவதே எனத் தெரிகிறது. இன்லைன் ஆப்ஜெக்டை prop ஆக அனுப்பும்போது, React-இன் மேற்பரப்பு ஒப்பீடு அதை ஒவ்வொரு முறையும் வேறொரு ஆப்ஜெக்டாகக் காண்கிறது; இது மீண்டும் ரெண்டர் ஆவதைத் தூண்டுகிறது. ஆப்ஜெக்டை நினைவகப்படுத்த useMemo பயன்படுத்துமாறு பரிந்துரைக்கிறேன்."_
>
> **பின்பு (19 டோக்கன்கள்):** _"ஒவ்வொரு ரெண்டரிலும் புதிய ஆப்ஜெக்ட் குறிப்பு. இன்லைன் ஆப்ஜெக்ட் prop = புதிய குறிப்பு = மறு-ரெண்டர். useMemo-இல் சுற்றவும்."_
>
> **அதே பதில். 72% குறைவான டோக்கன்கள். துல்லிய இழப்பு பூஜ்ஜியம்.** ✅
**PT-BR எடுத்துக்காட்டு — [Troglodita](https://github.com/leninejunior/troglodita) முறை:**
> **முன்பு (42 டோக்கன்கள்):** _"ஒவ்வொரு ரெண்டரிங் சுழற்சியிலும் ஒரு புதிய ஆப்ஜெக்ட் ரெஃபரன்ஸ் உருவாக்கப்படுவதால், காம்போனென்ட் மீண்டும் ரெண்டர் ஆகிறது. `useMemo`-ஐப் பயன்படுத்தப் பரிந்துரைக்கிறேன்."_
>
> **பிறகு (12 டோக்கன்கள்):** _"மறு-ரெண்டர்: ஒவ்வொரு சுழற்சியிலும் புதிய ref (inline ஆப்ஜெக்ட் மீண்டும் உருவாக்கப்படுகிறது). `useMemo` பயன்படுத்தவும்."_
>
> **அதே பதில். ~70% குறைவான டோக்கன்கள். தொழில்நுட்பத் துல்லியம் மாறாமல் உள்ளது.** ✅
### 🎚️ என்ஜின்களுக்கு அப்பால் — வெளியீட்டு பாணிகள், தகவமைப்பு டயல் மற்றும் ஒவ்வொரு கோரிக்கைக்குமான கட்டுப்பாடு
மேலே உள்ள 12 என்ஜின்கள் உள்ளே செல்வதைச் சுருக்குகின்றன. மேலும் மூன்று அடுக்குகள் **எப்படி**, **எப்போது**, மற்றும் வெளியே **என்ன** வருகிறது என்பதை வடிவமைக்கின்றன:
- **🪄 வெளியீட்டு பாணிகள்** _(வெளியீட்டு-அச்சு வழிநடத்தல்)_ — தீர்மானகரமான, cache-க்குப் பாதுகாப்பான பதில்-வடிவமைப்பு வழிமுறைகளைச் சேர்க்கிறது; இவற்றை ஒன்றிணைக்கலாம், ஒவ்வொன்றும் `lite` / `full` / `ultra` தீவிரத்தில் கிடைக்கும். ஒரு பாணியைச் சேர்க்க registry-இல் ஒரே ஒரு வரி போதும்:
- **சுருக்கமான உரைநடை** — தேவையற்ற சொற்கள் / articles / தயக்கமான சொற்றொடர்களை நீக்கி, தொழில்நுட்ப உள்ளடக்கத்தைத் துல்லியமாக வைத்திருக்கும்.
- **குறைவான code** — "சோம்பேறி senior dev" YAGNI: செயல்படும் மிகச்சிறிய மாற்றம் மட்டும்; கோரப்படாத scaffolding இல்லை.
- **போனிடெயில் (சோம்பேறி senior dev)** — YAGNI ஏணியில் மேலேறி, மூலக் காரணத்தைச் சரிசெய்து, செயல்படும் மிகச்சிறிய diff-ஐ வழங்கும்.
- **எனக்கு ADHD உள்ளது (செயல்-முதலில்)** — அடுத்த செயல் முதலில் வரும், படிகள் எண்ணிடப்படும், ஒரே ஒரு தெளிவான அடுத்த படி வழங்கப்படும், முன்னுரை இல்லை.
- **சுருக்கமான CJK (文言)** — செம்மொழிச் சீனத்தின் அதி-சுருக்கமான பாணி (`zh` locale-க்கு மட்டும்).
- **🎯 தகவமைப்பு context-budget** _(டயல்)_ — ஒரே on/off டோக்கன் வரம்பைப் பயன்படுத்துவதற்குப் பதிலாக, **மாடலின் context window-க்குள் பொருந்துவதற்கு** தேவையான அளவு வரை மட்டுமே மிகக் குறைந்த செலவுடைய, மிகக் குறைந்த தகவல் இழப்புடைய என்ஜின்களைப் படிப்படியாகச் செயல்படுத்துகிறது. கொள்கை: `reserve-output` (இயல்புநிலை, மாடலை அறிந்தது) · `percentage` · `absolute`. பயன்முறை: `floor` (பொருந்துவதை உறுதிசெய்கிறது) · `replace-autotrigger` (உங்கள் வெளிப்படையான தேர்வுக்கு முன்னுரிமை) · `off` (பழைய வரம்பு).
- **🎛️ சுருக்கம் எங்கே தீர்மானிக்கப்படுகிறது** _(முன்னுரிமை, அதிகம் → குறைவு)_ — ஒவ்வொரு கோரிக்கைக்குமான `x-omniroute-compression` header › routing-combo override › செயலில் உள்ள பெயரிடப்பட்ட profile › தகவமைப்பு / auto-trigger › panel இயல்புநிலை › off. பயன்படுத்தப்பட்ட திட்டம் `X-OmniRoute-Compression: ; source=` response header-இல் திரும்பக் காட்டப்படும்.
டோக்கன் வரம்பின்படி auto-trigger செய்யுங்கள், தகவமைப்பு டயலை இயக்குங்கள், பெயரிடப்பட்ட profile-ஐ நிலைநிறுத்துங்கள், ஒவ்வொரு கோரிக்கைக்கும் ஒருமுறை மட்டும் அமைக்குங்கள், அல்லது ஒவ்வொரு routing combo-க்கும் ஒரு pipeline-ஐ ஒதுக்குங்கள் — பணிச்சுமைக்கு எது பொருந்துகிறதோ அதைப் பயன்படுத்துங்கள். விருப்பத்தின் பேரில் இயக்கக்கூடிய 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 அல்லது அதற்குப் பிந்தைய பதிப்பைப் பயன்படுத்துகிறீர்களா?** அனுமதிக்கப்படாத package lifecycle scripts-ஐ npm தடுக்கக்கூடும். OmniRoute-இன் `postinstall` (`node scripts/build/postinstall.mjs`), அதன் native runtime கோப்புகளைத் தயாரிக்கத் தேவைப்படுகிறது. globally நிறுவும்போது npm எச்சரிக்கையில் குறிப்பிடப்பட்டுள்ள packages-ஐ அனுமதிக்கவும். OmniRoute 3.8.51 அறிவித்த package தொகுப்புக்கு:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> எதிர்கால global நிறுவல்களிலும் இந்த 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-ஐ நிறைவுசெய்யவும். இலவச tiers-க்கு signup, approval அல்லது payment method தேவைப்படலாம். [இலவச Tiers வழிகாட்டியை](docs/getting-started/FREE-TIERS-GUIDE.md) பார்க்கவும்; keyless கிடைப்பது உத்தரவாதமில்லை, மேலும் `tos: avoid` எனக் குறிக்கப்பட்ட providers இயல்புநிலையாக `auto`-இலிருந்து விலக்கப்படுகின்றன.
**3) உங்கள் coding tool-ஐ இணைக்கவும்**
```txt
அடிப்படை URL: http://localhost:20128/v1
API Key: [Dashboard → Endpoints இலிருந்து நகலெடுக்கவும்]
மாடல்: auto (தகுதியான இணைப்புகளுக்கு இடையே route செய்கிறது — அல்லது 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, மூலக் குறியீடு, 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 தேவை; இல்லையெனில் ஒன்றுடன் ஒன்று நேரத்தில் இயங்கும் இரண்டு நீண்ட context-களின்போது, செயல்முறை சுமார் 12 GiB-ல் `FATAL ERROR` ஏற்படுத்தும். Heap-ஐ விட container-ன் அளவை அதிகமாக அமைக்கவும் (native buffer-கள் V8-க்கு வெளியே இருக்கும்):
| பணிச்சுமை | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) |
| ------------------------------------------ | ------------------------------- | ---------------------- |
| Dashboard / இலகுவான chat | `1024` (image இயல்புநிலை) | ≥2 g |
| ஒரு coding agent | `8192` | ≥10 g |
| ஒரே நேரத்தில் இரண்டு நீண்ட `/v1/responses` | `10240`–`12288` | ≥12–16 g |
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
முழு அட்டவணை: [Docker வழிகாட்டி — இயக்கநேர RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **முன்வெளியீட்டு Docker சேனல்:** `diegosouzapw/omniroute:next` மற்றும்
> `diegosouzapw/omniroute:next-web` ஆகியவை தற்போதைய இயல்புநிலை `release/v*`
> branch-ஐப் பின்பற்றுகின்றன. மாறக்கூடிய இந்த tag-கள், இன்னும் வெளியிடப்படாத திருத்தங்களைச் சோதிப்பதற்காக மட்டுமே உருவாக்கப்பட்டவை;
> அவை **production-க்கு ஆதரிக்கப்படவில்லை**. பார்க்க:
> [Docker வெளியீட்டுச் சேனல்கள்](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
Bun runtime கண்டறிதல் மூலம் வழக்கமான `bun install` மற்றும் global நிறுவல் (`bun install -g omniroute`) ஆதரிக்கப்படுகின்றன:
- **உள்ளமைந்த `bun:sqlite`**: Bun-ன் கீழ் இயங்கும்போது, OmniRoute அதன் உள்ளமைந்த `bun:sqlite` driver-ஐப் பயன்படுத்துகிறது; Node.js-ல் `better-sqlite3` அல்லது `sql.js`-க்கு fallback செய்கிறது.
- **dev-ல் தானியங்கி Webpack bundler தேர்வு**: Development (`bun run dev`) தானாகவே Bun-ஐக் கண்டறிந்து, native V8 binding இணக்கமின்மைகளைத் தடுக்க Turbopack-ஐ முடக்கி Webpack-ஐப் பயன்படுத்துகிறது. Production build-கள் (`bun run build`), Node-ஐப் போலவே `OMNIROUTE_USE_TURBOPACK`-ஐத் துல்லியமாகப் பின்பற்றுகின்றன: இயல்புநிலையாக Turbopack; Webpack மூலம் build செய்ய `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` இதை `--build-arg` ஆக வழங்குகிறது).
- **Bun-க்கெனத் தனிப்பட்ட Dockerfile**: Native Bun production deployment-களுக்கான multi-stage `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Bun மூலம் நிறுவி இயக்கவும்
bun install
bun run dev
```
**🛠️ மூலக் குறியீட்டிலிருந்து**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Nix flake-களைப் பயன்படுத்துதல்
nix develop
npm run dev
# அல்லது devbox-ஐப் பயன்படுத்துதல்
devbox run npm run dev
```
📖 [Docker வழிகாட்டி](docs/guides/DOCKER_GUIDE.md) — Compose profile-கள், Caddy HTTPS, Cloudflare tunnel-கள்.
**🦭 Podman**
```bash
# 1. Bind-mount செய்யப்பட்ட data directory-ஐத் தயாரிக்கவும்
mkdir -p data
# 2. Linux + உள்ளூர் 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 build-கள், Podman Machine மற்றும்
Linux/systemd Quadlet அமைப்பு.
**⚡ வேகமான / குறைந்த அளவிலான நிறுவல் (native build-ஐத் தவிர்க்கவும்)**
Native SQLite engine (`better-sqlite3`) ஒரு **விருப்பமான** dependency ஆகும்; எனவே global
நிறுவல், மூலக் குறியீட்டிலிருந்து compile செய்வதற்காக ஒருபோதும் காத்திருக்காது: உங்கள்
platform/Node-க்கு பொருந்தும்போது prebuilt binary-ஐப் பயன்படுத்தும்; இல்லையெனில் pure-JS engine-க்கு
வெளிப்படையாக fallback ஆகும் (Node 22+ இல் `node:sqlite`; இல்லையெனில் தொகுப்புடன் வழங்கப்படும் `sql.js` WASM) — build tool-கள் தேவையில்லை.
நிறுவலுக்குப் பிந்தைய native warm-up-ஐ முழுமையாகத் தவிர்க்க (CI, headless அல்லது மெதுவான கணினிகள்):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 என்பதும் இதைத் தவிர்க்கும்
```
மிக வேகமான நிறுவல்களுக்கு **pnpm**-ஐப் பயன்படுத்தவும் (content-addressed store + hard link-கள் — மேலே பார்க்கவும்).
Dashboard இல்லாத headless runtime-க்கு Docker `base` profile-ஐ (மேலே) அல்லது
[Termux வழிகாட்டியை](docs/guides/TERMUX_GUIDE.md) பயன்படுத்தவும். CLI மற்றும் web dashboard ஆகியவை ஒரே process மூலம்
ஒரே port-ல் வழங்கப்படுகின்றன; எனவே தற்போது தனியான CLI-only package இல்லை.
சுற்றுத்தடை, அதிவேகப் பின்வாங்கல், ஒரே நேர அதீதக் கோரிக்கைத் தடுப்பு, தானியங்குச் சேர்க்கைச் சுய-சீரமைப்பு
பதிவிடல்
pino — கோரிக்கைச் சூழலுடன் கட்டமைக்கப்பட்ட JSON பதிவுகள்
சோதனை
Node.js சோதனை இயக்கி + Vitest — 5,100+ கண்காணிக்கப்படும் சோதனைக் கோப்புகள் முழுவதும் 39,000+ நிலையான சோதனை அறிவிப்புகள் (அலகு, ஒருங்கிணைப்பு, E2E, பாதுகாப்பு, சூழலமைப்பு)
கண்காணிக்கப்படும் 5,100+ சோதனைக் கோப்புகளில் உள்ள 39,000+ நிலையான சோதனை அறிவிப்புகளுக்கான சோதனை உள்ளடக்க உத்தி
# ⭐ முதன்மைப் பங்களிப்பாளர்கள்
> ஆர்வமிக்க திறந்த மூலச் சமூகத்தால் OmniRoute வடிவமைக்கப்படுகிறது. இந்த நபர்கள் திட்டத்தின் தரம், நிலைத்தன்மை மற்றும் சென்றடைவு ஆகியவற்றில் நேரடித் தாக்கத்தை ஏற்படுத்தும் விதத்தில் சிறப்பான பங்களிப்புகளைச் செய்துள்ளனர். **நன்றி.**
### ஒன்றிணைக்கப்பட்ட pull request-களின் அடிப்படையிலான வெளிப்புறப் பங்களிப்பாளர்கள்
நேரடி release/v3.8.50 முனை dafb4ae808-இல், 2026-08-24 05:26:03 UTC வரையிலான ஒன்றிணைப்புகளுடன் நிலைப்படுத்தப்பட்டது. பக்கங்களாகப் பிரிக்கப்பட்ட GitHub GraphQL கணக்கெடுப்பில் ஒன்றிணைக்கப்பட்ட 5,911 PR-கள் உள்ளன: களஞ்சிய உரிமையாளரால் 2,707, Dependabot-ஆல் 179, மேலும் 535 தனித்துவமான பங்களிப்பாளர்களிடமிருந்து 3,025 வெளிப்புற PR-கள். “மாற்றப்பட்ட வரிகள்” என்பது GitHub சேர்த்தல்கள் + நீக்குதல்கள் ஆகும்; உருவாக்கப்பட்ட கோப்புகள், lockfile-கள், பட்டியல்கள், மொழிபெயர்ப்புகள் மற்றும் ஆவணங்களும் இதில் அடங்கும்; இது மாற்றச் சுழற்சியின் அளவே அன்றி, எழுதப்பட்ட LOC அல்ல. வெட்டுப்புள்ளியில் உள்ள சமநிலைகள் தக்கவைக்கப்பட்டுள்ளன.
### GitHub-ஆல் வகைப்படுத்தப்பட்ட commit-கள்
Bob.Hou 🏅 GitHub-க்குக் காரணப்படுத்தப்பட்ட 51 commits · #10-இல் சமநிலை
Xiangzhe 🏅 GitHub-க்குக் காரணப்படுத்தப்பட்ட 51 commits · #10-இல் சமநிலை
2026-08-24 06:14:31 UTC அன்று மீண்டும் சரிபார்க்கப்பட்டது: இயல்புநிலைக் கிளையான release/v3.8.50-க்காகக் களஞ்சியத்தின் Contributors API அறிக்கையிட்ட GitHub-க்குக் காரணப்படுத்தப்பட்ட commits. API 525 அடையாளங்களை (415 பயனர்கள், 2 bots, 108 அநாமதேயர்கள்) திருப்பியளித்தது; இந்த அட்டவணை பராமரிப்பாளர், bots மற்றும் அநாமதேய அடையாளங்களை விலக்கி, போட்டி சமநிலைகளைத் தக்கவைத்துள்ளது. இது மேலேயுள்ள இணைக்கப்பட்ட-PR தரவரிசை மற்றும் கீழேயுள்ள 639 நபர்களைக் கொண்ட Git-metadata கணக்கெடுப்பு ஆகிய இரண்டிலிருந்தும் வேறுபட்டது.
> 🙏 இந்தப் பங்களிப்பாளர்களின் அம்சங்கள், பிழைத் திருத்தங்கள் மற்றும் உள்கட்டமைப்பு மேம்பாடுகள் OmniRoute-ஐ நம்பகமானதாகவும் அம்சங்கள் நிறைந்ததாகவும் ஆக்குவதில் ஒரு **முக்கியப் பகுதியாகும்**. ஒவ்வொரு pull request-உம், ஒவ்வொரு test case-உம், ஒவ்வொரு i18n மொழிபெயர்ப்புக் கோப்பும் முக்கியமானது. திறந்த மூல மென்பொருள் இவர்களைப் போன்றவர்களாலேயே உருவாக்கப்படுகிறது.
---
## 💖 ஆதரவாளர்கள்
தங்களது சொந்தப் பணத்தில் OmniRoute-க்கு நிதியளிக்கும் அனைவருக்கும் மனமார்ந்த நன்றி — ஒவ்வொரு பங்களிப்பும் இந்தத் திட்டத்தை இலவசமாகவும், சுயாதீனமாகவும், தொடர்ந்து முன்னேறிக்கொண்டிருக்கவும் உதவுகிறது.
… மேலும் தனிப்பட்டவர்களாகவே இருக்க விரும்பும் மற்றவர்களுக்கும் நன்றி 💛பொதுவான GitHub Sponsors விவரங்கள் 2026-08-24 அன்று மறுசரிபார்க்கப்பட்டன. மேலே உள்ள செயலில் உள்ளோர் அடையாளங்களை GitHub-இன் activeOnly நிலை தீர்மானிக்கிறது; முன்பு வெளிப்படுத்தப்பட்ட பொதுவான ஒருமுறை ஆதரவாளர்களுக்குத் தொடர்ந்து நன்றி தெரிவிக்கப்படுகிறது, மேலும் தனிப்பட்ட ஆதரவாளர்கள் பெயர் வெளியிடப்படாமல் இருக்கின்றனர்.💖 ஆதரவாளராகுங்கள் → — ஒவ்வொரு டாலரும் OmniRoute-ஐ இலவசமாகவும் சுயாதீனமாகவும் வைத்திருக்க உதவுகிறது.
## 👥 600+ பங்களிப்பாளர்கள்
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-08-24 அன்று நிலைப்படுத்தப்பட்ட அடிப்படை ac02c5b42f-இல் தணிக்கை செய்யப்பட்டு, நேரடி release/v3.8.50-இன் முனை dafb4ae808-இல் மீண்டும் சரிபார்க்கப்பட்டது: 639 இயல்பாக்கப்பட்ட மனித Git அடையாளங்கள் — 407 அடையாளங்கள் commit ஆசிரியர்களாகத் தோன்றுகின்றன (பராமரிப்பாளரும் உட்பட), மேலும் 232 அடையாளங்கள் வெளிப்படையான Co-authored-by முடிவுரைகளில் மட்டுமே தோன்றுகின்றன. இந்தக் கணக்கெடுப்பு GitHub noreply பயனர் அடையாளங்களை இயல்பாக்குகிறது, 26 bot/agent/service/placeholder அடையாளங்களை விலக்குகிறது, மேலும் சாதாரண மின்னஞ்சல் முகவரிகளின் காட்சிப் பெயர்கள் பொருந்துகின்றன என்பதற்காக மட்டுமே அவற்றை ஒன்றிணைப்பதில்லை.
### எவ்வாறு பங்களிப்பது
1. களஞ்சியத்தை fork செய்யவும்
2. **செயலில் உள்ள** `release/vX.Y.Z` முனையிலிருந்து branch உருவாக்கவும் (`main`-இலிருந்து அல்ல) — [Branching & Release Model](docs/ops/BRANCHING_MODEL.md)-ஐப் பார்க்கவும்
3. உங்கள் அம்சத்திற்கான branch-ஐ உருவாக்கவும் (`git checkout -b feat/amazing-feature`)
4. உங்கள் மாற்றங்களை commit செய்யவும் (`git commit -m 'feat: add amazing feature'`)
5. branch-க்குத் தள்ளவும் (`git push origin feat/amazing-feature`)
6. **base = அந்த `release/vX.Y.Z` branch** என அமைத்து ஒரு Pull Request-ஐத் திறக்கவும்
விரிவான வழிகாட்டுதல்களுக்கு [CONTRIBUTING.md](CONTRIBUTING.md)-ஐப் பார்க்கவும்.
### புதிய பதிப்பை வெளியிடுதல்
```bash
# ஒரு வெளியீட்டை உருவாக்கவும் — npm publish தானாகவே நடைபெறும்
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 நட்சத்திரங்கள்
## 🌍 StarMapper
## 🙏 நன்றிகள்
OmniRoute பல முன்னோடிகளின் சாதனைகளை அடித்தளமாகக் கொண்டு உருவாக்கப்பட்டுள்ளது. இது **[9router](https://github.com/decolua/9router)**-இன் ஒரு fork ஆகவும், Go திட்டமான **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**-இன் TypeScript port ஆகவும் தொடங்கியது — அதிலிருந்து, கீழே உள்ள ஒவ்வொரு துணை அமைப்பும் முதலில் அந்த இலக்கை அடைந்த ஓர் open-source திட்டத்தால் ஊக்கமளிக்கப்பட்டது. அவை ஒவ்வொன்றும் OmniRoute-இன் ஒரு குறிப்பிட்ட பகுதியை வடிவமைத்தன. அவை அனைத்திற்கும் நாங்கள் தெரிவிக்கும் நன்றி இதுவாகும். 🙏
> ⭐ நட்சத்திர எண்ணிக்கைகள் GitHub-இன் REST API மூலம் ஆகஸ்ட் 24, 2026 அன்று சரிபார்க்கப்பட்டவை — இந்தத் திட்டங்களுக்கு ஒரு நட்சத்திரம் வழங்குங்கள். இந்த எண்ணிக்கைகள் குறிப்பிட்ட தேதியில் எடுக்கப்பட்ட துல்லியமான நிலைப்படம்; காலப்போக்கில் அவை இயல்பாகவே மாறும்.
### 🧬 பரம்பரை & நுழைவாயில்
இதன் பொது விலைத் தரவுத்தொகுப்பு எங்களின் செலவு-கண்காணிப்பு ஒத்திசைவுக்கு தரவை வழங்குகிறது; மேலும், இதன் வழங்குநர்-இயல்பாக்க மாதிரி எங்களின் வழிப்படுத்தலை வடிவமைக்க உதவிய AI நுழைவாயில்.
உலாவி-அமர்வு, பதில்-சட்டகமிடல், பயன்பாடு மற்றும் இணையத் தேடல் ஏற்பிகள் உள்ளிட்ட, தொகுப்பில் சேர்க்கப்பட்ட ChatGPT Web → Codex Responses இணைப்புப் பாலத்திற்காகத் தழுவப்பட்ட MIT மூலம்.
ஸ்ட்ரீம் மீட்பு, சிந்தனையற்ற மாற்றுப்பெயர்கள், மாற்றுவழி இணையத் தேடல், நகரும்-சாளர வரம்புகள், பதிவு மறைப்பு மற்றும் வலுப்படுத்தப்பட்ட துவக்கி ஓட்டங்கள் ஆகியவற்றுக்கு port செய்யப்பட்ட வடிவமைப்புகள்.
இதன் Grok மாதிரி பொருத்தங்கள், போலி-TypeError Statsig உருவாக்கி, கோரிக்கை மற்றும் சாதன இயல்புநிலைகள், NDJSON பதில் செயலி ஆகியவை OmniRoute-இன் Grok Web இயக்கியில் குறிப்பிடத்தக்க வகையில் தழுவப்பட்டன.
grok2api-merged-க்குப் பின்னால் உள்ள முதன்மையான இடைமுகக் குறியீட்டு மூலம்; இதன் மாதிரி, header, payload, Statsig மற்றும் செயலி செயலாக்கங்கள் Grok Web மரபில் பாதுகாக்கப்பட்டுள்ளன.
Grok payload மற்றும் சாதன இயல்புநிலைகள், Statsig உருவாக்கி, மேலும் TQZHR மற்றும் grok2api-merged வழியாகக் கொண்டுவரப்பட்ட result.response செயலி ஆகியவற்றுக்கான அடிப்படை MIT மூலம்.
இதன் proxy-pool அடுக்கிற்காக grok2api-merged பாராட்டுக் குறிப்பிட்ட ஒரு இடைமுக மூலம்; OmniRoute அந்த மரபுக் குறிப்பைப் பாதுகாக்கிறது, ஆனால் அதன் வரம்புக்குட்பட்ட Grok Web இயக்கியில் proxy-pool port இருப்பதாக உரிமை கோரவில்லை.
இதன் cookie-அங்கீகரிக்கப்பட்ட Grok proxy மற்றும் result.response.token ஸ்ட்ரீமிங் வடிவமைப்பு OmniRoute-இன் Grok Web போக்குவரத்து அடுக்கை வடிவமைக்க உதவியது.
அசல் Grok Web செயலாக்கம் இதன் HTTP/உலாவி upstream வடிவமைப்பைக் கலந்தாலோசித்தது; இதன் நேரடி HTTP பாதை GrokProxy-இலிருந்து பெறப்பட்டதால், தனிப்பட்ட குறியீட்டு port எதுவும் உரிமை கோரப்படவில்லை.
வைரலான "பல டோக்கன்களை ஏன் பயன்படுத்த வேண்டும், சில டோக்கன்களே வேலையைச் செய்யும்போது" திட்டம் — அதன் குகைமனிதப் பேச்சுத் தத்துவமே எங்கள் நிலையான சுருக்கப் பயன்முறைக்கும் 30+ நிரப்புச்சொல்/சுருக்க விதிகளுக்கும் அடித்தளமாக உள்ளது.
உயர் செயல்திறன் கொண்ட கட்டளை வெளியீட்டுச் சுருக்கம் — எங்கள் RTK எஞ்சின், JSON வடிகட்டி DSL, மூல வெளியீட்டு மீட்பு மற்றும் அடுக்கப்பட்ட RTK → Caveman செயலாக்கத் தொடருக்கு ஊக்கமளித்தது.
PT-BR டோக்கன் சுருக்கம் — எங்கள் pt-BR மொழித் தொகுப்பை இயக்குகிறது: பிரேசிலிய-போர்த்துகீசிய இலக்கணத்திற்கேற்பச் சீரமைக்கப்பட்ட தேவையற்ற மறுகூற்றுக் குறைப்பு மற்றும் நிரப்புச்சொல் நீக்கம்.
வைரலான "சோம்பேறி மூத்த டெவலப்பர்" YAGNI-குறியீட்டாளர் திறன் — எங்கள் less-code வெளியீட்டுப் பாணிக்கு ஊக்கமளித்தது: _உருவாக்கப்பட்ட_ குறியீட்டைக் குறைக்கும் மிகச் சிறிய-செயல்படும்-மாற்ற வழிகாட்டல் (Caveman-இன் சுருக்கமான உரைநடைக்கான வெளியீட்டு-அச்சுச் சகோதரம்).
தோல்வியை உணர்ந்து கைவிடும் வசதியுடன், கோப்பு வகை வாரியாக உள்ளடக்கத்தை அறிந்து செய்யப்படும் வெளியீட்டுச் சுருக்கம் — எங்கள் வகை வாரியான அனுப்பீட்டையும் குறைந்தபட்ச-பலன் இல்லையெனில் தவிர்ப்பதையும் உறுதிப்படுத்தியது.
Rust நெடுவரிசை-JSON + உள்ளடக்க-முகவரியிட்ட மீட்டெடுப்பு + செய்திகளுக்கு இடையிலான நகல்நீக்கம் — எங்கள் headroom/ccr/session-dedup எஞ்சின் வடிவமைப்பையும், தற்காலிகச் சேமிப்பகத்துக்கு நிலையான "சுருக்கப்பட்ட வடிவம் நிலையைச் சாராதது" என்ற மாறாத விதியையும் உறுதிப்படுத்தியது.
TypeScript Compiler API கருவித்தொகுப்பு — string, template மற்றும் regex literals-ஐப் பாதுகாக்கும் எங்கள் parser-அடிப்படையிலான கருத்துரை நீக்கத்திற்கு ஊக்கமளித்தது.
மீண்டும் மீண்டும் நிகழும் 16 RAG/LLM தோல்வி முறைகளுக்கான ProblemMap வகைப்பாடு — எங்கள் சிக்கல் தீர்வு வழிகாட்டியில் பயன்படுத்தப்படும் பொதுவான சொற்களஞ்சியம்.
### 🛰️ போக்குவரத்து ஆய்வு, MITM & வெளிப்படையான proxy
குறியீட்டு உதவியாளர் ↔ LLM போக்குவரத்தின் MITM இடைமறிப்பு/பகுப்பாய்வு, ஆரம்பகால Traffic Inspector தேவைகளைத் தீர்மானிக்க உதவியது. முன்னர் பெறப்பட்ட நான்கு தொகுதிகள் — SSE ஒன்றிணைப்பு, உரையாடல் இயல்பாக்கம், ரகசிய மறைப்பு மற்றும் தலைப்புப் புலத் தூய்மைப்படுத்தல் — பொது நெறிமுறைத் தரநிலைகளின் அடிப்படையில் உருவாக்கப்பட்ட சுயாதீனமான clean-room செயலாக்கங்களால் மாற்றப்பட்டுள்ளன. இரண்டு host-passthrough பரப்புகளும் (passthrough.ts மற்றும் _internal/bypass.cjs) தனித்தனியாக வகைப்படுத்தப்பட்ட OmniRoute-இன் அகச் செயலாக்கங்களாகவே உள்ளன; அந்த மாற்றத்தின் ஒரு பகுதியாக அவை மீண்டும் எழுதப்படவில்லை.
ஒவ்வொரு செயல்முறைக்குமான வெளிப்படையான proxy வழிப்படுத்தல் — செயலிழப்பைப் பாதுகாப்பாகக் கையாளும் எங்கள் MITM teardown, socket செயலற்றநேர வரம்புகள், /proc செயல்முறை ஒதுக்கீடு மற்றும் TPROXY பிடிப்புக்கு உத்வேகம் அளித்தது.
Istio சேவை-mesh கண்காணிப்புத்திறன் — Routing/Combo Studio-வில் உள்ள எங்கள் circuit-breaker அடையாளச் சின்னங்கள் மற்றும் பிழை-விளிம்புக் காட்சிகளுக்கு உத்வேகம் அளித்தது.
எங்கள் பாதுகாப்புத் தேர்வுகளுக்கு வழிகாட்டும், இயல்புநிலையிலேயே பாதுகாப்பான நூலகங்களின் தொகுக்கப்பட்ட பட்டியல் (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
அதன் கணக்கு-விழிப்புணர்வுள்ள மாதிரி மறுவரைபாடு, இயக்கக்கூடிய கோப்புப் பாதைச் சரிபார்ப்பு மற்றும் திட்ட-சிட்டை நடத்தை ஆகியவை OmniRoute-இன் Antigravity இயக்கநேரத்தை வடிவமைக்க உதவின.
Grok Build ஒதுக்கீட்டுப் பரப்பைக் கண்டறிந்தது; பின்னர் OmniRoute நேரடி wire format-ஐச் சுயாதீனமாகச் சரிபார்த்துத் திருத்தியது.
## 📄 உரிமம்
MIT உரிமம் - விவரங்களுக்கு [LICENSE](LICENSE)-ஐப் பார்க்கவும்.
---
**[⬆ மேலே திரும்பு](#-omniroute)** · திறந்த மூல AI சமூகத்திற்காக ❤️ உடன் உருவாக்கப்பட்டது.
OmniRoute v3.8.52 · Node ≥22.22.2 · MIT உரிமம் · omniroute.online