# README (Hausa) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/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) · 🇮🇱 [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) ---
Allon Sarrafa na OmniRoute

# 🚀 OmniRoute — Ƙofar AI ta Kyauta OmniRoute — Kada ka taɓa daina rubuta lamba. Kowane kayan aikin AI → masu samarwa 375 — sama da 150 kyauta — ta hanyar endpoint guda ɗaya. Claude Code, Codex, Cursor, Cline, Copilot da Antigravity zuwa Claude / GPT / Gemini na KYAUTA tare da sauyawa ta atomatik idan an samu matsala. Haɗaɗɗen matse bayanai na RTK + Caveman yana rage amfani da tokens da 15–95% (~89% a matsakaici) — kada ka taɓa kaiwa iyaka. Masu samar da AI 375 · matakan kyauta sama da 150 · ~1.62B tokens kyauta/wata · dabarun routing 20 · $0 don farawa.
## 💰 ~1.62B Token / A Kowane Wata Daga Matakan Kyauta na Masu Samarwa na Waje
> **Zo da asusun masu samarwa naka na kanka.** Wannan kimarce ce ta jimilla a kan matakan kyauta na masu samarwa na waje waɗanda ake samun cancanta kafada, ba kyautar token ba daga OmniRoute. Yi rajista, samu takardun shaida inda ake buƙata, kuma haɗa masu samarwa waɗanda zaka iya amfani da su; kowane mai samarwa ne yake sarrafa iyakokinsa, samuwar sa, da sharuɗɗansa. > > Tara matakan kyauta da hannu abu ne mai wahala — SDKs da dama, iyakokin yawan buƙatu da dama, kuma ba ka san adadin da kake da shi a zahiri ba. OmniRoute yana lissafa **467 shigarwar matakan kyauta a kan 34 maɓallan pool masu maimaitawa** kuma yana ƙididdige babban adadin token daga **17 pools waɗanda ke da kasafin token na wata-wata da aka buga mai kyau ƙari da takunkumi biyar na Groq na kowane samfur**, an cire kwaido ta hanyar pool da aka raba. Quotas waɗanda ke buɗewa kawai bayan binciken shaidar yanki (a yau: ModelScope) ana nuna su dabam, +~6M a bayan tabbatar da shaidar yanki, kuma ba a taɓa ƙara su cikin babban adadin ba. Sakamakon yana kasancewa a bayyane a dashboard (`/dashboard/free-tiers`). Katin kasafin matakan kyauta na OmniRoute: ~1.62B token kyauta a kowane wata a tsiri, har zuwa ~2.22B a watan farko tare da bashin rajista, daga 34 maɓallan pool masu maimaitawa da aka rubuta waɗanda ke rufe 467 shigarwar matakan kyauta da aka lissafa a bayan endpoint ɗaya. Lissafin gaskiya da aka cire kwaidon pool — kowane pool da aka raba an ƙidaya shi sau ɗaya, ciki har da 17 pools masu maimaitawa da kasafin token na wata-wata da aka buga mai kyau ƙari da takunkumi biyar na Groq na kowane samfur; 12 masu samarwa an yi musu alamar guji a cikin lissafin haɗarin sharuɗɗa don kai ka yanke shawara. Sandar kasafin tana haɗa Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (takunkumi biyar na kowane samfur) da ƙananan pools, ƙari da bashin rajista na watan farko da masu samarwa marasa iyakar token har abada waɗanda aka nuna dabam don kada su taɓa ƙara girman babban adadin. Ana iya ganin amfani/raguwa kai tsaye a /dashboard/free-tiers. > Takaitaccen bayani mai motsi na shafin `/dashboard/free-tiers` kai tsaye. Cikakken hanyar aiki (cire kwaidon pool, matakan bashi, sharuɗɗan masu samarwa): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > Ana sake bincika waɗannan adadi kowane makonni biyu a kan lissafin kai tsaye kuma suna **motsawa a bangarori biyu** — mai samarwa ya ƙare matakin kyauta sai adadin ya ragu; sabon ya zo sai ya hau. Muna buga abin da lissafin yake ƙididdigewa a zahiri, ba a taɓa ƙara shi zuwa mafi kyawun yanayi ba.

⭐ Yi wa repo star idan OMNIROUTE ya taimaka maka adana kuɗi da sauƙaƙa aikinka.

[![Stars](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute) diegosouzapw%2FOmniRoute | Trendshift [![Star History Rank](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Shiga cikin al'umma **👋 Bi mai kula da shi — ka kasance na farko wajen samun sababbin masu samarwa, fitowar sabbin sigogi & shawarwari:** [![Bi Diego a LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Bi @diegosouzapw a GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Tambayoyi, shawarwari game da masu samarwa, taswirar aiki & tallafi → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Duniya](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Ƙofar na Ci Gaba da Girma
| | v3.8.50 | **v3.8.51** | `v3.8.53+` | | -------------------------------- | :----------------------: | :---------: | :-------------------: | | 🌐 Masu samarwa | 352 | **358** | 375 | | 🧠 Keɓaɓɓun ID na samfuran hira | 1320 | **1374** | 1475 | | 🖼️ Modality Bridge | 🆕 gani + sauti + bidiyo | ✓ | ✓ | | 📡 Katalogin kyauta na Radar | 🆕 ta zaɓi | ✓ | ✓ | | ⚖️ Shirye-shirye mai sanin quota | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetry na quota | 🆕 kai tsaye | ✓ | ✓ | | 🧰 Yanayin headless | — | — | 🆕 `serve --headless` | | 🛤️ Kayan aikin hanyar LTS | — | — | 🆕 tashoshin fitarwa | | 🔎 API na gano samfurori | — | — | 🆕 `/v1/models/query` | **→ [Taswirar Aiki](ROADMAP.md) — a kan hanyar zuwa `v3.9.0 LTS`**

## 🧩 Akwai [![sigar npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Na Watan NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Lasisi: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Sauke-sauken Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Sauke-sauken Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)
🚀 Farawa 🚀 Farawa Cikin Sauri 📦 Shigarwa 🆓 Haɗa mai samar da sabis
💡 Koyo 💥 Alƙawarin 🤔 Me Ya Sa OmniRoute 🏆 Abin da Ya Bambanta Shi
⚙️ Fasali 🎯 Combos 🌐 Masu Samar da Sabis 🔌 CLI & MCP
🗜️ Matsewa 🖥️ Inda Yake Aiki 🔒 Na Sirri
👀 Duba shi 🎬 Yadda Yake Aiki ✨ Sabbin Abubuwa 🤖 CLI Masu Jituwa
💚 Tallafi 💚 Tallafawa / Ba da Gudummawa 💬 Al'umma 💖 Masu Daukar Nauyi
📦 Aiki 🛠️ Tarin Fasahohi 📖 Takardu 👥 Masu Ba da Gudummawa
🌐 A cikin harsuna 67

Turanci (en) Português — Brasil (pt-BR) Português (pt) Español (es) Français (fr) Italiano (it) Deutsch (de) Nederlands (nl) Русский (ru) Українська (uk-UA) Polski (pl) Čeština (cs) Slovenčina (sk) Română (ro) Magyar (hu) Български (bg) Dansk (da) Suomi (fi) Norsk (no) Svenska (sv) 中文 — 简体 (zh-CN) 中文 — 繁體 (zh-TW) 日本語 (ja) 한국어 (ko) ไทย (th) Tiếng Việt (vi) Bahasa Indonesia (id) Bahasa Melayu (ms) Filipino (phi) हिन्दी (hi) ગુજરાતી (gu) मराठी (mr) தமிழ் (ta) తెలుగు (te) বাংলা (bn) اردو (ur) فارسی (fa) العربية (ar) עברית (he) Türkçe (tr) Azərbaycan (az) Kiswahili (sw) Ελληνικά (el) Hrvatski (hr) Српски (sr) Lietuvių (lt) Eesti (et) Latviešu (lv) Slovenščina (sl) Malti (mt) Gaeilge (ga) ಕನ್ನಡ (kn) മലയാളം (ml) ଓଡ଼ିଆ (or) ਪੰਜਾਬੀ (pa) नेपाली (ne) සිංහල (si) မြန်မာ (my) ខ្មែរ (km) Hausa (ha) Yorùbá (yo) Igbo (ig) አማርኛ (am) Oʻzbekcha (uz) ქართული (ka) Հայերեն (hy) Bosanski (bs)


## 🆓 Shigar da shi, haɗa mai samarwa, sannan ka watsa ta endpoint guda
Matakai uku: shigar kuma ka fara OmniRoute, haɗa mai samarwa da ya cancanta da asusunka ko maɓallin API naka, sannan ka nuna kayan aikinka zuwa localhost:20128/v1 ta amfani da maɓallin API na OmniRoute da model auto. Watsawa na danganta da haɗin da suka cancanta da iyakokin mai samarwa. ```bash # Bayan haɗa mai samarwa, kwafi maɓallin OmniRoute ɗinka daga 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` yana buƙatar hanya da ta cancanta. Sabuwar shigarwa na iya rashin manufofin da ba sa buƙatar maɓalli waɗanda suka cancanta, kuma mai samarwa marar maɓalli na iya ƙin abokan ciniki na waje. Masu samarwa da aka yi musu alamar `tos: avoid`, ciki har da Kiro, an fitar da su daga watsa ta atomatik a tsohuwar hanya; haɗa asusu ba ya soke wannan saitin ba. Duba [Jagoran Matakan Kyauta](docs/getting-started/FREE-TIERS-GUIDE.md) kafin ka zaɓi mai samarwa. 📦 Rubutun quickstart na copy-paste don **Python, Node.js, PHP, da cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Alƙawarin
Alƙawarin — Endpoint guda da masu samarwa 375. Fallback ta atomatik na ci gaba da watsa buƙatu muddin wata manufa mai lafiya ta kasance. Ginshiƙai shida: fallback mai juriya a kan masu samarwa 375 · har 95% ceton token a kan ayyukan da suka cancanta · $0 don farawa da matakan kyauta 150+ da masu samarwa 51 na kyauta har abada na lokaci-lokaci/marasa maɓalli · haɗin CLI/agent 37 ta saitin guda · dacewa da OpenAI, Claude, Gemini da Responses API a /v1 · sarrafa samarwa ciki har da circuit breakers, TLS stealth, kayan aikin MCP 110, A2A, memory, guardrails, evals da sanarwar gwaje-gwaje na tsaye 56,000+ a cikin fayilolin gwaji 7,800+ da aka bibiya.

# 🤔 Me ya sa ake buƙatar OmniRoute?
Me ya sa ake buƙatar OmniRoute — daina wasa da dashboards 10, maɓallan API da suka mutu da kuɗin da ba ka yi zatonsa ba. Wahalolin yau da kullum goma da mafitansu: ƙuntataccen adadi na ƙarewa ba a amfani da shi ba → yi amfani da subscriptions sosai; iyakar yawan buƙatu a tsakiyar coding → fallback ta atomatik mai matakai 4 (Subscription → API → Mai araha → Kyauta); fitowar kayan aiki na ƙone tokens → matsawa na RTK + Caveman (15–95%); APIs masu tsada → watsawa mai daidaita kuɗi; kowane kayan aiki da saitinsa → endpoint guda, dashboard guda; an toshe AI → proxy mai matakai 3 + TLS stealth; maɓallan da suka mutu → juriya mai layi 3 (circuit breakers, sanyaya maɓalli, kulle model); ƙungiya na rabon subscription ɗaya → taryin maɓallan da ƙuntataccen adadi na adalci; prompts ta girgijen wani → local-first tare da maɓallan da aka ɓoye da AES-256-GCM; babu ganin kuɗin da ake kashewa → bincike kai tsaye (amfani, ƙuntataccen adadi, ceto, jinkirin p95).
Yadda buƙatar OmniRoute ke gudana: IDE ko CLI naka (Claude Code, Cursor, Cline…) yana kiran endpoint guda na gida (http://localhost:20128/v1); Smart Router na OmniRoute (matsawa na RTK + Caveman, dabarun watsawa 20, circuit breakers, TLS stealth, MCP, A2A, guardrails) na iya komawa a kan matakai 4 na masu samarwa muddin wata manufa mai lafiya da ta cancanta ta kasance — Mataki 1 Subscription, Mataki 2 API Key, Mataki 3 Mai araha da Mataki 4 Kyauta.

## 🤝 Masu Tallafa Mana Masu Buɗaɗɗen Tushe

Kimi K3 — Open Frontier Intelligence · 2.8T parameters · 1M-token context

> **Kuna so ku shiga a matsayin Abokin Buɗaɗɗen Tushe?** Waɗannan su ne kamfanonin da ke tallafawa buɗaɗɗen tushe kuma suna taimakawa wajen ci gaba da OmniRoute — kuma muna faɗi a fili inda kowane kuɗin da suka ba mu yake zuwa. Tuntuɓi: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi (Moonshot AI)
Kimi
Moonshot AI

Founding Open Source Friend
Godiya ga Kimi (Moonshot AI), Abokinmu na Buɗaɗɗen Tushe na farko, don tallafawa wannan aikin! Kimi shine dakin gwaje-gwaje na AI a bayan iyalai na samfurin K2 da K3 masu buɗaɗɗen nauyi — Kimi K3 yana ba da taga mahallin 1M-token, hangen nesa na asali da matakin gaba na coding a farashi mai rahusa fiye da samfuran rufaffiyar, kuma yana aiki kai tsaye tare da Claude Code, Codex da kowane kayan aikin coding da OmniRoute ke bayarwa.

Abin da tallafin Kimi ke samarwa: Kiredit na API na Kimi yana samar da bututun sakin OmniRoute mai inganci na AI — matakin ingancin haɗawa wanda Kimi K3 ke samarwa wanda ke duba kowane buƙatar ja kafin a tura shi — tare da haɓaka fasali na yau da kullun. Tallafin Kimi na farko yana aiki akan duka hanyoyin: kai tsaye Kimi API (kimi-k3) da shirin coding na Kimi Code (OAuth da maɓallin API). OmniRoute kuma shine aikin buɗaɗɗen tushe na Brazil na farko a cikin shirin tallafi na Kimi. Samu maɓallin API na Kimi tare da ƙarin kiredit 15% →
Cheaper Inference
Cheaper Inference
cheaperinference.com

Open Source Friend
Godiya ga Cheaper Inference, Abokin Buɗaɗɗen Tushe na OmniRoute, don tallafawa wannan aikin! Cheaper Inference wata hanyar shiga ce mai tsada wacce ke sake siyar da samfuran gaba 42 — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok da MiniMax — a bayan wani wuri mai dacewa da OpenAI, yana tura kowane buƙata zuwa mai bayarwa mafi arha ba tare da cajin sama da farashin jerin mai yin samfurin ba.

Tallafi na farko a OmniRoute: Cikakkun Taɗi, asalin /v1/responses endpoint, hangen nesa, kiran kayan aiki da samfuran hoto 3 (grok-imagine, nano-banana-pro, nano-banana-2, ana iya isa gare su kamar cheaperinference/<model>). Samu maɓallin API →
Hanyoyin haɗi masu alamar aff=omniroute hanyoyin haɗi ne na abokan tarayya. Suna tallafawa aikin ba tare da ƙarin farashi a gare ku ba.
🎟️ Tallace-tallacen Abokan Hulɗa — takardun shaidar rajista kyauta daga masu bayarwa waɗanda ba mu tallafawa (danna don faɗaɗawa) Wannan sashin don lambobin referral/coupon ne kawai. Haɗin gwiwar tallafi suna cikin 🤝 Masu Tallafa Mana Masu Buɗaɗɗen Tushe a sama. OmniRoute ba shi da tallafi ko haɗin gwiwa tare da masu bayarwa da aka jera a nan — waɗannan takardun shaidar jama'a ne waɗanda kowa zai iya amfani da su.
AgentRouter
AgentRouter
agentrouter.org
AgentRouter — rajistar abokin tarayya · $100 kiredit kyauta akan rajista (sabar kyauta, sa ran jinkiri mafi girma — mafi kyau don gwaji, ba don samarwa ba). Tallafi na farko a OmniRoute tun v3.8.50: Cikakkun Taɗi, tsarin waya mai dacewa da Anthropic da hanyar da ta dace da OpenAI. Samfuran da ake da su sun haɗa da claude-opus-4-8, claude-opus-5, gpt-5.6-sol da ƙari. Ɗauki $100 ɗinku →

⚠️ Hanyar haɗi ta abokin tarayya — OmniRoute ba shi da tallafi ko haɗin gwiwa tare da wannan mai bayarwa.
Kun san wani mai bayarwa tare da takardar shaidar rajista kyauta mai karimci wanda ke amfanar masu amfani da OmniRoute? Buɗe wani batu kuma za mu ƙara shi a nan.

## 🎯 Haɗe-haɗe — Babban Ginshiƙi
Misalai masu motsi na dabarun sarrafa hanyoyin haɗe-haɗe guda 18 daga cikin 20 — tayal ɗaya ga kowace dabara: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. cache-optimized da quota-weighted ba su da motsi; teburin da ke ƙasa yana bayyana dukkan guda 20. > **Haɗin** jerin model ne da OmniRoute ke bi a tsakaninsu **ta atomatik**. Idan quota ya ƙare, provider ya gaza, ko farashi ya yi tashin gwauron zabi, haɗin zai iya matsawa zuwa model mai lafiya na gaba da ya cancanta. 🛡️ ### ⚡ Babu saiti — kawai yi amfani da `auto` Babu buƙatar ƙirƙirar haɗi. Saita model ɗinka zuwa `auto` (ko wani nau'insa), sannan OmniRoute zai gina haɗi na kama-da-wane daga providers ɗin da ka haɗa, yana tantance su kai-tsaye:
ID na ModelAbin da yake ingantawa
auto🎯 Daidaitaccen zaɓi na asali (LKGP — yana manne wa provider ɗinka na ƙarshe da ya yi aiki)
auto/coding🧑💻 Nauyi mai fifita inganci don samar da code
auto/fast⚡ Mafi ƙarancin jinkiri da farko
auto/cheap💰 Mafi arha ga kowane token da farko
auto/subscription🎟️ Quota na subscription ɗin da ka riga ka biya kawai — yana rufewa idan ya gaza, ba ya komawa ga zaɓin da za a caje ka (jagora)
auto/thrifty🪜 Quota na plan da farko, sannan mataki ɗaya bayan ɗaya zuwa zaɓuɓɓukan biyan kuɗi mafi arha — yana komawa kan plan bayan an sake saitawa (jagora)
auto/offline🔋 Mafi yawan ragowar damar quota / rate-limit da farko
auto/smart🔭 Fifita inganci + binciken 10% don gano models mafi kyau
auto/lkgp📌 Mannewa sarai ga provider na ƙarshe da aka san yana aiki
auto/chaos🧪 Aika buƙatu a layi ɗaya zuwa rukunin models (ɗaya ga kowane provider, guda 5 a matsayin tsoho), sannan ya dawo da amsa ɗaya; kira ɗaya na upstream ga kowane model a rukunin, ba gwajin jefa matsala ba
## ### 🔀 Ko ka gina naka — dabarun sarrafa hanya guda 20 Dukkan dabaru **20** — haɗa su yadda kake so a kowane mataki na haɗi:
# Dabara Abin da take yi
1 priority Jeri mai fifita target na farko — a cinye na kowanne kafin a koma na gaba 🥇
2 fill-first Cika quota na kowane target gaba ɗaya kafin matsawa zuwa na gaba
3 weighted Zaɓin bazuwar mai nauyi bisa nauyin kowane target
4 round-robin Bi targets ɗin bi da bi bisa tsari
5 p2c Daidaita kaya ta bazuwar zaɓi-biyu
6 least-used Zaɓi target mai mafi ƙarancin kaya a halin yanzu
7 random Zaɓin bazuwar daidai-wa-daida (an cire maimaitattu)
8 strict-random Bazuwar zaɓi ba tare da cire maimaitattu ba 🎲
9 cost-optimized Rage $ ga kowace buƙata daga farashin catalog na kai-tsaye 💸
10 headroom Zaɓi target mai mafi yawan quota da ya rage
11 quota-weighted Tsallake accounts da quota ɗinsu ya ƙare, sannan a zaɓa gwargwadon ragowar quota ÷ nauyin buƙatun da ke gudana — tattaunawar da ake yi tana ci gaba da manne wa zaɓinta ⚖️
12 reset-window Fi son target wanda za a sake saita lokacin quota ɗinsa da wuri
13 reset-aware Jera bisa lokacin sake saitin quota — gajerun lokuta da farko 📊
14 context-relay Miƙa context tsakanin targets don dogayen tattaunawa 🧠
15 context-optimized Zaɓi wanda ya fi dacewa da girman context na yanzu
16 cache-optimized Manne kowane farkon prompt da za a iya sake amfani da shi ga account ɗaya — ƙara yawan nasarar prompt-cache zuwa iyaka 🎯
17 lkgp Hanyar Ƙarshe da Aka San Tana Aiki — tana manne wa provider na ƙarshe da ya yi nasara, sannan ta koma ga ƙa'idoji idan ya gaza
18 auto Ƙididdigar kai-tsaye mai dalilai 16 a dukkan connections 🤖
19 fusion Aika buƙatu zuwa rukunin models + mai hukunci ya haɗa amsa ɗaya 🧬
20 pipeline Haɗa matakai — sakamakon kowane target yana shiga na gaba 🔗
Injin Auto-Combo yana ba kowane zaɓi maki bisa **abubuwa 16** (lafiya, ƙayyadadden kaso, farashi, jinkiri, dacewa da aiki, inganci, samuwar zaman aiki…) — duba [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md). ## ### 🧱 An gina juriya a ciki (matakai 3 masu zaman kansu) Juriyar OmniRoute — matakai 3 masu zaman kansu da ke gyara kansu, matakin da ya dace da gazawar da ta dace. Mataki na 1 mai katse da'irar mai samarwa (duk mai samarwar): yana katsewa ne kawai a kan 408/5xx, iyakoki OAuth 8× / API-key 12× / local 2×, yana sake saitawa bayan 60s/30s/15s zuwa gwajin HALF-OPEN, farfadowa lokacin da ake buƙata; yayin da yake OPEN combo yana sake tura buƙata zuwa mai samarwa na gaba. Mataki na 2 lokacin jiran haɗi (maɓalli/asusu ɗaya): tushe 5s OAuth / 3s API-key, jinkirin maimaitawa mai ƙaruwa ×2 tare da kariya daga cunkoson buƙatu lokaci guda, 429 yana bin Retry-After, nasara tana share duk yanayin kuskure; ana tsallake maɓalli ɗaya da ke jiran farfadowa yayin da sauran maɓallan ke ci gaba da aiki. Mataki na 3 kulle samfurin (samfuri ɗaya): 429 na kowane samfurin, 404 na local ko hana yanayi suna kulle wannan samfurin kawai — ba haɗin gaba ɗaya ba. Yanayin ƙarshe (an haramta, ya ƙare, kuɗin amfani sun ƙare) na mai gudanarwa ne, ba na lokutan jira ba. 📖 [Injin Auto-Combo](docs/routing/AUTO-COMBO.md) · [Jagorar Juriya](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Abin da Ya Bambanta OmniRoute
Abin da ya bambanta OmniRoute — kwatancen fasaloli na wani takamaiman lokaci da 9router, OpenRouter, CLIProxyAPI da LiteLLM a fannoni 13. OmniRoute: masu samarwa 375, matakan amfani kyauta sama da 150 da aka haɗa, dabarun karkatarwa 20, matse token mai injina 12, sabar MCP da aka gina ciki mai kayan aiki 110, yarjejeniyar wakili ta A2A, ma'adanar bayani mai dorewa, matakan kariya, wakilan gajimare, ɓoye sawun yatsan TLS, Desktop/Termux/PWA da yarukan UI na i18n guda 67. OmniRoute yana ƙarƙashin lasisin MIT kuma ana iya masaukinsa da kai. Ƙwarewa da ƙididdigar masu fafatawa na iya canzawa; duba hanyar binciken da aka haɗa. 📊 Cikakkiyar hanyar bincike & bayanan kowane fasali idan aka kwatanta da 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Tallafa wa OmniRoute OmniRoute na da lasisin MIT kuma ana kula da shi a fili. Idan yana adana maka lokaci ko kuɗi, ga yadda za ka taimaka masa ya ci gaba da kasancewa mai zaman kansa — zaɓi duk abin da ya dace da kai. Tallafi ba ya taɓa shafar fifikon zaɓin hanya; yana sayen bayyanar suna ne, ba matsayi ba.
⭐ Yi wa ma'ajiyar tauraroKyauta — yana taimaka wa bayyanar suna da gaskeYi wa OmniRoute tauraro
🐙 GitHub SponsorsSau ɗaya ko kowane wata · babu kuɗin dandaligithub.com/sponsors/diegosouzapw
☕ Ko-fiKyautar kuɗi ta gaggawa sau ɗaya, mai bayarwa ba ya buƙatar yin rajistako-fi.com/diegosouzapw
🧋 Buy Me a CoffeeƘaramin taimako na sada zumuntabuymeacoffee.com/diegosouzapw
🖐 LiberapayMai maimaituwa · mara riba · buɗaɗɗen tusheliberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)Nan take, babu kuɗin cajimaɓalli & QR suna ƙasa
₿ Kuɗin dijitalBTC · ETH · USDT-TRC20 · USDC-Solanaadiresoshi suna ƙasa
**🇧🇷 PIX** — nan take, babu kuɗin caji (Brazil) Lambar QR ta PIX ta OmniRoute Maɓalli (bazuwar): `5d865059-bc44-483a-962d-43ceb80126eb` Kwafi-da-manna na Pix: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```
₿ Kuɗin dijital — BTC · ETH · USDT-TRC20 · USDC-Solana (danna don faɗaɗawa)
₿ BTCBitcoin (SegWit)bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETHEthereum (ERC20)0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDTTron (TRC20)TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDCSolana2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Aika kowace tsaba a kan hanyar sadarwar da aka nuna kawai — aikawa a kan hanyar sadarwar da ba daidai ba na iya sa a rasa kuɗin.
🐛 Ka gano wata matsala ko kana da shawara? Buɗe [Tattaunawa](https://github.com/diegosouzapw/OmniRoute/discussions).

Bayanan masu haɓakawa: Aikin na iya ƙirƙirar fayil na gida mai suna .env yayin npm install/postinstall domin sauƙaƙa wa masu haɓakawa. Ana yin watsi da wannan fayil da gangan ta hanyar .gitignore (duba .gitignore) kuma ba dole ba ne a taɓa commit ɗinsa — idan aka yi commit ɗinsa bisa kuskure, sauya duk wasu sirrika da aka fallasa sannan a cire fayil ɗin daga tarihin. Duba docs/DEVELOPER-ENVIRONMENT.md don jagora kan sarrafa fayilolin muhalli na gida da sirrika.

## 📡 Radar na OmniRoute Babban adadin shirin kyauta har yanzu shi ne **~1.62B tokens/wata** daga kundin da aka bayyana a sama, wanda aka cire maimaituwar bayanai tsakanin rumbuna. Ƙimar rajista ta wucin gadi daga masu samarwa na iya ƙara adadin watan farko daban zuwa **~2.22B**. Radar wani zaɓin ƙarin kundi ne mai sa hannu, ga mutanen da ke son samun sabbin bayanai kan samuwar samfuran kyauta tsakanin fitowar sabbin sigogin OmniRoute; kundin al'umma da duk fasalolin kyauta da ake da su za su ci gaba da kasancewa kyauta. Masu tallafawa za su iya samun kundin kai-tsaye da ƙarin damammaki daga masu samarwa. Matsakaicinsa na daban, wanda zai iya sauyawa, shi ne **kimanin 3B tokens/wata a mafi yawa**, gwargwadon samuwar masu samarwa. Wannan matsakaici ba garanti ba ne: masu samarwa za su iya sauya ƙa'idojin amfani, cancanta, samfura, ko yankuna a kowane lokaci. Radar na zaɓi ne kuma GET-only. Abokin hulɗar OmniRoute ba ya loda prompts, zirga-zirga, saitunan masu samarwa, bayanan telemetry na amfani, ko matsayin kin nuna sanarwa na cikin gida. Ƙara sani game da cancanta da kundin na yanzu a **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Abubuwan da Suka Sabu
> Fitattun abubuwa na kwanan nan daga **v3.8.20 → v3.8.53**. Cikakken tarihi a cikin [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ `quota-weighted` routing** — dabarar combo ta 20 tana tsallake asusun da suka gushe, sannan tana zaɓa daga cikin sauran bisa gwargwadon ragowar quota ÷ nauyin in-flight, tana riƙe tattaunawar da ke gudana a matsayinsu. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless mode** — `omniroute serve --headless` (ko `OMNIROUTE_HEADLESS=1`) yana gudanar da injin proxy na `/v1/*` kawai, yayin da dashboard da sassan da suka shafi dashboard kawai ke kashe. → [Headless Mode](docs/guides/HEADLESS.md) - **🔎 Model discovery** — `/v1/models` yana tacewa bisa capability, context, kind da text, kuma `POST /v1/models/query` yana dawo da gajeren jeri na deterministic tare da irin wannan ganuwa ga kowane key. → [API Reference](docs/reference/API_REFERENCE.md) - **🔑 Per-key routing control** — ɗaure API key zuwa model ɗaya ko combo ɗaya da `forcedModel`, kuma ƙara ko cire models da combos na key a kai ɗaya (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Finer PII controls** — zaɓi na kowane nau'i, har zuwa alamu na masking na al'ada guda 20 da aka tantance, da ƙidayar gano na kowane nau'i; masking kanta tana ci gaba da kasancewa na zaɓi (opt-in). → [Guardrails](docs/security/GUARDRAILS.md) - **🌍 67 languages** — dashboard, mirrors na docs da CLI, tare da `npm run i18n:add-locale` yana ƙara harshe a ko'ina da umarni ɗaya. → [i18n Guide](docs/guides/I18N.md) - **🎛️ OmniConductor** — shigar da A2A delegation zuwa cikin agent fleet naka, Conductor skills a kan Agent Card, da panel na dashboard tare da Faro push-to-talk voice chat. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptive admission & overload protection** — buƙatun chat masu nauyi suna shiga jerin jira maimakon su dawo da 503, tare da atomic RPM rolling leases ga kowace connection. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Canonical `/v1/models` ordering** — toshe ɗaya mai ci gaba da aka rarraba ta provider ga kowane provider (combos a gaba farko), tabbatacce a dukkan tushen catalog. → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Compression hardening** — inflation guard kunne ta tafarki na asali, Caveman packs ga DE / FR / JA + Chinese (wényán), RTK filters ga Gradle & .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Honest flat-rate cost** — masu samar da subscription / coding-plan suna nuna **$0** a cikin cost analytics; budget, quota & routing suna ci gaba da ƙididdiga. → [API Reference](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share routing** — raba quota na account da aka haɗa a daidai a kan pooled keys, yana conserving aiki ta yadda ake ba da rance na slices da ke a banƙyama. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 One-command CLI/agent setup** — dokoki 15 da aka yi rajista `setup-*`; `omniroute run` yana ƙaddamar da CLIs 7 (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` yana goyon bayan targets 11 tare da interactive provider+model picker da favorites na kowane context. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Remote mode** — tuka OmniRoute mai nisa da scoped tokens (`connect` / `contexts` / `tokens`) + mai taimakon `antigravity` OAuth ga shigarwa a VPS. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 Smarter auto-routing** — combos na `auto/:`, **Fusion** (model panel + judge), task-aware routing, overrides na model / mode / USD-budget ga kowace buƙata. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Pluggable compression** — injuna 12 masu haɗawa + Compression Studios: LLMLingua-2, two-tier Ultra, omniglyph, per-step fidelity gate, GCF v3.2, drag-reorder editor. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Transparent MITM decrypt (TPROXY)** — kama CLIs da ke watsi da proxy env vars, tare da per-SNI CA + trust-store installer. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Cost telemetry everywhere** — headers na `X-OmniRoute-*` cost/usage a kowane endpoint, header na cache-HIT savings, da quotas na kashe USD na kowane key. → [API Reference](docs/reference/API_REFERENCE.md) - **🧠 Memory you control** — kashe ta tafarki na asali, opt-in int8 vector quantization + typed decay, `x-omniroute-no-memory` na kowace buƙata. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ Security** — prompt-injection guard a kowane LLM route (red-team suite), opt-in credential-masking guardrail (yana redact API keys/secrets da suka fito a bangarori biyu), binciken yanar gizo na karshe na kyauta ta DuckDuckGo, da zaɓin OIDC login gate ga dashboard (shiga da password koyaushe tana ci gaba da kasancewa). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ New endpoints** — `/v1/ocr` (Mistral OCR) da `/v1/audio/translations` (salon Whisper) suna cika saman media. → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 Image / video / audio generation** — API ɗaya ga media: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind, da speech providers kamar ElevenLabs. → [API Reference](docs/reference/API_REFERENCE.md) - **🌍 Deployment & ops** — reverse-proxy `basePath`, gano harshen browser kai tsaye, bin diddigar na'ura na kowane key, root-less MITM trust, zh-TW localization. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 More providers & agents** — cloud agents (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) tare da browser + OAuth login, Ollama first-class card, Claude Opus 5 & Sonnet 5, haɗin gwiwar Kimi na hukuma (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… da sabon **375-provider catalog**. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Routing transparency** — kowane response yana ɗauke da header na `X-OmniRoute-Decision` wanda ke bayyana strategy/provider/latency da ya yi aiki da shi, sabon dabarar combo na `cache-optimized` + factor na Auto-Combo `cacheAffinity` yana mayar da buƙatun da suka maimaita zuwa connection da ke riƙe da cached prefix, kuma read-only endpoint na `/v1/auto-combo/{channel}/candidates` yana nuna live candidate pool na channel na `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Ayyukan gida da kayan aiki** — Redis na gida ta danna ɗaya, masu shigar da relay na Cloudflare Workers / Deno Deploy, Bifrost & Mux a matsayin ayyukan da aka saka a ciki ƙarƙashin kulawa. → [Ayyukan da aka Saka a Ciki](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Har ila a cikin akwatin** — tsarin plugin da kasuwa, tsarin ƙwarewar Omni/Agent/GitHub, haɗin kai na Obsidian vault (kayan aikin MCP 22), APIs na Batch & Files masu jituwa da OpenAI, ma'ajin amsoshi na ma'ana, gamification tare da teburin manya, ganowar wakilan ACP (wakilai 15 da aka gina a ciki), fitar da log da aka tsara zuwa BigQuery, `auto/chaos` fan-out na samfura da yawa a kwarara, gadar bot na Telegram, mai sarrafa siga a cikin app da matsayin masu samarwa kyauta na LMArena-ELO. → [Docs](docs/README.md)
## 🤖 CLI da Wakilan Coding Masu Jituwa > Tsari ɗaya — `http://localhost:20128/v1` — kuma **kowace** IDE ko CLI ta AI tana aiki da samfurori na kyauta da masu araha.
Claude Code
Claude Code
                           
Codex CLI
Codex CLI
                           
Cline
Cline
                           
Kilo Code
Kilo Code
Zoo Code
Zoo Code
Continue
Continue
                           
Aider
Aider
                           
ForgeCode
ForgeCode
                           
jcode
jcode
                           
DeepSeek TUI
DeepSeek TUI
                           
CodeWhale
CodeWhale
                           
OpenCode
OpenCode
                           
Factory Droid
Factory Droid
                           
GitHub Copilot CLI
Copilot CLI
                           
Cursor CLI
Cursor CLI
                           
Smelt
Smelt
                           
Pi (pi-coding-agent)
Pi
                           
Grok Build (xAI)
Grok Build
                           
Hermes Agent (Nous Research)
Hermes Agent
                           
OpenClaw
OpenClaw
                           
Goose
Goose
                           
Open Interpreter
Open Interpreter
                           
Warp AI
Warp AI
                           
deyin.ai
deyin.ai
                           
+ yana kuma aiki da · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · duk wani kayan aiki mai jituwa da OpenAI
📖 Saitin kowane kayan aiki ga dukkan kayan aiki 37 (CLI Code 27 + CLI Agents 10) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin na OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)

**Ƙaddamar da kowane CLI mai goyon baya ta OmniRoute da umarni guda** — ba a rubuta fayilolin saiti, ana saka bayanan tantancewa ga kowane tsari, sannan Qwen/Gemini suna samun keɓantaccen home na wucin gadi: ```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" # Ko zaɓi provider+model ta hanyar hulɗa sannan a rubuta saitin kayan aikin: omniroute configure codex # akwai kuma: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Kowane umarni yana mutunta remote context mai aiki (`omniroute connect `), `--dry-run` yana nuna ainihin env/args ba tare da aiwatarwa ba, sannan `--api-key-env NAME` yana hana sirrika shiga tarihin shell ɗinka. → [Haɗaɗɗun CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 Masu Samar da AI 375 — 153 da Aka Yi Musu Alamun Kyauta a Katalog
> **Masu samarwa 375 da aka rajista** a cikin manyan tarin chat, media, search, local, cloud-agent da system, ciki har da **153 masu ɗauke da metadata na gano `hasFree: true`**. Rajistar model na chat tana ƙunshe da **masu samarwa 239 / ma'aurata provider-model 3,059 daban-daban / raw model IDs 1,475**; katalog na kasafin kyauta na daban yana da **layuka 467 na kowane model**, **pools 34 masu maimaitawa** da **masu samarwa 51 na maimaitawa/marasa makulli kyauta har abada**. Wadannan adadin ƙidaya daban-daban ne da gangan; ma'anoni da ƙididdigar da aka cire kwafin pools suna cikin [Bayanin Masu Samarwa](docs/reference/PROVIDER_REFERENCE.md) da [Matakan Kyauta](docs/reference/FREE_TIERS.md).
### 🏢 Kowane babban lab — ta hanyar endpoint ɗaya
OpenAI
OpenAI
Anthropic
Anthropic
Gemini
Gemini
xAI Grok
xAI Grok
DeepSeek
DeepSeek
Mistral
Mistral
Qwen
Qwen
Meta Llama
Meta Llama
Groq
Groq
NVIDIA
NVIDIA
MiniMax
MiniMax
Cohere
Cohere
Perplexity
Perplexity
Hugging Face
HuggingFace
Together
Together
Fireworks
Fireworks
Cloudflare
Cloudflare
Baidu
Baidu
…da ƙarin 350+ — kowane icon yana fitowa kai tsaye daga katalog ɗin masu samarwa na dashboard. 📖 [Bayanin Masu Samarwa](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Kyauta Har Abada — $0, babu kati
OpenCode Zen
OpenCode Zen
DeepSeek V4, Nemotron 3
Babu iyakar token
Kilo Code
Kilo Code
Auto-router, Tencent Hy3
Kyauta har abada
Requesty
Requesty
GPT-OSS 120B, Nemotron
Kyauta har abada
SiliconFlow
SiliconFlow
DeepSeek V3.2 / R1
Matakin kyauta
Z.AI GLM
Z.AI GLM
GLM-4.7 / 4.5-Flash
Kyauta har abada
Baidu ERNIE
Baidu ERNIE
ERNIE 4.0
Kyauta har abada
Qoder AI
Qoder AI
Qwen3-Max, Kimi-K2
KYAUTA marar iyaka
Pollinations
Pollinations
GPT, Llama, Claude
Ba a buƙatar makulli
Cloudflare AI
Cloudflare AI
Samfura 50+
Neurons 10K a rana
NVIDIA NIM
NVIDIA NIM
GLM, MiniMax
~40 RPM kyauta
Cerebras
Cerebras
GLM 4.7, GPT-OSS
Kiredit $5 na sau ɗaya; ana buƙatar kati
OpenRouter
OpenRouter
Samfuran :free
+$10 → RPM mafi girma
📖 Cikakken katalog wanda inji zai iya karantawa → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Inda OmniRoute Ke Gudana — Ko’ina
> Manhaja ɗaya, na’urarka, dokokinka. Daga shigarwar npm ta duniya baki ɗaya har zuwa **wayarka** ta hanyar Termux.
DandaliShigarwaMuhimman abubuwa
📦 npm (na duniya baki ɗaya)npm install -g omnirouteUmarni ɗaya, kowane OS
🐳 Dockerdocker run … diegosouzapw/omnirouteGine-ginen na’ura da yawa AMD64 + ARM64
🖥️ Kwamfutar tebur (Electron)npm run electron:buildTagar asali + tiren tsarin — Windows / macOS / Linux
🎩 Sandar menu (OmniRouteTray)brew install --cask zoispag/tap/omniroute-trayYana sa ido kan sabar & yana sabunta ta kai tsaye — macOS
💪 ARMna asali arm64Raspberry Pi, sabar ARM, Apple Silicon
📱 Android (Termux)pkg install nodejs && npx -y omnirouteYana gudana a wayarka, 24/7, ba tare da root ba
📲 PWA"Ƙara zuwa Fuskar Farko"Cikakken allo, ba tare da intanet ba, ana iya shigarwa daga burauza
🧩 Fulogin OpenCode@omniroute/opencode-providerHaɗawar OpenCode ta asali
🤖 VS Code Copilot Chatshigar da ƙarin OmniCopilotKowane samfurin OmniRoute a cikin mai zaɓar Copilot Chat na asali — barga & Insiders
🛠️ Daga lambar tushenpm install && npm run devYi masa gyare-gyare, ba da gudummawa
📖 [Jagorar Docker](docs/guides/DOCKER_GUIDE.md) · [Kwamfutar tebur](electron/README.md) · [Tiren sandar menu](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)
### 🧩 Sabo: OmniRoute a cikin Copilot Chat na asali na VS Code
> Babu sabon sandar gefe, babu sabon UI na hira — duk samfurin da OmniRoute ke samarwa yana bayyana kai tsaye a cikin > **mai zaɓar samfurin Copilot Chat da kake amfani da shi tuni**. Tun daga VS Code 1.122, samfuran masu samarwa suna aiki > ba tare da shiga GitHub ko biyan kuɗin Copilot ba — yanayin wakili, kiran kayan aiki da hangen hoto, duk > kyauta. Shigar da ƙarin **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, saita shi zuwa sabar OmniRoute ɗinka (tsohon saitin shi ne `localhost:20128`), sannan buɗe Copilot Chat → mai zaɓar samfuri → **Sarrafa Samfura…** → **OmniRoute**.
ShagoMahaɗiYana aiki da
🧩 VS Code MarketplaceShigar →VS Code — barga & Insiders
🔓 Open VSX RegistryShigar →Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…
Daga cikin editan: buɗe kallon **Extensions**, bincika **"OmniRoute"**, danna **Install** — yana aiki iri ɗaya a shagunan biyu. Lambar tushe, matsaloli da littafin matakan wallafawa suna nan a [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). 📖 [Jagorar VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — saitawa, abin da mai zaɓar ke nunawa, allon kulawa a cikin shafi, warware matsaloli
### 🎩 Sabo: OmniRouteTray — ƙofarka, tana zaune a sandar menu
> `omniroute serve` ya fi jin daɗi idan yana kunne koyaushe. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > yana mayar da hakan manhajar sandar menu ta macOS da za ka saita ka manta da ita: yana fara sabar, yana tabbatar da ci gaba da aikinta > bayan sake kunna na’ura, yana sabunta ta a wurinta, kuma yana sa kasafin token ɗinka na kai-tsaye ya kasance kusa da dannawa ɗaya — **ba a > bar tagar terminal a buɗe ba, babu `npm install -g omniroute` da za a riƙa kula da shi.** An gina shi da [Tauri v2](https://v2.tauri.app/) (jigon Rust mai ƙanƙanta ƙwarai), yana zuwa da runtime na Node 24 nasa mai sa hannu kuma yana sarrafa shigarwar OmniRoute mallakar manhajar, don haka ba ya taɓa cin karo da `node`/`bun` naka na duniya baki ɗaya. Yana **amfani tare da saitunanka da rumbun bayananka na `~/.omniroute/` da suke akwai** — don haka OmniRoute ɗin da kake gudanarwa tuni ne, kawai yanzu yana sanye da hula. 🎩
Abin da yake yiYadda yake yi
🟢 Yana sa ido kan sabarYana ƙaddamar da omniroute serve, yana karɓar misalin da ke gudana tuni maimakon maimaita shi
📊 Amfani na kai-tsaye a kallo ɗayaSandunan ƙason masu samarwa, iyakokin zaman Claude/na mako-mako tare da ƙidayar lokacin sake saitawa, rabon kuɗin kwanaki 30
🔄 Yana sabunta kansa a wurinsaShigarwa mai matakai, musayar atomic, komawa baya idan an gaza — koyaushe a kan sabuwar fitarwa
🚀 Farawa yayin shigaZaɓin ƙaddamarwa yayin shiga; tire kawai, babu alamar dock
🩺 Bincike & rajistociBinciken matsala da samun damar rajistan sabar da dannawa ɗaya
```sh brew install --cask zoispag/tap/omniroute-tray ``` Ka fi son saukewa? Ɗauko sabuwar .dmg daga Fitowar Sabbin Nau'ikan. Lambar tushe, matsaloli da takardun ginawa suna nan a zoispag/omniroute-tray.
💛 Aikin al'umma ne daga @zoispag — ba fitowar OmniRoute ta hukuma ba ce.

## 🔒 Na Sirri & Mai Bai wa Na’ura Fifiko
Na sirri kuma mai bai wa na’ura fifiko — ƙofar shiga da sashen sarrafawa na OmniRoute suna aiki a kan na’urarka. Ana aika prompts zuwa mai bayarwa na upstream da aka zaɓa ga kowace buƙata; OmniRoute ba ya ƙara wata hanyar sarrafa prompt da aka ɗauki nauyinta a wani wuri, kuma telemetry a kashe yake ta tsohuwa. Ana rufaffen credentials yayin ajiya da AES-256-GCM; matakan sarrafawa sun haɗa da iyakance API-key, tace IP, iyakokin yawan buƙata, kariya daga prompt-injection, goge upstream-headers, ɓoye PII na zaɓi, kurakurai da aka tsabtace da kuma tarihin binciken SQLite na cikin gida. OmniRoute yana ƙarƙashin lasisin MIT kuma ana iya ɗaukar nauyinsa da kai. 📖 [Izini](docs/architecture/AUTHZ_GUIDE.md) · [Matakan Kariya](docs/security/GUARDRAILS.md) · [Bin Ka’idoji](docs/security/COMPLIANCE.md)
## 🔌 Cikakken CLI + A2A & MCP
> Bayan uwar garken, OmniRoute **cikakkiyar cibiyar sarrafa layin umarni ce** mai **umarni sama da 80**, tare da buɗaɗɗun ƙa'idojin wakilai domin wakilin AI ya iya sarrafa ta **da kansa**. ### ⌨️ CLI na gaske (ba `start` kawai ba) ```bash omniroute # ƙaddamar da gateway + dashboard (tashar 20128) omniroute chat # abokin hulɗar taɗi na TUI (slash: /model /combo /skill /memory) omniroute setup # jagorar saitin fara amfani omniroute doctor # gano matsalolin masu samarwa, tashoshi, native deps ``` ### 🛰️ Yanayin nesa — gudanar da CLI a nan, OmniRoute a kan VPS OmniRoute na kan uwar garke? Sarrafa shi daga kwamfutar tafi-da-gidanka da **CLI iri ɗaya**. Shiga sau ɗaya da scoped access token; daga nan kowane umarni zai nufi na'urar nesa. ```bash omniroute connect 192.168.0.15 # kalmar sirri → scoped token, an adana shi a matsayin context omniroute models # ← yana gudana a kan uwar garken NESA omniroute configure codex # ← yana zaɓar model na nesa, yana rubuta profile na Codex na gida omniroute tokens create --name ci --scope read # ƙirƙiri tokens masu ƙuntataccen izini don wasu na'urori omniroute contexts use default # ← koma zuwa uwar garken gida ``` Tokens suna da scopes na `read` / `write` / `admin`; routes masu ƙaddamar da processes suna nan a loopback kawai. 📖 [Yanayin Nesa](docs/guides/REMOTE-MODE.md)
Gwajin terminal mai motsi da ke nuna OmniRoute CLI — omniroute providers list, omniroute combo list da omniroute health — yana zagayawa a cikin umarni 89 na matakin sama: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …
### 🤝 Haɗa wakili — kuma zai sarrafa OmniRoute da kansa Bayyana OmniRoute ta hanyar **MCP**, **A2A**, **REST API**, **webhooks** ko **CLI na nesa** — duk wani wakili mai ƙwarewa (ko lambar da ka rubuta) zai sami damar sarrafa dukkan gateway ɗin: routing, providers, combos, cache, compression, memory — kai tsaye. Ana samar da HTTP endpoints na ƙasa a ƙarƙashin `http://localhost:20128`.
Hanyar sadarwaEndpoint / umarniAbin da ake amfani da shi
🧰 MCP (stdio)omniroute --mcpHaɗa shi da Claude Desktop, Cursor, ko kowane MCP client
🌊 MCP (HTTP)/api/mcp/streamMCP na nesa — kayan aiki 110, scopes 33 (aiwatar da ƙuntatawa na zaɓi ne), cikakken tarihin bincike
📡 MCP (SSE)/api/mcp/sseHanyar jigilar MCP mai gudana kai tsaye
🤝 A2A/.well-known/agent.jsonDaga wakili zuwa wakili, JSON-RPC 2.0 + SSE, skills 6
🌐 REST API/v1/*Mai jituwa da OpenAI — taɗi, embeddings, hotuna, sauti, OCR
🔔 Webhooks/api/webhooksTura al'amuran buƙata / quota zuwa Slack, Discord, Telegram ko kowane URL
🛰️ CLI na nesaomniroute connect Sarrafa instance na nesa da scoped access tokens
```bash # Ba Claude Code cikakken kayan aikin OmniRoute ta hanyar MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` 📖 [Uwar Garken MCP](docs/frameworks/MCP-SERVER.md) · [Uwar Garken A2A](docs/frameworks/A2A-SERVER.md) · [Ƙa'idojin Wakilai](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Adana Token 15–95% — Ta Atomatik
### 📖 Yadda yake aiki — pipeline, gine-gine & lissafin tanadi Pipeline ɗin matsawa na OmniRoute: buƙatar abokin ciniki mai token 10,000 don kwatantawa tana wucewa ta hanyar injuna 12 da za a iya haɗawa — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra da OmniGlyph — kuma tana iya isa ga mai samarwa a kusan token 1,080 a cikin misalin stacked da aka rubuta. Ana kare abun ciki da aka tsara ta hanyar matsaran kiyayewa da ƙofofin daidaito na kowane mataki; yanayin lossy na bayyane ko na gwaji na iya canza abun ciki da ya cancanta. Combo na stacked na tsoho yana gudanar da `RTK → Caveman`. Idan dukkansu suna aiki a kan kayan aikin tool/context ɗaya, tanadi yana haɗuwa: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Injin kiyayewa yana **kullum kare** code blocks, URLs, JSON da bayanan da aka tsara. > **Me ya sa ake amfani da token da yawa alhali kaɗan ke cika aikin?** Kowace buƙata tana wucewa ta pipeline ɗin matsawa na OmniRoute **a bayyane** — babu canje-canje a gefen abokin ciniki. Yanzu **tarin injuna 12 da za a iya haɗawa** ne waɗanda ke gudana bisa tsari kuma ana haɗa su da daidaitawa bisa combo na routing — gina bisa ra'ayoyi daga [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), da [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Taron injuna 12 Injunan suna gudana bisa tsarin pipeline; kowannen yana da iya kunna/kashewa da daidaitawa shi kaɗai bisa combo:
#InjiAbin da yake yi
1Session-DedupYana fitar da abun ciki da aka maimaita a fadin zagayowar tattaunawa (ana nufin shi ta adireshin abun ciki, tsakanin zagayowa)
2CCRYana ajiye manyan tubalan a bayan alamun dawowa, ana kawo su idan an buƙata
3LiteGoge whitespace + URL ɗin hoto (tushen da ke da ƙarancin jinkiri)
4RTKTacewa ta wayo ga sakamakon kayan aiki, cire kwaskwarima & guntawa (yana sanin umarni)
5Responses Tool OutputJSON lossless-da-farko + matsawar bincike mai iyaka don fitar da shell/patch/search/build (Responses API)
6HeadroomMatse tebur na lossless na JSON arrays (~30%) ta hanyar codec na GCF da aka haɗa a ciki
7RelevanceƘididdigar jimla ta fitarwa bisa tambayar mai amfani ta ƙarshe
8CavemanMatsawar rubutu bisa ƙa'ida (~65–75% a kan fitarwa)
9AggressiveTakaitawa + tsufa mataki-mataki na tsoffin zagayowar tattaunawa
10LLMLingua-2Yanke ma'ana na ML ta hanyar MobileBERT ONNX — amintacce ga code, async
11UltraYanke token na heuristic tare da matakin ƙaramin samfuri (SLM) na zaɓi
12OmniGlyphLamuntawa ta gwaji ta context-a matsayin-hoto don Claude Fable 5 da aka auna a kan layin Anthropic kai tsaye; GPT 5.6 transformers suna ci gaba da kasancewa fail-closed har sai an samu shaida daga mai samarwa. Bayanan martaba huɗu na matsawa (aggressive tsoho, daidaitacce, amintacce ga coding, passthrough) (mafi ƙarfi; ana shiga ta zaɓi)
Ana **kullum adana** code blocks, URLs da bayanan da aka tsara daidai-ta-byte. **Saitunan danna-ɗaya** suna haɗa injunan:
YanayiTanadiMafi dacewa don
🪶 Lite~15%Tsoho amintacce da ke aiki koyaushe
🪨 Standard (Caveman)~30%Coding na yau da kullum
⚡ Aggressive~50%Dogayen zama masu cike da kayan aiki
🔥 Ultra~75%Mafi yawan tanadi
🧰 RTK60–90%Fitar da shell/test/build/git
🔗 Stacked (RTK → Caveman)78–95%Prompts gauraye + rajistan kayan aiki
**Misali na gaske — yanayin Standard:** > **Kafin (token 69):** _"Dalilin da ya sa React component ɗinku yake sake rendering mai yiwuwa shi ne kuna ƙirƙirar sabon reference na object a kowace zagayowar rendering. Idan kuna wucewa da object na inline a matsayin prop, kwatancen shallow na React yana ganin shi a matsayin wani object daban a kowane lokaci, wanda hakan ke haifar da sake rendering. Ina ba da shawarar amfani da useMemo don memoize object ɗin."_ > > **Bayan (token 19):** _"Sabon ref na object a kowane rendering. Prop na inline object = sabon ref = sake rendering. Rufe shi a useMemo."_ > > **Amsa ɗaya ce. Ragin token da 72%. Babu asarar daidaito.** ✅ **Misalin PT-BR — yanayin [Troglodita](https://github.com/leninejunior/troglodita):** > **Kafin (42 tokens):** _"Matsalar ita ce samfurin yana sake-nunawa saboda ana ƙirƙirar sabon nuni na abu a kowane zagayowar nunawa. Zan ba da shawarar amfani da useMemo."_ > > **Bayan (12 tokens):** _"Sake-nuni: sabon ref a kowane zagaye (an sake ƙirƙirar abu inline). Yi amfani da `useMemo`."_ > > **Amsa ɗaya. ~70% ƙarancin tokens. Daidaiton fasaha babu ɓarna.** ✅
### 🎚️ Bayan injunan — salon fitarwa, ma'aunin dacewa & sarrafa kowace buƙata Injunan 12 da ke sama suna rage abin da ke shiga **ciki**. Sauran matakai uku suna tsara **yadda**, **yaushe**, da abin da ke **fita**: - **🪄 Salon Fitarwa** _(jagorar axis-fitarwa)_ — shigar da umarnin tsara-amsa masu tabbas, amintattu ga cache; ana iya haɗa su, kowanne a matakin `lite` / `full` / `ultra`. Ƙara salon shine shigarwa ta layi ɗaya a rajista: - **Prose gajere** — cire cika-kalma / articles / neman kaucewa; ci gaba da riƙe abun fasaha daidai. - **Ƙarancin code** — "lazy senior dev" YAGNI: mafi ƙaramin canji da ke aiki, babu scaffolding da ba a nema ba. - **Ponytail (lazy senior dev)** — hau tsirar YAGNI, gyara tushen matsala, mafi ƙaramin diff da ke aiki. - **Ina da ADHD (aiki-da-farko)** — matakin gaba yana jagora, matakai suna da lambobi, mataki na gaba ɗaya mai tabbas, babu gabatarwa. - **Terse CJK (文言)** — salon ultra-gajere na Sinanci na gargajiya (an ƙuntata shi zuwa `zh`). - **🎯 Kasafin context mai dacewa** _(ma'auni)_ — maimakon ƙofar token ɗaya ta kunna/bice, ɗaga mafi araha, injunan da ba su da asara kawai har zuwa inda ake buƙata don **samar da dacewa da tagar context na samfurin**. Manufofi: `reserve-output` (tsoho, ya san samfurin) · `percentage` · `absolute`. Yanayi: `floor` (tabbatar da dacewa) · `replace-autotrigger` (zaɓin ku na sarif yana nasara) · `off` (ƙofar gado). - **🎛️ Inda ake yanke shawarar matstsawa** _(fifiko, sama → ƙasa)_ — header na kowace buƙata `x-omniroute-compression` › override na routing-combo › profile mai suna da ke aiki › dacewa / auto-trigger › tsohon panel › kashe. Tsarin da aka yi amfani da shi yana dawowa a cikin header na amsa `X-OmniRoute-Compression: ; source=`. Kunna ta atomatik ta ƙofar token, kunna ma'aunin dacewa, kafa profile mai suna, saita na lokaci ɗaya ga kowace buƙata, ko sanya pipeline ga kowace routing combo — duk wanda ya dace da aikin. **Eval harness** na zaɓi mara layi (`npm run eval:compression`) yana ƙididdige aminci vs. tanadi a kan corpus da aka kafa kafin ku inganta canji. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Fara da Sauri
**1) Shigar & gudana** ```bash npm install -g omniroute omniroute ``` > 💡 Kuna ganin `npm warn ERESOLVE` ko gargaɗin peer-dep? [Ba su da illa](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Kuna amfani da npm 11 ko na baya?** npm na iya toshe rubutun lifecycle na fakiti sai in an ba su izini. Ana buƙatar `postinstall` na OmniRoute (`node scripts/build/postinstall.mjs`) don shirya fayilolin runtime na asali. Bari fakitocin da aka ambata a gargaɗin npm yayin shigarwa a duniya. Don tsarin fakitin da OmniRoute 3.8.53 ya ba da rahoto: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Don sake amfani da wannan jerin izini don shigarwar duniya ta nan gaba, saita shi sau ɗaya, sannan ku shigar kamar yadda aka saba: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Jerin abubuwan dogaro na iya canzawa tsakanin fitarwa; idan npm ya ba da rahoton jeri daban, yi amfani da sunayen fakiti daga wannan gargaɗi. Ba da izinin fakiti yana ba da damar gudanar da rubutun shigarwa. > **Kuna amfani da Gemini Web ko wani mai samar da web-cookie?** Fakitin npm yana haɗawa da > Playwright amma ba binary na Chromium ba. Duba bayanin > [saita Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > kafin yin buƙata ta farko ta mai samar da yanar gizo. Dashboard a `http://localhost:20128` · API a `http://localhost:20128/v1`. **2) Haɗa mai samarwa mai cancanta ta amfani da asusun ku** Dashboard → **Providers** → zaɓi mai samarwa wanda sharuddan sa na yanzu da quota suka dace da yanayin amfanin ku → ƙara maɓallin API ko kammala tsarin asusun sa. Matakan kyauta na iya buƙatar rajista, amincewa, ko hanyar biya. Duba [Jagorar Matakan Kyauta](docs/getting-started/FREE-TIERS-GUIDE.md); ba a tabbatar da samuwa ba tare da maɓalli ba, kuma an keɓe masu samarwa da aka yi wa alama `tos: avoid` daga `auto` ta tsoho. **3) Nuna kayan aikin coding ɗin ku** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Tabbatar yana aiki** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Ya kamata ku ga samfurori da kuka haɗa an jera su. 🎉 Shi kenan — fara coding, kuma OmniRoute yana auto-routing & fallback a gare ku. Idan abokin cinikin ku ba zai iya aika alamu na al'ada ba, OmniRoute kuma yana bayyana aliases na dacewa masu alama: ```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 ``` Yi amfani da waɗannan kawai ga abokan ciniki da ba za su iya haɗa `Authorization: Bearer ...` ba. Auth na header ya kasance hanyar da aka fi so.
## 📦 Ƙarin hanyoyin girkawa — Docker, tushe, 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` yana bin mafi girman tsayayyen SemVer da aka **wallafa**. Ba ya bin git `main`. Saka takamaiman `:X.Y.Z` don GitOps. Duba [Tashoshin Fitarwar Docker](docs/guides/DOCKER_GUIDE.md#release-channels).An saita hoton zuwa **`OMNIROUTE_MEMORY_MB=1024`**. Wannan ya isa ga dashboard da hira marar nauyi. **Wakilan coding** (`POST /v1/responses` daga Claude Code, Codex, Grok, …) suna buƙatar V8 heap mafi girma sosai, in ba haka ba tsarin zai yi `FATAL ERROR` a kusan 12 GiB yayin da dogayen contexts guda biyu suka zo lokaci guda. Saita girman container sama da heap (native buffers suna wajen V8): | Nauyin aiki | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) | | ------------------------------------------ | ------------------------------- | ---------------------- | | Dashboard / hira marar nauyi | `1024` (tsohon saitin hoton) | ≥2 g | | Wakilin coding guda ɗaya | `8192` | ≥10 g | | Dogayen `/v1/responses` biyu a lokaci guda | `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 ``` Cikakken jadawali: [Jagorar Docker — RAM na lokacin aiki](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Tashar Docker ta kafin fitarwa:** `diegosouzapw/omniroute:next` da > `diegosouzapw/omniroute:next-web` suna bin reshen `release/v*` na yanzu wanda ake amfani da shi ta tsoho. > Waɗannan tags masu sauyawa an tanade su ne kawai don gwada gyare-gyaren da ba a fitar ba kuma > **ba a goyon bayansu don production**. Duba > [Tashoshin Fitarwar Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Ana goyon bayan daidaitaccen `bun install` da girkawa ta global (`bun install -g omniroute`) ta hanyar gano Bun runtime: - **Ginannen `bun:sqlite`**: OmniRoute yana amfani da ginannen driver na Bun mai suna `bun:sqlite` lokacin da yake gudana ƙarƙashin Bun, sannan ya koma amfani da `better-sqlite3` a Node.js ko `sql.js`. - **Zaɓin Webpack bundler ta atomatik a dev**: Development (`bun run dev`) yana gano Bun ta atomatik kuma ya kashe Turbopack don amfani da Webpack domin hana rashin jituwa da native V8 bindings. Production builds (`bun run build`) suna bin `OMNIROUTE_USE_TURBOPACK` daidai kamar a Node: Turbopack ta tsoho, `OMNIROUTE_USE_TURBOPACK=0` don yin build da Webpack (`Dockerfile.bun` yana samar da shi a matsayin `--build-arg`). - **Dockerfile na musamman don Bun**: `Dockerfile.bun` mai matakai da yawa don native Bun production deployments (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Girka kuma gudanar da Bun bun install bun run dev ``` **🛠️ Daga tushe** ```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 # Amfani da Nix flakes nix develop npm run dev # Ko amfani da devbox devbox run npm run dev ``` 📖 [Jagorar Docker](docs/guides/DOCKER_GUIDE.md) — Compose profiles, Caddy HTTPS, Cloudflare tunnels. **🦭 Podman** ```bash # 1. Shirya kundin bayanan da aka haɗa ta bind mount mkdir -p data # 2. Linux + local rootless Podman kawai (kar a taɓa amfani da remote Podman Machine client): podman unshare chown 1000:1000 ./data # 3. Saita alamar runtime, gina local Compose image, sannan fara echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` A macOS ko Windows, Podman yana amfani da remote Podman Machine: tsallake `podman unshare` kuma bi [jagorar kundin bayanai bisa topology](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Jagorar Podman](contrib/podman/README.md) — Compose builds, Podman Machine, da saitin Linux/systemd Quadlet. **⚡ Girkawa mafi sauri / marar nauyi (tsallake native build)** Native SQLite engine (`better-sqlite3`) dependency ne na **zaɓi**, don haka global install ba ya taɓa tsayawa yana jiran compilation daga tushe: yana amfani da prebuilt binary idan akwai wanda ya dace da platform/Node ɗinka, idan kuma babu sai ya koma kai tsaye zuwa pure-JS engine (`node:sqlite` a Node 22+, in ba haka ba bundled `sql.js` WASM) — ba a buƙatar build tools. Don tsallake native warm-up na bayan girkawa gaba ɗaya (CI, headless, ko na'urori masu jinkiri): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 shi ma yana tsallake shi ``` Don girkawa mafi sauri, fi son **pnpm** (content-addressed store + hard links — duba sama). Don runtime marar dashboard kuma headless, yi amfani da Docker `base` profile (a sama) ko [jagorar Termux](docs/guides/TERMUX_GUIDE.md). CLI da web dashboard ana samar da su ne ta tsari guda a port guda, don haka babu wani package na CLI-kawai a halin yanzu.
# 🎬 OmniRoute Yana Aiki
## 📹 Jagororin Bidiyo
Hoton dashboard a 2026-10-18 · Kundin bayanai na asali: YT 1.352 | TT 334 | IG 290 · Sabunta bayanai (kwanaki): YT 5 | TT 48 | IG 49
Bidiyon Instagram — nick_saraev
🎬 #1 — Instagram
nick_saraev — kallo 3,042,474
Bidiyon Instagram — nnapier7
🎬 #2 — Instagram
nnapier7 — kallo 1,454,535
YouTube — Amidia AI & Tech
🎬 #3 — YouTube
Amidia AI & Tech — kallo 794,974
Bidiyon Instagram — theopenstack
🎬 #4 — Instagram
theopenstack — kallo 692,419
TikTok — migue.baena
🎬 #5 — TikTok
migue.baena — kallo 685,788
**Cikakken matsayi (an cire maimaitattun URLs na asali, `v > 0`, mafi girman isa):** | #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** | Ma'aunai na asali a 2026-10-18: **bidiyoyi na musamman 1.976** · **sanannun kallo 20.220.289** (`v > 0`) · **tashoshi/asusu 1.210 bisa kowace hanyar sadarwa**. Dashboard na asali yana ɗauke da layuka 1.976 (YouTube 1.352 = dogayen bidiyoyi 740 + Shorts 612 · TikTok 334 · Instagram 290); babu wani maimaitaccen bayani da ya rage bayan daidaitawa bisa URL na asali, wanda ke riƙe da mafi girman adadin kallo ga kowane bidiyo. An dakatar da tattara bayanan YouTube a 2026-10-13 (adadin amfani na API ya ƙare daga 14 zuwa 18/10), yayin da aka dakatar da na TikTok/Instagram tun 2026-09-02 (babu kuɗin tattara bayanai); har yanzu bidiyoyi 76 ba su da adadin kallo. > 🎬 **Ka yi bidiyo game da OmniRoute?** Buɗe [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) ko [discussion](https://github.com/diegosouzapw/OmniRoute/discussions) tare da mahaɗin — za mu nuna shi a nan.
# 📧 Al'umma & Taimako > Komai a wuri guda — bi mai kula da aikin, yi hira da al'umma, ko buɗe issue. | Tasha | Inda / yadda | | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — bi mai kula da aikin | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — bi don sabbin fitowar siga da shawarwari | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Duniya** | [shiga rukunin](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazil** | [shiga rukunin](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Yanar gizo** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Al’ummar StHub OmniRoute (kyauta)** | [tashar StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Lambar tushe** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Kai rahoton matsala** | [buɗe batu](https://github.com/diegosouzapw/OmniRoute/issues) — haɗa sakamakon `npm run system-info` | | 🤝 **Ba da gudummawa** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Tsarin Rassa da Fitar da Siga](docs/ops/BRANCHING_MODEL.md) · zaɓi `good first issue` | | 💚 **Tallafa wa aikin** | [Hanyoyin tallafawa ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |
---
## 🛠️ Tarin Fasaha
MatakiFasaha
Lokacin AikiNode.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27
HarsheTypeScript 6.0 — 100% TypeScript a cikin src/ da open-sse/ (babu any a jigon tsarin tun daga v2.0)
Tsarin AikiNext.js 16 + React 19 + Tailwind CSS 4
Ma'ajin Bayanaibetter-sqlite3 (SQLite, WAL journaling) + LowDB (JSON na dā) — modules 147 na yankuna, migrations 209
ƘwaƙwalwaSQLite FTS5 binciken cikakken rubutu + vector embeddings masu int8-quantized, decay mai nau'i
Tsare-tsareZod 4 — tantance I/O na kayan aikin MCP + kwangilolin API
Ƙa'idodin SadarwaMCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
WatsawaServer-Sent Events (SSE) + gadar WebSocket (/v1/ws)
MatsewaPipeline mai injuna 12 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Tantancewa & tsaroOAuth 2.0 (PKCE) + JWT + API Keys + tantance MCP mai iyaka · AES-256-GCM a hali na ajiya · DOMPurify
ɓoyewawreq-js — kwaikwayon fingerprint na TLS JA3 / JA4, proxy mai matakai 3
JuriyawarCircuit breaker, exponential backoff, kariya daga thundering-herd, warkewar kai ta auto-combo
Rubutun Ayyukapino — logs na JSON masu tsari tare da mahallin buƙata
GwajiNode.js test runner + Vitest — sanarwar gwaje-gwaje 56,000+ a cikin fayilolin gwaji 7,800+ da ake bibiya (unit, integration, E2E, tsaro, ecosystem)
DandamaliDesktop (Electron) · Android (Termux) · PWA (kowane burauza)
CI/CDGitHub Actions — buga kai tsaye zuwa npm + Docker Hub a lokacin release
Hanyoyin HaɗiShafin Yanar · npm · Docker Hub

## 📖 Takaddun Bayanai
### 📘 Yadda Ake Farawa
TakardaBayani
Jagorar Mai AmfaniMasu samarwa, combos, haɗin CLI, tura zuwa amfani
Jagorar SaitawaCikakkun hanyoyin shigarwa, saitunan kayan aikin CLI, kafa protocol, daidaita timeout
Jagorar Kayan Aikin CLISaitin kowane kayan aiki don Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Yanayin Mai NisaSarrafa OmniRoute mai nisa (VPS) daga CLI na kwamfutar hannu ta alamar dama da aka keɓance
Saitin Claude CodeNuna Claude Code zuwa OmniRoute (na gida/na nisa) tare da launch + bayanan martaba na kowane samfuri
Fara Ciki Da SauriShigarwa ta matakai 3 → haɗa → saita
### 🔧 Ayyuka & Tura zuwa Amfani
TakardaBayani
Jagorar DockerDocker run, bayanan Compose, Caddy HTTPS, tunnels, alamun hoto
Jagorar PodmanHaɗin Quadlet systemd, podman-compose, SELinux
Tura VM zuwa AmfaniCikakkiyar jagora: saitin VM + nginx + Cloudflare
Tura Fly.io zuwa AmfaniTura zuwa Fly.io tare da ma'ajin data na dindindin
Jagorar TermuxGudanar da OmniRoute akan Android ta Termux
Jagorar PWAShigar da Progressive Web App, caching, gine-gine
Jagorar CirewaCirewa tsaftace don duk hanyoyin shigarwa
Saitin MuhalliCikakkun masu canjin .env da nassoshi
### 🧠 Fasali & Gine-gine
TakardaBayani
Gine-gineGine-ginen tsari, kwararar bayanai, da cikin gida
Jagorar MatsawaPipeline na zaɓuɓɓuka 7: off / lite / standard / aggressive / ultra / RTK / stacked
Matsawar RTKMatsawar fitowar umarni, matatsu, amincewa, tabbatarwa, dawo da fitowar raw
Injunan MatsawaCaveman, RTK, stacked pipelines, saman dashboard/API/MCP
Tsarin Dokokin MatsawaSchemomin JSON rule-pack don Caveman da matatsun RTK
Kunshin Harsunan MatsawaGano harshe da ƙirƙirar rule-pack na Caveman
Jagorar JuriyaCircuit breakers, cooldowns, jerin jira, hana thundering herd, yaudarar TLS
Injin Auto-ComboKimantawa ta abubuwa 16, kunshin yanayi, kai-waraka
Jagorar ProxyTsarin proxy na matakai 3, kasuwar 1proxy, CRUD na rajista
Matakan KyautaKundin da aka haɗa: wuraren taro masu maimaitawa 34 da aka rubuta / shigarwa 467 na matakin kyauta da aka lissafa
Nunin FasaliZiyarar gani ta dashboard tare da hotunan allo
Takaddun Bayanin CodebaseTafiya ta cikin codebase mai sauƙi ga masu farawa
### 🤖 Protocols & APIs
TakardaBayani
Nassin APIDuk endpoints tare da misalai
Ƙayyadaddun OpenAPIƘayyadaddun OpenAPI 3.0
MCP ServerKayan aikin MCP 110, saitunan IDE, abokan cinikin Python/TS/Go
Jagorar MCP ServerShigar da MCP, hanyoyin wucewa, da nassin kayan aiki
A2A ServerTsarin JSON-RPC 2.0, ƙwarewa, streaming, gudanar da ayyuka
Jagorar A2A ServerKatin wakilin A2A, ayyuka, ƙwarewa, da streaming
### 📋 Aiki & Inganci
TakardaBayani
Ba da GudummawaSaitin ci gaba da jagorori
Tsarin Reshe & Fitowar Juzu'iInda PRs ke nufi (release/*), abin da main da tags suke nufi
Tarihin Canje-canjeCikakken tarihin fitowar kowace sigar
Manufar TsaroRahoton rauni da ayyukan tsaro
Jagorar i18nTallafin harsuna 67, tsarin aikin fassara, RTL
Jerin Binciken SakinMatakun tantancewa kafin fitowar
Shirin RufewaDabarun rufe gwaji don bayanan gwaji na tsayayye sama da 56,000 a fayilolin gwaji sama da 7,800 da ake bibiya

# ⭐ Manyan Masu Ba da Gudummawa > Al'ummar buɗaɗɗiyar tushe mai himma ce ta kafa OmniRoute. Waɗannan mutanen sun ba da gudummawa na musamman waɗanda ke da tasiri kai tsaye ga inganci, kwanciyar hankali, da fadɗaɗɗen aikin. **Na gode.** ### Masu ba da gudummawa na waje ta haɗaɗɗun pull requests
MatsayiMai ba da gudummawaPRs da aka haɗa~Layukan da aka canza
1maxmad64bis37125,326,561
2HouMinXi26913,456,272
3backryun210270,562
4oyi77190411,243
5pacocartones17478,276
6JxnLexn1513,562,936
6KooshaPari1515,972,314
8rdself14580,663
9RaviTharuma123500,065
10herjarsa88230,872
11hartmark842,849,554
12jonlwheat2-gif6768,548
13artickc6243,502
14chirag127526,661
15xz-dev50245,976
16xiaoyaner02014733,626
17woodsonl46809,391
18rqzbeh44147,896
19QuangBlue4313,112
20MumuTW4026,093
An yi ƙidayar a 2026-10-18 15:09:09 UTC tare da ƙarshen release/v3.8.52 mai rayuwa 656f01cb43. Ƙidayar GitHub GraphQL mai shafi-shafi tana ƙunshe da haɗaɗɗun PRs 9,191: 3,834 daga mai ma'ajiyar, 229 daga Dependabot, 6 daga sauran bots/apps, kuma PRs na waje 5,122 daga masu ba da gudummawa daban-daban 835. "Layukan da aka canza" shi ne GitHub additions + deletions kuma ya ƙunshi fayilolin da aka samar, lockfiles, catalogs, fassarori da takaddun; shi ne churn, ba LOC da aka rubuta ba. PRs 49 sun ba da rahoton GitHub diffs sama da layi 500,000 (misali #13399, ƙara mai samar guda ɗaya, ya jera fayiloli 2,347 da aka canza), wanda ya ƙara adadin wasu lambobin da ke sama. Ana daraja daidaitattun tare. ### Commits da aka danganta ga GitHub
Dizzle
Dizzle

🥇 commits 367 da GitHub ta danganta
Bob.Hou
Bob.Hou

🥈 commits 269 da GitHub ta danganta
Paijo
Paijo

🥉 commits 229 da GitHub ta danganta
backryun
backryun

🏅 commits 202 da GitHub ta danganta
Paco Cartones
Paco Cartones

🏅 commits 174 da GitHub ta danganta
Ravi Tharuma
Ravi Tharuma

🏅 commits 126 da GitHub ta danganta
Markus Hartung
Markus Hartung

🏅 commits 114 da GitHub ta danganta
Randi
Randi

🏅 commits 108 da GitHub ta danganta
Jan Leon
Jan Leon

🏅 commits 87 da GitHub ta danganta
Chris
Chris

🏅 commits 70 da GitHub ta danganta
Koosha Paridehpour
Koosha Paridehpour

🏅 commits 68 da GitHub ta danganta
An sake duba a 2026-10-18 14:44:45 UTC: commits da GitHub ta danganta wanda Contributors API na ma'ajiyar ya ba da rahoto ga tsohon reshe release/v3.8.52. API ya dawo da keɓaɓɓun bayanai 849 (masu amfani 429, bots 2, marasa suna 418); wannan teburin ya cire mai kula da aikin, bots da keɓaɓɓun marasa suna, kuma ya riƙe daidaiton gasar. Ya bambanta da duka jerin matsayin PR da aka haɗa da ke sama da kuma ƙidayar Git-metadata da ke ƙasa. > 🙏 Fasalolin da waɗannan masu bayar da gudummawa suka kawo, gyaran kura-kurai, da gyare-gyaren kayayyakin more rayuwa sune **babban ɓangare** na abin da yake sa OmniRoute zama abin dogaro kuma mai cike da fasaloli. Kowane pull request, kowane test case, da kowane fayil na fassarar i18n yana da muhimmanci. Mutane irin nasu ne suke gina buɗaɗɗen tushe.
---
## 💖 Masu Tallafawa
Godiya ta musamman daga zuciya ga mutanen da ke ɗaukar nauyin OmniRoute daga aljihunsu — kowace gudummawa tana taimaka wa aikin ya ci gaba da kasancewa kyauta, mai cin gashin kansa kuma yana tafiya gaba.
Andrew
Andrew

💛 Mai tallafawa na kowane wata mai ci gaba
Vlad I
Vlad I

💛 Mai tallafawa na kowane wata mai ci gaba
小妍儿
小妍儿

💛 Mai tallafawa na kowane wata mai ci gaba
Guilherme Costa
Guilherme Costa

💛 Mai tallafawa na lokaci ɗaya mai ci gaba
Henrique Triches Iurkiv
Henrique Iurkiv

💛 Mai tallafawa na lokaci ɗaya mai ci gaba
Somesh Ghaturle
Somesh Ghaturle

💛 Mai tallafawa na lokaci ɗaya mai ci gaba
Kolonie AI
Kolonie AI

💛 Tsohon mai tallafawa na lokaci ɗaya
Professor Igor Morais Vasconcelos
Prof. Igor Morais

💛 Tsohon mai tallafawa na lokaci ɗaya
Pixma
Pixma

💛 Tsohon mai tallafawa na lokaci ɗaya
Paco Cartones
Paco Cartones

💛 Tsohon mai tallafawa na lokaci ɗaya
longtao
longtao

💛 Tsohon mai tallafawa na lokaci ɗaya
… da sauran waɗanda suka fi son kasancewa a ɓoye 💛 An sake tabbatar da masu tallafawa na GitHub na jama'a a ranar 2026-10-18 ta hanyar GitHub Sponsors GraphQL API: tallafi 11 na jama'a (6 masu ci gaba, 5 na baya) daga jimillar 14. Matsayin isActive na GitHub ne ke ƙayyade alamun masu ci gaba da ke sama; ana ci gaba da yi wa tsoffin masu tallafawa na jama'a na lokaci ɗaya godiya, yayin da masu tallafawa na sirri ke kasancewa ba tare da bayyana sunayensu ba. Ba a jera gudummawar Ko-fi, Buy Me a Coffee, Liberapay, PIX da crypto ba saboda ba su da bayanan mai tallafawa na jama'a. 💖 Zama mai tallafawa → — kowace dala tana taimaka wa OmniRoute ya ci gaba da kasancewa kyauta kuma mai cin gashin kansa.

## 👥 Masu Ba da Gudummawa 900+
[![Masu Ba da Gudummawa](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) An gudanar da bincike a ranar 2026-10-18 a kan ƙarshen release/v3.8.52 na kai-tsaye, wato ad160ab2d1 (commits 6,826): asalin mutane 993 na Git da aka daidaita — 707 sun bayyana a matsayin marubutan commit (ciki har da mai kula da aikin), yayin da 286 suka bayyana ne kawai a cikin alamomin Co-authored-by da aka bayyana kai tsaye. Ƙidayar tana amfani da .mailmap, tana kwatanta adiresoshin imel ba tare da la’akari da bambancin manyan da ƙananan haruffa ba, tana haɗa adiresoshin GitHub noreply masu lambobi da na rubutu kawai idan suna wakiltar suna iri ɗaya, tana ware asalin bots/agents/services/placeholders guda 26, kuma ba ta haɗa adiresoshin imel na yau da kullum kawai saboda sunayen da suke nunawa sun yi daidai ba. Binciken ranar 2026-08-24 ya wallafa 639; sake gudanar da wannan hanyar a kan tushen binciken nan na ac02c5b42f ya ba da 619, don haka ƙaruwar ta samo asali ne daga sababbin masu ba da gudummawa, ba daga sassauta hanyar ba. ### Yadda Ake Ba da Gudummawa 1. Yi fork na ma’ajiyar 2. Ƙirƙiri reshe daga ƙarshen **mai aiki** na `release/vX.Y.Z` (ba `main` ba) — duba [Tsarin Reshe da Fitarwa](docs/ops/BRANCHING_MODEL.md) 3. Ƙirƙiri reshen fasalinka (`git checkout -b feat/amazing-feature`) 4. Yi commit na sauye-sauyenka (`git commit -m 'feat: add amazing feature'`) 5. Tura zuwa reshen (`git push origin feat/amazing-feature`) 6. Buɗe Pull Request mai **base = wannan reshen `release/vX.Y.Z`** Duba [CONTRIBUTING.md](CONTRIBUTING.md) don cikakkun jagorori. ### Fitar da Sabuwar Siga ```bash # Ƙirƙiri fitarwa — npm publish zai gudana ta atomatik VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```
## 📊 Taurari Jadawalin Tarihin Taurari
## 🌍 StarMapper StarMapper

## 🙏 Godiya
OmniRoute ya ginu ne a kan ayyukan manyan da suka gabata. Ya fara ne a matsayin reshen **[9router](https://github.com/decolua/9router)** da kuma sauya aikin Go na **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** zuwa TypeScript — daga nan kuma, kowane ƙaramin tsarin da ke ƙasa ya samo wahayi daga wani aikin buɗaɗɗen tushe da ya riga ya cim ma hakan. Kowannensu ya taimaka wajen tsara wani takamaiman ɓangare na OmniRoute. Wannan ita ce godiyarmu gare su baki ɗaya. 🙏 > ⭐ an tabbatar da yawan taurari daga REST API na GitHub a ranar 18 ga Oktoba, 2026 — ku je ku ba waɗannan ayyukan tauraro. Adadin ainihin hoton bayanai ne na wannan ranar kuma zai sauya a zahiri. ### 🧬 Asali & ƙofa
Aiki⭐Yadda ya zaburar da OmniRoute
9router31,004Ainihin aikin da aka gina wannan reshe a kansa — wanda aka faɗaɗa a nan da API masu halaye da yawa tare da cikakken sake rubutawa a TypeScript.
CLIProxyAPI55,591Aiwatarwar Go da ta zaburar da wannan sauyawa zuwa JavaScript / TypeScript.
LiteLLM61,482Ƙofar AI wadda bayanan farashinta na jama'a ke ciyar da daidaitawar bin diddigin kuɗinmu, kuma tsarin daidaita masu samarwarta ya taimaka wajen tsara hanyar isar da buƙatunmu.
codex-chatgpt-web14,526An daidaita tushen MIT zuwa gadar ChatGPT Web → Codex Responses da aka haɗa cikin aikin, ciki har da adaftocin zaman burauza, tsara amsa, amfani da binciken yanar gizo.
free-claude-code61,430An ɗauko tsarukansa zuwa dawo da yawo, laƙaban rashin-tunani, binciken yanar gizo na madadin, iyakokin taga mai motsi, ɓoye bayanai a rajista da ingantattun hanyoyin ƙaddamarwa.
composer-api346An daidaita tsarin zaɓin kayan aiki, ƙuntata fitarwa da tabbatar da kayan aiki na Cursor Composer zuwa mai aiwatar da Cursor na asali.
codex-multi-auth553An ɗauko tsarin sabon shiga da juyawar refresh-token zuwa sake tabbatar da OAuth na Codex.
opencode-anthropic-auth558An faɗaɗa tsoffin saitunan sauyawa masu dacewa da Claude Code da halayen kanun lissafin kuɗi zuwa gadar OmniRoute da saituna ke sarrafawa.
grok2api-merged2An daidaita taswirar samfurin Grok ɗinsa, janareton Statsig na fake-TypeError, tsoffin saitunan buƙata da na'ura, da mai sarrafa amsar NDJSON zuwa mai aiwatar da Grok Web na OmniRoute.
TQZHR/grok2api706Babban tushen lambar da aka gada a bayan grok2api-merged; an adana aiwatarwar samfurinsa, kanunsa, payload, Statsig da masu sarrafawa a cikin asalin Grok Web.
chenyme/grok2api7,819Asalin tushen MIT na payload na Grok da tsoffin saitunan na'ura, janareton Statsig, da mai sarrafa result.response da aka gada ta TQZHR da grok2api-merged.
grok2api-pro27Wani tushen da aka gada wanda grok2api-merged ya ambata saboda shimfiɗar proxy-pool ɗinsa; OmniRoute yana riƙe wannan sanarwar asali amma baya ikirarin ɗauko proxy-pool a cikin iyakantaccen mai aiwatar da Grok Web nasa.
GrokProxy51Proxy na Grok da cookie ke tabbatar da sahihancinsa da tsarin yawo na result.response.token
GrokBridge5Aiwatarwar Grok Web ta asali ta yi amfani da ƙirar HTTP/burauza ta uwar garken sama; hanyarta ta HTTP kai tsaye ta samo asali daga GrokProxy, don haka ba a ikirarin ɗauko lamba mai zaman kanta ba.
### 🗜️ Mahalli & matse token — injuna
Aiki⭐Yadda ya zaburar da OmniRoute
Caveman113,396Shahararren aikin "me ya sa a yi amfani da token da yawa alhali kaɗan za su yi aikin" — falsafar maganar mutumin kogo tasa ce ke ƙarfafa yanayin matsawar mu na yau da kullum da dokokin cire kalmomin cikewa/tattara bayanai sama da 30.
RTK – Rust Token Killer83,835Matsawar fitarwar umarni mai inganci sosai — ta zaburar da injin RTK ɗinmu, JSON filter DSL, dawo da ɗanyen fitarwa da jerin aikin RTK → Caveman.
headroom75,741Matsawar mahalli da za a iya warwarewa (SmartCrusher) — ta zaburar da injin headroom ɗinmu da tsarin alamar dawo da bayanai na ccr.
LLMLingua6,757Binciken matsawar umarni (LLMLingua / LLMLingua-2) — ya zaburar da injin llmlingua ɗinmu mai aiki ba tare da jira ba, mai kiyaye lamba, kuma mai ci gaba da aiki idan ya gaza.
llmlingua-2-js32Juyin JS/ONNX (MobileBERT / XLM-RoBERTa) da ake amfani da shi a matsayin tushen worker-thread na injin LLMLingua ɗinmu.
Troglodita50Matsawar token ta PT-BR — ita ce ke ƙarfafa fakitin harshen pt-BR ɗinmu: rage maimaita ma’ana da cire kalmomin cikewa da aka daidaita don nahawun Fotigal na Brazil.
ponytail166,731Shahararriyar ƙwarewar mai rubuta lambar YAGNI ta "babban mai haɓakawa malalaci" — ta zaburar da Salon Fitarwa na less-code: jagorantar mafi ƙarancin canjin da zai yi aiki wanda ke rage lambar da aka _samar_ (takwaran ɓangaren fitarwa na taƙaitacciyar maganar Caveman).
i-have-adhd57,628An daidaita salon amsarsa mai fara da aiki kuma mai dacewa da masu ADHD zuwa taƙaitaccen salon fitarwa na OmniRoute a cikin harsuna biyar.
### 🧩 Tsare-tsare masu taƙaituwa, binciken token da kayan aiki masu fahimtar lamba
Aiki⭐Yadda ya zaburar da OmniRoute
TOON25,509Tsarin Rubutun Abu Mai Dogaro da Token — tsarin ginshiƙai da take-haɗe-da-layuka nasa ne ya tsara matakin taƙaita jadawalinmu.
GCF – Graph Compact Format59Tsarin jadawalinsa mai taƙaituwa da ƙirar bayanin martaba na gama-gari sun taimaka wajen tsara taƙaita jadawalin OmniRoute da tsarin codec na Headroom.
gcf-typescript4Aiwatarwar MIT TypeScript da aka shigar kai tsaye tare da faɗaɗa ta a matsayin codec na bayanin martaba na gama-gari na Headroom.
token-optimizer-mcp551Ma’ajiyar wucin gadi ta Brotli/SQLite + bambancin mahalli na kowane zama — ya zaburar da injin session-dedup ɗinmu.
token-savior1,182Taƙaita fitarwar Bash + bayanan martaba na MCP — ya zaburar da ƙa’idar janyewa daga matsawa da rage bayanan kayan aikin MCP ɗinmu.
token-saver154Matsawar fitarwa mai fahimtar abun ciki bisa kowane nau’in fayil tare da janyewa idan aka samu gazawa — ya tabbatar da rarrabawar mu bisa kowane nau’i da tsallake matsawa idan ribar ta yi ƙasa da mafi ƙaranci.
token-optimizer2,595"Nemo token na fatalwa" — tsarin tura bayanai waje + makama da za a iya amfani da shi wajen dawo da su ya taimaka wajen tsara tunaninmu game da tura bayanai waje ta CCR.
TokenMizer33Tsarin jadawalin zama + cire maimaitattun layuka tsakanin juyayyun tattaunawa wanda ya taimaka wajen tsara session-dedup ɗinmu.
OmniCompress3JSON na ginshiƙan Rust + dawo da bayanai bisa adireshin abun ciki + cire maimaituwa tsakanin saƙonni — ya tabbatar da ƙirar injinan headroom/ccr/session-dedup ɗinmu da ƙa’idar ma’ajiyar wucin gadi mai ɗorewa cewa "siffar da aka matsa ba ta dogara da matsayi".
mcp-compressor133Matsawar tsarin kayan aikin/bayani na MCP — ta taimaka wajen tsara rage yawan bayanan kayan aikin MCP ɗinmu.
RepoMapper217Jera taswirar ma’ajiyar lamba irin ta Aider bisa muhimmanci — ya taimaka wajen bincikenmu kan taswirar ma’ajiya / jera dawo da bayanai bisa muhimmanci.
quiet-shell-mcp4Rage fitarwar shell ta hanyar sanar da ƙa’idoji a kan MCP — ya tabbatar da taƙaita fitarwar bash ɗinmu ta hanyar sanar da ƙa’idoji.
ts-morph6,205Kayan aikin TypeScript Compiler API — ya zaburar da cire sharhi bisa parser ɗinmu wanda ke kiyaye string, template da regex literals.
### 🧠 Ƙwaƙwalwa & RAG
Aiki⭐Yadda ya zaburar da OmniRoute
Mem067,385Matakin ƙwaƙwalwa na bai-ɗaya — tsarinsa na proxy a matsayin iyakar rubutawa/karantawa ne ya tsara tsarin gine-ginen ƙwaƙwalwarmu.
Letta (MemGPT)25,179Wakilai masu riƙe da yanayi tare da ƙwaƙwalwa mai matakai — sun zaburar da tsarinmu mai matakai na Sarrafa Mahallin Bayani da Farfaɗowa (CCR).
WFGY1,800Rabe-raben ProblemMap na hanyoyin gazawar RAG/LLM guda 16 masu maimaituwa — ƙamus ɗin gama-gari a jagoranmu na warware matsaloli.
### 🛰️ Binciken zirga-zirga, MITM da proxy mai gaskiya
Aiki⭐Yadda ya zaburar da OmniRoute
llm-interceptor79Tsarewa/binciken MITM na zirga-zirgar mataimakin shirye-shirye ↔ LLM ya taimaka wajen tsara buƙatun farko na Traffic Inspector. An maye gurbin kayayyaki huɗu da aka samo a baya — haɗa SSE, daidaita tattaunawa, ɓoye sirri da tsabtace headers — da aiwatarwa masu zaman kansu da aka gina daga tushe bisa ƙa'idodin yarjejeniya na jama'a. Fuskokin host-passthrough guda biyu (passthrough.ts da _internal/bypass.cjs) sun ci gaba da kasancewa aiwatarwa na cikin OmniRoute waɗanda aka rarraba su daban; ba a sake rubuta su a matsayin wani ɓangare na wannan sauyawar ba.
ProxyBridge6,814Jagorantar proxy ga kowane process a bayyane — ya zaburar da kashe MITM cikin aminci idan aka samu rushewa, wa'adin rashin aiki na socket, danganta process ta /proc da kama zirga-zirga ta TPROXY.
### 📚 Bayanan samfuri, sa ido da UI
Aiki⭐Yadda ya zaburar da OmniRoute
models.dev7,286Buɗaɗɗen rumbun bayanai na ƙayyadaddun samfuran AI, farashi da ƙwarewa — ana daidaita shi kai tsaye cikin kundin samfuranmu.
React Flow / xyflow38,705Laburaren jadawali mai tushen nodes wanda ke tafiyar da Compression Studio da Combo/Routing Studio namu a ainihin lokaci.
LangGraph43,443Nuna jadawalin tafiyar aiki kai tsaye na LangGraph Studio ya zaburar da kallon cascade na ainihin lokaci a Studios namu.
Langfuse35,990Tsarin sa ido nasa na trace → span → generation ne ya tsara waterfall na Compression Studio namu.
Kiali3,645Sa ido kan service-mesh na Istio — ya zaburar da alamomin circuit-breaker da hotunan gefunan kurakurai a Routing/Combo Studio.
lobe-icons2,615Tambarin samfuran AI/LLM waɗanda ke nuna gumakan masu samarwa a faifan sarrafawarmu.
flag-icons12,473Yana samar da tutocin SVG masu lasisin MIT da mai zaɓen harshe na README ke amfani da su.
### 🛡️ Tsaro
Aiki⭐Yadda ya zaburar da OmniRoute
awesome-secure-defaults722Jerin zaɓaɓɓun laburare masu tsaro ta asali wanda ke jagorantar zaɓuɓɓukan tsaronmu (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
### 🧭 Kayan aiki masu taimakon juna
Aiki⭐Yadda ya zaburar da OmniRoute
ClawRouter6,628Ya zaburar da kawar da maimaitattun buƙatu, madadin gaggawa mara kuɗi, dabarun Auto-Combo masu iya haɗawa da rarraba niyya ta harsuna da dama.
Antigravity-Manager32,333Sake danganta samfuri bisa asusu, tabbatar da executable-path da halayen plan-label nasa sun taimaka wajen tsara runtime na Antigravity na OmniRoute.
vscode-antigravity-cockpit4,850Tsarin ƙirga-lokaci zuwa sake saitin ƙayyadadden amfani mai taƙaitaccen salo ya zaburar da nunin iyakar mai samarwa da ya dace a OmniRoute.
AionUi33,611Haɗe-haɗen ACP nasa sun zaburar da gano wakilan CLI da aka shigar ta atomatik a OmniRoute.
CodexBar22,616Ya gano fuskar ƙayyadadden amfani ta Grok Build; daga nan OmniRoute ya tabbatar tare da gyara tsarin bayanan da ake watsawa kai tsaye da kansa.
## 📄 Lasisi Lasisin MIT - duba [LICENSE](LICENSE) don ƙarin bayani. ---
**[⬆ Koma sama](#-omniroute)** · An gina shi da ❤️ don al'ummar AI ta buɗaɗɗen tushe. OmniRoute v3.8.53 · Node ≥22.22.2 · Lasisin MIT · omniroute.online