# 🚀 OmniRoute — இலவச AI நுழைவாயில்
**உருவாக்கியவர் [Diego Souza](https://github.com/diegosouzapw)**
## 💰 மூன்றாம் தரப்பு இலவச அடுக்குகள் முழுவதும் மாதத்திற்கு ~1.62B டோக்கன்கள்
> **உங்கள் சொந்த வழங்குநர் கணக்குகளைப் பயன்படுத்துங்கள்.** இது தனித்தனியாகத் தகுதியுடைய மூன்றாம் தரப்பு இலவச அடுக்குகளின் மதிப்பிடப்பட்ட மொத்தமாகும்; OmniRoute வழங்கும் டோக்கன் மானியம் அல்ல. பதிவு செய்து, தேவைப்படும் இடங்களில் நற்சான்றுகளைப் பெற்று, நீங்கள் பயன்படுத்தக்கூடிய வழங்குநர்களை இணைக்கவும்; ஒவ்வொரு வழங்குநரும் அதன் வரம்புகள், கிடைப்புநிலை மற்றும் விதிமுறைகளைக் கட்டுப்படுத்துகிறது.
>
> இலவச அடுக்குகளை கைமுறையாகச் சேர்ப்பது சிரமமானது — டஜன் கணக்கான SDKகள், டஜன் கணக்கான விகித வரம்புகள், மேலும் உண்மையில் உங்களிடம் எவ்வளவு உள்ளது என்ற தெளிவின்மை. OmniRoute, **34 மீண்டும் நிகழும் pool keys முழுவதும் 465 இலவச-அடுக்கு உள்ளீடுகளை** பட்டியலிட்டு, பகிரப்பட்ட pool அடிப்படையில் தனித்தன்மையாக்கப்பட்ட **வெளியிடப்பட்ட நேர்மறை மாதாந்திர பட்ஜெட்டைக் கொண்ட 17 pools மற்றும் ஒவ்வொரு மாதிரிக்குமான ஐந்து Groq caps** ஆகியவற்றிலிருந்து token தலைப்புக் கணக்கை உருவாக்குகிறது. பிராந்திய அடையாளச் சரிபார்ப்புக்குப் பிறகே திறக்கப்படும் ஒதுக்கீடுகள் (தற்போது: ModelScope) தனியாகக் காட்டப்படுகின்றன; பிராந்திய அடையாளச் சரிபார்ப்புக்குப் பின்னால் +~6M, மேலும் அவை தலைப்புக் கணக்கில் ஒருபோதும் சேர்க்கப்படுவதில்லை. முடிவை dashboard-ல் (`/dashboard/free-tiers`) தொடர்ந்து காணலாம்.
> நேரடியாகப் புதுப்பிக்கப்படும் `/dashboard/free-tiers` பக்கத்தின் அசைவூட்டப்பட்ட சுருக்கம். முழுமையான வழிமுறை (pool dedupe, credit tiers, provider terms): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> இந்த எண்ணிக்கைகள் live catalog-க்கு எதிராக இரண்டு வாரங்களுக்கு ஒருமுறை மீண்டும் தணிக்கை செய்யப்படுகின்றன; மேலும் **இரு திசைகளிலும் மாறக்கூடும்** — ஒரு provider இலவச அடுக்கை முடித்தால் எண்ணிக்கை குறையும்; புதிய ஒன்று வந்தால் அது உயரும். catalog உண்மையில் கணக்கிடுவதையே நாங்கள் வெளியிடுகிறோம்; மேலே வட்டமிடப்பட்ட சிறந்த நிலையை ஒருபோதும் வெளியிடுவதில்லை.
OMNIROUTE உங்கள் பணத்தைச் சேமிக்கவும், உங்கள் வேலையை எளிதாக்கவும் உதவியிருந்தால் ⭐ repo-க்கு Star அளிக்கவும்.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 சமூகத்தில் இணையுங்கள்
**👋 பராமரிப்பாளரைப் பின்தொடருங்கள் — புதிய providers, releases மற்றும் tips-ஐ முதலில் பெறுங்கள்:**
[](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)
**கேள்விகள், provider tips, roadmap மற்றும் support → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 கேட்வே தொடர்ந்து வளர்கிறது
## 🆓 நிறுவி, ஒரு வழங்குநரை இணைத்து, பின்னர் ஒரு endpoint வழியாக வழிமாற்றுங்கள்
```bash
# ஒரு வழங்குநரை இணைத்த பிறகு, Dashboard → Endpoints என்பதிலிருந்து உங்கள் OmniRoute key-ஐ நகலெடுக்கவும்:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto`-க்கு தகுதியான route தேவை. புதிதாக நிறுவிய நிலையில் தகுதியான keyless இலக்குகள் எதுவும் இல்லாமல் இருக்கலாம்; மேலும் keyless வழங்குநர் மூன்றாம் தரப்பு clients-ஐ நிராகரிக்கலாம். `tos: avoid` எனக் குறிக்கப்பட்ட, Kiro உட்பட, வழங்குநர்கள் தானியங்கி வழிமாற்றத்திலிருந்து இயல்பாக விலக்கப்படுகிறார்கள்; ஒரு கணக்கை இணைப்பது அந்த அமைப்பை மாற்றாது. வழங்குநரைத் தேர்ந்தெடுப்பதற்கு முன் [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md)-ஐப் பார்க்கவும்.📦 **Python, Node.js, PHP, மற்றும் cURL**-க்கான நகலெடுத்து ஒட்டக்கூடிய quickstart scripts → [`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 பயனர்களுக்கு பயனளிக்கும் ஒரு தாராளமான இலவச பதிவு கூப்பனுடன் மற்றொரு வழங்குநரைத் தெரியுமா? ஒரு சிக்கலைத் திறந்து, அதை இங்கே சேர்ப்போம்.
## 🎯 Combos — முதன்மை அம்சம்
> **combo** என்பது OmniRoute **தானாகவே** வழித்தடப்படுத்தும் மாடல்களின் சங்கிலியாகும். ஒதுக்கீடு தீர்ந்துவிட்டாலோ, வழங்குநர் செயலிழந்தாலோ அல்லது செலவுகள் திடீரென அதிகரித்தாலோ, combo அடுத்த தகுதியான, சீராகச் செயல்படும் மாடலுக்கு மாறும். 🛡️
### ⚡ எந்த உள்ளமைவும் தேவையில்லை — `auto`-ஐ மட்டும் பயன்படுத்துங்கள்
combo எதையும் உருவாக்கத் தேவையில்லை. உங்கள் மாடலை `auto` (அல்லது அதன் ஒரு மாறுபாடு) என அமைத்தால், இணைக்கப்பட்டுள்ள உங்கள் வழங்குநர்களிலிருந்து OmniRoute ஒரு மெய்நிகர் combo-வை உருவாக்கி, நேரடியாக மதிப்பெண்ணிடும்:
🧑💻 குறியீடு உருவாக்குவதற்குத் தரத்திற்கு முதலிடம் அளிக்கும் எடைகள்
auto/fast
⚡ மிகக் குறைந்த தாமதத்திற்கு முதலிடம்
auto/cheap
💰 ஒரு token-க்கான மிகக் குறைந்த செலவுக்கு முதலிடம்
auto/subscription
🎟️ நீங்கள் ஏற்கனவே பணம் செலுத்தும் சந்தா ஒதுக்கீடு மட்டும் — பயன்படுத்த முடியாவிட்டால் முற்றிலுமாக நிறுத்தப்படும்; கட்டணம் விதிக்கக்கூடிய மாற்றுவழிக்கு ஒருபோதும் செல்லாது (வழிகாட்டி)
auto/thrifty
🪜 முதலில் திட்ட ஒதுக்கீடு, பின்னர் மிகக் குறைந்த கட்டண விருப்பங்களுக்கு ஒவ்வொரு படியாக நகரும் — திட்டம் மீட்டமைக்கப்பட்டதும் மீண்டும் அதற்குத் திரும்பும் (வழிகாட்டி)
auto/offline
🔋 அதிக ஒதுக்கீடு / வீத வரம்பு余裕க்கு முதலிடம்
auto/smart
🔭 தரத்திற்கு முதலிடம் + சிறந்த மாடல்களைக் கண்டறிய 10% ஆய்வு
auto/lkgp
📌 கடைசியாகச் சிறப்பாகச் செயல்பட்ட வழங்குநருடன் தொடர்வதை வெளிப்படையாக உறுதிப்படுத்துகிறது
auto/chaos
🧪 மாடல்களின் குழுவுக்கு இணையாகப் பிரித்து அனுப்புகிறது (ஒவ்வொரு வழங்குநருக்கும் ஒன்று, இயல்புநிலையாக 5), பின்னர் ஒரு பதிலை வழங்குகிறது; ஒவ்வொரு குழு மாடலுக்கும் ஒரு மேல்நிலை அழைப்பு செய்யப்படும், இது故障ச் செலுத்தல் அல்ல
##
### 🔀 அல்லது நீங்களே உருவாக்குங்கள் — 20 வழித்தட உத்திகள்
அனைத்து **20** உத்திகளையும் — ஒவ்வொரு combo படியிலும் கலந்து பொருத்தலாம்:
#
உத்தி
இது என்ன செய்கிறது
1
priority
முதல் இலக்குக்கு முன்னுரிமை அளிக்கும் வரிசைப் பட்டியல் — அடுத்த இலக்குக்குச் செல்லும் முன் ஒவ்வொன்றையும் முழுமையாகப் பயன்படுத்தும் 🥇
2
fill-first
அடுத்ததற்குச் செல்லும் முன் ஒவ்வொரு இலக்கின் ஒதுக்கீட்டையும் முழுமையாகப் பயன்படுத்தும்
3
weighted
ஒவ்வொரு இலக்கின் எடையின் அடிப்படையிலான எடையிட்ட சீரற்ற தேர்வு
4
round-robin
இலக்குகளை வரிசையாகச் சுழன்று பயன்படுத்தும்
5
p2c
இரண்டு தேர்வுகளின் ஆற்றலைப் பயன்படுத்தும் சீரற்ற சுமைச் சமநிலைப்படுத்தல்
6
least-used
தற்போது மிகக் குறைந்த சுமையைக் கொண்ட இலக்கைத் தேர்ந்தெடுக்கும்
7
random
சீரான சீரற்ற தேர்வு (நகல்கள் நீக்கப்படும்)
8
strict-random
மீண்டும் வரும் தேர்வுகளின் நகல்களை நீக்காமல் சீரற்ற முறையில் தேர்ந்தெடுக்கும் 🎲
9
cost-optimized
நேரடி பட்டியல் விலைகளின் அடிப்படையில் ஒவ்வொரு கோரிக்கைக்குமான $ செலவைக் குறைக்கும் 💸
10
headroom
அதிக மீதமுள்ள ஒதுக்கீட்டைக் கொண்ட இலக்கைத் தேர்ந்தெடுக்கும்
11
quota-weighted
ஒதுக்கீடு தீர்ந்த கணக்குகளைத் தவிர்த்து, மீதமுள்ள ஒதுக்கீடு ÷ செயலிலுள்ள சுமை என்ற விகிதத்தில் தேர்ந்தெடுக்கும் — ஏற்கனவே உள்ள உரையாடல்கள் அதே இடத்தில் நிலைநிறுத்தப்படும் ⚖️
12
reset-window
ஒதுக்கீட்டுச் சாளரம் மிக விரைவில் மீட்டமைக்கப்படும் இலக்கை விரும்பித் தேர்ந்தெடுக்கும்
13
reset-aware
ஒதுக்கீடு மீட்டமைக்கப்படும் நேரத்தின் அடிப்படையில் தரவரிசைப்படுத்தும் — குறுகிய சாளரங்களுக்கு முதலிடம் 📊
14
context-relay
நீண்ட உரையாடல்களுக்கு இலக்குகளுக்கு இடையில் சூழலைக் கையளிக்கும் 🧠
15
context-optimized
தற்போதைய சூழல் அளவுக்கு மிகவும் பொருத்தமானதைத் தேர்ந்தெடுக்கும்
16
cache-optimized
மீண்டும் பயன்படுத்தக்கூடிய ஒவ்வொரு prompt முன்னொட்டையும் அதே கணக்கில் நிலைநிறுத்தும் — prompt-cache வெற்றிகளை அதிகரிக்கும் 🎯
17
lkgp
கடைசியாகச் சிறப்பாகச் செயல்பட்ட பாதை — கடைசியாக வெற்றியடைந்த வழங்குநரில் நிலைநிறுத்தி, பின்னர் விதிகளின் அடிப்படையில் மாற்றுவழிக்குச் செல்லும்
18
auto
ஒவ்வொரு இணைப்பிலும் 16 காரணிகளைக் கொண்ட நேரடி மதிப்பீடு 🤖
19
fusion
மாடல்களின் குழுவுக்குப் பிரித்து அனுப்பி, ஒரு மதிப்பீட்டாளர் ஒரே பதிலாக ஒருங்கிணைப்பார் 🧬
20
pipeline
படிகளைச் சங்கிலியாக இணைக்கும் — ஒவ்வொரு இலக்கின் வெளியீடும் அடுத்ததற்கான உள்ளீடாகும் 🔗
Auto-Combo இயந்திரம் ஒவ்வொரு சாத்தியமான தேர்வையும் **16 காரணிகளின்** அடிப்படையில் மதிப்பிடுகிறது (நிலை, ஒதுக்கீடு, செலவு, தாமதம், பணிப் பொருத்தம், தரம், அமர்வு கிடைக்கும் தன்மை…) — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)-ஐப் பார்க்கவும்.
##
### 🧱 மீண்டெழும் திறன் உள்ளமைக்கப்பட்டுள்ளது (3 சுயாதீன அடுக்குகள்)
📖 [Auto-Combo இயந்திரம்](docs/routing/AUTO-COMBO.md) · [மீண்டெழும் திறன் வழிகாட்டி](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute-ஐ தனித்துவமாக்குவது என்ன
📊 9router, OpenRouter, CLIProxyAPI மற்றும் LiteLLM உடனான முழு முறையியல் & ஒவ்வொரு அம்சத்தின் விவரங்கள் → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRoute-ஐ ஆதரிக்கவும்
OmniRoute MIT உரிமம் பெற்றது மற்றும் வெளிப்படையாகப் பராமரிக்கப்படுகிறது. இது உங்கள் நேரத்தையோ பணத்தையோ சேமித்தால், இதைச் சுயாதீனமாக வைத்திருக்க உதவும் வழிகள் இங்கே உள்ளன — உங்களுக்கு ஏற்றதைத் தேர்ந்தெடுக்கவும். ஆதரவுத்தொகை ஒருபோதும் வழிச்செலுத்தல் முன்னுரிமையைப் பாதிக்காது; அது தரவரிசையை அல்ல, பார்வைத்தன்மையையே வழங்குகிறது.
⚠️ ஒவ்வொரு நாணயத்தையும் காட்டப்பட்டுள்ள நெட்வொர்க்கில் மட்டுமே அனுப்பவும் — தவறான நெட்வொர்க்கில் அனுப்பினால் நிதியை இழக்க நேரிடலாம்.
🐛 பிழையைக் கண்டீர்களா அல்லது கருத்து உள்ளதா? ஒரு [கலந்துரையாடலை](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.54** வரையிலான சமீபத்திய சிறப்பம்சங்கள். முழு வரலாறு [`CHANGELOG.md`](CHANGELOG.md)-இல் உள்ளது.
- **⚖️ `quota-weighted` routing** — 20-வது combo strategy, quota தீர்ந்த கணக்குகளைத் தவிர்த்து, மீதமுள்ளவற்றில் leftover quota ÷ in-flight load என்ற விகிதத்தில் தேர்வு செய்கிறது; ஏற்கனவே உள்ள conversations அதே கணக்குகளில் நிலைநிறுத்தப்படுகின்றன. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless mode** — `omniroute serve --headless` (அல்லது `OMNIROUTE_HEADLESS=1`) dashboard மற்றும் dashboard-க்கு மட்டும் உரிய subsystems-ஐ முடக்கி, `/v1/*` proxy engine-ஐ மட்டும் இயக்குகிறது. → [Headless Mode](docs/guides/HEADLESS.md)
- **🔎 Model discovery** — `/v1/models` capability, context, kind மற்றும் text அடிப்படையில் வடிகட்டுகிறது; `POST /v1/models/query` அதே ஒவ்வொரு key-க்குமான visibility-யுடன், குறுகிய deterministic shortlist-ஐ வழங்குகிறது. → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 Per-key routing control** — `forcedModel` மூலம் ஒரு API key-ஐ ஒரு model அல்லது combo-வில் pin செய்யலாம்; மேலும் ஒரு key-க்கான models மற்றும் combos-ஐ அணுவகையாகச் சேர்க்கவோ நீக்கவோலாம் (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Finer PII controls** — ஒவ்வொரு வகைக்குமான தேர்வு, சரிபார்க்கப்பட்ட custom masking patterns-கள் 20 வரை, மேலும் ஒவ்வொரு வகைக்குமான detection counters; masking இயல்பாக முடக்கப்பட்டே இருக்கும். → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 மொழிகள்** — dashboard, docs mirrors மற்றும் CLI ஆகியவற்றில் ஆதரவு; `npm run i18n:add-locale` ஒரே command-இல் ஒரு மொழியை எல்லா இடங்களிலும் சேர்க்கிறது. → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — உங்கள் agent fleet-க்கான inbound A2A delegation, Agent Card-இல் Conductor skills, மேலும் Faro push-to-talk voice chat கொண்ட dashboard panel. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptive admission & overload protection** — heavyweight chat requests, 503 பிழை வழங்குவதற்குப் பதிலாக queue செய்யப்படுகின்றன; ஒவ்வொரு connection-க்கும் atomic RPM rolling leases பயன்படுத்தப்படுகின்றன. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Canonical `/v1/models` ordering** — ஒவ்வொரு provider-க்கும் ஒரே தொடர்ச்சியான provider-grouped block; combos முதலில் pin செய்யப்படுகின்றன, மேலும் ஒவ்வொரு catalog source-இலும் வரிசை நிலையாக இருக்கும். → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ Compression hardening** — இயல்பாக இயக்கப்பட்ட inflation guard, DE / FR / JA மற்றும் Chinese (wényán)-க்கான Caveman packs, Gradle & .NET-க்கான RTK filters. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 நேர்மையான flat-rate cost** — subscription / coding-plan providers-ன் cost analytics-இல் மதிப்பு **$0** எனப் பதிவாகிறது; budget, quota & routing ஆகியவை தொடர்ந்து மதிப்பீடு செய்கின்றன. → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share routing** — pooled keys முழுவதும் shared account-ன் quota-வை நியாயமாகப் பிரிக்கிறது; idle slices-ஐ கடனாக வழங்குவதன் மூலம் work-conserving முறையில் செயல்படுகிறது. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 ஒரே command-இல் CLI/agent அமைப்பு** — 15 பதிவு செய்யப்பட்ட `setup-*` commands; `omniroute run` 7 CLIs-ஐ (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) தொடங்குகிறது; `omniroute configure` interactive provider+model picker மற்றும் ஒவ்வொரு context-க்குமான favorites உடன் 11 targets-ஐ ஆதரிக்கிறது. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Remote mode** — scoped tokens (`connect` / `contexts` / `tokens`) மூலம் தொலைநிலை OmniRoute-ஐ இயக்கலாம்; VPS installs-க்காக `antigravity` OAuth helper-உம் உள்ளது. → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 மேம்பட்ட auto-routing** — `auto/:` combos, **Fusion** (model panel + judge), task-aware routing, ஒவ்வொரு request-க்குமான model / mode / USD-budget overrides. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Pluggable compression** — ஒன்றுடன் ஒன்று இணைக்கக்கூடிய 12 engines + Compression Studios: LLMLingua-2, two-tier Ultra, omniglyph, ஒவ்வொரு step-க்குமான fidelity gate, GCF v3.2, drag-reorder editor. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Transparent MITM decrypt (TPROXY)** — proxy env vars-ஐ புறக்கணிக்கும் CLIs-ஐ capture செய்யலாம்; ஒவ்வொரு SNI-க்கும் CA + trust-store installer உள்ளது. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 எங்கும் Cost telemetry** — ஒவ்வொரு endpoint-இலும் `X-OmniRoute-*` cost/usage headers, cache-HIT savings header, ஒவ்வொரு key-க்குமான USD spend quotas. → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 நீங்கள் கட்டுப்படுத்தும் Memory** — இயல்பாக முடக்கப்பட்டுள்ளது; opt-in int8 vector quantization + typed decay, ஒவ்வொரு request-க்குமான `x-omniroute-no-memory`. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ Security** — ஒவ்வொரு LLM route-இலும் prompt-injection guard (red-team suite), opt-in credential-masking guardrail (இரு திசைகளிலும் கசிந்த API keys/secrets-ஐ redacts செய்கிறது), அவசரகால இறுதி முயற்சியாக இலவச DuckDuckGo web search, மேலும் dashboard-க்கான விருப்ப OIDC login gate (password login எப்போதும் கிடைக்கும்). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ புதிய endpoints** — `/v1/ocr` (Mistral OCR) மற்றும் `/v1/audio/translations` (Whisper-style) ஆகியவை media surface-ஐ நிறைவு செய்கின்றன. → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 Image / video / audio generation** — media-க்கான ஒரே API: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, மேலும் ElevenLabs போன்ற speech providers. → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 Deployment & ops** — reverse-proxy `basePath`, browser-language auto-detect, ஒவ்வொரு key-க்குமான device tracking, root-less MITM trust, zh-TW localization. → [Environment](docs/reference/ENVIRONMENT.md)
- **🤝 மேலும் providers & agents** — cloud agents (Codex Cloud, Cursor, Devin, Jules), browser + OAuth login உடன் Grok Build (xAI), first-class card கொண்ட Ollama, Claude Opus 5 & Sonnet 5, Kimi official partnership (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… மேலும் புதுப்பிக்கப்பட்ட **388-provider catalog**. → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Routing transparency** — ஒவ்வொரு response-உம் அதை வழங்கிய strategy/provider/latency-ஐ குறிப்பிடும் `X-OmniRoute-Decision` header-ஐ கொண்டுள்ளது; புதிய `cache-optimized` combo strategy மற்றும் Auto-Combo `cacheAffinity` factor ஆகியவை repeat requests-ஐ cached prefix-ஐ வைத்திருக்கும் connection-க்கு மீண்டும் வழிமாற்றுகின்றன; மேலும் read-only `/v1/auto-combo/{channel}/candidates` endpoint, `auto/*` channel-ன் live candidate pool-ஐ வெளிப்படுத்துகிறது. → [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` இணை பல-மாதிரி fan-out, Telegram bot பாலம், பயன்பாட்டிலேயே உள்ள பதிப்பு மேலாளர் மற்றும் LMArena-ELO இலவச வழங்குநர் தரவரிசைகள். → [ஆவணங்கள்](docs/README.md)
## 🤖 இணக்கமான CLI-கள் & குறியீட்டு முகவர்கள்
> ஒரு அமைப்பு — `http://localhost:20128/v1` — மற்றும் **எல்லா** AI IDE அல்லது CLI-யும் இலவசம் மற்றும் குறைந்த செலவு மாடல்களில் இயங்கும்.
+ இதனுடன் கூட வேலை செய்யும் · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · எந்த OpenAI-இன் இணக்கமான கருவியும்
📖 அனைத்து 39 கருவிகளுக்குமான தனிப்பட்ட அமைப்பு (28 CLI Code's + 11 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode செருகுநிரல் → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**OmniRoute மூலம் ஆதரிக்கப்படும் எந்த CLI-யையும் ஒரு கட்டளையில் இயக்குங்கள்** — எந்த உள்ளமைவு கோப்புகளும் எழுதப்படாது,
அங்கீகாரங்கள் ஒவ்வொரு செயல்முறைக்கும் தனித்தனியாக செலுத்தப்படும், Qwen/Gemini-க்கு தனிப்பட்ட, தற்காலிகமான home வழங்கப்படும்:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# அல்லது வழங்குநர்+மாதிரியை இடைமுகமாக தேர்ந்தெடுத்து, கருவியின் சொந்த உள்ளமைவை எழுதுங்கள்:
omniroute configure codex # இதுவும்: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
ஒவ்வொரு கட்டளையும் செயலில் இருக்கும் தொலைநிலை சூழலை (`omniroute connect `) மதிக்கும், `--dry-run`
செயல்படுத்தாமல் சரியான env/args-ஐ முன்னோட்டமாக காட்டும், மற்றும் `--api-key-env NAME` ரகசியங்களை உங்கள் shell வரலாற்றிலிருந்து பாதுகாக்கும். → [CLI ஒருங்கிணைப்புகள்](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 AI வழங்குநர்கள் — 153 பட்டியலில் இலவசமாகக் குறிக்கப்பட்டவை
> **388 பதிவு செய்யப்பட்ட வழங்குநர்கள்**, canonical chat, media, search, local, cloud-agent மற்றும் system தொகுப்புகள் முழுவதும் உள்ளனர்; இதில் **153 வழங்குநர்கள் `hasFree: true` கண்டறிதல் metadata-வை கொண்டுள்ளனர்**. Chat model registry-யில் **239 வழங்குநர்கள் / 3,059 தனித்துவமான provider-model ஜோடிகள் / 1,475 மூல model IDs** உள்ளன; தனி இலவச-பட்ஜெட் பட்டியலில் **471 ஒவ்வொரு-model வரிசைகள்**, **34 தொடர்ச்சியான pool-கள்** மற்றும் **52 தொடர்ச்சியான/keyless எப்போதும்-இலவச வழங்குநர்கள்** உள்ளனர். இவை வடிவமைப்பின் அடிப்படையில் வெவ்வேறு denominator-கள்; வரையறைகளும் pool-deduped கணக்கீடுகளும் [வழங்குநர் குறிப்பு](docs/reference/PROVIDER_REFERENCE.md) மற்றும் [இலவச அடுக்குகள்](docs/reference/FREE_TIERS.md) ஆகியவற்றில் உள்ளன.
### 🏢 அனைத்து முக்கிய ஆய்வகங்களும் — ஒரே endpoint மூலம்
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…மேலும் 350+ — ஒவ்வொரு icon-உம் dashboard-ன் provider catalog-லிருந்து நேரடியாகத் தீர்க்கப்படுகிறது. 📖 [வழங்குநர் குறிப்பு](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 எப்போதும் இலவசம் — $0, அட்டை தேவையில்லை
OpenCode Zen DeepSeek V4, Nemotron 3 டோக்கன் வரம்பு இல்லை
Kilo Code தானியங்கி router, Tencent Hy3 என்றென்றும் இலவசம்
### 🧩 புதியது: OmniRoute உள்ளே VS குறியீட்டின் சொந்த Copilot அரட்டை
> புதிய பக்கப்பட்டி இல்லை, புதிய அரட்டை UI இல்லை - ஒவ்வொரு மாடல் OmniRoute சேவைகளும் சரியாக காண்பிக்கப்படும்** நீங்கள் ஏற்கனவே பயன்படுத்தும்Copilot அரட்டை மாதிரி பிக்கர்** . VS குறியீடு 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 அரட்டை வழிகாட்டி](docs/guides/VSCODE-COPILOT.md) — அமைவு, பிக்கர் என்ன காட்டுகிறது, டேஷ்போர்டு-இன்-ஏ-டாப், சரிசெய்தல்
### 🎩 புதியது: OmniRouteTray — உங்கள் நுழைவாயில், மெனு பட்டியில் வாழும்
> `omniroute serve` எப்போதும் இயங்கும் போது மிகவும் மகிழ்ச்சியாக இருக்கும்.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** அதை macOS க்கான செட் அண்ட் மறதி மெனு-பார் பயன்பாடாக மாற்றுகிறது: இது சேவையகத்தைத் தொடங்குகிறது, மறுதொடக்கம் முழுவதும் அதை உயிருடன் வைத்திருக்கும், அதை இடத்தில் புதுப்பிக்கிறது மற்றும் உங்கள் நேரடி டோக்கன் பட்ஜெட்டை ஒரே கிளிக்கில் வைக்கிறது -** டெர்மினல் சாளரம் திறக்கப்படவில்லை, குழந்தை காப்பகத்திற்கு `npm install -g omniroute` இல்லை.**
[Tauri v2](https://v2.tauri.app/) (ஒரு ரவுண்டிங் பிழையின் அளவு ரஸ்ட் கோர்) உடன் கட்டப்பட்டது, இது அதன் சொந்த கையொப்பமிடப்பட்ட நோட் 24 இயக்க நேரத்தை அனுப்புகிறது மற்றும் பயன்பாட்டிற்கு சொந்தமான OmniRoute நிறுவலை நிர்வகிக்கிறது, எனவே இது உங்கள் உலகளாவிய `node`/`bun` உடன் ஒருபோதும் போராடாது. அது** உங்கள் தற்போதைய `~/.omniroute/` கட்டமைப்பு மற்றும் தரவுத்தளத்தைப் பகிர்ந்து கொள்கிறது** — எனவே நீங்கள் ஏற்கனவே ஒரு தொப்பியுடன் இயங்கும் அதே OmniRoute தான். 🎩
அது என்ன செய்கிறது
எப்படி
🟢
📊 ஒரு பார்வையில் நேரடி பயன்பாடு
வழங்குநர் ஒதுக்கீடு பார்கள், மீட்டமைக்கப்பட்ட கவுண்டவுன்களுடன் Claude session/weekly வரம்புகள், 30 நாள் செலவு முறிவு
🔄
இடத்தில் தானியங்கு புதுப்பிப்புகள் நிலை நிறுவல், அணு இடமாற்று
தோல்வியில் திரும்புதல் — எப்போதும் புதிய வெளியீடு
இல்
🚀 உள்நுழைவில் தொடங்கு
உள்நுழைவில் விருப்பத் துவக்கம்; tray-only, no dock icon
🩺 டாக்டர் & பதிவுகள்
ஒரு கிளிக் கண்டறிதல் மற்றும் சர்வர் பதிவு அணுகல்
```sh
brew install --cask zoispag/tap/omniroute-tray
```
பதிவிறக்கத்தை விரும்புகிறீர்களா? சமீபத்திய .dmg ஐப் பெறவும்
வெளியிடுகிறது. ஆதாரம், சிக்கல்கள் மற்றும் உருவாக்கம்
டாக்ஸ் zoispag/omniroute-tray இல் வாழ்கிறது.
💛 @zoispag இன் சமூகத் திட்டம் — அதிகாரப்பூர்வ OmniRoute வெளியீடு அல்ல.
> சேவையகத்தைத் தாண்டி, OmniRoute என்பது **80+ கட்டளைகளைக்** கொண்ட ஒரு **முழுமையான கட்டளை-வரி கட்டுப்பாட்டு மையம்**; மேலும், திறந்த முகவர் நெறிமுறைகளின் மூலம் ஓர் AI முகவர் அதை **தானாகவே** இயக்க முடியும்.
### ⌨️ உண்மையான CLI (`start` மட்டும் அல்ல)
```bash
omniroute # நுழைவாயில் + கட்டுப்பாட்டுப் பலகையை வழங்கும் (போர்ட் 20128)
omniroute chat # ஊடாடும் TUI அரட்டை கிளையன்ட் (ஸ்லாஷ்: /model /combo /skill /memory)
omniroute setup # வழிகாட்டப்படும் முதல் இயக்க அமைவு வழிகாட்டி
omniroute doctor # வழங்குநர்கள், போர்ட்கள், நேட்டிவ் சார்புகளைச் சோதிக்கும்
```
### 🛰️ தொலைநிலைப் பயன்முறை — CLI-ஐ இங்கே இயக்கி, OmniRoute-ஐ VPS-இல் இயக்குங்கள்
OmniRoute ஒரு சேவையகத்தில் உள்ளதா? **அதே CLI** மூலம் உங்கள் மடிக்கணினியிலிருந்து அதை இயக்குங்கள். வரையறுக்கப்பட்ட அணுகல் டோக்கனைக் கொண்டு ஒருமுறை உள்நுழையுங்கள்;
அதன்பின் ஒவ்வொரு கட்டளையும் தொலைநிலைச் சேவையகத்தைக் குறிவைக்கும்.
```bash
omniroute connect 192.168.0.15 # கடவுச்சொல் → வரையறுக்கப்பட்ட டோக்கன், ஒரு சூழலாகச் சேமிக்கப்படும்
omniroute models # ← தொலைநிலைச் சேவையகத்திற்கு எதிராக இயங்கும்
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
வரையறுக்கப்பட்ட அணுகல் டோக்கன்களுடன் ஒரு தொலைநிலை instance-ஐ இயக்கவும்
```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% டோக்கன்களைச் சேமிக்கவும்
### 📖 இது எவ்வாறு செயல்படுகிறது — pipeline, architecture மற்றும் சேமிப்பு கணிதம்
இயல்புநிலை stacked combo `RTK → Caveman`-ஐ இயக்குகிறது. இரண்டும் ஒரே tool/context payload-ல் செயல்படும்போது, சேமிப்புகள் ஒன்றோடொன்று சேர்கின்றன:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Code blocks, URLs, JSON மற்றும் structured data ஆகியவை preservation engine மூலம் **எப்போதும் பாதுகாக்கப்படுகின்றன**.
> **சில டோக்கன்களே போதுமானபோது ஏன் பல டோக்கன்களைப் பயன்படுத்த வேண்டும்?** ஒவ்வொரு request-உம் OmniRoute-இன் compression pipeline வழியாக **வெளிப்படையாக** செல்கிறது — client மாற்றங்கள் தேவையில்லை. இது இப்போது வரிசையாக இயங்கி, ஒவ்வொரு routing combo-க்கும் தேவைக்கேற்ப கலந்து தேர்ந்தெடுக்கக்கூடிய **12 composable engines கொண்ட stack** ஆகும் — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) மற்றும் [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) ஆகியவற்றின் கருத்துகளை அடிப்படையாகக் கொண்டது.
### 🧱 12-engine stack
Engines pipeline வரிசையில் இயங்குகின்றன; ஒவ்வொன்றையும் தனித்தனியாக toggle செய்து, ஒவ்வொரு combo-க்கும் configure செய்யலாம்:
#
Engine
இது செய்வது
1
Session-Dedup
Turns முழுவதும் மீண்டும் வரும் content-ஐ நீக்குகிறது (content-addressed, cross-turn)
2
CCR
பெரிய blocks-ஐ retrieve markers-ன் பின்னால் archive செய்து, தேவைக்கேற்ப பெறுகிறது
கடைசி user query-க்கு எதிராக extractive sentence scoring செய்கிறது
8
Caveman
Rule-based prose compression (~65–75% on output)
9
Aggressive
Summarization + பழைய turns-ஐ progressive aging செய்கிறது
10
LLMLingua-2
MobileBERT ONNX மூலம் ML semantic pruning — code-safe, async
11
Ultra
விருப்பத்தேர்வான small-model (SLM) tier உடன் heuristic token pruning
12
OmniGlyph
Direct Anthropic wire-ல் அளவிடப்பட்ட Claude Fable 5-க்கான experimental context-as-image encoding; GPT 5.6 transformers, provider receipts நிலுவையில் இருப்பதால் fail-closed நிலையில் தொடர்கின்றன. நான்கு compression profiles (aggressive default, balanced, coding-safe, passthrough) (மிகவும் aggressive; opt-in)
Code blocks, URLs மற்றும் structured data ஆகியவை **எப்போதும் byte-perfect ஆகப் பாதுகாக்கப்படுகின்றன**. **One-click presets** engines-ஐ இணைக்கின்றன:
Mode
சேமிப்பு
சிறந்த பயன்பாடு
🪶 Lite
~15%
எப்போதும் இயக்கப்பட்டிருக்கும் பாதுகாப்பான இயல்புநிலை
🪨 Standard (Caveman)
~30%
தினசரி coding
⚡ Aggressive
~50%
நீண்ட tool-heavy sessions
🔥 Ultra
~75%
அதிகபட்ச சேமிப்பு
🧰 RTK
60–90%
Shell/test/build/git output
🔗 Stacked (RTK → Caveman)
78–95%
கலப்பு prompts + tool logs
**நிஜ உதாரணம் — Standard mode:**
> **முன் (69 tokens):** _"உங்கள் React component மீண்டும் render ஆகக் காரணம், ஒவ்வொரு render cycle-லும் நீங்கள் புதிய object reference-ஐ உருவாக்குவதாக இருக்கலாம். Inline object-ஐ prop ஆக அனுப்பும்போது, React-இன் shallow comparison அதை ஒவ்வொரு முறையும் வேறுபட்ட object-ஆகக் காண்கிறது; இதனால் re-render தூண்டப்படுகிறது. Object-ஐ memoize செய்ய useMemo-ஐ பயன்படுத்துமாறு பரிந்துரைக்கிறேன்."_
>
> **பின் (19 tokens):** _"ஒவ்வொரு render-லும் புதிய object ref. Inline object prop = புதிய ref = re-render. useMemo-ல் wrap செய்யவும்."_
>
> **அதே பதில். 72% குறைவான tokens. துல்லிய இழப்பு ஏதுமில்லை.** ✅
**PT-BR உதாரணம் — [Troglodita](https://github.com/leninejunior/troglodita) mode:**
> **முன் (42 tokens):** _"புதிய object reference ஒவ்வொரு render cycle-லும் உருவாக்கப்படுவதால் component மீண்டும் render ஆகிறது என்பதே பிரச்சினை. `useMemo` பயன்படுத்த பரிந்துரைக்கிறேன்."_
>
> **பின் (12 tokens):** _"மீண்டும்-ரெண்டர்: ஒவ்வொரு cycle-லும் புதிய ref (inline object மீண்டும் உருவாக்கப்பட்டது). `useMemo` பயன்படுத்தவும்."_
>
> **அதே பதில். ~70% குறைவான tokens. தொழில்நுட்பத் துல்லியம் மாறவில்லை.** ✅
### 🎚️ Engines-ஐத் தாண்டி — வெளியீட்டு பாணிகள், adaptive dial மற்றும் ஒவ்வொரு request-க்கான கட்டுப்பாடு
மேலுள்ள 12 engines, **உள்ளே** செல்லும் உள்ளீட்டைச் சுருக்குகின்றன. மேலும் மூன்று அடுக்குகள், **எப்படி**, **எப்போது**, மற்றும் வெளியே வருவது என்ன என்பதை வடிவமைக்கின்றன:
- **🪄 Output Styles** _(வெளியீட்டு அச்சு வழிநடத்தல்)_ — deterministic, cache-safe response-shaping வழிமுறைகளைச் செலுத்துகின்றன; ஒன்றுடன் ஒன்று இணைக்கக்கூடியவை, ஒவ்வொன்றும் `lite` / `full` / `ultra` தீவிர நிலைகளில் கிடைக்கும். ஒரு style-ஐச் சேர்ப்பது registry-ல் ஒரு வரியைச் சேர்ப்பது மட்டுமே:
- **சுருக்கமான உரை** — filler / articles / hedging-ஐ நீக்கி; தொழில்நுட்ப உள்ளடக்கத்தைத் துல்லியமாக வைத்திருக்கும்.
- **குறைந்த code** — "சோம்பேறி senior dev" YAGNI: செயல்படும் மிகச்சிறிய மாற்றம், கோரப்படாத scaffolding இல்லை.
- **Ponytail (சோம்பேறி senior dev)** — YAGNI படிக்கட்டில் மேலேறி, அடிப்படைக் காரணத்தைச் சரிசெய்து, செயல்படும் மிகச்சிறிய diff.
- **எனக்கு ADHD உள்ளது (action-first)** — அடுத்த செயல் முதலில் வரும், படிகள் எண்ணிடப்படும், ஒரு தெளிவான அடுத்த படி மட்டும், முன்னுரை இல்லை.
- **Terse CJK (文言)** — classical-Chinese ultra-terse பாணி (`zh` locale-க்கு மட்டும்).
- **🎯 Adaptive context-budget** _(dial)_ — ஒரே on/off token threshold-க்கு பதிலாக, model-ன் context window-க்குள் **பொருந்தும்** அளவுக்கு மட்டுமே, குறைந்த செலவுடையதும் தகவல் இழப்பு குறைவானதுமான engines-ஐ அதிகரிக்கிறது. Policy: `reserve-output` (default, model-aware) · `percentage` · `absolute`. Mode: `floor` (பொருந்துவதை உறுதி செய்கிறது) · `replace-autotrigger` (உங்கள் explicit தேர்வு முன்னுரிமை பெறும்) · `off` (legacy threshold).
- **🎛️ Compression தீர்மானிக்கப்படும் இடம்** _(precedence, high → low)_ — ஒவ்வொரு request-க்குமான `x-omniroute-compression` header › routing-combo override › active named profile › adaptive / auto-trigger › panel default › off. பயன்படுத்தப்பட்ட plan, `X-OmniRoute-Compression: ; source=` response header-ல் திரும்ப வழங்கப்படும்.
Token threshold மூலம் auto-trigger செய்யவும், adaptive dial-ஐ இயக்கவும், named profile-ஐ pin செய்யவும், ஒவ்வொரு request-க்கும் ஒருமுறை அமைக்கவும், அல்லது ஒவ்வொரு routing combo-க்கும் pipeline-ஐ ஒதுக்கவும் — workload-க்கு ஏற்றதைத் தேர்ந்தெடுக்கலாம். Opt-in offline **eval harness** (`npm run eval:compression`), மாற்றத்தை promote செய்வதற்கு முன் pinned corpus-ல் fidelity மற்றும் savings-ஐ மதிப்பிடுகிறது.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ விரைவு தொடக்கம்
**1) Install செய்து இயக்கவும்**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` அல்லது peer-dep warnings தோன்றுகிறதா? [அவை பாதிப்பில்லாதவை](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11 அல்லது அதற்குப் பிறகான பதிப்பைப் பயன்படுத்துகிறீர்களா?** அனுமதிக்கப்படாவிட்டால் npm package lifecycle scripts-ஐத் தடுக்கலாம். OmniRoute-ன் `postinstall` (`node scripts/build/postinstall.mjs`), அதன் native runtime files-ஐத் தயாரிக்கத் தேவைப்படுகிறது. Globally install செய்யும்போது npm-ன் warning-ல் குறிப்பிடப்பட்ட packages-ஐ அனுமதிக்கவும். OmniRoute 3.8.54 தெரிவித்த package set-க்கு:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> எதிர்கால global installs-க்காக இந்த allowlist-ஐ மீண்டும் பயன்படுத்த, ஒருமுறை configure செய்து, பின்னர் வழக்கம்போல் install செய்யவும்:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Releases-க்கு இடையில் dependency list மாறக்கூடும்; npm வேறுபட்ட list-ஐத் தெரிவித்தால், அந்த warning-ல் உள்ள package names-ஐப் பயன்படுத்தவும். ஒரு package-ஐ அனுமதிப்பது, அதன் install scripts இயங்க அனுமதிக்கிறது.
> **Gemini Web அல்லது வேறு web-cookie provider-ஐப் பயன்படுத்துகிறீர்களா?** npm package-ல்
> Playwright உள்ளது, ஆனால் அதன் Chromium binary இல்லை. முதல் web-provider request-ஐச் செய்வதற்கு முன்
> [Playwright Chromium setup](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> குறிப்பைப் பார்க்கவும்.
Dashboard: `http://localhost:20128` · API: `http://localhost:20128/v1`.
**2) உங்கள் சொந்த account-ஐப் பயன்படுத்தி தகுதியான provider-ஐ இணைக்கவும்**
Dashboard → **Providers** → உங்கள் பயன்பாட்டுக்கு ஏற்ற current terms மற்றும் quota கொண்ட provider-ஐத் தேர்ந்தெடுக்கவும் → அதன் API key-ஐச் சேர்க்கவும் அல்லது அதன் account flow-ஐ நிறைவு செய்யவும். Free tiers-க்கு signup, approval அல்லது payment method தேவைப்படலாம். [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md)-ஐப் பார்க்கவும்; keyless availability உறுதி செய்யப்படவில்லை, மேலும் `tos: avoid` எனக் குறிக்கப்பட்ட providers, இயல்புநிலையாக `auto`-விலிருந்து விலக்கப்படுகின்றன.
**3) உங்கள் coding tool-ஐச் சுட்டிக்காட்டவும்**
```txt
Base URL: http://localhost:20128/v1
API Key: [Dashboard → Endpoints-இலிருந்து நகலெடுக்கவும்]
Model: auto (தகுதியான connections-க்கு இடையில் routing செய்கிறது — அல்லது provider/model-ஐத் தேர்ந்தெடுக்கவும்)
```
**4) இது செயல்படுகிறதா என்பதைச் சரிபார்க்கவும்**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
உங்கள் இணைக்கப்பட்ட models பட்டியலிடப்பட்டிருப்பதைக் காண வேண்டும். 🎉 அவ்வளவுதான் — coding-ஐத் தொடங்குங்கள்; OmniRoute உங்களுக்காக auto-route செய்து fallback செய்யும்.
உங்கள் client custom headers-ஐ அனுப்ப முடியாவிட்டால், OmniRoute tokenized compatibility aliases-ஐயும் வழங்குகிறது:
```txt
OpenAI பட்டியல்: 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 இல்லை.
8,400+ கண்காணிக்கப்படும் சோதனைக் கோப்புகளில் உள்ள 60,000+ நிலையான சோதனை அறிவிப்புகளுக்கான சோதனைக் கவரேஜ் உத்தி
# ⭐ சிறந்த பங்களிப்பாளர்கள்
> OmniRoute-ஐ ஆர்வமிக்க திறந்த மூலச் சமூகத்தினர் வடிவமைக்கின்றனர். திட்டத்தின் தரம், நிலைத்தன்மை மற்றும் சென்றடையும் பரப்பை நேரடியாகப் பாதிக்கும் வகையில் இந்த நபர்கள் சிறப்பான பங்களிப்புகளைச் செய்துள்ளனர். **நன்றி.**
### இணைக்கப்பட்ட pull request-களின் அடிப்படையிலான வெளிப்புற பங்களிப்பாளர்கள்
2026-11-03 03:01:19 UTC அன்று நேரடி release/v3.8.53 முனை 05bc048d6c உடன் கணக்கெடுப்பு நடத்தப்பட்டது. பக்கங்களாகப் பிரிக்கப்பட்ட GitHub GraphQL கணக்கெடுப்பில் 9,947 இணைக்கப்பட்ட PR-கள் உள்ளன: களஞ்சிய உரிமையாளரால் 4,130, Dependabot மூலம் 240, பிற bot/app-களால் 6, மேலும் 883 தனித்துவமான பங்களிப்பாளர்களிடமிருந்து 5,571 வெளிப்புற PR-கள். “மாற்றப்பட்ட வரிகள்” என்பது GitHub-இன் சேர்த்தல்கள் + நீக்கல்கள் ஆகும்; உருவாக்கப்பட்ட கோப்புகள், lockfile-கள், பட்டியல்கள், மொழிபெயர்ப்புகள் மற்றும் ஆவணங்களும் இதில் அடங்கும்; இது churn ஆகும், எழுதிய LOC அல்ல. 53 PR-கள் 500,000 வரிகளுக்கு மேற்பட்ட GitHub வேறுபாடுகளைப் பதிவுசெய்கின்றன (எடுத்துக்காட்டாக, ஒரே provider சேர்த்தலான #13399, 2,347 மாற்றப்பட்ட கோப்புகளைப் பட்டியலிடுகிறது); இதனால் மேலுள்ள பல மொத்தங்கள் அதிகரிக்கின்றன. சமநிலைகள் ஒரே தரவரிசையில் வைக்கப்படுகின்றன.
### GitHub-க்கு ஒதுக்கப்பட்ட commit-கள்
2026-11-03 02:09:16 UTC-இல் மீண்டும் சரிபார்க்கப்பட்டது: release/v3.8.53 இயல்புநிலை கிளைக்கான களஞ்சியத்தின் Contributors API மூலம் தெரிவிக்கப்பட்ட GitHub-ஆல் குறிப்பிடப்பட்ட கமிட்கள். API 903 அடையாளங்களை (429 பயனர்கள், 2 போட்கள், 472 அநாமதேய அடையாளங்கள்) வழங்கியது; இந்த அட்டவணை பராமரிப்பாளர், போட்கள் மற்றும் அநாமதேய அடையாளங்களைத் தவிர்த்து, போட்டியில் ஏற்பட்ட சமநிலைகளைத் தக்கவைக்கிறது. இது மேலே உள்ள இணைக்கப்பட்ட PR தரவரிசையிலிருந்தும் கீழே உள்ள Git-மெட்டாடேட்டா கணக்கெடுப்பிலிருந்தும் வேறுபட்டது.
> 🙏 இந்தப் பங்களிப்பாளர்களின் அம்சங்கள், பிழைத்திருத்தங்கள் மற்றும் உள்கட்டமைப்பு மேம்பாடுகள் OmniRoute-ஐ நம்பகமானதாகவும் பல அம்சங்களைக் கொண்டதாகவும் ஆக்கும் செயல்பாட்டின் **முக்கியப் பகுதியாகும்**. ஒவ்வொரு pull request-உம், ஒவ்வொரு சோதனை வழக்கும், ஒவ்வொரு i18n மொழிபெயர்ப்புக் கோப்பும் முக்கியமானவை. இவர்களைப் போன்றவர்களால்தான் திறந்த மூல மென்பொருள் உருவாக்கப்படுகிறது.
---
## 💖 ஆதரவாளர்கள்
தங்கள் சொந்தப் பணத்திலிருந்து OmniRoute-க்கு நிதியளிக்கும் நபர்களுக்கு மனமார்ந்த நன்றி — ஒவ்வொரு பங்களிப்பும் இந்தத் திட்டத்தை இலவசமாகவும், சுதந்திரமாகவும், தொடர்ந்து முன்னேறிக்கொண்டிருக்கவும் உதவுகிறது.
… மேலும் தங்கள் அடையாளத்தைத் தனிப்பட்டதாக வைத்திருக்க விரும்பும் மற்றவர்களும் 💛பொதுவில் உள்ள GitHub Sponsors விவரங்கள், GitHub Sponsors GraphQL API மூலம் 2026-10-18 அன்று மீண்டும் சரிபார்க்கப்பட்டன: மொத்தமுள்ள 14 ஆதரவுகளில், 11 பொதுவான ஆதரவுகள் (6 தற்போது செயலில் உள்ளவை, 5 கடந்தகால ஆதரவுகள்). மேலே உள்ள செயலில் உள்ளவர் குறிச்சொற்களை GitHub-இன் isActive நிலையே தீர்மானிக்கிறது; முன்பு பொதுவில் ஒருமுறை ஆதரவளித்தவர்களுக்கு தொடர்ந்து நன்றி தெரிவிக்கப்படுகிறது, மேலும் தனிப்பட்ட ஆதரவாளர்கள் பெயர் வெளியிடப்படாமல் இருக்கிறார்கள். Ko-fi, Buy Me a Coffee, Liberapay, PIX மற்றும் கிரிப்டோ நன்கொடைகளுக்குப் பொதுவான ஆதரவாளர் பதிவு இல்லாததால் அவை பட்டியலிடப்படவில்லை.💖 ஆதரவாளராகுங்கள் → — ஒவ்வொரு டாலரும் OmniRoute-ஐ இலவசமாகவும் சுதந்திரமாகவும் வைத்திருக்க உதவுகிறது.
## 👥 1,000+ பங்களிப்பாளர்கள்
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-11-02 அன்று நேரடி release/v3.8.53 முனை 1c7135e0fb இல் தணிக்கை செய்யப்பட்டது (7,972 கமிட்கள்): 1,074 இயல்பாக்கப்பட்ட மனித Git அடையாளங்கள் — 759 பேர் கமிட் ஆசிரியர்களாகத் தோன்றுகின்றனர் (பராமரிப்பாளரை உள்ளடக்கி), மேலும் 315 பேர் வெளிப்படையான Co-authored-by டிரெய்லர்களில் மட்டுமே உள்ளனர். இந்தக் கணக்கெடுப்பு .mailmap ஐப் பயன்படுத்துகிறது, மின்னஞ்சல் முகவரிகளை எழுத்து வடிவ வேறுபாடுகளைப் பொருட்படுத்தாமல் ஒப்பிடுகிறது, ஒரே ஹேண்டிலை குறியாக்கும் போது மட்டுமே எண் மற்றும் எளிய GitHub noreply முகவரிகளை இணைக்கிறது, 29 bot/agent/service/placeholder அடையாளங்களை விலக்குகிறது, மேலும் காட்சிப் பெயர்கள் பொருந்துகின்றன என்பதற்காக மட்டுமே வழக்கமான மின்னஞ்சல் முகவரிகளை ஒன்றிணைக்காது. 2026-08-24 தணிக்கையில் 639 பேர் வெளியிடப்பட்டனர்; அந்தத் தணிக்கையின் அடிப்படையான ac02c5b42f இல் இந்த முறையை மீண்டும் இயக்கியபோது 619 கிடைத்தது, எனவே அதிகரிப்பு புதிய பங்களிப்பாளர்களால் ஏற்பட்டது, தளர்வான முறையால் அல்ல.
### பங்களிப்பது எப்படி
1. களஞ்சியத்தை Fork செய்யவும்
2. **செயலில் உள்ள** `release/vX.Y.Z` முனையிலிருந்து (`main` இலிருந்து அல்ல) கிளையை உருவாக்கவும் — [கிளை பிரித்தல் மற்றும் வெளியீட்டு மாதிரி](docs/ops/BRANCHING_MODEL.md) ஐப் பார்க்கவும்
3. உங்கள் அம்சக் கிளையை உருவாக்கவும் (`git checkout -b feat/amazing-feature`)
4. உங்கள் மாற்றங்களை கமிட் செய்யவும் (`git commit -m 'feat: add amazing feature'`)
5. கிளைக்குத் தள்ளவும் (`git push origin feat/amazing-feature`)
6. **base = அந்த `release/vX.Y.Z` கிளை** என அமைத்து Pull Request-ஐத் திறக்கவும்
விரிவான வழிகாட்டுதல்களுக்கு [CONTRIBUTING.md](CONTRIBUTING.md) ஐப் பார்க்கவும்.
### புதிய பதிப்பை வெளியிடுதல்
```bash
# வெளியீட்டை உருவாக்கவும் — npm publish தானாகவே நடைபெறும்
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 நட்சத்திரங்கள்
## 🌍 StarMapper
## 🙏 நன்றியுரைகள்
OmniRoute பல முன்னோடிகளின் அடித்தளத்தின் மீது கட்டமைக்கப்பட்டுள்ளது. இது **[9router](https://github.com/decolua/9router)**-இன் fork ஆகவும், Go திட்டமான **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**-இன் TypeScript port ஆகவும் தொடங்கியது — அதன் பின்னர், கீழே உள்ள ஒவ்வொரு subsystem-மும் முதலில் அந்தப் பாதையை உருவாக்கிய ஒரு open-source திட்டத்தால் ஈர்க்கப்பட்டது. அவை ஒவ்வொன்றும் OmniRoute-இன் ஒரு குறிப்பிட்ட பகுதியை வடிவமைத்தன. அவை அனைத்திற்கும் எங்கள் நன்றிகள். 🙏
> ⭐ நட்சத்திர எண்ணிக்கைகள் GitHub-ன் REST API மூலம் நவம்பர் 3, 2026 அன்று சரிபார்க்கப்பட்டவை — இந்தத் திட்டங்களுக்கு நட்சத்திரம் வழங்குங்கள். எண்ணிக்கைகள் குறிப்பிட்ட தேதியின் துல்லியமான snapshot ஆகும்; இயல்பாகவே மாறக்கூடும்.
### 🧬 மரபுத்தொடர் & gateway
இதன் patterns stream recovery, no-thinking aliases, fallback web search, sliding-window limits, log redaction மற்றும் hardened launcher flows ஆகியவற்றில் port செய்யப்பட்டன.
இதன் Grok model mappings, fake-TypeError Statsig generator, request மற்றும் device defaults, NDJSON response processor ஆகியவை OmniRoute-ன் Grok Web executor-இல் குறிப்பிடத்தக்க வகையில் தழுவப்பட்டன.
grok2api-merged-க்கு பின்னால் உள்ள முக்கிய transitive code source; இதன் model, header, payload, Statsig மற்றும் processor implementations, Grok Web lineage-இல் பாதுகாக்கப்பட்டுள்ளன.
Grok payload மற்றும் device defaults, Statsig generator, மேலும் TQZHR மற்றும் grok2api-merged வழியாகத் தொடரும் result.response processor ஆகியவற்றுக்கான அடிப்படை MIT source.
இதன் proxy-pool layer-க்காக grok2api-merged குறிப்பிடும் transitive source; OmniRoute அந்த lineage notice-ஐப் பாதுகாக்கிறது, ஆனால் அதன் வரையறுக்கப்பட்ட Grok Web executor-இல் proxy-pool port செய்ததாகக் கோரவில்லை.
இதன் HTTP/browser upstream design-க்காக அசல் Grok Web implementation ஆலோசிக்கப்பட்டது; இதன் direct HTTP path GrokProxy-இலிருந்து பெறப்பட்டது, எனவே தனித்த code port எதுவும் கோரப்படவில்லை.
வைரலான "சில token-கள் போதுமானபோது பல token-களை ஏன் பயன்படுத்த வேண்டும்" திட்டம் — இதன் caveman-பேச்சு தத்துவம் எங்கள் நிலையான சுருக்கப் பயன்முறைக்கும் 30+ filler/condensation விதிகளுக்கும் அடித்தளமாகிறது.
உயர் செயல்திறன் கொண்ட command-output சுருக்கம் — இது எங்கள் RTK engine, JSON filter DSL, raw-output recovery மற்றும் அடுக்கப்பட்ட RTK → Caveman pipeline-க்கு உத்வேகம் அளித்தது.
PT-BR token compression — Brazilian-Portuguese இலக்கணத்திற்காகச் செம்மைப்படுத்தப்பட்ட pleonasm reduction மற்றும் filler removal மூலம் எங்கள் pt-BR language pack-ஐ இயக்குகிறது.
வைரலான "lazy senior dev" YAGNI-coder skill — இது எங்கள் less-code Output Style-க்கு உத்வேகம் அளித்தது: Caveman-ன் சுருக்கமான உரைக்கு இணையான output-axis அணுகுமுறையாக, _உருவாக்கப்பட்ட_ code-ஐக் குறைக்கும் smallest-working-change steering.
Content-aware, per-file-type output compression with failure-aware bail-out — இது எங்கள் per-type dispatch மற்றும் minimum-gain skip அணுகுமுறையை உறுதிப்படுத்தியது.
coding-assistant ↔ LLM போக்குவரத்தின் MITM interception/analysis, ஆரம்பகட்ட Traffic Inspector தேவைகளைத் தீர்மானிக்க உதவியது. முன்பு பெறப்பட்ட நான்கு modules — SSE merging, conversation normalization, secret masking மற்றும் header sanitization — பொது protocol standards-ஐ அடிப்படையாகக் கொண்ட தனித்த clean-room implementations மூலம் மாற்றப்பட்டுள்ளன. இரண்டு host-passthrough surfaces (passthrough.ts மற்றும் _internal/bypass.cjs) OmniRoute-க்குள் தனித்த implementations ஆகவே உள்ளன; அந்த மாற்றத்தின் ஒரு பகுதியாக அவை மறுஎழுதப்படவில்லை.
ஒவ்வொரு process-க்கும் வெளிப்படையான proxy routing — crash-safe MITM teardown, socket idle-timeouts, /proc process attribution மற்றும் TPROXY capture ஆகியவற்றுக்கு ஊக்கமளித்தது.
இயல்புநிலையாகப் பாதுகாப்பான libraries-ன் தொகுக்கப்பட்ட பட்டியல், எங்கள் பாதுகாப்புத் தேர்வுகளுக்கு வழிகாட்டுகிறது (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Grok Build quota surface-ஐ அடையாளம் கண்டது; பின்னர் OmniRoute live wire format-ஐ தனித்தனியாகச் சரிபார்த்து திருத்தியது.
## 📄 רישיון
רישיון MIT - לפרטים נוספים ראו [LICENSE](LICENSE).
---
**[⬆ חזרה לראש הדף](#-omniroute)** · נבנה באהבה ❤️ למען קהילת הבינה המלאכותית בקוד פתוח.
נוצר על ידי Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · רישיון MIT · omniroute.online