> இலவச அடுக்குகளை கைமுறையாக ஒன்றிணைப்பது கடினமானது — டஜன் கணக்கான SDK-கள், டஜன் கணக்கான விகித வரம்புகள், மேலும் உண்மையில் உங்களிடம் எவ்வளவு உள்ளது என்பதே தெரியாது. OmniRoute, **மீண்டும் மீண்டும் கிடைக்கும் 35 pool key-களில் 489 இலவச-அடுக்கு பதிவுகளைப்** பட்டியலிட்டு, பகிரப்பட்ட pool அடிப்படையில் நகல்களை நீக்கிய பிறகு, **வெளியிடப்பட்ட நேர்மறையான மாதாந்திர பட்ஜெட்டைக் கொண்ட 17 pool-கள் மற்றும் ஒவ்வொரு மாடலுக்குமான ஐந்து Groq வரம்புகளிலிருந்து** டோக்கன் தலைப்பு எண்ணிக்கையைக் கணக்கிடுகிறது. பிராந்திய அடையாளச் சரிபார்ப்புக்குப் பிறகு மட்டுமே திறக்கப்படும் ஒதுக்கீடுகள் (தற்போது: ModelScope) தனியாகக் காட்டப்படுகின்றன; பிராந்திய அடையாளச் சரிபார்ப்புக்குப் பின்னால் +~6M உள்ளது, மேலும் அது தலைப்பு எண்ணிக்கையில் ஒருபோதும் சேர்க்கப்படுவதில்லை. முடிவு டாஷ்போர்டில் (`/dashboard/free-tiers`) தொடர்ந்து காணக்கூடியதாக இருக்கும்.
> நேரடி `/dashboard/free-tiers` பக்கத்தின் அசைவூட்டப்பட்ட சுருக்கம். முழுமையான வழிமுறை (pool நகல்நீக்கம், கிரெடிட் அடுக்குகள், வழங்குநர் விதிமுறைகள்): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> இந்த எண்ணிக்கைகள் ஒவ்வொரு இரண்டு வாரங்களுக்கும் நேரடி பட்டியலுடன் ஒப்பிட்டு மீண்டும் தணிக்கை செய்யப்படுகின்றன, மேலும் அவை **இரு திசைகளிலும் மாறுகின்றன** — ஒரு வழங்குநர் இலவச அடுக்கை நிறுத்தினால் எண்ணிக்கை குறையும்; புதிய ஒன்று சேர்ந்தால் அது உயரும். பட்டியல் உண்மையில் கணக்கிடுவதையே நாங்கள் வெளியிடுகிறோம்; மேல்நோக்கி முழுமைப்படுத்தப்பட்ட சிறந்த சூழ்நிலையை ஒருபோதும் வெளியிடுவதில்லை.
⭐ OMNIROUTE உங்கள் பணத்தைச் சேமிக்கவும், உங்கள் வேலையை எளிதாக்கவும் உதவியிருந்தால் repo-வுக்கு நட்சத்திரமிடுங்கள்.
[](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 [🌍 உலகளாவியது](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 பிரேசில்](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)**
## 📈 கேட்வே தொடர்ந்து வளர்கிறது
| | v3.8.49 | **v3.8.50** | `v3.8.51+` |
| ----------------------------------- | :-----: | :----------------------: | :--------------------: |
| 🌐 வழங்குநர்கள் | 290 | **357** | மேலும் வரிசையில் உள்ளன |
| 🧠 தனித்துவமான அரட்டை மாதிரி ID-கள் | 1185 | **1312** | — |
| 🖼️ பாங்குப் பாலம் | — | 🆕 பார்வை + ஒலி + காணொளி | — |
| 📡 Radar இலவசப் பட்டியல் | — | 🆕 விருப்பத் தேர்வு | — |
| ⚖️ ஒதுக்கீடு-அறிந்த திட்டமிடல் | — | 🆕 Quota-Share | — |
| 📊 ஒதுக்கீட்டுத் தொலைஅளவியல் | — | 🆕 நேரலை | — |
**→ [செயல்திட்டம்](ROADMAP.md) — `v3.9.0 LTS`-ஐ நோக்கித் தடத்தில் பயணிக்கிறது**
## 🆓 நீங்கள் நிறுவியவுடன் வேலை செய்கிறது — விசைகள் இல்லை, கட்டமைப்பு இல்லை
```bash
# புதிய நிறுவல், பூஜ்ஜிய நற்சான்றுகள் — `auto` ஏற்கனவே வேலை செய்கிறது:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
ஒரு குறிப்பிட்ட இலவச பின்தளத்தை விரும்புகிறீர்களா? `oc/…` (OpenCode Free) ஐ நேரடியாக அழைக்கவும். பின்னர் `auto` க்கு மேம்படுத்தி OmniRoute ஐ தேர்வு செய்ய விடுங்கள்.📦 **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 ஒரு மெய்நிகர் காம்போவை உருவாக்கி, அதை நிகழ்நேரத்தில் மதிப்பிடும்:
##
### 🔀 அல்லது உங்களுக்கானதை உருவாக்குங்கள் — 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 சுயாதீன அடுக்குகள்)
📖 [தானியங்கு-காம்போ எஞ்சின்](docs/routing/AUTO-COMBO.md) · [மீள்திறன் வழிகாட்டி](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute-ஐ தனித்துவமாக்குவது எது?
📊 முழுமையான வழிமுறை & அம்சம் வாரியான விவரங்கள் vs 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** — உங்கள் முகவர் குழுவிற்கான உள்வரும் A2A ஒப்படைப்பு, Agent Card-இல் Conductor திறன்கள் மற்றும் Faro push-to-talk குரல் அரட்டையுடன் கூடிய டாஷ்போர்டு பலகம். → [A2A சேவையகம்](docs/frameworks/A2A-SERVER.md)
- **🛂 தகவமைப்பு அனுமதி & அதிகச்சுமைப் பாதுகாப்பு** — கனமான அரட்டை கோரிக்கைகள் 503 பிழையை வழங்குவதற்குப் பதிலாக வரிசைப்படுத்தப்படுகின்றன; ஒவ்வொரு இணைப்பிற்கும் அணுவியல் RPM சுழல் குத்தகைகள் பயன்படுத்தப்படுகின்றன. → [மீள்திறன் வழிகாட்டி](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ நியமப்படுத்தப்பட்ட `/v1/models` வரிசைப்படுத்தல்** — ஒவ்வொரு வழங்குநருக்கும் தொடர்ச்சியான, வழங்குநர் வாரியாகத் தொகுக்கப்பட்ட ஒரே தொகுதி (காம்போக்கள் முதலில் நிலைநிறுத்தப்படும்); அனைத்து பட்டியல் மூலங்களிலும் நிலையானது. → [API மேற்கோள்](docs/reference/API_REFERENCE.md)
- **🗜️ சுருக்க வலுப்படுத்தல்** — இயல்பாக இயக்கப்பட்ட விரிவாக்கத் தடுப்பு, DE / FR / JA + சீனம் (wényán) ஆகியவற்றுக்கான Caveman தொகுப்புகள், Gradle & .NET-க்கான RTK வடிப்பான்கள். → [சுருக்கம்](docs/compression/COMPRESSION_ENGINES.md)
- **💸 நேர்மையான நிலையான-கட்டணச் செலவு** — சந்தா / குறியீட்டுத் திட்ட வழங்குநர்கள் செலவுப் பகுப்பாய்வில் **$0** எனக் காட்டப்படுகின்றனர்; பட்ஜெட், ஒதுக்கீடு & வழித்தடத் தேர்வு தொடர்ந்து மதிப்பிடுகின்றன. → [API மேற்கோள்](docs/reference/API_REFERENCE.md)
- **⚖️ ஒதுக்கீடு-பகிர்வு வழித்தடத் தேர்வு** — பகிரப்பட்ட கணக்கின் ஒதுக்கீட்டைத் தொகுக்கப்பட்ட விசைகளிடையே நியாயமாகப் பிரிக்கிறது; செயலற்ற பகுதிகளைப் பிறருக்குக் கடனாக வழங்குவதால் வேலைத் திறன் பாதுகாக்கப்படுகிறது. → [மீள்திறன் வழிகாட்டி](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 ஒற்றைக் கட்டளை CLI/முகவர் அமைப்பு** — பதிவுசெய்யப்பட்ட 13 `setup-*` கட்டளைகள்; `omniroute run` 7 CLI-களைத் தொடங்குகிறது (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure`, ஊடாடும் வழங்குநர்+மாதிரி தேர்வி மற்றும் சூழல் வாரியான விருப்பங்களுடன் 10 இலக்குகளை ஆதரிக்கிறது. → [CLI ஒருங்கிணைப்புகள்](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ தொலைநிலைப் பயன்முறை** — வரம்பிடப்பட்ட டோக்கன்கள் (`connect` / `contexts` / `tokens`) மற்றும் VPS நிறுவல்களுக்கான `antigravity` OAuth உதவியைக் கொண்டு தொலைநிலை OmniRoute-ஐ இயக்குங்கள். → [தொலைநிலைப் பயன்முறை](docs/guides/REMOTE-MODE.md)
- **🧭 மேலும் நுண்ணறிவுள்ள தானியங்கி வழித்தடத் தேர்வு** — `auto/:` காம்போக்கள், **Fusion** (மாதிரிக் குழு + மதிப்பீட்டாளர்), பணியை உணரும் வழித்தடத் தேர்வு, ஒவ்வொரு கோரிக்கைக்குமான மாதிரி / பயன்முறை / USD-பட்ஜெட் மேலெழுதல்கள். → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ செருகக்கூடிய சுருக்கம்** — ஒன்றிணைக்கக்கூடிய 12 இயந்திரங்கள் + Compression Studios: LLMLingua-2, இரு-அடுக்கு Ultra, omniglyph, ஒவ்வொரு படிநிலைக்குமான துல்லியக் கட்டுப்பாடு, GCF v3.2, இழுத்து-மறுவரிசைப்படுத்தும் திருத்தி. → [சுருக்கம்](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ வெளிப்படையான MITM மறைகுறிநீக்கம் (TPROXY)** — ஒவ்வொரு SNI-க்குமான CA + நம்பிக்கைச் சேமிப்பக நிறுவியுடன், பதிலாள் சூழல் மாறிகளைப் புறக்கணிக்கும் CLI-களைக் கைப்பற்றுங்கள். → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 எங்கும் செலவுத் தொலைஅளவியல்** — ஒவ்வொரு முனைப்பிலும் `X-OmniRoute-*` செலவு/பயன்பாட்டுத் தலைப்புகள், கேச்-HIT சேமிப்புத் தலைப்பு, விசை வாரியான USD செலவு ஒதுக்கீடுகள். → [API மேற்கோள்](docs/reference/API_REFERENCE.md)
- **🧠 உங்கள் கட்டுப்பாட்டிலுள்ள நினைவகம்** — இயல்பாக முடக்கப்பட்டுள்ளது; விருப்பத்தேர்வாக int8 வெக்டர் குவாண்டமாக்கல் + வகைப்படுத்தப்பட்ட சிதைவு, ஒவ்வொரு கோரிக்கைக்குமான `x-omniroute-no-memory`. → [நினைவகம்](docs/frameworks/MEMORY.md)
- **🛡️ பாதுகாப்பு** — ஒவ்வொரு LLM வழித்தடத்திலும் prompt-injection தடுப்பு (red-team சோதனைத் தொகுப்பு), விருப்பத்தேர்வான நற்சான்று-மறைப்புப் பாதுகாப்பு வரம்பு (இரு திசைகளிலும் கசிந்த API விசைகள்/ரகசியங்களை மறைக்கிறது), இலவச DuckDuckGo இறுதி-வழி வலைத் தேடல் மற்றும் டாஷ்போர்டுக்கான விருப்பத்தேர்வான OIDC உள்நுழைவு நுழைவாயில் (கடவுச்சொல் உள்நுழைவு எப்போதும் கிடைக்கும்). → [பாதுகாப்பு வரம்புகள்](docs/security/GUARDRAILS.md)
- **🖼️ புதிய முனைப்புகள்** — `/v1/ocr` (Mistral OCR) மற்றும் `/v1/audio/translations` (Whisper-பாணி) ஆகியவை ஊடக இடைமுகத்தை முழுமையாக்குகின்றன. → [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`, உலாவி மொழியைத் தானாகக் கண்டறிதல், விசை வாரியான சாதனக் கண்காணிப்பு, root இல்லாத MITM நம்பிக்கை, zh-TW உள்ளூர்மயமாக்கல். → [சூழல்](docs/reference/ENVIRONMENT.md)
- **🤝 மேலும் பல வழங்குநர்கள் & முகவர்கள்** — கிளவுட் முகவர்கள் (Codex Cloud, Cursor, Devin, Jules), உலாவி + OAuth உள்நுழைவுடன் Grok Build (xAI), முதன்மைத் தர Ollama அட்டை, Claude Opus 5 & Sonnet 5, Kimi அதிகாரப்பூர்வக் கூட்டாண்மை (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… மற்றும் புதுப்பிக்கப்பட்ட **352-வழங்குநர் பட்டியல்**. → [வழங்குநர்கள்](docs/reference/PROVIDER_REFERENCE.md)
- **📡 வழித்தடத் தேர்வின் வெளிப்படைத்தன்மை** — ஒவ்வொரு பதிலும் அதற்குச் சேவையளித்த உத்தி/வழங்குநர்/தாமதத்தைக் குறிப்பிடும் `X-OmniRoute-Decision` தலைப்பைக் கொண்டுள்ளது; புதிய `cache-optimized` காம்போ உத்தி + Auto-Combo `cacheAffinity` காரணி, மீண்டும் வரும் கோரிக்கைகளைக் கேச் செய்யப்பட்ட முன்னொட்டைக் கொண்ட இணைப்பிற்குத் திருப்புகின்றன; மேலும் படிக்க மட்டும் இயலும் `/v1/auto-combo/{channel}/candidates` முனைப்பு, ஓர் `auto/*` சேனலின் நேரடி வேட்பாளர் தொகுப்பை வெளிப்படுத்துகிறது. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ உள்ளூர் செயல்திறன் & உள்கட்டமைப்பு** — ஒரே கிளிக்கில் உள்ளூர் Redis, Cloudflare Workers / Deno Deploy ரிலே நிறுவிகள், மேற்பார்வையிடப்பட்ட உட்பொதிக்கப்பட்ட சேவைகளாக Bifrost & Mux. → [உட்பொதிக்கப்பட்ட சேவைகள்](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 தொகுப்பில் மேலும் உள்ளவை** — செருகுநிரல் கட்டமைப்பு + சந்தை, Omni/Agent/GitHub திறன் கட்டமைப்புகள், Obsidian vault ஒருங்கிணைப்பு (22 MCP கருவிகள்), OpenAI-இணக்கமான Batch & Files API-கள், பொருள்சார் பதில் கேச், முன்னணிப் பட்டியல்களுடன் விளையாட்டுமயமாக்கல், ACP முகவர் கண்டறிதல் (உள்ளமைந்த 15 முகவர்கள்), BigQuery-க்கு அட்டவணைப்படுத்தப்பட்ட பதிவேடு ஏற்றுமதி, `auto/chaos` தவறு உட்செலுத்தல், Telegram bot பாலம், செயலிக்குள்ளான பதிப்பு மேலாளர் மற்றும் LMArena-ELO இலவச-வழங்குநர் தரவரிசைகள். → [ஆவணங்கள்](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)
## 🌐 357 AI வழங்குநர்கள் — 152 பட்டியலில் இலவசமாகக் குறிக்கப்பட்டவை
> **357 பதிவுசெய்யப்பட்ட வழங்குநர்கள்**, அதிகாரப்பூர்வமான அரட்டை, ஊடகம், தேடல், உள்ளூர், கிளவுட்-முகவர் மற்றும் அமைப்புத் தொகுப்புகள் முழுவதிலும் உள்ளனர்; இவர்களில் **152 வழங்குநர்கள் `hasFree: true` கண்டறிதல் மெட்டாடேட்டாவைக் கொண்டுள்ளனர்**. அரட்டை மாதிரிப் பதிவகம் **229 வழங்குநர்கள் / 2,554 தனித்துவமான வழங்குநர்-மாதிரி இணைகள் / 1,283 மூல மாதிரி ID-கள்** ஆகியவற்றை உள்ளடக்கியது; தனியான இலவசப் பயன்பாட்டு வரம்புப் பட்டியலில் **491 மாதிரி-வாரியான வரிசைகள்**, **35 சுழற்சி முறையில் புதுப்பிக்கப்படும் தொகுப்புகள்** மற்றும் **54 சுழற்சி முறையில் புதுப்பிக்கப்படும்/API விசை தேவையில்லாத நிரந்தர இலவச வழங்குநர்கள்** உள்ளனர். இவை வடிவமைப்பின்படியே வெவ்வேறு அடிப்படை எண்ணிக்கைகளைக் கொண்டுள்ளன; வரையறைகளும், ஒரே தொகுப்பு மீண்டும் கணக்கிடப்படாமல் செய்யப்பட்ட கணக்கீடுகளும் [வழங்குநர் குறிப்பு](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 என்றென்றும் இலவசம்
### 🧩 புதியது: 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%
```
குறியீட்டுத் தொகுதிகள், URL-கள், 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
நுண்ணறிவான கருவி-முடிவு வடிகட்டல், நகல் நீக்கம் & துண்டித்தல் (கட்டளை-விழிப்புணர்வுடன்)
சுருக்கமாக்கல் + பழைய சுற்றுகளைப் படிப்படியாகக் காலாவதியாக்குதல்
10
LLMLingua-2
MobileBERT ONNX வழியான ML பொருள்சார் நீக்கம் — குறியீட்டுக்குப் பாதுகாப்பானது, ஒத்திசைவற்றது
11
Ultra
விருப்பத்தேர்வான சிறு-மாதிரி (SLM) அடுக்குடன் கூடிய அனுமான விதி அடிப்படையிலான டோக்கன் நீக்கம்
12
OmniGlyph
நேரடி Anthropic இணைப்பில் அளவிடப்பட்ட Claude Fable 5-க்கான சோதனைமுறை சூழல்-படமாக குறியாக்கம்; வழங்குநர் ரசீதுகள் கிடைக்கும் வரை GPT 5.6 டிரான்ஸ்ஃபார்மர்கள் fail-closed நிலையில் தொடர்கின்றன. நான்கு சுருக்கச் சுயவிவரங்கள் (இயல்புநிலையாக aggressive, balanced, coding-safe, passthrough) (மிகவும் தீவிரமானது; தேர்வுசெய்தால் மட்டும்)
குறியீட்டுத் தொகுதிகள், URL-கள் மற்றும் கட்டமைக்கப்பட்ட தரவு ஆகியவை பைட் அளவில் துல்லியமாக **எப்போதும் பாதுகாக்கப்படுகின்றன**. **ஒற்றைக் கிளிக் முன்னமைவுகள்** என்ஜின்களை ஒன்றிணைக்கின்றன:
முறை
சேமிப்பு
மிகவும் ஏற்றது
🪶 Lite
~15%
எப்போதும் இயக்கப்பட்டிருக்கும் பாதுகாப்பான இயல்புநிலை
🪨 Standard (Caveman)
~30%
தினசரி குறியீட்டாக்கம்
⚡ Aggressive
~50%
கருவிகள் அதிகம் பயன்படுத்தப்படும் நீண்ட அமர்வுகள்
🔥 Ultra
~75%
அதிகபட்ச சேமிப்பு
🧰 RTK
60–90%
Shell/test/build/git வெளியீடு
🔗 Stacked (RTK → Caveman)
78–95%
கலப்பு அறிவுறுத்தல்கள் + கருவிப் பதிவுகள்
**உண்மையான எடுத்துக்காட்டு — Standard முறை:**
> **முன்பு (69 டோக்கன்கள்):** _"உங்கள் React கூறு மீண்டும் ரெண்டர் செய்யப்படுவதற்கான காரணம், ஒவ்வொரு ரெண்டர் சுழற்சியிலும் நீங்கள் ஒரு புதிய ஆப்ஜெக்ட் குறிப்பை உருவாக்குவதாக இருக்கலாம். ஒரு inline ஆப்ஜெக்டை prop ஆக அனுப்பும்போது, React-இன் shallow comparison அதை ஒவ்வொரு முறையும் வேறொரு ஆப்ஜெக்டாகக் கருதுகிறது; இதனால் மீள் ரெண்டர் தூண்டப்படுகிறது. அந்த ஆப்ஜெக்டை நினைவகப்படுத்த useMemo-ஐப் பயன்படுத்துமாறு பரிந்துரைக்கிறேன்."_
>
> **பிறகு (19 டோக்கன்கள்):** _"ஒவ்வொரு ரெண்டரிலும் புதிய ஆப்ஜெக்ட் குறிப்பு. Inline ஆப்ஜெக்ட் prop = புதிய குறிப்பு = மீள் ரெண்டர். useMemo-வில் சுற்றவும்."_
>
> **அதே பதில். 72% குறைவான டோக்கன்கள். துல்லிய இழப்பு பூஜ்ஜியம்.** ✅
**PT-BR எடுத்துக்காட்டு — [Troglodita](https://github.com/leninejunior/troglodita) முறை:**
> **முன்பு (42 டோக்கன்கள்):** _"ஒவ்வொரு ரெண்டரிங் சுழற்சியிலும் ஒரு புதிய ஆப்ஜெக்ட் குறிப்பு உருவாக்கப்படுவதால், காம்போனென்ட் மீண்டும் ரெண்டர் செய்யப்படுகிறது. `useMemo`-ஐப் பயன்படுத்தப் பரிந்துரைக்கிறேன்."_
>
> **பிறகு (12 டோக்கன்கள்):** _"மறு ரெண்டர்: ஒவ்வொரு சுழற்சியிலும் புதிய குறிப்பு (இன்லைன் ஆப்ஜெக்ட் மீண்டும் உருவாக்கப்படுகிறது). `useMemo` பயன்படுத்தவும்."_
>
> **அதே பதில். ~70% குறைவான டோக்கன்கள். தொழில்நுட்பத் துல்லியம் மாறவில்லை.** ✅
### 🎚️ எஞ்சின்களுக்கும் அப்பால் — வெளியீட்டு பாணிகள், தகவமைப்பு டயல் மற்றும் ஒவ்வொரு கோரிக்கைக்குமான கட்டுப்பாடு
மேலே உள்ள 12 எஞ்சின்கள் **உள்ளே** செல்வதைச் சுருக்குகின்றன. மேலும் மூன்று அடுக்குகள் **எப்படி**, **எப்போது**, மற்றும் **எது வெளியே வருகிறது** என்பதை வடிவமைக்கின்றன:
- **🪄 வெளியீட்டு பாணிகள்** _(வெளியீட்டு-அச்சு வழிநடத்தல்)_ — தீர்மானகரமான, கேச்-பாதுகாப்பான பதில்-வடிவமைப்பு அறிவுறுத்தல்களைச் செலுத்தும்; இவற்றை ஒன்றிணைக்கலாம், ஒவ்வொன்றும் `lite` / `full` / `ultra` தீவிரத்தில் கிடைக்கும். ஒரு பாணியைச் சேர்க்க, ரெஜிஸ்ட்ரியில் ஒரு வரி பதிவு போதும்:
- **சுருக்கமான உரைநடை** — நிரப்பு வார்த்தைகள் / ஆர்டிக்கிள்கள் / தயக்கமூட்டும் சொற்களை நீக்கவும்; தொழில்நுட்ப உள்ளடக்கத்தைத் துல்லியமாக வைத்திருக்கவும்.
- **குறைவான குறியீடு** — "சோம்பேறி மூத்த டெவலப்பர்" YAGNI: செயல்படும் மிகச்சிறிய மாற்றம், கோரப்படாத கட்டமைப்பு வேண்டாம்.
- **போனிடெயில் (சோம்பேறி மூத்த டெவலப்பர்)** — YAGNI படிகளில் ஏறி, மூலக் காரணத்தைச் சரிசெய்து, செயல்படும் மிகச்சிறிய diff-ஐ உருவாக்கவும்.
- **எனக்கு ADHD உள்ளது (செயல்-முதலில்)** — அடுத்த செயலை முதலில் காட்டவும், படிகளுக்கு எண்கள் இடவும், ஒரே ஒரு உறுதியான அடுத்த படியை வழங்கவும், முன்னுரை வேண்டாம்.
- **சுருக்கமான CJK (文言)** — செம்மொழிச் சீனத்தின் அதி-சுருக்கமான பாணி (`zh` மொழியமைவுக்கு மட்டும்).
- **🎯 தகவமைப்பு சூழல்-பட்ஜெட்** _(டயல்)_ — ஒரே ஆன்/ஆஃப் டோக்கன் வரம்புக்குப் பதிலாக, **மாடலின் சூழல் சாளரத்திற்குள் பொருந்துவதற்குத்** தேவையான அளவு வரை மட்டுமே, மிக மலிவான மற்றும் குறைந்த இழப்புடைய எஞ்சின்களைப் படிப்படியாக இயக்கும். கொள்கை: `reserve-output` (இயல்புநிலை, மாடலைக் கருத்தில் கொள்வது) · `percentage` · `absolute`. பயன்முறை: `floor` (பொருந்துவதை உறுதிசெய்யும்) · `replace-autotrigger` (உங்கள் வெளிப்படையான தேர்வே முன்னுரிமை பெறும்) · `off` (மரபு வரம்பு).
- **🎛️ சுருக்கம் எங்கு தீர்மானிக்கப்படுகிறது** _(முன்னுரிமை, அதிகம் → குறைவு)_ — ஒவ்வொரு கோரிக்கைக்குமான `x-omniroute-compression` ஹெடர் › ரூட்டிங்-காம்போ ஓவர்ரைடு › செயலில் உள்ள பெயரிடப்பட்ட சுயவிவரம் › தகவமைப்பு / தானியங்கு-தூண்டல் › பேனல் இயல்புநிலை › ஆஃப். பயன்படுத்தப்பட்ட திட்டம் `X-OmniRoute-Compression: ; source=` பதில் ஹெடரில் திருப்பி அனுப்பப்படும்.
டோக்கன் வரம்பின் அடிப்படையில் தானியங்கு-தூண்டலை அமைக்கவும், தகவமைப்பு டயலை இயக்கவும், பெயரிடப்பட்ட சுயவிவரத்தைப் பின் செய்யவும், ஒவ்வொரு கோரிக்கைக்கும் ஒருமுறை மட்டும் பொருந்தும் அமைப்பை வழங்கவும் அல்லது ஒவ்வொரு ரூட்டிங் காம்போவுக்கும் ஒரு பைப்லைனை ஒதுக்கவும் — பணிச்சுமைக்கு எது பொருந்துகிறதோ அதைப் பயன்படுத்துங்கள். விருப்பத்தேர்வாக இயக்கக்கூடிய ஆஃப்லைன் **மதிப்பீட்டு ஹார்னஸ்** (`npm run eval:compression`), ஒரு மாற்றத்தைப் பயன்பாட்டிற்கு உயர்த்துவதற்கு முன், பின் செய்யப்பட்ட கார்பஸில் நம்பகத்தன்மையையும் சேமிப்பையும் மதிப்பிடுகிறது.
📖 [`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).
டாஷ்போர்டு `http://localhost:20128`-இல் · API `http://localhost:20128/v1`-இல்.
**2) இலவச வழங்குநரை இணைக்கவும் (பதிவுசெய்தல் தேவையில்லை)**
டாஷ்போர்டு → **வழங்குநர்கள்** → **Kiro AI**-ஐ (இலவச Claude, ஒரு கணக்கிற்கு மாதம் ~50 கிரெடிட்கள்) அல்லது **OpenCode Free**-ஐ (அங்கீகாரம் தேவையில்லை) இணைக்கவும் → முடிந்தது.
**3) உங்கள் கோடிங் கருவியை இதற்குச் சுட்டிக்காட்டவும்**
```txt
அடிப்படை URL: http://localhost:20128/v1
API விசை: [டாஷ்போர்டு → எண்ட்பாயிண்ட்களில் இருந்து நகலெடுக்கவும்]
மாடல்: auto (எந்த உள்ளமைவும் தேவையில்லாத ஸ்மார்ட் ரூட்டிங் — அல்லது ஏதேனும் வழங்குநர்/மாடல்)
```
**4) அது செயல்படுகிறதா என்பதைச் சரிபார்க்கவும்**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
நீங்கள் இணைத்த மாடல்கள் பட்டியலிடப்பட்டிருப்பதைப் பார்க்க வேண்டும். 🎉 அவ்வளவுதான் — கோடிங் செய்யத் தொடங்குங்கள்; OmniRoute உங்களுக்காகத் தானாக ரூட் செய்து, தேவைப்பட்டால் மாற்று வழிக்கு மாறும்.
உங்கள் கிளையண்டால் தனிப்பயன் ஹெடர்களை அனுப்ப முடியாவிட்டால், OmniRoute டோக்கனாக்கப்பட்ட இணக்கத்தன்மை மாற்றுப்பெயர்களையும் வழங்குகிறது:
```txt
OpenAI பட்டியல்: http://localhost:20128/vscode/YOUR_KEY/
OpenAI மாடல்கள்: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI அரட்டை: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI பதில்கள்: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama அரட்டை: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama குறிச்சொற்கள்: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
`Authorization: Bearer ...`-ஐ இணைக்க முடியாத கிளையண்ட்களுக்கு மட்டும் இவற்றைப் பயன்படுத்தவும். ஹெடர் அங்கீகாரமே பரிந்துரைக்கப்படும் பயன்முறையாகும்.
## 📦 மேலும் நிறுவல் முறைகள் — 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 டெஸ்ட் ரன்னர் + வைடெஸ்ட் — 39,000+ நிலையான சோதனை அறிவிப்புகள் 5,100+ கண்காணிக்கப்பட்ட சோதனை கோப்புகளில் (யூனிட், இன்டெக்ரேஷன், 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.51 · Node ≥22.22.2 · MIT உரிமம் · omniroute.online