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

# 🚀 OmniRoute — ነጻው የኤአይይ መግቢያ በር OmniRoute — ኮድ መስራት አታቁም:: እያንዳንዱ የኤአይይ መሳሪያ → 358 አቅራቢዎች — 150+ ነጻ — በአንድ የመጨረሻ ነጥብ በኩል:: Claude Code, Codex, Cursor, Cline, Copilot & Antigravity ወደ ነጻ Claude / GPT / Gemini በራስ-ሰር ምትኬ:: RTK + Caveman የተደራረበ መጭመቂያ 15–95% ቶከኖችን ይቆጥባል (~89% በአማካይ) — ገደቦችን በጭራሽ አይመታም:: 358 የኤአይይ አቅራቢዎች · 150+ ነጻ ደረጃዎች · ~1.62B ነጻ ቶከኖች/በወር · 19 የማዞሪያ ስልቶች · ለመጀመር $0::

OmniRoute — ኮድ መስራት አታቁም:: እያንዳንዱ የኤአይይ መሳሪያ → 358 አቅራቢዎች — 150+ ነጻ — በአንድ የመጨረሻ ነጥብ በኩል:: Claude Code, Codex, Cursor, Cline, Copilot & Antigravity ወደ ነጻ Claude / GPT / Gemini በራስ-ሰር ምትኬ:: RTK + Caveman የተደራረበ መጭመቂያ 15–95% ቶከኖችን ይቆጥባል (~89% በአማካይ) — ገደቦችን በጭራሽ አይመታም:: 358 የኤአይይ አቅራቢዎች · 150+ ነጻ ደረጃዎች · ~1.62B ነጻ ቶከኖች/በወር · 19 የማዞሪያ ስልቶች · ለመጀመር $0::

## 💰 በወር ~1.62B ነፃ ቶከኖች

> ነፃ የአገልግሎት ደረጃዎችን በእጅ ማዋሃድ አስቸጋሪ ነው — በደርዘን የሚቆጠሩ SDKዎች፣ በደርዘን የሚቆጠሩ የፍጥነት ገደቦች፣ እና በእርግጥ ምን ያህል እንዳለዎት የማወቂያ መንገድ የለም። OmniRoute **በ35 ተደጋጋሚ የፑል ቁልፎች ውስጥ 489 የነፃ ደረጃ ግቤቶችን** በካታሎግ ያደራጃል፤ እንዲሁም የቶከን ዋና ቁጥሩን **ይፋ የተደረገ አዎንታዊ ወርሃዊ በጀት ካላቸው 17 ፑሎች እና ለእያንዳንዱ ሞዴል ከተወሰኑ አምስት የGroq ገደቦች** ያሰላል፤ የጋራ ፑሎችንም አንድ ጊዜ ብቻ ይቆጥራል። ከክልላዊ ማንነት ማረጋገጫ በኋላ ብቻ የሚከፈቱ ኮታዎች (በአሁኑ ጊዜ፦ ModelScope) ለብቻቸው ይታያሉ፤ ከክልላዊ ማንነት ማረጋገጫ በስተጀርባ +~6M ይገኛሉ፣ እና በዋናው ቁጥር ውስጥ ፈጽሞ አይደመሩም። ውጤቱ በዳሽቦርዱ (`/dashboard/free-tiers`) ላይ ሁልጊዜ ይታያል።

> የቀጥታው `/dashboard/free-tiers` ገጽ በእንቅስቃሴ የቀረበ ማጠቃለያ። ሙሉ ዘዴው (የፑል ድግግሞሽን ማስወገድ፣ የክሬዲት ደረጃዎች፣ የአቅራቢዎች ውሎች)፦ **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**። > > _{እነዚህ ቁጥሮች በየሁለት ሳምንቱ ከቀጥታው ካታሎግ ጋር እንደገና ኦዲት ይደረግባቸዋል፣ እና **ወደ ሁለቱም አቅጣጫ ይለዋወጣሉ** — አንድ አቅራቢ ነፃ ደረጃውን ሲያቋርጥ ቁጥሩ ይቀንሳል፤ አዲስ አቅራቢ ሲጨመር ደግሞ ይጨምራል። እኛ ካታሎጉ በእርግጥ ያሰላውን እናትማለን፤ ወደ ላይ የተጠጋጋ ምርጥ ሁኔታን ፈጽሞ አናቀርብም።}

⭐ OMNIROUTE ገንዘብ እንዲቆጥቡ እና ሥራዎን እንዲያቀሉ ከረዳዎት ማከማቻውን በኮከብ ይደግፉ።

[![ኮከቦች](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![የኮከብ ታሪክ ደረጃ](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 ማህበረሰቡን ይቀላቀሉ **👋 ጠብቃውን ይከተሉ — አዳዲስ አቅራቢዎችን፣ ልቀቶችን እና ጠቃሚ ምክሮችን ቀድመው ያግኙ፦** [![Diegoን በLinkedIn ይከተሉ](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![@diegosouzapwን በGitHub ይከተሉ](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp ዓለም አቀፍ](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp ብራዚል](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![ድረ-ገጽ](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **ጥያቄዎች፣ የአቅራቢ ጠቃሚ ምክሮች፣ የዕቅድ መንገድ እና ድጋፍ → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 ዓለም አቀፍ](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 ብራዚል](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [ፖርታል](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 ጌትዌዩ ማደጉን ቀጥሏል

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | ------------------- | :-----: | :----------------: | :---------: | | 🌐 አቅራቢዎች | 290 | **357** | ተጨማሪ ወረፋ ላይ | | 🧠 ልዩ የውይይት ሞዴል IDs | 1185 | **1312** | — | | 🖼️ የሞዳሊቲ ድልድይ | — | 🆕 ምስል + ድምፅ + ቪዲዮ | — | | 📡 ነፃ የRadar ካታሎግ | — | 🆕 በምርጫ የሚነቃ | — | | ⚖️ ኮታን ያገናዘበ መርሐግብር | — | 🆕 Quota-Share | — | | 📊 የኮታ ቴሌሜትሪ | — | 🆕 ቀጥታ | — | **→ [የእድገት ዕቅድ](ROADMAP.md) — ወደ `v3.9.0 LTS` በመጓዝ ላይ**

## 🧩 የሚገኝ [![npm ስሪት](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![ወርሃዊ NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![ፈቃድ፦ MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker ማውረዶች](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron ማውረዶች](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 ይጀምሩ	🚀 ፈጣን ጅምር	📦 ይጫኑ	🆓 ያለ ውቅር
💡 ይማሩ	💥 ቃል ኪዳኑ	🤔 OmniRoute ለምን	🏆 ልዩ የሚያደርገው
⚙️ ባህሪያት	🎯 ጥምረቶች	🌐 አቅራቢዎች	🔌 CLI እና MCP
	🗜️ ማመቅ	🖥️ የሚሰራበት ቦታ	🔒 የግል
👀 ይመልከቱት	🎬 በተግባር	✨ አዲስ ነገር	🤖 ተኳዃኝ CLIዎች
💚 ድጋፍ	💚 ይደግፉ / ይለግሱ	💬 ማህበረሰብ	💖 ስፖንሰሮች
📦 ፕሮጀክት	🛠️ የቴክኖሎጂ ስብስብ	📖 ሰነዶች	👥 አስተዋጽዖ አድራጊዎች

🌐 በ66 ቋንቋዎች

## 🆓 እንደጫኑት ወዲያውኑ ይሰራል — ምንም ቁልፎች የሉም፣ ምንም ቅንብር የለም

እንደጫኑት ወዲያውኑ ይሰራል — ምንም ቅንብር የለም። ሶስት ደረጃዎች: 1. ይጫኑ — npm i -g omniroute፣ ሰርቨሩ በ localhost:20128 ላይ ይጀምራል። 2. መሳሪያዎን ወደ http://localhost:20128/v1 ያመልክቱ — ማንኛውም ከ OpenAI ጋር ተኳሃኝ የሆነ መሳሪያ (Claude Code, Cursor, Cline)። 3. ይመልሳል — ፈጣን ምላሽ ለማግኘት auto ሞዴሉን ይጠቀሙ፣ ያለ API ቁልፍ፣ ያለ ምዝገባ፣ ያለ ቅንብር። ቁልፍ የሌለው አቅራቢ OpenCode Free በ auto ጥምር ውስጥ አስቀድሞ የተገጠመ ነው፣ ስለዚህ አዲስ ጭነት ወዲያውኑ ምላሽ ይሰጣል።

```bash # አዲስ ጭነት፣ ዜሮ ምስክርነቶች — auto አስቀድሞ ይሰራል። curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{የተለየ ነፃ የኋላ-መጨረሻ ይመርጣሉ? `oc/…` (OpenCode Free)ን በቀጥታ ይደውሉ። ከዚያ ወደ `auto` ያሻሽሉ እና OmniRoute እንዲመርጥ ያድርጉ።} _{📦 ለ**Python, Node.js, PHP, እና cURL** ፈጣን ማስጀመሪያ ስክሪፕቶችን ይቅዱ-ይለጥፉ → [`examples/quickstart/`] (examples/quickstart/)}

# 💥 ቃል ኪዳኑ

# 🤔 ለምን OmniRoute?

የOmniRoute ጥያቄ ፍሰት: የእርስዎ IDE ወይም CLI (Claude Code, Cursor, Cline…) አንድ የአካባቢ የመጨረሻ ነጥብ (http://localhost:20128/v1) ይጠራል፤ የOmniRoute ስማርት ራውተር (RTK + Caveman መጭመቂያ፣ 19 የማዞሪያ ስልቶች፣ ሰርክዩት ብሬከሮች፣ TLS ስቴልዝ፣ MCP፣ A2A፣ ጋርድሬሎች) ብቁ ጤናማ ኢላማ እስካለ ድረስ በ4 የአቅራቢ ደረጃዎች ላይ ምትኬ ሊጠቀም ይችላል — ደረጃ 1 የደንበኝነት ምዝገባ፣ ደረጃ 2 API ቁልፍ፣ ደረጃ 3 ርካሽ እና ደረጃ 4 ነፃ።

## 🤝 በክፍት ምንጭ ወዳጆቻችን የተደገፈ

> **እንደ ክፍት ምንጭ ወዳጅ መቀላቀል ይፈልጋሉ?** እነዚህ ክፍት ምንጭን የሚደግፉና OmniRoute እንዲቀጥል የሚያግዙ ኩባንያዎች ናቸው — እኛም የሚሰጡን እያንዳንዱ token የት እንደሚውል በይፋ እንገልጻለን። ያግኙን፦ [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} ይህን ፕሮጀክት ስለደገፈ Kimi (Moonshot AI)፣ መስራች የክፍት ምንጭ ወዳጃችንን እናመሰግናለን! Kimi ክፍት-ክብደት ያላቸውን K2 እና K3 የሞዴል ቤተሰቦች የፈጠረው የAI ላብራቶሪ ነው — Kimi K3 የ1M-token አውድ መስኮት፣ ቤተኛ የምስል ችሎታ እና የድንበር-ደረጃ ኮድ ማድረግን ከዝግ-ሞዴሎች ዋጋ በጣም ባነሰ ያቀርባል፤ እንዲሁም ከClaude Code፣ Codex እና OmniRoute ከሚያገለግላቸው ሁሉም የኮድ መሳሪያዎች ጋር ያለምንም ተጨማሪ ውቅር ይሰራል።

የKimi ድጋፍ የሚያንቀሳቅሰው፦ የKimi API ክሬዲቶች የOmniRouteን በAI የተረጋገጠ የልቀት ሂደት — እያንዳንዱን pull request ከመለቀቁ በፊት የሚገመግመውን በKimi K3 የሚንቀሳቀስ የውህደት ማረጋገጫ ደረጃ — እንዲሁም የዕለት ተዕለት የባህሪ ልማትን ያንቀሳቅሳሉ። ከፍተኛ ደረጃ ያለው የKimi ድጋፍ በሁለቱም መንገዶች ይቀርባል፦ ቀጥተኛው Kimi API (kimi-k3) እና የKimi Code ኮድ ማድረጊያ ዕቅድ (OAuth እና API key)። OmniRoute በKimi የድጋፍ ፕሮግራም ውስጥ የመጀመሪያው የብራዚል ክፍት-ምንጭ ፕሮጀክትም ነው። 15% ተጨማሪ ክሬዲት ያለው Kimi API key ያግኙ →

Cheaper Inference
_{cheaperinference.com} ይህን ፕሮጀክት ስለደገፈ Cheaper Inference፣ የOmniRoute ክፍት ምንጭ ወዳጅን እናመሰግናለን! Cheaper Inference 42 የድንበር ሞዴሎችን — Claude፣ GPT-5.x፣ Gemini፣ Kimi K3፣ GLM፣ DeepSeek፣ Grok እና MiniMax — በአንድ ከOpenAI ጋር ተኳሃኝ የሆነ endpoint በኩል እንደገና የሚሸጥ በወጪ የተደረደረ gateway ነው፤ እያንዳንዱን ጥያቄ ከሞዴሉ አምራች የዝርዝር ዋጋ በላይ ሳያስከፍል ወደ በጣም ርካሹ ብቁ አቅራቢ ያዞራል።

በOmniRoute ውስጥ የከፍተኛ ደረጃ ድጋፍ፦ Chat Completions፣ ቤተኛው /v1/responses endpoint፣ ምስል፣ የመሳሪያ ጥሪ እና 3 የምስል ሞዴሎች (grok-imagine፣ nano-banana-pro፣ nano-banana-2፣ እንደ cheaperinference/<model> ሊደረስባቸው የሚችል)። API key ያግኙ →

_{aff=omniroute የሚል መለያ ያላቸው አገናኞች የአጋር አገናኞች ናቸው። ለእርስዎ ምንም ተጨማሪ ወጪ ሳያስከትሉ ፕሮጀክቱን ይደግፋሉ።}

_{🎟️ የአጋሮች ማስተዋወቂያ — እኛ ከማንደግፋቸው አቅራቢዎች ነፃ የምዝገባ ኩፖኖች (ለማስፋት ጠቅ ያድርጉ)}

_{ይህ ክፍል ለሪፈራል/ኩፖን ኮዶች ብቻ ነው። ስፖንሰር የተደረጉ አጋርነቶች ከላይ ባለው 🤝 በክፍት ምንጭ ወዳጆቻችን የተደገፈ ክፍል ውስጥ ይገኛሉ። OmniRoute እዚህ ከተዘረዘሩት አቅራቢዎች ጋር ምንም የስፖንሰርነት ወይም የአጋርነት ግንኙነት የለውም — እነዚህ ማንኛውም ሰው ሊጠቀምባቸው የሚችሉ ይፋዊ ኩፖኖች ናቸው።}

_AgentRouter
_{agentrouter.org} _{AgentRouter — የአጋር ምዝገባ · ሲመዘገቡ $100 ነፃ ክሬዲት (ነፃ server፣ ከፍተኛ latency ሊኖር ይችላል — ለሙከራ የተሻለ እንጂ ለproduction አይደለም)። ከv3.8.50 ጀምሮ በOmniRoute ውስጥ የከፍተኛ ደረጃ ድጋፍ፦ Chat Completions፣ ከAnthropic ጋር ተኳሃኝ የሆነው wire format እና ከOpenAI ጋር ተኳሃኝ የሆነው path። የሚገኙ ሞዴሎች claude-opus-4-8፣ claude-opus-5፣ gpt-5.6-sol እና ሌሎችንም ያካትታሉ። $100ዎን ያግኙ →}

_{⚠️ የአጋር አገናኝ — OmniRoute ከዚህ አቅራቢ ጋር ምንም የስፖንሰርነት ወይም የአጋርነት ግንኙነት የለውም።}

_{ለOmniRoute ተጠቃሚዎች የሚጠቅም ለጋስ ነፃ የምዝገባ ኩፖን ያለው ሌላ አቅራቢ ያውቃሉ? issue ይክፈቱ፣ እኛም እዚህ እንጨምረዋለን።}

## 🎯 ኮምቦዎች — ዋናው ባህሪ

ሁሉም 19 የኮምቦ ማዘዋወሪያ ስልቶች በእነማ ቀርበዋል — ለእያንዳንዱ ስልት አንድ ሰድር፦ priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline። እያንዳንዱ ምን እንደሚያደርግ ከላይ ያለውን ሰንጠረዥ ይመልከቱ።

> **ኮምቦ** OmniRoute **በራስ-ሰር** የሚያዘዋውርባቸው የሞዴሎች ሰንሰለት ነው። ኮታው ካለቀ፣ አቅራቢው ካልሰራ ወይም ወጪዎች በድንገት ከጨመሩ፣ ኮምቦው ወደሚቀጥለው ብቁና ጤናማ ሞዴል መሄድ ይችላል። 🛡️ ### ⚡ ዜሮ-ውቅር — `auto`ን ብቻ ይጠቀሙ መፍጠር ያለብዎት ኮምቦ የለም። ሞዴልዎን ወደ `auto` (ወይም አንዱ ተለዋጩ) ያዘጋጁ፤ OmniRoute ከተገናኙት አቅራቢዎችዎ በቀጥታ ነጥብ እየሰጠ ምናባዊ ኮምቦ ይገነባል፦

የሞዴል ID	የሚያመቻቸው ነገር
`auto`	🎯 ሚዛናዊ ነባሪ (LKGP — በመጨረሻ ጥሩ ከነበረው አቅራቢዎ ጋር ይቆያል)
`auto/coding`	🧑💻 ለኮድ ማመንጨት ጥራትን ቅድሚያ የሚሰጡ ክብደቶች
`auto/fast`	⚡ በመጀመሪያ ዝቅተኛው መዘግየት
`auto/cheap`	💰 በመጀመሪያ በቶከን ዝቅተኛው ዋጋ
`auto/offline`	🔋 በመጀመሪያ ከፍተኛው የኮታ / የፍጥነት-ገደብ ትርፍ አቅም
`auto/smart`	🔭 ጥራትን ቅድሚያ መስጠት + የተሻሉ ሞዴሎችን ለማግኘት 10% ሙከራ
`auto/lkgp`	📌 ከመጨረሻው ጥሩ አቅራቢ ጋር በግልጽ መቆየት
`auto/chaos`	🧪 የመቋቋም ችሎታን ለመፈተሽ የስህተት-መወጋት ክብደቶች (የchaos ምህንድስና)

## ### 🔀 ወይም የራስዎን ይገንቡ — 19 የማዘዋወሪያ ስልቶች ሁሉም **19** ስልቶች — በእያንዳንዱ የኮምቦ ደረጃ እንደፈለጉ ያዋህዱ፦

#	ስልት	የሚያደርገው ነገር
1	`priority`	የመጀመሪያውን ዒላማ የሚያስቀድም ቅደም ተከተላዊ ዝርዝር — ወደሚቀጥለው ከመሄድ በፊት እያንዳንዱን ሙሉ በሙሉ ይጠቀማል 🥇
2	`fill-first`	ወደሚቀጥለው ከመሄድ በፊት የእያንዳንዱን ዒላማ ኮታ ሙሉ በሙሉ ይሙሉ
3	`weighted`	በእያንዳንዱ ዒላማ ክብደት መሠረት ክብደት ያለው የዘፈቀደ ምርጫ
4	`round-robin`	በዒላማዎች መካከል በቅደም ተከተል ይዘዋወራል
5	`p2c`	የሁለት-ምርጫዎች-ኃይል የዘፈቀደ ጭነት ማመጣጠን
6	`least-used`	ዝቅተኛው የአሁኑ ጭነት ያለበትን ዒላማ ይምረጡ
7	`random`	ወጥ የዘፈቀደ ምርጫ (የተደጋገሙ የተወገዱበት)
8	`strict-random`	የተደጋገሙትን ሳያስወግድ የዘፈቀደ ምርጫ 🎲
9	`cost-optimized`	ከቀጥታ ካታሎግ ዋጋ መረጃ በመጠቀም በጥያቄ የሚከፈለውን $ ይቀንሳል 💸
10	`headroom`	ከፍተኛው ቀሪ ኮታ ያለውን ዒላማ ይምረጡ
11	`reset-window`	የኮታ መስኮቱ ቀድሞ የሚጀመርበትን ዒላማ ይመርጣል
12	`reset-aware`	በኮታ ዳግም መጀመሪያ ጊዜ ደረጃ ይሰጣል — አጭር መስኮቶችን ያስቀድማል 📊
13	`context-relay`	ለረጅም ውይይቶች ዐውዱን በዒላማዎች መካከል ያስተላልፋል 🧠
14	`context-optimized`	ለአሁኑ የዐውድ መጠን በተሻለ ሁኔታ የሚስማማውን ይምረጡ
15	`cache-optimized`	እያንዳንዱን እንደገና ጥቅም ላይ የሚውል የጥያቄ ቅድመ ክፍል በተመሳሳዩ መለያ ላይ ያቆያል — የጥያቄ-መሸጎጫ ግኝቶችን ከፍ ያደርጋል 🎯
16	`lkgp`	በመጨረሻ ጥሩ እንደሆነ የታወቀ መንገድ — በመጨረሻ ስኬታማ በነበረው አቅራቢ ላይ ያቆያል፣ ከዚያም ወደ ደንቦች ይመለሳል
17	`auto`	በእያንዳንዱ ግንኙነት ላይ የ16 ምክንያቶች ቀጥታ ውጤት አሰጣጥ 🤖
18	`fusion`	ጥያቄውን ለሞዴሎች ፓነል ያሰራጫል + አንድ ዳኛ አንድ መልስ ያዋህዳል 🧬
19	`pipeline`	ደረጃዎችን ያገናኛል — የእያንዳንዱ ዒላማ ውጤት ለሚቀጥለው ግብዓት ይሆናል 🔗

_{የAuto-Combo ሞተሩ ለእያንዳንዱ እጩ በ**16 ምክንያቶች** (ጤና፣ ኮታ፣ ወጪ፣ መዘግየት፣ ለተግባሩ ተስማሚነት፣ ጥራት፣ የክፍለ ጊዜ ተገኝነት…) ነጥብ ይሰጣል — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)ን ይመልከቱ።} ## ### 🧱 የመቋቋም ችሎታ አብሮ የተገነባ ነው (3 ገለልተኛ ንብርብሮች)

የOmniRoute የመቋቋም አቅም — 3 እርስ በርሳቸው ገለልተኛ ራስ-ፈዋሽ ንብርብሮች፣ ለእያንዳንዱ ብልሽት ትክክለኛው ንብርብር። ንብርብር 1 የአቅራቢ ሰርኪት ብሬከር (ሙሉው አቅራቢ)፦ የሚቋረጠው በ408/5xx ላይ ብቻ ነው፤ ገደቦቹ OAuth 8× / API-key 12× / local 2× ሲሆኑ፣ ከ60s/30s/15s በኋላ ወደ HALF-OPEN ሙከራ ይመለሳል፣ መልሶ ማገገሙም በፍላጎት ጊዜ ብቻ ይከናወናል፤ OPEN እያለ ኮምቦው ወደ ቀጣዩ አቅራቢ መንገዱን ያዞራል። ንብርብር 2 የግንኙነት ማቀዝቀዣ ጊዜ (አንድ ቁልፍ/መለያ)፦ መነሻው OAuth 5s / API-key 3s ነው፤ ከመንጋ መትመም መከላከያ ጋር በ×2 ኤክስፖነንሻል መዘግየት፣ 429 የRetry-After መመሪያን ያከብራል፣ ስኬት ሁሉንም የስህተት ሁኔታዎች ያጸዳል፤ አንድ እየቀዘቀዘ ያለ ቁልፍ ይታለፋል፣ ከእሱ ጋር ያሉ ሌሎች ቁልፎች ግን አገልግሎት መስጠታቸውን ይቀጥላሉ። ንብርብር 3 የሞዴል መቆለፊያ (አንድ ሞዴል)፦ በእያንዳንዱ ሞዴል የሚከሰት 429፣ local 404 ወይም የሁነታ ክልከላዎች ያንን ሞዴል ብቻ ይቆልፋሉ — መላውን ግንኙነት በፍጹም አይቆልፉም። የመጨረሻ ሁኔታዎች (የታገደ፣ ጊዜው ያለፈ፣ ክሬዲቱ ያለቀ) የኦፕሬተሩ ጉዳይ ናቸው፣ የማቀዝቀዣ ጊዜዎች አይደሉም።

_{📖 [ራስ-ሰር ኮምቦ ሞተር](docs/routing/AUTO-COMBO.md) · [የመቋቋም አቅም መመሪያ](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 ኦምኒሩት ልዩ የሚያደርገው ምንድን ነው

_{📊 ሙሉ ዘዴ እና የባህሪ ዝርዝር ከ9router፣ OpenRouter፣ CLIProxyAPI እና LiteLLM ጋር ሲነፃፀር → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 OmniRouteን ይደግፉ OmniRoute በMIT ፈቃድ የተለቀቀ ሲሆን በግልጽነት ይጠበቃል። ጊዜዎን ወይም ገንዘብዎን የሚቆጥብልዎት ከሆነ፣ ነጻነቱን ለማስጠበቅ ከእርስዎ ጋር የሚስማማውን መንገድ ይምረጡ። ስፖንሰርነት በማዘዋወሪያ ቅድሚያ ላይ ፈጽሞ ተጽዕኖ አያሳድርም፤ የሚገዛው ታይነትን እንጂ ደረጃን አይደለም።

⭐ ማከማቻውን በኮከብ ይመዝግቡ	ነጻ — ታይነቱን በእውነት ይረዳል	OmniRouteን በኮከብ ይመዝግቡ
🐙 GitHub Sponsors	የአንድ ጊዜ ወይም ወርሃዊ · ምንም የመድረክ ክፍያ የለም	github.com/sponsors/diegosouzapw
☕ Ko-fi	ፈጣን የአንድ ጊዜ ስጦታ፣ ለለጋሹ ምዝገባ አያስፈልግም	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	አነስተኛ፣ መደበኛ ያልሆነ ድጋፍ	buymeacoffee.com/diegosouzapw
🖐 Liberapay	ተደጋጋሚ · ለትርፍ ያልተቋቋመ · ክፍት ምንጭ	liberapay.com/diegosouzapw
🇧🇷 PIX (ብራዚል)	ፈጣን፣ ያለ ክፍያ	ቁልፉና QR ከታች ይገኛሉ
₿ ክሪፕቶ	BTC · ETH · USDT-TRC20 · USDC-Solana	አድራሻዎቹ ከታች ይገኛሉ

**🇧🇷 PIX** — ፈጣን፣ ያለ ክፍያ (ብራዚል) የOmniRoute PIX QR ኮድ

ቁልፍ (የዘፈቀደ): `5d865059-bc44-483a-962d-43ceb80126eb` የPix ቅዳና-ለጥፍ፦ ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ ክሪፕቶ — BTC · ETH · USDT-TRC20 · USDC-Solana (ለማስፋት ጠቅ ያድርጉ)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ እያንዳንዱን ሳንቲም በተጠቀሰው ኔትወርክ ላይ ብቻ ይላኩ — በተሳሳተ ኔትወርክ መላክ ገንዘቡን ሊያሳጣ ይችላል።}

🐛 ስህተት አግኝተዋል ወይም አስተያየት አለዎት? [ውይይት](https://github.com/diegosouzapw/OmniRoute/discussions) ይክፈቱ።

የገንቢ ማስታወሻዎች፦ ፕሮጀክቱ ለገንቢዎች ምቾት ሲባል npm install/postinstall በሚካሄድበት ጊዜ አካባቢያዊ .env ፋይል ሊፈጥር ይችላል። ይህ ፋይል ሆን ተብሎ በ.gitignore ችላ ይባላል (.gitignoreን ይመልከቱ) እና ፈጽሞ ወደ ማከማቻው መጨመር የለበትም — በስህተት ከተጨመረ፣ ይፋ የሆኑ ማንኛውንም ምስጢሮች ይቀይሩ እና ፋይሉን ከታሪኩ ያስወግዱ። አካባቢያዊ የአካባቢ ፋይሎችንና ምስጢሮችን ስለማስተዳደር መመሪያ ለማግኘት docs/DEVELOPER-ENVIRONMENT.mdን ይመልከቱ።

## 📡 OmniRoute Radar ከላይ በሰነድ ከተገለጸው፣ የጋራ ስብስብ ድግግሞሽ ከተወገደለት ካታሎግ የሚገኘው ዋናው የነፃ ደረጃ መጠን **~1.62B ቶከኖች/በወር** ሆኖ ይቆያል። ጊዜያዊ የአቅራቢዎች ምዝገባ ክሬዲቶች የመጀመሪያውን ወር መጠን በተናጠል ወደ **~2.22B** ሊያሳድጉት ይችላሉ። Radar በOmniRoute ልቀቶች መካከል ይበልጥ ወቅታዊ የሆነ የነፃ ሞዴሎች ተደራሽነት ለሚፈልጉ ሰዎች፣ እንደ አማራጭ የሚቀርብ እና በዲጂታል ፊርማ የተረጋገጠ የካታሎግ ተደራቢ ነው፤ የማህበረሰቡ ካታሎግ እና ሁሉም ነባር ነፃ ባህሪያት ነፃ ሆነው ይቀጥላሉ። ደጋፊዎች ቀጥታ የሚዘምነውን ካታሎግ እና ተጨማሪ የአቅራቢዎች ዕድሎችን ሊያገኙ ይችላሉ። የተለየውና ሊለወጥ የሚችለው ከፍተኛ ገደቡ፣ እንደ አቅራቢዎች ተደራሽነት፣ **ቢበዛ በግምት 3B ቶከኖች/በወር** ነው። ይህ ከፍተኛ ገደብ ዋስትና አይደለም፦ አቅራቢዎች ኮታዎችን፣ ብቁነትን፣ ሞዴሎችን ወይም ክልሎችን በማንኛውም ጊዜ ሊለውጡ ይችላሉ። Radar በምርጫ የሚነቃ ሲሆን GET ጥያቄዎችን ብቻ ይጠቀማል። የOmniRoute ደንበኛ ፕሮግራም ፕሮምፕቶችን፣ ትራፊክን፣ የአቅራቢ ውቅርን፣ የአጠቃቀም ቴሌሜትሪን ወይም በአካባቢው የተቀመጠውን የማስታወቂያ ውድቅ ማድረጊያ ሁኔታ አይሰቅልም። ስለ ብቁነት እና ስለ ወቅታዊው ካታሎግ በ**[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** ይወቁ።

## ✨ ምን አዲስ ነገር አለ

> ከ**v3.8.20 → v3.8.50** የቅርብ ጊዜ ዋና ዋና ለውጦች። ሙሉው ታሪክ በ[`CHANGELOG.md`](CHANGELOG.md) ውስጥ ይገኛል። - **🎛️ OmniConductor** — ወደ ወኪሎችዎ ስብስብ የሚገባ A2A ውክልና፣ በAgent Card ላይ ያሉ Conductor ክህሎቶች፣ እና Faro ለመናገር-ተጭነው የሚጠቀሙበት የድምፅ ውይይት ያለው ዳሽቦርድ ፓነል። → [A2A አገልጋይ](docs/frameworks/A2A-SERVER.md) - **🛂 ተለዋዋጭ የመግቢያ ቁጥጥር እና የጫና መከላከያ** — ከባድ የውይይት ጥያቄዎች 503 ከመመለስ ይልቅ ወረፋ ይይዛሉ፣ ለእያንዳንዱ ግንኙነት አቶሚክ RPM ተንከባላይ የኪራይ ጊዜዎችን በመጠቀም። → [የጽናት መመሪያ](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ መደበኛ የ`/v1/models` ቅደም ተከተል** — ለእያንዳንዱ አቅራቢ አንድ ተከታታይ፣ በአቅራቢ የተመደበ ብሎክ (ኮምቦዎች መጀመሪያ ላይ የተሰኩ)፣ በሁሉም የካታሎግ ምንጮች ላይ የተረጋጋ። → [የAPI ማጣቀሻ](docs/reference/API_REFERENCE.md) - **🗜️ የመጭመቂያ ማጠናከሪያ** — በነባሪነት የነቃ የመፍታት መከላከያ፣ Caveman ጥቅሎች ለDE / FR / JA + ቻይንኛ (wényán)፣ RTK ማጣሪያዎች ለGradle እና .NET። → [መጭመቂያ](docs/compression/COMPRESSION_ENGINES.md) - **💸 ትክክለኛ ቋሚ-ተመን ወጪ** — የደንበኝነት / የኮዲንግ-ዕቅድ አቅራቢዎች በወጪ ትንታኔዎች ውስጥ **$0** ያሳያሉ፤ በጀት፣ ኮታ እና ማዘዋወር ግምት መስጠታቸውን ይቀጥላሉ። → [የAPI ማጣቀሻ](docs/reference/API_REFERENCE.md) - **⚖️ የQuota-Share ማዘዋወር** — የጋራ መለያ ኮታን በተሰባሰቡ ቁልፎች መካከል በፍትሐዊነት ይከፋፍላል፤ ሥራ ፈት የሆኑ ድርሻዎችን ለሌሎች በማዋስ አቅም እንዳይባክን ያደርጋል። → [የጽናት መመሪያ](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 በአንድ ትዕዛዝ የCLI/ወኪል ማዋቀር** — 13 የተመዘገቡ `setup-*` ትዕዛዞች፤ `omniroute run` 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ያስጀምራል፤ `omniroute configure` 10 ዒላማዎችን ከበይነተገናኝ አቅራቢ+ሞዴል መራጭ እና ለእያንዳንዱ አውድ ተወዳጆች ጋር ይደግፋል። → [የCLI ውህደቶች](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ የርቀት ሁነታ** — የተወሰነ ወሰን ባላቸው ቶከኖች (`connect` / `contexts` / `tokens`) እና ለVPS ጭነቶች በሚያገለግል `antigravity` OAuth አጋዥ፣ የርቀት OmniRouteን ያስተዳድሩ። → [የርቀት ሁነታ](docs/guides/REMOTE-MODE.md) - **🧭 ይበልጥ ብልህ ራስ-ሰር ማዘዋወር** — `auto/:` ኮምቦዎች፣ **Fusion** (የሞዴል ፓነል + ዳኛ)፣ ሥራን የሚገነዘብ ማዘዋወር፣ ለእያንዳንዱ ጥያቄ የሞዴል / ሁነታ / የUSD-በጀት ማሻሻያዎች። → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ ተሰኪ መጭመቂያ** — 12 በጥምረት ጥቅም ላይ ሊውሉ የሚችሉ ሞተሮች + Compression Studios፦ LLMLingua-2፣ ባለሁለት-ደረጃ Ultra፣ omniglyph፣ ለእያንዳንዱ እርምጃ የትክክለኛነት በር፣ GCF v3.2፣ በመጎተት እንደገና ማደራጃ አርታዒ። → [መጭመቂያ](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ ግልጽ የMITM ዲክሪፕሽን (TPROXY)** — የፕሮክሲ env varsን ችላ የሚሉ CLIsን፣ ለእያንዳንዱ SNI የተለየ CA እና የtrust-store ጫኚ በመጠቀም ይያዙ። → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 በሁሉም ቦታ የወጪ ቴሌሜትሪ** — በእያንዳንዱ የመጨረሻ ነጥብ ላይ `X-OmniRoute-*` የወጪ/አጠቃቀም ራስጌዎች፣ የcache-HIT ቁጠባ ራስጌ፣ እና ለእያንዳንዱ ቁልፍ የUSD ወጪ ኮታዎች። → [የAPI ማጣቀሻ](docs/reference/API_REFERENCE.md) - **🧠 እርስዎ የሚቆጣጠሩት ማህደረ ትውስታ** — በነባሪነት የጠፋ፣ በምርጫ የሚነቃ int8 የቬክተር ኳንታይዜሽን + ዓይነት ያለው መዳከም፣ ለእያንዳንዱ ጥያቄ `x-omniroute-no-memory`። → [ማህደረ ትውስታ](docs/frameworks/MEMORY.md) - **🛡️ ደህንነት** — በእያንዳንዱ LLM መስመር ላይ የprompt-injection መከላከያ (የred-team ሙከራ ስብስብ)፣ በምርጫ የሚነቃ የማረጋገጫ መረጃ መሸፈኛ መከላከያ (የወጡ API ቁልፎችን/ሚስጥሮችን በሁለቱም አቅጣጫ ያደበዝዛል)፣ ነፃ የመጨረሻ-አማራጭ DuckDuckGo የድር ፍለጋ፣ እና ለዳሽቦርዱ አማራጭ OIDC የመግቢያ በር (በይለፍ ቃል መግባት ሁልጊዜ እንደተገኘ ይቆያል)። → [መከላከያዎች](docs/security/GUARDRAILS.md) - **🖼️ አዲስ የመጨረሻ ነጥቦች** — `/v1/ocr` (Mistral OCR) እና `/v1/audio/translations` (Whisper-አይነት) የሚዲያ በይነገጹን ያሟላሉ። → [የAPI ማጣቀሻ](docs/reference/API_REFERENCE.md) - **🎨 ምስል / ቪዲዮ / ድምፅ ማመንጨት** — ለሚዲያ አንድ API፦ xAI Grok Imagine እና Novita AI ቪዲዮ፣ ComfyUI፣ Magnific፣ Adobe Firefly፣ Segmind፣ እንዲሁም እንደ ElevenLabs ያሉ የንግግር አቅራቢዎች። → [የAPI ማጣቀሻ](docs/reference/API_REFERENCE.md) - **🌍 ማሰማራት እና ክንውን** — የreverse-proxy `basePath`፣ የአሳሽ ቋንቋ ራስ-ሰር ማወቅ፣ ለእያንዳንዱ ቁልፍ የመሣሪያ ክትትል፣ root የማያስፈልገው የMITM እምነት፣ zh-TW አካባቢያዊነት። → [አካባቢ](docs/reference/ENVIRONMENT.md) - **🤝 ተጨማሪ አቅራቢዎች እና ወኪሎች** — የደመና ወኪሎች (Codex Cloud, Cursor, Devin, Jules)፣ Grok Build (xAI) ከአሳሽ + OAuth መግቢያ ጋር፣ የOllama ዋና ድጋፍ ያለው ካርድ፣ Claude Opus 5 እና Sonnet 5፣ ከKimi ጋር ይፋዊ አጋርነት (Code/Web/Moonshot)፣ Zed፣ Requesty፣ SenseNova፣ Yuanbao፣ Agnes AI… እና የታደሰ **352-አቅራቢ ካታሎግ**። → [አቅራቢዎች](docs/reference/PROVIDER_REFERENCE.md) - **📡 የማዘዋወር ግልጽነት** — እያንዳንዱ ምላሽ እሱን ያቀረበውን ስትራቴጂ/አቅራቢ/መዘግየት የሚጠቅስ `X-OmniRoute-Decision` ራስጌ ይይዛል፤ አዲሱ `cache-optimized` የኮምቦ ስትራቴጂ + የAuto-Combo `cacheAffinity` ምክንያት ተደጋጋሚ ጥያቄዎችን የተሸጎጠውን ቅድመ ቅጥያ ወደያዘው ግንኙነት ይመልሳሉ፣ እንዲሁም ለንባብ-ብቻ የሆነ `/v1/auto-combo/{channel}/candidates` የመጨረሻ ነጥብ የ`auto/*` ሰርጥን ቀጥታ የእጩዎች ስብስብ ያሳያል። → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ አካባቢያዊ አፈጻጸም እና መሠረተ ልማት** — በአንድ ጠቅታ አካባቢያዊ Redis፣ Cloudflare Workers / Deno Deploy ሪሌይ አሰማሪዎች፣ Bifrost እና Mux እንደ ክትትል ያላቸው የተካተቱ አገልግሎቶች። → [የተካተቱ አገልግሎቶች](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 በጥቅሉ ውስጥ የተካተቱ ሌሎች ነገሮች** — የተሰኪ ማዕቀፍ + የገበያ ቦታ፣ Omni/Agent/GitHub የክህሎት ማዕቀፎች፣ የObsidian vault ውህደት (22 MCP መሣሪያዎች)፣ ከOpenAI ጋር ተኳሃኝ የBatch እና Files APIs፣ የትርጉም ምላሽ መሸጎጫ፣ ከደረጃ ሰንጠረዦች ጋር ጌማዊነት፣ ACP የወኪል ማግኛ (15 አብሮገነብ ወኪሎች)፣ ወደ BigQuery የታቀደ የምዝግብ ማስወጣት፣ `auto/chaos` የብልሽት ማስገባት፣ የTelegram ቦት ድልድይ፣ በመተግበሪያ ውስጥ ያለ የስሪት አስተዳዳሪ እና LMArena-ELO የነፃ-አቅራቢ ደረጃዎች። → [ሰነዶች](docs/README.md)

## 🤖 ተኳኋኝ CLIs እና የኮዲንግ ወኪሎች > አንድ ውቅር — `http://localhost:20128/v1` — እና **ሁሉም** AI IDE ወይም CLI በነጻ እና ዝቅተኛ ወጪ ባላቸው ሞዴሎች ላይ ይሰራል።

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ ከእነዚህም ጋር ይሰራል · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · ማንኛውም ከOpenAI ጋር ተኳኋኝ የሆነ መሣሪያ

_{📖 ለሁሉም 36 መሣሪያዎች (26 CLI Code መሣሪያዎች + 10 CLI Agents) የየመሣሪያው ማዋቀሪያ → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode ተሰኪ → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**ማንኛውንም የሚደገፍ CLI በአንድ ትዕዛዝ በOmniRoute በኩል ያስጀምሩ** — ምንም የውቅረት ፋይሎች አይጻፉም፣ የመግቢያ ማረጋገጫዎች ለእያንዳንዱ ሂደት ይገባሉ፣ እንዲሁም Qwen/Gemini ጊዜያዊና የተነጠለ home ያገኛሉ፦ ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # ወይም provider+modelን በይነተገናኝ ሁኔታ ይምረጡና የመሣሪያውን የራሱን ውቅር ይጻፉ፦ omniroute configure codex # እነዚህም፦ claude opencode qwen aider goose gemini cline continue kilo ``` እያንዳንዱ ትዕዛዝ ንቁውን የርቀት አውድ (`omniroute connect `) ያከብራል፤ `--dry-run` ሳያስፈጽም ትክክለኛዎቹን env/args አስቀድሞ ያሳያል፣ እና `--api-key-env NAME` ሚስጥሮችን ከshell ታሪክዎ ውጭ ያቆያል። → [የCLI ውህደቶች](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 357 የAI አቅራቢዎች — 152 በካታሎግ እንደ ነፃ የተመለከቱ

> በመደበኛዎቹ የውይይት፣ ሚዲያ፣ ፍለጋ፣ አካባቢያዊ፣ የደመና-ወኪል እና የስርዓት ስብስቦች ውስጥ **357 የተመዘገቡ አቅራቢዎች** ሲኖሩ፣ ከእነዚህም **152ቱ `hasFree: true` የማግኛ ሜታዳታ አላቸው**። የውይይት ሞዴል መዝገቡ **229 አቅራቢዎችን / 2,554 የተለያዩ የአቅራቢ-ሞዴል ጥንዶችን / 1,283 ጥሬ የሞዴል መለያዎችን** ይሸፍናል፤ የተለየው የነፃ በጀት ካታሎግ ደግሞ **491 በሞዴል የተደራጁ ረድፎች**፣ **35 ተደጋጋሚ የአቅም ጥምረቶች** እና **54 ተደጋጋሚ/ቁልፍ-አልባ ለዘላለም ነፃ አቅራቢዎች** አሉት። እነዚህ በንድፍ የተለያዩ መነሻ ድምሮች ናቸው፤ ትርጓሜዎች እና ተመሳሳይ የአቅም ጥምረቶችን ያስወገዱ ስሌቶች በ[የአቅራቢዎች ማጣቀሻ](docs/reference/PROVIDER_REFERENCE.md) እና [ነፃ ደረጃዎች](docs/reference/FREE_TIERS.md) ውስጥ ይገኛሉ።

### 🏢 ሁሉም ዋና ላቦራቶሪዎች — በአንድ የመዳረሻ ነጥብ

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

_{…እና 330+ ተጨማሪ — እያንዳንዱ አዶ ከዳሽቦርዱ የአቅራቢዎች ካታሎግ በቀጥታ ይጫናል። 📖 [የአቅራቢዎች ማጣቀሻ](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 ለዘላለም ነፃ — $0፣ ካርድ አያስፈልግም

OpenCode Zen _{DeepSeek V4, Nemotron 3 የቶከን ገደብ የለም}	Kilo Code _{ራስ-ሰር ራውተር፣ Tencent Hy3 ለዘላለም ነፃ}	Requesty _{GPT-OSS 120B, Nemotron ለዘላለም ነፃ}	SiliconFlow _{DeepSeek V3.2 / R1 ነፃ ደረጃ}	Z.AI GLM _{GLM-4.7 / 4.5-Flash ለዘላለም ነፃ}	Baidu ERNIE _{ERNIE 4.0 ለዘላለም ነፃ}
Qoder AI _{Qwen3-Max, Kimi-K2 ያልተገደበ ነፃ አገልግሎት}	Pollinations _{GPT, Llama, Claude ቁልፍ አያስፈልግም}	Cloudflare AI _{50+ ሞዴሎች 10K ኒውሮኖች/በቀን}	NVIDIA NIM _{GLM, MiniMax ~40 RPM በነፃ}	Cerebras _{GLM 4.7, GPT-OSS 1M ቶከኖች/ቀን}	OpenRouter _{:free ሞዴሎች +$10 → ከፍተኛ RPM}

📖 ሙሉ በማሽን የሚነበብ ካታሎግ → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ OmniRoute የሚሰራበት — በማንኛውም ቦታ

> ተመሳሳይ መተግበሪያ፣ የእርስዎ ማሽን፣ የእርስዎ ደንቦች። ከዓለም አቀፍ npm ጭነት እስከ **ስልክዎ** ድረስ በTermux በኩል።

መድረክ	ጭነት	ዋና ባህሪያት
📦 npm (ዓለም አቀፍ)	`npm install -g omniroute`	አንድ ትዕዛዝ፣ ማንኛውም OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	ባለብዙ አርክቴክቸር AMD64 + ARM64
🖥️ ዴስክቶፕ (Electron)	`npm run electron:build`	ቤተኛ መስኮት + የስርዓት ትሪ — Windows / macOS / Linux
🎩 ምናሌ አሞሌ (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	አገልጋዩን ይቆጣጠራል & በራስ-ሰር ያዘምናል — macOS
💪 ARM	ቤተኛ `arm64`	Raspberry Pi፣ ARM አገልጋዮች፣ Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	በስልክዎ ላይ 24/7 ይሰራል፣ root አያስፈልግም
📲 PWA	"ወደ መነሻ ማያ ገጽ አክል"	ሙሉ ማያ ገጽ፣ ከመስመር ውጭ፣ ከአሳሽ መጫን የሚቻል
🧩 OpenCode ተሰኪ	`@omniroute/opencode-provider`	ቤተኛ OpenCode ውህደት
🤖 VS Code Copilot Chat	የOmniCopilot ቅጥያን ይጫኑ	ሁሉም የOmniRoute ሞዴሎች በቤተኛው Copilot Chat መራጭ ውስጥ — stable & Insiders
🛠️ ከምንጭ ኮድ	`npm install && npm run dev`	ያሻሽሉት፣ አስተዋጽኦ ያድርጉ

_{📖 [የDocker መመሪያ](docs/guides/DOCKER_GUIDE.md) · [ዴስክቶፕ](electron/README.md) · [የምናሌ አሞሌ ትሪ](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 አዲስ፦ OmniRoute በVS Code ቤተኛ Copilot Chat ውስጥ

> አዲስ የጎን አሞሌ የለም፣ አዲስ የውይይት UI የለም — OmniRoute የሚያቀርበው እያንዳንዱ ሞዴል በቀጥታ > **አስቀድመው በሚጠቀሙበት Copilot Chat ሞዴል መራጭ** ውስጥ ይታያል። ከVS Code 1.122 ጀምሮ የአቅራቢ ሞዴሎች > የGitHub መግቢያ ወይም የCopilot ደንበኝነት ምዝገባ ሳያስፈልጋቸው ይሰራሉ — የወኪል ሁነታ፣ የመሣሪያ ጥሪ እና የእይታ ችሎታ > በነጻ። የ**[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** ቅጥያን ይጫኑ፣ ወደ OmniRoute አገልጋይዎ (ነባሪው `localhost:20128` ነው) ያመልክቱት፣ ከዚያ Copilot Chat → የሞዴል መራጭ → **ሞዴሎችን ያስተዳድሩ…** → **OmniRoute** ይክፈቱ።

መደብር	አገናኝ	አብሮ የሚሰራው
🧩 VS Code Marketplace	ይጫኑ →	VS Code — stable & Insiders
🔓 Open VSX Registry	ይጫኑ →	Cursor፣ Windsurf፣ VSCodium፣ Theia፣ code-server፣ Gitpod፣ Antigravity፣ Kiro…

ከአርታዒው ውስጥ፦ የ**ቅጥያዎች** እይታን ይክፈቱ፣ **"OmniRoute"**ን ይፈልጉ፣ **ጫን**ን ጠቅ ያድርጉ — በሁለቱም መደብሮች ላይ በተመሳሳይ መንገድ ይሰራል። ምንጭ ኮዱ፣ ችግሮች እና የሕትመት የአሠራር መመሪያው በ[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) ይገኛሉ። _{📖 [የVS Code Copilot Chat መመሪያ](docs/guides/VSCODE-COPILOT.md) — ማዋቀር፣ መራጩ የሚያሳየው፣ ዳሽቦርድ በትር ውስጥ፣ ችግር መፍታት}

### 🎩 አዲስ፦ OmniRouteTray — በምናሌ አሞሌው ውስጥ የሚኖረው መግቢያዎ

> `omniroute serve` ሁልጊዜ ሲበራ በተሻለ ሁኔታ ይሰራል። **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > ይህንን ለmacOS አንዴ አዘጋጅተው የሚረሱት የምናሌ አሞሌ መተግበሪያ ያደርገዋል፦ አገልጋዩን ያስጀምራል፣ ከዳግም ማስነሳት በኋላም > እንዲሰራ ያደርገዋል፣ በቦታው ላይ ያዘምነዋል፣ እና ቀጥታ የtoken በጀትዎን በአንድ ጠቅታ ብቻ እንዲያገኙ ያደርጋል — **ክፍት የተርሚናል > መስኮት አያስፈልግም፣ `npm install -g omniroute`ን መከታተልም አያስፈልግም።** በ[Tauri v2](https://v2.tauri.app/) (መጠኑ እጅግ አነስተኛ የሆነ Rust ኮር) የተገነባ ሲሆን፣ የራሱን የተፈረመ Node 24 runtime ይዞ ይመጣል እና በመተግበሪያው ባለቤትነት የሚተዳደር የOmniRoute ጭነትን ያስተዳድራል፤ ስለዚህ ከዓለም አቀፍ `node`/`bun`ዎ ጋር ፈጽሞ አይጋጭም። **ያለዎትን `~/.omniroute/` ውቅር እና የውሂብ ጎታ ይጋራል** — ስለዚህ አስቀድመው የሚያስኬዱት ያው OmniRoute ነው፣ ባርኔጣ አድርጎ ብቻ። 🎩

የሚያደርገው	እንዴት
🟢 አገልጋዩን ይቆጣጠራል	`omniroute serve`ን ያስጀምራል፣ ቅጂ ከመፍጠር ይልቅ አስቀድሞ እየሰራ ያለን instance ይጠቀማል
📊 ቀጥታ አጠቃቀምን በጨረፍታ	የአቅራቢ ኮታ አሞሌዎች፣ የClaude ክፍለ ጊዜ/ሳምንታዊ ገደቦች ከዳግም ማስጀመሪያ ቆጠራዎች ጋር፣ የ30 ቀናት ወጪ ዝርዝር
🔄 በቦታው ላይ በራስ-ሰር ይዘምናል	ደረጃ በደረጃ ጭነት፣ አቶሚክ ቅያሬ፣ ሲከሽፍ ወደ ነበረበት መመለስ — ሁልጊዜ በአዲሱ ልቀት ላይ
🚀 ሲገቡ ይጀምራል	ሲገቡ በአማራጭ ማስጀመር፤ በትሪ ውስጥ ብቻ፣ የdock አዶ የለም
🩺 ምርመራ & ምዝግቦች	በአንድ ጠቅታ ምርመራዎች እና የአገልጋይ ምዝግቦች መዳረሻ

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{ማውረድን ይመርጣሉ? የቅርብ ጊዜውን .dmg ከ
ልቀቶች ያግኙ። የምንጭ ኮድ፣ ችግሮች እና የግንባታ
ሰነዶች በzoispag/omniroute-tray ይገኛሉ።

💛 በ@zoispag የተዘጋጀ የማህበረሰብ ፕሮጀክት — ይፋዊ የOmniRoute ልቀት አይደለም።}

## 🔒 የግል እና አካባቢያዊ-ቅድሚያ

_{📖 [ፈቃድ መስጠት](docs/architecture/AUTHZ_GUIDE.md) · [የጥበቃ ገደቦች](docs/security/GUARDRAILS.md) · [ተገዢነት](docs/security/COMPLIANCE.md)}

## 🔌 ሙሉ CLI + A2A እና MCP

> ከሰርቨሩ ባሻገር፣ OmniRoute **80+ ትዕዛዞች** ያሉት **የተሟላ የትዕዛዝ-መስመር መቆጣጠሪያ ማዕከል** ሲሆን፣ AI ወኪል **በራሱ** እንዲያንቀሳቅሰው የሚያስችሉ ክፍት የወኪል ፕሮቶኮሎችንም ያካትታል። ### ⌨️ እውነተኛ CLI (`start` ብቻ አይደለም) ```bash omniroute # ጌትዌይ + ዳሽቦርድን ያስተናግዱ (port 20128) omniroute chat # በይነተገናኝ TUI የውይይት ደንበኛ (slash: /model /combo /skill /memory) omniroute setup # የመጀመሪያ አጠቃቀም መመሪያ አዋቂ omniroute doctor # አቅራቢዎችን፣ portsን እና native depsን ይመርምሩ ``` ### 🛰️ የርቀት ሁነታ — CLIን እዚህ፣ OmniRouteን በVPS ላይ ያስኪዱ OmniRoute በሰርቨር ላይ ነው? በ**ተመሳሳዩ CLI** ከላፕቶፕዎ ሆነው ያንቀሳቅሱት። የተወሰነ ወሰን ባለው የመዳረሻ ቶከን አንድ ጊዜ ይግቡ፤ ከዚያ በኋላ እያንዳንዱ ትዕዛዝ ወደ ርቀት ሰርቨሩ ይመራል። ```bash omniroute connect 192.168.0.15 # የይለፍ ቃል → ወሰን ያለው ቶከን፣ እንደ ዐውድ ይቀመጣል omniroute models list # ← በርቀት ሰርቨሩ ላይ ይሰራል omniroute configure codex # ← የርቀት ሞዴል ይመርጣል፣ አካባቢያዊ የCodex መገለጫ ይጽፋል omniroute tokens create --name ci --scope read # ለሌሎች ማሽኖች ይበልጥ ጠባብ ቶከኖችን ይፍጠሩ omniroute contexts use default # ← ወደ አካባቢያዊ ሰርቨሩ ይመለሱ ``` ቶከኖች `read` / `write` / `admin` የሚል ወሰን አላቸው፤ ፕሮሰሶችን የሚጀምሩ መስመሮች በloopback ብቻ ይቆያሉ። _{📖 [የርቀት ሁነታ](docs/guides/REMOTE-MODE.md)}

የOmniRoute CLIን የሚያሳይ እነማዊ የተርሚናል ማሳያ — omniroute providers list፣ omniroute combo list እና omniroute health — በ86ቱ የከፍተኛ ደረጃ ትዕዛዞች ላይ በየተራ የሚያልፍ፦ providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 ወኪል ያገናኙ — እና OmniRouteን ራሱ ይቆጣጠራል OmniRouteን በ**MCP**፣ **A2A**፣ **REST API**፣ **webhooks** ወይም **የርቀት CLI** በኩል ተደራሽ ያድርጉት — ማንኛውም ብቃት ያለው ወኪል (ወይም የእርስዎ ኮድ) የጠቅላላውን ጌትዌይ ቁልፎች ያገኛል፦ ራውቲንግ፣ አቅራቢዎች፣ combos፣ cache፣ compression፣ memory — በራስ-ሰር። ከታች ያሉት የHTTP መዳረሻ ነጥቦች በ`http://localhost:20128` ስር ይስተናገዳሉ።

በይነገጽ	የመዳረሻ ነጥብ / ትዕዛዝ	የአጠቃቀም ዓላማ
🧰 MCP (stdio)	`omniroute --mcp`	ከClaude Desktop፣ Cursor ወይም ከማንኛውም MCP ደንበኛ ጋር ያገናኙ
🌊 MCP (HTTP)	`/api/mcp/stream`	የርቀት MCP — 110 መሣሪያዎች፣ 33 ወሰኖች (ማስፈጸሙ በምርጫ የሚነቃ)፣ ሙሉ የኦዲት መዝገብ
📡 MCP (SSE)	`/api/mcp/sse`	የዥረት MCP ማጓጓዣ
🤝 A2A	`/.well-known/agent.json`	ከወኪል-ወደ-ወኪል፣ JSON-RPC 2.0 + SSE፣ 6 ክህሎቶች
🌐 REST API	`/v1/*`	ከOpenAI ጋር ተኳሃኝ — ውይይት፣ embeddings፣ ምስሎች፣ ድምፅ፣ OCR
🔔 Webhooks	`/api/webhooks`	የጥያቄ / ኮታ ክስተቶችን ወደ Slack፣ Discord፣ Telegram ወይም ማንኛውም URL ይግፉ
🛰️ የርቀት CLI	`omniroute connect`	ወሰን ባላቸው የመዳረሻ ቶከኖች የርቀት ኢንስታንስን ያንቀሳቅሱ

```bash # ሙሉውን የOmniRoute መሣሪያ ስብስብ በMCP በኩል ለ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% ቶከኖችን ይቆጥቡ — በራስ-ሰር

### 📖 እንዴት እንደሚሠራ — የሂደት መስመር፣ አርክቴክቸር እና የቁጠባ ስሌት የOmniRoute ማመቂያ ሂደት መስመር፦ 10,000-ቶከን ያለው ምሳሌያዊ የደንበኛ ጥያቄ በ12 ሊጣመሩ በሚችሉ ሞተሮች — Session-Dedup፣ CCR፣ Lite፣ RTK፣ Responses Tool Output፣ Headroom፣ Relevance፣ Caveman፣ Aggressive፣ LLMLingua-2፣ Ultra እና OmniGlyph — ያልፍና በሰነዱ በተገለጸው የተደራረበ ምሳሌ ወደ አቅራቢው 1,080 ቶከን ገደማ ሆኖ ሊደርስ ይችላል። የተዋቀረ ይዘት በጥበቃ መከላከያዎች እና በእያንዳንዱ ደረጃ የታማኝነት መቆጣጠሪያዎች ይጠበቃል፤ በግልጽ የተመረጡ መረጃ የሚያሳጡ ወይም የሙከራ ሁነታዎች ብቁ ይዘትን ሊቀይሩ ይችላሉ።

የOmniRoute ማመቂያ ሂደት መስመር፦ 10,000-ቶከን ያለው ምሳሌያዊ የደንበኛ ጥያቄ በ12 ሊጣመሩ በሚችሉ ሞተሮች — Session-Dedup፣ CCR፣ Lite፣ RTK፣ Responses Tool Output፣ Headroom፣ Relevance፣ Caveman፣ Aggressive፣ LLMLingua-2፣ Ultra እና OmniGlyph — ያልፍና በሰነዱ በተገለጸው የተደራረበ ምሳሌ ወደ አቅራቢው 1,080 ቶከን ገደማ ሆኖ ሊደርስ ይችላል። የተዋቀረ ይዘት በጥበቃ መከላከያዎች እና በእያንዳንዱ ደረጃ የታማኝነት መቆጣጠሪያዎች ይጠበቃል፤ በግልጽ የተመረጡ መረጃ የሚያሳጡ ወይም የሙከራ ሁነታዎች ብቁ ይዘትን ሊቀይሩ ይችላሉ።

ነባሪው የተደራረበ ጥምረት `RTK → Caveman`ን ያስኬዳል። ሁለቱም በተመሳሳይ የመሣሪያ/ዐውድ ጭነት ላይ ሲሠሩ፣ ቁጠባው ተደራርቦ ይጨምራል፦ ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` የኮድ ብሎኮች፣ URLs፣ JSON እና የተዋቀረ ውሂብ በጥበቃ ሞተሩ **ሁልጊዜ ይጠበቃሉ**። > **ጥቂት ቶከኖች ሥራውን ሲሠሩ ብዙ ቶከኖችን ለምን ይጠቀማሉ?** እያንዳንዱ ጥያቄ በOmniRoute ማመቂያ ሂደት መስመር **በግልጽነት** ያልፋል — በደንበኛው በኩል ምንም ለውጥ አያስፈልግም። አሁን በቅደም ተከተል የሚሠሩ እና በእያንዳንዱ የማስተላለፊያ ጥምረት የሚዋሃዱ **12 ሊጣመሩ የሚችሉ ሞተሮች ቁልል** ነው — ከ[RTK](https://github.com/rtk-ai/rtk)፣ [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+)፣ [LLMLingua-2](https://github.com/microsoft/LLMLingua) እና [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) ሐሳቦች ላይ በመመሥረት። ### 🧱 የ12 ሞተሮች ቁልል ሞተሮቹ በሂደት መስመሩ ቅደም ተከተል ይሠራሉ፤ እያንዳንዳቸውን በተናጠል ማብራትና ማጥፋት፣ እንዲሁም ለእያንዳንዱ ጥምረት ማዋቀር ይቻላል፦

#	ሞተር	የሚሠራው
1	Session-Dedup	በተከታታይ ዙሮች የተደጋገመ ይዘትን ያስወግዳል (በይዘት አድራሻ የሚለይ፣ ዙሮችን አቋርጦ የሚሠራ)
2	CCR	ትላልቅ ብሎኮችን ከመልሶ ማግኛ ምልክቶች በስተጀርባ ያከማቻል፤ ሲፈለጉም ይወሰዳሉ
3	Lite	ነጭ ቦታን + የምስል URLን ማሳጠር (ዝቅተኛ መዘግየት ያለው መሠረታዊ አማራጭ)
4	RTK	ብልህ የመሣሪያ ውጤት ማጣራት፣ ተደጋጋሚ ይዘትን ማስወገድ እና መቁረጥ (ትዕዛዝን የሚያውቅ)
5	Responses Tool Output	በመጀመሪያ መረጃ የማያሳጣ JSON + ለshell/patch/search/build ውጤቶች ወሰን ያለው የምርመራ ማመቅ (Responses API)
6	Headroom	በውስጥ የተካተተ GCF ኮዴክ በመጠቀም የJSON ድርድሮችን መረጃ የማያሳጣ ሰንጠረዣዊ ማጠቃለል (~30%)
7	Relevance	ከመጨረሻው የተጠቃሚ ጥያቄ አንጻር ዐረፍተ ነገሮችን በማውጣት ደረጃ መስጠት
8	Caveman	በደንብ ላይ የተመሠረተ የስድ ንባብ ማመቅ (በውጤት ላይ ~65–75%)
9	Aggressive	ማጠቃለል + የቆዩ ዙሮችን በሂደት ማርጀት
10	LLMLingua-2	በMobileBERT ONNX በኩል የML ትርጉማዊ ቅንጠባ — ለኮድ ደህንነቱ የተጠበቀ፣ ያልተመሳሰለ
11	Ultra	አማራጭ አነስተኛ-ሞዴል (SLM) ደረጃ ያለው በልምድ ላይ የተመሠረተ የቶከን ቅንጠባ
12	OmniGlyph	በቀጥታው Anthropic ግንኙነት ላይ ለተለካው Claude Fable 5 የሙከራ ዐውድ-እንደ-ምስል ኮድ ማድረግ፤ የGPT 5.6 ትራንስፎርመሮች የአቅራቢ ደረሰኞች እስኪገኙ ድረስ ሲሳኩ ዝግ ሆነው ይቆያሉ። አራት የማመቂያ መገለጫዎች (ነባሪው aggressive፣ balanced፣ coding-safe፣ passthrough) (እጅግ ኃይለኛው፤ በምርጫ የሚነቃ)

የኮድ ብሎኮች፣ URLs እና የተዋቀረ ውሂብ በባይት ደረጃ ፍጹም ሆነው **ሁልጊዜ ይጠበቃሉ**። **በአንድ ጠቅታ የሚመረጡ ቅንብሮች** ሞተሮቹን ያጣምራሉ፦

ሁነታ	ቁጠባ	በጣም የሚስማማው
🪶 Lite	~15%	ሁልጊዜ የሚሠራ ደህንነቱ የተጠበቀ ነባሪ
🪨 Standard (Caveman)	~30%	ዕለታዊ ኮድ ማዘጋጀት
⚡ Aggressive	~50%	መሣሪያዎች በብዛት የሚጠቀሙ ረጅም ክፍለ ጊዜዎች
🔥 Ultra	~75%	ከፍተኛው ቁጠባ
🧰 RTK	60–90%	የshell/test/build/git ውጤት
🔗 Stacked (RTK → Caveman)	78–95%	የተቀላቀሉ ጥያቄዎች + የመሣሪያ መዝገቦች

**እውነተኛ ምሳሌ — Standard ሁነታ፦** > **በፊት (69 ቶከኖች)፦** _"የReact ኮምፖነንትዎ እንደገና እየተሳለ ያለበት ምክንያት ምናልባት በእያንዳንዱ የማሳያ ዑደት አዲስ የኦብጀክት ማጣቀሻ እየፈጠሩ ስለሆነ ነው። የመስመር ውስጥ ኦብጀክትን እንደ prop ሲያስተላልፉ፣ የReact ጥልቀት የሌለው ንጽጽር በእያንዳንዱ ጊዜ እንደተለየ ኦብጀክት ያየዋል፤ ይህም እንደገና መሳልን ያስነሳል። ኦብጀክቱን በማስታወሻ ለማቆየት useMemoን እንዲጠቀሙ እመክራለሁ።"_ > > **በኋላ (19 ቶከኖች)፦** _"በእያንዳንዱ ማሳያ አዲስ የኦብጀክት ማጣቀሻ። የመስመር ውስጥ ኦብጀክት prop = አዲስ ማጣቀሻ = እንደገና መሳል። በuseMemo ያጠቃልሉት።"_ > > **ተመሳሳይ መልስ። 72% ያነሱ ቶከኖች። ምንም የትክክለኛነት መቀነስ የለም።** ✅ **የPT-BR ምሳሌ — [Troglodita](https://github.com/leninejunior/troglodita) ሁነታ፦** > **በፊት (42 ቶከኖች):** _"ችግሩ፣ በእያንዳንዱ የሬንደር ዙር አዲስ የኦብጀክት ማጣቀሻ ስለሚፈጠር ኮምፖነንቱ እንደገና ሬንደር እያደረገ መሆኑ ነው። useMemoን እንዲጠቀሙ እመክራለሁ።"_ > > **በኋላ (12 ቶከኖች):** _"እንደገና ሬንደር፦ በእያንዳንዱ ዙር አዲስ ማጣቀሻ (inline ኦብጀክት እንደገና ይፈጠራል)። `useMemo`ን ይጠቀሙ።"_ > > **ተመሳሳይ መልስ። ~70% ያነሱ ቶከኖች። ቴክኒካዊ ትክክለኛነቱ እንደተጠበቀ ነው።** ✅
### 🎚️ ከኤንጂኖቹ ባሻገር — የውጤት ቅጦች፣ ተስማሚ ማስተካከያው እና የእያንዳንዱ ጥያቄ ቁጥጥር ከላይ ያሉት 12 ኤንጂኖች ወደ **ውስጥ** የሚገባውን ይቀንሳሉ። ሦስት ተጨማሪ ንብርብሮች **እንዴት**፣ **መቼ** እና ምን ወደ **ውጭ** እንደሚወጣ ቅርጽ ይሰጣሉ፦ - **🪄 የውጤት ቅጦች** _(በውጤት ዘንግ ላይ መምራት)_ — ውሳኔያዊና ለካሽ ደህንነቱ የተጠበቀ የምላሽ ቅርጽ ማስያዣ መመሪያዎችን ያክላል፤ እርስ በርስ ሊጣመሩ ይችላሉ፣ እያንዳንዳቸውም በ`lite` / `full` / `ultra` ጥንካሬ ይሰራሉ። ቅጥ ማከል በሬጂስትሪው ውስጥ የአንድ መስመር ግቤት ብቻ ነው፦ - **አጭር ጽሑፍ** — አላስፈላጊ ቃላትን / አርቲክሎችን / ማመንታትን ያስወግዱ፤ ቴክኒካዊ ይዘቱን በትክክል ያቆዩ። - **ያነሰ ኮድ** — የ"ሰነፍ ከፍተኛ ደረጃ ገንቢ" YAGNI፦ ትንሹ የሚሰራ ለውጥ፣ ያልተጠየቀ የመሠረተ ኮድ የለም። - **Ponytail (ሰነፍ ከፍተኛ ደረጃ ገንቢ)** — የYAGNI ደረጃዎችን ይውጡ፣ ዋናውን መንስኤ ያስተካክሉ፣ ትንሹን የሚሰራ diff ይጠቀሙ። - **ADHD አለብኝ (ድርጊት-ቀዳሚ)** — ቀጣዩን ድርጊት አስቀድሞ ያቀርባል፣ ደረጃዎችን በቁጥር ይዘረዝራል፣ አንድ ተጨባጭ ቀጣይ እርምጃ ይሰጣል፣ መግቢያ አይጨምርም። - **አጭር CJK (文言)** — እጅግ አጭር የጥንታዊ ቻይንኛ ቅጥ (በlocale ተገድቦ ለ`zh`)። - **🎯 ተስማሚ የአውድ በጀት** _(ማስተካከያው)_ — በአንድ የማብራት/ማጥፋት የቶከን ገደብ ፈንታ፣ **ከሞዴሉ የአውድ መስኮት ጋር ለማስማማት** በጣም ርካሽና አነስተኛ የመረጃ ኪሳራ ያላቸውን ኤንጂኖች እስከሚያስፈልገው ድረስ ብቻ ደረጃ በደረጃ ያሳድጋል። ፖሊሲ፦ `reserve-output` (ነባሪ፣ ሞዴሉን የሚያገናዝብ) · `percentage` · `absolute`። ሁነታ፦ `floor` (መስማማቱን ያረጋግጣል) · `replace-autotrigger` (ግልጽ ምርጫዎ ቅድሚያ ያገኛል) · `off` (የቆየ ገደብ)። - **🎛️ ጭመቃ የሚወሰንበት ቦታ** _(ቅድሚያ፣ ከከፍተኛ → ዝቅተኛ)_ — የእያንዳንዱ ጥያቄ `x-omniroute-compression` ራስጌ › የራውቲንግ ውህድ ሽረት › ገቢር ስያሜ ያለው መገለጫ › ተስማሚ / ራስ-ሰር ማስጀመሪያ › የፓነል ነባሪ › ጠፍቷል። ተግባራዊ የሆነው ዕቅድ በ`X-OmniRoute-Compression: ; source=` የምላሽ ራስጌ ውስጥ ተመልሶ ይታያል። በቶከን ገደብ ራስ-ሰር ማስጀመሪያውን ያብሩ፣ ተስማሚ ማስተካከያውን ያንቁ፣ ስያሜ ያለውን መገለጫ ይሰኩ፣ ለእያንዳንዱ ጥያቄ የአንድ ጊዜ ቅንብር ያዘጋጁ ወይም ለእያንዳንዱ የራውቲንግ ውህድ pipeline ይመድቡ — ለስራው የሚስማማውን ይጠቀሙ። በፈቃድ የሚነቃው ከመስመር ውጭ **የግምገማ መሣሪያ** (`npm run eval:compression`) ለውጥን ከማስተዋወቅዎ በፊት፣ በተወሰነ corpus ላይ ታማኝነትን ከቁጠባ ጋር ያነጻጽራል። 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ ፈጣን መጀመሪያ

**1) ይጫኑ እና ያስኪዱ** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` ወይም የpeer-dep ማስጠንቀቂያዎችን አዩ? [ምንም ጉዳት የላቸውም](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)። ዳሽቦርዱ `http://localhost:20128` ላይ · APIው `http://localhost:20128/v1` ላይ። **2) ነፃ አቅራቢን ያገናኙ (ምዝገባ አያስፈልግም)** ዳሽቦርድ → **አቅራቢዎች** → **Kiro AI**ን (ነፃ Claude፣ ለእያንዳንዱ መለያ ~50 ክሬዲቶች/ወር) ወይም **OpenCode Free**ን (ማረጋገጫ አያስፈልግም) ያገናኙ → ተጠናቋል። **3) የኮድ መሣሪያዎን ያመልክቱ** ```txt መሠረታዊ URL: http://localhost:20128/v1 API ቁልፍ: [ከዳሽቦርድ → መጨረሻ ነጥቦች ይቅዱ] ሞዴል: auto (ያለ ቅንብር ብልህ ራውቲንግ — ወይም ማንኛውም አቅራቢ/ሞዴል) ``` **4) እየሰራ መሆኑን ያረጋግጡ** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` ያገናኟቸው ሞዴሎች በዝርዝሩ ውስጥ ሊታዩ ይገባል። 🎉 ይሄው ነው — ኮድ መጻፍ ይጀምሩ፣ OmniRoute በራስ-ሰር ራውቲንግ ያደርግልዎታል እና ካልተሳካም ወደ አማራጭ ይቀይራል። ደንበኛዎ ብጁ ራስጌዎችን መላክ ካልቻለ፣ OmniRoute በቶከን የተደገፉ የተኳኋኝነት ተለዋጭ ስሞችንም ያቀርባል፦ ```txt የOpenAI ካታሎግ: http://localhost:20128/vscode/YOUR_KEY/ የOpenAI ሞዴሎች: http://localhost:20128/vscode/YOUR_KEY/models የOpenAI ውይይት: http://localhost:20128/vscode/YOUR_KEY/chat/completions የOpenAI ምላሾች: http://localhost:20128/vscode/YOUR_KEY/responses የOllama ውይይት: http://localhost:20128/vscode/YOUR_KEY/api/chat የOllama መለያዎች: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` እነዚህን `Authorization: Bearer ...`ን ማያያዝ ለማይችሉ ደንበኞች ብቻ ይጠቀሙ። በራስጌ የሚደረግ ማረጋገጫ አሁንም ተመራጩ ሁነታ ነው።
## 📦 ተጨማሪ የመጫኛ ዘዴዎች — Docker፣ ከምንጭ፣ pnpm፣ Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` ከታተሙት የተረጋጉ SemVer ስሪቶች ከፍተኛውን ይከተላል። git `main`ን አይከተልም። ለGitOps `:X.Y.Z`ን በቋሚነት ይጠቀሙ። [Docker የልቀት ቻናሎች](docs/guides/DOCKER_GUIDE.md#release-channels)ን ይመልከቱ። ምስሉ **`OMNIROUTE_MEMORY_MB=1024`**ን በቋሚነት ያስቀምጣል። ይህ ለዳሽቦርዱ እና ለቀላል ውይይት በቂ ነው። **የኮድ ጽሑፍ ወኪሎች** (ከClaude Code፣ Codex፣ Grok፣ … የሚመጣ `POST /v1/responses`) እጅግ ትልቅ የV8 heap ያስፈልጋቸዋል፤ አለበለዚያ ሁለት ረጅም እና ተደራራቢ ዐውደ-ጽሑፎች ሲኖሩ ሂደቱ ~12 GiB ላይ `FATAL ERROR` ያጋጥመዋል። ኮንቴይነሩን ከheap በላይ የሆነ መጠን ይመድቡ (ቤተኛ buffers ከV8 ውጭ ይገኛሉ)፦ | የሥራ ጫና | Heap (`-e OMNIROUTE_MEMORY_MB`) | ኮንቴይነር (`--memory`) | | ------------------------------------- | ------------------------------- | ------------------- | | ዳሽቦርድ / ቀላል ውይይት | `1024` (የምስሉ ነባሪ) | ≥2 g | | አንድ የኮድ ጽሑፍ ወኪል | `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 ይከተላሉ። እነዚህ ሊለወጡ የሚችሉ tags ያልተለቀቁ ማስተካከያዎችን ለመሞከር ብቻ የታሰቡ ሲሆን > **በምርት አካባቢ አይደገፉም**። > [Docker የልቀት ቻናሎች](docs/guides/DOCKER_GUIDE.md#release-channels)ን ይመልከቱ። **🥟 Bun** መደበኛው `bun install` እና ዓለም አቀፍ መጫን (`bun install -g omniroute`) በBun አሂድ ጊዜ ራስ-ሰር ማወቅ በኩል ይደገፋሉ፦ - **አብሮ የተካተተ `bun:sqlite`**፦ OmniRoute በBun ስር ሲሠራ አብሮ የተካተተውን የBun `bun:sqlite` driver ይጠቀማል፤ በNode.js ላይ ደግሞ ወደ `better-sqlite3` ወይም `sql.js` ይመለሳል። - **በልማት ጊዜ ራስ-ሰር የWebpack bundler ምርጫ**፦ ልማት (`bun run dev`) የቤተኛ V8 binding አለመጣጣምን ለመከላከል Bunን በራስ-ሰር ያውቃል እና Turbopackን በማሰናከል Webpackን ይጠቀማል። የምርት builds (`bun run build`) በNode ላይ እንዳለው `OMNIROUTE_USE_TURBOPACK`ን በትክክል ይከተላሉ፦ በነባሪ Turbopack፣ በWebpack build ለማድረግ `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` ይህን እንደ `--build-arg` ያቀርባል)። - **ለBun የተለየ Dockerfile**፦ ለቤተኛ Bun የምርት deployments ባለብዙ-ደረጃ `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 flakesን በመጠቀም nix develop npm run dev # ወይም devboxን በመጠቀም devbox run npm run dev ``` 📖 [Docker መመሪያ](docs/guides/DOCKER_GUIDE.md) — Compose profiles፣ Caddy HTTPS፣ Cloudflare tunnels። **🦭 Podman** ```bash # 1. bind-mounted የውሂብ ማውጫውን ያዘጋጁ mkdir -p data # 2. ለLinux + አካባቢያዊ rootless Podman ብቻ (በርቀት የPodman Machine client ላይ ፈጽሞ አይጠቀሙ)፦ podman unshare chown 1000:1000 ./data # 3. የአሂድ ጊዜ ፍንጭን ያዘጋጁ፣ አካባቢያዊውን Compose image ይገንቡ እና ያስጀምሩ echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` በmacOS ወይም Windows ላይ Podman የርቀት Podman Machine ይጠቀማል፦ `podman unshare`ን ይዝለሉ እና [ለtopology የተለየውን የውሂብ ማውጫ መመሪያ](contrib/podman/README.md#data-directory-permissions-by-topology) ይከተሉ። 📖 [Podman መመሪያ](contrib/podman/README.md) — Compose builds፣ Podman Machine፣ እና የLinux/systemd Quadlet ማዋቀር። **⚡ ፈጣን / ቀለል ያለ ጭነት (ቤተኛውን build ይዝለሉ)** ቤተኛው SQLite engine (`better-sqlite3`) **አማራጭ** dependency ነው፤ ስለዚህ ዓለም አቀፍ ጭነት ከምንጭ ማጠናቀርን በመጠበቅ ፈጽሞ አይታገድም፦ ከእርስዎ platform/Node ጋር የሚዛመድ ከሆነ አስቀድሞ የተገነባ binary ይጠቀማል፤ አለበለዚያ በግልጽነት ወደ ሙሉ-JS engine (በNode 22+ ላይ `node:sqlite`፣ ያለበለዚያ የተካተተው `sql.js` WASM) ይመለሳል — የbuild መሣሪያዎች አያስፈልጉም። ከጭነት በኋላ የሚደረገውን ቤተኛ warm-up ሙሉ በሙሉ ለመዝለል (CI፣ headless ወይም ዘገምተኛ ማሽኖች)፦ ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1ም ይዘለዋል ``` ለፈጣኑ ጭነት **pnpm**ን ይምረጡ (በይዘት አድራሻ የሚሰጥ store + hard links — ከላይ ይመልከቱ)። ዳሽቦርድ ለሌለው headless አሂድ ጊዜ የDocker `base` profileን (ከላይ) ወይም [የTermux መመሪያ](docs/guides/TERMUX_GUIDE.md)ን ይጠቀሙ። CLIው እና የድር ዳሽቦርዱ በአንድ port ላይ በተመሳሳይ ሂደት ይቀርባሉ፤ ስለዚህ በአሁኑ ጊዜ የተለየ CLI-only package የለም።

# 🎬 OmniRoute በተግባር

## 📹 የቪዲዮ መመሪያዎች

_{የዳሽቦርድ ቅጽበታዊ እይታ በ2026-08-24 · ጥሬ ካታሎግ፦ YT 809 | TT 137 | IG 124 · ወቅታዊነት (ቀናት)፦ YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 እይታዎች}

🎬 #2 — Instagram
_{theopenstack — 692,419 እይታዎች}

🎬 #3 — TikTok
_{milesreevesai — 620,400 እይታዎች}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 እይታዎች}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 እይታዎች}

**ሙሉ ደረጃ አሰጣጥ (የተደጋገሙት የተወገዱባቸው ቀኖናዊ URLs፣ `v > 0`፣ ከፍተኛው ተደራሽነት)፦** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | ቀኖናዊ መለኪያዎች በ2026-08-24፦ **1.029 ልዩ ቪዲዮዎች** · **11.132.922 የታወቁ እይታዎች** (`v > 0`) · **639 ቻናሎች/መገለጫዎች በየአውታረ መረቡ**። ጥሬው ዳሽቦርድ 1.070 ረድፎችን ይዟል፤ 41 የInstagram ብዜቶች በቀኖናዊ URL መሠረት ተስተካክለው፣ ለእያንዳንዱ ቪዲዮ ከፍተኛው የእይታ ብዛት ተጠብቋል። > 🎬 **ስለ OmniRoute ቪዲዮ ሠርተዋል?** ከሊንኩ ጋር [ችግር](https://github.com/diegosouzapw/OmniRoute/issues/new) ወይም [ውይይት](https://github.com/diegosouzapw/OmniRoute/discussions) ይክፈቱ — እዚህ እናቀርበዋለን።

# 📧 ማህበረሰብ እና እገዛ > ሁሉም ነገር በአንድ ቦታ — ጠባቂውን ይከተሉ፣ ከማህበረሰቡ ጋር ይወያዩ ወይም ችግር ይክፈቱ። | ቻናል | የት / እንዴት | | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — አስተዳዳሪውን ይከተሉ | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — ልቀቶችን እና ምክሮችን ለማግኘት ይከተሉ | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 ዓለም አቀፍ** | [ቡድኑን ይቀላቀሉ](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 ብራዚል** | [ቡድኑን ይቀላቀሉ](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **ድረ ገጽ** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute ማህበረሰብ (ነፃ)** | [የStHub ፖርታል](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **የምንጭ ኮድ** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **ሳንካ ሪፖርት ያድርጉ** | [ጉዳይ ይክፈቱ](https://github.com/diegosouzapw/OmniRoute/issues) — የ`npm run system-info` ውጤትን ያያይዙ | | 🤝 **አስተዋጽኦ ያድርጉ** | [CONTRIBUTING.md](CONTRIBUTING.md) · [የቅርንጫፍ እና ልቀት ሞዴል](docs/ops/BRANCHING_MODEL.md) · `good first issue` ይምረጡ | | 💚 **ፕሮጀክቱን ይደግፉ** | [የድጋፍ መንገዶች ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ የቴክኖሎጂ ክምችት

ንብርብር	ቴክኖሎጂ
ሩንታይም	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
ቋንቋ	TypeScript 6.0 — 100% TypeScript across `src/` and `open-sse/` (zero `any` in core since v2.0)
ፍሬምዎርክ	Next.js 16 + React 19 + Tailwind CSS 4
ዳታቤዝ	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 122 domain modules, 183 migrations
ማህደረ ትውስታ	SQLite FTS5 full-text + int8-quantized vector embeddings, typed decay
ስኪማዎች	Zod 4 — MCP tool I/O validation + API contracts
ፕሮቶኮሎች	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
ዥረት መልቀቅ	Server-Sent Events (SSE) + WebSocket bridge (`/v1/ws`)
መጭመቅ	12-engine pipeline — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
ማረጋገጫ እና ደህንነት	OAuth 2.0 (PKCE) + JWT + API Keys + MCP scoped auth · AES-256-GCM at rest · DOMPurify
ስውርነት	wreq-js — JA3 / JA4 TLS fingerprint impersonation, 3-level proxy
መቋቋም	Circuit breaker, exponential backoff, anti-thundering-herd, auto-combo self-healing
ሎጊንግ	pino — structured JSON logs with request context
ሙከራ	Node.js test runner + Vitest — 39,000+ static test declarations across 5,100+ tracked test files (unit, integration, E2E, security, ecosystem)
ፕላትፎርሞች	Desktop (Electron) · Android (Termux) · PWA (any browser)
CI/CD	GitHub Actions — auto npm publish + Docker Hub on release
አገናኞች	ድር ጣቢያ · npm · Docker Hub

## 📖 ሰነዶች

### 📘 መጀመሪያ

ሰነድ	መግለጫ
የተጠቃሚ መመሪያ	አቅራቢዎች፣ ጥምረቶች፣ የCLI ውህደት፣ ማሰማራት
የማዋቀር መመሪያ	ሙሉ የመጫኛ ዘዴዎች፣ የCLI መሣሪያ ውቅሮች፣ የፕሮቶኮል ማዋቀር፣ የጊዜ ገደብ ማስተካከያ
የCLI መሣሪያዎች መመሪያ	ለClaude Code፣ Codex፣ Cursor፣ Cline፣ OpenClaw፣ Kilo፣ Copilot የየመሣሪያው ማዋቀር
የርቀት ሁነታ	ወሰን ያላቸውን የመዳረሻ ቶከኖች በመጠቀም የርቀት OmniRoute (VPS)ን ከላፕቶፕዎ CLI ያስተዳድሩ
የClaude Code ውቅር	`launch` + የየሞዴሉ መገለጫዎችን በመጠቀም Claude Codeን ወደ OmniRoute (አካባቢያዊ/የርቀት) ያመልክቱ
ፈጣን ጅምር	ባለ3-ደረጃ መጫን → ማገናኘት → ማዋቀር

### 🔧 ክወናዎች እና ማሰማራት

ሰነድ	መግለጫ
የDocker መመሪያ	Docker run፣ የCompose መገለጫዎች፣ Caddy HTTPS፣ ዋሻዎች፣ የምስል መለያዎች
የPodman መመሪያ	የQuadlet systemd ውህደት፣ podman-compose፣ SELinux
የVM ማሰማራት	የተሟላ መመሪያ፦ VM + nginx + Cloudflare ማዋቀር
የFly.io ማሰማራት	ቋሚ ማከማቻን በመጠቀም ወደ Fly.io ያሰማሩ
የTermux መመሪያ	OmniRouteን በTermux በኩል በAndroid ላይ ያስኪዱ
የPWA መመሪያ	የProgressive Web App ጭነት፣ መሸጎጫ፣ አርክቴክቸር
የማራገፍ መመሪያ	ለሁሉም የመጫኛ ዘዴዎች ንጹሕ ማስወገድ
የአካባቢ ውቅር	የተሟሉ የ`.env` ተለዋዋጮች እና ማጣቀሻዎች

### 🧠 ባህሪያት እና አርክቴክቸር

ሰነድ	መግለጫ
አርክቴክቸር	የስርዓት አርክቴክቸር፣ የውሂብ ፍሰት እና ውስጣዊ አሠራር
የማመቂያ መመሪያ	ባለ7-አማራጭ ቧንቧ፦ ጠፍቷል / ቀላል / መደበኛ / ኃይለኛ / እጅግ ከፍተኛ / RTK / የተደራረበ
የRTK ማመቂያ	የትዕዛዝ ውጤት ማመቂያ፣ ማጣሪያዎች፣ እምነት፣ ማረጋገጥ፣ ያልተሰናዳ ውጤትን መልሶ ማግኘት
የማመቂያ ሞተሮች	Caveman፣ RTK፣ የተደራረቡ ቧንቧዎች፣ የዳሽቦርድ/API/MCP በይነገጾች
የማመቂያ ደንቦች ቅርጸት	ለCaveman እና RTK ማጣሪያዎች የJSON የደንብ-ጥቅል መርሐግብሮች
የማመቂያ ቋንቋ ጥቅሎች	ቋንቋን መለየት እና የCaveman የደንብ-ጥቅል ዝግጅት
የጽናት መመሪያ	የወረዳ ሰባሪዎች፣ የማቀዝቀዣ ጊዜዎች፣ ወረፋ፣ የጎርፍ ጥያቄ መከላከያ፣ የTLS ማስመሰል
የራስ-ጥምረት ሞተር	ባለ16-ምክንያት ውጤት አሰጣጥ፣ የሁነታ ጥቅሎች፣ ራስን መጠገን
የፕሮክሲ መመሪያ	ባለ3-ደረጃ የፕሮክሲ ስርዓት፣ የ1proxy ገበያ፣ የመዝገብ CRUD
ነፃ ደረጃዎች	የተጠቃለለ ማውጫ፦ 35 በሰነድ የተገለጹ ተደጋጋሚ ስብስቦች / 489 በካታሎግ የተመዘገቡ የነፃ-ደረጃ ግቤቶች
የባህሪያት ማዕከለ-ስዕላት	ከቅጽበታዊ ገጽ ምስሎች ጋር የሚቀርብ ምስላዊ የዳሽቦርድ ጉብኝት
የኮድ ስብስብ ሰነድ	ለጀማሪዎች ምቹ የኮድ ስብስብ ዝርዝር መመሪያ

### 🤖 ፕሮቶኮሎች እና APIዎች

ሰነድ	መግለጫ
የAPI ማጣቀሻ	ሁሉም የመጨረሻ ነጥቦች ከምሳሌዎች ጋር
የOpenAPI ዝርዝር መግለጫ	የOpenAPI 3.0 ዝርዝር መግለጫ
MCP አገልጋይ	110 የMCP መሣሪያዎች፣ የIDE ውቅሮች፣ የPython/TS/Go ደንበኞች
የMCP አገልጋይ መመሪያ	የMCP ጭነት፣ ማጓጓዣዎች እና የመሣሪያ ማጣቀሻ
A2A አገልጋይ	የJSON-RPC 2.0 ፕሮቶኮል፣ ክህሎቶች፣ ዥረት ማሰራጨት፣ የተግባር አስተዳደር
የA2A አገልጋይ መመሪያ	የA2A ወኪል ካርድ፣ ተግባራት፣ ክህሎቶች እና ዥረት ማሰራጨት

### 📋 ፕሮጀክት እና ጥራት

ሰነድ	መግለጫ
አስተዋጽዖ ማድረግ	የልማት ማዋቀሪያ እና መመሪያዎች
የቅርንጫፍ እና ልቀት ሞዴል	PRዎች የሚያነጣጥሩበት (`release/*`)፣ `main` እና መለያዎች ምን ማለት እንደሆኑ
የለውጥ መዝገብ	የእያንዳንዱ ስሪት ሙሉ የልቀት ታሪክ
የደህንነት ፖሊሲ	የተጋላጭነት ሪፖርት አደራረግ እና የደህንነት ልምዶች
የi18n መመሪያ	የ42 ቋንቋዎች ድጋፍ፣ የትርጉም የስራ ፍሰት፣ RTL
የልቀት ማረጋገጫ ዝርዝር	ከልቀት በፊት የማረጋገጫ ደረጃዎች
የሽፋን ዕቅድ	በ5,100+ ክትትል በሚደረግባቸው የሙከራ ፋይሎች ውስጥ ለ39,000+ ቋሚ የሙከራ መግለጫዎች የሙከራ ሽፋን ስትራቴጂ

# ⭐ ከፍተኛ አስተዋጽዖ አድራጊዎች > OmniRoute በጋለ ስሜት ባለው ክፍት ምንጭ ማህበረሰብ የተቀረጸ ነው። እነዚህ ግለሰቦች በፕሮጀክቱ ጥራት፣ መረጋጋት እና ተደራሽነት ላይ ቀጥተኛ ተፅዕኖ ያላቸውን ልዩ አስተዋጽዖዎች አድርገዋል። **እናመሰግናለን።** ### በተዋሃዱ pull requestዎች የተደረደሩ ውጫዊ አስተዋጽዖ አድራጊዎች

ደረጃ	አስተዋጽዖ አድራጊ	የተዋሃዱ PRዎች	~የተለወጡ መስመሮች
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{በቀጥታ ስርጭት ላይ ባለው release/v3.8.50 ጫፍ dafb4ae808፣ እስከ 2026-08-24 05:26:03 UTC ድረስ ባሉ ውህደቶች ላይ የተወሰነ። በገጽ የተከፋፈለው የGitHub GraphQL ቆጠራ 5,911 የተዋሃዱ PRዎችን ይዟል፦ 2,707 በማከማቻው ባለቤት፣ 179 በDependabot እና 3,025 ውጫዊ PRዎች ከ535 የተለያዩ አስተዋጽዖ አድራጊዎች። “የተለወጡ መስመሮች” የGitHub ጭማሪዎችን + ቅነሳዎችን የሚያመለክት ሲሆን የመነጩ ፋይሎችን፣ lockfileዎችን፣ ካታሎጎችን፣ ትርጉሞችን እና ሰነዶችን ያካትታል፤ ይህ የለውጥ መጠን እንጂ በደራሲዎች የተጻፉ LOC አይደሉም። በመቁረጫው ነጥብ ላይ ያሉ እኩል ደረጃዎች ተጠብቀዋል።} ### በGitHub የተመደቡ commits

backryun _{🥇 220 በGitHub የተመዘገቡ commits}	Paijo _{🥈 219 በGitHub የተመዘገቡ commits}	Randi _{🥉 108 በGitHub የተመዘገቡ commits}	Ravi Tharuma _{🏅 81 በGitHub የተመዘገቡ commits}	Chris _{🏅 70 በGitHub የተመዘገቡ commits}	Markus Hartung _{🏅 69 በGitHub የተመዘገቡ commits · በ#6 እኩል}
Dizzle _{🏅 69 በGitHub የተመዘገቡ commits · በ#6 እኩል}	Jan Leon _{🏅 64 በGitHub የተመዘገቡ commits}	zenobit _{🏅 62 በGitHub የተመዘገቡ commits}	Bob.Hou _{🏅 51 በGitHub የተመዘገቡ commits · በ#10 እኩል}	Xiangzhe _{🏅 51 በGitHub የተመዘገቡ commits · በ#10 እኩል}

_{በ2026-08-24 06:14:31 UTC እንደገና ተረጋግጧል፦ ለrelease/v3.8.50 ነባሪ branch በrepository Contributors API የተዘገቡ በGitHub የተመዘገቡ commits። APIው 525 ማንነቶችን (415 ተጠቃሚዎች፣ 2 bots፣ 108 ስም-አልባ) መልሷል፤ ይህ ሰንጠረዥ maintainerን፣ botsን እና ስም-አልባ ማንነቶችን አያካትትም፣ የውድድር እኩል ውጤቶችንም ይጠብቃል። ይህ ከላይ ካለው የmerged-PR ደረጃ አሰጣጥም ሆነ ከታች ካለው የ639 ሰዎች Git-metadata ቆጠራ የተለየ ነው።} > 🙏 የእነዚህ አስተዋጽዖ አበርካቾች ባህሪያት፣ የስህተት ማስተካከያዎች እና የመሠረተ ልማት ማሻሻያዎች OmniRouteን አስተማማኝ እና በባህሪያት የበለፀገ ከሚያደርጉት ነገሮች **ዋና ክፍል** ናቸው። እያንዳንዱ pull request፣ እያንዳንዱ test case እና እያንዳንዱ የi18n ትርጉም ፋይል አስፈላጊ ነው። Open source የሚገነባው እንደእነሱ ባሉ ሰዎች ነው።

---
## 💖 ስፖንሰሮች

OmniRouteን ከራሳቸው ኪስ ለሚደግፉ ሰዎች ከልብ የመነጨ ምስጋና — እያንዳንዱ አስተዋጽኦ ፕሮጀክቱ ነጻ፣ ራሱን የቻለ እና ወደፊት የሚራመድ ሆኖ እንዲቀጥል ያደርጋል።

Andrew
_{💛 ንቁ ወርሃዊ ስፖንሰር}

Vlad I
_{💛 ንቁ ወርሃዊ ስፖንሰር}

Paco Cartones
_{💛 ንቁ የአንድ ጊዜ ስፖንሰር}

Prof. Igor Morais
_{💛 የቀድሞ የአንድ ጊዜ ደጋፊ}

longtao
_{💛 የቀድሞ የአንድ ጊዜ ደጋፊ}

_{… እና ማንነታቸውን በምስጢር ማቆየት የሚመርጡ ሌሎች 💛} _{ይፋዊ የGitHub ስፖንሰሮች በ2026-08-24 እንደገና ተረጋግጠዋል። ከላይ ያሉትን የንቁነት መለያዎች የሚወስነው የGitHub activeOnly ሁኔታ ነው፤ ከዚህ ቀደም በይፋ የተገለጹ የአንድ ጊዜ ደጋፊዎች ምስጋናቸውን እንደተቀበሉ ይቆያሉ፣ የግል ስፖንሰሮችም ስማቸው ሳይገለጽ ይቀራሉ።} 💖 ስፖንሰር ይሁኑ → — እያንዳንዱ ዶላር OmniRoute ነጻ እና ራሱን የቻለ ሆኖ እንዲቀጥል ያደርጋል።

## 👥 600+ አስተዋጽኦ አድራጊዎች

[![አስተዋጽኦ አድራጊዎች](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{በ2026-08-24 በተወሰነው መሠረታዊ ac02c5b42f ላይ ኦዲት ተደርጎ፣ በቀጥታ ባለው release/v3.8.50 ጫፍ dafb4ae808 ላይ እንደገና ተረጋግጧል፦ 639 መደበኛ የተደረጉ የሰው Git ማንነቶች — 407ቱ የcommit ደራሲዎች ሆነው ይታያሉ (ጠባቂውን ጨምሮ)፣ 232ቱ ደግሞ በግልጽ Co-authored-by ማጠቃለያ መስመሮች ውስጥ ብቻ ይታያሉ። ቆጠራው የGitHub noreply መለያዎችን መደበኛ ያደርጋል፣ 26 የbot/agent/service/placeholder ማንነቶችን ያስወግዳል፣ እንዲሁም የማሳያ ስሞቻቸው ስለሚመሳሰሉ ብቻ መደበኛ የኢሜይል አድራሻዎችን አያዋህድም።} ### እንዴት አስተዋጽኦ ማድረግ እንደሚቻል 1. ማከማቻውን fork ያድርጉ 2. ከ**ንቁው** `release/vX.Y.Z` ጫፍ branch ይፍጠሩ (`main` አይደለም) — [የBranch እና የRelease ሞዴል](docs/ops/BRANCHING_MODEL.md)ን ይመልከቱ 3. የባህሪ branchዎን ይፍጠሩ (`git checkout -b feat/amazing-feature`) 4. ለውጦችዎን commit ያድርጉ (`git commit -m 'feat: add amazing feature'`) 5. ወደ branchው push ያድርጉ (`git push origin feat/amazing-feature`) 6. **base = ያ `release/vX.Y.Z` branch** በማድረግ Pull Request ይክፈቱ ዝርዝር መመሪያዎችን ለማየት [CONTRIBUTING.md](CONTRIBUTING.md)ን ይመልከቱ። ### አዲስ ስሪት መልቀቅ ```bash # release ይፍጠሩ — npm publish በራስ-ሰር ይከናወናል VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 ኮከቦች

## 🌍 ስታርማፐር

## 🙏 ምስጋናዎች

OmniRoute በግዙፍ ፕሮጀክቶች ትከሻ ላይ የቆመ ነው። የጀመረው እንደ **[9router](https://github.com/decolua/9router)** fork እና የGo ፕሮጀክት **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** TypeScript port ሆኖ ነው፤ ከዚያም እያንዳንዱ ከታች ያለው subsystem ቀድሞ ከዚያ የደረሰ open-source ፕሮጀክት መነሳሳትን አግኝቷል። እያንዳንዳቸው የOmniRouteን አንድ ተጨባጭ ክፍል ቅርጽ አስይዘዋል። ይህ ለሁሉም የምናቀርበው ምስጋና ነው። 🙏 > ⭐ የኮከብ ብዛቶቹ ኦገስት 24፣ 2026 ላይ በGitHub REST API ተረጋግጠዋል — ለእነዚህ ፕሮጀክቶች ኮከብ ይስጡ። ብዛቶቹ በተጠቀሰው ቀን የተወሰደ ትክክለኛ ቅጽበታዊ መረጃ ሲሆኑ፣ በተፈጥሮ ይለወጣሉ። ### 🧬 የዘር ሐረግ እና gateway

ፕሮጀክት	⭐	ለOmniRoute እንዴት መነሻ ሆነ
9router	26,161	ይህ fork የተገነባበት ዋናው ፕሮጀክት — እዚህ ባለብዙ-ሞዳል APIs እና ሙሉ የTypeScript ዳግም ጽሑፍ ተስፋፍቷል።
CLIProxyAPI	48,497	ለዚህ JavaScript / TypeScript port መነሻ የሆነው የGo አተገባበር።
LiteLLM	57,100	የወጪ ክትትል ማመሳሰላችንን የሚመግብ ይፋዊ የዋጋ ውሂብ ስብስብ ያለው እና የአቅራቢ መደበኛነት ሞዴሉ የራውቲንግ ንድፋችንን ያሳወቀው የAI ጌትዌይ።
codex-chatgpt-web	1,410	የአሳሽ ክፍለ-ጊዜ፣ የምላሽ ክፈፍ፣ የአጠቃቀም እና የድር ፍለጋ አስማሚዎችን ጨምሮ፣ በውስጥ ወደተካተተው ChatGPT Web → Codex Responses ድልድይ የተስማማ የMIT ምንጭ።
free-claude-code	48,112	ወደ ዥረት መልሶ ማግኛ፣ no-thinking ተለዋጭ ስሞች፣ ተተኪ የድር ፍለጋ፣ ተንሸራታች-መስኮት ገደቦች፣ የሎግ ማደብዘዝ እና የተጠናከሩ የማስጀመሪያ ፍሰቶች የተላለፉ ንድፎች።
composer-api	322	ወደ ቤተኛው Cursor አስፈጻሚ የተስማሙ የCursor Composer መሣሪያ-ምርጫ፣ የውጤት-ገደብ እና የመሣሪያ-ማስረከቢያ ንድፎች።
codex-multi-auth	457	ወደ Codex OAuth ዳግም ማረጋገጫ የተላለፉ የአዲስ መግቢያ እና የrefresh-token ማዞሪያ ንድፎች።
opencode-anthropic-auth	510	ከClaude Code ጋር ተኳኋኝ የሆኑ ነባሪ የለውጥ ቅንብሮች እና የክፍያ ራስጌ ባህሪ ወደ OmniRoute በውቅር የሚመራ ድልድይ አጠቃላይ ተደርገዋል።
grok2api-merged	2	የእሱ የGrok ሞዴል ማዛመጃዎች፣ የሐሰት-TypeError Statsig አመንጪ፣ የጥያቄ እና የመሣሪያ ነባሪዎች፣ እንዲሁም NDJSON ምላሽ አቀናባሪ በተጨባጭ ሁኔታ ወደ OmniRoute የGrok Web አስፈጻሚ ተስማምተዋል።
TQZHR/grok2api	705	ከgrok2api-merged በስተጀርባ ያለው ዋና በተዘዋዋሪ የመጣ የኮድ ምንጭ፤ የእሱ ሞዴል፣ ራስጌ፣ payload፣ Statsig እና የአቀናባሪ አተገባበሮች በGrok Web የዘር ሐረግ ውስጥ ተጠብቀዋል።
chenyme/grok2api	7,520	በTQZHR እና grok2api-merged በኩል ለተላለፉት የGrok payload እና የመሣሪያ ነባሪዎች፣ የStatsig አመንጪ እና የ`result.response` አቀናባሪ መሠረታዊው የMIT ምንጭ።
grok2api-pro	27	ለproxy-pool ንብርብሩ grok2api-merged እውቅና የሰጠው በተዘዋዋሪ የመጣ ምንጭ፤ OmniRoute ያንን የዘር ሐረግ ማስታወቂያ ይጠብቃል፣ ነገር ግን በተገደበው Grok Web አስፈጻሚው ውስጥ የproxy-pool port እንዳለ አይገልጽም።
GrokProxy	50	በcookie የተረጋገጠው የGrok proxy እና የ`result.response.token` ዥረት ንድፉ ለOmniRoute የGrok Web ትራንስፖርት መነሻ ሆነዋል።
GrokBridge	5	የመጀመሪያው የGrok Web አተገባበር የእሱን HTTP/አሳሽ upstream ንድፍ አጣቅሷል፤ ቀጥተኛው የHTTP መንገዱ ከGrokProxy የመጣ ስለሆነ፣ ራሱን የቻለ የኮድ port እንደተደረገ አይገለጽም።
grok-web-api	14	የእሱ Rust `ChatOptions` እና የምላሽ-ኤንቨሎፕ መርሃግብሮች ለOmniRoute TypeScript Grok የጥያቄ እና የዥረት-ምላሽ ዓይነቶች መነሻ ሆነዋል።

### 🗜️ የአውድ እና የቶከን መጭመቂያ — ሞተሮች

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
Caveman	100,538	በስፋት የተሰራጨው “ጥቂት ቶከን ሥራውን ሲሠራ ብዙ ቶከን ለምን ይጠቀማሉ?” ፕሮጀክት — የዋሻ ሰው አነጋገር ፍልስፍናው መደበኛውን የማጨመቂያ ሁነታችንን እና ከ30 በላይ የማሟያ/ማጠራቀሚያ ደንቦችን ያንቀሳቅሳል።
RTK – Rust Token Killer	77,185	ከፍተኛ አፈጻጸም ያለው የትዕዛዝ ውጤት ማጨመቂያ — የRTK ሞተራችንን፣ JSON ማጣሪያ DSLን፣ ያልተቀነባበረ ውጤት መልሶ ማግኘትን እና የተደራረበውን RTK → Caveman የሂደት መስመር አነሳስቷል።
headroom	67,310	ሊቀለበስ የሚችል የአውድ ማጨመቂያ (SmartCrusher) — የ`headroom` ሞተራችንን እና የ`ccr` መልሶ ማግኛ ምልክት ንድፍን አነሳስቷል።
LLMLingua	6,598	የፕሮምፕት ማጨመቂያ ጥናት (LLMLingua / LLMLingua-2) — ያልተመሳሰለ፣ ለኮድ ደኅንነቱ የተጠበቀ እና ሲሳነው ዋናውን ውጤት የሚያሳልፍ የ`llmlingua` ሞተራችንን አነሳስቷል።
llmlingua-2-js	31	ለLLMLingua ሞተራችን እንደ የወርከር-ክር የጀርባ ሥርዓት ጥቅም ላይ የዋለው የJS/ONNX ፖርት (MobileBERT / XLM-RoBERTa)።
Troglodita	40	የPT-BR ቶከን ማጨመቂያ — የpt-BR ቋንቋ ጥቅላችንን ያንቀሳቅሳል፦ ለብራዚላዊ-ፖርቱጋላዊ ሰዋሰው የተስተካከለ የድግግሞሽ ቅነሳ እና የማሟያ ቃላት ማስወገድ።
ponytail	108,957	በስፋት የተሰራጨው የ“ሰነፍ ከፍተኛ ደረጃ ገንቢ” YAGNI-ኮደር ክህሎት — የless-code የውጤት ቅጣችንን አነሳስቷል፦ _የሚመነጨውን_ ኮድ የሚቀንስ በትንሹ የሚሠራ ለውጥ አቅጣጫ (ከCaveman አጭር ንባብ ጋር በውጤት ዘንግ ላይ ያለ አቻ)።
i-have-adhd	23,526	እርምጃን የሚያስቀድም፣ ለADHD ተስማሚ የሆነው የምላሽ ቅጡ በአምስት ቋንቋዎች ወደ OmniRoute አጭር የውጤት ቅጥ ተስተካክሏል።

### 🧩 የታመቁ ቅርጸቶች፣ የቶከን ጥናት እና ኮድን የሚያውቁ መሣሪያዎች

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
TOON	25,233	ቶከን-ተኮር የነገር ምልክት አጻጻፍ — የዓምድ፣ ራስጌ-እና-ረድፎች ሞዴሉ የሰንጠረዥ ማጠቃለያ ደረጃችንን ቀርጿል።
GCF – Graph Compact Format	41	የታመቀው የግራፍ ቅርጸት እና አጠቃላይ መገለጫ ንድፉ ለOmniRoute የሰንጠረዥ ማጠቃለያ እና የHeadroom ኮዴክ ቅርጸት መረጃ ሰጥተዋል።
gcf-typescript	4	በቀጥታ በፕሮጀክቱ ውስጥ የተካተተው እና እንደ Headroom አጠቃላይ-መገለጫ ኮዴክ የተስፋፋው የMIT TypeScript ትግበራ።
token-optimizer-mcp	494	Brotli/SQLite መሸጎጫ + በክፍለ ጊዜ የአውድ ልዩነት — የ`session-dedup` ሞተራችንን አነሳስቷል።
token-savior	1,122	የBash ውጤት ማጠቃለያ + MCP መገለጫዎች — የማጨመቂያ ማቋረጫ ሥነ-ሥርዓታችንን እና የMCP መሣሪያ ማኒፌስት ቅነሳን አነሳስቷል።
token-saver	138	ይዘትን የሚያውቅ፣ በፋይል ዓይነት የሚከናወን እና ስህተትን ያገናዘበ ማቋረጫ ያለው የውጤት ማጨመቂያ — በዓይነት የሚከናወነውን ማሰራጨታችንን እና ዝቅተኛ ጥቅም ሲኖር መዝለልን አረጋግጧል።
token-optimizer	1,951	“የማይታዩትን ቶከኖች ፈልግ” — ሥራን ወደ ውጭ የማስተላለፍ + ሊመለስ የሚችል መያዣ ንድፉ ለCCR ወደ ውጭ የማስተላለፍ አስተሳሰባችን መረጃ ሰጥቷል።
TokenMizer	28	ለክፍለ ጊዜ ግራፍ + በምላሾች መካከል የመስመር ብዜት ማስወገጃ የንድፍ መሠረት፣ ለsession-dedup ንድፋችን መረጃ የሰጠ።
OmniCompress	3	Rust ዓምዳዊ-JSON + ይዘት-አድራሻ ያለው መልሶ ማግኛ + በመልእክቶች መካከል የብዜት ማስወገጃ — የ`headroom`/`ccr`/`session-dedup` ሞተር ንድፋችንን እና ለመሸጎጫ የተረጋጋውን “የታመቀው ቅርጽ ከአቀማመጥ ነጻ ነው” የማይለወጥ መርህ አረጋግጧል።
mcp-compressor	113	የMCP መሣሪያ ስኪማ/መግለጫ ማጨመቂያ — ለMCP መሣሪያ ማኒፌስት የብዛት ቅነሳችን መረጃ ሰጥቷል።
RepoMapper	197	የAider ዓይነት የሪፖዚቶሪ-ካርታ ደረጃ አሰጣጥ — ለሪፖዚቶሪ-ካርታ / መልሶ-ማግኛ ደረጃ አሰጣጥ ምርምራችን መረጃ ሰጥቷል።
quiet-shell-mcp	4	በMCP ላይ የሚከናወን ገላጭ የሼል-ውጤት ቅነሳ — ገላጭ የbash-ውጤት ማጠቃለያችንን አረጋግጧል።
ts-morph	6,162	የTypeScript Compiler API መሣሪያ ስብስብ — ሕብረቁምፊ፣ አብነት እና ሬገክስ ሊተራሎችን በመጠበቅ በፓርሰር ላይ የተመሠረተ የአስተያየት ማስወገጃችንን አነሳስቷል።

### 🧠 ማህደረ ትውስታ እና RAG

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
Mem0	63,902	ሁለንተናዊ የማህደረ ትውስታ ንብርብር — የእሱ proxy-as-write/read-boundary ሞዴል የማህደረ ትውስታ አርክቴክቸራችንን ቅርጽ አስይዟል።
Letta (MemGPT)	24,382	ባለደረጃ ማህደረ ትውስታ ያላቸው ሁኔታ-ጠባቂ ወኪሎች — ለባለደረጃ Context Control & Recovery (CCR) ሞዴላችን መነሻ ሆነዋል።
WFGY	1,781	የ16 ተደጋጋሚ RAG/LLM የውድቀት ሁነታዎች ProblemMap ምድብ አደራደር — በችግር መፍቻ መመሪያችን ውስጥ ያለው የጋራ ቃላት ስብስብ።

### 🛰️ የትራፊክ ምርመራ፣ MITM እና ግልጽ ፕሮክሲ

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
llm-interceptor	66	የኮድ ረዳት ↔ LLM ትራፊክ MITM መጥለፍ/ትንተና ለመጀመሪያዎቹ Traffic Inspector መስፈርቶች መረጃ ሰጥቷል። ከዚህ ቀደም የተዋጡ አራት ሞጁሎች — SSE ማዋሃድ፣ የውይይት መደበኛነት፣ ሚስጥር መሸፈን እና የራስጌ ማጽዳት — በይፋዊ የፕሮቶኮል ደረጃዎች ላይ በተመሠረቱ ገለልተኛ እና ከባዶ በተገነቡ ትግበራዎች ተተክተዋል። ሁለቱ የአስተናጋጅ-ማሳለፊያ በይነገጾች (`passthrough.ts` እና `_internal/bypass.cjs`) በተናጠል የተመደቡ የOmniRoute ውስጣዊ ትግበራዎች ሆነው ይቀጥላሉ፤ የዚያ ምትክ አካል በመሆን እንደገና አልተጻፉም።
ProxyBridge	5,995	ለእያንዳንዱ ሂደት ግልጽ የፕሮክሲ ማዘዋወር — ከብልሽት የተጠበቀ MITM ማፍረስ፣ የሶኬት ስራ-ፈት ጊዜ ገደቦች፣ `/proc` የሂደት መለያ እና TPROXY ቀረጻችንን አነሳስቷል።

### 📚 የሞዴል ውሂብ፣ ታዛቢነት እና UI

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
models.dev	6,555	ክፍት የAI ሞዴል ዝርዝሮች፣ ዋጋ አወጣጥ እና ችሎታዎች የውሂብ ጎታ — በተፈጥሯዊ ሁኔታ ከሞዴል ካታሎጋችን ጋር ይመሳሰላል።
React Flow / xyflow	38,108	በቋጠሮ ላይ የተመሠረተው የግራፍ ቤተ-መጻሕፍት የአሁናዊ Compression Studio እና Combo/Routing Studioአችንን ያንቀሳቅሳል።
LangGraph	40,314	የLangGraph Studio የቀጥታ የስራ-ፍሰት ግራፍ እይታ የStudiosአችንን የአሁናዊ ተከታታይ እይታ አነሳስቷል።
Langfuse	33,592	የእሱ trace → span → generation ታዛቢነት ሞዴል የCompression Studio ፏፏቴ እይታችንን ቅርጽ አስይዟል።
Kiali	3,631	የIstio አገልግሎት-ሜሽ ታዛቢነት — በRouting/Combo Studio ውስጥ ያሉ የሰርኪት-ብሬከር ባጆቻችንን እና የስህተት-ጠርዝ ምስላዊ አቀራረቦችን አነሳስቷል።
lobe-icons	2,428	በዳሽቦርዳችን ላይ የአቅራቢዎችን አዶዎች የሚያሳዩ AI/LLM የምርት አርማዎች።
flag-icons	12,354	በREADME የቋንቋ መራጭ ውስጥ ጥቅም ላይ የሚውሉ MIT-ፈቃድ ያላቸውን SVG ባንዲራዎች ያቀርባል።

### 🛡️ ደህንነት

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
awesome-secure-defaults	721	የደህንነት ምርጫዎቻችንን የሚመራ በነባሪነት ደህንነታቸው የተጠበቀ የቤተ-መጻሕፍት ስብስብ (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)።

### 🧭 አጋዥ መሣሪያዎች

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
ClawRouter	6,564	የጥያቄ ብዜት ማስወገድን፣ የአደጋ ጊዜ ዜሮ-ወጪ ምትክን፣ ሊሰኩ የሚችሉ Auto-Combo ስልቶችን እና ባለብዙ ቋንቋ የዓላማ ምደባን አነሳስቷል።
Antigravity-Manager	30,652	መለያን ያገናዘበ የሞዴል ዳግም ማዛመድ፣ የሚፈጸም ፋይል ዱካ ማረጋገጥ እና የዕቅድ-መለያ ባህሪው ለOmniRoute Antigravity ሩጫ-ጊዜ መረጃ ሰጥቷል።
vscode-antigravity-cockpit	4,817	አጭር የኮታ-ዳግም-ማስጀመሪያ ቆጠራ ቅርጸቱ በOmniRoute ውስጥ ያለውን ተዛማጅ የአቅራቢ ገደብ ማሳያ አነሳስቷል።
AionUi	32,230	የእሱ ACP ውህደቶች OmniRoute የተጫኑ CLI ወኪሎችን በራስ-ሰር እንዲያገኝ አነሳስተዋል።
CodexBar	20,507	የGrok Build ኮታ በይነገጽን ለይቶ አሳይቷል፤ ከዚያም OmniRoute የቀጥታ የዋየር ቅርጸቱን በገለልተኛነት አረጋግጦ አስተካክሏል።

## 📄 ፈቃድ MIT ፈቃድ - ለዝርዝሮች [LICENSE](LICENSE)ን ይመልከቱ። ---

**[⬆ ወደ ላይ ተመለስ](#-omniroute)** · ለክፍት ምንጭ AI ማህበረሰብ በ❤️ የተገነባ። _{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT ፈቃድ · omniroute.online}