# 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 ጌትዌይ
**በ [Diego Souza](https://github.com/diegosouzapw) የተፈጠረ**
## 💰 በሶስተኛ ወገን ነፃ ደረጃዎች በወር ~1.62B ቶከኖች
> **የራስዎን የአቅራቢ መለያዎች ይጠቀሙ።** ይህ በተናጠል ብቁ በሆኑ የሶስተኛ ወገን ነፃ ደረጃዎች ላይ የተመሠረተ ግምታዊ ጠቅላላ መጠን ነው፤ ከOmniRoute የሚሰጥ የቶከን ስጦታ አይደለም። ይመዝገቡ፣ በሚያስፈልግበት ጊዜ ማረጋገጫዎችን ያግኙ፣ እና ሊጠቀሙባቸው የሚችሉትን አቅራቢዎች ያገናኙ፤ እያንዳንዱ አቅራቢ የራሱን ገደቦች፣ ተገኝነት እና ውሎች ይቆጣጠራል።
>
> ነፃ ደረጃዎችን በእጅ ማከማቸት አስቸጋሪ ነው — በደርዘን የሚቆጠሩ SDKዎች፣ በደርዘን የሚቆጠሩ የጥያቄ መጠን ገደቦች፣ እና በእርግጥ ምን ያህል እንዳለዎት የሚያሳይ መረጃ አለመኖር። OmniRoute **በ34 ተደጋጋሚ የፑል ቁልፎች ውስጥ 465 ነፃ-ደረጃ ግቤቶችን** ይመዘግባል፣ እና የቶከን አጠቃላይ መጠኑን የሚያሰላው **የታተመ አዎንታዊ ወርሃዊ በጀት ካላቸው 17 ፑሎች እና አምስት በሞዴል የተለዩ የGroq ገደቦች** ላይ በመመሥረት፣ በጋራ ፑል መሠረት የተደጋገሙትን በማስወገድ ነው። ከክልላዊ የማንነት ማረጋገጫ በኋላ ብቻ የሚከፈቱ ኮታዎች (ዛሬ፦ ModelScope) ለየት ተለይተው ይታያሉ፣ ከክልላዊ የማንነት ማረጋገጫ በኋላ +~6M ይጨምራሉ፣ እና በአጠቃላይ መጠኑ ውስጥ በፍጹም አይደመሩም። ውጤቱ በዳሽቦርዱ ላይ (`/dashboard/free-tiers`) ሁልጊዜ ይታያል።
> የቀጥታ `/dashboard/free-tiers` ገጽ የታነመ ማጠቃለያ። ሙሉ ዘዴው (የፑል ድግግሞሽ ማስወገድ፣ የክሬዲት ደረጃዎች፣ የአቅራቢ ውሎች)፦ **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**።
>
> እነዚህ አሃዞች በየሁለት ሳምንቱ ከቀጥታ ካታሎጉ ጋር እንደገና ይመረመራሉ እና **በሁለቱም አቅጣጫዎች ይለወጣሉ** — አንድ አቅራቢ ነፃ ደረጃውን ካቋረጠ ቁጥሩ ይቀንሳል፤ አዲስ አቅራቢ ከተጨመረ ይጨምራል። ካታሎጉ በእርግጥ የሚያሰላውን ነው የምናተምው፤ ሆን ብለን ወደ ላይ የተጠጋጋ ምርጥ ሁኔታን በፍጹም አንጠቀምም።
⭐ OMNIROUTE ገንዘብ ለመቆጠብ እና ሥራዎን ለማቀላጠፍ ከረዳዎት ሪፖውን ስታር ያድርጉ።
[](https://github.com/diegosouzapw/OmniRoute)

[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 ማኅበረሰቡን ይቀላቀሉ
**👋 ጠባቂውን ይከተሉ — አዳዲስ አቅራቢዎችን፣ ልቀቶችን እና ምክሮችን ከሁሉም በፊት ያግኙ፦**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**ጥያቄዎች፣ የአቅራቢ ምክሮች፣ የወደፊት ዕቅድ እና ድጋፍ → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 ዓለም አቀፍ](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](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.50 | **v3.8.51** | `v3.8.54+` |
| --------------------- | :----------------: | :---------: | :-------------------: |
| 🌐 አቅራቢዎች | 352 | **358** | 388 |
| 🧠 ልዩ የውይይት ሞዴል መለያዎች | 1320 | **1374** | 1491 |
| 🖼️ የሞዳሊቲ ድልድይ | 🆕 ራዕይ + ድምጽ + ቪዲዮ | ✓ | ✓ |
| 📡 የRadar ነፃ ካታሎግ | 🆕 በፈቃደኝነት ምርጫ | ✓ | ✓ |
| ⚖️ ኮታን ያገናዘበ መርሐ ግብር | 🆕 Quota-Share | ✓ | ✓ |
| 📊 የኮታ ቴሌሜትሪ | 🆕 ቀጥታ | ✓ | ✓ |
| 🧰 ራስ-አልባ ሁነታ | — | — | 🆕 `serve --headless` |
| 🛤️ LTS የረድፍ መሠረተ ልማት | — | — | 🆕 የልቀት ቻናሎች |
| 🔎 የሞዴል ማግኛ API | — | — | 🆕 `/v1/models/query` |
**→ [የመንገድ ካርታ](ROADMAP.md) — ወደ `v3.9.0 LTS` በረድፉ ላይ እየተጓዙ**
## 🧩 ይገኛል
[](https://www.npmjs.com/package/omniroute)

[](https://hub.docker.com/r/diegosouzapw/omniroute)
[](LICENSE)


## 🆓 ጫን፣ አቅራቢን አገናኝ፣ ከዚያም በአንድ ኤንድፖይንት በኩል አዘዋውር
```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` ብቁ የሆነ የማዘዋወሪያ መንገድ ያስፈልገዋል። አዲስ ጭነት ምንም ብቁ የቁልፍ-አልባ መዳረሻዎች ላይኖሩት ይችላል፣ እና ቁልፍ-አልባ አቅራቢ የሶስተኛ ወገን ደንበኞችን ሊቀበል ይችላል። `tos: avoid` ተብለው የተመለከቱ አቅራቢዎች፣ Kiroን ጨምሮ፣ በነባሪ ከራስ-ሰር ማዘዋወር ውጭ ይደረጋሉ፤ መለያን ማገናኘት ይህን ቅንብር አይሽረውም። አቅራቢ ከመምረጥህ በፊት [የነፃ ደረጃዎች መመሪያ](docs/getting-started/FREE-TIERS-GUIDE.md)ን ተመልከት።
📦 ለ**Python፣ Node.js፣ PHP እና cURL** የተዘጋጁ የፈጣን ጅምር ስክሪፕቶችን ቅዳና ለጥፍ → [`examples/quickstart/`](examples/quickstart/)
# 💥 ተስፋው
# 🤔 OmniRouteን ለምን?
## 🤝 በክፍት ምንጭ ወዳጆቻችን የተደገፈ
> **እንደ ክፍት ምንጭ ወዳጅ መቀላቀል ይፈልጋሉ?** እነዚህ ክፍት ምንጭን የሚደግፉና 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 ይክፈቱ፣ እኛም እዚህ እንጨምረዋለን።
## 🎯 ጥምሮች — ዋናው ባህሪ
> **ጥምር** ማለት 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 ነጻ ንብርብሮች)
📖 [የ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 ፈቃድ የተለቀቀ ሲሆን በግልጽነት ይጠበቃል። ጊዜዎን ወይም ገንዘብዎን የሚቆጥብልዎት ከሆነ፣ ነጻነቱን ለማስጠበቅ ከእርስዎ ጋር የሚስማማውን መንገድ ይምረጡ። ስፖንሰርነት በማዘዋወሪያ ቅድሚያ ላይ ፈጽሞ ተጽዕኖ አያሳድርም፤ የሚገዛው ታይነትን እንጂ ደረጃን አይደለም።
**🇧🇷 PIX** — ፈጣን፣ ያለ ክፍያ (ብራዚል)
ቁልፍ (የዘፈቀደ): `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.54** ያሉ የቅርብ ጊዜ ዋና ማሻሻያዎች። ሙሉ ታሪክ በ [`CHANGELOG.md`](CHANGELOG.md) ይገኛል።
- **⚖️ `quota-weighted` ራውቲንግ** — 20ኛው የኮምቦ ስትራቴጂ ኮታቸውን የጨረሱ መለያዎችን ያልፋል፤ ከዚያም በቀሩት መካከል በቀሪ ኮታ ÷ በሂደት ላይ ባለ ጭነት መጠን መሠረት ይመርጣል፣ ነባር ውይይቶችንም በተመሳሳይ መለያ ላይ ያቆያል። → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 ራስ-አልባ ሁነታ** — `omniroute serve --headless` (ወይም `OMNIROUTE_HEADLESS=1`) የ`/v1/*` ፕሮክሲ ሞተሩን ብቻ ያስኬዳል፤ ዳሽቦርዱና ለዳሽቦርዱ ብቻ የሚያገለግሉ ንዑስ ስርዓቶች ይጠፋሉ። → [Headless Mode](docs/guides/HEADLESS.md)
- **🔎 የሞዴል ፍለጋ** — `/v1/models` በችሎታ፣ በአውድ፣ በዓይነት እና በጽሑፍ ይሰራል፤ `POST /v1/models/query` ደግሞ ተመሳሳይ በእያንዳንዱ ቁልፍ የሚወሰን ታይነት ያለው አጭርና በቆራጥነት የሚወሰን የምርጫ ዝርዝር ይመልሳል። → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 በቁልፍ ደረጃ የራውቲንግ ቁጥጥር** — አንድ API ቁልፍን `forcedModel` በመጠቀም ወደ አንድ ሞዴል ወይም ኮምቦ ይሰኩ፤ እንዲሁም የአንድ ቁልፍ ሞዴሎችንና ኮምቦዎችን በአቶሚክ ሁኔታ ይጨምሩ ወይም ያስወግዱ (`/api/keys/{id}/access`)። → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ የተሻሉ የPII ቁጥጥሮች** — በዓይነት መምረጥ፣ እስከ 20 የተረጋገጡ ብጁ የመሸፈኛ ቅጦች እና በዓይነት የሚቆጠሩ የማወቂያ ቆጣሪዎች፤ መሸፈኑ ግን አሁንም በተጠቃሚው ፈቃድ ብቻ ይነቃል። → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 ቋንቋዎች** — ዳሽቦርድ፣ የሰነድ መስታወቶች እና CLI፤ `npm run i18n:add-locale` በአንድ ትዕዛዝ ቋንቋን በሁሉም ቦታ ይጨምራል። → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — ወደ ወኪሎችዎ መረብ የሚገባ A2A ውክልና፣ በAgent Card ላይ የConductor ችሎታዎች እና የFaro የድምፅ ውይይት ለመናገር-ተጫን የሚል የዳሽቦርድ ፓነል። → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 ተለዋዋጭ መቀበያ እና ከመጠን በላይ ጭነት ጥበቃ** — ከባድ የውይይት ጥያቄዎች 503 ከመመለስ ይልቅ ወረፋ ውስጥ ይገባሉ፤ በእያንዳንዱ ግንኙነት ደግሞ አቶሚክ RPM ተንሸራታች ሊዝ ይጠቀማሉ። → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ ቀኖናዊ `/v1/models` ቅደም ተከተል** — ለእያንዳንዱ ፕሮቫይደር አንድ ተያያዥና በፕሮቫይደር የተመደበ ብሎክ (ኮምቦዎች በመጀመሪያ ተሰክተው)፣ ከሁሉም የካታሎግ ምንጮች ጋር የተረጋጋ። → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ የኮምፕሬሽን ጥንካሬ** — በነባሪ የሚነቃ የመስፋፋት ጥበቃ፣ ለDE / FR / JA እና ለቻይንኛ (wényán) Caveman ፓኮች፣ ለGradle እና .NET RTK ማጣሪያዎች። → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 ታማኝ የጠፍጣፋ ዋጋ ስሌት** — የምዝገባ / የኮዲንግ-ፕላን ፕሮቫይደሮች በወጪ ትንታኔ ውስጥ **$0** ተብለው ይነበባሉ፤ በጀት፣ ኮታ እና ራውቲንግ ግን ግምታቸውን ይቀጥላሉ። → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share ራውቲንግ** — የጋራ መለያ ኮታን በተመጣጣኝ ሁኔታ በተመደቡ ቁልፎች መካከል ይከፋፍላል፤ እንቅስቃሴ የሌላቸው ክፍሎች ለሌሎች እንዲበደሩ በማድረግ ሀብቱን ሙሉ በሙሉ ይጠቀማል። → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 በአንድ ትዕዛዝ CLI/ወኪል ማዋቀር** — 15 የተመዘገቡ `setup-*` ትዕዛዞች፤ `omniroute run` 7 CLIዎችን (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ያስጀምራል፤ `omniroute configure` በተጠቃሚ መስተጋብር የሚሰራ የፕሮቫይደር+ሞዴል መራጭና በእያንዳንዱ አውድ ተወዳጆችን ጨምሮ 11 ዒላማዎችን ይደግፋል። → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ የርቀት ሁነታ** — የርቀት OmniRouteን በተወሰነ ወሰን ባላቸው ቶከኖች (`connect` / `contexts` / `tokens`) ያስተዳድሩ፤ ለVPS ጭነቶችም `antigravity` OAuth እገዛ ይጠቀሙ። → [Remote Mode](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፣ በመጎተት የሚደረደር አርታዒ። → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ ግልጽ MITM ዲክሪፕት (TPROXY)** — የፕሮክሲ አካባቢ ተለዋዋጮችን ችላ የሚሉ CLIዎችን ይይዛል፤ ከSNI ጋር የተያያዘ CA እና የመተማመኛ ማከማቻ መጫኛ አለው። → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 በሁሉም ቦታ የወጪ ቴሌሜትሪ** — በእያንዳንዱ ኤንድፖይንት `X-OmniRoute-*` የወጪ/አጠቃቀም ራስጌዎች፣ የካሽ-HIT ቁጠባ ራስጌ እና በእያንዳንዱ ቁልፍ የUSD ወጪ ኮታዎች። → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 እርስዎ የሚቆጣጠሩት ማህደረ ትውስታ** — በነባሪ ጠፍቶ ይገኛል፤ በፈቃደኝነት የሚነቃ int8 የቬክተር ኳንታይዜሽን + ዓይነት-ተኮር መቀነስ፣ በእያንዳንዱ ጥያቄ `x-omniroute-no-memory`። → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ ደህንነት** — በእያንዳንዱ LLM ራውት ላይ የፕሮምፕት-ኢንጀክሽን ጥበቃ (የቀይ-ቡድን ሙከራ ስብስብ)፣ በፈቃደኝነት የሚነቃ የማረጋገጫ መረጃ መሸፈኛ ጥበቃ (የተሰረቁ API ቁልፎችን/ሚስጥሮችን በሁለቱም አቅጣጫዎች ይሰርዛል)፣ ነፃ DuckDuckGo የመጨረሻ አማራጭ የድር ፍለጋ እና ለዳሽቦርዱ አማራጭ OIDC የመግቢያ መግቢያ፤ የይለፍ ቃል መግቢያ ግን ሁልጊዜ ይኖራል። → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ አዲስ ኤንድፖይንቶች** — `/v1/ocr` (Mistral OCR) እና `/v1/audio/translations` (እንደ Whisper ያለ) የሚዲያ ተግባራትን ያሟላሉ። → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 የምስል / ቪዲዮ / ድምፅ ማመንጨት** — ለሚዲያ አንድ API፦ xAI Grok Imagine እና Novita AI ቪዲዮ፣ ComfyUI፣ Magnific፣ Adobe Firefly፣ Segmind እና እንደ ElevenLabs ያሉ የንግግር ፕሮቫይደሮች። → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 ማሰማራት እና ኦፕሬሽኖች** — የሪቨርስ-ፕሮክሲ `basePath`፣ በአሳሽ ቋንቋ ራስ-ሰር ማወቅ፣ በእያንዳንዱ ቁልፍ የመሣሪያ ክትትል፣ ሩት-አልባ MITM መተማመን፣ zh-TW አካባቢያዊ ትርጉም። → [Environment](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… እና እንደገና የተዘጋጀ **388-ፕሮቫይደር ካታሎግ**። → [Providers](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` በትይዩ የሚሠራ የብዝሃ-ሞዴል fan-out፣ የTelegram bot ድልድይ፣ በመተግበሪያው ውስጥ ያለ የስሪት አስተዳዳሪ እና የLMArena-ELO ነፃ አቅራቢዎች ደረጃ አሰጣጦች። → [ሰነዶች](docs/README.md)
## 🤖 ከፍተኛ ተስማሚ CLIs እና የመኮድ ወኪሎች
> አንድ ውቅረት — `http://localhost:20128/v1` — እና **ሁሉም** የAI IDE ወይም CLI በነፃ እና በዝቅተኛ ዋጋ ሞዴሎች ላይ ይሰራል።
+ እንዲሁም ከሚሰሩት ጋር · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · ማንኛውም ከOpenAI ጋር ተስማሚ መሳሪያ
📖 ለሁሉም 39 መሳሪያዎች (28 CLI ኮድ + 11 CLI ወኪሎች) የተለያዩ መሳሪያዎች ማዘጋጃ መመሪያ → [`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 የተለየ የጊዜያዊ መኖሪያ ያገኛሉ፡
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# ወይም አቅራቢ+ሞዴል በእጅ ይምረጡ እና የመሳሪያውን የራሱን ቅኝ ይጻፉ፡
omniroute configure codex # እንዲሁም: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
እያንዳንዱ ትእዛዝ የተነቃቃ የርቀት ኮንቴክስትን (`omniroute connect `) ይከተላል፣ `--dry-run`
ትክክለኛውን አካባቢ/አርግሞንቶችን ሳይከናወን ይቀይራል፣ እና `--api-key-env NAME` ምስጢራዊውን ከshell ታሪክዎ ውጭ ይጠብቃል። → [CLI መዋቀሪያዎች](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 የAI አቅራቢዎች — 153 በካታሎግ ነፃ ተመዝግበዋል
> በመደበኛ የውይይት፣ የሚዲያ፣ የፍለጋ፣ የአካባቢ፣ የክላውድ-ኤጀንት እና የሲስተም ስብስቦች ውስጥ **388 የተመዘገቡ አቅራቢዎች** አሉ፤ ከእነዚህም **153 `hasFree: true` የግኝት ሜታዳታ የያዙ** ናቸው። የውይይት ሞዴል መዝገቡ **239 አቅራቢዎች / 3,059 የተለያዩ አቅራቢ-ሞዴል ጥንዶች / 1,475 ጥሬ የሞዴል መለያዎች** ይሸፍናል፤ የተለየው የነፃ በጀት ካታሎግ ደግሞ **471 በሞዴል የተደራጁ ረድፎች**፣ **34 ተደጋጋሚ ገንዳዎች** እና **52 ተደጋጋሚ/ቁልፍ-አልባ ለዘላለም ነፃ አቅራቢዎች** አሉት። እነዚህ በንድፍ የተለያዩ መለኪያዎች ናቸው፤ ትርጓሜዎቹ እና በገንዳ የተባዙ ስሌቶቹ በ [የአቅራቢ ማጣቀሻ](docs/reference/PROVIDER_REFERENCE.md) እና [ነፃ ደረጃዎች](docs/reference/FREE_TIERS.md) ውስጥ ይገኛሉ።
## 🖥️ OmniRoute የሚሮጥበት - በማንኛውም ቦታ
> ተመሳሳይ መተግበሪያ፣ ማሽንዎ፣ የእርስዎ ደንቦች። ከአለምአቀፍ npm እስከ መጫን ድረስ** ስልክህ** በ Termux በኩል.
| መድረክ | | ጫን ዋና ዜናዎች |
| 📦 npm (ግሎባል) | npm ጫን -g omniroute | አንድ ትዕዛዝ፣ማንኛውም OS |
| ⚡ Bun (ግሎባል) | bun add -g omniroute | ተመሳሳይ የመመዝገቢያ ታርቦል፣ ፈጣን ጭነቶች |
| 🐳 Docker | docker run … diegosouzapw/omniroute | Multi-arch AMD64 + ዝ ARM64 |
| 🖥️ Desktop (Electron) | npm አሂድ ኤሌክትሮን: | ቤተኛ መስኮት + ስርዓት ትሪ — Windows / macOS / Linux |
| 🎩 Menu-bar (OmniRouteTray) | brew install --cask zoispag/tap/omniroute-tray | ይቆጣጠራል & አገልጋዩን በራስ-ያዘምናል — macOS |
| 💪 ARM | ቤተኛ arm64 | Raspberry Pi፣ ARM አገልጋዮች፣ አፕል ሲሊኮን |
| 📱 አንድሮይድ (ቴርሙክስ) | pkg install nodejs && npx -y omniroute | በስልክዎ ላይ ይሰራል , 24/7, no root |
| 📲 PWA | "ወደ መነሻ ስክሪን አክል" | ሙሉ ስክሪን፣ ከመስመር ውጭ፣ ከአሳሽ ሊጫን የሚችል |
| 🧩 OpenCode plugin | @omniroute/opencode-provider | ቤተኛ OpenCode ውህደት |
| 🤖 VS ኮድ Copilot ውይይት | ጫን OmniCopilot ቅጥያ | በቤተኛ Copilot ውይይት መራጭ ውስጥ እያንዳንዱ OmniRoute ሞዴል - የተረጋጋ & 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 ኮድ ውስጥ የቤተኛ Copilot ውይይት
> አዲስ የጎን አሞሌ የለም፣ አዲስ የውይይት UI የለም - እያንዳንዱ OmniRoute የሚያገለግለው ሞዴል በ ውስጥ ይታያል** አስቀድመው የሚጠቀሙበት Copilot የውይይት ሞዴል መራጭ** . ከ VS ኮድ 1.122 ጀምሮ የአቅራቢዎች ሞዴሎች ያለ GitHub መግቢያ ወይም የ Copilot ደንበኝነት ምዝገባ - ወኪል ሁነታ፣ የመሳሪያ ጥሪ እና ራዕይ በነጻ ይሰራሉ።
ን ይጫኑ** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** ቅጥያ፣ ወደ OmniRoute አገልጋይዎ ያመልክቱ (ወደ `localhost:20128` ነባሪዎች)፣ ከዚያ Copilot Chat → ሞዴል መራጭ → ን ይክፈቱ።** ሞዴሎችን አስተዳድር…** →**OmniRoute** .
ከውስጥ አርታዒው፡ ክፈት** ቅጥያዎች** እይታ, ፍለጋ** "OmniRoute"** , ጠቅ ያድርጉ** ጫን** - በሁለቱም መደብሮች ላይ በተመሳሳይ መንገድ ይሰራል. ምንጭ፣ ጉዳዮች እና የማተም runbook በ [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) ላይ በቀጥታ።
📖 [VS ኮድ Copilot የውይይት መመሪያ](docs/guides/VSCODE-COPILOT.md) — ማዋቀር፣ መራጩ የሚያሳየው፣ ዳሽቦርድ-ውስጥ-ታብ፣ መላ መፈለጊያ
### 🎩 አዲስ OmniRouteTray — መግቢያዎ፣ በምናሌ አሞሌ ውስጥ መኖር
> `omniroute serve` ሁል ጊዜ ሲበራ ደስተኛ ነው።** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** ለ macOS ያንን ወደ ስብስብ እና የመርሳት ሜኑ-ባር መተግበሪያ ይለውጠዋል፡ አገልጋዩን ያስጀምራል፣ ዳግም በሚነሳበት ጊዜ ሁሉ ህያው ያደርገዋል፣ ያዘምነዋል፣ እና የቀጥታ ማስመሰያ ባጀትዎን በአንድ ጠቅታ ርቀት ላይ ያስቀምጣል።** ምንም ተርሚናል መስኮት አልተከፈተም ፣ ምንም `npm install -g omniroute` ለህፃናት እንክብካቤ የለም።**
በ [Tauri v2](https://v2.tauri.app/) የተሰራው (የማዞሪያ ስህተት መጠን ያለው የዝገት ኮር) የራሱ የሆነ የተፈረመበት Node 24 Runtime ይልካል እና በመተግበሪያ ባለቤትነት የተያዘውን OmniRoute ጭነትን ያስተዳድራል፣ ስለዚህ ከእርስዎ አለም አቀፍ `node`/`bun` ጋር በጭራሽ አይዋጋም። እሱ** ያለዎትን `~/.omniroute/` ውቅር እና የውሂብ ጎታ ያካፍላል** - ስለዚህ እርስዎ ቀደም ብለው የሮጡት ተመሳሳይ OmniRoute ነው ፣ ኮፍያ በማድረግ። 🎩
| ምን ያደርጋል | እንዴት |
| 🟢 አገልጋዩን ይቆጣጠራል | Spawns omniroute ማገልገል , ከማባዛት ይልቅ ቀድሞውንም የሚሰራ ምሳሌን ይቀበላል |
| 📊 የቀጥታ አጠቃቀም በጨረፍታ | የአቅራቢ ኮታ አሞሌዎች፣ Claude session/weekly ገደቦች ከዳግም ማስጀመሪያ ቆጠራዎች ጋር፣ የ30 ቀን ወጪ ዝርዝር |
| 🔄 በራስ-ዝማኔዎች በቦታቸው | ደረጃ የተደረገ ጫኝ፣ አቶሚክ ስዋፕ፣ መልሶ በመውደቅ ላይ - ሁልጊዜ በአዲሱ ልቀት ላይ |
| 🚀 መግቢያ ላይ ይጀምሩ | በመግቢያ ጊዜ አማራጭ ማስጀመር; ትሪ-ብቻ፣ ምንም የመትከያ አዶ |
የለም።
| 🩺 ዶክተር & መዝገቦች | አንድ ጠቅታ የምርመራ እና የአገልጋይ ሎግ መዳረሻ |
```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ን ራሱ ይቆጣጠራል
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% ቶከኖችን ይቆጥቡ — በራስ-ሰር
### 📖 እንዴት እንደሚሠራ — የሂደት መስመር፣ አርክቴክቸር እና የቁጠባ ሒሳብ
ነባሪው የተደራረበ ጥምረት `RTK → Caveman` ን ያስኬዳል። ሁለቱም በአንድ የመሣሪያ/አውድ ጭነት ላይ ሲሠሩ፣ ቁጠባው ይደራረባል፦
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
የኮድ ብሎኮች፣ URLዎች፣ JSON እና የተዋቀረ ውሂብ በጥበቃ ሞተሩ **ሁልጊዜ ይጠበቃሉ**።
> **ጥቂት ቶከኖች ሥራውን ሲያከናውኑ ለምን ብዙ ቶከኖችን ይጠቀማሉ?** እያንዳንዱ ጥያቄ በOmniRoute የመጭመቂያ የሂደት መስመር ውስጥ **በግልጽ ሳይታወቅ** ያልፋል — በደንበኛ በኩል ምንም ለውጥ አያስፈልግም። አሁን በቅደም ተከተል የሚሠሩ እና በእያንዳንዱ የማዘዋወሪያ ጥምረት ላይ ሊቀላቀሉና ሊመረጡ የሚችሉ **12 ሊዋቀሩ የሚችሉ ሞተሮች ቁልል** ሆኗል — ከ[RTK](https://github.com/rtk-ai/rtk)፣ [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+)፣ [LLMLingua-2](https://github.com/microsoft/LLMLingua) እና [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) ሐሳቦችን በመገንባት።
### 🧱 የ12 ሞተሮች ቁልል
ሞተሮቹ በየሂደቱ መስመር ቅደም ተከተል ይሠራሉ፤ እያንዳንዱም በተናጠል ሊነቃና ለእያንዳንዱ ጥምረት ሊዋቀር ይችላል፦
| # | ሞተር | የሚያደርገው |
| 1 | Session-Dedup | በተለያዩ ዙሮች የሚደገመውን ይዘት ያስወግዳል (በይዘት አድራሻ የተመሠረተ፣ በዙሮች መካከል) |
| 2 | CCR | ትልልቅ ብሎኮችን ከማስመለሻ ምልክቶች ጀርባ ያስቀምጣል፤ በሚፈለጉበት ጊዜ ይጫናሉ |
| 3 | Lite | ባዶ ቦታን እና የምስል-URL መጠንን ይቀንሳል (የዝቅተኛ መዘግየት መነሻ) |
| 4 | RTK | የመሣሪያ ውጤቶችን በብልሃት ያጣራል፣ ተደጋጋሚዎችን ያስወግዳል እና ይቆርጣል (ትዕዛዝን የሚያውቅ) |
| 5 | Responses Tool Output | ለሼል/ፓች/ፍለጋ/ግንባታ ውጤቶች መጀመሪያ የማይጠፋ የJSON እና የተገደበ የምርመራ መጭመቂያ (Responses API) |
| 6 | Headroom | በvendored GCF codec በኩል የJSON ድርድሮችን ያለ መረጃ መጥፋት በሰንጠረዥ መልክ ያጠቃል (~30%) |
| 7 | Relevance | በመጨረሻው የተጠቃሚ ጥያቄ ላይ በመመሥረት ዓረፍተ ነገሮችን በይዘት ያስመዝናል |
| 8 | Caveman | በሕግ የተመሠረተ የሥነ-ጽሑፍ መጭመቂያ (~65–75% በውጤት ላይ) |
| 9 | Aggressive | የቆዩ ዙሮችን ማጠቃለያ እና በቀስታ ማሳረግ |
| 10 | LLMLingua-2 | በMobileBERT ONNX በኩል የML ትርጉም-ተኮር ማጣራት — ለኮድ ደህንነቱ የተጠበቀ፣ async |
| 11 | Ultra | ከተመረጠ አነስተኛ-ሞዴል (SLM) ደረጃ ጋር የሚመጣ በሂዩሪስቲክ የተመሠረተ የቶከን ማሳነሻ |
| 12 | OmniGlyph | በቀጥታ Anthropic wire ላይ ለተለካው Claude Fable 5 የሙከራ አውድ-እንደ-ምስል ኢንኮዲንግ፤ GPT 5.6 transformers የአቅራቢ ማረጋገጫዎች እስኪገኙ ድረስ fail-closed ሆነው ይቆያሉ። አራት የመጭመቂያ መገለጫዎች (ነባሪው ኃይለኛ፣ ሚዛናዊ፣ ለኮድ ደህንነቱ የተጠበቀ፣ passthrough) (በጣም ኃይለኛ፤ በፈቃደኝነት የሚነቃ) |
የኮድ ብሎኮች፣ URLዎች እና የተዋቀረ ውሂብ **ሁልጊዜ በባይት ደረጃ ፍጹም ሆነው ይጠበቃሉ**። **በአንድ ጠቅታ የሚዘጋጁ ቅድመ-ቅንብሮች** ሞተሮቹን ያጣምራሉ፦
| ሁነታ | ቁጠባ | በተለይ ለ |
| 🪶 Lite | ~15% | ሁልጊዜ የሚነቃ አስተማማኝ ነባሪ |
| 🪨 Standard (Caveman) | ~30% | የዕለት ተዕለት ኮዲንግ |
| ⚡ Aggressive | ~50% | ረጅም እና በመሣሪያዎች የበዛባቸው ክፍለ-ጊዜዎች |
| 🔥 Ultra | ~75% | ከፍተኛው ቁጠባ |
| 🧰 RTK | 60–90% | የሼል/ሙከራ/ግንባታ/ጂት ውጤት |
| 🔗 Stacked (RTK → Caveman) | 78–95% | የተቀላቀሉ ጥያቄዎች + የመሣሪያ ምዝገባዎች |
**እውነተኛ ምሳሌ — Standard ሁነታ፦**
> **በፊት (69 ቶከኖች):** _"የእርስዎ React ኮምፖነንት እንደገና የሚሰራው ምናልባት በእያንዳንዱ የማሳያ ዑደት አዲስ የነገር ማጣቀሻ ስለሚፈጥሩ ሊሆን ይችላል። የውስጥ ነገርን እንደ prop ሲያስተላልፉ፣ የReact ጥልቀት የሌለው ንጽጽር ሁልጊዜ እንደ የተለየ ነገር ይመለከተዋል፤ ይህም እንደገና እንዲሰራ ያደርጋል። ነገሩን በማስታወስ ለማቆየት useMemo እንዲጠቀሙ እመክራለሁ።"_
>
> **በኋላ (19 ቶከኖች):** _"በእያንዳንዱ ማሳያ አዲስ የነገር ማጣቀሻ። የውስጥ ነገር prop = አዲስ ማጣቀሻ = እንደገና ማሳያ። በuseMemo ይሸፍኑት።"_
>
> **ተመሳሳይ መልስ። 72% ያነሱ ቶከኖች። የትክክለኛነት መቀነስ የለም።** ✅
**የPT-BR ምሳሌ — [Troglodita](https://github.com/leninejunior/troglodita) ሁነታ፦**
> **በፊት (42 tokens):** _"ችግሩ ክፍሉ እንደገና እየተሰራ ያለው በእያንዳንዱ የማሳያ ዙር አዲስ የኦብጀክት ማጣቀሻ ስለሚፈጠር ነው። `useMemo`ን መጠቀም እመክራለሁ።"_
>
> **በኋላ (12 tokens):** _"እንደገና ማሳየት፦ በእያንዳንዱ ዙር አዲስ ማጣቀሻ (የውስጥ ኦብጀክት እንደገና ተፈጥሯል)። `useMemo`ን ተጠቀም።"_
>
> **ተመሳሳይ መልስ። ወደ 70% የሚጠጉ tokens ቀንሰዋል።** ✅
### 🎚️ ከኤንጂኖቹ በላይ — የውጤት ቅጦች፣ የሚለምደው መቆጣጠሪያ እና በእያንዳንዱ ጥያቄ ቁጥጥር
ከላይ ያሉት 12 ኤንጂኖች ወደ ውስጥ የሚገባውን ይቀንሳሉ። ሶስት ተጨማሪ ንብርብሮች ግን እንዴት፣ መቼ እና ምን እንደሚወጣ ይቀርጻሉ፦
- **🪄 የውጤት ቅጦች** _(በውጤት ዘንግ ላይ አቅጣጫ መስጠት)_ — ቆራጥ፣ ካሽ-ደህንነት ያላቸው የምላሽ ቅርጽ መመሪያዎችን ያስገባሉ፤ ሊዋሃዱ ይችላሉ፣ እያንዳንዱም በ `lite` / `full` / `ultra` ጥንካሬ ይገኛል። ቅጥ መጨመር በመዝገብ ውስጥ በአንድ መስመር ግቤት ይቻላል፦
- **አጭር ንባብ** — ተጨማሪ ቃላትን / መጣጥፎችን / ጥርጣሬን አስወግድ፤ የቴክኒክ ይዘቱን በትክክል አስቀምጥ።
- **አነስተኛ ኮድ** — የ“ሰነፍ ከፍተኛ ደረጃ ገንቢ” YAGNI፦ የሚሰራውን ትንሹን ለውጥ ብቻ፣ ያልተጠየቀ መዋቅር አትጨምር።
- **ጭራ ያለው (ሰነፍ ከፍተኛ ደረጃ ገንቢ)** — በ YAGNI ደረጃዎች ላይ ውጣ፣ ዋናውን ምክንያት አስተካክል፣ የሚሰራውን ትንሹን ልዩነት ተጠቀም።
- **ADHD አለብኝ (ተግባር-ቀዳሚ)** — ቀጣዩ ተግባር በመጀመሪያ ይምጣ፣ ደረጃዎች በቁጥር ይዘርዘሩ፣ አንድ ግልጽ ቀጣይ እርምጃ ይኑር፣ መግቢያ አይኑር።
- **አጭር CJK (文言)** — የጥንታዊ ቻይንኛ እጅግ አጭር ቅጥ (ለ `zh` ብቻ የተገደበ)።
- **🎯 የሚለምደው የአውድ-በጀት** _(መቆጣጠሪያው)_ — አንድ የማብራት/ማጥፋት token ገደብ ከመጠቀም ይልቅ፣ በጣም ርካሹን እና ኪሳራው አነስተኛ የሆኑትን ኤንጂኖች የሞዴሉን የአውድ መስኮት ለመግጠም እስከሚያስፈልግ ድረስ ብቻ ያስፋፋል። መመሪያ፦ `reserve-output` (ነባሪ፣ ሞዴልን የሚያውቅ) · `percentage` · `absolute`። ሁነታ፦ `floor` (መግጠሙን ያረጋግጣል) · `replace-autotrigger` (የእርስዎ ግልጽ ምርጫ ያሸንፋል) · `off` (የቆየ ገደብ)።
- **🎛️ መጨናነቅ የሚወሰንበት ቦታ** _(ቅድሚያ፣ ከፍተኛ → ዝቅተኛ)_ — በእያንዳንዱ ጥያቄ `x-omniroute-compression` header › የrouting-combo መሻር › ንቁ ስም ያለው profile › adaptive / auto-trigger › የፓነል ነባሪ › off። የተተገበረው ዕቅድ በ `X-OmniRoute-Compression: ; source=` response header ይመለሳል።
በtoken ገደብ ራስ-ሰር እንዲነሳ አድርግ፣ የሚለምደውን መቆጣጠሪያ አብራ፣ ስም ያለው profile ወደ አንድ ምርጫ አስቀምጥ፣ በአንድ ጥያቄ ላይ ብቻ ተግብር፣ ወይም በእያንዳንዱ routing combo ላይ pipeline መድብ — ለሥራው የሚስማማውን ምረጥ። ከለውጥ በፊት በተወሰነ corpus ላይ ታማኝነትን ከቁጠባ ጋር ለመመዘን የሚመረጥ፣ ከመስመር ውጭ **eval harness** (`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 እንዲፈቀዱ ካልተደረጉ የpackage lifecycle scripts እንዳይሰሩ ሊከለክል ይችላል። የOmniRoute `postinstall` (`node scripts/build/postinstall.mjs`) የnative runtime files ለማዘጋጀት ያስፈልጋል። በglobal ሲጭኑ በnpm ማስጠንቀቂያ ውስጥ የተጠቀሱትን packages ይፍቀዱ። በOmniRoute 3.8.54 የተመዘገበው የpackage ስብስብ፦
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> ይህን የመፍቀጃ ዝርዝር ለወደፊት global installs እንደገና ለመጠቀም፣ አንድ ጊዜ ያዋቅሩት ከዚያም በመደበኛ ሁኔታ ይጫኑ፦
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> የdependency ዝርዝሩ በrelease መካከል ሊቀየር ይችላል፤ npm የተለየ ዝርዝር ካሳየ፣ በዚያ ማስጠንቀቂያ ውስጥ ያሉትን package names ይጠቀሙ። አንድ package መፍቀድ የinstall scripts እንዲሰሩ ያስችላል።
> **Gemini Web ወይም ሌላ web-cookie provider እየተጠቀሙ ነው?** የnpm package ውስጥ
> Playwright አለ፣ የChromium binary ግን የለም። የመጀመሪያውን web-provider request
> ከማድረግዎ በፊት የ
> [Playwright Chromium ማዋቀሪያ](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> ማስታወሻን ይመልከቱ።
Dashboard በ `http://localhost:20128` · API በ `http://localhost:20128/v1`።
**2) ብቁ የሆነ provider የራስዎን account በመጠቀም ያገናኙ**
Dashboard → **Providers** → የአሁኑ ውሎችና quota ከአጠቃቀምዎ ጋር የሚስማማ provider ይምረጡ → API key ያክሉ ወይም የaccount flow ያጠናቅቁ። ነፃ tiers signup፣ approval ወይም payment method ሊጠይቁ ይችላሉ። [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md)ን ይመልከቱ፤ keyless availability የተረጋገጠ አይደለም፣ እና `tos: avoid` የተሰናደቡ providers በነባሪ ከ `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"
```
የተገናኙትን models በዝርዝር ማየት አለብዎት። 🎉 ይኸው ነው — ኮድ መጻፍ ይጀምሩ፣ OmniRoute ደግሞ በራስ-ሰር ይመራል እና fallback ያደርግልዎታል።
Clientዎ ብጁ headers መላክ ካልቻለ፣ OmniRoute tokenized compatibility aliases እንዲሁ ያቀርባል፦
```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 ...` ማያያዝ ለማይችሉ clients ብቻ ነው። Header auth አሁንም የሚመከረው ሁነታ ነው።
## 📦 ተጨማሪ የመጫኛ ዘዴዎች — Docker፣ ከምንጭ፣ pnpm፣ Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` ከታተሙት የተረጋጉ SemVer ስሪቶች ከፍተኛውን ይከተላል። git `main`ን አይከተልም። ለGitOps `:X.Y.Z`ን በቋሚነት ይጠቀሙ። [Docker የልቀት ቻናሎች](docs/guides/DOCKER_GUIDE.md#release-channels)ን ይመልከቱ። ምስሉ **`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 — በsrc/ እና open-sse/ ውስጥ 100% TypeScript (ከv2.0 ጀምሮ በዋናው ኮድ ውስጥ ዜሮ any) |
| ፍሬምወርክ | Next.js 16 + React 19 + Tailwind CSS 4 |
| የውሂብ ጎታ | better-sqlite3 (SQLite፣ WAL ጆርናሊንግ) + LowDB (የJSON ውርስ) — 147 የዶሜይን ሞጁሎች፣ 233 ማይግሬሽኖች |
| ማህደረ ትውስታ | የSQLite FTS5 ሙሉ-ጽሑፍ + int8-quantized የቬክተር ኢምቤዲንጎች፣ የተየበ መቀነስ |
| ስኪማዎች | Zod 4 — የMCP መሣሪያ I/O ማረጋገጫ + የAPI ውሎች |
| ፕሮቶኮሎች | MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE) |
| ዥረት ማስተላለፍ | Server-Sent Events (SSE) + WebSocket ድልድይ (/v1/ws) |
| መጭመቅ | 12-ሞተር የሂደት መስመር — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph |
| ማረጋገጫ እና ደህንነት | OAuth 2.0 (PKCE) + JWT + API Keys + MCP የተወሰነ ማረጋገጫ · AES-256-GCM በማከማቻ ላይ · DOMPurify |
| ስውርነት | wreq-js — JA3 / JA4 TLS የአሻራ ማስመሰል፣ 3-ደረጃ ፕሮክሲ |
| ጽናት | የወረዳ ማቋረጫ፣ ኤክስፖኔንሻል የመመለሻ መዘግየት፣ የተጠቃሚዎች በአንድ ጊዜ መጨናነቅን መከላከል፣ ራስ-ሰር ጥምረት ራስን መጠገን |
| መዝገብ ማድረግ | pino — የተዋቀሩ የJSON መዝገቦች ከጥያቄ አውድ ጋር |
| ሙከራ | Node.js test runner + Vitest — በ8,400+ በተከታተሉ የሙከራ ፋይሎች (ዩኒት፣ ኢንተግሬሽን፣ E2E፣ ደህንነት፣ ኢኮሲስተም) ውስጥ 60,000+ የማይንቀሳቀሱ የሙከራ መግለጫዎች |
| መድረኮች | ዴስክቶፕ (Electron) · Android (Termux) · PWA (ማንኛውም አሳሽ) |
| CI/CD | GitHub Actions — በልቀት ጊዜ ራስ-ሰር npm ማተም + Docker Hub |
| አገናኞች | ድረ-ገጽ · npm · Docker Hub |
## 📖 ሰነድ
### 📘 መጀመሪያ መጀመር
| ሰነድ | መግለጫ |
| የተጠቃሚ መመሪያ | አቅራቢዎች፣ ጥምረቶች፣ CLI ውህደት፣ ማሰማራት |
| የማዋቀሪያ መመሪያ | የተሟላ የመጫኛ ዘዴዎች፣ CLI መሣሪያ ውቅሮች፣ የፕሮቶኮል ማዋቀር፣ የጊዜ ማብቂያ ማስተካከያ |
| የCLI መሣሪያዎች መመሪያ | ለ Claude Code፣ Codex፣ Cursor፣ Cline፣ OpenClaw፣ Kilo፣ Copilot የተናጠል ማዋቀር |
| የርቀት ሁነታ | የርቀት OmniRoute (VPS) ን ከላፕቶፕዎ CLI በተወሰኑ የመዳረሻ ማስመሰያዎች መቆጣጠር |
| የ Claude Code ውቅር | Claude Codeን ወደ OmniRoute (አካባቢያዊ/ርቀት) በlaunch + ለእያንዳንዱ ሞዴል መገለጫዎች ማመልከት |
| ፈጣን መጀመሪያ | ባለ 3-ደረጃ መጫን → መገናኘት → ማዋቀር |
### 🔧 ክዋኔ እና ማሰማራት
### 🧠 ባህሪያት እና አርክቴክቸር
| ሰነድ | መግለጫ |
| አርክቴክቸር | የስርዓት አርክቴክቸር፣ የውሂብ ፍሰት እና ውስጣዊ አሠራሮች |
| የመጭመቂያ መመሪያ | ባለ 7-አማራጭ ሂደት፦ off / lite / standard / aggressive / ultra / RTK / stacked |
| RTK መጭመቂያ | የትዕዛዝ ውጤት መጭመቅ፣ ማጣሪያዎች፣ መተማመን፣ ማረጋገጥ፣ ጥሬ ውጤት መልሶ ማግኘት |
| የመጭመቂያ ሞተሮች | Caveman፣ RTK፣ የተደራረቡ ሂደቶች፣ dashboard/API/MCP በይነገጾች |
| የመጭመቂያ ደንቦች ቅርጸት | ለ Caveman እና RTK ማጣሪያዎች የ JSON ደንብ-ጥቅል መዋቅሮች |
| የመጭመቂያ ቋንቋ ጥቅሎች | የቋንቋ ማወቂያ እና የ Caveman ደንብ-ጥቅል ደራሲነት |
| የጽናት መመሪያ | የወረዳ ማቋረጫዎች፣ የማቀዝቀዣ ጊዜዎች፣ ወረፋ፣ የተጠቃሚዎች በአንድ ጊዜ መጨናነቅን መከላከል፣ TLS ማስመሰል |
| የራስ-ሰር ጥምረት ሞተር | በ16 ምክንያቶች የተመሠረተ ውጤት አሰጣጥ፣ የሁነታ ጥቅሎች፣ ራስን መፈወስ |
| የ Proxy መመሪያ | ባለ 3-ደረጃ የ proxy ስርዓት፣ 1proxy የገበያ ቦታ፣ የመዝገብ CRUD |
| ነጻ ደረጃዎች | የተጠናከረ ማውጫ፦ 34 በሰነድ የተደገፉ ተደጋጋሚ ስብስቦች / 465 በካታሎግ የተመዘገቡ የነጻ ደረጃ ግቤቶች |
| የባህሪያት ማሳያ | ከስክሪንሾቶች ጋር የሚታይ የ dashboard ጉብኝት |
| የኮድቤዝ ሰነድ | ለጀማሪዎች ተስማሚ የኮድቤዝ ማብራሪያ |
### 🤖 ፕሮቶኮሎች እና APIዎች
### 📋 ፕሮጀክት እና ጥራት
# ⭐ ከፍተኛ አስተዋጽኦ አበርካቾች
> OmniRoute በቁርጠኛ ክፍት-ምንጭ ማኅበረሰብ የተቀረጸ ነው። እነዚህ ግለሰቦች በፕሮጀክቱ ጥራት፣ መረጋጋት እና ተደራሽነት ላይ በቀጥታ ተጽዕኖ የሚያሳድሩ ልዩ አስተዋጽኦዎችን አበርክተዋል። **እናመሰግናለን።**
### በተዋሃዱ pull requestዎች የተደረደሩ ውጫዊ አስተዋጽኦ አበርካቾች
| ደረጃ | አስተዋጽኦ አበርካች | የተዋሃዱ PRዎች | ~የተቀየሩ መስመሮች |
| 1 | maxmad64bis | 418 | 25,367,739 |
| 2 | HouMinXi | 295 | 13,557,796 |
| 3 | pacocartones | 222 | 81,551 |
| 4 | backryun | 210 | 270,562 |
| 5 | JxnLexn | 198 | 3,570,623 |
| 6 | oyi77 | 190 | 411,243 |
| 7 | KooshaPari | 151 | 5,972,314 |
| 8 | rdself | 145 | 80,663 |
| 9 | RaviTharuma | 123 | 500,065 |
| 10 | herjarsa | 88 | 230,872 |
| 11 | hartmark | 85 | 2,849,623 |
| 12 | jonlwheat2-gif | 68 | 69,097 |
| 13 | artickc | 62 | 43,502 |
| 14 | xiaoyaner0201 | 59 | 126,220 |
| 15 | chirag127 | 52 | 6,661 |
| 16 | xz-dev | 50 | 245,976 |
| 17 | woodsonl | 48 | 811,771 |
| 18 | rqzbeh | 46 | 151,229 |
| 19 | MumuTW | 43 | 28,166 |
| 19 | QuangBlue | 43 | 13,112 |
የቆጠራው ጊዜ 2026-11-03 03:01:19 UTC ሲሆን በቀጥታ release/v3.8.53 ጫፍ 05bc048d6c ተከናውኗል። ገጽ-በ-ገጽ የሚቀርበው የGitHub GraphQL ቆጠራ 9,947 የተዋሃዱ PRዎችን ይዟል፦ 4,130 በማከማቻው ባለቤት፣ 240 በDependabot፣ 6 በሌሎች ቦቶች/መተግበሪያዎች እና 5,571 ውጫዊ PRዎች ከ883 የተለያዩ አስተዋጽኦ አበርካቾች የቀረቡ ናቸው። “የተቀየሩ መስመሮች” የGitHub ጨማሪዎች + ስረዛዎች ሲሆኑ የተፈጠሩ ፋይሎችን፣ lockfileዎችን፣ ካታሎጎችን፣ ትርጉሞችን እና ሰነዶችን ያካትታሉ፤ ይህ የለውጥ መጠን እንጂ በደራሲነት የተጻፉ LOCዎች አይደሉም። 53 PRዎች ከ500,000 መስመሮች በላይ የGitHub ልዩነቶችን ሪፖርት ያደርጋሉ (ለምሳሌ #13399፣ አንድ ነጠላ የአቅራቢ ጭማሪ፣ 2,347 የተቀየሩ ፋይሎችን ይዘረዝራል)፤ ይህም ከላይ ያሉትን በርካታ ድምሮች ያበዛል። እኩል ውጤት ያላቸው በአንድ ደረጃ ተመድበዋል።
### በGitHub የተመደቡ ኮሚቶች
በ2026-11-03 02:09:16 UTC እንደገና ተረጋግጧል፦ በGitHub Contributors API ለrelease/v3.8.53 ነባሪ ቅርንጫፍ የተዘገቡ በGitHub የተመዘገቡ ኮሚቶች። APIው 903 ማንነቶችን (429 ተጠቃሚዎች፣ 2 ቦቶች፣ 472 ስም-አልባዎች) መልሷል፤ ይህ ሰንጠረዥ አስተዳዳሪውን፣ ቦቶችን እና ስም-አልባ ማንነቶችን አያካትትም፣ እንዲሁም የውድድር እኩል ውጤቶችን ያስቀራል። ይህ ከላይ ከተጠቀሰው የተዋሃዱ PR ደረጃ እና ከታች ካለው የGit ሜታዳታ ቆጠራ የተለየ ነው።
> 🙏 የእነዚህ አበርካቾች ባህሪያት፣ የሳንካ ማስተካከያዎች እና የመሠረተ ልማት ማሻሻያዎች OmniRoute አስተማማኝና በብዙ ባህሪያት የበለፀገ እንዲሆን የሚያደርጉት የ**ዋና አካል** ናቸው። እያንዳንዱ pull request፣ እያንዳንዱ የሙከራ ጉዳይ እና እያንዳንዱ የi18n ትርጉም ፋይል ወሳኝ ነው። ክፍት ምንጭ ሶፍትዌር የሚገነባው እንደነሱ ባሉ ሰዎች ነው።
---
## 💖 ስፖንሰሮች
OmniRouteን ከራሳቸው ኪስ ለሚደግፉ ሰዎች ከልብ የመነጨ ምስጋና — እያንዳንዱ አስተዋጽኦ ፕሮጀክቱ ነፃ፣ ገለልተኛ እና በእንቅስቃሴ ላይ እንዲቆይ ያደርጋል።
… እና ማንነታቸውን በምስጢር ማቆየት የሚመርጡ ሌሎች 💛
ይፋዊ የGitHub Sponsors መረጃ በ2026-10-18 በGitHub Sponsors GraphQL API በኩል እንደገና ተረጋግጧል፦ በአጠቃላይ ካሉ 14 ስፖንሰርነቶች ውስጥ 11 ይፋዊ ስፖንሰርነቶች (6 ንቁ፣ 5 የቀድሞ)። ከላይ ያሉትን የንቁነት መለያዎች የሚወስነው የGitHub isActive ሁኔታ ነው፤ የቀድሞ ይፋዊ የአንድ ጊዜ ደጋፊዎች ምስጋናቸውን እንደተጠበቀ ይቆያሉ፣ የግል ስፖንሰሮችም ማንነታቸው ሳይገለጽ ይቀራሉ። Ko-fi፣ Buy Me a Coffee፣ Liberapay፣ PIX እና የክሪፕቶ ልገሳዎች ይፋዊ የስፖንሰር መዝገብ ስለሌላቸው አልተዘረዘሩም።
💖 ስፖንሰር ይሁኑ → — እያንዳንዱ ዶላር OmniRoute ነፃ እና ገለልተኛ ሆኖ እንዲቆይ ያግዛል።
## 👥 1,000+ አስተዋጽኦ አድራጊዎች
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
በ2026-11-02 በቀጥታ ባለው release/v3.8.53 ጫፍ 1c7135e0fb (7,972 ኮሚቶች) ላይ የተደረገ ኦዲት፦ 1,074 መደበኛ የሰው Git መለያዎች — 759 እንደ ኮሚት አዘጋጆች (ጠባቂውን ጨምሮ) ይታያሉ፣ 315 ደግሞ በግልጽ Co-authored-by ተከታይ መስመሮች ውስጥ ብቻ ይገኛሉ። ይህ ቆጠራ .mailmapን ይተገብራል፣ የኢሜይል አድራሻዎችን የፊደል አጻጻፍ ልዩነትን ሳይመለከት ያነጻጽራል፣ ቁጥራዊ እና መደበኛ የGitHub noreply አድራሻዎችን ተመሳሳይ መያዣ ሲያመለክቱ ብቻ ያገናኛል፣ 29 የቦት/ወኪል/አገልግሎት/placeholder መለያዎችን ያስወግዳል፣ እና ተራ የኢሜይል አድራሻዎችን የማሳያ ስሞቻቸው ተመሳሳይ ስለሆኑ ብቻ አያዋህድም። የ2026-08-24 ኦዲት 639 አሳትሟል፤ ይህ ዘዴ በዚያ ኦዲት መነሻ ac02c5b42f ላይ እንደገና ሲሰራ 619 ያሳያል። ስለዚህ ጭማሪው የመጣው ከአዳዲስ አስተዋጽኦ አድራጊዎች እንጂ ከቀለል ያለ ዘዴ አይደለም።
### እንዴት አስተዋጽኦ ማድረግ እንደሚቻል
1. ማከማቻውን ፎርክ ያድርጉ
2. ከ**ንቁ** `release/vX.Y.Z` ጫፍ (ከ `main` ሳይሆን) ቅርንጫፍ ይፍጠሩ — [የቅርንጫፍ አሰራር እና የልቀት ሞዴል](docs/ops/BRANCHING_MODEL.md)ን ይመልከቱ
3. የባህሪ ቅርንጫፍዎን ይፍጠሩ (`git checkout -b feat/amazing-feature`)
4. ለውጦችዎን ኮሚት ያድርጉ (`git commit -m 'feat: add amazing feature'`)
5. ወደ ቅርንጫፉ ይጫኑ (`git push origin feat/amazing-feature`)
6. መነሻ = ያ `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 የተወሰነ ክፍልን ቀርጿል። ይህ ለሁሉም የምናቀርበው ምስጋናችን ነው። 🙏
> ⭐ የኮከብ ቁጥሮች እ.ኤ.አ. ኖቬምበር 3፣ 2026 ከGitHub's REST API ተረጋግጠዋል — ለእነዚህ ፕሮጀክቶች ኮከብ ስጡ። ቁጥሮቹ በተወሰነ ቀን የተወሰደ ትክክለኛ ቅጽበታዊ መረጃ ስለሆኑ በተፈጥሮ ይለወጣሉ።
### 🧬 የዘር ሐረግ እና ጌትዌይ
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳው |
| 9router | 31,861 | ይህ ፎርክ የተገነባበት የመጀመሪያው ፕሮጀክት — እዚህ በብዙ-ሞዳል APIs እና ሙሉ የTypeScript እንደገና ጽሑፍ ተሻሽሏል። |
| CLIProxyAPI | 57,329 | ይህን የJavaScript / TypeScript ማስተላለፊያ ያነሳሳው የGo አተገባበር። |
| LiteLLM | 62,580 | የይፋ የዋጋ መረጃ ስብስቡ የወጪ ክትትል ማመሳሰያችንን የሚመግብ፣ እና የአቅራቢዎች መደበኛነት ሞዴሉ ለአዘዋወራችን መረጃ የሰጠው የAI ጌትዌይ። |
| codex-chatgpt-web | 15,435 | በተካተተው ChatGPT Web → Codex Responses ድልድይ ውስጥ የተስተካከለ የMIT ምንጭ፣ የአሳሽ-ክፍለ ጊዜ፣ የምላሽ-ፍሬሚንግ፣ የአጠቃቀም እና የድር-ፍለጋ አስማሚዎችን ጨምሮ። |
| free-claude-code | 65,966 | በዥረት መልሶ ማግኛ፣ የno-thinking ተለዋጭ ስሞች፣ የመጠባበቂያ የድር ፍለጋ፣ ተንሸራታች-መስኮት ገደቦች፣ የሎግ ማጥፋት እና ጠንካራ የአስጀማሪ ፍሰቶች ውስጥ የተላለፉ ንድፎች። |
| composer-api | 347 | የCursor Composer የመሣሪያ-ምርጫ፣ የውጤት-ገደብ እና የመሣሪያ-መፈጸሚያ ንድፎች ወደ ቤተኛው Cursor አስፈጻሚ ተስተካክለዋል። |
| codex-multi-auth | 561 | የአዲስ-መግቢያ እና የrefresh-token ሽክርክር ንድፎች ወደ Codex OAuth እንደገና ማረጋገጫ ተላልፈዋል። |
| opencode-anthropic-auth | 562 | ከClaude Code ጋር ተኳሃኝ የሆኑ የለውጥ ነባሪዎች እና የክፍያ-ራስጌ ባህሪ ወደ OmniRoute ውቅረት-ተኮር ድልድይ በአጠቃላይ ተስተካክለዋል። |
| grok2api-merged | 2 | የGrok ሞዴል ካርታዎቹ፣ የሐሰት-TypeError Statsig ጀነሬተሩ፣ የጥያቄ እና የመሣሪያ ነባሪዎቹ፣ እና የNDJSON ምላሽ አቀናባሪው በተጨባጭ ወደ OmniRoute የGrok Web አስፈጻሚ ተስተካክለዋል። |
| TQZHR/grok2api | 707 | ከgrok2api-merged በስተጀርባ ያለው ዋና ተሻጋሪ የኮድ ምንጭ፤ የሞዴል፣ የራስጌ፣ የpayload፣ የStatsig እና የአቀናባሪ አተገባበሮቹ በGrok Web የዘር ሐረግ ውስጥ ተጠብቀዋል። |
| chenyme/grok2api | 7,874 | ለGrok payload እና የመሣሪያ ነባሪዎች፣ ለStatsig ጀነሬተር እና በTQZHR እና grok2api-merged በኩል ለተላለፈው result.response አቀናባሪ መሠረት የሆነው የMIT ምንጭ። |
| grok2api-pro | 27 | በgrok2api-merged ለproxy-pool ንብርብሩ እንደ ምንጭ የተጠቀሰ ተሻጋሪ ምንጭ፤ OmniRoute ያንን የዘር ሐረግ ማስታወሻ ይጠብቃል እንጂ በወሰነው የGrok Web አስፈጻሚ ውስጥ የproxy-pool ማስተላለፊያ እንዳደረገ አይገልጽም። |
| GrokProxy | 52 | በኩኪ-የተረጋገጠው የGrok ፕሮክሲ እና result.response.token የዥረት ንድፉ የOmniRoute የGrok Web ትራንስፖርትን አነሳስቷል። |
| GrokBridge | 5 | የመጀመሪያው የGrok Web አተገባበር የHTTP/አሳሽ የupstream ንድፉን ለመረዳት ተመርምሯል፤ ቀጥተኛ የHTTP መንገዱ ከGrokProxy የተገኘ ስለሆነ ራሱን የቻለ የኮድ ማስተላለፊያ እንደተደረገ አይገልጽም። |
### 🗜️ አውድ እና የቶከን መጨመቂያ — ሞተሮች
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳው |
| Caveman | 116,957 | በቫይረል የተሰራጨው “ለምን ብዙ ቶከኖችን ትጠቀማለህ፣ ጥቂት ቶከኖች ብቻ በቂ ሲሆኑ” የሚለው ፕሮጀክት — የካቭማን ንግግር ፍልስፍናው የእኛን መደበኛ የመጭመቂያ ሁነታ እና ከ30 በላይ የመሙያ/የማጠቃለያ ደንቦችን ያንቀሳቅሳል። |
| RTK – Rust Token Killer | 85,350 | ከፍተኛ-አፈጻጸም ያለው የትዕዛዝ ውጤት መጭመቂያ — የእኛን RTK ሞተር፣ JSON ማጣሪያ DSL፣ ጥሬ ውጤት መልሶ ማግኛ እና የተደራረበውን RTK → Caveman ቧንቧ መስመር አነሳስቷል። |
| headroom | 78,672 | ሊቀለበስ የሚችል የአውድ መጭመቂያ (SmartCrusher) — የእኛን headroom ሞተር እና የccr መልሶ ማግኛ-ምልክት ንድፍ አነሳስቷል። |
| LLMLingua | 6,797 | የጥያቄ መጭመቂያ ምርምር (LLMLingua / LLMLingua-2) — የእኛን ያልተመሳሰለ፣ ኮድን የሚጠብቅ፣ ስህተት ሲከሰት መስራቱን የሚቀጥል llmlingua ሞተር አነሳስቷል። |
| llmlingua-2-js | 33 | የእኛ የLLMLingua ሞተር የሰራተኛ-ክር ጀርባ ክፍል ሆኖ የሚያገለግለው የJS/ONNX ወደብ (MobileBERT / XLM-RoBERTa)። |
| Troglodita | 50 | የPT-BR ቶከን መጭመቂያ — ለብራዚል-ፖርቱጋልኛ ሰዋሰው የተስተካከለ የእኛን pt-BR የቋንቋ ጥቅል፣ የተደጋጋሚ ቃላት መቀነስ እና የመሙያ ቃላት ማስወገድን ያንቀሳቅሳል። |
| ponytail | 182,929 | በቫይረል የተሰራጨው “ሰነፍ ከፍተኛ ደረጃ ገንቢ” YAGNI-coder ችሎታ — የእኛን less-code የውጤት ዘይቤ አነሳስቷል፦ የሚሰራ ለውጥን በትንሹ ለማድረግ የሚመራ አቀራረብ፣ _የሚመነጨውን_ ኮድ የሚቀንስ (ከካቭማን አጭር ንግግር ጋር በውጤት-ዘንግ የሚመሳሰል)። |
| i-have-adhd | 59,838 | ተግባርን ቅድሚያ የሚሰጥ እና ADHDን የሚያስብ የምላሽ ዘይቤው በአምስት ቋንቋዎች የOmniRoute አጭር የውጤት ዘይቤ ላይ ተስተካክሏል። |
### 🧩 የታመቁ ቅርጸቶች፣ የቶከን ምርምር እና ኮድን የሚያውቁ መሳሪያዎች
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳው |
| TOON | 25,602 | ቶከንን ያማከለ የነገር ኖቴሽን — የአምድ፣ ራስጌ-ከረድፎች ሞዴሉ የእኛን የሰንጠረዥ ማጠቃለያ ደረጃ ቀርጾታል። |
| GCF – Graph Compact Format | 61 | የታመቀው የግራፍ ቅርጸት እና አጠቃላይ-መገለጫ ንድፉ የOmniRouteን የሰንጠረዥ ማጠቃለያ እና የHeadroom ኮዴክ ቅርጸት አሳውቋል። |
| gcf-typescript | 4 | እንደ Headroom አጠቃላይ-መገለጫ ኮዴክ በቀጥታ ወደ አብሮ የተካተተ እና የተራዘመው የMIT TypeScript ትግበራ። |
| token-optimizer-mcp | 566 | Brotli/SQLite መሸጎጫ + በእያንዳንዱ ክፍለ-ጊዜ የአውድ-ልዩነት — የእኛን session-dedup ሞተር አነሳስቷል። |
| token-savior | 1,203 | የBash ውጤት ማጠቃለያ + MCP መገለጫዎች — የእኛን የመጭመቂያ መተው ዲሲፕሊን እና የMCP መሳሪያ-ማኒፌስት ቅነሳ አነሳስቷል። |
| token-saver | 162 | ይዘትን የሚያውቅ፣ በፋይል ዓይነት የሚለያይ የውጤት መጭመቂያ ከስህተት ግንዛቤ ጋር መተው — የእኛን በዓይነት የማሰራጨት እና አነስተኛ ትርፍ ሲኖር የመዝለል አቀራረብ አረጋግጧል። |
| token-optimizer | 2,853 | “የመንፈስ ቶከኖችን ፈልግ” — የእሱ የማስወጣት + መልሶ ማግኛ መያዣ ንድፍ የእኛን የCCR ማስወጣት አስተሳሰብ አሳውቋል። |
| TokenMizer | 34 | የክፍለ-ጊዜ ግራፍ + በተራዎች መካከል የመስመር-ድግግሞሽ ማስወገጃ ንድፍ፣ የእኛን የsession-dedup ንድፍ አሳውቋል። |
| OmniCompress | 3 | የRust አምዳዊ-JSON + ይዘት-በአድራሻ የሚጠራ + በመልዕክቶች መካከል የድግግሞሽ ማስወገድ — የእኛን headroom/ccr/session-dedup ሞተር ንድፍ እና መሸጎጫ-የተረጋጋውን “የተጨመቀው ቅርጽ ከቦታ ነፃ ነው” መርህ አረጋግጧል። |
| mcp-compressor | 140 | የMCP መሳሪያ-ስኪማ/መግለጫ መጭመቂያ — የእኛን የMCP መሳሪያ-ማኒፌስት ብዛት ቅነሳ አሳውቋል። |
| RepoMapper | 218 | የAider-ዓይነት የሪፖ-ካርታ ደረጃ አሰጣጥ — የእኛን የሪፖ-ካርታ / የመልሶ ማግኛ-ደረጃ አሰጣጥ ምርምር አሳውቋል። |
| quiet-shell-mcp | 4 | በMCP ላይ የተመሰረተ የሼል-ውጤት ቅነሳ — የእኛን የታወጀ የbash-ውጤት ማጠቃለያ አረጋግጧል። |
| ts-morph | 6,222 | የTypeScript ኮምፓይለር API መሳሪያ ስብስብ — ሕብረቁምፊ፣ አብነት እና regex ሊተራልስን እየጠበቀ በፓርሰር ላይ የተመሰረተ አስተያየት ማስወገዳችንን አነሳስቷል። |
### 🧠 ማህደረ ትውስታ እና RAG
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
| Mem0 | 68,294 | ሁለንተናዊ የማስታወሻ ንብርብር — የእሱ proxy-as-write/read-boundary ሞዴል የማስታወሻ አርክቴክቸራችንን ቀርጾታል። |
| Letta (MemGPT) | 25,321 | በደረጃ የተደራጀ ማስታወሻ ያላቸው ሁኔታ-ጠባቂ ኤጀንቶች — የእኛን Context Control & Recovery (CCR) በደረጃ የተደራጀ ሞዴል አነሳስቷል። |
| WFGY | 1,804 | የ16 ተደጋጋሚ RAG/LLM ውድቀት ሁኔታዎች የProblemMap ምደባ — በመላ የመላ ፍለጋ መመሪያችን ውስጥ የምንጋራው የቃላት ማውጫ። |
### 🛰️ የትራፊክ ምርመራ፣ MITM እና ግልጽ ፕሮክሲ
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
| llm-interceptor | 81 | የcoding-assistant ↔ LLM ትራፊክ የMITM ጣልቃ ገብነት/ትንተና የመጀመሪያዎቹን የTraffic Inspector መስፈርቶች አበረታታ። ቀደም ሲል የተነደፉ አራት ሞጁሎች — SSE ማዋሃድ፣ የውይይት መደበኛነት ማስጠበቅ፣ ሚስጥራዊ መረጃ መሸፈን እና ራስጌ ማጽዳት — በይፋ በሚገኙ የፕሮቶኮል ደረጃዎች ላይ በተመሰረቱ ገለልተኛ እና ንጹህ-ክፍል አተገባበሮች ተተክተዋል። ሁለቱ የhost-passthrough ገጽታዎች (passthrough.ts እና _internal/bypass.cjs) እንደ የOmniRoute ውስጣዊ አተገባበሮች ተለይተው ይቀራሉ፤ በዚያ መተካት አካል ሆነው እንደገና አልተጻፉም። |
| ProxyBridge | 6,978 | ግልጽ በሆነ መልኩ በእያንዳንዱ ሂደት የሚደረግ የፕሮክሲ ማዞሪያ — ከብልሽት የሚጠብቀውን የMITM መዝጋት፣ የሶኬት የእንቅልፍ ጊዜ ገደቦች፣ የ/proc ሂደት መለያ እና TPROXY ቀረጻ አነሳስቷል። |
### 📚 የሞዴል መረጃ፣ ታዛቢነት እና UI
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
| models.dev | 7,486 | የAI ሞዴሎች ዝርዝር መግለጫዎች፣ ዋጋዎች እና ችሎታዎች ክፍት የሆነ የመረጃ ቋት — በተፈጥሮ ወደ የሞዴል ካታሎጋችን ይመሳሰላል። |
| React Flow / xyflow | 38,874 | በእውነተኛ ጊዜ የሚሰሩትን Compression Studio እና Combo/Routing Studio የሚያንቀሳቅሰው ኖድ-ተኮር የግራፍ ቤተ-መጽሐፍት። |
| LangGraph | 44,349 | የLangGraph Studio የቀጥታ የስራ ፍሰት-ግራፍ ምስላዊ አቀራረብ የStudios በእውነተኛ ጊዜ የcascade እይታችንን አነሳስቷል። |
| Langfuse | 36,907 | የእሱ trace → span → generation የታዛቢነት ሞዴል የCompression Studio waterfall አቀራረባችንን ቀርጾታል። |
| Kiali | 3,647 | የIstio የአገልግሎት-መረብ ታዛቢነት — በRouting/Combo Studio ውስጥ የሰርኪዩት-ብሬከር ባጆችን እና የስህተት-ጠርዝ ምስላዊ አቀራረቦችን አነሳስቷል። |
| lobe-icons | 2,666 | በዳሽቦርዳችን ላይ የአቅራቢዎችን አዶዎች የሚያሳዩ የAI/LLM ብራንድ ሎጎዎች። |
| flag-icons | 12,499 | በREADME የቋንቋ መራጭ ውስጥ የሚጠቀሙትን በMIT ፈቃድ የተሰጣቸው SVG ባንዲራዎች ያቀርባል። |
### 🛡️ ደህንነት
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
| awesome-secure-defaults | 723 | በነባሪ ደህንነታቸው የተጠበቀ ቤተ-መጻሕፍት የተመረጠ ዝርዝር፣ የደህንነት ምርጫዎቻችንን (Helmet.js፣ DOMPurify፣ ssrf-req-filter፣ safe-regex፣ Google Tink) ይመራል። |
### 🧭 ተጨማሪ መሣሪያዎች
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
| ClawRouter | 6,649 | የጥያቄ ድግግሞሽ ማስወገድን፣ የአደጋ ጊዜ ዜሮ-ወጪ አማራጭን፣ ሊሰኩ የሚችሉ Auto-Combo ስትራቴጂዎችን እና ባለብዙ ቋንቋ የዓላማ ምደባን አነሳስቷል። |
| Antigravity-Manager | 32,785 | የእሱ መለያን የሚያውቅ የሞዴል ዳግም ካርታ ስራ፣ የሚፈጸም ፋይል ዱካ ማረጋገጫ እና የዕቅድ-መለያ አሠራር የOmniRoute Antigravity runtimeን አሳወቁ። |
| vscode-antigravity-cockpit | 4,852 | የእሱ አጭር የኮታ-ዳግም ማስጀመሪያ ቆጠራ ቅርጸት በOmniRoute ውስጥ ያለውን ተመሳሳይ የአቅራቢ-ገደብ ማሳያ አነሳስቷል። |
| AionUi | 33,996 | የእሱ ACP ውህደቶች የተጫኑ CLI ኤጀንቶችን በራስ-ሰር እንዲያገኝ OmniRouteን አነሳስተዋል። |
| CodexBar | 22,955 | የGrok Build ኮታ ገጽታን ለይቷል፤ ከዚያም OmniRoute የቀጥታ wire ቅርጸቱን በተናጠል አረጋግጦ አስተካክሏል። |
## 📄 ፈቃድ
የMIT ፈቃድ - ለዝርዝሮች [LICENSE](LICENSE) ይመልከቱ።
---
**[⬆ ወደ ላይ ተመለስ](#-omniroute)** · ለክፍት-ምንጭ AI ማህበረሰብ በ❤️ የተሰራ።
በDiego Souza የተፈጠረ · OmniRoute v3.8.54 · Node ≥22.22.2 · የMIT ፈቃድ · omniroute.online