mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-21 14:22:14 +03:00

Files

Diego Rodrigues de Sa e Souza 8feea123bb feat(docs): mirror every docs/ page in all 65 locales (#14106 )

* feat(docs): mirror every docs/ page in all 65 locales

Extends the documentation mirrors from the 22-page core set (#13940) to
every Markdown page under docs/: 152 sources x 65 locales = 9,880 mirrors
(6,208 new), language bars rewritten for the full locale list, state
adopted so the blocking drift gate now covers all 152 pages.

run-translation.mjs: an oversized block made only of table rows or list
items (PROVIDER_REFERENCE.md 244-row table, FREE_TIERS.md 71-item list) is
cut at item boundaries and rejoined without a blank line — the single
16-40 KB request outlived the backend socket for verbose scripts. 48
older mirrors whose tables had lost rows were retranslated with --force.

* docs(i18n): refresh mirrors for the sources the base changed since the branch cut

Section-level retranslation of the 29 docs (and README.md) whose source
or mirrors moved on release/v3.8.51 during the run, then state adoption;
the drift gate is green again on the merged tree.

2026-09-18 13:16:46 -03:00

132 KiB

Raw Blame History

User Guide (தமிழ்)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

வழங்குநர்களை உள்ளமைத்தல், சேர்க்கைகளை உருவாக்குதல், CLI கருவிகளை ஒருங்கிணைத்தல் மற்றும் OmniRoute-ஐ வரிசைப்படுத்துதல் ஆகியவற்றுக்கான முழுமையான வழிகாட்டி.

உள்ளடக்க அட்டவணை

விலை விவரச் சுருக்கம்
பயன்பாட்டு நிகழ்வுகள்
வழங்குநர் அமைப்பு
CLI ஒருங்கிணைப்பு
பயன்பாட்டுக்குக் கொண்டுவருதல்
கிடைக்கக்கூடிய மாடல்கள்
மேம்பட்ட அம்சங்கள்
தானியங்கி வழிப்படுத்தல் (அமைவு தேவையில்லை)
MCP & A2A ஒருங்கிணைப்பு
திறன்கள் அமைப்பு
நினைவக அமைப்பு
Webhooks
Cloud Agents
நிரலாக்க முறையிலான மேலாண்மை
உள் CLI
டெஸ்க்டாப் பயன்பாடு (Electron)

💰 விலை விவரச் சுருக்கம்

திட்ட நிலை	வழங்குநர்	செலவு	ஒதுக்கீடு மீட்டமைப்பு	மிகவும் ஏற்றது
💳 சந்தா	Claude Code (Pro)	$20/மாதம்	5 மணிநேரம் + வாரந்தோறும்	ஏற்கெனவே சந்தா பெற்றவர்கள்
	Codex (Plus/Pro)	$20-200/மாதம்	5 மணிநேரம் + வாரந்தோறும்	OpenAI பயனர்கள்
	GitHub Copilot	$10-19/மாதம்	மாதந்தோறும்	GitHub பயனர்கள்
🔑 API விசை	DeepSeek	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	மலிவான தர்க்கத் திறன்
	Groq	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	அதிவேக அனுமானம்
	xAI (Grok)	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	Grok 4 தர்க்கத் திறன்
	Mistral	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	EU-வில் ஹோஸ்ட் செய்யப்பட்ட மாடல்கள்
	Perplexity	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	தேடலால் மேம்படுத்தப்பட்டது
	Together AI	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	திறந்த மூல மாடல்கள்
	Fireworks AI	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	வேகமான FLUX படங்கள்
	Cerebras	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	வேஃபர் அளவிலான வேகம்
	Cohere	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	Command R+ RAG
	NVIDIA NIM	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	நிறுவன மாடல்கள்
	Baidu Qianfan	பயன்பாட்டுக்கு ஏற்ப கட்டணம்	இல்லை	ERNIE மாடல்கள்
💰 மலிவு	GLM-4.7	$0.6/1M	தினமும் காலை 10 மணி	குறைந்த செலவிலான மாற்றுத் தீர்வு
	MiniMax M2.1	$0.2/1M	சுழற்சி முறையில் 5 மணிநேரம்	மிக மலிவான விருப்பம்
	Kimi K2	$9/மாதம் நிலையான கட்டணம்	10M டோக்கன்கள்/மாதம்	கணிக்கக்கூடிய செலவு
🆓 இலவசம்	Qoder	$0	வழங்குநரின் வரம்புகள் பொருந்தும்	தற்போதைய பட்டியலைச் சரிபார்க்கவும்
	Kiro	$0	~50 கிரெடிட்கள்/மாதம்	இலவச Claude

🎯 பயன்பாட்டு நிகழ்வுகள்

நிகழ்வு 1: "என்னிடம் Claude Pro சந்தா உள்ளது"

சிக்கல்: ஒதுக்கீடு பயன்படுத்தப்படாமலேயே காலாவதியாகிறது; தீவிரமாக நிரலெழுதும்போது பயன்பாட்டு வீத வரம்புகள் ஏற்படுகின்றன

கலவை: "maximize-claude"
  1. cc/claude-opus-4-7        (சந்தாவை முழுமையாகப் பயன்படுத்தவும்)
  2. glm/glm-4.7               (ஒதுக்கீடு தீர்ந்ததும் மலிவான மாற்றுத் தீர்வு)
  3. if/qwen3.8-max-preview       (அவசரநிலைக்கான இலவச மாற்றுத் தீர்வு)

மாதச் செலவு: $20 (சந்தா) + ~$5 (மாற்றுத் தீர்வு) = மொத்தம் $25
இதற்கு மாறாக, $20 செலுத்தியும் வரம்புகளை எட்டுவது = விரக்தி

நிகழ்வு 2: "செலவே இல்லாமல் வேண்டும்"

சிக்கல்: சந்தாக்களை வாங்க இயலாது; நம்பகமான AI நிரலாக்கம் தேவை

கலவை: "zero-cost"
  1. if/kimi-k2.7-code          (இலவச அணுகல் எனப் பட்டியலிடப்பட்டுள்ளது; பயன்பாட்டு வீத வரம்புகள் பொருந்தக்கூடும்)
  2. kr/qwen3-coder-next        (Kiro இலவச மாற்றுத் தீர்வு)

மாதச் செலவு: $0
தரம்: உங்கள் பணிச்சுமைக்கான மாடல், வரம்புகள், தனியுரிமை மற்றும் SLA ஆகியவற்றைச் சரிபார்க்கவும்

நிகழ்வு 3: "இடையூறுகள் இல்லாமல் 24/7 நிரலெழுத வேண்டும்"

சிக்கல்: காலக்கெடுக்கள் உள்ளன; செயல்படாத நேரத்தை ஏற்க முடியாது

கலவை: "always-on"
  1. cc/claude-opus-4-7        (சிறந்த தரம்)
  2. cx/gpt-5.5                (இரண்டாவது சந்தா)
  3. glm/glm-4.7               (மலிவானது, தினமும் மீட்டமைக்கப்படும்)
  4. minimax/MiniMax-M2.1      (மிக மலிவானது, 5 மணிநேரத்தில் மீட்டமைப்பு)
  5. if/deepseek-v4-flash       (இலவச அணுகல் எனப் பட்டியலிடப்பட்டுள்ளது; பயன்பாட்டு வீத வரம்புகள் பொருந்தக்கூடும்)

விளைவு: 5 மாற்று அடுக்குகள் தாக்குப்பிடிக்கும் திறனை விரிவுபடுத்துகின்றன; மூல வழங்குநரின் கிடைப்புத்தன்மைக்கு உத்தரவாதம் இல்லை
மாதச் செலவு: $20-200 (சந்தாக்கள்) + $10-20 (மாற்றுத் தீர்வு)

நிகழ்வு 4: "OpenClaw-இல் இலவச AI வேண்டும்"

சிக்கல்: செய்தியிடல் பயன்பாடுகளில் முற்றிலும் இலவசமான AI உதவியாளர் தேவை

கலவை: "openclaw-free"
  1. if/qwen3.8-max-preview     (இலவச அணுகல் எனப் பட்டியலிடப்பட்டுள்ளது; பயன்பாட்டு வீத வரம்புகள் பொருந்தக்கூடும்)
  2. if/deepseek-v4-flash       (இலவச அணுகல் எனப் பட்டியலிடப்பட்டுள்ளது; பயன்பாட்டு வீத வரம்புகள் பொருந்தக்கூடும்)
  3. if/kimi-k2.7-code          (இலவச அணுகல் எனப் பட்டியலிடப்பட்டுள்ளது; பயன்பாட்டு வீத வரம்புகள் பொருந்தக்கூடும்)

மாதச் செலவு: $0
இதன் வழியாக அணுகலாம்: WhatsApp, Telegram, Slack, Discord, iMessage, Signal...

📖 வழங்குநர் அமைப்பு

CSV அல்லது JSON கோப்பிலிருந்து API-key இணைப்புகளை மொத்தமாகச் சேர்க்க, Dashboard → Providers → Import from file என்பதைப் பயன்படுத்தவும். நெடுவரிசைகள் அவற்றின் இடத்தை அடிப்படையாகக் கொண்டவை (provider,name,apiKey,baseUrl,priority); provider ஏற்கனவே நிர்வகிக்கப்படும் வழங்குநராகவோ இணக்கமான node ஆகவோ இருக்க வேண்டும். CSV அல்லது JSON கோப்பிலிருந்து வழங்குநர்களை இறக்குமதி செய்தல் என்பதைப் பார்க்கவும்.

🔐 சந்தா வழங்குநர்கள்

Claude Code (Pro/Max)

Dashboard → Providers → Claude Code-ஐ இணைக்கவும்
→ OAuth உள்நுழைவு → தானியங்கி token புதுப்பிப்பு
→ 5 மணிநேர + வாராந்திர ஒதுக்கீட்டுக் கண்காணிப்பு

மாடல்கள்:
  cc/claude-opus-4-7
  cc/claude-sonnet-4-6
  cc/claude-haiku-4-5-20251001

தொழில்முறை உதவிக்குறிப்பு: சிக்கலான பணிகளுக்கு Opus-ஐயும், வேகத்துக்கு Sonnet-ஐயும் பயன்படுத்தவும். OmniRoute ஒவ்வொரு மாடலுக்குமான ஒதுக்கீட்டைக் கண்காணிக்கிறது!

Claude மற்றும் Claude Code-இணக்கமான வழித்தடங்கள், Opus மற்றும் Sonnet மாடல்களுக்கு max சிந்தனை முயற்சி அளவைத் தக்கவைக்கின்றன. Haiku மாடல்கள் max முயற்சி அடுக்கை ஏற்காது; எனவே OmniRoute அந்தக் கோரிக்கையை upstream-க்கு அனுப்புவதற்கு முன் அதிக சிந்தனை வரவுசெலவுக்கு நிலைக்குறைக்கிறது.

OpenAI Codex (Plus/Pro)

Dashboard → Providers → Codex-ஐ இணைக்கவும்
→ OAuth உள்நுழைவு (port 1455)
→ 5 மணிநேர + வாராந்திர மீட்டமைப்பு

மாடல்கள்:
  cx/gpt-5.5
  cx/gpt-5.4
  cx/gpt-5.3-codex
  cx/gpt-5.3-codex-spark

GitHub Copilot

Dashboard → Providers → GitHub-ஐ இணைக்கவும்
→ GitHub வழியாக OAuth
→ மாதாந்திர மீட்டமைப்பு (மாதத்தின் 1-ஆம் தேதி)

மாடல்கள்:
  gh/gpt-5.5
  gh/gpt-5.4
  gh/claude-sonnet-4.6
  gh/claude-opus-4.7
  gh/gemini-3.1-pro-preview

💰 மலிவான வழங்குநர்கள்

GLM-4.7 (தினசரி மீட்டமைப்பு, $0.6/1M)

பதிவுசெய்யவும்: Zhipu AI
Coding Plan-இலிருந்து API key-ஐப் பெறவும்
Dashboard → API Key-ஐச் சேர்க்கவும்: வழங்குநர்: glm, API Key: your-key

பயன்பாடு: glm/glm-4.7 — தொழில்முறை உதவிக்குறிப்பு: Coding Plan, 1/7 செலவில் 3× ஒதுக்கீட்டை வழங்குகிறது! தினமும் காலை 10:00 மணிக்கு மீட்டமைக்கப்படும்.

MiniMax M2.1 (5 மணிநேர மீட்டமைப்பு, $0.20/1M)

பதிவுசெய்யவும்: MiniMax
API key-ஐப் பெறவும் → Dashboard → API Key-ஐச் சேர்க்கவும்

பயன்பாடு: minimax/MiniMax-M2.1 — தொழில்முறை உதவிக்குறிப்பு: நீண்ட context-க்கு (1M tokens) மிக மலிவான தேர்வு!

Kimi K2 (மாதத்திற்கு நிலையான $9)

சந்தா செலுத்தவும்: Moonshot AI
API key-ஐப் பெறவும் → Dashboard → API Key-ஐச் சேர்க்கவும்

பயன்பாடு: kimi/kimi-k2.5 — தொழில்முறை உதவிக்குறிப்பு: 10M tokens-க்கு நிலையான மாதாந்திரக் கட்டணம் $9 = நடைமுறைச் செலவு $0.90/1M!

Baidu Qianfan / ERNIE

பதிவுசெய்யவும்: Baidu AI Cloud Qianfan
Qianfan API key ஒன்றை உருவாக்கவும் → Dashboard → API Key-ஐச் சேர்க்கவும்: வழங்குநர்: qianfan

பயன்பாடு: qianfan/ernie-5.1, qianfan/ernie-x1.1, அல்லது மற்றொரு Qianfan OpenAI-இணக்கமான model ID.

🆓 இலவச வழங்குநர்கள்

அங்கீகாரம் தேவையில்லாத இலவச வழங்குநர்களின் வழங்குநர் பக்கத்தில் அங்கீகாரம் தேவையில்லை என்பதற்குப் பக்கத்தில் ஒரு switch உள்ளது. அதை அணைப்பது அந்த வழங்குநரை முடக்கி, Providers configured/compact காட்சிகளிலிருந்து அதை அகற்றி, அதன் மாடல்களை /v1/models இலிருந்து அகற்றும்.

Qoder (9 இலவச மாடல்கள்)

Dashboard → Qoder-ஐ இணைக்கவும் → OAuth உள்நுழைவு → அணுகல் தற்போதைய வழங்குநர் வரம்புகளுக்கு உட்பட்டது

மாடல்கள்: if/qwen3.8-max-preview, if/qwen3.7-max, if/qwen3.7-plus, if/kimi-k3, if/kimi-k2.7-code, if/glm-5.2, if/deepseek-v4-pro, if/deepseek-v4-flash, if/minimax-m3

Kiro (Claude இலவசம்)

Dashboard → Kiro-ஐ இணைக்கவும் → AWS Builder ID அல்லது Google/GitHub → மாதத்திற்கு ~50 credits

மாடல்கள்: kr/claude-sonnet-4.5, kr/claude-haiku-4.5

🎨 சேர்க்கைகள்

ஒவ்வொரு அட்டையிலும் உள்ள கைப்பிடியை இழுப்பதன் மூலம் கட்டுப்பாட்டுப் பலகை → சேர்க்கைகள் என்பதில் சேர்க்கை அட்டைகளை நேரடியாக மறுவரிசைப்படுத்தலாம். வரிசை SQLite-இல் சேமிக்கப்பட்டு, மீண்டும் ஏற்றும்போது மீட்டமைக்கப்படும்.

எடுத்துக்காட்டு 1: சந்தாவை அதிகபட்சமாகப் பயன்படுத்துதல் → மலிவான காப்பு

கட்டுப்பாட்டுப் பலகை → சேர்க்கைகள் → புதிதாக உருவாக்கு

பெயர்: premium-coding
மாதிரிகள்:
  1. cc/claude-opus-4-7 (முதன்மைச் சந்தா)
  2. glm/glm-4.7 (மலிவான காப்பு, $0.6/1M)
  3. minimax/MiniMax-M2.7 (மிக மலிவான மாற்று, $0.3/1M)

CLI-இல் பயன்படுத்தவும்: premium-coding

எடுத்துக்காட்டு 2: இலவசம் மட்டும் (செலவு இல்லை)

பெயர்: free-combo
மாதிரிகள்:
  1. if/kimi-k2.7-code (இலவச அணுகலாகப் பட்டியலிடப்பட்டுள்ளது; வழங்குநரின் வரம்புகள் பொருந்தக்கூடும்)
  2. kr/qwen3-coder-next (Kiro இலவச மாற்று)

செலவு: தற்போது $0 எனப் பட்டியலிடப்பட்டுள்ளது; விதிமுறைகளும் கிடைக்கும் தன்மையும் மாறக்கூடும்

🔧 CLI ஒருங்கிணைப்பு

Cursor IDE

Cursor-ஐ OmniRoute கிளையண்டாகப் பயன்படுத்துதல் (Cursor அரட்டையை OmniRoute வழியாக அனுப்புதல்):

அமைப்புகள் → மாதிரிகள் → மேம்பட்டவை:
  OpenAI API அடிப்படை URL: http://localhost:20128/v1
  OpenAI API விசை: [OmniRoute கட்டுப்பாட்டுப் பலகையிலிருந்து]
  மாதிரி: cc/claude-opus-4-7

OmniRoute-ஐ Cursor வழங்குநராகப் பயன்படுத்துதல் (OmniRoute, Cursor அப்ஸ்ட்ரீமை அழைக்கும்):
கட்டுப்பாட்டுப் பலகை → வழங்குநர்கள் → Cursor → Cursor மூலம் உள்நுழைக என்பதைப் பயன்படுத்துவது சிறந்தது. Docker-இல், docs/providers/CURSOR-DOCKER.md-ஐப் பார்க்கவும்.

Claude Code

~/.claude/settings.json-ஐத் திருத்தவும்:

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:20128",
    "ANTHROPIC_AUTH_TOKEN": "your-omniroute-api-key"
  }
}

இங்கே Claude-உடன் இணக்கமான மூல முனைப்புள்ளியைப் பயன்படுத்தவும். ANTHROPIC_BASE_URL-க்கு /v1-ஐச் சேர்க்க வேண்டாம்.

Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"
codex "your prompt"

OpenClaw

~/.openclaw/openclaw.json-ஐத் திருத்தவும்:

{
  "agents": {
    "defaults": {
      "model": { "primary": "omniroute/if/kimi-k2.7-code" }
    }
  },
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://localhost:20128/v1",
        "apiKey": "your-omniroute-api-key",
        "api": "openai-completions",
        "models": [{ "id": "if/kimi-k2.7-code", "name": "Kimi K2.7 Code" }]
      }
    }
  }
}

அல்லது கட்டுப்பாட்டுப் பலகையைப் பயன்படுத்தவும்: CLI கருவிகள் → OpenClaw → தானியங்கு உள்ளமைவு

Cline / Continue / RooCode

வழங்குநர்: OpenAI இணக்கமானது
அடிப்படை URL: http://localhost:20128/v1
API விசை: [கட்டுப்பாட்டுப் பலகையிலிருந்து]
மாதிரி: cc/claude-opus-4-7

🚀 நிறுவல்

உலகளாவிய npm நிறுவல் (பரிந்துரைக்கப்படுகிறது)

npm install -g omniroute

# உள்ளமைவு கோப்பகத்தை உருவாக்கவும்
mkdir -p ~/.omniroute

# .env கோப்பை உருவாக்கவும் (.env.example-ஐப் பார்க்கவும்)
cp .env.example ~/.omniroute/.env

# சேவையகத்தைத் தொடங்கவும்
omniroute
# அல்லது தனிப்பயன் போர்ட்டுடன்:
omniroute --port 3000

CLI ஆனது ~/.omniroute/.env அல்லது ./.env-இலிருந்து .env-ஐத் தானாக ஏற்றும்.

தட்டு முறை

கணினித் தட்டில் OmniRoute-ஐத் தொடங்கவும்:

omniroute serve --tray

சேவையகமும் தட்டும் தயாரானதும் கட்டளை நிறைவடையும்.

முனையம் இல்லாமலும் சேவையகம் தொடர்ந்து இயங்கும்.

தட்டு முறை macOS, Windows மற்றும் வரைகலை Linux அமர்வுகளை ஆதரிக்கிறது. தட்டு முறை கட்டுப்பாட்டுப் பலகையைத் தானாகத் திறக்காது.

பின்வரும் செயல்களுக்கு தட்டு மெனுவைப் பயன்படுத்தவும்:

கட்டுப்பாட்டுப் பலகையைத் திறக்கவும்.
/dashboard/logs-ஐத் திறக்கவும்.
தானியங்கு தொடக்கத்தை மாற்றவும்.
OmniRoute-ஐ நிறுத்தவும்.

பின்வரும் விருப்பங்களுடன் --tray-ஐ இணைத்துப் பயன்படுத்த வேண்டாம்:

--daemon
--log
--no-recovery

இந்த முறைகளுக்கு வேறுபட்ட செயல்முறை உரிமை தேவைப்படுகிறது.

அடுத்த கணினி உள்நுழைவின்போது தொடங்குவதை இயக்கவும்:

omniroute autostart enable

தானியங்கு தொடக்கம் macOS, Windows மற்றும் வரைகலை Linux அமர்வுகளில் தட்டு முறையைப் பயன்படுத்தும். திரையற்ற Linux ஏற்கனவே உள்ள systemd பயனர் சேவையைப் பயன்படுத்தும்.

உள்நுழையும்போது தொடங்குவதை முடக்கவும்:

omniroute autostart disable

நிறுவல் நீக்கம்

OmniRoute இனி தேவையில்லாதபோது, முழுமையாக அகற்றுவதற்கு இரண்டு விரைவான ஸ்கிரிப்ட்களை வழங்குகிறோம்:

கட்டளை	செயல்
`npm run uninstall`	கணினிச் செயலியை அகற்றும், ஆனால் `~/.omniroute`-இல் உள்ள உங்கள் DB மற்றும் உள்ளமைவுகளைத் தக்கவைக்கும்.
`npm run uninstall:full`	செயலியை அகற்றுவதுடன் அனைத்து உள்ளமைவுகள், விசைகள் மற்றும் தரவுத்தளங்களை நிரந்தரமாக அழிக்கும்.

குறிப்பு: இந்தக் கட்டளைகளை இயக்க, OmniRoute திட்டக் கோப்பகத்திற்குச் சென்று (அதை clone செய்திருந்தால்) அவற்றை இயக்கவும். மாற்றாக, உலகளாவிய முறையில் நிறுவியிருந்தால், npm uninstall -g omniroute என்பதை மட்டும் இயக்கலாம்.

VPS நிறுவல்

git clone https://github.com/diegosouzapw/OmniRoute.git
cd OmniRoute && npm install && npm run build

export JWT_SECRET="your-secure-secret-change-this"
export INITIAL_PASSWORD="your-password"
export DATA_DIR="/var/lib/omniroute"
export PORT="20128"
export HOSTNAME="0.0.0.0"
export NODE_ENV="production"
export NEXT_PUBLIC_BASE_URL="http://localhost:20128"
export API_KEY_SECRET="endpoint-proxy-api-key-secret"

npm run start
# அல்லது: pm2 start npm --name omniroute -- start

PM2 நிறுவல் (குறைந்த நினைவகம்)

குறைந்த RAM கொண்ட சேவையகங்களுக்கு, நினைவக வரம்பு விருப்பத்தைப் பயன்படுத்தவும்:

# 512MB வரம்புடன் (இயல்புநிலை)
pm2 start npm --name omniroute -- start

# அல்லது தனிப்பயன் நினைவக வரம்புடன்
OMNIROUTE_MEMORY_MB=512 pm2 start npm --name omniroute -- start

# அல்லது ecosystem.config.js-ஐப் பயன்படுத்தி
pm2 start ecosystem.config.js

ecosystem.config.js-ஐ உருவாக்கவும்:

module.exports = {
  apps: [
    {
      name: "omniroute",
      script: "npm",
      args: "start",
      env: {
        NODE_ENV: "production",
        OMNIROUTE_MEMORY_MB: "512",
        JWT_SECRET: "your-secret",
        INITIAL_PASSWORD: "your-password",
      },
      node_args: "--max-old-space-size=512",
      max_memory_restart: "300M",
    },
  ],
};

Docker

# படிமத்தை உருவாக்கவும் (இயல்புநிலை = codex/claude/droid முன்பே நிறுவப்பட்ட runner-cli)
docker build -t omniroute:cli .

# எடுத்துச் செல்லக்கூடிய முறை (பரிந்துரைக்கப்படுகிறது)
docker run -d --name omniroute -p 20128:20128 --env-file ./.env -v omniroute-data:/app/data omniroute:cli

CLI பைனரிகளுடன் ஹோஸ்ட்-ஒருங்கிணைந்த முறைக்கு, முதன்மை ஆவணங்களில் உள்ள Docker பகுதியைப் பார்க்கவும்.

Void Linux (xbps-src)

Void Linux பயனர்கள் xbps-src குறுக்குத் தொகுப்பு கட்டமைப்பைப் பயன்படுத்தி OmniRoute-ஐ இயல்பாகத் தொகுப்பாக்கி நிறுவலாம். இது தேவையான better-sqlite3 இயல்புநிலை பிணைப்புகளுடன் Node.js தனித்தியங்கும் உருவாக்கத்தையும் தானியங்குபடுத்துகிறது.

xbps-src வார்ப்புருவைக் காண்க

# 'omniroute'-க்கான வார்ப்புருக் கோப்பு
pkgname=omniroute
version=3.8.0
revision=1
hostmakedepends="nodejs python3 make"
depends="openssl"
short_desc="Universal AI gateway with smart routing for multiple LLM providers"
maintainer="zenobit <zenobit@disroot.org>"
license="MIT"
homepage="https://github.com/diegosouzapw/OmniRoute"
distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz"
checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b
system_accounts="_omniroute"
omniroute_homedir="/var/lib/omniroute"
export NODE_ENV=production
export npm_config_engine_strict=false
export npm_config_loglevel=error
export npm_config_fund=false
export npm_config_audit=false

do_build() {
	# node-gyp-க்கான இலக்கு CPU கட்டமைப்பைத் தீர்மானிக்கவும்
	local _gyp_arch
	case "$XBPS_TARGET_MACHINE" in
		aarch64*) _gyp_arch=arm64 ;;
		armv7*|armv6*) _gyp_arch=arm ;;
		i686*) _gyp_arch=ia32 ;;
		*) _gyp_arch=x64 ;;
	esac

	# 1) அனைத்து சார்புகளையும் நிறுவவும் – ஸ்கிரிப்ட்களைத் தவிர்க்கவும்
	NODE_ENV=development npm ci --ignore-scripts

	# 2) Next.js தனித்தியங்கும் தொகுப்பை உருவாக்கவும்
	npm run build

	# 3) நிலையான வளங்களைத் தனித்தியங்கும் தொகுப்புக்குள் நகலெடுக்கவும்
	cp -r .next/static .next/standalone/.next/static
	[ -d public ] && cp -r public .next/standalone/public || true

	# 4) better-sqlite3 இயல்புநிலை பிணைப்பைத் தொகுக்கவும்
	local _node_gyp=/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js
	(cd node_modules/better-sqlite3 && node "$_node_gyp" rebuild --arch="$_gyp_arch")

	# 5) தொகுக்கப்பட்ட பிணைப்பைத் தனித்தியங்கும் தொகுப்புக்குள் வைக்கவும்
	local _bs3_release=.next/standalone/node_modules/better-sqlite3/build/Release
	mkdir -p "$_bs3_release"
	cp node_modules/better-sqlite3/build/Release/better_sqlite3.node "$_bs3_release/"

	# 6) கட்டமைப்பு சார்ந்த sharp தொகுப்புகளை அகற்றவும்
	rm -rf .next/standalone/node_modules/@img

	# 7) Next.js நிலையான பகுப்பாய்வால் விடுபட்ட pino இயக்கநேரச் சார்புகளை நகலெடுக்கவும்:
	for _mod in pino-abstract-transport split2 process-warning; do
		cp -r "node_modules/$_mod" .next/standalone/node_modules/
	done
}

do_check() {
	npm run test:unit
}

do_install() {
	vmkdir usr/lib/omniroute/.next
	vcopy .next/standalone/. usr/lib/omniroute/.next/standalone

	# நிறுவலுக்குப் பிந்தைய hook மூலம் காலியான Next.js பயன்பாட்டு router அடைவுகள் அகற்றப்படுவதைத் தடுக்கவும்
	for _d in \
		.next/standalone/.next/server/app/dashboard \
		.next/standalone/.next/server/app/dashboard/settings \
		.next/standalone/.next/server/app/dashboard/providers; do
		touch "${DESTDIR}/usr/lib/omniroute/${_d}/.keep"
	done

	cat > "${WRKDIR}/omniroute" <<'EOF'
#!/bin/sh
export PORT="${PORT:-20128}"
export DATA_DIR="${DATA_DIR:-${XDG_DATA_HOME:-${HOME}/.local/share}/omniroute}"
export APP_LOG_TO_FILE="${APP_LOG_TO_FILE:-false}"
mkdir -p "${DATA_DIR}"
exec node /usr/lib/omniroute/.next/standalone/server.js "$@"
EOF
	vbin "${WRKDIR}/omniroute"
}

post_install() {
	vlicense LICENSE
}

சூழல் மாறிகள்

மாறி	இயல்புநிலை	விளக்கம்
`JWT_SECRET`	`omniroute-default-secret-change-me`	JWT கையொப்பமிடும் ரகசியம் (உற்பத்திச் சூழலில் மாற்றவும்)
`INITIAL_PASSWORD`	`CHANGEME`	முதல் உள்நுழைவுக்கான கடவுச்சொல்
`DATA_DIR`	`~/.omniroute`	தரவுக் கோப்பகம் (தரவுத்தளம், பயன்பாடு, பதிவுகள்)
`PORT`	கட்டமைப்பின் இயல்புநிலை	சேவை போர்ட் (எடுத்துக்காட்டுகளில் `20128`)
`HOSTNAME`	கட்டமைப்பின் இயல்புநிலை	பிணைப்பு ஹோஸ்ட் (Docker-இன் இயல்புநிலை `0.0.0.0`)
`NODE_ENV`	இயக்கநேர இயல்புநிலை	வரிசைப்படுத்தலுக்கு `production` என அமைக்கவும்
`NEXT_PUBLIC_BASE_URL`	`http://localhost:20128`	முகப்புப்பலகையில் காட்டப்பட்டு சேவையகத்திற்கும் வெளிப்படுத்தப்படும் பொது அடிப்படை URL (மரபார்ந்த `BASE_URL`-ஐ மாற்றுகிறது)
`NEXT_PUBLIC_CLOUD_URL`	`https://omniroute.dev`	கிளவுட் ஒத்திசைவு முனைப்புள்ளியின் அடிப்படை URL (மரபார்ந்த `CLOUD_URL`-ஐ மாற்றுகிறது)
`API_KEY_SECRET`	`endpoint-proxy-api-key-secret`	உருவாக்கப்பட்ட API விசைகளுக்கான HMAC ரகசியம்
`REQUIRE_API_KEY`	`false`	`/v1/*`-இல் Bearer API விசையைச் செயல்படுத்திக் கட்டாயப்படுத்தும்
`ALLOW_API_KEY_REVEAL`	`false`	அங்கீகரிக்கப்பட்ட முகப்புப்பலகைப் பயனர்கள் கோரிக்கையின் பேரில் சேமிக்கப்பட்ட முழு API விசை மதிப்புகளைப் பார்க்க அனுமதிக்கும்
`PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES`	`70`	தற்காலிகச் சேமிப்பிலுள்ள வழங்குநர் வரம்புத் தரவுக்கான சேவையகப் புதுப்பிப்பு இடைவெளி; UI புதுப்பிப்புப் பொத்தான்கள் இன்னும் கைமுறை ஒத்திசைவைத் தூண்டும்
`DISABLE_SQLITE_AUTO_BACKUP`	`false`	எழுதுதல்/இறக்குமதி/மீட்டமைப்புக்கு முன் தானியங்கு SQLite நகலெடுப்புகளை முடக்கும்; கைமுறை காப்புப்பிரதிகள் தொடர்ந்து செயல்படும்
`APP_LOG_TO_FILE`	`true`	பயன்பாட்டு மற்றும் தணிக்கைப் பதிவு வெளியீட்டை வட்டில் சேமிக்கச் செயல்படுத்தும்
`AUTH_COOKIE_SECURE`	`false`	`Secure` அங்கீகார குக்கியை கட்டாயப்படுத்தும் (HTTPS ரிவர்ஸ் ப்ராக்ஸிக்குப் பின்னால்)
`CLOUDFLARED_BIN`	அமைக்கப்படவில்லை	நிர்வகிக்கப்பட்ட பதிவிறக்கத்திற்குப் பதிலாக ஏற்கனவே உள்ள `cloudflared` பைனரியைப் பயன்படுத்தும்
`CLOUDFLARED_PROTOCOL`	`http2`	நிர்வகிக்கப்பட்ட Quick Tunnels-க்கான போக்குவரத்து (`http2`, `quic`, அல்லது `auto`)
`OMNIROUTE_MEMORY_MB`	`512`	MB-இல் Node.js ஹீப் வரம்பு
`PROMPT_CACHE_MAX_SIZE`	`50`	ப்ராம்ப்ட் தற்காலிகச் சேமிப்பின் அதிகபட்ச உள்ளீடுகள்
`SEMANTIC_CACHE_MAX_SIZE`	`100`	அர்த்தவியல் தற்காலிகச் சேமிப்பின் அதிகபட்ச உள்ளீடுகள்

முழுமையான சூழல் மாறிக் குறிப்புக்கு, README-ஐப் பார்க்கவும்.

📊 கிடைக்கக்கூடிய மாதிரிகள்

கிடைக்கக்கூடிய அனைத்து மாதிரிகளையும் காண்க

கீழேயுள்ள பட்டியல் v3.8.0-க்கான open-sse/config/providerRegistry.ts-இலிருந்து தொகுக்கப்பட்டுள்ளது. கிளவுட் பட்டியல்கள் (Gemini, OpenRouter போன்றவை) மாறும் வகையில் ஒத்திசைக்கப்படுகின்றன — முழுமையான நேரடிப் பட்டியலைக் காண Dashboard → Providers → [provider] → Available Models என்பதைத் திறக்கவும் அல்லது GET /api/models/catalog-ஐ அழைக்கவும்.

வழங்குநரின் உள்ளமைக்கப்பட்ட பட்டியல் காலப்போக்கில் மாறியிருந்தால், நேரடி மூலப் பட்டியலைப் பெற அந்தப் பக்கத்தில் உள்ள Import from /models என்பதைப் பயன்படுத்தவும் (அல்லது Auto-Sync-ஐ இயக்கவும்). இது LLM7.io (gemini-3.1-flash-lite) மற்றும் UncloseAI (solidrust/Hermes-3-Llama-3.1-8B-AWQ) ஆகியவற்றுக்கு v3.8.50-இல் சரிபார்க்கப்பட்டது; அதே சோதனைச் சுற்றின்போது Pollinations-இன் அடையாளமற்ற அணுகல், மூலச் சேவையின் வரம்புகளுக்கு உட்பட்டதாகவே இருந்தது.

Claude Code (cc/) — Pro/Max OAuth: cc/claude-opus-4-8, cc/claude-opus-4-7, cc/claude-opus-4-6, cc/claude-opus-4-5-20251101, cc/claude-sonnet-4-6, cc/claude-sonnet-4-5-20250929, cc/claude-haiku-4-5-20251001

Codex (cx/) — Plus/Pro OAuth: cx/gpt-5.5 (+ முயற்சி நிலைகள்: gpt-5.5-xhigh, gpt-5.5-high, gpt-5.5-medium, gpt-5.5-low), cx/gpt-5.4, cx/gpt-5.4-mini, cx/gpt-5.3-codex, cx/gpt-5.3-codex-spark

GitHub Copilot (gh/) — OAuth: gh/gpt-5.5, gh/gpt-5.4, gh/gpt-5.4-mini, gh/gpt-5-mini, gh/gpt-5.3-codex, gh/claude-opus-4.7, gh/claude-opus-4.6, gh/claude-opus-4-5-20251101, gh/claude-sonnet-4.6, gh/claude-sonnet-4.5, gh/claude-haiku-4.5, gh/gemini-3.1-pro-preview, gh/gemini-3-flash-preview, gh/oswe-vscode-prime

Kiro (kr/) — இலவச OAuth: Dashboard → Providers → Kiro → Available Models என்பதன் கீழ் காட்டப்படும் நேரடிப் பட்டியலைப் பயன்படுத்தவும். கிடைக்கும் தன்மை கணக்கு மற்றும் திட்டத்தைச் சார்ந்தது.

Qoder (if/) — இலவச OAuth: if/qwen3.8-max-preview, if/qwen3.7-max, if/qwen3.7-plus, if/kimi-k3, if/kimi-k2.7-code, if/glm-5.2, if/deepseek-v4-pro, if/deepseek-v4-flash, if/minimax-m3

GLM (glm/, glm-cn/, zai/, glmt/) — $0.2–0.6/1M: glm/glm-5.1, glm/glm-5, glm/glm-5-turbo, glm/glm-4.7, glm/glm-4.7-flash, glm/glm-4.6, glm/glm-4.6v, glm/glm-4.5, glm/glm-4.5v, glm/glm-4.5-air

MiniMax (minimax/, minimax-cn/) — $0.2/1M: minimax/MiniMax-M2.7, minimax/MiniMax-M2.7-highspeed, minimax/MiniMax-M2.5, minimax/MiniMax-M2.5-highspeed

Kimi (kimi/, kimi-coding/, kimi-coding-apikey/) — மாதத்திற்கு நிலையான $9 அல்லது பயன்பாட்டுக்கு ஏற்ப: kimi/kimi-k2.6, kimi/kimi-k2.5

DeepSeek (ds/) — API விசை: ds/deepseek-v4-pro, ds/deepseek-v4-flash

Groq (groq/) — அதிவேகமானது: groq/llama-3.3-70b-versatile, groq/meta-llama/llama-4-maverick-17b-128e-instruct, groq/qwen/qwen3-32b, groq/openai/gpt-oss-120b

xAI (xai/) — இயல்புநிலை Grok: xai/grok-4.3, xai/grok-4.20-multi-agent-0309, xai/grok-4.20-0309-reasoning, xai/grok-4.20-0309-non-reasoning

Mistral (mistral/) — EU-இல் ஹோஸ்ட் செய்யப்பட்டது: mistral/mistral-large-latest, mistral/mistral-medium-3-5, mistral/mistral-small-latest, mistral/devstral-latest, mistral/codestral-latest

Perplexity (pplx/) — தேடலால் மேம்படுத்தப்பட்டது: pplx/sonar-deep-research, pplx/sonar-reasoning-pro, pplx/sonar-pro, pplx/sonar

Together AI (together/) — திறந்த மூலம்: together/meta-llama/Llama-3.3-70B-Instruct-Turbo-Free (இலவசம்), together/meta-llama/Llama-Vision-Free, together/deepseek-ai/DeepSeek-R1-Distill-Llama-70B-Free, together/deepseek-ai/DeepSeek-R1, together/Qwen/Qwen3-235B-A22B, together/meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8

Fireworks AI (fireworks/) — வேகமான அனுமானம்: fireworks/accounts/fireworks/models/kimi-k2p6, fireworks/accounts/fireworks/models/minimax-m2p7, fireworks/accounts/fireworks/models/qwen3p6-plus, fireworks/accounts/fireworks/models/glm-5p1, fireworks/accounts/fireworks/models/deepseek-v4-pro

Cerebras (cerebras/) — வேஃபர் அளவிலானது: cerebras/zai-glm-4.7, cerebras/gpt-oss-120b

Cohere (cohere/) — RAG-ஐ மையமாகக் கொண்டது: cohere/command-a-reasoning-08-2025, cohere/command-a-vision-07-2025, cohere/command-a-03-2025, cohere/command-r-08-2024

NVIDIA NIM (nvidia/) — நிறுவனப் பயன்பாடு: nvidia/z-ai/glm-5.1, nvidia/minimaxai/minimax-m2.7, nvidia/google/gemma-4-31b-it, nvidia/mistralai/mistral-small-4-119b-2603, nvidia/mistralai/mistral-large-3-675b-instruct-2512, nvidia/qwen/qwen3.5-397b-a17b, nvidia/deepseek-ai/deepseek-v4-pro, nvidia/openai/gpt-oss-120b, nvidia/nvidia/nemotron-3-super-120b-a12b

Baidu Qianfan (qianfan/) — ERNIE: qianfan/ernie-5.1, qianfan/ernie-5.0-thinking-latest, qianfan/ernie-x1.1

Ollama Cloud (ollama-cloud/): ollama-cloud/deepseek-v4-pro, ollama-cloud/deepseek-v4-flash, ollama-cloud/kimi-k2.6, ollama-cloud/glm-5.1, ollama-cloud/minimax-m2.7, ollama-cloud/gemma4:31b, ollama-cloud/qwen3.5:397b

Gemini (Google Cloud gemini/): Google-இலிருந்து ஒவ்வொரு API விசைக்கும் நேரடியாக ஒத்திசைக்கப்படுகிறது — நிலையான பட்டியல் இல்லை. Dashboard → Providers என்பதில் ஒரு விசையை இணைத்து, தற்போதைய பட்டியலை இறக்குமதி செய்ய Available Models என்பதைப் பயன்படுத்தவும் (எ.கா. gemini/gemini-3-pro, gemini/gemini-3-flash).

பிற இணக்கமான வழங்குநர்கள் (தேர்ந்தெடுக்கப்பட்டவை): cohere, databricks, snowflake, together, vertex, alibaba, alibaba-cn, bedrock (aws-bedrock வழியாக), azure-ai, openrouter (இடைமாற்றமில்லா பட்டியல்), siliconflow, hyperbolic, huggingface, featherless-ai, cloudflare-ai, scaleway, deepinfra, vercel-ai-gateway, bazaarlink, friendliai, nous-research, reka, volcengine, ai21, gigachat. ஒவ்வொன்றும் providerRegistry.ts-இல் தனது சொந்த மாதிரிப் பட்டியலைப் பராமரிக்கிறது; மேலும் வழங்குநர் /models முனைப்புள்ளியை வெளிப்படுத்தும்போது அவற்றைத் தானாக ஒத்திசைக்க முடியும்.

மாதிரி ID-கள் குறித்த குறிப்பு: OmniRoute வழங்குநருக்குரிய அசல் ID-களைப் பயன்படுத்துகிறது (claude-opus-4-8, gpt-5.5, glm-5.1, MiniMax-M2.7, kimi-k2.5, grok-4.20-0309-reasoning). மூல API அவற்றை அவ்வாறே எதிர்பார்ப்பதால், சில ID-களில் புள்ளிகளுடன் கூடிய பதிப்புகள் உள்ளன. ஒரு மாதிரி மேலே பட்டியலிடப்படவில்லை என்றால், அது கிடைக்கிறதா என்பதை உறுதிப்படுத்த omniroute models --search <term>-ஐ இயக்கவும் அல்லது GET /api/models/catalog-ஐ அணுகவும்.

🧩 மேம்பட்ட அம்சங்கள்

தனிப்பயன் மாடல்கள்

செயலி புதுப்பிப்புக்காகக் காத்திருக்காமல், எந்த வழங்குநரிலும் எந்த மாடல் ID-யையும் சேர்க்கலாம்:

# API வழியாக
curl -X POST http://localhost:20128/api/provider-models \
  -H "Content-Type: application/json" \
  -d '{"provider": "openai", "modelId": "gpt-5.2", "modelName": "GPT-5.2"}'

# பட்டியலிடுக: curl http://localhost:20128/api/provider-models?provider=openai
# அகற்றுக: curl -X DELETE "http://localhost:20128/api/provider-models?provider=openai&model=gpt-5.2"

அல்லது டாஷ்போர்டைப் பயன்படுத்தவும்: வழங்குநர்கள் → [வழங்குநர்] → தனிப்பயன் மாடல்கள்.

குறிப்புகள்:

OpenRouter மற்றும் OpenAI/Anthropic-இணக்கமான வழங்குநர்கள் கிடைக்கக்கூடிய மாடல்கள் என்பதிலிருந்து மட்டுமே நிர்வகிக்கப்படுகின்றனர். கைமுறைச் சேர்ப்பு, இறக்குமதி மற்றும் தானியங்கிய ஒத்திசைவு ஆகிய அனைத்தும் ஒரே கிடைக்கக்கூடிய-மாடல்கள் பட்டியலில் சேரும்; எனவே அந்த வழங்குநர்களுக்குத் தனியான தனிப்பயன் மாடல்கள் பிரிவு இல்லை.
நிர்வகிக்கப்படும் கிடைக்கக்கூடிய-மாடல் இறக்குமதிகளை வழங்காத வழங்குநர்களுக்காகவே தனிப்பயன் மாடல்கள் பிரிவு உருவாக்கப்பட்டுள்ளது.

OmniRoute சக நுழைவாயில்களைச் சங்கிலியாக இணைத்தல்

மற்றொரு OmniRoute நுழைவாயிலை தனிப்பயன் OpenAI-இணக்கமான வழங்குநராகச் சேர்க்கலாம். அந்தச் சக நுழைவாயிலின் /v1 அடிப்படை URL மற்றும் அதனால் வழங்கப்பட்ட பிரத்யேகமான, குறைந்தபட்சச் சிறப்புரிமை கொண்ட API விசையைப் பயன்படுத்தவும்.

இருவழி அல்லது பல-தாவல் சங்கிலிகளுக்கு, ஒவ்வொரு நுழைவாயிலிலும் விருப்பத் தேர்வான சுழற்சித் தடுப்பைச் செயல்படுத்தவும்:

# gateway-a
OMNIROUTE_INSTANCE_ID=gateway-a
OMNIROUTE_PEER_URLS=http://gateway-b:20128/v1
OMNIROUTE_PEER_MAX_HOPS=4

# gateway-b
OMNIROUTE_INSTANCE_ID=gateway-b
OMNIROUTE_PEER_URLS=http://gateway-a:20128/v1
OMNIROUTE_PEER_MAX_HOPS=4

வெளிப்படையாக அனுமதிப்பட்டியலில் சேர்க்கப்பட்டுள்ள சக நுழைவாயில் URL-க்கு அனுப்பப்படும் கோரிக்கைகள் மட்டுமே X-OmniRoute-Peer-Trace தலைப்பைப் பெறும். மீண்டும் வரும் instance ID அல்லது தீர்ந்துவிட்ட தாவல் வரம்பைக் கொண்ட கோரிக்கையை நுழைவாயில் HTTP 508 Loop Detected உடன் நிராகரிக்கும்; வழக்கமான மேல்நிலை வழங்குநர்கள் எந்தச் சக நுழைவாயில் மெட்டாதரவையும் பெற மாட்டார்கள்.

சக நுழைவாயில் சங்கிலியமைப்பு என்பது தரவுத்தளப் பிரதியெடுப்போ ஹோஸ்ட் தோல்விமாற்றமோ அல்ல. ஒவ்வொரு நுழைவாயிலும் தனித்தனி SQLite நிலை, தற்காலிகச் சேமிப்புகள், விகித எண்ணிகள் மற்றும் அமர்வுகளை வைத்திருக்கும். செயலில்/செயலற்ற அல்லது செயலில்/செயலில் கிடைப்புத்தன்மைக்கு, உடல்நிலைச் சரிபார்ப்புடன் கூடிய தலைகீழ் ப்ராக்ஸி அல்லது கிளையன்ட் தோல்விமாற்றத்தைப் பயன்படுத்தவும்; ஒரே SQLite தரவுத்தளத்தை இயங்கிக்கொண்டிருக்கும் பல OmniRoute instance-களில் ஒருபோதும் mount செய்ய வேண்டாம்.

பிரத்யேக வழங்குநர் வழித்தடங்கள்

மாடல் சரிபார்ப்புடன் கோரிக்கைகளை நேரடியாக ஒரு குறிப்பிட்ட வழங்குநருக்கு வழிப்படுத்தவும்:

POST http://localhost:20128/v1/providers/openai/chat/completions
POST http://localhost:20128/v1/providers/openai/embeddings
POST http://localhost:20128/v1/providers/fireworks/images/generations

வழங்குநர் முன்னொட்டு இல்லாவிட்டால் அது தானாகச் சேர்க்கப்படும். பொருந்தாத மாடல்கள் 400 என்பதை வழங்கும்.

நெட்வொர்க் ப்ராக்ஸி உள்ளமைவு

# உலகளாவிய ப்ராக்ஸியை அமைக்கவும்
curl -X PUT http://localhost:20128/api/settings/proxy \
  -d '{"global": {"type":"http","host":"proxy.example.com","port":"8080"}}'

# ஒவ்வொரு வழங்குநருக்குமான ப்ராக்ஸி
curl -X PUT http://localhost:20128/api/settings/proxy \
  -d '{"providers": {"openai": {"type":"socks5","host":"proxy.example.com","port":"1080"}}}'

# ப்ராக்ஸியைச் சோதிக்கவும்
curl -X POST http://localhost:20128/api/settings/proxy/test \
  -d '{"proxy":{"type":"socks5","host":"proxy.example.com","port":"1080"}}}'

முன்னுரிமை வரிசை: விசை-குறிப்பிட்டது → சேர்க்கை-குறிப்பிட்டது → வழங்குநர்-குறிப்பிட்டது → உலகளாவியது → சூழல்.

மாடல் பட்டியல் API

curl http://localhost:20128/api/models/catalog

வழங்குநரின் அடிப்படையில் வகைப்படுத்தப்பட்ட மாடல்களை அவற்றின் வகைகளுடன் (chat, embedding, image) வழங்குகிறது.

கிளவுட் ஒத்திசைவு

சாதனங்கள் முழுவதும் வழங்குநர்கள், சேர்க்கைகள் மற்றும் அமைப்புகளை ஒத்திசைக்கவும்
காலக்கெடு மற்றும் உடனடித் தோல்வியுடன் கூடிய தானியங்கிப் பின்னணி ஒத்திசைவு
தயாரிப்புச் சூழலில் சர்வர் தரப்பு NEXT_PUBLIC_BASE_URL/NEXT_PUBLIC_CLOUD_URL என்பவற்றை முன்னுரிமைப்படுத்தவும்

Cloudflare விரைவு சுரங்கப்பாதை

Docker மற்றும் சுயமாக ஹோஸ்ட் செய்யப்பட்ட பிற நிறுவல்களுக்கு டாஷ்போர்டு → முனைப்புள்ளிகள் என்பதில் கிடைக்கும்
உங்கள் தற்போதைய OpenAI-இணக்கமான /v1 முனைப்புள்ளிக்கு அனுப்பிவைக்கும் தற்காலிக https://*.trycloudflare.com URL-ஐ உருவாக்குகிறது
முதல் முறை செயல்படுத்தும்போது, தேவைப்பட்டால் மட்டுமே cloudflared நிறுவப்படும்; பின்னர் மறுதொடக்கங்கள் அதே நிர்வகிக்கப்பட்ட binary-ஐ மீண்டும் பயன்படுத்தும்
OmniRoute அல்லது container மறுதொடக்கத்திற்குப் பிறகு விரைவு சுரங்கப்பாதைகள் தானாக மீட்டமைக்கப்படாது; தேவைப்படும்போது டாஷ்போர்டிலிருந்து அவற்றை மீண்டும் செயல்படுத்தவும்
சுரங்கப்பாதை URL-கள் நிலையற்றவை; சுரங்கப்பாதையை நிறுத்தி/தொடங்கும் ஒவ்வொரு முறையும் அவை மாறும்
கட்டுப்படுத்தப்பட்ட container-களில் சத்தமிகுந்த QUIC UDP buffer எச்சரிக்கைகளைத் தவிர்க்க, நிர்வகிக்கப்பட்ட விரைவு சுரங்கப்பாதைகள் இயல்பாக HTTP/2 போக்குவரத்தைப் பயன்படுத்தும்
நிர்வகிக்கப்பட்ட போக்குவரத்துத் தேர்வை மீற விரும்பினால் CLOUDFLARED_PROTOCOL=quic அல்லது auto என அமைக்கவும்
நிர்வகிக்கப்பட்ட பதிவிறக்கத்திற்குப் பதிலாக முன்பே நிறுவப்பட்ட cloudflared binary-ஐப் பயன்படுத்த விரும்பினால் CLOUDFLARED_BIN என அமைக்கவும்
Cloudflare விரைவு சுரங்கப்பாதை, Tailscale Funnel மற்றும் ngrok சுரங்கப்பாதை பலகைகளை அமைப்புகள் → தோற்றம் என்பதில் காட்டலாம் அல்லது மறைக்கலாம். ஒரு பலகையை மறைப்பது இயங்கிக்கொண்டிருக்கும் சுரங்கப்பாதையை நிறுத்தாது.

LLM நுழைவாயில் நுண்ணறிவு (கட்டம் 9)

பொருள்சார் தற்காலிகச் சேமிப்பு — ஸ்ட்ரீமிங் அல்லாத, temperature=0 பதில்களைத் தானாகத் தற்காலிகச் சேமிக்கிறது (X-OmniRoute-No-Cache: true மூலம் தவிர்க்கலாம்)
கோரிக்கை ஒருமுறைச் செயலாக்கம் — Idempotency-Key அல்லது X-Request-Id தலைப்பு வழியாக 5 வினாடிகளுக்குள் வரும் ஒரேமாதிரியான கோரிக்கைகளை நீக்குகிறது
முன்னேற்றக் கண்காணிப்பு — X-OmniRoute-Progress: true தலைப்பு வழியாக விருப்பத் தேர்வான SSE event: progress நிகழ்வுகளை வழங்குகிறது

மொழிபெயர்ப்பாளர் பயிற்சிக்களம்

டாஷ்போர்டு → மொழிபெயர்ப்பாளர் வழியாக அணுகவும். வழங்குநர்களுக்கு இடையில் OmniRoute எவ்வாறு API கோரிக்கைகளை மொழிபெயர்க்கிறது என்பதைப் பிழைத்திருத்தி காட்சிப்படுத்தவும்.

பயன்முறை	நோக்கம்
பயிற்சிக்களம்	மூல/இலக்கு வடிவங்களைத் தேர்ந்தெடுத்து, கோரிக்கையை ஒட்டி, மொழிபெயர்க்கப்பட்ட வெளியீட்டை உடனடியாகப் பார்க்கவும்
அரட்டைச் சோதனையாளர்	ப்ராக்ஸி வழியாக நேரடி அரட்டைச் செய்திகளை அனுப்பி, முழுமையான கோரிக்கை/பதில் சுழற்சியை ஆய்வு செய்யவும்
சோதனைத் தளம்	மொழிபெயர்ப்பின் சரியான தன்மையைச் சரிபார்க்க, பல வடிவச் சேர்க்கைகள் முழுவதும் தொகுதிச் சோதனைகளை இயக்கவும்
நேரடி கண்காணிப்பான்	கோரிக்கைகள் ப்ராக்ஸி வழியாகச் செல்லும்போது நிகழ்நேர மொழிபெயர்ப்புகளைக் கண்காணிக்கவும்

பயன்பாட்டு நிலைகள்:

ஒரு குறிப்பிட்ட கிளையன்ட்/வழங்குநர் சேர்க்கை ஏன் தோல்வியடைகிறது என்பதைப் பிழைத்திருத்துதல்
சிந்தனைக் குறிச்சொற்கள், கருவி அழைப்புகள் மற்றும் system prompt-கள் சரியாக மொழிபெயர்க்கப்படுகின்றனவா என்பதைச் சரிபார்த்தல்
OpenAI, Claude, Gemini மற்றும் Responses API வடிவங்களுக்கு இடையிலான வடிவ வேறுபாடுகளை ஒப்பிடுதல்

வழித்தட உத்திகள்

Dashboard → Settings → Routing வழியாக உள்ளமைக்கவும். டாஷ்போர்டில் அதிகம் பயன்படுத்தப்படும் ஆறு உத்திகள் காட்டப்படுகின்றன; சேர்க்கைகளும் auto-router-உம் உள்நிலையில் மேலும் விரிவான உத்தித் தொகுப்பை ஆதரிக்கின்றன.

டாஷ்போர்டில் காணக்கூடிய உத்திகள் (கணக்கு-நிலை வழித்தடத் தேர்வு):

உத்தி	விளக்கம்
Fill First	முன்னுரிமை வரிசையில் கணக்குகளைப் பயன்படுத்தும் — முதன்மைக் கணக்கு கிடைக்காமல் போகும் வரை அனைத்து கோரிக்கைகளையும் அதுவே கையாளும்
Round Robin	உள்ளமைக்கக்கூடிய sticky வரம்புடன் அனைத்து கணக்குகளையும் சுழற்சி முறையில் பயன்படுத்தும் (இயல்புநிலை: ஒரு கணக்கிற்கு 3 அழைப்புகள்)
P2C (Power of Two Choices)	சீரற்ற முறையில் 2 கணக்குகளைத் தேர்ந்தெடுத்து, அவற்றில் ஆரோக்கியமானதற்கு வழித்தடம் அமைக்கும் — ஆரோக்கிய நிலையைக் கருத்தில் கொண்டு சுமையைச் சமநிலைப்படுத்தும்
Random	Fisher-Yates shuffle-ஐப் பயன்படுத்தி ஒவ்வொரு கோரிக்கைக்கும் ஒரு கணக்கைச் சீரற்ற முறையில் தேர்ந்தெடுக்கும்
Least Used	மிகவும் பழைய `lastUsedAt` நேர முத்திரையைக் கொண்ட கணக்கிற்கு வழித்தடம் அமைத்து, போக்குவரத்தைச் சீராகப் பகிர்ந்தளிக்கும்
Cost Optimized	மிகக் குறைந்த முன்னுரிமை மதிப்பைக் கொண்ட கணக்கிற்கு வழித்தடம் அமைத்து, மிகக் குறைந்த செலவிலான வழங்குநர்களுக்காக மேம்படுத்தும்

மேம்பட்ட சேர்க்கை மற்றும் auto உத்திகள் (ஒவ்வொரு சேர்க்கைக்கும் தனித்தனியாக அல்லது auto/* முன்னொட்டுகள் வழியாக உள்ளமைக்கலாம் — AUTO-COMBO.md-ஐப் பார்க்கவும்):

priority — கண்டிப்பான வரிசை; round-robin முறையை ஒருபோதும் பயன்படுத்தாது
weighted — ஒவ்வொரு மாதிரிக்குமான எடைகளின் அடிப்படையில் விகிதாசாரப் போக்குவரத்துப் பிரிப்பு
fill-first — வரம்புகளை எட்டும் வரை முதல் மாதிரியை முழுமையாகப் பயன்படுத்தும்
round-robin / strict-random / random
p2c (Power of Two Choices)
least-used மற்றும் cost-optimized
auto — அனைத்து தேர்வுகளிலும் மதிப்பெண் சார்ந்து தேர்ந்தெடுக்கும்
lkgp (Last Known Good Provider) — கடைசியாக வெற்றியடைந்த வழங்குநரை நிலைநிறுத்தி, பின்னர் விதிகளின் அடிப்படையில் மாற்று வழியைப் பயன்படுத்தும்
context-optimized — மிகப்பெரிய இலவச context window கொண்ட மாதிரியைத் தேர்ந்தெடுக்கும்
context-relay — தொடர் உரையாடல்களுக்காக நீண்ட-context மாதிரிகளைச் சங்கிலியாக இணைக்கும்

வெளிப்புற Sticky Session தலைப்பு

வெளிப்புற session affinity-க்காக (எடுத்துக்காட்டாக, reverse proxy-களுக்குப் பின்னால் உள்ள Claude Code/Codex முகவர்கள்), இதை அனுப்பவும்:

X-Session-Id: your-session-key

OmniRoute, x_session_id-ஐயும் ஏற்றுக்கொண்டு, நடைமுறையில் பயன்படுத்தப்பட்ட session key-ஐ X-OmniRoute-Session-Id-இல் திருப்பி அனுப்பும்.

நீங்கள் Nginx-ஐப் பயன்படுத்தி underscore வடிவிலான தலைப்புகளை அனுப்பினால், இதை இயக்கவும்:

underscores_in_headers on;

Wildcard மாதிரி மாற்றுப்பெயர்கள்

மாதிரிப் பெயர்களை மறுவரைபடம் செய்ய wildcard வடிவங்களை உருவாக்கவும்:

வடிவம்: claude-sonnet-*     →  இலக்கு: cc/claude-sonnet-4-6
வடிவம்: gpt-*               →  இலக்கு: gh/gpt-5.3-codex

Wildcard-கள் * (எத்தகைய எழுத்துகளும்) மற்றும் ? (ஒற்றை எழுத்து) ஆகியவற்றை ஆதரிக்கின்றன.

மாற்று வழிச் சங்கிலிகள்

அனைத்து கோரிக்கைகளுக்கும் பொருந்தும் உலகளாவிய மாற்று வழிச் சங்கிலிகளை வரையறுக்கவும்:

சங்கிலி: production-fallback
  1. cc/claude-opus-4-7
  2. gh/gpt-5.3-codex
  3. glm/glm-4.7

மீள்திறன் & Circuit Breaker-கள்

Dashboard → Settings → Resilience வழியாக உள்ளமைக்கவும்.

OmniRoute, ஐந்து கூறுகளைக் கொண்ட வழங்குநர்-நிலை மீள்திறனைச் செயல்படுத்துகிறது:

கோரிக்கை வரிசை & வேகக் கட்டுப்பாடு — கணினி-நிலை கோரிக்கை வடிவமைப்பு:
- நிமிடத்திற்கான கோரிக்கைகள் (RPM) — ஒரு கணக்கிற்கு ஒரு நிமிடத்தில் அனுமதிக்கப்படும் அதிகபட்ச கோரிக்கைகள்
- கோரிக்கைகளுக்கு இடையிலான குறைந்தபட்ச நேரம் — கோரிக்கைகளுக்கு இடையிலான குறைந்தபட்ச இடைவெளி, மில்லிவினாடிகளில்
- அதிகபட்ச ஒரேநேரக் கோரிக்கைகள் — ஒரு கணக்கிற்கான அதிகபட்ச ஒரேநேரக் கோரிக்கைகள்
இணைப்பு Cooldown — மீண்டும் முயற்சிக்கக்கூடிய தோல்விகளுக்குப் பிறகு, ஓர் இணைப்பிற்கான auth-type வாரியான உள்ளமைவு:
- அடிப்படை Cooldown — மீண்டும் முயற்சிக்கக்கூடிய upstream தோல்விகளுக்கான இயல்புநிலை cooldown காலம்
- Upstream Retry குறிப்புகளைப் பயன்படுத்து — வழங்கப்பட்டால், அதிகாரப்பூர்வமான Retry-After அல்லது reset குறிப்புகளை மதிக்கும்
- அதிகபட்ச Backoff படிகள் — தொடர்ச்சியான தோல்விகளுக்கான அதிகபட்ச exponential backoff நிலை
வழங்குநர் Circuit Breaker — தொடக்கம் முதல் முடிவு வரையிலான வழங்குநர் தோல்விகளைக் கண்காணித்து, உள்ளமைக்கப்பட்ட எச்சரிக்கை வரம்பில் ஒரு வழங்குநரைச் சீர்குன்றியதாகக் குறிக்கும்; உள்ளமைக்கப்பட்ட தோல்வி வரம்பை எட்டும்போது breaker-ஐத் திறக்கும்:
- சீர்குன்றல் வரம்பு — DEGRADED நிலைக்குச் செல்வதற்கு முன் ஏற்படக்கூடிய தொடர்ச்சியான வழங்குநர் தோல்விகள்
- தோல்வி வரம்பு — OPEN நிலைக்குச் செல்வதற்கு முன் ஏற்படக்கூடிய தொடர்ச்சியான வழங்குநர் தோல்விகள்
- Reset காலாவதி — வழங்குநர் மீண்டும் சோதிக்கப்படுவதற்கு முன்பான கால இடைவெளி
- CLOSED (ஆரோக்கியமானது) — கோரிக்கைகள் வழக்கம்போல் பாயும்
- DEGRADED — அதிகரித்த தோல்விகள் கண்காணிக்கப்படும் போதும் கோரிக்கைகள் தொடர்ந்து பாயும்
- OPEN — தொடர்ச்சியான தோல்விகளுக்குப் பிறகு வழங்குநர் தற்காலிகமாகத் தடுக்கப்படுவார்
- HALF_OPEN — வழங்குநர் மீண்டுள்ளாரா எனச் சோதிக்கப்படும்
இணைப்பு-வரம்புடைய 429 விகித வரம்புகள் Connection Cooldown-இலேயே இருக்கும்; அவை வழங்குநர் breaker கணக்கில் சேர்க்கப்படாது.

வழங்குநர் breaker-இன் இயக்கநேர நிலை Dashboard → Health-இல் மட்டுமே காட்டப்படும்.
Cooldown-க்காகக் காத்திருத்தல் — சாத்தியமான அனைத்து இணைப்புகளும் ஏற்கெனவே cooldown நிலையில் இருந்தால், OmniRoute மிக விரைவில் முடியும் cooldown வரை காத்திருந்து, அதே client கோரிக்கையைத் தானாக மீண்டும் முயற்சிக்க முடியும்.
விகித வரம்பைத் தானாகக் கண்டறிதல் — upstream வழங்குநர்கள் வெளிப்படையான காத்திருப்பு காலங்களை வழங்கும்போது, இந்த அமைப்பு இயக்கப்பட்டிருந்தால் அந்தக் குறிப்புகள் உள்ளூர் இணைப்பு cooldown-ஐ மீறி முன்னுரிமை பெறும்.

வல்லுநர் குறிப்பு: செயலிழப்புக்குப் பிறகு செயலிலுள்ள வழங்குநர் breaker-களை ஆய்வு செய்து reset செய்ய Health பக்கத்தைப் பயன்படுத்தவும். Resilience பக்கம் உள்ளமைவை மட்டுமே மாற்றும்.

தரவுத்தள ஏற்றுமதி / இறக்குமதி

தரவுத்தளக் காப்புப்பிரதிகளை Dashboard → Settings → System & Storage-இல் நிர்வகிக்கவும்.

செயல்	விளக்கம்
தரவுத்தளத்தை ஏற்றுமதி செய்	தற்போதைய SQLite தரவுத்தளத்தை `.sqlite` கோப்பாகப் பதிவிறக்குகிறது
அனைத்தையும் ஏற்றுமதி செய் (.tar.gz)	தரவுத்தளம், அமைப்புகள், combos, provider இணைப்புகள் (நற்சான்றுகள் இல்லாமல்), API key metadata ஆகியவற்றை உள்ளடக்கிய முழுமையான காப்பகத்தைப் பதிவிறக்குகிறது
தரவுத்தளத்தை இறக்குமதி செய்	தற்போதைய தரவுத்தளத்தை மாற்றுவதற்கு ஒரு `.sqlite` கோப்பைப் பதிவேற்றுகிறது. `DISABLE_SQLITE_AUTO_BACKUP=true` என அமைக்கப்படாத வரை, இறக்குமதிக்கு முந்தைய காப்புப்பிரதி தானாக உருவாக்கப்படும்

# API: தரவுத்தளத்தை ஏற்றுமதி செய்
curl -o backup.sqlite http://localhost:20128/api/db-backups/export

# API: அனைத்தையும் ஏற்றுமதி செய் (முழுமையான காப்பகம்)
curl -o backup.tar.gz http://localhost:20128/api/db-backups/exportAll

# API: தரவுத்தளத்தை இறக்குமதி செய்
curl -X POST http://localhost:20128/api/db-backups/import \
  -F "file=@backup.sqlite"

இறக்குமதிச் சரிபார்ப்பு: இறக்குமதி செய்யப்பட்ட கோப்பு ஒருமைப்பாடு (SQLite pragma சோதனை), தேவையான அட்டவணைகள் (provider_connections, provider_nodes, combos, api_keys) மற்றும் அளவு (அதிகபட்சம் 100MB) ஆகியவற்றுக்காகச் சரிபார்க்கப்படுகிறது.

பயன்பாட்டுச் சூழல்கள்:

OmniRoute-ஐ இயந்திரங்களுக்கு இடையே மாற்றுதல்
பேரிடர் மீட்புக்காக வெளிப்புறக் காப்புப்பிரதிகளை உருவாக்குதல்
குழு உறுப்பினர்களுக்கு இடையே உள்ளமைவுகளைப் பகிர்தல் (அனைத்தையும் ஏற்றுமதி செய் → காப்பகத்தைப் பகிர்)

அமைப்புகள் முகப்புப்பலகை

எளிதாக வழிசெலுத்துவதற்காக அமைப்புகள் பக்கம் 7 தாவல்களாக ஒழுங்கமைக்கப்பட்டுள்ளது:

தாவல்	உள்ளடக்கங்கள்
பொது	கணினிச் சேமிப்பகக் கருவிகள், இயல்புநிலை நடத்தை, Endpoint tunnel காட்சித்தன்மை
தோற்றம்	Theme கட்டுப்பாடுகள் (light/dark/system), sidebar காட்சித்தன்மை, Cloudflare/Tailscale/ngrok tunnel அட்டைகளுக்கான panel நிலைமாற்றிகள்
AI	Thinking budget (passthrough / auto-strip / custom / adaptive — THINKING_BUDGET.md-ஐப் பார்க்கவும்), உலகளாவிய system prompt, prompt cache புள்ளிவிவரங்கள்
பாதுகாப்பு	Login/Password அமைப்புகள், IP அணுகல் கட்டுப்பாடு, `/models`-க்கான API auth, Provider தடுப்பு, prompt-injection பாதுகாப்பு
வழித்தடமிடல்	உலகளாவிய வழித்தடமிடல் உத்தி (Fill First / Round Robin / P2C / Random / Least Used / Cost Optimized), wildcard model மாற்றுப்பெயர்கள், fallback chains, combo இயல்புநிலைகள்
மீள்திறன்	கோரிக்கை வரிசை, இணைப்பு cooldown, provider breaker உள்ளமைவு மற்றும் wait-for-cooldown நடத்தை
மேம்பட்டவை	உலகளாவிய proxy உள்ளமைவு (HTTP/SOCKS5), ஒவ்வொரு provider-க்குமான proxy overrides

பொது தாவல் இனி படிக்க மட்டும் இயலும் logging மற்றும் cache குறிப்புகளை நகலெடுத்துக் காட்டாது. தரவுத்தளத் தக்கவைப்பு மற்றும் உகப்பாக்க அமைப்புகள் /api/settings/database வழியாகச் சேமிக்கப்படுகின்றன; cache-ஐக் கைமுறையாக அழிப்பதற்கு DELETE /api/cache பயன்படுத்தப்படுகிறது. கோரிக்கை மற்றும் proxy பதிவு வரிசைகளின் அதிகபட்ச வரம்புகள் CALL_LOGS_TABLE_MAX_ROWS மற்றும் PROXY_LOGS_TABLE_MAX_ROWS மூலம் கட்டுப்படுத்தப்படுகின்றன.

செலவுகள் மற்றும் வரவுசெலவுத் திட்ட மேலாண்மை

முகப்புப்பலகை → செலவுகள் வழியாக அணுகவும்.

தாவல்	நோக்கம்
வரவுசெலவுத் திட்டம்	தினசரி/வாராந்திர/மாதாந்திர வரவுசெலவுத் திட்டங்கள் மற்றும் நிகழ்நேரக் கண்காணிப்புடன் ஒவ்வொரு API key-க்கும் செலவு வரம்புகளை அமைக்கவும்
விலை நிர்ணயம்	ஒவ்வொரு provider-க்குமான 1K input/output tokens செலவு உள்ளிட்ட model விலைப் பதிவுகளைப் பார்த்துத் திருத்தவும்

# API: ஒரு வரவுசெலவுத் திட்டத்தை அமைக்கவும்
curl -X POST http://localhost:20128/api/usage/budget \
  -H "Content-Type: application/json" \
  -d '{"keyId": "key-123", "limit": 50.00, "period": "monthly"}'

# API: தற்போதைய வரவுசெலவுத் திட்ட நிலையைக் காணவும்
curl http://localhost:20128/api/usage/budget

செலவுக் கண்காணிப்பு: ஒவ்வொரு கோரிக்கையும் token பயன்பாட்டைப் பதிவுசெய்து, விலை அட்டவணையைப் பயன்படுத்திச் செலவைக் கணக்கிடுகிறது. Provider, model மற்றும் API key வாரியான விவரங்களை முகப்புப்பலகை → பயன்பாடு என்பதில் காணலாம்.

ஒலிப் படியெடுத்தல்

OpenAI-இணக்கமான endpoint மூலம் ஒலிப் படியெடுத்தலை OmniRoute ஆதரிக்கிறது:

POST /v1/audio/transcriptions
Authorization: Bearer your-api-key
Content-Type: multipart/form-data

# curl உடனான எடுத்துக்காட்டு
curl -X POST http://localhost:20128/v1/audio/transcriptions \
  -H "Authorization: Bearer your-api-key" \
  -F "file=@audio.mp3" \
  -F "model=openai/whisper-1"

deepgram/nova-3 என்பது சொந்த Deepgram வழித்தடமாகும்; இதற்கு Deepgram API key தேவை. OpenRouter மட்டுமே உள்ளமைக்கப்பட்டிருந்தால், openrouter/deepgram/nova-3-ஐப் பயன்படுத்தவும்.

பேச்சிலிருந்து உரை (படியெடுத்தல்) provider-கள்:

openai/ (whisper-இணக்கமானது)
groq/ (Groq Whisper Turbo)
deepgram/ (Nova குடும்பம்)
assemblyai/
nvidia/ (Parakeet, Canary)
huggingface/ (whisper வகைகள்)
qwen/

உரையிலிருந்து பேச்சு (POST /v1/audio/speech) provider-கள்:

openai/ (tts-1, tts-1-hd)
hyperbolic/
deepgram/ (Aura)
nvidia/ (Magpie TTS)
elevenlabs/
huggingface/
inworld/
cartesia/
playht/
kie/
aws-polly/
xiaomi-mimo/
coqui/, tortoise/
qwen/

படியெடுத்தலுக்கு ஆதரிக்கப்படும் ஒலி வடிவங்கள்: mp3, wav, m4a, flac, ogg, webm. TTS வெளியீட்டு வடிவங்கள் provider-ஐப் பொறுத்தவை (mp3, wav, opus, pcm, mulaw).

Combo சமநிலைப்படுத்தல் உத்திகள்

ஒவ்வொரு combo-க்குமான சமநிலைப்படுத்தலை முகப்புப்பலகை → Combos → உருவாக்கு/திருத்து → உத்தி என்பதில் உள்ளமைக்கவும்.

உத்தி	விளக்கம்
சுழற்சி முறை	மாதிரிகளை வரிசையாகச் சுழற்சி முறையில் பயன்படுத்துகிறது
முன்னுரிமை	எப்போதும் முதல் மாதிரியை முயற்சிக்கிறது; பிழை ஏற்பட்டால் மட்டுமே மாற்று மாதிரிக்குச் செல்கிறது
சீரற்ற தேர்வு	ஒவ்வொரு கோரிக்கைக்கும் தொகுப்பிலிருந்து சீரற்ற மாதிரியைத் தேர்ந்தெடுக்கிறது
எடையிடப்பட்டது	ஒவ்வொரு மாதிரிக்கும் ஒதுக்கப்பட்ட எடைகளின் அடிப்படையில் விகிதாசாரமாக வழிமாற்றுகிறது
குறைவாகப் பயன்படுத்தப்பட்டது	அண்மையில் மிகக் குறைவான கோரிக்கைகளைப் பெற்ற மாதிரிக்கு வழிமாற்றுகிறது (தொகுப்பு அளவீடுகளைப் பயன்படுத்துகிறது)
செலவு-உகப்பாக்கப்பட்டது	கிடைக்கக்கூடியவற்றில் மிகக் குறைந்த செலவுள்ள மாதிரிக்கு வழிமாற்றுகிறது (விலை அட்டவணையைப் பயன்படுத்துகிறது)

உலகளாவிய தொகுப்பு இயல்புநிலைகளை Dashboard → Settings → Routing → Combo Defaults என்பதில் அமைக்கலாம். தொகுப்பு இலக்குகளுக்கான காலக்கெடுக்கள், இயல்பாக தற்போதைய கோரிக்கையின் காலக்கெடுவைப் பெறுகின்றன. ஒவ்வொரு இலக்கிற்குமான குறுகிய வரம்பு விரைவான மாற்று முயற்சியைத் தூண்ட வேண்டியபோது மட்டும், தொகுப்பு இயல்புநிலைகளிலோ தனிப்பட்ட தொகுப்பிலோ உள்ள Target timeout (seconds) என்பதைப் பயன்படுத்தவும்.

பூஜ்ஜியத் தாமதத் தொகுப்பு உகப்பாக்கங்கள் விருப்பத்தேர்வுக்குரியவை. இந்தத் தாமத அம்சங்கள் மாற்று இலக்குகளுடன் போட்டியிடுவதையும், TTFT வரலாற்றின் அடிப்படையில் இலக்குகளைத் தவிர்ப்பதையும், மாற்றுக் கோரிக்கைகளைச் சுருக்குவதையும் தடுக்க Zero-latency optimizations என்பதை முடக்கி வைக்கவும்; இதை இயக்குவது, நீண்ட வால் தாமதத்தைக் குறைப்பதற்காக வழிமாற்றம்/கோரிக்கை நம்பகத்தன்மையைச் சமரசம் செய்து, உள்ளமைக்கப்பட்ட ஹெட்ஜிங், முன்கணிப்பு TTFT தவிர்ப்புகள் மற்றும் முன்செயல் மாற்றுக் கோரிக்கைச் சுருக்கத்தை அனுமதிக்கும்.

அப்ஸ்ட்ரீம் வழங்குநர்கள் கடுமையான max_tokens / maxOutputTokens வரம்புகளைக் கோரும்போது Reasoning token buffer என்பதை முடக்கவும். இது இயக்கப்பட்டிருக்கும்போது, அறியப்பட்ட வெளியீட்டு உச்சவரம்பைக் கொண்ட மாதிரிகளுக்கு மட்டுமே தொகுப்பு வழிமாற்றம் பகுத்தறிவு மாதிரிக்கான கூடுதல் இடத்தைச் சேர்க்கும்; மேலும் பாதுகாப்பான இடையக மதிப்பு அந்த உச்சவரம்பை மீறுமானால், கிளையன்ட் டோக்கன் வரம்பை மாற்றாமல் வைத்திருக்கும். கிளையன்ட் வரம்பு ஏற்கெனவே அறியப்பட்ட உச்சவரம்பை விட அதிகமாக இருந்தால், அப்ஸ்ட்ரீம் கோரிக்கையை அனுப்புவதற்கு முன் OmniRoute அதை அந்த உச்சவரம்புக்குக் குறைக்கும்.

ஆரோக்கிய நிலை முகப்புப்பலகை

Dashboard → Health வழியாக அணுகவும். 6 அட்டைகளுடன் நிகழ்நேர அமைப்பு ஆரோக்கிய நிலையின் மேலோட்டப் பார்வை:

அட்டை	அது காட்டுவது
அமைப்பு நிலை	இயக்க நேரம், பதிப்பு, நினைவகப் பயன்பாடு, தரவுக் கோப்பகம்
வழங்குநர் ஆரோக்கியம்	உலகளாவிய வழங்குநர் சர்க்யூட் பிரேக்கரின் இயக்கநேர நிலை
விகித வரம்புகள்	மீதமுள்ள நேரத்துடன் ஒவ்வொரு கணக்கிற்குமான செயலில் உள்ள இணைப்பு குளிர்வுக் காலங்கள்
செயலில் உள்ள பூட்டல்கள்	செயலில் உள்ள மாதிரி-சார்ந்த பூட்டல்கள் மற்றும் தற்காலிக விலக்கல்கள்
கையொப்பத் தேக்ககம்	நகல் நீக்கத் தேக்ககப் புள்ளிவிவரங்கள் (செயலில் உள்ள விசைகள், வெற்றி விகிதம்)
தாமதத் தொலைஅளவியல்	ஒவ்வொரு வழங்குநருக்குமான p50/p95/p99 தாமதத் தொகுப்பு

நிபுணர் குறிப்பு: ஆரோக்கிய நிலைப் பக்கம் ஒவ்வொரு 10 வினாடிகளுக்கும் தானாகப் புதுப்பிக்கப்படும். எந்த வழங்குநர்கள் சிக்கல்களை எதிர்கொள்கிறார்கள் என்பதைக் கண்டறிய சர்க்யூட் பிரேக்கர் அட்டையைப் பயன்படுத்தவும்.

🤖 தானியங்கு வழித்தேர்வு (அமைப்புகள் தேவையில்லை)

இணைக்கப்பட்டுள்ள அனைத்து வழங்குநர்களிலும் ஒவ்வொரு கோரிக்கைக்கும் சிறந்த மாதிரியைத் தேர்ந்தெடுக்கும் மதிப்பெண் அடிப்படையிலான தானியங்கு வழித்தேர்வியுடன் OmniRoute வழங்கப்படுகிறது — பராமரிக்க வேண்டிய சேர்க்கைகள் எதுவுமில்லை. auto/* முன்னொட்டுகளில் ஒன்றைப் பயன்படுத்திக் கோரிக்கையை அனுப்பினால் போதும்; தாமதம், செலவு, வெற்றி விகிதம், சூழல் பொருத்தம், பணிக்கான மாதிரியின் தகுதி, சமீபத்திய தோல்விகள், ஒதுக்கீடு மற்றும் சர்க்யூட்-பிரேக்கர் நிலை ஆகியவற்றின் அடிப்படையில் தேர்வுக்குரியவற்றுக்கு மதிப்பெண் அளித்து, OmniRoute உடனடியாக ஒரு மெய்நிகர் சேர்க்கையை உருவாக்கும்.

முன்னொட்டு	மேம்படுத்தப்படுவது
`auto`	சமநிலையான இயல்புநிலை (தாமதம் × செலவு × வெற்றி விகிதம்)
`auto/coding`	நிரலாக்கப் பணிகள்: Claude, GPT-5, GLM, Kimi, Qwen Coder, DeepSeek coders ஆகியவற்றுக்கு முன்னுரிமை அளிக்கிறது
`auto/cheap`	மிகக் குறைந்த $/token; அதிக தாமதத்தை ஏற்கிறது
`auto/fast`	மிகக் குறைந்த தாமதம்; செலவைப் புறக்கணிக்கிறது
`auto/offline`	உள்ளூர் வழங்குநர்கள் மட்டும் (Ollama, vLLM, llama.cpp) — வலையமைப்பிலிருந்து தனிமைப்படுத்தப்பட்ட அமைப்புகளுக்குப் பயனுள்ளது
`auto/smart`	பகுத்தறிவுத் தரத்திற்கு முதலிடம் (Opus, GPT-5 xhigh, R1, GLM 5.1 reasoning)
`auto/lkgp`	"கடைசியாகச் சிறப்பாகச் செயல்பட்ட வழங்குநர்" — கடைசியாக வெற்றிபெற்ற வழங்குநரைப் பயன்படுத்தி, பின்னர் விதிகளுக்கு மாறுகிறது

எடுத்துக்காட்டு:

curl -X POST http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "auto/coding",
    "messages": [{ "role": "user", "content": "Refactor this Python function" }],
    "stream": true
  }'

தானியங்கு வழித்தேர்வி குறித்த முழு விவரமும் AUTO-COMBO.md ஆவணத்தில் உள்ளது — மதிப்பீட்டு எடைகளைச் சரிசெய்வது, வழங்குநர்களைத் தடுப்புப் பட்டியலில் சேர்ப்பது மற்றும் Dashboard → Auto Combo பகுதியில் வழித்தேர்வு முடிவுகளை ஆய்வு செய்வது உள்ளிட்டவை இதில் அடங்கும்.

🔌 MCP & A2A ஒருங்கிணைப்பு

OmniRoute ஓர் MCP சேவையகமாகவும் (Model Context Protocol), ஓர் A2A சேவையகமாகவும் (Agent-to-Agent JSON-RPC 2.0) செயல்படுகிறது. MCP-இணக்கமான எந்த IDE அல்லது முகவர் ஹோஸ்ட்டும் OmniRoute கருவிகளை நேரடியாக அழைக்கலாம் — கூடுதல் உறையாக்கம் எதுவும் தேவையில்லை.

MCP பரிமாற்ற முறைகள்

SSE: http://localhost:20128/api/mcp/sse
ஸ்ட்ரீம் செய்யக்கூடிய HTTP: http://localhost:20128/api/mcp/stream
stdio: omniroute --mcp (stdio-ஐ விரும்பும் IDE செருகுநிரல்களுக்கு)

Claude Desktop-ஐ இணைத்தல்

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) கோப்பை அல்லது Windows/Linux-இல் அதற்குச் சமமான கோப்பைத் திருத்தவும்:

{
  "mcpServers": {
    "omniroute": {
      "command": "omniroute",
      "args": ["--mcp"]
    }
  }
}

Cursor / Continue / VS Code MCP-ஐ இணைத்தல்

SSE URL http://localhost:20128/api/mcp/sse மற்றும் Dashboard → API Keys பகுதியில் உருவாக்கப்பட்ட Bearer API விசையைப் பயன்படுத்தவும்.

அணுகல் வரம்புகள்

MCP தற்போது பெயரிடப்பட்ட 32 அணுகல் வரம்புகளை வரையறுக்கிறது. ஒவ்வொரு Bearer விசையையும் குறிப்பிட்ட அணுகல் வரம்புகளுக்கு மட்டும் கட்டுப்படுத்தலாம் — அதிகாரப்பூர்வ அணுகல் வரம்பு மற்றும் கருவிப் பட்டியலுக்கு MCP-SERVER.md ஆவணத்தையும், JSON-RPC திட்டவடிவத்திற்கு A2A-SERVER.md ஆவணத்தையும் பார்க்கவும்.

🧠 திறன்கள் அமைப்பு

முகவர்கள் மற்றும் A2A முனைப்புள்ளி, களம் சார்ந்த செயல்முறைகளை (எ.கா. code-review, summarize, extract-facts, web-research) இயக்குவதற்காக OmniRoute விரிவாக்கக்கூடிய திறன் கட்டமைப்பை (src/lib/skills/) வழங்குகிறது.

சந்தை பயனர் இடைமுகம் — கட்டுப்பாட்டுப் பலகை → திறன்கள் என்பதிலிருந்து திறன்களை உலாவி நிறுவலாம்
ஒவ்வொரு விசைக்குமான வரம்புகள் — எந்த API விசைகள் எந்தத் திறன்களை அழைக்கலாம் என்பதைக் கட்டுப்படுத்தலாம்
தனிப்பயன் திறன்கள் — src/lib/a2a/skills/ கோப்பகத்தில் ஒரு TypeScript கோப்பைச் சேர்த்து, அதைப் பதிவுசெய்தால், அது உடனடியாக A2A வழியாக அழைக்கக்கூடியதாகிவிடும்

முழுமையான குறிப்பு: SKILLS.md.

💾 நினைவக அமைப்பு

OmniRoute, கலப்பு மீட்டெடுப்புடன் நீண்டகால உரையாடல் நினைவகத்தை நிலையாகச் சேமிக்கிறது:

கடந்தகால உரையாடல் சுற்றுகள் முழுவதிலும் திறவுச்சொல் தேடலுக்காக SQLite FTS5
பொருள்சார் நினைவுகூரலுக்காக Qdrant vector store (விருப்பத்தேர்வு)
தானியங்கிய உண்மைத் தகவல் பிரித்தெடுப்பு — ஒவ்வொரு அமர்வுக்குப் பிறகும் பொருள்கள், விருப்பத்தேர்வுகள் மற்றும் முடிவுகள் சுருக்கப்பட்டு memory_facts அட்டவணையில் சேமிக்கப்படுகின்றன
நினைவகங்கள் ஒவ்வொரு API விசை மற்றும் ஒவ்வொரு அமர்வின் அடிப்படையில் வரம்பிடப்படுகின்றன

கட்டுப்பாட்டுப் பலகை → நினைவகம் என்பதில் நினைவகங்களை நிர்வகிக்கலாம் (தேடுதல், திருத்துதல், ஏற்றுமதி செய்தல், முற்றிலும் நீக்குதல்). HTTP இடைமுகம் (/api/memory/*), முகவர்கள் உண்மைத் தகவல்களை நிரல்முறையாக அனுப்பவும் வினவவும் அனுமதிக்கிறது — MEMORY.md-ஐப் பார்க்கவும்.

🔔 Webhooks

நிகழ்நேரக் கண்காணிப்பு மற்றும் தானியக்கமாக்கலுக்காக OmniRoute நிகழ்வுகளுக்குச் சந்தா சேருங்கள்.

இலக்கு URL மற்றும் HMAC கையொப்பமிடும் ரகசியத்துடன் கட்டுப்பாட்டுப் பலகை → Webhooks என்பதில் ஒரு webhook-ஐ உருவாக்கவும்
கிடைக்கக்கூடிய நிகழ்வுகள்: request.completed, request.failed, provider.unavailable, budget.exceeded, combo.switched, circuit_breaker.opened, circuit_breaker.closed
சரிபார்ப்பிற்காக ஒவ்வொரு தரவுச்சுமையிலும் X-OmniRoute-Signature (HMAC-SHA256) இடம்பெறும்
மறுமுயற்சிகள்: அதிவேகமாக அதிகரிக்கும் தாமதத்துடன் 3 முயற்சிகள், பின்னர் செயலிழந்த செய்திகளுக்கான வரிசை

முழுமையான அமைப்புமுறை WEBHOOKS.md-இல் உள்ளது.

☁️ மேக முகவர்கள்

உங்கள் உள்ளக வழிப்படுத்தலைக் கையாளும் அதே கட்டுப்பாட்டுப் பலகையிலிருந்து நீண்ட நேரம் இயங்கும் பணிகளை அனுப்புவதற்காக, OmniRoute மேகக் குறியீட்டு முகவர்களுடன் (OpenAI Codex Cloud, Devin, Jules, Antigravity) ஒருங்கிணைகிறது.

கட்டுப்பாட்டுப் பலகை → மேக முகவர்கள் என்பதிலோ அல்லது POST /api/v1/agents/tasks வழியாகவோ பணிகளை உருவாக்கவும்
ஒவ்வொரு பணிக்குமான நிலை, பதிவுகள் மற்றும் உருவாக்கப்பட்ட வெளியீடுகளைக் கண்காணிக்கவும்
ஒவ்வொரு வழங்குநருக்கும் உங்கள் சொந்த API விசையைப் பயன்படுத்தலாம் — சான்றுகள் OmniRoute நிகழ்விலிருந்து ஒருபோதும் வெளியேறாது

முழுமையான குறிப்பு: CLOUD_AGENT.md.

🛠️ நிரல்முறை மேலாண்மை

manage வரம்பைக் கொண்ட Bearer விசையைப் பயன்படுத்தி, ஒவ்வொரு OmniRoute வளத்தையும் (வழங்குநர்கள், சேர்க்கைகள், விசைகள், அமைப்புகள்) HTTP வழியாக நிர்வகிக்கலாம்.

கட்டுப்பாட்டுப் பலகை → API விசைகள் → புதிய விசை → வரம்பு: manage என்பதில் விசையை உருவாக்கிய பின்:

# வழங்குநர்களைப் பட்டியலிடவும்
curl http://localhost:20128/api/providers \
  -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY"

# வழங்குநர் இணைப்பைச் சேர்க்கவும்
curl -X POST http://localhost:20128/api/providers \
  -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "provider": "openai", "apiKey": "sk-...", "name": "main" }'

# சேர்க்கையை உருவாக்கவும்
curl -X POST http://localhost:20128/api/combos \
  -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "premium", "strategy": "priority", "models": [{ "model": "cc/claude-opus-4-7" }, { "model": "glm/glm-5.1" }] }'

# API விசைகளைப் பட்டியலிடவும்/உருவாக்கவும்
curl http://localhost:20128/api/keys -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY"
curl -X POST http://localhost:20128/api/keys -H "Authorization: Bearer $OMNIROUTE_MANAGE_KEY" \
  -d '{ "name": "ci-bot", "scopes": ["chat"] }'

முழுமையான முனைப்புள்ளிப் பட்டியல் மற்றும் கோரிக்கை/பதில் அமைப்புமுறைகளுக்கு API_REFERENCE.md-ஐப் பார்க்கவும்.

💻 உள் CLI

அமைப்பு, நோயறிதல் மற்றும் இயக்கநேரக் கட்டுப்பாட்டிற்காக OmniRoute ஓர் உள் CLI-ஐ (omniroute …) வழங்குகிறது. இது மூன்றாம் தரப்பு CLI-கள் (Claude Code, Cursor, Codex, Cline, …) OmniRoute உடன் தொடர்புகொள்ளும் வகையில் அவற்றை உள்ளமைக்கும் டாஷ்போர்டில் உள்ள "CLI கருவிகள்" பக்கத்திலிருந்து தனிப்பட்டது.

omniroute setup                    # ஊடாடும் வழிகாட்டி (கடவுச்சொல், வழங்குநர்கள், சேர்க்கைகள்)
omniroute setup --non-interactive  # CI-க்கு ஏற்றது
omniroute doctor                   # செயல்நிலை நோயறிதல்கள் (தரவுக் கோப்பகம், DB, வழங்குநர்கள், போர்ட்கள்)
omniroute providers available      # ஆதரிக்கப்படும் வழங்குநர்களைப் பட்டியலிடு
omniroute providers list           # உள்ளமைக்கப்பட்ட இணைப்புகளைப் பட்டியலிடு
omniroute providers test <id>      # வழங்குநர் இணைப்பை நேரலையாகச் சோதி
omniroute combos list              # சேர்க்கைகளைப் பட்டியலிடு
omniroute combos switch <name>     # இயல்புநிலைச் சேர்க்கையை அமை
omniroute models                   # கிடைக்கக்கூடிய மாதிரிகளைப் பட்டியலிடு (--json, --search)
omniroute keys add | list | remove # முனையத்திலிருந்து API விசைகளை நிர்வகி
omniroute backup                   # உள்ளமைவு + DB-இன் நிலைப்படத்தை உருவாக்கு
omniroute restore [<timestamp>]    # நிலைப்படத்திலிருந்து மீட்டமை
omniroute health                   # விரிவான செயல்நிலை (தடுப்பான்கள், தற்காலிக சேமிப்பு, நினைவகம்)
omniroute quota                    # வழங்குநரின் ஒதுக்கீட்டுப் பயன்பாடு
omniroute mcp status               # MCP சேவையக நிலை
omniroute a2a status               # A2A சேவையக நிலை
omniroute tunnel list|create|stop  # Cloudflare/Tailscale/ngrok சுரங்கங்கள்
omniroute reset-password           # நிர்வாகி கடவுச்சொல்லை மீட்டமை
omniroute --mcp                    # stdio வழியாக MCP சேவையகத்தைத் தொடங்கு
omniroute --port 3000              # தனிப்பயன் போர்ட்டில் சேவையகத்தைத் தொடங்கு

உதவிக்குறிப்பு: செயல்நிலையற்ற வழங்குநர் இணைப்புகள் குறித்து எச்சரிக்கை பெற, உங்கள் கண்காணிப்புக் கருவியுடன் omniroute doctor --json-ஐ இணைத்துப் பயன்படுத்தவும்.

🖥️ டெஸ்க்டாப் பயன்பாடு (Electron)

Windows, macOS மற்றும் Linux-க்கான சொந்த டெஸ்க்டாப் பயன்பாடாக OmniRoute கிடைக்கிறது.

நிறுவல்

# electron கோப்பகத்திலிருந்து:
cd electron
npm install

# உருவாக்கப் பயன்முறை (இயங்கிக்கொண்டிருக்கும் Next.js உருவாக்க சேவையகத்துடன் இணைகிறது):
npm run dev

# உற்பத்திப் பயன்முறை (தனித்தியங்கும் கட்டமைப்பைப் பயன்படுத்துகிறது):
npm start

நிறுவிகளை உருவாக்குதல்

cd electron
npm run build          # தற்போதைய இயங்குதளம்
npm run build:win      # Windows (.exe NSIS)
npm run build:mac      # macOS (.dmg universal)
npm run build:linux    # Linux (.AppImage)

வெளியீடு → electron/dist-electron/

முக்கிய அம்சங்கள்

அம்சம்	விளக்கம்
சேவையகத் தயார்நிலை	சாளரத்தைக் காட்டுவதற்கு முன் சேவையகத்தைத் தொடர்ந்து சோதிக்கிறது (வெற்றுத் திரை இல்லை)
கணினித் தட்டு	தட்டிற்குச் சுருக்குதல், போர்ட்டை மாற்றுதல், தட்டு மெனுவிலிருந்து வெளியேறுதல்
போர்ட் மேலாண்மை	தட்டிலிருந்து சேவையக போர்ட்டை மாற்றுதல் (சேவையகத்தைத் தானாக மறுதொடக்கம் செய்கிறது)
உள்ளடக்கப் பாதுகாப்புக் கொள்கை	அமர்வு தலைப்புகள் வழியாகக் கட்டுப்பாடான CSP
ஒற்றை நிகழ்வு	ஒரே நேரத்தில் பயன்பாட்டின் ஒரு நிகழ்வு மட்டுமே இயங்க முடியும்
இணையமில்லாப் பயன்முறை	தொகுக்கப்பட்ட Next.js சேவையகம் இணையமின்றி இயங்குகிறது

சூழல் மாறிகள்

மாறி	இயல்புநிலை	விளக்கம்
`OMNIROUTE_PORT`	`20128`	சேவையக போர்ட்
`OMNIROUTE_MEMORY_MB`	`512`	Node.js ஹீப் வரம்பு (64–16384 MB)

📖 முழு ஆவணம்: electron/README.md

132 KiB Raw Blame History Unescape Escape

User Guide (தமிழ்)

உள்ளடக்க அட்டவணை

💰 விலை விவரச் சுருக்கம்

🎯 பயன்பாட்டு நிகழ்வுகள்

நிகழ்வு 1: "என்னிடம் Claude Pro சந்தா உள்ளது"

நிகழ்வு 2: "செலவே இல்லாமல் வேண்டும்"

நிகழ்வு 3: "இடையூறுகள் இல்லாமல் 24/7 நிரலெழுத வேண்டும்"

நிகழ்வு 4: "OpenClaw-இல் இலவச AI வேண்டும்"

📖 வழங்குநர் அமைப்பு

🔐 சந்தா வழங்குநர்கள்

Claude Code (Pro/Max)

OpenAI Codex (Plus/Pro)

GitHub Copilot

💰 மலிவான வழங்குநர்கள்

GLM-4.7 (தினசரி மீட்டமைப்பு, $0.6/1M)

MiniMax M2.1 (5 மணிநேர மீட்டமைப்பு, $0.20/1M)

Kimi K2 (மாதத்திற்கு நிலையான $9)

Baidu Qianfan / ERNIE

🆓 இலவச வழங்குநர்கள்

Qoder (9 இலவச மாடல்கள்)

Kiro (Claude இலவசம்)

🎨 சேர்க்கைகள்

எடுத்துக்காட்டு 1: சந்தாவை அதிகபட்சமாகப் பயன்படுத்துதல் → மலிவான காப்பு

எடுத்துக்காட்டு 2: இலவசம் மட்டும் (செலவு இல்லை)

🔧 CLI ஒருங்கிணைப்பு

Cursor IDE

Claude Code

Codex CLI

OpenClaw

Cline / Continue / RooCode

🚀 நிறுவல்

உலகளாவிய npm நிறுவல் (பரிந்துரைக்கப்படுகிறது)

தட்டு முறை

நிறுவல் நீக்கம்

VPS நிறுவல்

PM2 நிறுவல் (குறைந்த நினைவகம்)

Docker

Void Linux (xbps-src)

சூழல் மாறிகள்

📊 கிடைக்கக்கூடிய மாதிரிகள்

🧩 மேம்பட்ட அம்சங்கள்

தனிப்பயன் மாடல்கள்

OmniRoute சக நுழைவாயில்களைச் சங்கிலியாக இணைத்தல்

பிரத்யேக வழங்குநர் வழித்தடங்கள்

நெட்வொர்க் ப்ராக்ஸி உள்ளமைவு

மாடல் பட்டியல் API

கிளவுட் ஒத்திசைவு

Cloudflare விரைவு சுரங்கப்பாதை

LLM நுழைவாயில் நுண்ணறிவு (கட்டம் 9)

மொழிபெயர்ப்பாளர் பயிற்சிக்களம்

வழித்தட உத்திகள்

வெளிப்புற Sticky Session தலைப்பு

Wildcard மாதிரி மாற்றுப்பெயர்கள்

மாற்று வழிச் சங்கிலிகள்

மீள்திறன் & Circuit Breaker-கள்

தரவுத்தள ஏற்றுமதி / இறக்குமதி

அமைப்புகள் முகப்புப்பலகை

செலவுகள் மற்றும் வரவுசெலவுத் திட்ட மேலாண்மை

ஒலிப் படியெடுத்தல்

Combo சமநிலைப்படுத்தல் உத்திகள்

ஆரோக்கிய நிலை முகப்புப்பலகை

🤖 தானியங்கு வழித்தேர்வு (அமைப்புகள் தேவையில்லை)

🔌 MCP & A2A ஒருங்கிணைப்பு

MCP பரிமாற்ற முறைகள்

Claude Desktop-ஐ இணைத்தல்

Cursor / Continue / VS Code MCP-ஐ இணைத்தல்

அணுகல் வரம்புகள்

🧠 திறன்கள் அமைப்பு

💾 நினைவக அமைப்பு

🔔 Webhooks

☁️ மேக முகவர்கள்

🛠️ நிரல்முறை மேலாண்மை

💻 உள் CLI

🖥️ டெஸ்க்டாப் பயன்பாடு (Electron)

நிறுவல்

நிறுவிகளை உருவாக்குதல்

முக்கிய அம்சங்கள்

சூழல் மாறிகள்

132 KiB

Raw Blame History