Restores `memory_id` to the `memory_fts_au` trigger's `WHEN` clause and adds an FTS5 rebuild to the memory cleanup pass. This repairs a regression that landed yesterday: migration 178 guarded the trigger with `old.content IS DISTINCT FROM new.content OR old.key IS DISTINCT FROM new.key`, which drops the `memory_id` term the insert path depends on. `createMemory` inserts the row, the AFTER INSERT trigger stores an auto-assigned FTS5 rowid, and the follow-up `UPDATE memories SET memory_id = rowid` is what re-syncs FTS — an update that touches neither `content` nor `key`. With 178 alone that update stopped firing, so newly created memories drifted out of the FTS index and keyword/hybrid search silently returned nothing for them. Migration 180 adds the third term back. Maintainer note before merge: the cleanup half now runs `rebuild` on every pass rather than `optimize` only when rows were deleted — accepted as-is; it is bounded by the memory table size and the trigger fix removes the bloat source that motivated it. Validated as a combined board first (this PR merged with the 11 siblings of the same batch on the release tip): eslint on every changed file with the suppressions file, typecheck:core, check:open-sse-typecheck, complexity, cognitive-complexity, changelog-integrity, i18n new-key coverage, docs-sync, migration-numbering, provider-consistency and a duplicate-identifier audit all green, plus 275 passing / 0 failing focused node:test cases across the 28 test files the batch touches. Then re-validated alone on the fresh tip before this merge: conflicts re-resolved, file sizes rebaselined for this PR's own growth, eslint and this PR's focused tests re-run. Thanks @HouMinXi!
README (አማርኛ)
🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW
💰 ~1.47B ነፃ Tokens / በወር
ነፃ ደረጃዎችን በእጅ መደራረብ አስቸጋሪ ነው — በደርዘን የሚቆጠሩ SDKዎች፣ በደርዘን የሚቆጠሩ የፍጥነት ገደቦች፣ እና በእርግጥ ምን ያህል እንዳለዎት ማወቅ አይቻልም። OmniRoute በ34 ተደጋጋሚ pool keys ውስጥ ያሉ 444 የነፃ ደረጃ ግቤቶችን ይመዘግባል፣ እንዲሁም የtokens ዋና ቁጥርን ይፋ የሆነ አዎንታዊ ወርሃዊ በጀት ካላቸው 16 pools እና አምስት የእያንዳንዱ ሞዴል Groq caps ያሰላል፤ በጋራ pool የተደጋገሙትንም ያስወግዳል። ከክልላዊ የማንነት ማረጋገጫ በኋላ ብቻ የሚከፈቱ ኮታዎች (በአሁኑ ጊዜ፦ ModelScope) በተለየ ሁኔታ ይታያሉ፤ +~6M ከክልላዊ የማንነት ማረጋገጫ በስተጀርባ ያሉ ሲሆን በዋናው ቁጥር ውስጥ ፈጽሞ አይደመሩም። ውጤቱ በዳሽቦርዱ (
/dashboard/free-tiers) ላይ ሁልጊዜ ይታያል።
የቀጥታው
/dashboard/free-tiersገጽ የታነመ ማጠቃለያ። ሙሉ ዘዴው (የpool ድግግሞሽ ማስወገድ፣ የክሬዲት ደረጃዎች፣ የአቅራቢ ውሎች)፦ docs/reference/FREE_TIERS.md።እነዚህ ቁጥሮች በየሁለት ሳምንቱ ከቀጥታው ካታሎግ ጋር እንደገና ኦዲት ይደረጋሉ፣ እና በሁለቱም አቅጣጫ ይንቀሳቀሳሉ — አንድ አቅራቢ ነፃ ደረጃውን ሲያቋርጥ ቁጥሩ ይቀንሳል፤ አዲስ ሲጨመር ደግሞ ይጨምራል። ካታሎጉ በእውነት የሚያሰላውን እናትማለን፤ የተጋነነ ምርጥ ሁኔታን ፈጽሞ አናቀርብም።
⭐ OMNIROUTE ገንዘብ እንዲቆጥቡ እና ሥራዎን እንዲያቀሉ ከረዳዎት repoውን Star ያድርጉ።
💬 ማህበረሰቡን ይቀላቀሉ
👋 ጠባቂውን ይከተሉ — ስለ አዳዲስ አቅራቢዎች፣ releases እና ጠቃሚ ምክሮች ቀድመው ይወቁ፦
ጥያቄዎች፣ የአቅራቢ ጠቃሚ ምክሮች፣ የወደፊት ዕቅድ እና ድጋፍ → Discord · Telegram · WhatsApp 🌍 ዓለም አቀፍ / 🇧🇷 ብራዚል / ፖርታል
📈 ጌትዌዩ ማደጉን ቀጥሏል
| v3.8.49 | v3.8.50 | v3.8.51+ |
|
|---|---|---|---|
| 🌐 አቅራቢዎች | 290 | 352 | ተጨማሪ በወረፋ ላይ |
| 🧠 ልዩ የውይይት ሞዴል መለያዎች | 1185 | 1312 | — |
| 🖼️ የሞዳሊቲ ድልድይ | — | 🆕 ምስል + ድምፅ + ቪዲዮ | — |
| 📡 የራዳር ነፃ ካታሎግ | — | 🆕 በፈቃድ የሚነቃ | — |
| ⚖️ ኮታን ያገናዘበ መርሐግብር | — | 🆕 Quota-Share | — |
| 📊 የኮታ ቴሌሜትሪ | — | 🆕 ቀጥታ | — |
→ የወደፊት ዕቅድ — ወደ v3.9.0 LTS በፍጥነት በመጓዝ ላይ
🧩 ይገኛል
| 🚀 ጀምር | 🚀 ፈጣን ጅምር | 📦 ጫን | 🆓 ምንም ውቅር አያስፈልግም |
| 💡 ተማር | 💥 ቃል ኪዳኑ | 🤔 OmniRoute ለምን? | 🏆 ልዩ የሚያደርገው |
| ⚙️ ባህሪያት | 🎯 ጥምረቶች | 🌐 አቅራቢዎች | 🔌 CLI & MCP |
| 🗜️ መጭመቅ | 🖥️ የሚሠራበት ቦታ | 🔒 የግል | |
| 👀 ይመልከቱት | 🎬 በተግባር | ✨ አዲስ ነገር | 🤖 ተኳኋኝ CLIs |
| 💚 ድጋፍ | 💚 ድጋፍ / ልገሳ | 💬 ማህበረሰብ | 💖 ስፖንሰሮች |
| 📦 ፕሮጀክት | 🛠️ የቴክኖሎጂ ስብስብ | 📖 ሰነዶች | 👥 አስተዋጽዖ አድራጊዎች |
🆓 እንደጫኑት ወዲያውኑ ይሰራል — ቁልፍ አያስፈልግም፣ ውቅር አያስፈልግም
# አዲስ ጭነት፣ ምንም ማረጋገጫ መረጃ አያስፈልግም — `auto` አስቀድሞ ይሰራል፦
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
የተወሰነ ነፃ backend ይመርጣሉ? oc/… (OpenCode Free)ን በቀጥታ ይጥሩ። ከዚያ autoን ይጠቀሙና OmniRoute እንዲመርጥ ይፍቀዱ።
📦 በቀጥታ ቀድተው የሚለጥፏቸው ፈጣን መጀመሪያ ስክሪፕቶች ለPython, Node.js, PHP, እና cURL → examples/quickstart/
💥 ቃል ኪዳኑ
🤔 OmniRoute ለምን?
🤝 በክፍት ምንጭ ወዳጆቻችን የተደገፈ
እንደ ክፍት ምንጭ ወዳጅ መቀላቀል ይፈልጋሉ? እነዚህ ክፍት ምንጭን የሚደግፉና OmniRoute ወደፊት እንዲራመድ የሚያግዙ ኩባንያዎች ናቸው — እኛም የሚሰጡን እያንዳንዱ token የት እንደሚውል በይፋ እንገልጻለን። ያነጋግሩን፦ 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 ክሬዲቶች በAI ማረጋገጫ ለሚደረግለት የOmniRoute የልቀት ሂደት — ከመላኩ በፊት እያንዳንዱን pull request የሚገመግመውን በKimi K3 ኃይል የሚሰራ የmerge ማረጋገጫ ደረጃ — እንዲሁም ለዕለት ተዕለት የባህሪ ልማት ኃይል ይሰጣሉ። የከፍተኛ ደረጃ Kimi ድጋፍ በሁለቱም መንገዶች ይቀርባል፦ ቀጥተኛው Kimi API ( kimi-k3) እና የKimi Code ኮድ ማዘጋጃ ዕቅድ (OAuth እና API key)። OmniRoute በKimi የድጋፍ ፕሮግራም ውስጥ የመጀመሪያው የብራዚል ክፍት-ምንጭ ፕሮጀክትም ነው። የKimi API key ከ15% ተጨማሪ ክሬዲቶች ጋር ያግኙ →
|
|
Cheaper Inference cheaperinference.com |
የOmniRoute ክፍት ምንጭ ወዳጅ ለሆነው Cheaper Inference ይህን ፕሮጀክት ስለደገፈ እናመሰግናለን! Cheaper Inference 42 የከፍተኛ ደረጃ ሞዴሎችን — Claude፣ GPT-5.x፣ Gemini፣ Kimi K3፣ GLM፣ DeepSeek፣ Grok እና MiniMax — በአንድ ከOpenAI ጋር ተኳሃኝ በሆነ endpoint በድጋሚ የሚሸጥ፣ በወጪ ደረጃ የተመደበ gateway ነው፤ እያንዳንዱን request ከሞዴሉ አምራች ዝርዝር ዋጋ በላይ ሳያስከፍል ወደ በጣም ርካሹ ብቁ provider ይመራል።
በOmniRoute ውስጥ የከፍተኛ ደረጃ ድጋፍ፦ Chat Completions፣ ውስጣዊው /v1/responses endpoint፣ የምስል እይታ፣ tool calling እና 3 የምስል ሞዴሎች (grok-imagine፣ nano-banana-pro፣ nano-banana-2፣ እንደ cheaperinference/<model> ሊደረስባቸው የሚችል)። API key ያግኙ →
|
aff=omniroute የሚል መለያ ያላቸው አገናኞች የአጋርነት አገናኞች ናቸው። እርስዎ ተጨማሪ ወጪ ሳይከፍሉ ፕሮጀክቱን ይደግፋሉ።
🎟️ የአጋርነት ማስተዋወቂያ — እኛ ከማንደግፋቸው providers ነፃ የምዝገባ ኩፖኖች (ለማስፋት ጠቅ ያድርጉ)
ይህ ክፍል ለreferral/ኩፖን codes ብቻ ነው። ስፖንሰር የተደረጉ አጋርነቶች ከላይ ባለው 🤝 በክፍት ምንጭ ወዳጆቻችን የተደገፈ ክፍል ውስጥ ይገኛሉ። OmniRoute እዚህ ከተዘረዘሩት providers ጋር ምንም የስፖንሰርነት ወይም የአጋርነት ግንኙነት የለውም — እነዚህ ማንኛውም ሰው ሊጠቀምባቸው የሚችሉ ይፋዊ ኩፖኖች ናቸው።
|
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 ከዚህ provider ጋር ምንም የስፖንሰርነት ወይም የአጋርነት ግንኙነት የለውም። |
የOmniRoute ተጠቃሚዎችን የሚጠቅም ለጋስ ነፃ የምዝገባ ኩፖን ያለው ሌላ provider ያውቃሉ? issue ይክፈቱ፣ እኛም እዚህ እንጨምረዋለን።
🎯 ኮምቦዎች — ዋናው ባህሪ
ኮምቦ OmniRoute በራስ-ሰር የሚያዘዋውርባቸው የሞዴሎች ሰንሰለት ነው። ኮታው ካለቀ፣ አቅራቢው ካልሰራ ወይም ወጪዎች በድንገት ከጨመሩ፣ ኮምቦው ወደሚቀጥለው ብቁና ጤናማ ሞዴል መሄድ ይችላል። 🛡️
⚡ ዜሮ-ውቅር — autoን ብቻ ይጠቀሙ
መፍጠር ያለብዎት ኮምቦ የለም። ሞዴልዎን ወደ auto (ወይም አንዱ ተለዋጩ) ያዘጋጁ፤ OmniRoute ከተገናኙት አቅራቢዎችዎ በቀጥታ ነጥብ እየሰጠ ምናባዊ ኮምቦ ይገነባል፦
| የሞዴል ID | የሚያመቻቸው ነገር |
|---|---|
auto | 🎯 ሚዛናዊ ነባሪ (LKGP — በመጨረሻ ጥሩ ከነበረው አቅራቢዎ ጋር ይቆያል) |
auto/coding | 🧑💻 ለኮድ ማመንጨት ጥራትን ቅድሚያ የሚሰጡ ክብደቶች |
auto/fast | ⚡ በመጀመሪያ ዝቅተኛው መዘግየት |
auto/cheap | 💰 በመጀመሪያ በቶከን ዝቅተኛው ዋጋ |
auto/offline | 🔋 በመጀመሪያ ከፍተኛው የኮታ / የፍጥነት-ገደብ ትርፍ አቅም |
auto/smart | 🔭 ጥራትን ቅድሚያ መስጠት + የተሻሉ ሞዴሎችን ለማግኘት 10% ሙከራ |
auto/lkgp | 📌 ከመጨረሻው ጥሩ አቅራቢ ጋር በግልጽ መቆየት |
auto/chaos | 🧪 የመቋቋም ችሎታን ለመፈተሽ የስህተት-መወጋት ክብደቶች (የchaos ምህንድስና) |
🔀 ወይም የራስዎን ይገንቡ — 19 የማዘዋወሪያ ስልቶች
ሁሉም 19 ስልቶች — በእያንዳንዱ የኮምቦ ደረጃ እንደፈለጉ ያዋህዱ፦
| # | ስልት | የሚያደርገው ነገር |
|---|---|---|
| 1 | priority |
የመጀመሪያውን ዒላማ የሚያስቀድም ቅደም ተከተላዊ ዝርዝር — ወደሚቀጥለው ከመሄድ በፊት እያንዳንዱን ሙሉ በሙሉ ይጠቀማል 🥇 |
| 2 | fill-first |
ወደሚቀጥለው ከመሄድ በፊት የእያንዳንዱን ዒላማ ኮታ ሙሉ በሙሉ ይሙሉ |
| 3 | weighted |
በእያንዳንዱ ዒላማ ክብደት መሠረት ክብደት ያለው የዘፈቀደ ምርጫ |
| 4 | round-robin |
በዒላማዎች መካከል በቅደም ተከተል ይዘዋወራል |
| 5 | p2c |
የሁለት-ምርጫዎች-ኃይል የዘፈቀደ ጭነት ማመጣጠን |
| 6 | least-used |
ዝቅተኛው የአሁኑ ጭነት ያለበትን ዒላማ ይምረጡ |
| 7 | random |
ወጥ የዘፈቀደ ምርጫ (የተደጋገሙ የተወገዱበት) |
| 8 | strict-random |
የተደጋገሙትን ሳያስወግድ የዘፈቀደ ምርጫ 🎲 |
| 9 | cost-optimized |
ከቀጥታ ካታሎግ ዋጋ መረጃ በመጠቀም በጥያቄ የሚከፈለውን $ ይቀንሳል 💸 |
| 10 | headroom |
ከፍተኛው ቀሪ ኮታ ያለውን ዒላማ ይምረጡ |
| 11 | reset-window |
የኮታ መስኮቱ ቀድሞ የሚጀመርበትን ዒላማ ይመርጣል |
| 12 | reset-aware |
በኮታ ዳግም መጀመሪያ ጊዜ ደረጃ ይሰጣል — አጭር መስኮቶችን ያስቀድማል 📊 |
| 13 | context-relay |
ለረጅም ውይይቶች ዐውዱን በዒላማዎች መካከል ያስተላልፋል 🧠 |
| 14 | context-optimized |
ለአሁኑ የዐውድ መጠን በተሻለ ሁኔታ የሚስማማውን ይምረጡ |
| 15 | cache-optimized |
እያንዳንዱን እንደገና ጥቅም ላይ የሚውል የጥያቄ ቅድመ ክፍል በተመሳሳዩ መለያ ላይ ያቆያል — የጥያቄ-መሸጎጫ ግኝቶችን ከፍ ያደርጋል 🎯 |
| 16 | lkgp |
በመጨረሻ ጥሩ እንደሆነ የታወቀ መንገድ — በመጨረሻ ስኬታማ በነበረው አቅራቢ ላይ ያቆያል፣ ከዚያም ወደ ደንቦች ይመለሳል |
| 17 | auto |
በእያንዳንዱ ግንኙነት ላይ የ16 ምክንያቶች ቀጥታ ውጤት አሰጣጥ 🤖 |
| 18 | fusion |
ጥያቄውን ለሞዴሎች ፓነል ያሰራጫል + አንድ ዳኛ አንድ መልስ ያዋህዳል 🧬 |
| 19 | pipeline |
ደረጃዎችን ያገናኛል — የእያንዳንዱ ዒላማ ውጤት ለሚቀጥለው ግብዓት ይሆናል 🔗 |
የAuto-Combo ሞተሩ ለእያንዳንዱ እጩ በ16 ምክንያቶች (ጤና፣ ኮታ፣ ወጪ፣ መዘግየት፣ ለተግባሩ ተስማሚነት፣ ጥራት፣ የክፍለ ጊዜ ተገኝነት…) ነጥብ ይሰጣል — docs/routing/AUTO-COMBO.mdን ይመልከቱ።
🧱 የመቋቋም ችሎታ አብሮ የተገነባ ነው (3 ገለልተኛ ንብርብሮች)
📖 ራስ-ሰር ኮምቦ ሞተር · የመቋቋም አቅም መመሪያ
🏆 OmniRouteን ልዩ የሚያደርገው
📊 ሙሉ ዘዴውና የእያንዳንዱ ባህሪ ዝርዝር ከ9router፣ OpenRouter፣ CLIProxyAPI እና LiteLLM ጋር → 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 — ፈጣን፣ ያለ ክፍያ (ብራዚል)
ቁልፍ (የዘፈቀደ): 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 |
⚠️ እያንዳንዱን ሳንቲም በተጠቀሰው ኔትወርክ ላይ ብቻ ይላኩ — በተሳሳተ ኔትወርክ መላክ ገንዘቡን ሊያሳጣ ይችላል።
🐛 ስህተት አግኝተዋል ወይም አስተያየት አለዎት? ውይይት ይክፈቱ።
የገንቢ ማስታወሻዎች፦ ፕሮጀክቱ ለገንቢዎች ምቾት ሲባል npm install/postinstall በሚካሄድበት ጊዜ አካባቢያዊ .env ፋይል ሊፈጥር ይችላል። ይህ ፋይል ሆን ተብሎ በ.gitignore ችላ ይባላል (.gitignoreን ይመልከቱ) እና ፈጽሞ ወደ ማከማቻው መጨመር የለበትም — በስህተት ከተጨመረ፣ ይፋ የሆኑ ማንኛውንም ምስጢሮች ይቀይሩ እና ፋይሉን ከታሪኩ ያስወግዱ። አካባቢያዊ የአካባቢ ፋይሎችንና ምስጢሮችን ስለማስተዳደር መመሪያ ለማግኘት docs/DEVELOPER-ENVIRONMENT.mdን ይመልከቱ።
📡 OmniRoute Radar
ዋናው የነፃ ደረጃ መጠን፣ ከላይ በሰነድ የተገለጸውን በጋራ ስብስብ ውስጥ ድግግሞሽ የተወገደለትን ካታሎግ በመጠቀም፣ ~1.47B ቶከኖች/በወር ሆኖ ይቆያል። ጊዜያዊ የአቅራቢዎች የምዝገባ ክሬዲቶች በተናጠል የመጀመሪያውን ወር ወደ ~2.10B ሊያሳድጉት ይችላሉ። Radar፣ በOmniRoute ልቀቶች መካከል ይበልጥ ወቅታዊ የነፃ ሞዴሎች ተደራሽነትን ለሚፈልጉ ሰዎች የተዘጋጀ፣ አማራጭ እና ዲጂታል ፊርማ ያለው የካታሎግ ተደራቢ ነው፤ የማህበረሰቡ ካታሎግ እና ሁሉም ነባር ነፃ ባህሪያት ነፃ ሆነው ይቀጥላሉ።
ደጋፊዎች በቀጥታ የሚዘመነውን ካታሎግ እና ተጨማሪ የአቅራቢዎች ዕድሎችን ማግኘት ይችላሉ። የተለየውና ሊለወጥ የሚችለው ከፍተኛ ገደቡ፣ እንደ አቅራቢዎች ተደራሽነት፣ ቢበዛ በግምት 3B ቶከኖች/በወር ነው። ይህ ከፍተኛ ገደብ ዋስትና አይደለም፦ አቅራቢዎች ኮታዎችን፣ ብቁነትን፣ ሞዴሎችን ወይም ክልሎችን በማንኛውም ጊዜ ሊቀይሩ ይችላሉ።
Radar በምርጫ የሚነቃ እና GET ብቻ የሚጠቀም ነው። የOmniRoute ደንበኛ ፕሮምፕቶችን፣ ትራፊክን፣ የአቅራቢ ውቅርን፣ የአጠቃቀም ቴሌሜትሪን ወይም የማስታወቂያ ስንብት የአካባቢ ሁኔታን አይሰቅልም። ስለ ብቁነት እና ስለ ወቅታዊው ካታሎግ በ radar.omniroute.online/planos ይወቁ።
✨ ምን አዲስ ነገር አለ
ከv3.8.20 → v3.8.50 የቅርብ ጊዜ ዋና ዋና ለውጦች። ሙሉው ታሪክ በ
CHANGELOG.mdውስጥ ይገኛል።
- 🎛️ OmniConductor — ወደ ወኪሎችዎ ስብስብ የሚገባ A2A ውክልና፣ በAgent Card ላይ ያሉ Conductor ክህሎቶች፣ እና Faro ለመናገር-ተጭነው የሚጠቀሙበት የድምፅ ውይይት ያለው ዳሽቦርድ ፓነል። → A2A አገልጋይ
- 🛂 ተለዋዋጭ የመግቢያ ቁጥጥር እና የጫና መከላከያ — ከባድ የውይይት ጥያቄዎች 503 ከመመለስ ይልቅ ወረፋ ይይዛሉ፣ ለእያንዳንዱ ግንኙነት አቶሚክ RPM ተንከባላይ የኪራይ ጊዜዎችን በመጠቀም። → የጽናት መመሪያ
- 🗂️ መደበኛ የ
/v1/modelsቅደም ተከተል — ለእያንዳንዱ አቅራቢ አንድ ተከታታይ፣ በአቅራቢ የተመደበ ብሎክ (ኮምቦዎች መጀመሪያ ላይ የተሰኩ)፣ በሁሉም የካታሎግ ምንጮች ላይ የተረጋጋ። → የAPI ማጣቀሻ - 🗜️ የመጭመቂያ ማጠናከሪያ — በነባሪነት የነቃ የመፍታት መከላከያ፣ Caveman ጥቅሎች ለDE / FR / JA + ቻይንኛ (wényán)፣ RTK ማጣሪያዎች ለGradle እና .NET። → መጭመቂያ
- 💸 ትክክለኛ ቋሚ-ተመን ወጪ — የደንበኝነት / የኮዲንግ-ዕቅድ አቅራቢዎች በወጪ ትንታኔዎች ውስጥ $0 ያሳያሉ፤ በጀት፣ ኮታ እና ማዘዋወር ግምት መስጠታቸውን ይቀጥላሉ። → የAPI ማጣቀሻ
- ⚖️ የQuota-Share ማዘዋወር — የጋራ መለያ ኮታን በተሰባሰቡ ቁልፎች መካከል በፍትሐዊነት ይከፋፍላል፤ ሥራ ፈት የሆኑ ድርሻዎችን ለሌሎች በማዋስ አቅም እንዳይባክን ያደርጋል። → የጽናት መመሪያ
- 🤖 በአንድ ትዕዛዝ የCLI/ወኪል ማዋቀር — 13 የተመዘገቡ
setup-*ትዕዛዞች፤omniroute run7 CLIs (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) ያስጀምራል፤omniroute configure10 ዒላማዎችን ከበይነተገናኝ አቅራቢ+ሞዴል መራጭ እና ለእያንዳንዱ አውድ ተወዳጆች ጋር ይደግፋል። → የCLI ውህደቶች - 🛰️ የርቀት ሁነታ — የተወሰነ ወሰን ባላቸው ቶከኖች (
connect/contexts/tokens) እና ለVPS ጭነቶች በሚያገለግልantigravityOAuth አጋዥ፣ የርቀት OmniRouteን ያስተዳድሩ። → የርቀት ሁነታ - 🧭 ይበልጥ ብልህ ራስ-ሰር ማዘዋወር —
auto/<category>:<tier>ኮምቦዎች፣ Fusion (የሞዴል ፓነል + ዳኛ)፣ ሥራን የሚገነዘብ ማዘዋወር፣ ለእያንዳንዱ ጥያቄ የሞዴል / ሁነታ / የUSD-በጀት ማሻሻያዎች። → Auto-Combo - 🗜️ ተሰኪ መጭመቂያ — 12 በጥምረት ጥቅም ላይ ሊውሉ የሚችሉ ሞተሮች + Compression Studios፦ LLMLingua-2፣ ባለሁለት-ደረጃ Ultra፣ omniglyph፣ ለእያንዳንዱ እርምጃ የትክክለኛነት በር፣ GCF v3.2፣ በመጎተት እንደገና ማደራጃ አርታዒ። → መጭመቂያ
- 🕵️ ግልጽ የMITM ዲክሪፕሽን (TPROXY) — የፕሮክሲ env varsን ችላ የሚሉ CLIsን፣ ለእያንዳንዱ SNI የተለየ CA እና የtrust-store ጫኚ በመጠቀም ይያዙ። → MITM/TPROXY
- 💸 በሁሉም ቦታ የወጪ ቴሌሜትሪ — በእያንዳንዱ የመጨረሻ ነጥብ ላይ
X-OmniRoute-*የወጪ/አጠቃቀም ራስጌዎች፣ የcache-HIT ቁጠባ ራስጌ፣ እና ለእያንዳንዱ ቁልፍ የUSD ወጪ ኮታዎች። → የAPI ማጣቀሻ - 🧠 እርስዎ የሚቆጣጠሩት ማህደረ ትውስታ — በነባሪነት የጠፋ፣ በምርጫ የሚነቃ int8 የቬክተር ኳንታይዜሽን + ዓይነት ያለው መዳከም፣ ለእያንዳንዱ ጥያቄ
x-omniroute-no-memory። → ማህደረ ትውስታ - 🛡️ ደህንነት — በእያንዳንዱ LLM መስመር ላይ የprompt-injection መከላከያ (የred-team ሙከራ ስብስብ)፣ በምርጫ የሚነቃ የማረጋገጫ መረጃ መሸፈኛ መከላከያ (የወጡ API ቁልፎችን/ሚስጥሮችን በሁለቱም አቅጣጫ ያደበዝዛል)፣ ነፃ የመጨረሻ-አማራጭ DuckDuckGo የድር ፍለጋ፣ እና ለዳሽቦርዱ አማራጭ OIDC የመግቢያ በር (በይለፍ ቃል መግባት ሁልጊዜ እንደተገኘ ይቆያል)። → መከላከያዎች
- 🖼️ አዲስ የመጨረሻ ነጥቦች —
/v1/ocr(Mistral OCR) እና/v1/audio/translations(Whisper-አይነት) የሚዲያ በይነገጹን ያሟላሉ። → የAPI ማጣቀሻ - 🎨 ምስል / ቪዲዮ / ድምፅ ማመንጨት — ለሚዲያ አንድ API፦ xAI Grok Imagine እና Novita AI ቪዲዮ፣ ComfyUI፣ Magnific፣ Adobe Firefly፣ Segmind፣ እንዲሁም እንደ ElevenLabs ያሉ የንግግር አቅራቢዎች። → የAPI ማጣቀሻ
- 🌍 ማሰማራት እና ክንውን — የreverse-proxy
basePath፣ የአሳሽ ቋንቋ ራስ-ሰር ማወቅ፣ ለእያንዳንዱ ቁልፍ የመሣሪያ ክትትል፣ root የማያስፈልገው የMITM እምነት፣ zh-TW አካባቢያዊነት። → አካባቢ - 🤝 ተጨማሪ አቅራቢዎች እና ወኪሎች — የደመና ወኪሎች (Codex Cloud, Cursor, Devin, Jules)፣ Grok Build (xAI) ከአሳሽ + OAuth መግቢያ ጋር፣ የOllama ዋና ድጋፍ ያለው ካርድ፣ Claude Opus 5 እና Sonnet 5፣ ከKimi ጋር ይፋዊ አጋርነት (Code/Web/Moonshot)፣ Zed፣ Requesty፣ SenseNova፣ Yuanbao፣ Agnes AI… እና የታደሰ 352-አቅራቢ ካታሎግ። → አቅራቢዎች
- 📡 የማዘዋወር ግልጽነት — እያንዳንዱ ምላሽ እሱን ያቀረበውን ስትራቴጂ/አቅራቢ/መዘግየት የሚጠቅስ
X-OmniRoute-Decisionራስጌ ይይዛል፤ አዲሱcache-optimizedየኮምቦ ስትራቴጂ + የAuto-CombocacheAffinityምክንያት ተደጋጋሚ ጥያቄዎችን የተሸጎጠውን ቅድመ ቅጥያ ወደያዘው ግንኙነት ይመልሳሉ፣ እንዲሁም ለንባብ-ብቻ የሆነ/v1/auto-combo/{channel}/candidatesየመጨረሻ ነጥብ የauto/*ሰርጥን ቀጥታ የእጩዎች ስብስብ ያሳያል። → Auto-Combo - ⚡ አካባቢያዊ አፈጻጸም እና መሠረተ ልማት — በአንድ ጠቅታ አካባቢያዊ Redis፣ Cloudflare Workers / Deno Deploy ሪሌይ አሰማሪዎች፣ Bifrost እና Mux እንደ ክትትል ያላቸው የተካተቱ አገልግሎቶች። → የተካተቱ አገልግሎቶች
- 🧩 በጥቅሉ ውስጥ የተካተቱ ሌሎች ነገሮች — የተሰኪ ማዕቀፍ + የገበያ ቦታ፣ Omni/Agent/GitHub የክህሎት ማዕቀፎች፣ የObsidian vault ውህደት (22 MCP መሣሪያዎች)፣ ከOpenAI ጋር ተኳሃኝ የBatch እና Files APIs፣ የትርጉም ምላሽ መሸጎጫ፣ ከደረጃ ሰንጠረዦች ጋር ጌማዊነት፣ ACP የወኪል ማግኛ (15 አብሮገነብ ወኪሎች)፣ ወደ BigQuery የታቀደ የምዝግብ ማስወጣት፣
auto/chaosየብልሽት ማስገባት፣ የTelegram ቦት ድልድይ፣ በመተግበሪያ ውስጥ ያለ የስሪት አስተዳዳሪ እና LMArena-ELO የነፃ-አቅራቢ ደረጃዎች። → ሰነዶች
🤖 ተኳኋኝ 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 |
Agent Deck |
📖 ለሁሉም 36 መሣሪያዎች (26 CLI Code's + 10 CLI Agents) የእያንዳንዱ መሣሪያ ማዋቀሪያ → docs/reference/CLI-TOOLS.md · 🧩 OpenCode ተሰኪ → @omniroute/opencode-provider
OmniRouteን በመጠቀም የሚደገፍ ማንኛውንም CLI በአንድ ትዕዛዝ ያስጀምሩ — ምንም የማዋቀሪያ ፋይል አይጻፍም፣ ምስክርነቶች ለእያንዳንዱ ሂደት ይገባሉ፣ Qwen/Gemini ደግሞ ጊዜያዊ የተነጠለ መነሻ ያገኛሉ፦
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
እያንዳንዱ ትዕዛዝ ንቁውን የርቀት አውድ (omniroute connect <host>) ያከብራል፤ --dry-run
ሳያስፈጽም ትክክለኛዎቹን env/args አስቀድሞ ያሳያል፣ እንዲሁም --api-key-env NAME ሚስጥሮችን
ከshell ታሪክዎ ውጭ ያቆያል። → የCLI ውህደቶች
🌐 352 AI አቅራቢዎች — 152 በካታሎግ ነፃ ተብለው የተመለከቱ
በመደበኛዎቹ የውይይት፣ የሚዲያ፣ የፍለጋ፣ የአካባቢ፣ የደመና-ወኪል እና የስርዓት ስብስቦች ውስጥ 352 የተመዘገቡ አቅራቢዎች አሉ፤ ከእነዚህም 152ቱ
hasFree: trueየማግኛ ሜታዳታ ይዘዋል። የውይይት ሞዴል መዝገቡ 229 አቅራቢዎችን / 2,554 ልዩ የአቅራቢ-ሞዴል ጥንዶችን / 1,283 ጥሬ የሞዴል IDsን ይሸፍናል፤ የተለየው የነፃ በጀት ካታሎግ ደግሞ 444 የየሞዴሉ ረድፎች፣ 34 ተደጋጋሚ ገንዳዎች እና 52 ተደጋጋሚ/ቁልፍ-አልባ ለዘላለም ነፃ አቅራቢዎች አሉት። እነዚህ ሆን ተብሎ የተለያዩ መለኪያ መሠረቶች ናቸው፤ ትርጓሜዎቹ እና በገንዳ የተባዙ ግቤቶችን ያስወገዱ ስሌቶች በየአቅራቢ ማጣቀሻ እና ነፃ ደረጃዎች ውስጥ ይገኛሉ።
🏢 ሁሉም ዋና ላቦራቶሪዎች — በአንድ መዳረሻ ነጥብ
OpenAI |
Anthropic |
Gemini |
xAI Grok |
DeepSeek |
Mistral |
Qwen |
Meta Llama |
Groq |
NVIDIA |
MiniMax |
Cohere |
Perplexity |
HuggingFace |
Together |
Fireworks |
Cloudflare |
Baidu |
…እና 330+ ተጨማሪ — እያንዳንዱ አዶ ከዳሽቦርዱ የአቅራቢዎች ካታሎግ በቀጥታ ይጫናል። 📖 የአቅራቢ ማጣቀሻ
🆓 ለዘላለም ነፃ — $0፣ ካርድ አያስፈልግም
📖 ሙሉ በማሽን የሚነበብ ካታሎግ → 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 መመሪያ · ዴስክቶፕ · የምናሌ አሞሌ ትሪ · Termux · PWA · OpenCode
🧩 አዲስ፦ OmniRoute በVS Code ቤተኛ Copilot Chat ውስጥ
አዲስ የጎን አሞሌ የለም፣ አዲስ የውይይት UI የለም — OmniRoute የሚያቀርበው እያንዳንዱ ሞዴል በቀጥታ አስቀድመው በሚጠቀሙበት Copilot Chat ሞዴል መራጭ ውስጥ ይታያል። ከVS Code 1.122 ጀምሮ የአቅራቢ ሞዴሎች የGitHub መግቢያ ወይም የCopilot ደንበኝነት ምዝገባ ሳያስፈልጋቸው ይሰራሉ — የወኪል ሁነታ፣ የመሣሪያ ጥሪ እና የእይታ ችሎታ በነጻ።
የ**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 ይገኛሉ።
📖 የVS Code Copilot Chat መመሪያ — ማዋቀር፣ መራጩ የሚያሳየው፣ ዳሽቦርድ በትር ውስጥ፣ ችግር መፍታት
🎩 አዲስ፦ OmniRouteTray — በምናሌ አሞሌው ውስጥ የሚኖረው መግቢያዎ
omniroute serveሁልጊዜ ሲበራ በተሻለ ሁኔታ ይሰራል። OmniRouteTray ይህንን ለmacOS አንዴ አዘጋጅተው የሚረሱት የምናሌ አሞሌ መተግበሪያ ያደርገዋል፦ አገልጋዩን ያስጀምራል፣ ከዳግም ማስነሳት በኋላም እንዲሰራ ያደርገዋል፣ በቦታው ላይ ያዘምነዋል፣ እና ቀጥታ የtoken በጀትዎን በአንድ ጠቅታ ብቻ እንዲያገኙ ያደርጋል — ክፍት የተርሚናል መስኮት አያስፈልግም፣npm install -g omnirouteን መከታተልም አያስፈልግም።
በTauri v2 (መጠኑ እጅግ አነስተኛ የሆነ Rust ኮር) የተገነባ ሲሆን፣ የራሱን የተፈረመ Node 24 runtime ይዞ ይመጣል
እና በመተግበሪያው ባለቤትነት የሚተዳደር የOmniRoute ጭነትን ያስተዳድራል፤ ስለዚህ ከዓለም አቀፍ
node/bunዎ ጋር ፈጽሞ አይጋጭም። ያለዎትን ~/.omniroute/ ውቅር እና የውሂብ ጎታ ይጋራል — ስለዚህ
አስቀድመው የሚያስኬዱት ያው OmniRoute ነው፣ ባርኔጣ አድርጎ ብቻ። 🎩
| የሚያደርገው | እንዴት |
|---|---|
| 🟢 አገልጋዩን ይቆጣጠራል | omniroute serveን ያስጀምራል፣ ቅጂ ከመፍጠር ይልቅ አስቀድሞ እየሰራ ያለን instance ይጠቀማል |
| 📊 ቀጥታ አጠቃቀምን በጨረፍታ | የአቅራቢ ኮታ አሞሌዎች፣ የClaude ክፍለ ጊዜ/ሳምንታዊ ገደቦች ከዳግም ማስጀመሪያ ቆጠራዎች ጋር፣ የ30 ቀናት ወጪ ዝርዝር |
| 🔄 በቦታው ላይ በራስ-ሰር ይዘምናል | ደረጃ በደረጃ ጭነት፣ አቶሚክ ቅያሬ፣ ሲከሽፍ ወደ ነበረበት መመለስ — ሁልጊዜ በአዲሱ ልቀት ላይ |
| 🚀 ሲገቡ ይጀምራል | ሲገቡ በአማራጭ ማስጀመር፤ በትሪ ውስጥ ብቻ፣ የdock አዶ የለም |
| 🩺 ምርመራ & ምዝግቦች | በአንድ ጠቅታ ምርመራዎች እና የአገልጋይ ምዝግቦች መዳረሻ |
brew install --cask zoispag/tap/omniroute-tray
ማውረድን ይመርጣሉ? የቅርብ ጊዜውን .dmg ከ
ልቀቶች ያግኙ። የምንጭ ኮድ፣ ችግሮች እና የግንባታ
ሰነዶች በzoispag/omniroute-tray ይገኛሉ።
💛 በ@zoispag የተዘጋጀ የማህበረሰብ ፕሮጀክት — ይፋዊ የOmniRoute ልቀት አይደለም።
🔒 የግል እና አካባቢያዊ-ቅድሚያ
📖 ፈቃድ መስጠት · የጥበቃ ገደቦች · ተገዢነት
🔌 ሙሉ CLI + A2A እና MCP
ከሰርቨሩ ባሻገር፣ OmniRoute 80+ ትዕዛዞች ያሉት የተሟላ የትዕዛዝ-መስመር መቆጣጠሪያ ማዕከል ሲሆን፣ AI ወኪል በራሱ እንዲያንቀሳቅሰው የሚያስችሉ ክፍት የወኪል ፕሮቶኮሎችንም ያካትታል።
⌨️ እውነተኛ CLI (start ብቻ አይደለም)
omniroute # ጌትዌይ + ዳሽቦርድን ያስተናግዱ (port 20128)
omniroute chat # በይነተገናኝ TUI የውይይት ደንበኛ (slash: /model /combo /skill /memory)
omniroute setup # የመጀመሪያ አጠቃቀም መመሪያ አዋቂ
omniroute doctor # አቅራቢዎችን፣ portsን እና native depsን ይመርምሩ
🛰️ የርቀት ሁነታ — CLIን እዚህ፣ OmniRouteን በVPS ላይ ያስኪዱ
OmniRoute በሰርቨር ላይ ነው? በተመሳሳዩ CLI ከላፕቶፕዎ ሆነው ያንቀሳቅሱት። የተወሰነ ወሰን ባለው የመዳረሻ ቶከን አንድ ጊዜ ይግቡ፤ ከዚያ በኋላ እያንዳንዱ ትዕዛዝ ወደ ርቀት ሰርቨሩ ይመራል።
omniroute connect 192.168.0.15 # የይለፍ ቃል → ወሰን ያለው ቶከን፣ እንደ ዐውድ ይቀመጣል
omniroute models list # ← በርቀት ሰርቨሩ ላይ ይሰራል
omniroute configure codex # ← የርቀት ሞዴል ይመርጣል፣ አካባቢያዊ የCodex መገለጫ ይጽፋል
omniroute tokens create --name ci --scope read # ለሌሎች ማሽኖች ይበልጥ ጠባብ ቶከኖችን ይፍጠሩ
omniroute contexts use default # ← ወደ አካባቢያዊ ሰርቨሩ ይመለሱ
ቶከኖች read / write / admin የሚል ወሰን አላቸው፤ ፕሮሰሶችን የሚጀምሩ መስመሮች በloopback ብቻ ይቆያሉ።
📖 የርቀት ሁነታ
🤝 ወኪል ያገናኙ — እና OmniRouteን ራሱ ይቆጣጠራል
OmniRouteን በMCP፣ A2A፣ REST API፣ webhooks ወይም የርቀት CLI በኩል ተደራሽ ያድርጉት — ማንኛውም ብቃት ያለው ወኪል (ወይም የእርስዎ ኮድ) የጠቅላላውን ጌትዌይ ቁልፎች ያገኛል፦ ራውቲንግ፣ አቅራቢዎች፣ combos፣ cache፣ compression፣ memory — በራስ-ሰር። ከታች ያሉት የHTTP መዳረሻ ነጥቦች በhttp://localhost:20128 ስር ይስተናገዳሉ።
| በይነገጽ | የመዳረሻ ነጥብ / ትዕዛዝ | የአጠቃቀም ዓላማ |
|---|---|---|
| 🧰 MCP (stdio) | omniroute --mcp | ከClaude Desktop፣ Cursor ወይም ከማንኛውም MCP ደንበኛ ጋር ያገናኙ |
| 🌊 MCP (HTTP) | /api/mcp/stream | የርቀት MCP — 110 መሣሪያዎች፣ 33 ወሰኖች (ማስፈጸሙ በምርጫ የሚነቃ)፣ ሙሉ የኦዲት መዝገብ |
| 📡 MCP (SSE) | /api/mcp/sse | የዥረት MCP ማጓጓዣ |
| 🤝 A2A | /.well-known/agent.json | ከወኪል-ወደ-ወኪል፣ JSON-RPC 2.0 + SSE፣ 6 ክህሎቶች |
| 🌐 REST API | /v1/* | ከOpenAI ጋር ተኳሃኝ — ውይይት፣ embeddings፣ ምስሎች፣ ድምፅ፣ OCR |
| 🔔 Webhooks | /api/webhooks | የጥያቄ / ኮታ ክስተቶችን ወደ Slack፣ Discord፣ Telegram ወይም ማንኛውም URL ይግፉ |
| 🛰️ የርቀት CLI | omniroute connect | ወሰን ባላቸው የመዳረሻ ቶከኖች የርቀት ኢንስታንስን ያንቀሳቅሱ |
# ሙሉውን የOmniRoute መሣሪያ ስብስብ በMCP በኩል ለClaude Code ይስጡ፦
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
📖 MCP ሰርቨር · A2A ሰርቨር · የወኪል ፕሮቶኮሎች
🗜️ 15–95% ቶከኖችን ይቆጥቡ — በራስ-ሰር
📖 እንዴት እንደሚሠራ — የሂደት መስመር፣ አርክቴክቸር እና የቁጠባ ስሌት
ነባሪው የተደራረበ ጥምረት RTK → Cavemanን ያስኬዳል። ሁለቱም በተመሳሳይ የመሣሪያ/ዐውድ ጭነት ላይ ሲሠሩ፣ ቁጠባው ተደራርቦ ይጨምራል፦
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
የኮድ ብሎኮች፣ URLs፣ JSON እና የተዋቀረ ውሂብ በጥበቃ ሞተሩ ሁልጊዜ ይጠበቃሉ።
ጥቂት ቶከኖች ሥራውን ሲሠሩ ብዙ ቶከኖችን ለምን ይጠቀማሉ? እያንዳንዱ ጥያቄ በOmniRoute ማመቂያ ሂደት መስመር በግልጽነት ያልፋል — በደንበኛው በኩል ምንም ለውጥ አያስፈልግም። አሁን በቅደም ተከተል የሚሠሩ እና በእያንዳንዱ የማስተላለፊያ ጥምረት የሚዋሃዱ 12 ሊጣመሩ የሚችሉ ሞተሮች ቁልል ነው — ከRTK፣ Caveman (⭐ 90K+)፣ LLMLingua-2 እና Troglodita (PT-BR) ሐሳቦች ላይ በመመሥረት።
🧱 የ12 ሞተሮች ቁልል
ሞተሮቹ በሂደት መስመሩ ቅደም ተከተል ይሠራሉ፤ እያንዳንዳቸውን በተናጠል ማብራትና ማጥፋት፣ እንዲሁም ለእያንዳንዱ ጥምረት ማዋቀር ይቻላል፦
| # | ሞተር | የሚሠራው |
|---|---|---|
| 1 | Session-Dedup | በተከታታይ ዙሮች የተደጋገመ ይዘትን ያስወግዳል (በይዘት አድራሻ የሚለይ፣ ዙሮችን አቋርጦ የሚሠራ) |
| 2 | CCR | ትላልቅ ብሎኮችን ከመልሶ ማግኛ ምልክቶች በስተጀርባ ያከማቻል፤ ሲፈለጉም ይወሰዳሉ |
| 3 | Lite | ነጭ ቦታን + የምስል URLን ማሳጠር (ዝቅተኛ መዘግየት ያለው መሠረታዊ አማራጭ) |
| 4 | RTK | ብልህ የመሣሪያ ውጤት ማጣራት፣ ተደጋጋሚ ይዘትን ማስወገድ እና መቁረጥ (ትዕዛዝን የሚያውቅ) |
| 5 | Responses Tool Output | በመጀመሪያ መረጃ የማያሳጣ JSON + ለshell/patch/search/build ውጤቶች ወሰን ያለው የምርመራ ማመቅ (Responses API) |
| 6 | Headroom | በውስጥ የተካተተ GCF ኮዴክ በመጠቀም የJSON ድርድሮችን መረጃ የማያሳጣ ሰንጠረዣዊ ማጠቃለል (~30%) |
| 7 | Relevance | ከመጨረሻው የተጠቃሚ ጥያቄ አንጻር ዐረፍተ ነገሮችን በማውጣት ደረጃ መስጠት |
| 8 | Caveman | በደንብ ላይ የተመሠረተ የስድ ንባብ ማመቅ (በውጤት ላይ ~65–75%) |
| 9 | Aggressive | ማጠቃለል + የቆዩ ዙሮችን በሂደት ማርጀት |
| 10 | LLMLingua-2 | በMobileBERT ONNX በኩል የML ትርጉማዊ ቅንጠባ — ለኮድ ደህንነቱ የተጠበቀ፣ ያልተመሳሰለ |
| 11 | Ultra | አማራጭ አነስተኛ-ሞዴል (SLM) ደረጃ ያለው በልምድ ላይ የተመሠረተ የቶከን ቅንጠባ |
| 12 | OmniGlyph | በቀጥታው Anthropic ግንኙነት ላይ ለተለካው Claude Fable 5 የሙከራ ዐውድ-እንደ-ምስል ኮድ ማድረግ፤ የGPT 5.6 ትራንስፎርመሮች የአቅራቢ ደረሰኞች እስኪገኙ ድረስ ሲሳኩ ዝግ ሆነው ይቆያሉ። አራት የማመቂያ መገለጫዎች (ነባሪው aggressive፣ balanced፣ coding-safe፣ passthrough) (እጅግ ኃይለኛው፤ በምርጫ የሚነቃ) |
የኮድ ብሎኮች፣ URLs እና የተዋቀረ ውሂብ በባይት ደረጃ ፍጹም ሆነው ሁልጊዜ ይጠበቃሉ። በአንድ ጠቅታ የሚመረጡ ቅንብሮች ሞተሮቹን ያጣምራሉ፦
| ሁነታ | ቁጠባ | በጣም የሚስማማው |
|---|---|---|
| 🪶 Lite | ~15% | ሁልጊዜ የሚሠራ ደህንነቱ የተጠበቀ ነባሪ |
| 🪨 Standard (Caveman) | ~30% | ዕለታዊ ኮድ ማዘጋጀት |
| ⚡ Aggressive | ~50% | መሣሪያዎች በብዛት የሚጠቀሙ ረጅም ክፍለ ጊዜዎች |
| 🔥 Ultra | ~75% | ከፍተኛው ቁጠባ |
| 🧰 RTK | 60–90% | የshell/test/build/git ውጤት |
| 🔗 Stacked (RTK → Caveman) | 78–95% | የተቀላቀሉ ጥያቄዎች + የመሣሪያ መዝገቦች |
እውነተኛ ምሳሌ — Standard ሁነታ፦
በፊት (69 ቶከኖች)፦ "የReact ኮምፖነንትዎ እንደገና እየተሳለ ያለበት ምክንያት ምናልባት በእያንዳንዱ የማሳያ ዑደት አዲስ የኦብጀክት ማጣቀሻ እየፈጠሩ ስለሆነ ነው። የመስመር ውስጥ ኦብጀክትን እንደ prop ሲያስተላልፉ፣ የReact ጥልቀት የሌለው ንጽጽር በእያንዳንዱ ጊዜ እንደተለየ ኦብጀክት ያየዋል፤ ይህም እንደገና መሳልን ያስነሳል። ኦብጀክቱን በማስታወሻ ለማቆየት useMemoን እንዲጠቀሙ እመክራለሁ።"
በኋላ (19 ቶከኖች)፦ "በእያንዳንዱ ማሳያ አዲስ የኦብጀክት ማጣቀሻ። የመስመር ውስጥ ኦብጀክት prop = አዲስ ማጣቀሻ = እንደገና መሳል። በuseMemo ያጠቃልሉት።"
ተመሳሳይ መልስ። 72% ያነሱ ቶከኖች። ምንም የትክክለኛነት መቀነስ የለም። ✅
የPT-BR ምሳሌ — Troglodita ሁነታ፦
በፊት (42 ቶከኖች): "ችግሩ፣ በእያንዳንዱ የሬንደር ዙር አዲስ የኦብጀክት ማጣቀሻ ስለሚፈጠር ኮምፖነንቱ እንደገና ሬንደር እያደረገ መሆኑ ነው። useMemoን እንዲጠቀሙ እመክራለሁ።"
በኋላ (12 ቶከኖች): "እንደገና ሬንደር፦ በእያንዳንዱ ዙር አዲስ ማጣቀሻ (inline ኦብጀክት እንደገና ይፈጠራል)።
useMemoን ይጠቀሙ።"ተመሳሳይ መልስ። ~70% ያነሱ ቶከኖች። ቴክኒካዊ ትክክለኛነቱ እንደተጠበቀ ነው። ✅
🎚️ ከኤንጂኖቹ ባሻገር — የውጤት ቅጦች፣ ተስማሚ ማስተካከያው እና የእያንዳንዱ ጥያቄ ቁጥጥር
ከላይ ያሉት 12 ኤንጂኖች ወደ ውስጥ የሚገባውን ይቀንሳሉ። ሦስት ተጨማሪ ንብርብሮች እንዴት፣ መቼ እና ምን ወደ ውጭ እንደሚወጣ ቅርጽ ይሰጣሉ፦
- 🪄 የውጤት ቅጦች (በውጤት ዘንግ ላይ መምራት) — ውሳኔያዊና ለካሽ ደህንነቱ የተጠበቀ የምላሽ ቅርጽ ማስያዣ መመሪያዎችን ያክላል፤ እርስ በርስ ሊጣመሩ ይችላሉ፣ እያንዳንዳቸውም በ
lite/full/ultraጥንካሬ ይሰራሉ። ቅጥ ማከል በሬጂስትሪው ውስጥ የአንድ መስመር ግቤት ብቻ ነው፦- አጭር ጽሑፍ — አላስፈላጊ ቃላትን / አርቲክሎችን / ማመንታትን ያስወግዱ፤ ቴክኒካዊ ይዘቱን በትክክል ያቆዩ።
- ያነሰ ኮድ — የ"ሰነፍ ከፍተኛ ደረጃ ገንቢ" YAGNI፦ ትንሹ የሚሰራ ለውጥ፣ ያልተጠየቀ የመሠረተ ኮድ የለም።
- Ponytail (ሰነፍ ከፍተኛ ደረጃ ገንቢ) — የYAGNI ደረጃዎችን ይውጡ፣ ዋናውን መንስኤ ያስተካክሉ፣ ትንሹን የሚሰራ diff ይጠቀሙ።
- ADHD አለብኝ (ድርጊት-ቀዳሚ) — ቀጣዩን ድርጊት አስቀድሞ ያቀርባል፣ ደረጃዎችን በቁጥር ይዘረዝራል፣ አንድ ተጨባጭ ቀጣይ እርምጃ ይሰጣል፣ መግቢያ አይጨምርም።
- አጭር CJK (文言) — እጅግ አጭር የጥንታዊ ቻይንኛ ቅጥ (በlocale ተገድቦ ለ
zh)።
- 🎯 ተስማሚ የአውድ በጀት (ማስተካከያው) — በአንድ የማብራት/ማጥፋት የቶከን ገደብ ፈንታ፣ ከሞዴሉ የአውድ መስኮት ጋር ለማስማማት በጣም ርካሽና አነስተኛ የመረጃ ኪሳራ ያላቸውን ኤንጂኖች እስከሚያስፈልገው ድረስ ብቻ ደረጃ በደረጃ ያሳድጋል። ፖሊሲ፦
reserve-output(ነባሪ፣ ሞዴሉን የሚያገናዝብ) ·percentage·absolute። ሁነታ፦floor(መስማማቱን ያረጋግጣል) ·replace-autotrigger(ግልጽ ምርጫዎ ቅድሚያ ያገኛል) ·off(የቆየ ገደብ)። - 🎛️ ጭመቃ የሚወሰንበት ቦታ (ቅድሚያ፣ ከከፍተኛ → ዝቅተኛ) — የእያንዳንዱ ጥያቄ
x-omniroute-compressionራስጌ › የራውቲንግ ውህድ ሽረት › ገቢር ስያሜ ያለው መገለጫ › ተስማሚ / ራስ-ሰር ማስጀመሪያ › የፓነል ነባሪ › ጠፍቷል። ተግባራዊ የሆነው ዕቅድ በX-OmniRoute-Compression: <mode>; source=<source>የምላሽ ራስጌ ውስጥ ተመልሶ ይታያል።
በቶከን ገደብ ራስ-ሰር ማስጀመሪያውን ያብሩ፣ ተስማሚ ማስተካከያውን ያንቁ፣ ስያሜ ያለውን መገለጫ ይሰኩ፣ ለእያንዳንዱ ጥያቄ የአንድ ጊዜ ቅንብር ያዘጋጁ ወይም ለእያንዳንዱ የራውቲንግ ውህድ pipeline ይመድቡ — ለስራው የሚስማማውን ይጠቀሙ። በፈቃድ የሚነቃው ከመስመር ውጭ የግምገማ መሣሪያ (npm run eval:compression) ለውጥን ከማስተዋወቅዎ በፊት፣ በተወሰነ corpus ላይ ታማኝነትን ከቁጠባ ጋር ያነጻጽራል።
📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md
⚡ ፈጣን መጀመሪያ
1) ይጫኑ እና ያስኪዱ
npm install -g omniroute
omniroute
💡
npm warn ERESOLVEወይም የpeer-dep ማስጠንቀቂያዎችን አዩ? ምንም ጉዳት የላቸውም።
ዳሽቦርዱ http://localhost:20128 ላይ · APIው http://localhost:20128/v1 ላይ።
2) ነፃ አቅራቢን ያገናኙ (ምዝገባ አያስፈልግም)
ዳሽቦርድ → አቅራቢዎች → Kiro AIን (ነፃ Claude፣ ለእያንዳንዱ መለያ ~50 ክሬዲቶች/ወር) ወይም OpenCode Freeን (ማረጋገጫ አያስፈልግም) ያገናኙ → ተጠናቋል።
3) የኮድ መሣሪያዎን ያመልክቱ
መሠረታዊ URL: http://localhost:20128/v1
API ቁልፍ: [ከዳሽቦርድ → መጨረሻ ነጥቦች ይቅዱ]
ሞዴል: auto (ያለ ቅንብር ብልህ ራውቲንግ — ወይም ማንኛውም አቅራቢ/ሞዴል)
4) እየሰራ መሆኑን ያረጋግጡ
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
ያገናኟቸው ሞዴሎች በዝርዝሩ ውስጥ ሊታዩ ይገባል። 🎉 ይሄው ነው — ኮድ መጻፍ ይጀምሩ፣ OmniRoute በራስ-ሰር ራውቲንግ ያደርግልዎታል እና ካልተሳካም ወደ አማራጭ ይቀይራል።
ደንበኛዎ ብጁ ራስጌዎችን መላክ ካልቻለ፣ OmniRoute በቶከን የተደገፉ የተኳኋኝነት ተለዋጭ ስሞችንም ያቀርባል፦
የOpenAI ካታሎግ: http://localhost:20128/vscode/YOUR_KEY/
የOpenAI ሞዴሎች: http://localhost:20128/vscode/YOUR_KEY/models
የOpenAI ውይይት: http://localhost:20128/vscode/YOUR_KEY/chat/completions
የOpenAI ምላሾች: http://localhost:20128/vscode/YOUR_KEY/responses
የOllama ውይይት: http://localhost:20128/vscode/YOUR_KEY/api/chat
የOllama መለያዎች: http://localhost:20128/vscode/YOUR_KEY/api/tags
እነዚህን Authorization: Bearer ...ን ማያያዝ ለማይችሉ ደንበኞች ብቻ ይጠቀሙ። በራስጌ የሚደረግ ማረጋገጫ አሁንም ተመራጩ ሁነታ ነው።
📦 ተጨማሪ የመጫኛ ዘዴዎች — Docker፣ ከምንጭ፣ pnpm፣ Arch
🐳 Docker
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 የልቀት ቻናሎችን ይመልከቱ። ምስሉ **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 |
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።
የቅድመ-ልቀት Docker ቻናል፦
diegosouzapw/omniroute:nextእናdiegosouzapw/omniroute:next-webየአሁኑን ነባሪrelease/v*branch ይከተላሉ። እነዚህ ሊለወጡ የሚችሉ tags ያልተለቀቁ ማስተካከያዎችን ለመሞከር ብቻ የታሰቡ ሲሆን በምርት አካባቢ አይደገፉም። Docker የልቀት ቻናሎችን ይመልከቱ።
🥟 Bun
መደበኛው bun install እና ዓለም አቀፍ መጫን (bun install -g omniroute) በBun አሂድ ጊዜ ራስ-ሰር ማወቅ በኩል ይደገፋሉ፦
- አብሮ የተካተተ
bun:sqlite፦ OmniRoute በBun ስር ሲሠራ አብሮ የተካተተውን የBunbun:sqlitedriver ይጠቀማል፤ በ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 .)።
# በBun ይጫኑ እና ያስኪዱ
bun install
bun run dev
🛠️ ከምንጭ
cp .env.example .env && npm install
PORT=20128 npm run dev
📦 pnpm
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
🐧 Arch Linux (AUR)
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
🔧 Nix (Flake)
# Nix flakesን በመጠቀም
nix develop
npm run dev
# ወይም devboxን በመጠቀም
devbox run npm run dev
📖 Docker መመሪያ — Compose profiles፣ Caddy HTTPS፣ Cloudflare tunnels።
🦭 Podman
# 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 የተለየውን የውሂብ ማውጫ መመሪያ ይከተሉ።
📖 Podman መመሪያ — 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 ወይም ዘገምተኛ ማሽኖች)፦
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1ም ይዘለዋል
ለፈጣኑ ጭነት pnpmን ይምረጡ (በይዘት አድራሻ የሚሰጥ store + hard links — ከላይ ይመልከቱ)።
ዳሽቦርድ ለሌለው headless አሂድ ጊዜ የDocker base profileን (ከላይ) ወይም
የTermux መመሪያን ይጠቀሙ። CLIው እና የድር ዳሽቦርዱ በአንድ port ላይ በተመሳሳይ
ሂደት ይቀርባሉ፤ ስለዚህ በአሁኑ ጊዜ የተለየ CLI-only package የለም።
🎬 OmniRoute በተግባር
📹 የቪዲዮ መመሪያዎች
የዳሽቦርድ ቅጽበታዊ እይታ በ2026-08-24 · ጥሬ ካታሎግ፦ YT 809 | TT 137 | IG 124 · ወቅታዊነት (ቀናት)፦ YT 1 | TT 21 | IG 22
ሙሉ ደረጃ አሰጣጥ (የተደጋገሙት የተወገዱባቸው ቀኖናዊ URLs፣ v > 0፣ ከፍተኛው ተደራሽነት)፦
| #1 | #2 | #3 | #4 | #5 |
|---|---|---|---|---|
| nick_saraev — Instagram — 3,042,474 | theopenstack — Instagram — 692,419 | milesreevesai — TikTok — 620,400 | Vaibhav Sisinty — YouTube — 391,109 | buildwithai.club — Instagram — 347,652 |
| #6 | #7 | #8 | #9 | #10 |
|---|---|---|---|---|
| nivedan.ai — Instagram — 331,973 | vaibhavsisinty — Instagram — 263,744 | Nick Automates — YouTube Shorts — 218,174 | theroshankrishna — Instagram — 186,786 | midudev — TikTok — 177,800 |
ቀኖናዊ መለኪያዎች በ2026-08-24፦ 1.029 ልዩ ቪዲዮዎች · 11.132.922 የታወቁ እይታዎች (v > 0) · 639 ቻናሎች/መገለጫዎች በየአውታረ መረቡ። ጥሬው ዳሽቦርድ 1.070 ረድፎችን ይዟል፤ 41 የInstagram ብዜቶች በቀኖናዊ URL መሠረት ተስተካክለው፣ ለእያንዳንዱ ቪዲዮ ከፍተኛው የእይታ ብዛት ተጠብቋል።
🎬 ስለ OmniRoute ቪዲዮ ሠርተዋል? ከሊንኩ ጋር ችግር ወይም ውይይት ይክፈቱ — እዚህ እናቀርበዋለን።
📧 ማህበረሰብ እና እገዛ
ሁሉም ነገር በአንድ ቦታ — ጠባቂውን ይከተሉ፣ ከማህበረሰቡ ጋር ይወያዩ ወይም ችግር ይክፈቱ።
| ቻናል | የት / እንዴት |
|---|---|
| 💼 LinkedIn — አስተዳዳሪውን ይከተሉ | linkedin.com/in/diegosouzapw |
| 🐙 GitHub — ልቀቶችን እና ምክሮችን ለማግኘት ይከተሉ | @diegosouzapw |
| 💬 Discord | discord.gg/U47eFqAXCn |
| ✈️ Telegram | t.me/omnirouteOficial |
| 🟢 WhatsApp — 🌍 ዓለም አቀፍ | ቡድኑን ይቀላቀሉ |
| 🟢 WhatsApp — 🇧🇷 ብራዚል | ቡድኑን ይቀላቀሉ |
| 🌍 ድረ ገጽ | omniroute.online |
| 🌍 🌍StHub OmniRoute ማህበረሰብ (ነፃ) | የStHub ፖርታል |
| 📦 የምንጭ ኮድ | github.com/diegosouzapw/OmniRoute |
| 🐛 ሳንካ ሪፖርት ያድርጉ | ጉዳይ ይክፈቱ — የnpm run system-info ውጤትን ያያይዙ |
| 🤝 አስተዋጽኦ ያድርጉ | CONTRIBUTING.md · የቅርንጫፍ እና ልቀት ሞዴል · good first issue ይምረጡ |
| 💚 ፕሮጀክቱን ይደግፉ | የድጋፍ መንገዶች ↑ · GitHub Sponsors |
🛠️ የቴክኖሎጂ ስብስብ
| ንብርብር | ቴክኖሎጂ |
|---|---|
| የማስኬጃ አካባቢ | 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) — 122 የጎራ ሞጁሎች፣ 174 ፍልሰቶች |
| ማህደረ ትውስታ | 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-ደረጃ ፕሮክሲ |
| የመቋቋም ችሎታ | የወረዳ መቆራረጫ፣ ኤክስፖኔንሺያል መልሶ መሞከሪያ፣ የተቀናጀ ድንገተኛ ጫና መከላከያ፣ ራስ-ሰር ጥምር ራስን ማዳን |
| መዝገብ መያዝ | pino — የጥያቄ አውድ ያላቸው የተዋቀሩ JSON መዝገቦች |
| ሙከራ | Node.js የሙከራ አስኪያጅ + Vitest — በ5,100+ ክትትል በሚደረግባቸው የሙከራ ፋይሎች ውስጥ 39,000+ የማይንቀሳቀሱ የሙከራ መግለጫዎች (አሃድ፣ ውህደት፣ E2E፣ ደህንነት፣ ስነ-ምህዳር) |
| መድረኮች | ዴስክቶፕ (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 ውቅር | launch + የየሞዴሉን መገለጫዎች በመጠቀም Claude Codeን ወደ OmniRoute (አካባቢያዊ/የርቀት) ያመልክቱ |
| ፈጣን ጅምር | ባለ3-ደረጃ ጫን → አገናኝ → አዋቅር |
🔧 ክወናዎች & ማሰማራት
| ሰነድ | መግለጫ |
|---|---|
| የDocker መመሪያ | Docker ማስኬድ፣ Compose መገለጫዎች፣ Caddy HTTPS፣ መሿለኪያዎች፣ የምስል መለያዎች |
| የPodman መመሪያ | Quadlet systemd ውህደት፣ podman-compose፣ SELinux |
| የVM ማሰማራት | የተሟላ መመሪያ፦ VM + nginx + Cloudflare ማዋቀር |
| የFly.io ማሰማራት | ዘላቂ ማከማቻን በመጠቀም ወደ Fly.io ያሰማሩ |
| የTermux መመሪያ | OmniRouteን በTermux በኩል በAndroid ላይ ያስኪዱ |
| የPWA መመሪያ | የProgressive Web App መጫን፣ መሸጎጥ፣ ሥነ ሕንፃ |
| የማራገፍ መመሪያ | ለሁሉም የመጫኛ ዘዴዎች ንጹሕ ማስወገድ |
| የአካባቢ ውቅር | የተሟሉ .env ተለዋዋጮች እና ማጣቀሻዎች |
🧠 ባህሪያት & ሥነ ሕንፃ
| ሰነድ | መግለጫ |
|---|---|
| አርክቴክቸር | የስርዓት አርክቴክቸር፣ የውሂብ ፍሰት እና ውስጣዊ አሠራሮች |
| የማመቅ መመሪያ | ባለ7-አማራጭ የሂደት ቅደም ተከተል፦ ጠፍቷል / ቀላል / መደበኛ / ኃይለኛ / እጅግ ከፍተኛ / RTK / የተደራረበ |
| የRTK ማመቅ | የትዕዛዝ ውጤት ማመቅ፣ ማጣሪያዎች፣ እምነት፣ ማረጋገጥ እና ጥሬ ውጤትን መልሶ ማግኘት |
| የማመቅ ሞተሮች | Caveman፣ RTK፣ የተደራረቡ የሂደት ቅደም ተከተሎች፣ ዳሽቦርድ/API/MCP በይነገጾች |
| የማመቅ ደንቦች ቅርጸት | ለCaveman እና RTK ማጣሪያዎች የJSON ደንብ-ጥቅል መርሃግብሮች |
| የማመቅ ቋንቋ ጥቅሎች | ቋንቋን መለየት እና የCaveman ደንብ-ጥቅል ማዘጋጀት |
| የጽናት መመሪያ | የወረዳ ቆራጮች፣ የማቀዝቀዣ ጊዜዎች፣ ወረፋ፣ የተጨናነቀ ድንገተኛ ጥያቄን መከላከል፣ TLS ማስመሰል |
| የራስ-ሰር ጥምር ሞተር | ባለ16-ሁኔታ ውጤት አሰጣጥ፣ የሁነታ ጥቅሎች፣ ራስን መጠገን |
| የፕሮክሲ መመሪያ | ባለ3-ደረጃ የፕሮክሲ ስርዓት፣ የ1proxy የገበያ ቦታ፣ የመዝገብ CRUD |
| ነፃ ደረጃዎች | የተዋሃደ ማውጫ፦ 34 በሰነድ የተመዘገቡ ተደጋጋሚ ስብስቦች / 444 በካታሎግ የተመዘገቡ የነፃ ደረጃ ግቤቶች |
| የባህሪያት ማሳያ | በስክሪን ምስሎች የተደገፈ የዳሽቦርድ ምስላዊ ጉብኝት |
| የኮድ መሠረት ሰነድ | ለጀማሪዎች ምቹ የኮድ መሠረት ዝርዝር መመሪያ |
🤖 ፕሮቶኮሎች እና APIዎች
| ሰነድ | መግለጫ |
|---|---|
| የAPI ማጣቀሻ | ሁሉም የመዳረሻ ነጥቦች ከምሳሌዎች ጋር |
| የOpenAPI ዝርዝር መግለጫ | የOpenAPI 3.0 ዝርዝር መግለጫ |
| የMCP አገልጋይ | 110 የMCP መሣሪያዎች፣ የIDE ውቅሮች፣ የPython/TS/Go ደንበኞች |
| የMCP አገልጋይ መመሪያ | የMCP ጭነት፣ ማጓጓዣዎች እና የመሣሪያ ማጣቀሻ |
| የA2A አገልጋይ | የJSON-RPC 2.0 ፕሮቶኮል፣ ክህሎቶች፣ ዥረት ማስተላለፍ፣ የተግባር አስተዳደር |
| የA2A አገልጋይ መመሪያ | የA2A ወኪል ካርድ፣ ተግባራት፣ ክህሎቶች እና ዥረት ማስተላለፍ |
📋 ፕሮጀክት እና ጥራት
| ሰነድ | መግለጫ |
|---|---|
| አስተዋጽኦ ማድረግ | የልማት ማዋቀር እና መመሪያዎች |
| የቅርንጫፍ እና ልቀት ሞዴል | PRዎች የሚያነጣጥሩበት (release/*)፣ main እና መለያዎች የሚያመለክቱት |
| የለውጥ መዝገብ | ለእያንዳንዱ ስሪት የተሟላ የልቀት ታሪክ |
| የደኅንነት ፖሊሲ | የተጋላጭነት ሪፖርት ማድረግ እና የደኅንነት ልምዶች |
| የi18n መመሪያ | የ42 ቋንቋዎች ድጋፍ፣ የትርጉም የሥራ ፍሰት፣ RTL |
| የልቀት ማረጋገጫ ዝርዝር | ከልቀት በፊት የማረጋገጫ ደረጃዎች |
| የሽፋን ዕቅድ | በ5,100+ ክትትል በሚደረግባቸው የሙከራ ፋይሎች ውስጥ ለ39,000+ ቋሚ የሙከራ መግለጫዎች የሙከራ ሽፋን ስትራቴጂ |
⭐ ከፍተኛ አስተዋጽኦ አድራጊዎች
OmniRoute በጋለ ስሜት በሚሳተፍ ክፍት-ምንጭ ማህበረሰብ የተቀረጸ ነው። እነዚህ ግለሰቦች በፕሮጀክቱ ጥራት፣ መረጋጋት እና ተደራሽነት ላይ ቀጥተኛ ተጽዕኖ ያላቸው ልዩ አስተዋጽኦዎችን አድርገዋል። እናመሰግናለን።
በተዋሃዱ የpull request ጥያቄዎች ብዛት የተደረደሩ ውጫዊ አስተዋጽኦ አድራጊዎች
| ደረጃ | አስተዋጽዖ አድራጊ | የተዋሃዱ PRዎች | ~የተቀየሩ መስመሮች |
|---|---|---|---|
| 1 | backryun | 190 | 227,977 |
| 2 | oyi77 | 180 | 407,678 |
| 3 | rdself | 145 | 80,663 |
| 4 | JxnLexn | 128 | 387,049 |
| 5 | KooshaPari | 101 | 125,747 |
| 6 | herjarsa | 88 | 230,872 |
| 7 | RaviTharuma | 79 | 55,106 |
| 8 | maxmad64bis | 69 | 394,715 |
| 9 | artickc | 59 | 33,260 |
| 10 | HouMinXi | 51 | 47,334 |
| 10 | chirag127 | 51 | 5,153 |
| 12 | xz-dev | 50 | 245,976 |
| 13 | hartmark | 47 | 52,185 |
| 14 | rqzbeh | 39 | 143,181 |
| 15 | dhaern | 34 | 19,559 |
| 16 | Dingding-leo | 33 | 1,986 |
| 17 | NomenAK | 32 | 13,854 |
| 18 | MumuTW | 30 | 16,953 |
| 19 | benzntech | 29 | 11,641 |
| 20 | pacocartones | 24 | 9,331 |
| 20 | Prudhvivuda | 24 | 6,312 |
በቀጥታ ስርጭት ላይ ባለው release/v3.8.50 የመጨረሻ ነጥብ dafb4ae808 ላይ የተቀዘቀዘ፣ እስከ 2026-08-24 05:26:03 UTC ድረስ የተደረጉ ውህደቶችን ያካትታል። በገጾች የተከፋፈለው የGitHub GraphQL ቆጠራ 5,911 የተዋሃዱ PRዎችን ይዟል፦ 2,707 በማከማቻው ባለቤት፣ 179 በDependabot እና 3,025 ውጫዊ PRዎች ከ535 የተለያዩ አስተዋጽዖ አድራጊዎች። «የተቀየሩ መስመሮች» የGitHub ጭማሪዎችን + ስረዛዎችን የሚያመለክት ሲሆን፣ በራስ-ሰር የተፈጠሩ ፋይሎችን፣ lockfileዎችን፣ ካታሎጎችን፣ ትርጉሞችን እና ሰነዶችን ያካትታል፤ ይህ የለውጥ መጠን እንጂ በደራሲው የተጻፈ LOC አይደለም። በመቁረጫ ነጥቡ ላይ ያሉ እኩል ውጤቶች እንደተጠበቁ ናቸው።
በGitHub የተመደቡ ኮሚቶች
|
backryun 🥇 220 በGitHub የተመዘገቡ commits |
Paijo 🥈 219 በGitHub የተመዘገቡ commits |
Randi 🥉 108 በGitHub የተመዘገቡ commits |
Ravi Tharuma 🏅 81 በGitHub የተመዘገቡ commits |
Chris 🏅 70 በGitHub የተመዘገቡ commits |
Markus Hartung 🏅 69 በGitHub የተመዘገቡ commits · በ#6 እኩል |
|
Dizzle 🏅 69 በGitHub የተመዘገቡ commits · በ#6 እኩል |
Jan Leon 🏅 64 በGitHub የተመዘገቡ commits |
zenobit 🏅 62 በGitHub የተመዘገቡ commits |
Bob.Hou 🏅 51 በGitHub የተመዘገቡ commits · በ#10 እኩል |
Xiangzhe 🏅 51 በGitHub የተመዘገቡ commits · በ#10 እኩል |
በ2026-08-24 06:14:31 UTC እንደገና የተረጋገጠ፦ ለrelease/v3.8.50 ነባሪ branch በrepository Contributors API ሪፖርት የተደረጉ በGitHub የተመዘገቡ commits። APIው 525 ማንነቶችን (415 ተጠቃሚዎች፣ 2 bots፣ 108 ስም-አልባ) መልሷል፤ ይህ ሠንጠረዥ maintainerን፣ botsን እና ስም-አልባ ማንነቶችን አያካትትም፣ እንዲሁም በውድድሩ ያሉ እኩል ደረጃዎችን ያቆያል። ይህም ከላይ ካለው የተዋሃዱ PR ደረጃ አሰጣጥም ሆነ ከታች ካለው የ639 ሰዎች Git-metadata ቆጠራ የተለየ ነው።
🙏 የእነዚህ አስተዋጽዖ አድራጊዎች ባህሪያት፣ የሳንካ ማስተካከያዎች እና የመሠረተ ልማት ማሻሻያዎች OmniRouteን አስተማማኝ እና በባህሪያት የበለጸገ ከሚያደርጉት ነገሮች ዋና አካል ናቸው። እያንዳንዱ pull request፣ እያንዳንዱ test case እና እያንዳንዱ i18n የትርጉም ፋይል ጠቃሚ ነው። ክፍት ምንጭ የሚገነባው እንደ እነርሱ ባሉ ሰዎች ነው።
💖 ስፖንሰሮች
OmniRouteን ከራሳቸው ኪስ ለሚደግፉ ሰዎች ከልብ የመነጨ ምስጋና — እያንዳንዱ አስተዋጽኦ ፕሮጀክቱ ነጻ፣ ራሱን የቻለ እና ወደፊት የሚራመድ ሆኖ እንዲቀጥል ያደርጋል።
![]() Andrew 💛 ንቁ ወርሃዊ ስፖንሰር |
![]() Vlad I 💛 ንቁ ወርሃዊ ስፖንሰር |
![]() Paco Cartones 💛 ንቁ የአንድ ጊዜ ስፖንሰር |
![]() Prof. Igor Morais 💛 የቀድሞ የአንድ ጊዜ ደጋፊ |
![]() longtao 💛 የቀድሞ የአንድ ጊዜ ደጋፊ |
… እና ማንነታቸውን በምስጢር ማቆየት የሚመርጡ ሌሎች 💛
ይፋዊ የGitHub ስፖንሰሮች በ2026-08-24 እንደገና ተረጋግጠዋል። ከላይ ያሉትን የንቁነት መለያዎች የሚወስነው የGitHub activeOnly ሁኔታ ነው፤ ከዚህ ቀደም በይፋ የተገለጹ የአንድ ጊዜ ደጋፊዎች ምስጋናቸውን እንደተቀበሉ ይቆያሉ፣ የግል ስፖንሰሮችም ስማቸው ሳይገለጽ ይቀራሉ።
💖 ስፖንሰር ይሁኑ → — እያንዳንዱ ዶላር OmniRoute ነጻ እና ራሱን የቻለ ሆኖ እንዲቀጥል ያደርጋል።
👥 600+ አስተዋጽኦ አድራጊዎች
በ2026-08-24 በተወሰነው መሠረታዊ ac02c5b42f ላይ ኦዲት ተደርጎ፣ በቀጥታ ባለው release/v3.8.50 ጫፍ dafb4ae808 ላይ እንደገና ተረጋግጧል፦ 639 መደበኛ የተደረጉ የሰው Git ማንነቶች — 407ቱ የcommit ደራሲዎች ሆነው ይታያሉ (ጠባቂውን ጨምሮ)፣ 232ቱ ደግሞ በግልጽ Co-authored-by ማጠቃለያ መስመሮች ውስጥ ብቻ ይታያሉ። ቆጠራው የGitHub noreply መለያዎችን መደበኛ ያደርጋል፣ 26 የbot/agent/service/placeholder ማንነቶችን ያስወግዳል፣ እንዲሁም የማሳያ ስሞቻቸው ስለሚመሳሰሉ ብቻ መደበኛ የኢሜይል አድራሻዎችን አያዋህድም።
እንዴት አስተዋጽኦ ማድረግ እንደሚቻል
- ማከማቻውን fork ያድርጉ
- ከንቁው
release/vX.Y.Zጫፍ branch ይፍጠሩ (mainአይደለም) — የBranch እና የRelease ሞዴልን ይመልከቱ - የባህሪ branchዎን ይፍጠሩ (
git checkout -b feat/amazing-feature) - ለውጦችዎን commit ያድርጉ (
git commit -m 'feat: add amazing feature') - ወደ branchው push ያድርጉ (
git push origin feat/amazing-feature) - base = ያ
release/vX.Y.Zbranch በማድረግ Pull Request ይክፈቱ
ዝርዝር መመሪያዎችን ለማየት CONTRIBUTING.mdን ይመልከቱ።
አዲስ ስሪት መልቀቅ
# release ይፍጠሩ — npm publish በራስ-ሰር ይከናወናል
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
📊 ኮከቦች
🙏 ምስጋናዎች
OmniRoute በግዙፍ ፕሮጀክቶች ትከሻ ላይ የቆመ ነው። የጀመረው እንደ 9router fork እና የGo ፕሮጀክት CLIProxyAPI TypeScript port ሆኖ ነው፤ ከዚያም እያንዳንዱ ከታች ያለው subsystem ቀድሞ ከዚያ የደረሰ open-source ፕሮጀክት መነሳሳትን አግኝቷል። እያንዳንዳቸው የOmniRouteን አንድ ተጨባጭ ክፍል ቅርጽ አስይዘዋል። ይህ ለሁሉም የምናቀርበው ምስጋና ነው። 🙏
⭐ የኮከብ ብዛቶቹ ኦገስት 24፣ 2026 ላይ በGitHub REST API ተረጋግጠዋል — ለእነዚህ ፕሮጀክቶች ኮከብ ይስጡ። ብዛቶቹ በተጠቀሰው ቀን የተወሰደ ትክክለኛ ቅጽበታዊ መረጃ ሲሆኑ፣ በተፈጥሮ ይለወጣሉ።
🧬 የዘር ሐረግ እና gateway
| ፕሮጀክት | ⭐ | ለOmniRoute እንዴት መነሻ ሆነ |
|---|---|---|
| 9router | 26,161 | ይህ fork የተገነባበት ዋናው ፕሮጀክት — እዚህ ባለብዙ-ሞዳል APIs እና ሙሉ የTypeScript ዳግም ጽሑፍ ተስፋፍቷል። |
| CLIProxyAPI | 48,497 | ለዚህ JavaScript / TypeScript port መነሻ የሆነው የGo አተገባበር። |
| LiteLLM | 57,100 | የወጪ ክትትል ማመሳሰላችንን የሚመግብ ይፋዊ የዋጋ ውሂብ ስብስብ ያለው እና የአቅራቢ መደበኛነት ሞዴሉ የራውቲንግ ንድፋችንን ያሳወቀው የAI ጌትዌይ። |
| codex-chatgpt-web | 1,410 | የአሳሽ ክፍለ-ጊዜ፣ የምላሽ ክፈፍ፣ የአጠቃቀም እና የድር ፍለጋ አስማሚዎችን ጨምሮ፣ በውስጥ ወደተካተተው ChatGPT Web → Codex Responses ድልድይ የተስማማ የMIT ምንጭ። |
| free-claude-code | 48,112 | ወደ ዥረት መልሶ ማግኛ፣ no-thinking ተለዋጭ ስሞች፣ ተተኪ የድር ፍለጋ፣ ተንሸራታች-መስኮት ገደቦች፣ የሎግ ማደብዘዝ እና የተጠናከሩ የማስጀመሪያ ፍሰቶች የተላለፉ ንድፎች። |
| composer-api | 322 | ወደ ቤተኛው Cursor አስፈጻሚ የተስማሙ የCursor Composer መሣሪያ-ምርጫ፣ የውጤት-ገደብ እና የመሣሪያ-ማስረከቢያ ንድፎች። |
| codex-multi-auth | 457 | ወደ Codex OAuth ዳግም ማረጋገጫ የተላለፉ የአዲስ መግቢያ እና የrefresh-token ማዞሪያ ንድፎች። |
| opencode-anthropic-auth | 510 | ከClaude Code ጋር ተኳኋኝ የሆኑ ነባሪ የለውጥ ቅንብሮች እና የክፍያ ራስጌ ባህሪ ወደ OmniRoute በውቅር የሚመራ ድልድይ አጠቃላይ ተደርገዋል። |
| grok2api-merged | 2 | የእሱ የGrok ሞዴል ማዛመጃዎች፣ የሐሰት-TypeError Statsig አመንጪ፣ የጥያቄ እና የመሣሪያ ነባሪዎች፣ እንዲሁም NDJSON ምላሽ አቀናባሪ በተጨባጭ ሁኔታ ወደ OmniRoute የGrok Web አስፈጻሚ ተስማምተዋል። |
| TQZHR/grok2api | 705 | ከgrok2api-merged በስተጀርባ ያለው ዋና በተዘዋዋሪ የመጣ የኮድ ምንጭ፤ የእሱ ሞዴል፣ ራስጌ፣ payload፣ Statsig እና የአቀናባሪ አተገባበሮች በGrok Web የዘር ሐረግ ውስጥ ተጠብቀዋል። |
| chenyme/grok2api | 7,520 | በTQZHR እና grok2api-merged በኩል ለተላለፉት የGrok payload እና የመሣሪያ ነባሪዎች፣ የStatsig አመንጪ እና የresult.response አቀናባሪ መሠረታዊው የMIT ምንጭ። |
| grok2api-pro | 27 | ለproxy-pool ንብርብሩ grok2api-merged እውቅና የሰጠው በተዘዋዋሪ የመጣ ምንጭ፤ OmniRoute ያንን የዘር ሐረግ ማስታወቂያ ይጠብቃል፣ ነገር ግን በተገደበው Grok Web አስፈጻሚው ውስጥ የproxy-pool port እንዳለ አይገልጽም። |
| GrokProxy | 50 | በcookie የተረጋገጠው የGrok proxy እና የresult.response.token ዥረት ንድፉ ለOmniRoute የGrok Web ትራንስፖርት መነሻ ሆነዋል። |
| GrokBridge | 5 | የመጀመሪያው የGrok Web አተገባበር የእሱን HTTP/አሳሽ upstream ንድፍ አጣቅሷል፤ ቀጥተኛው የHTTP መንገዱ ከGrokProxy የመጣ ስለሆነ፣ ራሱን የቻለ የኮድ port እንደተደረገ አይገለጽም። |
| grok-web-api | 14 | የእሱ Rust ChatOptions እና የምላሽ-ኤንቨሎፕ መርሃግብሮች ለOmniRoute TypeScript Grok የጥያቄ እና የዥረት-ምላሽ ዓይነቶች መነሻ ሆነዋል። |
🗜️ የአውድ እና የቶከን መጭመቂያ — ሞተሮች
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
|---|---|---|
| Caveman | 100,538 | በስፋት የተሰራጨው “ጥቂት ቶከን ሥራውን ሲሠራ ብዙ ቶከን ለምን ይጠቀማሉ?” ፕሮጀክት — የዋሻ ሰው አነጋገር ፍልስፍናው መደበኛውን የማጨመቂያ ሁነታችንን እና ከ30 በላይ የማሟያ/ማጠራቀሚያ ደንቦችን ያንቀሳቅሳል። |
| RTK – Rust Token Killer | 77,185 | ከፍተኛ አፈጻጸም ያለው የትዕዛዝ ውጤት ማጨመቂያ — የRTK ሞተራችንን፣ JSON ማጣሪያ DSLን፣ ያልተቀነባበረ ውጤት መልሶ ማግኘትን እና የተደራረበውን RTK → Caveman የሂደት መስመር አነሳስቷል። |
| headroom | 67,310 | ሊቀለበስ የሚችል የአውድ ማጨመቂያ (SmartCrusher) — የheadroom ሞተራችንን እና የccr መልሶ ማግኛ ምልክት ንድፍን አነሳስቷል። |
| LLMLingua | 6,598 | የፕሮምፕት ማጨመቂያ ጥናት (LLMLingua / LLMLingua-2) — ያልተመሳሰለ፣ ለኮድ ደኅንነቱ የተጠበቀ እና ሲሳነው ዋናውን ውጤት የሚያሳልፍ የllmlingua ሞተራችንን አነሳስቷል። |
| llmlingua-2-js | 31 | ለLLMLingua ሞተራችን እንደ የወርከር-ክር የጀርባ ሥርዓት ጥቅም ላይ የዋለው የJS/ONNX ፖርት (MobileBERT / XLM-RoBERTa)። |
| Troglodita | 40 | የPT-BR ቶከን ማጨመቂያ — የpt-BR ቋንቋ ጥቅላችንን ያንቀሳቅሳል፦ ለብራዚላዊ-ፖርቱጋላዊ ሰዋሰው የተስተካከለ የድግግሞሽ ቅነሳ እና የማሟያ ቃላት ማስወገድ። |
| ponytail | 108,957 | በስፋት የተሰራጨው የ“ሰነፍ ከፍተኛ ደረጃ ገንቢ” YAGNI-ኮደር ክህሎት — የless-code የውጤት ቅጣችንን አነሳስቷል፦ _የሚመነጨውን_ ኮድ የሚቀንስ በትንሹ የሚሠራ ለውጥ አቅጣጫ (ከCaveman አጭር ንባብ ጋር በውጤት ዘንግ ላይ ያለ አቻ)። |
| i-have-adhd | 23,526 | እርምጃን የሚያስቀድም፣ ለADHD ተስማሚ የሆነው የምላሽ ቅጡ በአምስት ቋንቋዎች ወደ OmniRoute አጭር የውጤት ቅጥ ተስተካክሏል። |
🧩 የታመቁ ቅርጸቶች፣ የቶከን ጥናት እና ኮድን የሚያውቁ መሣሪያዎች
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
|---|---|---|
| TOON | 25,233 | ቶከን-ተኮር የነገር ምልክት አጻጻፍ — የዓምድ፣ ራስጌ-እና-ረድፎች ሞዴሉ የሰንጠረዥ ማጠቃለያ ደረጃችንን ቀርጿል። |
| GCF – Graph Compact Format | 41 | የታመቀው የግራፍ ቅርጸት እና አጠቃላይ መገለጫ ንድፉ ለOmniRoute የሰንጠረዥ ማጠቃለያ እና የHeadroom ኮዴክ ቅርጸት መረጃ ሰጥተዋል። |
| gcf-typescript | 4 | በቀጥታ በፕሮጀክቱ ውስጥ የተካተተው እና እንደ Headroom አጠቃላይ-መገለጫ ኮዴክ የተስፋፋው የMIT TypeScript ትግበራ። |
| token-optimizer-mcp | 494 | Brotli/SQLite መሸጎጫ + በክፍለ ጊዜ የአውድ ልዩነት — የsession-dedup ሞተራችንን አነሳስቷል። |
| token-savior | 1,122 | የBash ውጤት ማጠቃለያ + MCP መገለጫዎች — የማጨመቂያ ማቋረጫ ሥነ-ሥርዓታችንን እና የMCP መሣሪያ ማኒፌስት ቅነሳን አነሳስቷል። |
| token-saver | 138 | ይዘትን የሚያውቅ፣ በፋይል ዓይነት የሚከናወን እና ስህተትን ያገናዘበ ማቋረጫ ያለው የውጤት ማጨመቂያ — በዓይነት የሚከናወነውን ማሰራጨታችንን እና ዝቅተኛ ጥቅም ሲኖር መዝለልን አረጋግጧል። |
| token-optimizer | 1,951 | “የማይታዩትን ቶከኖች ፈልግ” — ሥራን ወደ ውጭ የማስተላለፍ + ሊመለስ የሚችል መያዣ ንድፉ ለCCR ወደ ውጭ የማስተላለፍ አስተሳሰባችን መረጃ ሰጥቷል። |
| TokenMizer | 28 | ለክፍለ ጊዜ ግራፍ + በምላሾች መካከል የመስመር ብዜት ማስወገጃ የንድፍ መሠረት፣ ለsession-dedup ንድፋችን መረጃ የሰጠ። |
| OmniCompress | 3 | Rust ዓምዳዊ-JSON + ይዘት-አድራሻ ያለው መልሶ ማግኛ + በመልእክቶች መካከል የብዜት ማስወገጃ — የheadroom/ccr/session-dedup ሞተር ንድፋችንን እና ለመሸጎጫ የተረጋጋውን “የታመቀው ቅርጽ ከአቀማመጥ ነጻ ነው” የማይለወጥ መርህ አረጋግጧል። |
| mcp-compressor | 113 | የMCP መሣሪያ ስኪማ/መግለጫ ማጨመቂያ — ለMCP መሣሪያ ማኒፌስት የብዛት ቅነሳችን መረጃ ሰጥቷል። |
| RepoMapper | 197 | የAider ዓይነት የሪፖዚቶሪ-ካርታ ደረጃ አሰጣጥ — ለሪፖዚቶሪ-ካርታ / መልሶ-ማግኛ ደረጃ አሰጣጥ ምርምራችን መረጃ ሰጥቷል። |
| quiet-shell-mcp | 4 | በMCP ላይ የሚከናወን ገላጭ የሼል-ውጤት ቅነሳ — ገላጭ የbash-ውጤት ማጠቃለያችንን አረጋግጧል። |
| ts-morph | 6,162 | የTypeScript Compiler API መሣሪያ ስብስብ — ሕብረቁምፊ፣ አብነት እና ሬገክስ ሊተራሎችን በመጠበቅ በፓርሰር ላይ የተመሠረተ የአስተያየት ማስወገጃችንን አነሳስቷል። |
🧠 ማህደረ ትውስታ እና RAG
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
|---|---|---|
| Mem0 | 63,902 | ሁለንተናዊ የማህደረ ትውስታ ንብርብር — የእሱ proxy-as-write/read-boundary ሞዴል የማህደረ ትውስታ አርክቴክቸራችንን ቅርጽ አስይዟል። |
| Letta (MemGPT) | 24,382 | ባለደረጃ ማህደረ ትውስታ ያላቸው ሁኔታ-ጠባቂ ወኪሎች — ለባለደረጃ Context Control & Recovery (CCR) ሞዴላችን መነሻ ሆነዋል። |
| WFGY | 1,781 | የ16 ተደጋጋሚ RAG/LLM የውድቀት ሁነታዎች ProblemMap ምድብ አደራደር — በችግር መፍቻ መመሪያችን ውስጥ ያለው የጋራ ቃላት ስብስብ። |
🛰️ የትራፊክ ምርመራ፣ MITM እና ግልጽ ፕሮክሲ
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
|---|---|---|
| llm-interceptor | 66 | የኮድ ረዳት ↔ LLM ትራፊክ MITM መጥለፍ/ትንተና ለመጀመሪያዎቹ Traffic Inspector መስፈርቶች መረጃ ሰጥቷል። ከዚህ ቀደም የተዋጡ አራት ሞጁሎች — SSE ማዋሃድ፣ የውይይት መደበኛነት፣ ሚስጥር መሸፈን እና የራስጌ ማጽዳት — በይፋዊ የፕሮቶኮል ደረጃዎች ላይ በተመሠረቱ ገለልተኛ እና ከባዶ በተገነቡ ትግበራዎች ተተክተዋል። ሁለቱ የአስተናጋጅ-ማሳለፊያ በይነገጾች (passthrough.ts እና _internal/bypass.cjs) በተናጠል የተመደቡ የOmniRoute ውስጣዊ ትግበራዎች ሆነው ይቀጥላሉ፤ የዚያ ምትክ አካል በመሆን እንደገና አልተጻፉም። |
| ProxyBridge | 5,995 | ለእያንዳንዱ ሂደት ግልጽ የፕሮክሲ ማዘዋወር — ከብልሽት የተጠበቀ MITM ማፍረስ፣ የሶኬት ስራ-ፈት ጊዜ ገደቦች፣ /proc የሂደት መለያ እና TPROXY ቀረጻችንን አነሳስቷል። |
📚 የሞዴል ውሂብ፣ ታዛቢነት እና UI
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
|---|---|---|
| models.dev | 6,555 | ክፍት የAI ሞዴል ዝርዝሮች፣ ዋጋ አወጣጥ እና ችሎታዎች የውሂብ ጎታ — በተፈጥሯዊ ሁኔታ ከሞዴል ካታሎጋችን ጋር ይመሳሰላል። |
| React Flow / xyflow | 38,108 | በቋጠሮ ላይ የተመሠረተው የግራፍ ቤተ-መጻሕፍት የአሁናዊ Compression Studio እና Combo/Routing Studioአችንን ያንቀሳቅሳል። |
| LangGraph | 40,314 | የLangGraph Studio የቀጥታ የስራ-ፍሰት ግራፍ እይታ የStudiosአችንን የአሁናዊ ተከታታይ እይታ አነሳስቷል። |
| Langfuse | 33,592 | የእሱ trace → span → generation ታዛቢነት ሞዴል የCompression Studio ፏፏቴ እይታችንን ቅርጽ አስይዟል። |
| Kiali | 3,631 | የIstio አገልግሎት-ሜሽ ታዛቢነት — በRouting/Combo Studio ውስጥ ያሉ የሰርኪት-ብሬከር ባጆቻችንን እና የስህተት-ጠርዝ ምስላዊ አቀራረቦችን አነሳስቷል። |
| lobe-icons | 2,428 | በዳሽቦርዳችን ላይ የአቅራቢዎችን አዶዎች የሚያሳዩ AI/LLM የምርት አርማዎች። |
| flag-icons | 12,354 | በREADME የቋንቋ መራጭ ውስጥ ጥቅም ላይ የሚውሉ MIT-ፈቃድ ያላቸውን SVG ባንዲራዎች ያቀርባል። |
🛡️ ደህንነት
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
|---|---|---|
| awesome-secure-defaults | 721 | የደህንነት ምርጫዎቻችንን የሚመራ በነባሪነት ደህንነታቸው የተጠበቀ የቤተ-መጻሕፍት ስብስብ (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)። |
🧭 አጋዥ መሣሪያዎች
| ፕሮጀክት | ⭐ | OmniRouteን እንዴት እንዳነሳሳ |
|---|---|---|
| ClawRouter | 6,564 | የጥያቄ ብዜት ማስወገድን፣ የአደጋ ጊዜ ዜሮ-ወጪ ምትክን፣ ሊሰኩ የሚችሉ Auto-Combo ስልቶችን እና ባለብዙ ቋንቋ የዓላማ ምደባን አነሳስቷል። |
| Antigravity-Manager | 30,652 | መለያን ያገናዘበ የሞዴል ዳግም ማዛመድ፣ የሚፈጸም ፋይል ዱካ ማረጋገጥ እና የዕቅድ-መለያ ባህሪው ለOmniRoute Antigravity ሩጫ-ጊዜ መረጃ ሰጥቷል። |
| vscode-antigravity-cockpit | 4,817 | አጭር የኮታ-ዳግም-ማስጀመሪያ ቆጠራ ቅርጸቱ በOmniRoute ውስጥ ያለውን ተዛማጅ የአቅራቢ ገደብ ማሳያ አነሳስቷል። |
| AionUi | 32,230 | የእሱ ACP ውህደቶች OmniRoute የተጫኑ CLI ወኪሎችን በራስ-ሰር እንዲያገኝ አነሳስተዋል። |
| CodexBar | 20,507 | የGrok Build ኮታ በይነገጽን ለይቶ አሳይቷል፤ ከዚያም OmniRoute የቀጥታ የዋየር ቅርጸቱን በገለልተኛነት አረጋግጦ አስተካክሏል። |
📄 ፈቃድ
MIT ፈቃድ - ለዝርዝሮች LICENSEን ይመልከቱ።
⬆ ወደ ላይ ተመለስ · ለክፍት ምንጭ AI ማህበረሰብ በ❤️ የተገነባ።
OmniRoute v3.8.51 · Node ≥22.22.2 · MIT ፈቃድ · omniroute.online





