# 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 — ነፃው የAI መግቢያ OmniRoute — ኮድ መጻፍዎን ፈጽሞ አያቁሙ። እያንዳንዱ የAI መሣሪያ → 375 አቅራቢዎች — 150+ ነፃ — በአንድ የመጨረሻ ነጥብ በኩል። Claude Code፣ Codex፣ Cursor፣ Cline፣ Copilot እና Antigravity ከራስ-ሰር አማራጭ ሽግግር ጋር ወደ ነፃ Claude / GPT / Gemini። RTK + Caveman የተደራረበ መጭመቂያ 15–95% ቶከኖችን (~89% በአማካይ) ይቆጥባል — ገደቦች ላይ ፈጽሞ አይድረሱ። 375 የAI አቅራቢዎች · 150+ ነፃ ደረጃዎች · በወር ~1.62B ነፃ ቶከኖች · 20 የማስተላለፊያ ስልቶች · ለመጀመር $0።

OmniRoute — ኮድ መጻፍዎን ፈጽሞ አያቁሙ። እያንዳንዱ የAI መሣሪያ → 375 አቅራቢዎች — 150+ ነፃ — በአንድ የመጨረሻ ነጥብ በኩል። Claude Code፣ Codex፣ Cursor፣ Cline፣ Copilot እና Antigravity ከራስ-ሰር አማራጭ ሽግግር ጋር ወደ ነፃ Claude / GPT / Gemini። RTK + Caveman የተደራረበ መጭመቂያ 15–95% ቶከኖችን (~89% በአማካይ) ይቆጥባል — ገደቦች ላይ ፈጽሞ አይድረሱ። 375 የAI አቅራቢዎች · 150+ ነፃ ደረጃዎች · በወር ~1.62B ነፃ ቶከኖች · 20 የማስተላለፊያ ስልቶች · ለመጀመር $0።

## 💰 ~1.62B ቶከኖች / ወር በሶስተኛ ወገን ነፃ ደረጃዎች ላይ

> **የራስዎን የአቅራቢ መለያዎች ይምጡ።** ይህ በተለይ ብቁ ከሆኑ ሶስተኛ ወገን ነፃ ደረጃዎች የተገኘ ግምታዊ ድምር ነው፣ ከOmniRoute የተሰጠ የቶከን ድጎማ አይደለም። ይመዝገቡ፣ አስፈላጊ በሆኑበት ማረጋገጫዎችን ያግኙ እና መጠቀም የሚችሏቸውን አቅራቢዎች ያገናኙ፤ እያንዳንዱ አቅራቢ የራሱን ገደቦች፣ ተገኝነት እና ውሎች ይቆጣጠራል። > > ነፃ ደረጃዎችን በእጅ ማከባለል አስቸጋሪ ነው — በርካታ SDKዎች፣ በርካታ የመጠን ገደቦች (rate limits)፣ እና በትክክል ምን ያህል እንዳለዎት መረዳት አይቻልም። OmniRoute **በ34 ተደጋጋሚ የገንዳ ቁልፎች (pool keys) ላይ 467 የነፃ-ደረጃ ግቤቶችን** ያዘላል እና የቶከን ዋና ቁጥሩን ከ**የታተመ አዎንታዊ ወርሃዊ በጀት ካላቸው 17 ገንዳዎች እና አምስት በሞዴል-መሰረት Groq ገደቦች** ያሰላል፣ በጋራ ገንዳ ተቀናሽ ተደርጓል። ከክልላዊ የማንነት ማረጋገጫ በኋላ ብቻ የሚከፈቱ ኮታዎች (ዛሬ፡ ModelScope) በተነጥለው ይታያሉ፣ +~6M ከክልላዊ የማንነት ማረጋገጫ በስተጀርባ፣ እና በዋና ቁጥሩ ውስጥ በፍጹም አይደመሩም። ውጤቱ በዳሽቦርዱ ላይ (`/dashboard/free-tiers`) የሚታይ ይቆያል።

OmniRoute የነፃ-ደረጃ የበጀት ካርድ፦ ~1.62B ነፃ ቶከኖች በወር በቋሚነት፣ በመጀመሪያው ወር ከምዝገባ ክሬዲቶች ጋር እስከ ~2.22B፣ ከ34 ተመዝግበው ካሉ ተደጋጋሚ የገንዳ ቁልፎች 467 ተዘርዝረው ካሉ የነፃ-ደረጃ ግቤቶች ከአንድ endpoint በስተጀርባ። ታማኝ የገንዳ-ተቀናሽ ሂሳብ — እያንዳንዱ የጋራ ገንዳ አንድ ጊዜ ተቆጥሯል፣ የታተመ አዎንታዊ ወርሃዊ የቶከን በጀት ካላቸው 17 ተደጋጋሚ ገንዳዎች እና አምስት በሞዴል-መሰረት Groq ገደቦችን ጨምሮ፤ 12 አቅራቢዎች በውሎች-ስጋት ካታሎግ ውስጥ avoid ተብለው ተመዝግበዋል ስለዚህ እርስዎ ይወስናሉ። የበጀት አሞሌው Mistral 1B፣ Nara 210M፣ LLM7 150M፣ xKiro 150M፣ Groq 30M (አምስት በሞዴል-መሰረት ገደቦች) እና ትናንሽ ገንዳዎችን ያካትታል፣ በተጨማሪም የመጀመሪያ ወር የምዝገባ ክሬዲቶች እና በቋሚነት-ነፃ የቶከን-ገደብ የሌላቸው አቅራቢዎች በተነጥለው ቀርበዋል ስለዚህ ዋና ቁጥሩን በፍጹም አያጎድሉም። ቀጥታ የተጠቀመ/የቀረ በ /dashboard/free-tiers ላይ።

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

⭐ OMNIROUTE ገንዘብ እንዲቆጥቡ እና ሥራዎን ቀላል እንዲያደርግ ከረዳዎት ሪፖውን ኮከብ (Star) ይስጡት።

[![ኮከቦች](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) ### 💬 ማህበረሰቡን ይቀላቀሉ **👋 አስተዳዳሪውን ይከተሉ — አዲስ አቅራቢዎችን፣ ልቀቶችን እና ምክሮችን መጀመሪያ ያግኙ፦** [![ዲዬጎን በ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) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 ጌትዌዩ እያደገ ይቀጥላል

| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | ------------------------- | :----------------: | :---------: | :-------------------: | | 🌐 አቅራቢዎች | 352 | **358** | 375 | | 🧠 ልዩ የቻት ሞዴል መለያዎች | 1320 | **1374** | 1475 | | 🖼️ Modality Bridge | 🆕 እይታ + ድምጽ + ቪዲዮ | ✓ | ✓ | | 📡 Radar ነጻ ካታሎግ | 🆕 በፈቃደኝነት | ✓ | ✓ | | ⚖️ ኮታን የሚገነዘብ መርሐግብር አሠራር | 🆕 Quota-Share | ✓ | ✓ | | 📊 የኮታ ቴሌሜትሪ | 🆕 ቀጥታ | ✓ | ✓ | | 🧰 ሄድለስ ሁነታ | — | — | 🆕 `serve --headless` | | 🛤️ የ LTS ባቡር መሠረተ ልማት | — | — | 🆕 የልቀት ቻናሎች | | 🔎 የሞዴል ፍለጋ API | — | — | 🆕 `/v1/models/query` | **→ [ሮድማፕ](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
	🗜️ መጭመቂያ	🖥️ የሚሰራበት ቦታ	🔒 የግል
👀 ይመልከቱት	🎬 በተግባር	✨ አዲስ ነገር	🤖 ተኳኋኝ CLIs
💚 ድጋፍ	💚 ይደግፉ / ይለግሱ	💬 ማህበረሰብ	💖 ስፖንሰሮች
📦 ፕሮጀክት	🛠️ የቴክኖሎጂ ስብስብ	📖 ሰነዶች	👥 አስተዋጽዖ አድራጊዎች

🌐 በ67 ቋንቋዎች

## 🆓 ይጭኑ፣ አቅራቢ ያገናኙ፣ ከዚያ በአንድ endpoint በኩል ያሳልፉ

ሦስት ደረጃዎች: OmniRoute ይጭኑ እና ያስጀምሩ፣ ብቁ የሆነ አቅራቢን በራስዎ መለያ ወይም API ቁልፍ ያገናኙ፣ ከዚያ መሣሪያዎን በ OmniRoute API ቁልፍ እና ሞዴል auto በመጠቀም ወደ localhost:20128/v1 ያመልክቱ። ማሳለፍ በሚገኙ ብቁ ግንኙነቶች እና በአቅራቢ ገደቦች ላይ የተመሰረተ ነው።

```bash # አቅራቢ ካገናኙ በኋላ፣ የ OmniRoute ቁልፍዎን ከ Dashboard → Endpoints ይቅዱ: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto` ብቁ የሆነ መንገድ ያስፈልገዋል። አዲስ ጭማሪ ምንም ብቁ የሆኑ ያለ-ቁልፍ (keyless) ዒላማዎች ላይኖሩት ይችላል፣ እና ያለ-ቁልፍ አቅራቢ የሦስተኛ ወገን ደንበኞችን ሊከለክል ይችላል። `tos: avoid` ተብለው የተመዘገቡ አቅራቢዎች፣ Kiroን ጨምሮ፣ በነባሪነት ከራስ-ሰር ማሳለፊያ ይገለላሉ፤ መለያ ማገናኘት ያንን ቅንብር አይተካውም። አቅራቢ ከመምረጥዎ በፊት [የነጻ ደረጃዎች መመሪያ](docs/getting-started/FREE-TIERS-GUIDE.md) ይመልከቱ።} _{📦 ለ**Python, Node.js, PHP እና cURL** ቅጂ-ለጣፍ ፈጣን-ጅምር ስክሪፕቶች → [`examples/quickstart/`](examples/quickstart/)}

# 💥 ቃል ኪዳኑ

# 🤔 ለምን OmniRoute?

የOmniRoute የጥያቄ ፍሰት: የእርስዎ IDE ወይም CLI (Claude Code, Cursor, Cline…) አንድን አካባቢያዊ endpoint (http://localhost:20128/v1) ይጠራል; የOmniRoute ብልጥ ማሳለፊያ (RTK + Caveman compression፣ 20 የማሳለፊያ ስልቶች፣ circuit breakers፣ TLS stealth፣ MCP፣ A2A፣ guardrails) ብቁ ጤናማ ዒላማ ሳለ በ4 የአቅራቢ ደረጃዎች ላይ ምትክ ማድረግ ይችላል — ደረጃ 1 Subscription፣ ደረጃ 2 API Key፣ ደረጃ 3 Cheap እና ደረጃ 4 Free።

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

> **እንደ ክፍት ምንጭ ወዳጅ መቀላቀል ይፈልጋሉ?** እነዚህ ክፍት ምንጭን የሚደግፉና 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 ይክፈቱ፣ እኛም እዚህ እንጨምረዋለን።}

## 🎯 ጥምሮች — ዋናው ባህሪ

ከ20ዎቹ የጥምር ማዘዋወሪያ ስልቶች ውስጥ የ18ቱ እነማዊ ምሳሌዎች — ለእያንዳንዱ ስልት አንድ ሰቅ፦ priority፣ fill-first፣ weighted፣ round-robin፣ p2c፣ least-used፣ random፣ strict-random፣ cost-optimized፣ headroom፣ reset-window፣ reset-aware፣ context-relay፣ context-optimized፣ lkgp፣ auto፣ fusion፣ pipeline። cache-optimized እና quota-weighted እነማዊ አይደሉም፤ ከታች ያለው ሰንጠረዥ ሁሉንም 20 ይገልጻል።

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

የሞዴል መታወቂያ	ለማመቻቸት የሚያተኩርበት
`auto`	🎯 ሚዛናዊ ነባሪ (LKGP — ከመጨረሻው ጥሩ አቅራቢዎ ጋር ይቆያል)
`auto/coding`	🧑💻 ለኮድ ማመንጨት ጥራትን የሚያስቀድሙ ክብደቶች
`auto/fast`	⚡ በመጀመሪያ ዝቅተኛው መዘግየት
`auto/cheap`	💰 በመጀመሪያ በአንድ ቶከን በጣም ርካሹ
`auto/subscription`	🎟️ አስቀድመው የሚከፍሉበት የደንበኝነት ምዝገባ ኮታ ብቻ — ካልተሳካ ይዘጋል፤ ፈጽሞ ክፍያ ወዳለበት ምትክ አይዘዋወርም (መመሪያ)
`auto/thrifty`	🪜 በመጀመሪያ የዕቅዱን ኮታ፣ ከዚያም ደረጃ በደረጃ በጣም ርካሽ ወደሆኑት የክፍያ አማራጮች — ዕቅዱ ዳግም ከተጀመረ በኋላ ወደ ዕቅዱ ይመለሳል (መመሪያ)
`auto/offline`	🔋 በመጀመሪያ ከፍተኛው የኮታ / የፍጥነት ገደብ ትርፍ አቅም
`auto/smart`	🔭 ጥራትን በማስቀደም + የተሻሉ ሞዴሎችን ለማግኘት 10% ሙከራ
`auto/lkgp`	📌 ከመጨረሻው ጥሩ አቅራቢ ጋር በግልጽ መጣበቅ
`auto/chaos`	🧪 ወደ ሞዴሎች ፓነል በትይዩ መበተን (ከእያንዳንዱ አቅራቢ አንድ፣ በነባሪ 5)፤ አንድ መልስ ይመልሳል፤ ለእያንዳንዱ የፓነል ሞዴል አንድ ወደላይ የሚላክ ጥሪ እንጂ የብልሽት ማስገቢያ አይደለም

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

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

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

የOmniRoute የብልሽት መቋቋም ችሎታ — 3 ነጻ ራስን ፈዋሽ ንብርብሮች፣ ለእያንዳንዱ ብልሽት ትክክለኛው ንብርብር። ንብርብር 1፦ የአቅራቢ circuit breaker (መላው አቅራቢ)፦ የሚቋረጠው በ408/5xx ላይ ብቻ ሲሆን፣ ገደቦቹ OAuth 8× / API-key 12× / local 2× ናቸው፤ ከ60s/30s/15s በኋላ ወደ HALF-OPEN ሙከራ ይመለሳል፣ እንደ አስፈላጊነቱ ይልማል፤ OPEN ሆኖ ሳለ comboው ወደ ቀጣዩ አቅራቢ መንገዱን ይቀይራል። ንብርብር 2፦ የግንኙነት cooldown (አንድ ቁልፍ/መለያ)፦ መነሻው OAuth 5s / API-key 3s ሲሆን፣ ከተደራራቢ ጥያቄዎች መጨናነቅ መከላከያ ጋር በ×2 የሚጨምር የመጠባበቂያ ጊዜ አለው፤ 429 Retry-Afterን ያከብራል፣ ስኬት ሁሉንም የስህተት ሁኔታዎች ያጸዳል፤ በcooldown ላይ ያለ አንድ ቁልፍ ይታለፋል፣ ተጓዳኝ ቁልፎቹ ግን አገልግሎት መስጠታቸውን ይቀጥላሉ። ንብርብር 3፦ የሞዴል lockout (አንድ ሞዴል)፦ በሞዴል የሚከሰት 429፣ local 404 ወይም የmode እገዳዎች ያንን ሞዴል ብቻ ይቆልፋሉ — መላውን ግንኙነት ፈጽሞ አይቆልፉም። የመጨረሻ ሁኔታዎች (የታገደ፣ ጊዜው ያለፈ፣ ክሬዲቱ ያለቀ) ለኦፕሬተሩ የሚተዉ ናቸው፣ cooldowns አይደሉም።

_{📖 [የAuto-Combo ሞተር](docs/routing/AUTO-COMBO.md) · [የብልሽት መቋቋም መመሪያ](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 OmniRouteን ልዩ የሚያደርገው

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

⭐ ማከማቻውን በኮከብ ይመዝግቡ	ነጻ — ታይነቱን በእውነት ይረዳል	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.53** በቅርብ ዘመን ዋና ዋና ለውጦች። ሙሉ ታሪኩ በ[`CHANGELOG.md`](CHANGELOG.md) ይገኛል። - **⚖️ `quota-weighted` ማስተላለፊያ** — የ20ኛው የኮምቦ ስትራቴጂ ያልቁ የሆኑ መለያዎችን ይለማመዳል፣ ከዚያ በቀሪው ኮታ ÷ በመንገድ ላይ ያለ ጭነት አኳኋን በተቀሩት መካከል ይመረጣል፣ ካሉአቸው ውይይቶች ጋር ተያይዘው እንዲቆዩ ያደርጋል። → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 የራስ-አልባ ሁኔታ** — `omniroute serve --headless` (ወይም `OMNIROUTE_HEADLESS=1`) `/v1/*` የፕሮክሲ ሞተርን ብቻ ያስነሳል፣ ዳሽቦርድ እና የዳሽቦርድ-ብቻ ንዑስ ስርዓቶች ዝም ይላሉ። → [የራስ-አልባ ሁኔታ](docs/guides/HEADLESS.md) - **🔎 የሞዴል ፍለጋ** — `/v1/models` በአቅም፣ በኮንቴክስት፣ በአይነት እና በጽሑፍ ያጣራል፣ እና `POST /v1/models/query` በእያንዳንዱ ቁልፍ ታይነት ጋር አንድ አጭር እና ተወሳኝ የተመረጠ ዝርዝር ይመልሳል። → [API ማጣቀሻ](docs/reference/API_REFERENCE.md) - **🔑 በእያንዳንዱ ቁልፍ የማስተላለፊያ ቁጥጥር** — የአንድ API ቁልፍ ከአንድ ሞዴል ወይም ኮምቦ ጋር በ`forcedModel` ያስገድዱት፣ እና የአንድ ቁልፍ ሞዴሎችን እና ኮምቦዎችን በአቶሚክ ያክሉ ወይም ያስወግዱ (`/api/keys/{id}/access` በኩል)። → [API ማጣቀሻ](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ የተሻሻሉ PII ቁጥጥሮች** — በአይነቱ ምርጫ፣ እስከ 20 ድረስ የተረጋገጡ ልዩ የማስደበቂያ (masking) ስነ-ሥርዓቶች እና በአይነቱ የመገኘት ቆጣሪዎች፤ ማስደበቂያው ራሱ በገዛ ፈቃድ (opt-in) እንደሆነ ይቆያል። → [መከላከያዎች](docs/security/GUARDRAILS.md) - **🌍 67 ቋንቋዎች** — ዳሽቦርድ፣ የሰነድ ሚራሮች እና CLI፣ `npm run i18n:add-locale` በአንድ ትእዛዝ በሁሉም ቦታ ቋንቋ ያክላል። → [i18n መመሪያ](docs/guides/I18N.md) - **🎛️ OmniConductor** — ወደ የእርስዎ ወኪል ቡድን የሚገባ A2A ስልጣን ማስተላለፍ፣ በAgent Card ላይ የConductor ክህሎቶች፣ እና ከFaro push-to-talk የድምፅ ውይይት ጋር የዳሽቦርድ ፓነል። → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 ተስማሚ ተቀባይነት እና የጭምር ጭንመት ጥበቃ** — ከባድ የውይይት ጥያቄዎች 503 መልስ በመስጠት ፈንታ በወረፋ ይጠብቃሉ፣ ከእያንዳንዱ ግንኙነት ጋር አቶሚክ RPM የሚጠራሩ ኪራዮች ተጠቅሟል። → [የመቋቋም መመሪያ](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ መደበኛ `/v1/models` ደረጃ አቀማመጥ** — ለእያንዳንዱ አቅራቢ አንድ ተያያዥ የአቅራቢ ቡድን አገናኝ (ኮምቦዎች መጀመሪያ ተሰክረው)፣ በሁሉም የካታሎግ ምንጮች ዘላቂ። → [API ማጣቀሻ](docs/reference/API_REFERENCE.md) - **🗜️ የመጭመቂያ ጥንካሬ** — በነባሩ የሚበራ የማራዘሚያ (inflation) ጠባቂ፣ ለDE / FR / JA + ቻይንኛ (wényán) የCaveman ጥቅሎች፣ ለGradle እና .NET የRTK ማጣሪያዎች። → [መጭመቂያ](docs/compression/COMPRESSION_ENGINES.md) - **💸 እውነተኛ የቋሚ ተመን ዋጋ** — subscription / coding-plan አቅራቢዎች በዋጋ ትንታኔ ውስጥ **$0** ያነባሉ፣ በጀት፣ ኮታ እና ማስተላለፊያ ግምት መስጠቱን ይቀጥላሉ። → [API ማጣቀሻ](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share ማስተላለፊያ** — የጋራ መለያ ኮታ በድምሩ የተደራረቡ ቁልፎች መካከል በትክክል ይከፋፈላል፣ ስራን በማይበላሽ መንገድ ያልተጠቀሙት ክፍሎች ይተዋወቃሉ። → [የመቋቋም መመሪያ](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 በአንድ ትእዛዝ CLI/agent ማዋቀር** — 15 የተመዘገቡ `setup-*` ትእዛዞች፤ `omniroute run` 7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ያስነሳል፤ `omniroute configure` ከ11 ግቦች ጋር በተግባር የሚሰራ provider+model picker እና በእያንዳንዱ ሁኔታ ተወዳጆችን ያገናኛል። → [CLI ትዋሃዶች](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ የርቀት ሁኔታ** — የርቀት OmniRoute ከወሰኑ ወሰኖች (scopes) ያላቸው ቶከኖች (`connect` / `contexts` / `tokens`) ያስናኑ፣ ለVPS ጭነቶችም `antigravity` OAuth ረዳት ይጠቀሙ። → [የርቀት ሁኔታ](docs/guides/REMOTE-MODE.md) - **🧭 የተሻሻለ ራስ-ሰር ማስተላለፊያ** — `auto/:` ኮምቦዎች፣ **Fusion** (የሞዴል ፓነል + ዳኛ)፣ በተግባር የሚረዳ ማስተላለፊያ (task-aware routing)፣ በእያንዳንዱ ጥያቄ ሞዴል / ሁኔታ / USD-በጀት መተካቾች። → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ የሚገጠመ compression** — 12 የሚዋሃዱ ሞተሮች + Compression Studios፦ LLMLingua-2፣ two-tier Ultra፣ omniglyph፣ per-step fidelity gate፣ GCF v3.2፣ drag-reorder editor። → [መጭመቂያ](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ በግልጽ MITM decrypt (TPROXY)** — proxy env vars የሚያረሙ CLIs ያገናኙ፣ ከእያንዳንዱ SNI CA + trust-store installer ጋር። → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 ዋጋ telemetry በሁሉም ቦታ** — `X-OmniRoute-*` የዋጋ/አጠቃቀም headers በእያንዳንዱ endpoint ላይ፣ cache-HIT savings header፣ በእያንዳንዱ ቁልፍ USD የወጪ ኮታዎች። → [API ማጣቀሻ](docs/reference/API_REFERENCE.md) - **🧠 እርስዎ የሚቆጣጠሩት ማህደረ ትውስታ** — በነባሩ ጠፍቷል፣ በገዛ ፈቃድ (opt-in) int8 vector quantization + typed decay፣ በእያንዳንዱ ጥያቄ `x-omniroute-no-memory`። → [ማህደረ ትውስታ](docs/frameworks/MEMORY.md) - **🛡️ ደህንነት** — በእያንዳንዱ LLM route ላይ prompt-injection ጠባቂ (red-team suite)፣ በገዛ ፈቃድ (opt-in) credential-masking guardrail (የተፋሰሱ API keys/secrets በሁለቱም አቅጣጮች ያጠፋል)፣ ነፃ DuckDuckGo የመጨረሻ አማራጭ ድር ፍለጋ፣ እና ለዳሽቦርድ አማራጭ OIDC login gate (የይለፍ ቃል መግባት ሁልጊዜ ይገኛል)። → [መከላከያዎች](docs/security/GUARDRAILS.md) - **🖼️ አዲስ endpoints** — `/v1/ocr` (Mistral OCR) እና `/v1/audio/translations` (Whisper-style) የሚዲያውን ወለል ያጠናቅቃሉ። → [API ማጣቀሻ](docs/reference/API_REFERENCE.md) - **🎨 የምስል / ቪዲዮ / ድምፅ መፍጠሪያ** — አንድ API ለሚዲያ፦ xAI Grok Imagine እና Novita AI video፣ 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 login ጋር፣ የOllama first-class card፣ Claude Opus 5 እና Sonnet 5፣ የKimi ኦፊሴላዊ አጋርነት (Code/Web/Moonshot)፣ Zed፣ Requesty፣ SenseNova፣ Yuanbao፣ Agnes AI… እና የተቀየሰ **375-አቅራቢ ካታሎግ**። → [አቅራቢዎች](docs/reference/PROVIDER_REFERENCE.md) - **📡 የማስተላለፊያ ግልጽነት** — ከየምላሹ ጋር `X-OmniRoute-Decision` header ይከተላል፣ አገልግሎት የሰጠውን strategy/provider/latency ይሰይማል፣ አዲስ `cache-optimized` combo strategy + Auto-Combo `cacheAffinity` ምክንያት ተደጋጋሚ ጥያቄዎችን ወደ ካሺዱ prefix የያዘው ግንኙነት ይመልሳል፣ እና ለእንባቆም (read-only) የሆነ `/v1/auto-combo/{channel}/candidates` endpoint የ`auto/*` channel የቀጥታ እጩዎችን መደብ ያጋልጣል። → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ የአካባቢ አፈጻጸም እና መሠረተ ልማት** — በአንድ ጠቅታ የሚጀምር የአካባቢ Redis፣ የ Cloudflare Workers / Deno Deploy ሪሌይ ማሰራጫዎች፣ Bifrost እና Mux እንደ ተቆጣጣሪ ያላቸው የተካተቱ አገልግሎቶች። → [የተካተቱ አገልግሎቶች](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 እንዲሁም በሳጥኑ ውስጥ** — የፕላጊን ማዕቀፍ + ገበያ ቦታ፣ የ Omni/Agent/GitHub ክህሎት ማዕቀፎች፣ የ Obsidian vault ውህደት (22 MCP መሣሪያዎች)፣ ከ OpenAI ጋር የሚጣጣሙ Batch እና Files APIዎች፣ የስማንቲክ ምላሽ ካሽ፣ ከአሸናፊዎች ሰሌዳ ጋር ያለ ጌሚፊኬሽን፣ የ ACP ወኪሎች ግኝት (15 የተገነቡ ወኪሎች)፣ በመርሐግብር የተያዘ የመዝገብ ላክ ወደ BigQuery፣ `auto/chaos` ትይዩ ብዙ-ሞዴል ስርጭት፣ የ Telegram ቦት ድልድይ፣ የመተግበሪያ ውስጥ የስሪት አስተዳዳሪ እና የ 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-ተኳኋኝ መሣሪያ

_{📖 ለሁሉም 37 መሣሪያዎች (27 CLI Code's + 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 5dive ``` እያንዳንዱ ትዕዛዝ ገባሪውን የርቀት አውድ (`omniroute connect `) ያከብራል፣ `--dry-run` ሳይፈጽም ትክክለኛዎቹን env/args አስቀድሞ ያሳያል፣ እና `--api-key-env NAME` ምስጢሮችን ከshell ታሪክዎ ውጭ ያቆያል። → [የCLI ውህደቶች](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 375 AI አቅራቢዎች — 153 በካታሎግ ነፃ የተመለከቱ

> **375 የተመዘገቡ አቅራቢዎች** በካኖኒካል የቻት፣ ሚዲያ፣ ፍለጋ፣ አካባቢያዊ፣ የደመና-ወኪል እና የስርዓት ስብስቦች ውስጥ፣ ከእነዚህም መካከል **`hasFree: true` የግኝት ሜታዳታ የሚሸከሙ 153** ናቸው። የቻት ሞዴል ምዝገባ **239 አቅራቢዎች / 3,059 የተለዩ የአቅራቢ-ሞዴል ጥንዶች / 1,475 ጥሬ ሞዴል መለያዎች** ይሸፍናል፤ የተለየው የነፃ-በጀት ካታሎግ **467 በእያንዳንዱ ሞዴል ረድፎች**፣ **34 ተደጋጋሚ ፑሎች** እና **51 ተደጋጋሚ/ያለ-ቁልፍ ለዘላለም-ነፃ አቅራቢዎች** አሉት። እነዚህ በእቅድ የተለያዩ ማካለያዎች ናቸው፤ ትርጉሞች እና ፑል-ድግግሞሽ-የተካቸው ስሌቶች በ[የአቅራቢ ማጣቀሻ](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

_{…እና 350+ ተጨማሪ — እያንዳንዱ አዶ በቀጥታ ከዳሽቦርዱ የአቅራቢ ካታሎግ ይፈታል። 📖 [የአቅራቢ ማጣቀሻ](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 የአንድ ጊዜ $5 ክሬዲት; ካርድ ያስፈልጋል}	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 # ጌትዌይን + ዳሽቦርድን ያስተናግዱ (ፖርት 20128) omniroute chat # መስተጋብራዊ TUI የውይይት ደንበኛ (ስላሽ፦ /model /combo /skill /memory) omniroute setup # የመጀመሪያ አጠቃቀም የሚመራ አዋቂ omniroute doctor # አቅራቢዎችን፣ ፖርቶችን፣ ቤተኛ ጥገኞችን ይመርምሩ ``` ### 🛰️ የርቀት ሁነታ — CLI-ውን እዚህ ያስኪዱ፣ OmniRouteን በVPS ላይ ያስቀምጡ OmniRoute በአገልጋይ ላይ አለ? **ተመሳሳዩን CLI** በመጠቀም ከላፕቶፕዎ ያንቀሳቅሱት። የተወሰነ ወሰን ባለው የመዳረሻ ቶከን አንድ ጊዜ ይግቡ፤ ከዚያ በኋላ እያንዳንዱ ትዕዛዝ የርቀት አገልጋዩን ያነጣጥራል። ```bash omniroute connect 192.168.0.15 # የይለፍ ቃል → የተወሰነ ወሰን ያለው ቶከን፣ እንደ አውድ ይቀመጣል omniroute models # ← በርቀት አገልጋዩ ላይ ይሰራል omniroute configure codex # ← የርቀት ሞዴል ይመርጣል፣ አካባቢያዊ የCodex መገለጫ ይጽፋል omniroute tokens create --name ci --scope read # ለሌሎች ማሽኖች ይበልጥ የተገደቡ ቶከኖችን ያመንጩ omniroute contexts use default # ← ወደ አካባቢያዊ አገልጋዩ ይመለሱ ``` ቶከኖች `read` / `write` / `admin` በሚሉ ወሰኖች የተከፋፈሉ ናቸው፤ ሂደት የሚጀምሩ መስመሮች ለloopback ብቻ የተገደቡ ሆነው ይቆያሉ። _{📖 [የርቀት ሁነታ](docs/guides/REMOTE-MODE.md)}

የOmniRoute CLIን የሚያሳይ እነማዊ የተርሚናል ማሳያ — omniroute providers list፣ omniroute combo list እና omniroute health — በ89 ትዕዛዞች ያሉትን ከፍተኛ-ደረጃ በይነገጽ እየዞረ ያሳያል፦ 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** በኩል ያቅርቡ — ማንኛውም ብቃት ያለው ወኪል (ወይም የራስዎ ኮድ) ሙሉውን ጌትዌይ፦ መስመር ማስያዝን፣ አቅራቢዎችን፣ ጥምረቶችን፣ መሸጎጫን፣ ማመቅን፣ ማህደረ ትውስታን — በራስ-ሰር ለመቆጣጠር ቁልፎቹን ያገኛል። ከታች ያሉት 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 ጋር ተኳኋኝ — ውይይት፣ መክተቶች፣ ምስሎች፣ ድምጽ፣ OCR
🔔 Webhooks	`/api/webhooks`	የጥያቄ / የኮታ ክስተቶችን ወደ Slack፣ Discord፣ Telegram ወይም ማንኛውም URL ይላኩ
🛰️ የርቀት CLI	`omniroute connect`	የተወሰነ ወሰን ባላቸው የመዳረሻ ቶከኖች የርቀት ኢንስታንስን ያንቀሳቅሱ

```bash # ለClaude Code ሙሉውን የOmniRoute መሳሪያ ስብስብ በMCP በኩል ይስጡ፦ 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 compression pipeline፡ የሚያስረዳ 10,000-ቶከን የክሊያንት ጥያቄ በ 12 የሚባባሱ ሞተሮች ያልፋል — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra እና OmniGlyph — በሰነድ የቀረበው የተደረደረ ምሳሌ ውስጥ በግምት 1,080 ቶከኖች አቅራቢውን ሊደርስ ይችላል። የተቋቋመ ይዘት በ preservation guards እና በእያንዳንዱ ደረጃ fidelity gates የተጠበቀ ነው; ተገልጣዊ lossy ወይም የሙከራ ሁነታዎች ብቁ ይዘትን ሊቀይሩ ይችላሉ።

የ OmniRoute compression pipeline፡ የሚያስረዳ 10,000-ቶከን የክሊያንት ጥያቄ በ 12 የሚባባሱ ሞተሮች ያልፋል — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra እና OmniGlyph — በሰነድ የቀረበው የተደረደረ ምሳሌ ውስጥ በግምት 1,080 ቶከኖች አቅራቢውን ሊደርስ ይችላል። የተቋቋመ ይዘት በ preservation guards እና በእያንዳንዱ ደረጃ fidelity gates የተጠበቀ ነው; ተገልጣዊ lossy ወይም የሙከራ ሁነታዎች ብቁ ይዘትን ሊቀይሩ ይችላሉ።

ነባሪ የተደረደረ ድብልቅ `RTK → Caveman` ያስኪያል። ሁለቱም በተመሳሳይ tool/context payload ላይ ሲሰሩ፣ ቁጠባዎች ይጨምራሉ፦ ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` የኮድ ብሎኮች፣ ዩአርኤሎች፣ JSON እና የተቋቋመ ውሂብ በ preservation engine **ሁልጊዜ የተጠበቁ** ናቸው። > **በጥቂት ቶከኖች ሥራው ሲሰራ ብዙ ቶከኖችን ለምን መጠቀም?** እያንዳንዱ ጥያቄ በ OmniRoute compression pipeline **በግልጽ** ያልፋል — ከክሊያንት መቀየር የለም። አሁን **12 የሚባባሱ ሞተሮች ክምር** ነው፣ እነሱም በትክክለኛው ቅደም ተከተል የሚሄዱ እና በእያንዳንዱ routing combo የሚመረጡና የሚዛመዱ — ከ [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-ሞተሩ ክምር ሞተሮች በpipeline ቅደም ተከተል ይሄዳሉ; እያንዳንዱ በራሱ ሊብረደድ እና ሊዋቀር የሚችል ነው፦

#	ሞተር	ምን እንደሚሰራ
1	Session-Dedup	በዙሮች ውስጥ የተደገመ ይዘት ያስወግዳል (በይዘት-አድራሻ፣ በመሐከል ዙር)
2	CCR	ትላልቅ ብሎኮችን ከመልሶ ለማግኘት ማርከሮች በስተጀርባ ያስቀምጣል፣ በጥያቄ ሰዓት ይወሰዳል
3	Lite	ክፍተት + የምስል-URL መቁረጥ (ዝቅተኛ መዘግየን መሠረት)
4	RTK	ብልህ የመሣሪያ ውጤት ማጣራት፣ dedup እና መቁረጥ (ትእዛዝ-አዋቂ)
5	Responses Tool Output	Lossless-first JSON + የተወሰነ የምርመራ መጭመቅ ለ shell/patch/search/build ውጤቶች (Responses API)
6	Headroom	Lossless የሠንጠረዥ መጭመቅ የ JSON arrays (~30%) በተካተተ GCF codec
7	Relevance	በመጨረሻው የተጠቃሚ ጥያቄ ላይ በተመሠረተ extractive sentence scoring
8	Caveman	በመመሪያ ላይ የተመሠረተ የተረኛ ጽሑፍ መጭመቅ (~65–75% በውጤት ላይ)
9	Aggressive	ማጠቃለል + የድሮ ዙሮች ተከታታይ መድከም
10	LLMLingua-2	ML semantic pruning በ MobileBERT ONNX — code-safe, async
11	Ultra	Heuristic token pruning ከአማራጭ small-model (SLM) ደረጃ ጋር
12	OmniGlyph	የሙከራ context-as-image encoding ለ Claude Fable 5 በቀጥታ Anthropic wire ላይ; GPT 5.6 transformers fail-closed ይቆያሉ እስከ አቅራቢው ማረጋገጫዎች ይጠብቃሉ። አራት compression profiles (aggressive default, balanced, coding-safe, passthrough) (ከፍተኛው aggressive; opt-in)

የኮድ ብሎኮች፣ ዩአርኤሎች እና የተቋቋመ ውሂብ **ሁልጊዜ በባይት ደረጃ ትክክለኛ** ይጠብቃሉ። **አንድ-ጠቅታ ቅድመ-ቅንብሮች** ሞተሮቹን ያጣምራሉ፦

ሁነታ	ቁጠባ	ለምን እንደሚሆን በጣም ጥሩ
🪶 Lite	~15%	ሁልጊዜ የተቀናበረ ደህንነቱ የተጠበቀ ነባሪ
🪨 Standard (Caveman)	~30%	ዕለታዊ ኮዲንግ
⚡ Aggressive	~50%	ረጅም እና በመሣሪያ የበለፀጉ ክፍለ-ጊዜያት
🔥 Ultra	~75%	ከፍተኛ ቁጠባ
🧰 RTK	60–90%	Shell/test/build/git ውጤት
🔗 Stacked (RTK → Caveman)	78–95%	የተቀላቀሉ prompts + የመሣሪያ ምዝግብ ማስታወሻዎች

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

# ⚡ ፈጣን ጅምር

**1) ይጫኑ እና ያሂዱ** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` ወይም የpeer-dep ማስጠንቀቂያዎችን አይተዋል? [አደገኛ አይደሉም](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated)። > **npm 11 ወይም ከዚያ በላይ ይጠቀማሉ?** npm እስካልተፈቀዱ ድረስ የፓኬጅ ህይወት-ዑደት ስክሪፕቶችን ሊከለክል ይችላል። የOmniRoute `postinstall` (`node scripts/build/postinstall.mjs`) የኔቲቭ ሰራት ፋይሎቹን ለማዘጋጀት ያስፈልጋል። በአለም አቀፍ ሲጭኑ በnpm ማስጠንቀቂያ ውስጥ የተጠቀሱትን ፓኬጆች ይፍቀዱ። በOmniRoute 3.8.53 የተዘገበው የፓኬጅ ስብስብ: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > ይህንን የፍቃድ ዝርዝር ለወደፊት አለም አቀፍ ጭቃጭቆች እንደገና ለመጠቀም አንድ ጊዜ ያዋቅሩት፣ ከዚያ በተራ ሁኔታ ይጫኑ: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > የጥገኝነት ዝርዝሩ በልቀቶች መካከል ሊለወጥ ይችላል; npm የተለየ ዝርዝር ካመለከተ፣ ከዚያ ማስጠንቀቂያ የፓኬጅ ስሞችን ይጠቀሙ። ፓኬጅ መፍቀድ የጭቃጭቆ ስክሪፕቶቹ እንዲሠሩ ይፈቅዳል። > **Gemini Web ወይም ሌላ የድር-ኩኪ አቅራቢ ይጠቀማሉ?** የnpm ፓኬጁ Playwrightን > ያካትታል ግን የChromium ባይነሪውን አይደለም። የመጀመሪያውን የድር-አቅራቢ ጥያቄ ከመላክዎ በፊት > [የPlaywright Chromium ገጽታ](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > ማስታወሻውን ይመልከቱ። ዳሽቦርድ በ`http://localhost:20128` · API በ`http://localhost:20128/v1`። **2) ብቁ አቅራቢን በራስዎ መለያ ያገናኙ** ዳሽቦርድ → **አቅራቢዎች** → የአሁኑ ውሎች እና ኮታ ለእርስዎ አጠቃቀም ጉዳይ የሚስማማ አቅራቢ ይምረጡ → የAPI ቁልፉን ያክሉ ወይም የመለያ ፍሰቱን ያጠናቅቁ። ነፃ ደረጃዎች ምዝገባ፣ ፈቃድ ወይም የክፍያ ዘዴ ሊጠይቁ ይችላሉ። [የነፃ ደረጃዎች መመሪያ](docs/getting-started/FREE-TIERS-GUIDE.md)ን ይመልከቱ; ያለ ቁልፍ ተገኝነት አይረጋገጥም፣ እና `tos: avoid` ተብለው የተለጠፉ አቅራቢዎች በነባሪነት ከ`auto` ይቀራሉ። **3) የኮዲንግ መሣሪያዎን ያቅኑ** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) እየሠራ መሆኑን ያረጋግጡ** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` የተገናኙትን ሞዴሎች ተዘርዝረው ማየት አለብዎት። 🎉 ሁሉም ተጠናቋል — መኮድ ይጀምሩ፣ OmniRoute በራስ-ሰር ያዘዋውራል እና ለእርስዎ ይተካካል። ደንበኛዎ ብጁ ራስጌዎችን መላክ ካልቻለ፣ OmniRoute እንዲሁም ቶከን-ተሰጥቶባቸዋል የሚጣጣም ተተኪዎችን ይጋልጣል: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` እነዚህን `Authorization: Bearer ...` ማያያዝ ለማይችሉ ደንበኞች ብቻ ይጠቀሙ። የራስጌ ማረጋገጫ የሚመረጥ ሁነታ ይቆያል።
## 📦 ተጨማሪ የመጫኛ ዘዴዎች — 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-10-18 · ጥሬ ካታሎግ፦ YT 1.352 | TT 334 | IG 290 · ወቅታዊነት (ቀናት)፦ YT 5 | TT 48 | IG 49}

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

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 እይታዎች}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 እይታዎች}

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

🎬 #5 — TikTok
_{migue.baena — 685,788 እይታዎች}

**ሙሉ ደረጃ አሰጣጥ (የተደጋገሙት የተወገዱ ቀኖናዊ URLs፣ `v > 0`፣ ከፍተኛ ተደራሽነት)፦** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | በ2026-10-18 ያሉ ቀኖናዊ መለኪያዎች፦ **1.976 ልዩ ቪዲዮዎች** · **20.220.289 የታወቁ እይታዎች** (`v > 0`) · **1.210 ቻናሎች/መገለጫዎች በኔትወርክ**። ጥሬው ዳሽቦርድ 1.976 ረድፎችን ይዟል (YouTube 1.352 = 740 ረጅም ቪዲዮዎች + 612 Shorts · TikTok 334 · Instagram 290)፤ በቀኖናዊ URL መደበኛነት ከተከናወነ በኋላ ምንም የተደጋገመ መዝገብ አልቀረም፣ ይህም ለእያንዳንዱ ቪዲዮ ከፍተኛውን ቆጠራ ይይዛል። የYouTube ውሂብ ስብስብ ከ2026-10-13 ጀምሮ ቆሟል (ከ14 እስከ 18/10 የAPI ኮታው አልቋል)፣ የTikTok/Instagram ደግሞ ከ2026-09-02 ጀምሮ ቆሟል (የውሂብ ስብስብ ክሬዲት የለም)፤ 76 ቪዲዮዎች አሁንም የእይታ ቆጠራ የላቸውም። > 🎬 **ስለ 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 በ`src/` እና `open-sse/` ላይ (ከ v2.0 ጀምሮ በኮር ውስጥ ምንም `any` የለም)
ፍሬምወርክ	Next.js 16 + React 19 + Tailwind CSS 4
ዳታቤዝ	better-sqlite3 (SQLite፣ WAL ጆርናሊንግ) + LowDB (JSON ነባር) — 147 የጎራ ሞጁሎች፣ 209 ማይግሬሽኖች
ማህደረ ትውስታ	SQLite FTS5 ሙሉ-ጽሑፍ + በ int8 የተቀነሱ የቬክተር ኢምቤዲንግዎች፣ ዓይነት-የተሰየመ መቀነስ
ስኪማዎች	Zod 4 — የ MCP መሣሪያ I/O ማረጋገጫ + የ API ውሎች
ፕሮቶኮሎች	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
ስትሪሚንግ	ከሰርቨር የተላኩ ክስተቶች (SSE) + WebSocket ድልድይ (`/v1/ws`)
ግፊት	12-ሞተር ፓይፕላይን — RTK፣ Caveman፣ LLMLingua-2 (MobileBERT ONNX)፣ GCF፣ OmniGlyph
ማረጋገጫ እና ደህንነት	OAuth 2.0 (PKCE) + JWT + API ቁልፎች + MCP ስኮፕ ያለው ማረጋገጫ · AES-256-GCM በማከማቻ ላይ · DOMPurify
ስውርነት	wreq-js — JA3 / JA4 TLS የጣት አምሳያ ማስመሰል፣ 3-ደረጃ ፕሮክሲ
መቋቋም	ሰርኪት ብሬከር፣ ኤክስፖኔንሺያል ባክኦፍ፣ ፀረ-thundering-herd፣ ራስ-ሰር ኮምቦ ራስ-መፈወስ
ምዝገባ	pino — የተዋቀሩ JSON ምዝገባዎች ከጥያቄ አውድ ጋር
ሙከራ	Node.js የሙከራ አሂድ + Vitest — 56,000+ የስታቲክ ሙከራ መግለጫዎች በ 7,800+ የሚከታተሉ የሙከራ ፋይሎች ላይ (ዩኒት፣ ውህደት፣ E2E፣ ደህንነት፣ ኢኮስስተም)
መድረኮች	ዴስክቶፕ (Electron) · Android (Termux) · PWA (ማንኛውም አሳሽ)
CI/CD	GitHub Actions — በራስ-ሰር npm ማተም + Docker Hub በሚለቀቅበት ጊዜ
አገናኞች	ድረ-ገጽ · npm · Docker Hub

## 📖 ሰነዶች

### 📘 መጀመሪያ

ሰነድ	መግለጫ
የተጠቃሚ መመሪያ	አቅራቢዎች፣ ኮምቦዎች፣ የCLI ውህደት፣ መሰማራት
የማዋቀር መመሪያ	ሙሉ የመጫኛ ዘዴዎች፣ የCLI መሣሪያ ማዋቀሪያዎች፣ የፕሮቶኮል ማዋቀር፣ የtimeout ማስተካከያ
የCLI መሣሪያዎች መመሪያ	ለClaude Code፣ Codex፣ Cursor፣ Cline፣ OpenClaw፣ Kilo፣ Copilot በእያንዳንዱ መሣሪያ ማዋቀር
የሩቅ ሁነታ	ሩቅ የሆነ OmniRoute (VPS) ከላፕቶፕዎ CLI በተገደበ የመዳረሻ ቶከኖች ይግፉት
የClaude Code ማዋቀሪያ	Claude Codeን ወደ OmniRoute (አካባቢያዊ/ሩቅ) በ`launch` + በእያንዳንዱ ሞዴል ፕሮፋይሎች ያቅኑ
ፈጣን ጅምር	በ3 ደረጃዎች መጫን → ግንኙነት → ማዋቀር

### 🔧 ክዋኔዎች እና መሰማራት

ሰነድ	መግለጫ
የDocker መመሪያ	Docker run፣ የCompose ፕሮፋይሎች፣ Caddy HTTPS፣ ማውጫዎች (tunnels)፣ የምስል መለያዎች
የPodman መመሪያ	Quadlet systemd ውህደት፣ podman-compose፣ SELinux
የVM መሰማራት	ሙሉ መመሪያ: VM + nginx + Cloudflare ማዋቀር
Fly.io መሰማራት	ወደ Fly.io በቋሚ ማከማቻ ይሰማሩ
የTermux መመሪያ	OmniRouteን በAndroid ላይ በTermux ያሂዱ
የPWA መመሪያ	የProgressive Web App መጫኛ፣ caching፣ አርክቴክቸር
የማስወገድ መመሪያ	ለሁሉም የመጫኛ ዘዴዎች ንጹህ ማስወገድ
የአካባቢ ማዋቀሪያ	ሙሉ የ`.env` ተለዋዋጮች እና ማጣቀሻዎች

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

ሰነድ	መግለጫ
አርክቴክቸር	የስርዓት አርክቴክቸር፣ የውሂብ ፍሰት እና ውስጣዊ አካላት
የመጨፍለቅ መመሪያ	የ7-አማራጭ pipeline: off / lite / standard / aggressive / ultra / RTK / stacked
RTK መጨፍለቅ	የትእዛዝ-ውጤት መጨፍለቅ፣ ማጣሪያዎች፣ እምነት፣ ማረጋገጥ፣ የጥሬ-ውጤት ማግኛ
የመጨፍለቅ ሞተሮች	Caveman፣ RTK፣ stacked pipelines፣ dashboard/API/MCP ገጽታዎች
የመጨፍለቅ ህጎች ቅርጸት	የJSON rule-pack schemas ለCaveman እና RTK ማጣሪያዎች
የመጨፍለቅ የቋንቋ ጥቅሎች	የቋንቋ መለያ እና የCaveman rule-pack ማዘጋጀት
የመቋቋም መመሪያ	Circuit breakers፣ cooldowns፣ ወሰፍ (queue)፣ anti-thundering herd፣ TLS spoofing
Auto-Combo ሞተር	16-ምክንያት ውጤት ሰጪ፣ የሁነታ ጥቅሎች፣ ራስ-ማገገም
የፕሮክሲ መመሪያ	የ3-ደረጃ ፕሮክሲ ስርዓት፣ 1proxy ገበያ፣ registry CRUD
ነፃ ደረጃዎች	የተዋሃደ ማውጫ: 34 የተሰነዱ ተደጋጋሚ ገንዳዎች / 467 የተመዘገቡ ነፃ-ደረጃ ግቤቶች
የባህሪያት ማዕረግ	የእይታ ዳሽቦርድ ጉብኝት ከስክሪን ሾቶች ጋር
የኮድቤዝ ሰነዶች	ለጀማሪዎች ምቹ የኮድቤዝ ጉብኝት

### 🤖 ፕሮቶኮሎች እና APIs

ሰነድ	መግለጫ
የAPI ማጣቀሻ	ሁሉም endpoints ከምሳሌዎች ጋር
የOpenAPI ስፔክ	የOpenAPI 3.0 ስፔሲፊኬሽን
የMCP ሰርቨር	110 የMCP መሣሪያዎች፣ የIDE ማዋቀሪያዎች፣ Python/TS/Go ደንበኞች
የMCP ሰርቨር መመሪያ	የMCP መጫኛ፣ transports፣ እና የመሣሪያ ማጣቀሻ
የA2A ሰርቨር	የJSON-RPC 2.0 ፕሮቶኮል፣ ችሎታዎች፣ streaming፣ የስራ አስተዳደር
የA2A ሰርቨር መመሪያ	የA2A ወኪል ካርድ፣ ስራዎች፣ ችሎታዎች እና streaming

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

ሰነድ	መግለጫ
አስተዋጽኦ	የልማት ዝግጅት እና መመሪያዎች
የቅርንጫፍ እና የልቀት ሞዴል	PRs የሚለዩበት ቦታ (`release/*`)፣ `main` እና መለያዎች ምን ማለት እንደሆኑ
የለውጥ መዝገብ	ሙሉ የእያንዳንዱ ስሪት የልቀት ታሪክ
የደህንነት ፖሊሲ	የደህንነት ስጋት ሪፖርት ማድረግ እና የደህንነት ልምዶች
የ i18n መመሪያ	የ67 ቋንቋዎች ድጋፍ፣ የትርጉም የስራ ፍሰት፣ RTL
የልቀት ቼክሊስት	ከልቀት በፊት የማረጋገጫ ደረጃዎች
የሽፋን እቅድ	በ7,800+ የተከታተሉ የሙከራ ፋይሎች ውስጥ ለ56,000+ የቋሚ የሙከራ መግለጫዎች የሙከራ ሽፋን ስትራቴጂ

# ⭐ ከፍተኛ አስተዋጽኦ አበርካቾች > OmniRoute በትጋት በሚሰሩ ክፍት ምንጭ ማህበረሰብ የቀረጸ ነው። እነዚህ ግለሰቦች በፕሮጀክቱ ጥራት፣ መረጋጋት እና ተደራሽነት ላይ በቀጥታ ተጽእኖ የሚያሳድሩ ልዩ አስተዋጽኦዎችን አበርክተዋል። **እናመሰግናለን።** ### ውጫዊ አስተዋጽኦ አበርካቾች በተዋሀዱ pull requests መሰረት

ደረጃ	አስተዋጽኦ አበርካች	የተዋሀዱ PRs	~የተቀየሩ መስመሮች
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{ቆጠራው በ2026-10-18 15:09:09 UTC በቀጥታ release/v3.8.52 ጫፍ 656f01cb43 ተወስዷል። የተከፋፈለው GitHub GraphQL ቆጠራ 9,191 የተዋሀዱ PRs ይዟል፦ 3,834 በሪፖዚተሪው ባለቤት፣ 229 በDependabot፣ 6 በሌሎች ቦቶች/መተግበሪያዎች፣ እና 5,122 ውጫዊ PRs ከ835 የተለያዩ አስተዋጽኦ አበርካቾች። “የተቀየሩ መስመሮች” ማለት GitHub additions + deletions ማለት ሲሆን በራስ-ሰር የተፈጠሩ ፋይሎችን፣ lockfilesን፣ ካታሎጎችን፣ ትርጉሞችን እና ሰነዶችን ያካትታል፤ ይህ ለውጥ (churn) ነው እንጂ በቀጥታ የተጻፈ LOC አይደለም። 49 PRs ከ500,000 መስመሮች በላይ የሆኑ GitHub diffs ሪፖርት ያደርጋሉ (ለምሳሌ #13399፣ አንድ ነጠላ አቅራቢ ጨምሮ፣ 2,347 የተቀየሩ ፋይሎችን ይዘረዝራል)፣ ይህም ከላይ ያሉትን በርካታ ድምሮች ያጉላል። እኩል የሆኑ ደረጃዎች በአንድ ላይ ይደረደራሉ።} ### በGitHub የተመደቡ ኮሚቶች

Dizzle _{🥇 367 በGitHub የተመደቡ ኮሚቶች}	Bob.Hou _{🥈 269 በGitHub የተመደቡ ኮሚቶች}	Paijo _{🥉 229 በGitHub የተመደቡ ኮሚቶች}	backryun _{🏅 202 በGitHub የተመደቡ ኮሚቶች}	Paco Cartones _{🏅 174 በGitHub የተመደቡ ኮሚቶች}	Ravi Tharuma _{🏅 126 በGitHub የተመደቡ ኮሚቶች}
Markus Hartung _{🏅 114 በGitHub የተመደቡ ኮሚቶች}	Randi _{🏅 108 በGitHub የተመደቡ ኮሚቶች}	Jan Leon _{🏅 87 በGitHub የተመደቡ ኮሚቶች}	Chris _{🏅 70 በGitHub የተመደቡ ኮሚቶች}	Koosha Paridehpour _{🏅 68 በGitHub የተመደቡ ኮሚቶች}

_{እንደገና የተፈተሸው በ2026-10-18 14:44:45 UTC፡ ለrelease/v3.8.52 ነባር ቅርንጫፍ በሪፖዚተሪው Contributors API የሪፖርት የተደረጉ በGitHub የተመደቡ ኮሚቶች። APIው 849 ማንነቶችን መልሷል (429 ተጠቃሚዎች፣ 2 ቦቶች፣ 418 ስም-አልባዎች)፤ ይህ ሰንጠረዥ አስተዳዳሪውን፣ ቦቶችን እና ስም-አልባ ማንነቶችን አያካትትም እና የውድድር እኩልነቶችን ይይዛል። ከላይ ካለው የተዋሃዱ-PR ደረጃ ሰንጠረዥ እና ከታች ካለው የGit-metadata ቆጠራ ሁለቱም የተለየ ነው።} > 🙏 የእነዚህ አስተዋጽኦ አበርካቾች ባህሪያት፣ የሳንካ ጥገናዎች እና የመሰረተ ልማት ማሻሻያዎች OmniRouteን አስተማማኝ እና ባህሪያት የበለጸገ የሚያደርገው **ዋና አካል** ናቸው። እያንዳንዱ pull request፣ እያንዳንዱ የሙከራ ሁኔታ እና እያንዳንዱ የi18n ትርጉም ፋይል አስፈላጊ ነው። ክፍት ምንጭ በእንደ እነሱ ያሉ ሰዎች ይገነባል።

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

OmniRouteን ከራሳቸው ኪስ ለሚደግፉ ሰዎች ከልብ የመነጨ ምስጋና — እያንዳንዱ አስተዋጽኦ ፕሮጀክቱ ነፃ፣ ገለልተኛ እና በእንቅስቃሴ ላይ እንዲቆይ ያደርጋል።

Andrew _{💛 ንቁ ወርሃዊ ስፖንሰር}	Vlad I _{💛 ንቁ ወርሃዊ ስፖንሰር}	小妍儿 _{💛 ንቁ ወርሃዊ ስፖንሰር}	Guilherme Costa _{💛 ንቁ የአንድ ጊዜ ስፖንሰር}	Henrique Iurkiv _{💛 ንቁ የአንድ ጊዜ ስፖንሰር}	Somesh Ghaturle _{💛 ንቁ የአንድ ጊዜ ስፖንሰር}
Kolonie AI _{💛 የቀድሞ የአንድ ጊዜ ደጋፊ}	Prof. Igor Morais _{💛 የቀድሞ የአንድ ጊዜ ደጋፊ}	Pixma _{💛 የቀድሞ የአንድ ጊዜ ደጋፊ}	Paco Cartones _{💛 የቀድሞ የአንድ ጊዜ ደጋፊ}	longtao _{💛 የቀድሞ የአንድ ጊዜ ደጋፊ}

_{… እና ማንነታቸውን በምስጢር ማቆየት የሚመርጡ ሌሎች 💛} _{ይፋዊ የGitHub Sponsors መረጃ በ2026-10-18 በGitHub Sponsors GraphQL API በኩል እንደገና ተረጋግጧል፦ በአጠቃላይ ካሉ 14 ስፖንሰርነቶች ውስጥ 11 ይፋዊ ስፖንሰርነቶች (6 ንቁ፣ 5 የቀድሞ)። ከላይ ያሉትን የንቁነት መለያዎች የሚወስነው የGitHub isActive ሁኔታ ነው፤ የቀድሞ ይፋዊ የአንድ ጊዜ ደጋፊዎች ምስጋናቸውን እንደተጠበቀ ይቆያሉ፣ የግል ስፖንሰሮችም ማንነታቸው ሳይገለጽ ይቀራሉ። Ko-fi፣ Buy Me a Coffee፣ Liberapay፣ PIX እና የክሪፕቶ ልገሳዎች ይፋዊ የስፖንሰር መዝገብ ስለሌላቸው አልተዘረዘሩም።} 💖 ስፖንሰር ይሁኑ → — እያንዳንዱ ዶላር OmniRoute ነፃ እና ገለልተኛ ሆኖ እንዲቆይ ያግዛል።

## 👥 900+ አስተዋጽዖ አድራጊዎች

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

## 📊 ኮከቦች

## 🌍 StarMapper

## 🙏 ምስጋናዎች

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

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
9router	31,004	ይህ የተገነጠለ ፕሮጀክት የተገነባበት ዋናው ፕሮጀክት ሲሆን፣ እዚህ ላይ ባለብዙ-ሞዳሊቲ APIs እና ሙሉ የTypeScript ዳግም ጽሑፍ ተስፋፍቷል።
CLIProxyAPI	55,591	ለዚህ JavaScript / TypeScript ማስተላለፊያ መነሳሳት የሆነው የGo ትግበራ።
LiteLLM	61,482	ይፋዊ የዋጋ ውሂብ ስብስቡ የወጪ ክትትል ማመሳሰላችንን የሚመግብ እና የአቅራቢ ማስተካከያ ሞዴሉ የመስመር ምርጫችንን ያሳወቀ የAI መግቢያ በር።
codex-chatgpt-web	14,526	ከChatGPT Web → Codex Responses ድልድይ ጋር አብሮ እንዲካተት የተስማማ የMIT ምንጭ፤ የአሳሽ ክፍለ-ጊዜ፣ የምላሽ ፍሬም አደረጃጀት፣ የአጠቃቀም እና የድር ፍለጋ አስማሚዎችን ያካትታል።
free-claude-code	61,430	ወደ ዥረት መልሶ ማግኛ፣ የማያስቡ ተለዋጭ ስሞች፣ ተጠባባቂ የድር ፍለጋ፣ ተንሸራታች-መስኮት ገደቦች፣ የምዝግብ ማደብዘዝ እና የተጠናከሩ የማስጀመሪያ ፍሰቶች የተላለፉ ቅጦች።
composer-api	346	ወደ ነባሩ Cursor አስፈጻሚ የተስማሙ የCursor Composer የመሣሪያ ምርጫ፣ የውጤት ገደብ እና የመሣሪያ ማስገቢያ ቅጦች።
codex-multi-auth	553	ወደ Codex OAuth ዳግም ማረጋገጫ የተላለፉ የአዲስ መግቢያ እና የrefresh-token ሽክርክር ቅጦች።
opencode-anthropic-auth	558	ከClaude Code ጋር ተኳሃኝ የሆኑ ነባሪ ለውጦች እና የክፍያ ራስጌ ባህሪ በOmniRoute ውቅር-ተኮር ድልድይ ውስጥ አጠቃላይ ሆነዋል።
grok2api-merged	2	የGrok ሞዴል ማዛመጃዎቹ፣ የሐሰት-TypeError Statsig አመንጪው፣ የጥያቄ እና የመሣሪያ ነባሪዎቹ፣ እንዲሁም የNDJSON ምላሽ አቀናባሪው ወደ OmniRoute Grok Web አስፈጻሚ በተጨባጭ ተስማምተው ገብተዋል።
TQZHR/grok2api	706	ከgrok2api-merged በስተጀርባ ያለው ዋናው ተሻጋሪ የኮድ ምንጭ፤ የሞዴል፣ የራስጌ፣ የpayload፣ የStatsig እና የአቀናባሪ ትግበራዎቹ በGrok Web የዘር ሐረግ ውስጥ ተጠብቀዋል።
chenyme/grok2api	7,819	በTQZHR እና grok2api-merged በኩል የተላለፉት የGrok payload እና የመሣሪያ ነባሪዎች፣ የStatsig አመንጪ እና የ`result.response` አቀናባሪ መሠረታዊ የMIT ምንጭ።
grok2api-pro	27	ለproxy-pool ንብርብሩ በgrok2api-merged ዕውቅና የተሰጠው ተሻጋሪ ምንጭ፤ OmniRoute ያንን የዘር ሐረግ ማስታወቂያ ይጠብቃል፣ ነገር ግን በተወሰነው Grok Web አስፈጻሚው ውስጥ የproxy-pool ማስተላለፊያ እንዳለው አይገልጽም።
GrokProxy	51	በcookie የተረጋገጠው የGrok proxy እና የ`result.response.token` ዥረት ቅጥ OmniRoute Grok Web ማጓጓዣን አሳውቋል።
GrokBridge	5	የመጀመሪያው የGrok Web ትግበራ የHTTP/አሳሽ የላይኛው ምንጭ ንድፉን አማክሯል፤ ቀጥተኛው የHTTP መንገድ ከGrokProxy የተገኘ ስለሆነ፣ ራሱን የቻለ የኮድ ማስተላለፍ እንደተደረገ አይገለጽም።

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

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
Caveman	113,396	በፍጥነት የተስፋፋው "ጥቂት token ሥራውን ሲሠራ ለምን ብዙ token ይጠቀማሉ" ፕሮጀክት — የዋሻ ሰው ንግግር ፍልስፍናው መደበኛውን የመጭመቂያ ሁነታችንን እና ከ30 በላይ የትርፍ ቃላት/የማጠቃለያ ደንቦችን ያንቀሳቅሳል።
RTK – Rust Token Killer	83,835	ከፍተኛ አፈጻጸም ያለው የትዕዛዝ ውጤት መጭመቂያ — የRTK ሞተራችንን፣ JSON ማጣሪያ DSLን፣ ጥሬ ውጤትን መልሶ ማግኘትን እና የተደራረበውን RTK → Caveman የሂደት መስመር አነሳስቷል።
headroom	75,741	ወደ ቀድሞ ሁኔታው ሊመለስ የሚችል የአውድ መጭመቂያ (SmartCrusher) — የ`headroom` ሞተራችንን እና የ`ccr` የማምጫ ምልክት ንድፍን አነሳስቷል።
LLMLingua	6,757	የprompt መጭመቂያ ጥናት (LLMLingua / LLMLingua-2) — async፣ ለኮድ ደህንነቱ የተጠበቀ፣ ሲያልፍ ክፍት የሆነውን የ`llmlingua` ሞተራችንን አነሳስቷል።
llmlingua-2-js	32	ለLLMLingua ሞተራችን እንደ worker-thread backend የሚያገለግለው JS/ONNX port (MobileBERT / XLM-RoBERTa)።
Troglodita	50	የPT-BR token መጭመቂያ — የpt-BR ቋንቋ ጥቅላችንን ያንቀሳቅሳል፦ ለብራዚል-ፖርቱጋልኛ ሰዋሰው የተስተካከለ የድግግሞሽ ቅነሳ እና የትርፍ ቃላት ማስወገድ።
ponytail	166,731	በፍጥነት የተስፋፋው የ"ሰነፍ ከፍተኛ ደረጃ ገንቢ" YAGNI-coder ክህሎት — የless-code የውጤት ቅጣችንን አነሳስቷል፦ _የሚመነጨውን_ ኮድ የሚቀንስ አነስተኛውን የሚሠራ ለውጥ የማስመራት ዘዴ (ከCaveman አጭር ጽሑፍ ጋር በውጤት ዘርፍ የሚዛመድ)።
i-have-adhd	57,628	ተግባርን የሚያስቀድም፣ ለADHD ምቹ የሆነው የምላሽ ቅጥ በአምስት ቋንቋዎች ወደ OmniRoute አጭር የውጤት ቅጥ ተስማምቶ ተቀይሯል።

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

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
TOON	25,509	Token-Oriented Object Notation — በዓምድ የተደራጀው፣ ራስጌ-እና-ረድፎች ያሉት ሞዴሉ የሰንጠረዥ ማጠቃለያ ደረጃችንን ቅርጽ ሰጥቶታል።
GCF – Graph Compact Format	59	የታመቀው የግራፍ ቅርጸቱ እና generic-profile ንድፉ ለOmniRoute የሰንጠረዥ ማጠቃለያ እና የHeadroom codec ቅርጸት መሠረት ሰጥተዋል።
gcf-typescript	4	እንደ Headroom generic-profile codec በቀጥታ የተካተተ እና የተስፋፋው የMIT TypeScript ትግበራ።
token-optimizer-mcp	551	Brotli/SQLite cache + በእያንዳንዱ session የአውድ ልዩነት — የ`session-dedup` ሞተራችንን አነሳስቷል።
token-savior	1,182	የBash ውጤት ማጠቃለያ + MCP profiles — መጭመቂያን መተው ያለበትን ጊዜ የመወሰን ሥርዓታችንን እና የMCP tool-manifest ቅነሳን አነሳስቷል።
token-saver	154	ይዘትን የሚያገናዝብ፣ በእያንዳንዱ የፋይል ዓይነት የሚሠራ የውጤት መጭመቂያ፣ ከስህተት ግንዛቤ ያለው የመተው ሥርዓት — በዓይነት የሚከፋፈለውን dispatch እና ዝቅተኛ ትርፍ ሲኖር የመዝለል ዘዴያችንን አረጋግጧል።
token-optimizer	2,595	"የማይታዩትን tokens ፈልግ" — የoffload + መልሶ ሊገኝ የሚችል handle ንድፉ ለCCR offload አስተሳሰባችን መሠረት ሰጥቷል።
TokenMizer	33	ለsession-dedup ንድፋችን መሠረት የሰጠ የsession-graph + በተለያዩ turn መካከል የመስመር ድግግሞሽን የማስወገድ ንድፍ።
OmniCompress	3	Rust columnar-JSON + በይዘት አድራሻ የተሰጠውን መልሶ ማምጣት + በመልዕክቶች መካከል ድግግሞሽን ማስወገድ — የ`headroom`/`ccr`/`session-dedup` ሞተር ንድፋችንን እና ለcache የተረጋጋውን "የታመቀው ቅርጽ ከአቀማመጥ ነጻ ነው" የማይለወጥ መርህ አረጋግጧል።
mcp-compressor	133	የMCP tool-schema/መግለጫ መጭመቂያ — ለMCP tool-manifest የብዛት ቅነሳችን መሠረት ሰጥቷል።
RepoMapper	217	የAider ቅጥ ያለው repo-map ደረጃ አሰጣጥ — ለrepo-map / የማምጫ ደረጃ አሰጣጥ ምርምራችን መሠረት ሰጥቷል።
quiet-shell-mcp	4	በMCP ላይ የሚሠራ ገላጭ የshell ውጤት ቅነሳ — ገላጭ የbash ውጤት ማጠቃለያችንን አረጋግጧል።
ts-morph	6,205	የTypeScript Compiler API መሣሪያ ስብስብ — string፣ template እና regex literalsን ሳይቀይር የሚጠብቀውን፣ በparser ላይ የተመሠረተ የአስተያየት ማስወገጃችንን አነሳስቷል።

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

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
Mem0	67,385	ሁለንተናዊ የማህደረ ትውስታ ንብርብር — የእሱ proxy-as-write/read-boundary ሞዴል የማህደረ ትውስታ አርክቴክቸራችንን ቅርጽ አስይዟል።
Letta (MemGPT)	25,179	ደረጃዊ ማህደረ ትውስታ ያላቸው ሁኔታ-ጠባቂ ወኪሎች — የእኛን ደረጃዊ Context Control & Recovery (CCR) ሞዴል አነሳስቷል።
WFGY	1,800	የ16 ተደጋጋሚ RAG/LLM የብልሽት ሁነቶች ProblemMap ምደባ — በችግር ፈቺ መመሪያችን ውስጥ ያለው የጋራ ቃላት ስብስብ።

### 🛰️ የትራፊክ ፍተሻ፣ MITM እና ግልጽ proxy

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

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

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
models.dev	7,286	የAI ሞዴል ዝርዝሮች፣ ዋጋ እና ችሎታዎች ክፍት የውሂብ ጎታ — በቀጥታ ከሞዴል ካታሎጋችን ጋር ተመሳስሏል።
React Flow / xyflow	38,705	የእውነተኛ ጊዜ Compression Studio እና Combo/Routing Studioን የሚያንቀሳቅሰው በnode ላይ የተመሠረተ የግራፍ ላይብረሪ።
LangGraph	43,443	የLangGraph Studio ቀጥታ የworkflow-graph ምስላዊ አቀራረብ የStudios የእውነተኛ ጊዜ ቅደም-ተከተላዊ እይታችንን አነሳስቷል።
Langfuse	35,990	የእሱ trace → span → generation ታዛቢነት ሞዴል የCompression Studio ተከታታይ ፍሰት እይታችንን ቅርጽ አስይዟል።
Kiali	3,645	የIstio service-mesh ታዛቢነት — በRouting/Combo Studio ውስጥ ያሉትን የcircuit-breaker ባጆቻችንን እና የስህተት-ጠርዝ ምስላዊ አቀራረቦችን አነሳስቷል።
lobe-icons	2,615	በdashboardችን ውስጥ የአቅራቢዎችን አዶዎች የሚያሳዩ የAI/LLM የምርት ስም አርማዎች።
flag-icons	12,473	በREADME ቋንቋ መምረጫ የሚጠቀሙትን በMIT ፈቃድ የተሰጣቸውን SVG ባንዲራዎች ያቀርባል።

### 🛡️ ደህንነት

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

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

ፕሮጀክት	⭐	OmniRouteን እንዴት እንዳነሳሳ
ClawRouter	6,628	የጥያቄ ድግግሞሽ ማስወገድ፣ የድንገተኛ ጊዜ ዜሮ-ወጪ fallback፣ ተሰኪ Auto-Combo ስትራቴጂዎች እና ባለብዙ ቋንቋ የዓላማ ምደባን አነሳስቷል።
Antigravity-Manager	32,333	የእሱ መለያ-ተኮር የሞዴል እንደገና ማዛመድ፣ የexecutable-path ማረጋገጫ እና የplan-label ባህሪ ለOmniRoute Antigravity runtime መሠረት ሆኗል።
vscode-antigravity-cockpit	4,850	የእሱ እምቅ የquota-reset ቆጠራ ቅርጸት በOmniRoute ውስጥ ያለውን ተጓዳኝ የአቅራቢ-ገደብ ማሳያ አነሳስቷል።
AionUi	33,611	የእሱ ACP ውህደቶች የOmniRouteን የተጫኑ CLI ወኪሎች ራስ-ሰር ማግኘት አነሳስተዋል።
CodexBar	22,616	የGrok Build quota በይነገጽን ለይቷል፤ ከዚያ OmniRoute የቀጥታ wire ቅርጸቱን በተናጥል አረጋግጦ አርሟል።

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

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