# README (Lietuvių) 🌐 **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) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---
OmniRoute skydelis

# 🚀 OmniRoute — Nemokami AI vartai **Sukūrė [Diego Souza](https://github.com/diegosouzapw)** OmniRoute — Niekada nenustokite programuoti. Kiekvienas AI įrankis → 388 teikėjas — daugiau nei 150 nemokamų — per vieną galinį tašką. Claude Code, Codex, Cursor, Cline, Copilot ir Antigravity į NEMOKAMUS Claude / GPT / Gemini su automatiniu atsarginiu perjungimu. RTK + Caveman pakopinis glaudinimas sutaupo 15–95 % žetonų (~89 % vidutiniškai) — niekada nepasiekite limitų. 388 AI teikėjas · daugiau nei 150 nemokamų planų · ~1,62 mlrd. nemokamų žetonų per mėnesį · 20 maršrutizavimo strategijų · pradėkite už 0 USD.
## 💰 ~1,62 mlrd. žetonų / mėn. trečiųjų šalių nemokamuose planuose
> **Naudokite savo tiekėjų paskyras.** Tai yra apskaičiuota bendra suma iš atskirai tinkamų naudoti trečiųjų šalių nemokamų planų, o ne OmniRoute suteikiamas žetonų kreditas. Užsiregistruokite, prireikus gaukite prisijungimo duomenis ir prijunkite galimus naudoti tiekėjus; kiekvienas tiekėjas kontroliuoja savo limitus, prieinamumą ir sąlygas. > > Nemokamų planų sudėjimas rankiniu būdu yra varginantis — dešimtys SDK, dešimtys užklausų dažnio limitų ir jokio aiškumo, kiek iš tikrųjų turite. OmniRoute kataloguoja **465 nemokamo plano įrašus pagal 34 pasikartojančius telkinio raktus** ir apskaičiuoja žetonų antraštėje rodomą skaičių pagal **17 telkinių, kuriems paskelbtas teigiamas mėnesio biudžetas, bei penkis kiekvienam modeliui taikomus Groq limitus**, juos deduplikuodama pagal bendrą telkinį. Kvotos, kurios atidaromos tik patikrinus regioninę tapatybę (šiuo metu: ModelScope), rodomos atskirai — +~6 mln. po regioninės tapatybės patvirtinimo — ir niekada neįtraukiamos į antraštėje rodomą sumą. Rezultatas lieka matomas skydelyje (`/dashboard/free-tiers`). OmniRoute nemokamo plano biudžeto kortelė: ~1,62 mlrd. nemokamų žetonų per mėnesį įprastai, iki ~2,22 mlrd. pirmąjį mėnesį su registracijos kreditais, iš 34 dokumentuotų pasikartojančių telkinio raktų, apimančių 465 kataloge esančius nemokamo plano įrašus per vieną galinį tašką. Sąžiningas, pagal telkinius deduplikuotas skaičiavimas — kiekvienas bendras telkinys skaičiuojamas vieną kartą, įskaitant 17 pasikartojančių telkinių su paskelbtu teigiamu mėnesio žetonų biudžetu ir penkis kiekvienam modeliui taikomus Groq limitus; 12 tiekėjų pažymėti kaip vengti sąlygų rizikos kataloge, todėl sprendžiate jūs. Biudžeto juostoje įtraukti Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (penki kiekvienam modeliui taikomi limitai) ir mažesni telkiniai, taip pat pirmojo mėnesio registracijos kreditai bei atskirai pateikiami visam laikui nemokami tiekėjai be žetonų limito, kad jie niekada neišpūstų antraštėje rodomo skaičiaus. Tiesiogiai naudojama ir likusi suma puslapyje /dashboard/free-tiers. > Animacinė tiesioginio `/dashboard/free-tiers` puslapio santrauka. Visa metodika (telkinių deduplikavimas, kreditų pakopos, tiekėjų sąlygos): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > Šie skaičiai kas dvi savaites iš naujo tikrinami pagal tiesioginį katalogą ir **gali tiek didėti, tiek mažėti** — tiekėjui nutraukus nemokamą planą, skaičius sumažėja; atsiradus naujam, jis padidėja. Skelbiame tai, ką katalogas iš tikrųjų apskaičiuoja, o ne suapvalintą geriausią scenarijų.

⭐ Pažymėkite saugyklą žvaigždute, jei OMNIROUTE padėjo sutaupyti pinigų ir palengvino jūsų darbą.

[![Žvaigždutės](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute) diegosouzapw%2FOmniRoute | Trendshift [![Žvaigždžių istorijos reitingas](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) ### 💬 Prisijunkite prie bendruomenės **👋 Sekite prižiūrėtoją — pirmieji sužinokite apie naujus tiekėjus, leidimus ir patarimus:** [![Sekite Diego sistemoje 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/) [![Sekite @diegosouzapw sistemoje 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 Brazilija](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) [![Svetainė](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Klausimai, patarimai apie tiekėjus, veiksmų planas ir pagalba → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazilija](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portalas](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Šliuzas toliau auga
| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | --------------------------------- | :---------------------------------: | :---------: | :-------------------: | | 🌐 Teikėjai | 352 | **358** | 388 | | 🧠 Unikalūs pokalbių modelių ID | 1320 | **1374** | 1491 | | 🖼️ Modalumo tiltas | 🆕 vaizdas + garsas + vaizdo įrašas | ✓ | ✓ | | 📡 Nemokamas „Radar“ katalogas | 🆕 pasirenkamas | ✓ | ✓ | | ⚖️ Kvotoms pritaikytas planavimas | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kvotų telemetrija | 🆕 realiuoju laiku | ✓ | ✓ | | 🧰 Režimas be grafinės sąsajos | — | — | 🆕 `serve --headless` | | 🛤️ LTS infrastruktūra | — | — | 🆕 leidimo kanalai | | 🔎 Modelių aptikimo API | — | — | 🆕 `/v1/models/query` | **→ [Veiksmų planas](ROADMAP.md) — keliaujame link `v3.9.0 LTS`**

## 🧩 Prieinama [![npm versija](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM per mėnesį](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) ![Licencija: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker atsisiuntimai](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron atsisiuntimai](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)
🚀 Pradžia 🚀 Greita pradžia 📦 Diegimas 🆓 Prijungti teikėją
💡 Sužinokite 💥 Pažadas 🤔 Kodėl OmniRoute 🏆 Kuo išsiskiria
⚙️ Funkcijos 🎯 Deriniai 🌐 Teikėjai 🔌 CLI ir MCP
🗜️ Suspaudimas 🖥️ Kur veikia 🔒 Privatu
👀 Pažiūrėkite 🎬 Veikimas ✨ Kas naujo 🤖 Suderinami CLI
💚 Palaikymas 💚 Palaikyti / Paaukoti 💬 Bendruomenė 💖 Rėmėjai
📦 Projektas 🛠️ Technologijų rinkinys 📖 Dokumentacija 👥 Prisidėjusieji
🌐 67 kalbomis

Anglų (en) Portugalų — Brazilija (pt-BR) Portugalų (pt) Ispanų (es) Prancūzų (fr) Italų (it) Vokiečių (de) Olandų (nl) Rusų (ru) Ukrainiečių (uk-UA) Lenkų (pl) Čekų (cs) Slovakų (sk) Rumunų (ro) Vengrų (hu) Bulgarų (bg) Danų (da) Suomių (fi) Norvegų (no) Švedų (sv) Kinų — supaprastinta (zh-CN) Kinų — tradicinė (zh-TW) Japonų (ja) Korėjiečių (ko) Tajų (th) Vietnamiečių (vi) Indoneziečių (id) Malajų (ms) Filipiniečių (phi) Hindi (hi) Gudžaratų (gu) Maratų (mr) Tamilų (ta) Telugų (te) Bengalų (bn) Urdu (ur) Persų (fa) Arabų (ar) Hebrajų (he) Turkų (tr) Azerbaidžaniečių (az) Svahilių (sw) Graikų (el) Kroatų (hr) Serbų (sr) Lietuvių (lt) Estų (et) Latvių (lv) Slovėnų (sl) Maltiečių (mt) Airių (ga) Kanadų (kn) Malajalių (ml) Odijų (or) Pandžabų (pa) Nepaliečių (ne) Sinhalų (si) Birmiečių (my) Khmerų (km) Hausų (ha) Jorubų (yo) Igbo (ig) Amharų (am) Uzbekų (uz) Gruzinų (ka) Armėnų (hy) Bosnių (bs)


## 🆓 Įdiekite, prijunkite teikėją ir nukreipkite per vieną galinį punktą
Trys žingsniai: įdiekite ir paleiskite OmniRoute, prijunkite tinkamą teikėją naudodami savo paskyrą arba API raktą, tada nukreipkite savo įrankį į localhost:20128/v1 naudodami OmniRoute API raktą ir modelį auto. Maršruto parinkimas priklauso nuo pasiekiamų tinkamų jungčių ir teikėjo limitų. ```bash # Prijungę teikėją, nukopijuokite OmniRoute raktą iš 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` reikia tinkamo maršruto. Naujai įdiegtoje sistemoje gali nebūti tinkamų tik raktu pagrįstų taikinių, o teikėjas, nereikalaujantis rakto, gali atmesti trečiųjų šalių klientus. Teikėjai, pažymėti `tos: avoid`, įskaitant Kiro, pagal numatytuosius nustatymus neįtraukiami į automatinį maršrutų parinkimą; paskyros prijungimas šio nustatymo nepakeičia. Prieš pasirinkdami teikėją, peržiūrėkite [Nemokamų planų vadovą](docs/getting-started/FREE-TIERS-GUIDE.md). 📦 Greitosios pradžios scenarijai, kuriuos galima nukopijuoti ir įklijuoti, skirti **Python, Node.js, PHP ir cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Pažadas
Pažadas — vienas galinis punktas ir 388 teikėjas. Automatinis atsarginis perjungimas užtikrina maršrutų parinkimą, kol pasiekiamas kitas veikiantis taikinys. Šeši pagrindiniai privalumai: atsparus atsarginis perjungimas tarp 388 teikėjo · iki 95 % žetonų sutaupymas tinkamiems darbo krūviams · pradėti galima už 0 USD, turint daugiau nei 150 nemokamų planų ir 52 pasikartojančius arba rakto nereikalaujančius nemokamus planus visam laikui · 39 CLI / agentų integracijos naudojant vieną konfigūraciją · OpenAI, Claude, Gemini ir Responses API suderinamumas adresu /v1 · gamybinės aplinkos valdikliai, įskaitant grandinės pertraukiklius, TLS slėpimą, MCP su 110 įrankių, A2A, atmintį, apsaugos priemones, vertinimus ir daugiau nei 56 000 statinių testų deklaracijų daugiau nei 7 800 sekamų testų failų.

# 🤔 Kodėl OmniRoute?
Kodėl OmniRoute — nebespręskite 10 valdymo skydų, neveikiančių API raktų ir netikėtų sąskaitų problemų. Dešimt kasdienių problemų ir sprendimų: nepanaudota pasibaigianti kvota → maksimaliai išnaudokite prenumeratas; greičio ribojimai programuojant → automatinis atsarginis perjungimas per 4 lygius (prenumerata → API → nebrangus → nemokamas); įrankių išvestys eikvoja žetonus → RTK + Caveman glaudinimas (15–95 %); brangios API → į kainą orientuotas maršrutų parinkimas; kiekvienam įrankiui reikia atskiros sąrankos → vienas galinis punktas, vienas valdymo skydas; dirbtinis intelektas blokuojamas → 3 lygių tarpinis serveris + TLS slėpimas; neveikiantys raktai → 3 lygių atsparumas (grandinės pertraukikliai, rakto atvėsimo laikotarpis, modelio blokavimas); komanda dalijasi viena prenumerata → raktų telkiniai su sąžiningai dalijama kvota; raginimai siunčiami per kito asmens debesį → pirmenybė vietiniam veikimui naudojant AES-256-GCM užšifruotus raktus; nematoma išlaidų apžvalga → tiesioginė analitika (naudojimas, kvota, sutaupymai, p95 delsa).
OmniRoute užklausos eiga: jūsų IDE arba CLI (Claude Code, Cursor, Cline…) iškviečia vieną vietinį galinį punktą (http://localhost:20128/v1); OmniRoute išmanusis maršrutizatorius (RTK + Caveman glaudinimas, 20 maršrutų parinkimo strategijų, grandinės pertraukikliai, TLS slėpimas, MCP, A2A, apsaugos priemonės) gali persijungti tarp 4 teikėjų lygių, kol išlieka tinkamas veikiantis taikinys — 1 lygis: prenumerata, 2 lygis: API raktas, 3 lygis: nebrangus ir 4 lygis: nemokamas.

## 🤝 Mus remia mūsų atvirojo kodo draugai

Kimi K3 — pažangiausias atvirasis intelektas · 2,8 trln. parametrų · 1 mln. žetonų kontekstas

> **Norite prisijungti kaip atvirojo kodo draugas?** Šios įmonės remia atvirąjį kodą ir padeda „OmniRoute“ judėti pirmyn, o mes viešai nurodome, kur panaudojamas kiekvienas jų suteiktas žetonas. Susisiekite: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi (Moonshot AI)
Kimi
Moonshot AI

Steigiamasis atvirojo kodo draugas
Dėkojame Kimi (Moonshot AI), mūsų steigiamajam atvirojo kodo draugui, už šio projekto rėmimą! „Kimi“ yra DI laboratorija, sukūrusi atvirų svorių K2 ir K3 modelių šeimas. Kimi K3 siūlo 1 mln. žetonų konteksto langą, įtaisytąjį vaizdų apdorojimą ir pažangiausio lygio programavimą už gerokai mažesnę kainą nei uždarieji modeliai, be to, iškart veikia su „Claude Code“, „Codex“ ir visais programavimo įrankiais, kuriuos aptarnauja „OmniRoute“.

Ką užtikrina „Kimi“ parama: „Kimi“ API kreditai užtikrina „OmniRoute“ DI patvirtinamą leidimų procesą — suliejimo patvirtinimo, kurį vykdo Kimi K3, etapą, peržiūrintį kiekvieną įtraukimo užklausą prieš jos išleidimą, — taip pat kasdienį funkcijų kūrimą. Visavertis „Kimi“ palaikymas teikiamas abiem būdais: per tiesioginę Kimi API (kimi-k3) ir Kimi Code programavimo planą (OAuth ir API raktas). „OmniRoute“ taip pat yra pirmasis Brazilijos atvirojo kodo projektas „Kimi“ paramos programoje. Gaukite „Kimi“ API raktą su 15 % papildomų kreditų →
Cheaper Inference
Cheaper Inference
cheaperinference.com

Atvirojo kodo draugas
Dėkojame Cheaper Inference, „OmniRoute“ atvirojo kodo draugui, už šio projekto rėmimą! „Cheaper Inference“ yra pagal kainą parenkantis šliuzas, perparduodantis 42 pažangiausius modelius — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ir MiniMax — per vieną su OpenAI suderinamą galinį tašką. Kiekviena užklausa nukreipiama pigiausiam tinkamam teikėjui, o mokestis niekada neviršija modelio kūrėjo nustatytos kainos.

Visavertis palaikymas „OmniRoute“: Chat Completions, savasis /v1/responses galinis taškas, vaizdų apdorojimas, įrankių iškvietimas ir 3 vaizdų modeliai (grok-imagine, nano-banana-pro, nano-banana-2, pasiekiami kaip cheaperinference/<model>). Gaukite API raktą →
Nuorodos, pažymėtos aff=omniroute, yra partnerių nuorodos. Jos padeda finansuoti projektą jums nieko papildomai nekainuojant.
🎟️ Partnerių akcijos — nemokami registracijos kuponai iš teikėjų, kurių neremiame (spustelėkite, kad išskleistumėte) Šis skyrius skirtas tik rekomendacijų ir kuponų kodams. Remiamos partnerystės pateiktos pirmiau, skiltyje 🤝 Mus remia mūsų atvirojo kodo draugai. „OmniRoute“ nesieja rėmimo ar partnerystės santykiai su čia nurodytais teikėjais — tai vieši kuponai, kuriais gali pasinaudoti visi.
AgentRouter
AgentRouter
agentrouter.org
AgentRouter — partnerių registracija · užsiregistravę gaukite $100 nemokamų kreditų (nemokamas serveris, todėl tikėtina didesnė delsa — geriausiai tinka testavimui, o ne gamybinei aplinkai). Visavertis palaikymas „OmniRoute“ nuo v3.8.50: Chat Completions, su Anthropic suderinamas duomenų perdavimo formatas ir su OpenAI suderinamas kelias. Galimi modeliai: claude-opus-4-8, claude-opus-5, gpt-5.6-sol ir kiti. Pasiimkite savo $100 →

⚠️ Partnerio nuoroda — „OmniRoute“ nesieja rėmimo ar partnerystės santykiai su šiuo teikėju.
Žinote kitą teikėją, siūlantį dosnų nemokamą registracijos kuponą, naudingą „OmniRoute“ naudotojams? Sukurkite problemos įrašą ir mes jį čia pridėsime.

## 🎯 Kombinacijos — pagrindinė funkcija
Animuoti 18 iš 20 kombinacijų maršruto parinkimo strategijų pavyzdžiai — po vieną plytelę kiekvienai strategijai: 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 ir quota-weighted nėra animuotos; toliau pateiktoje lentelėje aprašytos visos 20 strategijų. > **Kombinacija** – tai modelių grandinė, tarp kurių „OmniRoute“ užklausas nukreipia **automatiškai**. Jei išnaudojama kvota, sutrinka teikėjo veikimas arba smarkiai išauga išlaidos, kombinacija gali pereiti prie kito tinkamo ir tinkamai veikiančio modelio. 🛡️ ### ⚡ Nereikia jokios konfigūracijos – tiesiog naudokite `auto` Nereikia kurti jokios kombinacijos. Nustatykite modelį į `auto` (arba jo variantą), o „OmniRoute“ pagal jūsų prijungtus teikėjus sukurs virtualią kombinaciją, kuri bus vertinama realiuoju laiku:
Modelio IDKam jis optimizuotas
auto🎯 Subalansuotas numatytasis variantas (LKGP – lieka prie paskutinio sėkmingai veikusio teikėjo)
auto/coding🧑💻 Kodo generavimui skirti svoriai, pirmenybę teikiant kokybei
auto/fast⚡ Pirmiausia – mažiausia delsa
auto/cheap💰 Pirmiausia – mažiausia vieno žetono kaina
auto/subscription🎟️ Tik prenumeratos kvota, už kurią jau mokate – nepavykus užklausa nutraukiama, niekada nepereinama prie apmokestinamo atsarginio varianto (vadovas)
auto/thrifty🪜 Pirmiausia plano kvota, tada po vieną pakopą pereinama prie pigiausių mokamų variantų, o kvotai atsistačius grįžtama prie plano (vadovas)
auto/offline🔋 Pirmiausia – didžiausias kvotos / dažnio ribos rezervas
auto/smart🔭 Pirmenybė kokybei + 10 % tyrinėjimo, siekiant atrasti geresnius modelius
auto/lkgp📌 Aiškiai nurodytas prisirišimas prie paskutinio sėkmingai veikusio teikėjo
auto/chaos🧪 Lygiagretus užklausų siuntimas modelių grupei (po vieną kiekvienam teikėjui, pagal numatytąją nuostatą – 5), grąžinant vieną atsakymą; kiekvienam grupės modeliui tenka po vieną išorinę užklausą, tai nėra gedimų imitavimas
## ### 🔀 Arba sukurkite savo – 20 maršruto parinkimo strategijų Visos **20** strategijų – derinkite jas kiekviename kombinacijos žingsnyje:
# Strategija Kaip ji veikia
1 priority Sąrašas, kuriame pirmenybė teikiama pirmajam tikslui – kiekvienas išnaudojamas prieš pereinant prie kito 🥇
2 fill-first Prieš pereinant prie kito tikslo visiškai išnaudojama kiekvieno tikslo kvota
3 weighted Atsitiktinis pasirinkimas pagal kiekvieno tikslo svorį
4 round-robin Tikslai cikliškai pasirenkami nustatyta tvarka
5 p2c Atsitiktinis apkrovos balansavimas pagal dviejų pasirinkimų principą
6 least-used Pasirenkamas tikslas, kurio dabartinė apkrova mažiausia
7 random Tolygus atsitiktinis pasirinkimas (be pasikartojimų)
8 strict-random Atsitiktinis pasirinkimas nešalinant pasikartojimų 🎲
9 cost-optimized Vienos užklausos kaina mažinama pagal realiuoju laiku gaunamas katalogo kainas 💸
10 headroom Pasirenkamas tikslas, turintis didžiausią likusią kvotą
11 quota-weighted Praleidžiamos paskyros su išnaudota kvota, tada pasirenkama proporcingai likusiai kvotai ÷ vykdomai apkrovai – esami pokalbiai lieka priskirti tam pačiam tikslui ⚖️
12 reset-window Pirmenybė teikiama tikslui, kurio kvotos laikotarpis bus atkurtas greičiausiai
13 reset-aware Rikiuojama pagal kvotos atkūrimo laiką – pirmiausia trumpi laikotarpiai 📊
14 context-relay Ilguose pokalbiuose kontekstas perduodamas tarp tikslų 🧠
15 context-optimized Pasirenkamas dabartiniam konteksto dydžiui tinkamiausias tikslas
16 cache-optimized Kiekvienas pakartotinai naudojamas raginimo priešdėlis priskiriamas tai pačiai paskyrai – taip maksimaliai padidinamas raginimų podėlio pataikymų skaičius 🎯
17 lkgp Paskutinis sėkmingai veikęs kelias – naudojamas paskutinis sėkmingai veikęs teikėjas, o jam neveikiant pereinama prie taisyklių
18 auto Visų jungčių vertinimas realiuoju laiku pagal 16 veiksnių 🤖
19 fusion Užklausos siunčiamos modelių grupei, o vertintojas susintetina vieną atsakymą 🧬
20 pipeline Žingsniai sujungiami į grandinę – kiekvieno tikslo išvestis perduodama kitam 🔗
„Auto-Combo“ variklis kiekvieną kandidatą vertina pagal **16 veiksnių** (būklę, kvotą, kainą, delsą, tinkamumą užduočiai, kokybę, sesijos pasiekiamumą…) — žr. [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md). ## ### 🧱 Atsparumas integruotas sistemoje (3 nepriklausomi lygmenys) „OmniRoute“ atsparumas — 3 nepriklausomi savaiminio atkūrimo lygmenys, tinkamas lygmuo tinkamam gedimui. 1 lygmuo — paslaugų teikėjo grandinės pertraukiklis (visas paslaugų teikėjas): suveikia tik gavus 408/5xx, ribos — OAuth 8× / API raktui 12× / vietiniam teikėjui 2×, po 60 s / 30 s / 15 s pereina į HALF-OPEN bandomąją būseną, taikomas atidėtasis atkūrimas; kol būsena yra OPEN, derinys peradresuojamas kitam paslaugų teikėjui. 2 lygmuo — ryšio atvėsimo laikotarpis (vienam raktui / paskyrai): bazinė trukmė — 5 s OAuth / 3 s API raktui, eksponentinis ×2 laukimo trukmės didinimas su apsauga nuo vienalaikių užklausų antplūdžio, gavus 429 paisoma Retry-After, sėkmingas atsakas išvalo visą klaidos būseną; vienas atvėstantis raktas praleidžiamas, o kiti raktai toliau aptarnauja užklausas. 3 lygmuo — modelio blokavimas (vienas modelis): konkretaus modelio 429, vietinis 404 arba veiksenos draudimai užblokuoja tik tą modelį — niekada ne visą ryšį. Galutinės būsenos (uždrausta prieiga, pasibaigęs galiojimas, išnaudoti kreditai) skirtos operatoriui, o ne atvėsimo laikotarpiams. 📖 [„Auto-Combo“ variklis](docs/routing/AUTO-COMBO.md) · [Atsparumo vadovas](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Kuo išsiskiria „OmniRoute“
Kuo išsiskiria „OmniRoute“ — atnaujinta funkcijų momentinė apžvalga, kurioje pagal 13 galimybių lyginami 9router, OpenRouter, CLIProxyAPI ir LiteLLM. „OmniRoute“: 388 tiekėjas, daugiau nei 150 integruotų nemokamų planų, 20 maršrutizavimo strategijų, žetonų glaudinimas naudojant 12 variklių, integruotas MCP serveris su 110 įrankių, A2A agentų protokolas, nuolatinė atmintis, apsaugos taisyklės, debesijos agentai, TLS pirštų atspaudų slėpimas, Desktop/Termux/PWA ir 67 i18n naudotojo sąsajos lokalės. „OmniRoute“ licencijuota pagal MIT licenciją ir gali būti talpinama savarankiškai. Konkurentų galimybės ir skaičiai gali keistis; žr. susietą metodiką. 📊 Visa metodika ir išsami kiekvienos funkcijos informacija, palyginti su 9router, OpenRouter, CLIProxyAPI ir LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Paremkite „OmniRoute“ „OmniRoute“ platinamas pagal MIT licenciją ir prižiūrimas atvirai. Jei jis padeda sutaupyti laiko ar pinigų, štai kaip galite padėti jam išlikti nepriklausomam — pasirinkite jums tinkamiausią būdą. Rėmimas niekada neturi įtakos maršruto parinkimo prioritetui; jis suteikia matomumą, o ne aukštesnę vietą reitinge.
⭐ Pažymėkite saugyklą žvaigžduteNemokama — tai iš tiesų padeda didinti matomumąPažymėti „OmniRoute“ žvaigždute
🐙 „GitHub Sponsors“Vienkartinė arba mėnesinė parama · jokio platformos mokesčiogithub.com/sponsors/diegosouzapw
☕ „Ko-fi“Greita vienkartinė parama, rėmėjui nereikia registruotisko-fi.com/diegosouzapw
🧋 „Buy Me a Coffee“Nedidelis, neformalus paramos gestasbuymeacoffee.com/diegosouzapw
🖐 „Liberapay“Periodinė parama · ne pelno siekianti platforma · atvirasis kodasliberapay.com/diegosouzapw
🇧🇷 PIX (Brazilija)Akimirksniu, be mokesčiųraktas ir QR kodas pateikti toliau
₿ KriptovaliutosBTC · ETH · USDT-TRC20 · USDC-Solanaadresai pateikti toliau
**🇧🇷 PIX** — akimirksniu, be mokesčių (Brazilija) „OmniRoute“ PIX QR kodas Raktas (atsitiktinis): `5d865059-bc44-483a-962d-43ceb80126eb` PIX kopijavimo ir įklijavimo kodas: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```
₿ Kriptovaliutos — BTC · ETH · USDT-TRC20 · USDC-Solana (spustelėkite, kad išskleistumėte)
₿ BTCBitcoin (SegWit)bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETHEthereum (ERC20)0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDTTron (TRC20)TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDCSolana2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Kiekvieną kriptovaliutą siųskite tik nurodytu tinklu — siunčiant netinkamu tinklu galima prarasti lėšas.
🐛 Radote klaidą ar turite atsiliepimų? Pradėkite [diskusiją](https://github.com/diegosouzapw/OmniRoute/discussions).

Pastabos kūrėjams: Kūrėjų patogumui vykdant npm diegimą arba postinstall projektas gali sugeneruoti vietinį .env failą. Šis failas sąmoningai ignoruojamas naudojant .gitignore (žr. .gitignore) ir niekada neturi būti įtrauktas į saugyklą — jei jis buvo įtrauktas netyčia, pakeiskite visus atskleistus slaptuosius duomenis ir pašalinkite failą iš istorijos. Vietinių aplinkos failų ir slaptųjų duomenų tvarkymo rekomendacijas rasite docs/DEVELOPER-ENVIRONMENT.md.

## 📡 „OmniRoute Radar“ Pagrindinis nemokamo lygio rodiklis išlieka **~1.62B žetonų per mėnesį** pagal pirmiau pateiktą dokumentuotą, dubliuojamus telkinių įrašus pašalinantį katalogą. Laikini teikėjų registracijos kreditai gali papildomai padidinti pirmojo mėnesio kiekį iki **~2.22B**. „Radar“ yra pasirenkama, pasirašyta katalogo perdanga, skirta norintiems naujesnės informacijos apie nemokamų modelių prieinamumą tarp „OmniRoute“ leidimų; bendruomenės katalogas ir visos esamos nemokamos funkcijos lieka nemokamos. Rėmėjai gali gauti tiesioginį katalogą ir papildomas teikėjų galimybes. Jo atskira, kintama viršutinė riba yra **daugiausia maždaug 3B žetonų per mėnesį**, priklausomai nuo teikėjų prieinamumo. Ši viršutinė riba nėra garantija: teikėjai bet kada gali keisti kvotas, tinkamumo reikalavimus, modelius ar regionus. „Radar“ yra pasirenkama ir naudoja tik GET užklausas. „OmniRoute“ klientas neįkelia užklausų tekstų, srauto, teikėjų konfigūracijos, naudojimo telemetrijos ar vietinės pranešimų atmetimo būsenos. Informaciją apie tinkamumo reikalavimus ir dabartinį katalogą rasite **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Kas naujo
> Naujausi akcentai nuo **v3.8.20 → v3.8.54**. Visa istorija pateikiama faile [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ `quota-weighted` maršrutizavimas** — 20-oji kombinuotoji strategija praleidžia išnaudotas paskyras, tada iš likusių renkasi proporcingai likusiai kvotai ÷ vykdomų užklausų apkrovai, išlaikydama esamų pokalbių susiejimą. → [Automatiniai deriniai](docs/routing/AUTO-COMBO.md) - **🧰 Režimas be grafinės sąsajos** — `omniroute serve --headless` (arba `OMNIROUTE_HEADLESS=1`) paleidžia tik `/v1/*` tarpinio serverio modulį, išjungdamas valdymo skydą ir tik jam skirtus posistemius. → [Režimas be grafinės sąsajos](docs/guides/HEADLESS.md) - **🔎 Modelių aptikimas** — `/v1/models` filtruoja pagal galimybes, kontekstą, rūšį ir tekstą, o `POST /v1/models/query` grąžina trumpą deterministinį sąrašą su tokiu pačiu matomumu pagal raktą. → [API nuoroda](docs/reference/API_REFERENCE.md) - **🔑 Maršrutizavimo valdymas pagal raktą** — susiekite API raktą su vienu modeliu arba deriniu naudodami `forcedModel`, taip pat atominiu būdu pridėkite arba pašalinkite rakto modelius ir derinius (`/api/keys/{id}/access`). → [API nuoroda](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Tikslesni PII valdikliai** — pasirinkimas pagal tipą, iki 20 patvirtintų pasirinktinių maskavimo šablonų ir aptikimo skaitikliai pagal tipą; pats maskavimas išlieka pasirenkamas. → [Apsaugos priemonės](docs/security/GUARDRAILS.md) - **🌍 67 kalbos** — valdymo skydas, dokumentacijos veidrodžiai ir CLI, o `npm run i18n:add-locale` viena komanda prideda kalbą visur. → [i18n vadovas](docs/guides/I18N.md) - **🎛️ OmniConductor** — įeinantis A2A delegavimas jūsų agentų flotilei, Conductor gebėjimai Agent Card kortelėje ir valdymo skydo skydelis su Faro tiesioginio pokalbio balsu funkcija. → [A2A serveris](docs/frameworks/A2A-SERVER.md) - **🛂 Adaptyvus priėmimas ir perkrovos apsauga** — didelės apimties pokalbių užklausos patenka į eilę, užuot grąžinusios 503, o kiekvienam ryšiui taikomos atominės slenkančios RPM nuomos. → [Atsparumo vadovas](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanoninė `/v1/models` tvarka** — vienas vientisas pagal teikėją sugrupuotas blokas kiekvienam teikėjui (deriniai pateikiami pirmiausia), stabili tvarka visuose katalogo šaltiniuose. → [API nuoroda](docs/reference/API_REFERENCE.md) - **🗜️ Suspaudimo sustiprinimas** — pagal numatytuosius nustatymus įjungta išsipūtimo apsauga, Caveman paketai DE / FR / JA ir kinų (wényán) kalboms, RTK filtrai Gradle ir .NET. → [Suspaudimas](docs/compression/COMPRESSION_ENGINES.md) - **💸 Sąžininga fiksuoto tarifo kaina** — prenumeratos / programavimo plano teikėjų kainų analizėje rodoma **$0**; biudžetas, kvota ir maršrutizavimas toliau atlieka sąmatas. → [API nuoroda](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share maršrutizavimas** — sąžiningai paskirsto bendros paskyros kvotą telkiamiems raktams, užtikrindamas darbo tęstinumą, kad nenaudojamos dalys būtų paskolinamos. → [Atsparumo vadovas](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 CLI / agentų sąranka viena komanda** — 15 registruotų `setup-*` komandų; `omniroute run` paleidžia 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` palaiko 11 paskirties sistemų su interaktyviu teikėjo ir modelio parinkikliu bei parankiniais pagal kontekstą. → [CLI integracijos](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Nuotolinis režimas** — valdykite nuotolinį OmniRoute naudodami ribotos aprėpties žetonus (`connect` / `contexts` / `tokens`) ir `antigravity` OAuth pagalbinę priemonę VPS diegimams. → [Nuotolinis režimas](docs/guides/REMOTE-MODE.md) - **🧭 Išmanesnis automatinis maršrutizavimas** — `auto/:` deriniai, **Fusion** (modelių grupė + vertintojas), užduotims pritaikytas maršrutizavimas, pagal užklausą taikomi modelio / režimo / USD biudžeto pakeitimai. → [Automatiniai deriniai](docs/routing/AUTO-COMBO.md) - **🗜️ Įskiepiamas suspaudimas** — 12 komponuojamų variklių ir Compression Studios: LLMLingua-2, dviejų lygių Ultra, omniglyph, kiekvieno veiksmo tikslumo vartai, GCF v3.2, redaktorius su elementų vilkimu ir pertvarkymu. → [Suspaudimas](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Skaidrus MITM iššifravimas (TPROXY)** — fiksavimo CLI, kurie ignoruoja tarpinio serverio aplinkos kintamuosius, su atskiru CA pagal SNI ir patikimos saugyklos diegimo programa. → [MITM / TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Išlaidų telemetrija visur** — `X-OmniRoute-*` išlaidų ir naudojimo antraštės kiekviename galiniame taške, talpyklos pataikymo santaupų antraštė, USD išlaidų kvotos pagal raktą. → [API nuoroda](docs/reference/API_REFERENCE.md) - **🧠 Jūsų valdoma atmintis** — pagal numatytuosius nustatymus išjungta, pasirenkamas int8 vektorių kvantavimas ir tipizuotas nykimas, kiekvienai užklausai skirtas `x-omniroute-no-memory`. → [Atmintis](docs/frameworks/MEMORY.md) - **🛡️ Saugumas** — apsauga nuo prompt injekcijų kiekviename LLM maršrute (red-team testų rinkinys), pasirenkama prisijungimo duomenų maskavimo apsauga (užmaskuoja nutekėjusius API raktus ir paslaptis abiem kryptimis), nemokama DuckDuckGo paskutinės išeities žiniatinklio paieška ir pasirenkami OIDC prisijungimo vartai valdymo skydui (prisijungimas slaptažodžiu visada lieka pasiekiamas). → [Apsaugos priemonės](docs/security/GUARDRAILS.md) - **🖼️ Nauji galiniai taškai** — `/v1/ocr` (Mistral OCR) ir `/v1/audio/translations` (Whisper tipo) užbaigia medijos funkcijų rinkinį. → [API nuoroda](docs/reference/API_REFERENCE.md) - **🎨 Vaizdų / vaizdo įrašų / garso generavimas** — viena medijos API: xAI Grok Imagine ir Novita AI vaizdo įrašai, ComfyUI, Magnific, Adobe Firefly, Segmind bei kalbos teikėjai, tokie kaip ElevenLabs. → [API nuoroda](docs/reference/API_REFERENCE.md) - **🌍 Diegimas ir operacijos** — atvirkštinio tarpinio serverio `basePath`, automatinis naršyklės kalbos aptikimas, įrenginių sekimas pagal raktą, MITM pasitikėjimas be root teisių, zh-TW lokalizacija. → [Aplinka](docs/reference/ENVIRONMENT.md) - **🤝 Daugiau teikėjų ir agentų** — debesijos agentai (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) su naršyklės ir OAuth prisijungimu, visavertė Ollama kortelė, Claude Opus 5 ir Sonnet 5, oficiali Kimi partnerystė (Code / Web / Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… ir atnaujintas **388 teikėjo katalogas**. → [Teikėjai](docs/reference/PROVIDER_REFERENCE.md) - **📡 Maršrutizavimo skaidrumas** — kiekviename atsakyme pateikiama `X-OmniRoute-Decision` antraštė, nurodanti strategiją, teikėją ir delsą, aptarnavusius užklausą; nauja `cache-optimized` derinio strategija ir Auto-Combo `cacheAffinity` faktorius nukreipia pasikartojančias užklausas atgal į ryšį, kuriame laikoma podėlyje esanti priešdėlio dalis; tik skaitymui skirtas `/v1/auto-combo/{channel}/candidates` galinis taškas atskleidžia tiesioginį `auto/*` kanalo kandidatų telkinį. → [Automatiniai deriniai](docs/routing/AUTO-COMBO.md). - **⚡ Vietinis našumas ir infrastruktūra** — vienu spustelėjimu paleidžiamas vietinis Redis, „Cloudflare Workers“ / „Deno Deploy“ perdavimo serverių diegikliai, „Bifrost“ ir „Mux“ kaip prižiūrimosios įterptosios paslaugos. → [Įterptosios paslaugos](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Taip pat įtraukta** — įskiepių sistema ir prekyvietė, „Omni“ / „Agent“ / „GitHub“ įgūdžių sistemos, „Obsidian“ saugyklos integracija (22 MCP įrankiai), su „OpenAI“ suderinamos „Batch“ ir „Files“ API, semantinė atsakymų podėlio sistema, žaidybinimas su lyderių lentelėmis, ACP agentų aptikimas (15 integruotų agentų), suplanuotas žurnalų eksportavimas į „BigQuery“, `auto/chaos` lygiagretus kelių modelių paskirstymas, „Telegram“ roboto sąsaja, programoje integruota versijų tvarkyklė ir nemokamų teikėjų reitingai pagal LMArena-ELO. → [Dokumentacija](docs/README.md)
## 🤖 Suderinami CLI ir programavimo agentai > Viena konfigūracija — `http://localhost:20128/v1` — ir **kiekviena** AI IDE ar CLI veikia su nemokamais ir nebrangiais modeliais.
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
                           
+ taip pat veikia su · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · bet kuriuo OpenAI suderinamu įrankiu
📖 Kiekvieno įrankio nustatymai visiems 39 įrankiams (28 CLI Code + 11 CLI Agentų) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode papildinys → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)

**Paleiskite bet kurį palaikomą CLI per OmniRoute viena komanda** — jokių konfigūracinių failų, prisijungimo duomenys įterpiami kiekvienam procesui, Qwen/Gemini gauna laikiną izoliuotą namų katalogą: ```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" # Arba pasirinkite tiekėją+modelį interaktyviai ir parašykite įrankio nuosavą konfigūraciją: omniroute configure codex # taip pat: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Kiekviena komanda gerbia aktyvų nuotolinį kontekstą (`omniroute connect `), `--dry-run` leidžia peržiūrėti tikslią aplinką/argumentus nevykdant komandos, o `--api-key-env NAME` apsaugo slaptus duomenis nuo patekimo į jūsų shell istoriją. → [CLI integracijos](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 AI teikėjai — 153 kataloge pažymėti kaip nemokami
> **388 registruotas teikėjas** kanoninėse pokalbių, medijos, paieškos, vietinėse, debesijos agentų ir sistemos kolekcijose, įskaitant **153 teikėjus, turinčius `hasFree: true` aptikimo metaduomenis**. Pokalbių modelių registre yra **239 teikėjai / 3 059 skirtingos teikėjo ir modelio poros / 1 475 neapdoroti modelių ID**; atskirame nemokamų planų kataloge yra **471 eilutė pagal modelį**, **34 pasikartojantys fondai** ir **52 pasikartojantys arba be rakto visam laikui nemokami teikėjai**. Tai skirtingi vardikliai pagal paskirtį; apibrėžimai ir pagal fondus deduplikuoti skaičiavimai pateikiami [Teikėjų žinyne](docs/reference/PROVIDER_REFERENCE.md) ir [Nemokamuose planuose](docs/reference/FREE_TIERS.md).
### 🏢 Kiekviena pagrindinė laboratorija — per vieną galinį tašką
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
                           
…ir dar daugiau nei 350 — kiekviena piktograma tiesiogiai gaunama iš prietaisų skydelio teikėjų katalogo. 📖 [Teikėjų žinynas](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Nemokamai visam laikui — 0 $, be kortelės
OpenCode Zen
OpenCode Zen
DeepSeek V4, Nemotron 3
Be žetonų limito
Kilo Code
Kilo Code
Automatinis maršrutizatorius, Tencent Hy3
Nemokama visam laikui
Requesty
Requesty
GPT-OSS 120B, Nemotron
Nemokama visam laikui
SiliconFlow
SiliconFlow
DeepSeek V3.2 / R1
Nemokamas planas
Z.AI GLM
Z.AI GLM
GLM-4.7 / 4.5-Flash
Nemokama visam laikui
Baidu ERNIE
Baidu ERNIE
ERNIE 4.0
Nemokama visam laikui
Qoder AI
Qoder AI
Qwen3-Max, Kimi-K2
NERIBOTAI NEMOKAMAI
Pollinations
Pollinations
GPT, Llama, Claude
Rakto nereikia
Cloudflare AI
Cloudflare AI
50+ modelių
10 tūkst. neuronų per dieną
NVIDIA NIM
NVIDIA NIM
GLM, MiniMax
~40 RPM nemokamai
Cerebras
Cerebras
GLM 4.7, GPT-OSS
Vienkartinis 5 USD kreditas; reikalinga kortelė
OpenRouter
OpenRouter
:free modeliai
+10 USD → didesnis RPM
📖 Visas kompiuterio nuskaitomas katalogas → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Kur OmniRoute bėga – bet kur
> Ta pati programa, jūsų aparatas, jūsų taisyklės. Nuo visuotinio npm diegimo iki** savo telefoną** per Termux. – Windows / macOS / LinuxOmniRouteTray)
Platforma Įdiekite Svarbiausi
📦 npm (visuotinis) npm įdiegti -g omniroute Viena komanda, bet kuri OS
⚡ Bun (pasaulinis) bun add -g omniroute Tas pats registro rinkinys, greičiau įdiegiamas
🐳 Docker docker paleisti … diegosouzapw/omniroute Daugiašakė AMD64 + ARM64
🖥️ Darbalaukis (Electron) npm paleisti elektroną: kūrimas Natūralus langas +
🎩 Meniu juosta
brew install --cask zoispag/tap/omniroute-tray Prižiūri & automatinius serverio atnaujinimus – macOS
💪 ARM vietinis arm64 Raspberry Pi, ARM serveriai, Apple Silicon
📱 Android (Termux) pkg įdiegti nodejs && npx -y omniroute Vykdo jūsų telefone , 24/7, be
📲 PWA„Pridėti prie pagrindinio ekrano“ Visas ekranas, neprisijungus, galima įdiegti iš naršyklės
🧩 OpenCode papildinys @omniroute/opencode-provider Vietinis OpenCode integravimas
🤖 VS Kodas Copilot Pokalbiai įdiegti OmniCopilot plėtinys Kiekvienas OmniRoute modelis vietiniame Copilot pokalbių rinkiklyje – stabilus & Insiders
🛠️ Iš šaltinio npm įdiegti && npm paleisti dev Nulaužkite jį, prisidėkite
📖 [Docker vadovas](docs/guides/DOCKER_GUIDE.md) · [Darbalaukis](electron/README.md) · [Meniu juostos dėklas](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)
### 🧩 Naujiena: OmniRoute viduje VS Code vietiniame Copilot pokalbyje
> Jokios naujos šoninės juostos, jokio naujo pokalbio UI – kiekvienas OmniRoute modelis rodomas tiesiai**Copilot pokalbių modelių rinkiklis, kurį jau naudojate** . Nuo VS kodo 1.122 teikėjo modeliai veikia be GitHub prisijungimo arba Copilot prenumeratos – agento režimas, įrankių iškvietimas ir vizija, nemokamai. Įdiekite** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** plėtinį, nukreipkite jį į savo OmniRoute serverį (numatytasis nustatymas yra `localhost:20128`), tada atidarykite Copilot Chat → modelių rinkiklį →** Tvarkyti modelius…** →**OmniRoute** . < td lygiuoti ="kairėje">VS Kodas – stabilus & Insiders < td lygiuoti ="kairėje">Cursor, Windsurf, VSCodium, Theia, Antigravity, Kiro…
parduotuvė nuoroda Veikia su
🧩 VS Code Marketplace Įdiegti →
🔓 Atidaryti VSX registrą Įdiegti →
Iš redaktoriaus vidaus: atidarykite** Plėtiniai** peržiūrėti, ieškoti** "OmniRoute"** , spustelėkite** Įdiegti** – veikia vienodai abiejose parduotuvėse. Šaltinis, numeriai ir leidybos vadovėlis tiesiogiai adresu [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). 📖 [VS kodas Copilot Pokalbių vadovas](docs/guides/VSCODE-COPILOT.md) – sąranka, ką rodo rinkiklis, prietaisų skydelis skirtuke, trikčių šalinimas
### 🎩 Naujiena: OmniRouteTray – jūsų vartai, gyvenantys meniu juostoje
> `omniroute serve` yra laimingiausias, kai jis visada įjungtas.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** paverčia ją „nustatyti ir pamiršti“ meniu juostos programa, skirta macOS: ji paleidžia serverį, palaiko jį perkraunant iš naujo, atnaujina jį vietoje ir vienu spustelėjimu suteikia jūsų tiesioginio prieigos rakto biudžetą –** nėra paliktas atidarytas terminalo langas, nėra `npm install -g omniroute` auklei.** Sukurtas naudojant [„Tauri v2“](https://v2.tauri.app/) (Rust branduolys, kurio dydis yra apvalinimo klaidos), jis pristato savo pasirašytą „Node 24“ vykdymo laiką ir valdo programai priklausančią OmniRoute diegimą, todėl niekada nekovoja su jūsų visuotiniu `node`/`bun`. Tai** bendrina esamą `~/.omniroute/` konfigūraciją ir duomenų bazę** — vadinasi, tai tas pats OmniRoute kurį jau bėgi, tik su kepure. 🎩
Ką tai daro Kaip
🟢 Prižiūri serverį Sukuria omniroute serve , priima jau veikiantį egzempliorių, o ne dubliuoja jį
📊 Tiesioginis naudojimas Teikėjo kvotų juostos, Claude session/weekly ribos su iš naujo nustatytais atgaliniais skaičiavimais, 30 dienų išlaidų paskirstymas
🔄 Automatiniai atnaujinimai vietoje Laipsniškas diegimas, atomų keitimas, atšaukimas gedimo atveju – visada naujausiame leidime
🚀 Pradėti prisijungus Pasirenkamas paleidimas prisijungus; tik dėklas, be doko piktogramos
🩺 Doctor & žurnalai Diagnostika vienu paspaudimu ir serverio žurnalo prieiga
```sh brew install --cask zoispag/tap/omniroute-tray ``` Norite atsisiųsti? Paimkite naujausią .dmg iš Išleidžia . Šaltinis, problemos ir konstrukcija docs gyvena zoispag/omniroute-tray.
💛 projektas – ne oficialus OmniRoute leidimas.

## 🔒 Privatu ir pirmiausia vietoje
Privatu ir pirmiausia vietoje — „OmniRoute“ šliuzas ir valdymo plokštuma veikia jūsų kompiuteryje. Užklausos siunčiamos kiekvienai užklausai pasirinktam išoriniam paslaugų teikėjui; „OmniRoute“ neprideda jokio debesijoje talpinamo užklausų apdorojimo tarpinio etapo, o telemetrija pagal numatytuosius nustatymus yra išjungta. Prisijungimo duomenys saugomi užšifruoti naudojant AES-256-GCM; valdymo priemonės apima API raktų aprėpties ribojimą, IP filtravimą, dažnio apribojimus, apsaugą nuo užklausų injekcijų, išorinių paslaugų teikėjų antraščių valymą, pasirenkamą asmens identifikavimo informacijos redagavimą, išvalytas klaidas ir vietinį SQLite audito žurnalą. „OmniRoute“ platinama pagal MIT licenciją ir gali būti talpinama savarankiškai. 📖 [Autorizavimas](docs/architecture/AUTHZ_GUIDE.md) · [Apsaugos priemonės](docs/security/GUARDRAILS.md) · [Atitiktis](docs/security/COMPLIANCE.md)
## 🔌 Visavertė CLI + A2A ir MCP
> Be serverio, OmniRoute taip pat yra **visavertis komandų eilutės valdymo centras**, turintis **daugiau nei 80 komandų** ir atvirus agentų protokolus, todėl DI agentas gali jį valdyti **savarankiškai**. ### ⌨️ Tikra CLI (ne vien `start`) ```bash omniroute # paleisti šliuzą ir valdymo skydelį (prievadas 20128) omniroute chat # interaktyvus TUI pokalbių klientas (komandos: /model /combo /skill /memory) omniroute setup # vedlys, skirtas pirmajam paleidimui omniroute doctor # diagnozuoti teikėjus, prievadus ir savąsias priklausomybes ``` ### 🛰️ Nuotolinis režimas — paleiskite CLI čia, o OmniRoute – VPS serveryje OmniRoute veikia serveryje? Valdykite jį iš savo nešiojamojo kompiuterio naudodami **tą pačią CLI**. Vieną kartą prisijunkite naudodami ribotos aprėpties prieigos prieigos raktą; tuomet kiekviena komanda bus vykdoma nuotoliniame serveryje. ```bash omniroute connect 192.168.0.15 # slaptažodis → ribotos aprėpties prieigos raktas, išsaugomas kaip kontekstas omniroute models # ← vykdoma NUOTOLINIAME serveryje omniroute configure codex # ← pasirenkamas nuotolinis modelis, įrašomas vietinis Codex profilis omniroute tokens create --name ci --scope read # sukurti siauresnės aprėpties prieigos raktus kitiems įrenginiams omniroute contexts use default # ← grįžti į vietinį serverį ``` Prieigos raktų aprėptys yra `read` / `write` / `admin`; procesus paleidžiantys maršrutai lieka pasiekiami tik per grįžtamąją sąsają. 📖 [Nuotolinis režimas](docs/guides/REMOTE-MODE.md)
Animuotas terminalas, demonstruojantis OmniRoute CLI — omniroute providers list, omniroute combo list ir omniroute health — paeiliui parodantis aukščiausio lygio 89 komandų sąsają: 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 …
### 🤝 Prijunkite agentą — ir jis pats valdys OmniRoute Suteikite prieigą prie OmniRoute per **MCP**, **A2A**, **REST API**, **žiniatinklio sąsajas** arba **nuotolinę CLI** — bet kuris tinkamas agentas (ar jūsų pačių kodas) galės autonomiškai valdyti visą šliuzą: maršrutizavimą, teikėjus, derinius, podėlį, glaudinimą ir atmintį. Toliau nurodyti HTTP galiniai taškai pasiekiami adresu `http://localhost:20128`.
SąsajaGalinis taškas / komandaKam naudoti
🧰 MCP (stdio)omniroute --mcpIntegruoti su Claude Desktop, Cursor ar bet kuriuo MCP klientu
🌊 MCP (HTTP)/api/mcp/streamNuotolinis MCP — 110 įrankių, 33 aprėptys (apribojimų taikymas pasirenkamas), išsamus audito žurnalas
📡 MCP (SSE)/api/mcp/sseSrautinis MCP transportas
🤝 A2A/.well-known/agent.jsonRyšys tarp agentų, JSON-RPC 2.0 + SSE, 6 įgūdžiai
🌐 REST API/v1/*Suderinama su OpenAI — pokalbiai, įterpiniai, vaizdai, garsas, OCR
🔔 Žiniatinklio sąsajos/api/webhooksSiųsti užklausų / kvotų įvykius į Slack, Discord, Telegram arba bet kurį URL
🛰️ Nuotolinė CLIomniroute connect Valdyti nuotolinį egzempliorių naudojant ribotos aprėpties prieigos raktus
```bash # Suteikti Claude Code visą OmniRoute įrankių rinkinį per MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` 📖 [MCP serveris](docs/frameworks/MCP-SERVER.md) · [A2A serveris](docs/frameworks/A2A-SERVER.md) · [Agentų protokolai](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Automatiškai sutaupykite 15–95 % žetonų
### 📖 Kaip tai veikia — konvejeris, architektūra ir sutaupymo matematika OmniRoute glaudinimo konvejeris: iliustracinė 10 000 žetonų kliento užklausa pereina per 12 komponuojamų variklių — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra ir OmniGlyph — o dokumentuotame sudėtiniame pavyzdyje teikėją gali pasiekti maždaug 1 080 žetonų. Struktūrinį turinį apsaugo išsaugojimo apsaugos ir kiekvieno etapo tikslumo vartai; aiškiai nuostolingi arba eksperimentiniai režimai gali transformuoti tinkamą turinį. Numatytasis sudėtinis derinys vykdo `RTK → Caveman`. Kai abu veikia tą patį įrankio / konteksto turinį, sutaupymai sumuojasi: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Kodo blokai, URL, JSON ir struktūriniai duomenys **visada apsaugomi** išsaugojimo varikliu. > **Kodėl naudoti daug žetonų, jei užtenka kelių?** Kiekviena užklausa **skaidriai** pereina per OmniRoute glaudinimo konvejerį — klientui nereikia jokių pakeitimų. Dabar tai yra **12 komponuojamų variklių seka**, kurie vykdomi eilės tvarka ir gali būti įvairiai derinami pagal maršrutizavimo derinį — remiantis [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) ir [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) idėjomis. ### 🧱 12 variklių seka Varikliai vykdomi konvejerio tvarka; kiekvieną galima nepriklausomai įjungti arba konfigūruoti pagal derinį:
#VariklisKą jis daro
1Session-DedupPašalina per skirtingus pokalbio žingsnius pasikartojantį turinį (pagal turinio adresą, tarp pokalbio žingsnių)
2CCRDidelius blokus archyvuoja užklausos žymekliais, o jie gaunami prireikus
3LiteTarpų ir paveikslėlių URL trumpinimas (mažos delsos bazinis režimas)
4RTKIšmanus įrankių rezultatų filtravimas, pasikartojančių duomenų šalinimas ir trumpinimas (atsižvelgia į komandas)
5Responses Tool OutputPirmiausia be nuostolių apdorojamas JSON ir ribojamas diagnostikos glaudinimas apvalkalo / pataisų / paieškos / kūrimo išvestims (Responses API)
6HeadroomBe nuostolių sutankina JSON masyvų lenteles (~30 %) naudodamas įtrauktą GCF kodeką
7RelevanceVertina sakinius pagal jų svarbą, palyginti su paskutine naudotojo užklausa
8CavemanTaisyklėmis pagrįstas prozos glaudinimas (~65–75 % išvestyje)
9AggressiveSantraukų kūrimas ir laipsniškas senų pokalbio žingsnių „senėjimas“
10LLMLingua-2ML semantinis retinimas naudojant MobileBERT ONNX — saugus kodui, asinchroninis
11UltraHeuristinis žetonų retinimas su pasirenkamu mažo modelio (SLM) lygiu
12OmniGlyphEksperimentinis konteksto kodavimas kaip paveikslėlio, skirtas išmatuotam Claude Fable 5 tiesioginiame Anthropic perdavimo kanale; GPT 5.6 transformatoriai lieka uždaryti pagal saugiąją schemą, kol bus gauti teikėjo patvirtinimai. Keturi glaudinimo profiliai (agresyvusis numatytasis, subalansuotas, saugus kodui, perdavimas be pakeitimų) (agresyviausias; pasirenkamas)
Kodo blokai, URL ir struktūriniai duomenys **visada išsaugomi** bitų tikslumu. **Vieno spustelėjimo išankstiniai nustatymai** sujungia variklius:
RežimasSutaupymaiGeriausiai tinka
🪶 Lite~15 %Visada įjungtas saugus numatytasis režimas
🪨 Standard (Caveman)~30 %Kasdieniam programavimui
⚡ Aggressive~50 %Ilgiems seansams su daugybe įrankių
🔥 Ultra~75 %Maksimaliems sutaupymams
🧰 RTK60–90 %Apvalkalo / testų / kūrimo / git išvestims
🔗 Stacked (RTK → Caveman)78–95 %Mišrioms užklausoms ir įrankių žurnalams
**Tikras pavyzdys — Standard režimas:** > **Prieš (69 žetonai):** _"Tikėtina priežastis, kodėl jūsų React komponentas generuojamas iš naujo, yra ta, kad kiekvieno generavimo ciklo metu kuriama nauja objekto nuoroda. Kai perduodate tiesioginį objektą kaip savybę, React paviršutiniškas palyginimas kaskart mato kitą objektą, todėl komponentas generuojamas iš naujo. Rekomenduočiau naudoti useMemo objektui įsiminti."_ > > **Po (19 žetonų):** _"Nauja objekto nuoroda kiekvieno generavimo metu. Tiesioginė objekto savybė = nauja nuoroda = generavimas iš naujo. Apgaubkite naudodami useMemo."_ > > **Tas pats atsakymas. 72 % mažiau žetonų. Tikslumas neprarastas.** ✅ **PT-BR pavyzdys — [Troglodita](https://github.com/leninejunior/troglodita) režimas:** > **Anksčiau (42 žetonai):** _„Problema ta, kad komponentas iš naujo atvaizduojamas, nes kiekvieno atvaizdavimo ciklo metu sukuriama nauja objekto nuoroda. Rekomenduočiau naudoti useMemo.“_ > > **Dabar (12 žetonų):** _„Pakartotinis atvaizdavimas: nauja nuoroda kiekviename cikle (įterptasis objektas sukuriamas iš naujo). Naudoti `useMemo`.“_ > > **Tas pats atsakymas. ~70 % mažiau žetonų. Techninis tikslumas išlaikytas.** ✅
### 🎚️ Už variklių ribų — išvesties stiliai, adaptyvusis valdiklis ir valdymas kiekvienai užklausai Pirmiau aprašyti 12 variklių sumažina tai, kas **patenka į vidų**. Dar trys sluoksniai formuoja **kaip**, **kada** ir kas **patenka į išvestį**: - **🪄 Išvesties stiliai** _(išvesties ašies valdymas)_ — įterpia deterministines, talpyklai saugias atsako formavimo instrukcijas; juos galima derinti, o kiekvienam taikomas `lite` / `full` / `ultra` intensyvumas. Stilių pridėti galima vienu registro įrašu: - **Glausta proza** — pašalinti užpildą / artikelius / atsargias formuluotes; techninę esmę išlaikyti tiksliai. - **Mažiau kodo** — YAGNI pagal „tingaus vyresniojo programuotojo“ principą: mažiausias veikiantis pakeitimas, be neprašytos infrastruktūros. - **Arklio uodega (tingus vyresnysis programuotojas)** — kopti YAGNI kopėčiomis, taisyti pagrindinę priežastį, pateikti mažiausią veikiantį skirtumą. - **Turiu ADHD (veiksmas pirmiausia)** — pirmiausia nurodyti kitą veiksmą, sunumeruoti žingsnius, pateikti vieną konkretų kitą žingsnį, be įžangos. - **Glaustas CJK (文言)** — itin glaustas klasikinės kinų kalbos stilius (priklauso nuo lokalės, taikomas tik `zh`). - **🎯 Adaptyvusis konteksto biudžetas** _(valdiklis)_ — vietoj vienos įjungimo / išjungimo žetonų ribos brangiausi ir mažiausiai informacijos prarandantys varikliai aktyvinami tik tiek, kiek reikia, kad **tilptų į modelio konteksto langą**. Politika: `reserve-output` (numatytoji, atsižvelgianti į modelį) · `percentage` · `absolute`. Režimas: `floor` (garantuoti, kad tilps) · `replace-autotrigger` (pirmenybė teikiama jūsų aiškiam pasirinkimui) · `off` (senstelėjusi riba). - **🎛️ Kur nusprendžiama dėl glaudinimo** _(prioritetas nuo aukščiausio iki žemiausio)_ — kiekvienos užklausos `x-omniroute-compression` antraštė › maršrutizavimo derinio perrašymas › aktyvus pavadintas profilis › adaptyvusis režimas / automatinis paleidiklis › skydelio numatytoji reikšmė › išjungta. Pritaikytas planas grąžinamas `X-OmniRoute-Compression: ; source=` atsako antraštėje. Automatinis paleidimas pagal žetonų ribą, adaptyviojo valdiklio įjungimas, pavadinto profilio prisegimas, vienkartinis nustatymas konkrečiai užklausai arba konvejerio priskyrimas kiekvienam maršrutizavimo deriniui — pasirinkite tai, kas geriausiai atitinka darbo krūvį. Pasirenkamas neprisijungęs **vertinimo įrankių rinkinys** (`npm run eval:compression`) įvertina tikslumą ir sutaupymą pagal fiksuotą korpusą prieš diegiant pakeitimą. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Greita pradžia
**1) Įdiekite ir paleiskite** ```bash npm install -g omniroute omniroute ``` > 💡 Matote `npm warn ERESOLVE` arba įspėjimus apie peer priklausomybes? [Jie nepavojingi](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Naudojate npm 11 arba naujesnę versiją?** npm gali blokuoti paketo gyvavimo ciklo scenarijus, nebent jiems suteiktas leidimas. OmniRoute `postinstall` (`node scripts/build/postinstall.mjs`) reikalingas paruošti saviesiems vykdymo failams. Diegdami globaliai suteikite leidimą įspėjime npm nurodytiems paketams. Paketų rinkiniui, apie kurį praneša OmniRoute 3.8.54: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Norėdami ateityje šį leidžiamų paketų sąrašą naudoti diegdami globaliai, sukonfigūruokite jį vieną kartą, tada diekite įprastai: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Priklausomybių sąrašas tarp leidimų gali keistis; jei npm praneša apie kitokį sąrašą, naudokite tame įspėjime nurodytus paketų pavadinimus. Leidus paketui, jo diegimo scenarijams leidžiama veikti. > **Naudojate Gemini Web arba kitą žiniatinklio slapukais pagrįstą teikėją?** npm pakete yra > Playwright, tačiau nėra jo Chromium dvejetainio failo. Prieš pateikdami pirmąją užklausą žiniatinklio teikėjui, žr. > [Playwright Chromium sąrankos](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > pastabą. Valdymo skydelis adresu `http://localhost:20128` · API adresu `http://localhost:20128/v1`. **2) Prijunkite tinkamą teikėją naudodami savo paskyrą** Valdymo skydelis → **Teikėjai** → pasirinkite teikėją, kurio dabartinės sąlygos ir kvota atitinka jūsų naudojimo scenarijų → pridėkite jo API raktą arba atlikite paskyros prijungimo veiksmus. Nemokami planai gali reikalauti registracijos, patvirtinimo arba mokėjimo metodo. Peržiūrėkite [nemokamų planų vadovą](docs/getting-started/FREE-TIERS-GUIDE.md); prieinamumas be rakto negarantuojamas, o teikėjai, pažymėti `tos: avoid`, pagal numatytuosius nustatymus neįtraukiami į `auto`. **3) Nukreipkite savo programavimo įrankį** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Patikrinkite, ar viskas veikia** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Turėtumėte matyti išvardytus prijungtus modelius. 🎉 Štai ir viskas — pradėkite programuoti, o OmniRoute automatiškai parinks maršrutą ir prireikus persijungs į atsarginį. Jei jūsų klientas negali siųsti pasirinktinių antraščių, OmniRoute taip pat pateikia žetonais pagrįstus suderinamumo pseudonimus: ```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 ``` Naudokite juos tik su klientais, kurie negali pridėti `Authorization: Bearer ...`. Autentifikavimas antraštėje išlieka rekomenduojamu režimu.
## 📦 Daugiau diegimo būdų — Docker, pirminis kodas, 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` nurodo aukščiausią **paskelbtą** stabilią SemVer versiją. Ji neseka git `main`. Naudodami GitOps, pasirinkite konkrečią `:X.Y.Z` versiją. Žr. [Docker leidimų kanalus](docs/guides/DOCKER_GUIDE.md#release-channels). Atvaizde nustatyta **`OMNIROUTE_MEMORY_MB=1024`**. To pakanka valdymo skydeliui ir nedideliam pokalbiui. **Programavimo agentams** (`POST /v1/responses` iš Claude Code, Codex, Grok, …) reikia gerokai didesnės V8 krūvos, kitaip, esant dviem persidengiantiems ilgiems kontekstams ir sunaudojus apie 12 GiB, procesas baigiamas `FATAL ERROR` klaida. Konteineriui skirkite daugiau atminties nei krūvai (savosios atminties buferiai yra už V8 ribų): | Darbo krūvis | Krūva (`-e OMNIROUTE_MEMORY_MB`) | Konteineris (`--memory`) | | ----------------------------------------------- | ------------------------------------ | ------------------------ | | Valdymo skydelis / nedidelis pokalbis | `1024` (numatytoji atvaizdo reikšmė) | ≥2 g | | Vienas programavimo agentas | `8192` | ≥10 g | | Dvi vienalaikės ilgos `/v1/responses` užklausos | `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 ``` Visa lentelė: [Docker vadovas — vykdymo aplinkos RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Išankstinių Docker leidimų kanalas:** `diegosouzapw/omniroute:next` ir > `diegosouzapw/omniroute:next-web` seka dabartinę numatytąją `release/v*` > šaką. Šios kintamos žymos skirtos tik dar neišleistiems pataisymams testuoti ir > **nėra palaikomos gamybinėje aplinkoje**. Žr. > [Docker leidimų kanalus](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standartinis `bun install` ir visuotinis diegimas (`bun install -g omniroute`) palaikomi aptinkant Bun vykdymo aplinką: - **Integruotas `bun:sqlite`**: veikdama Bun aplinkoje, OmniRoute naudoja integruotą Bun `bun:sqlite` tvarkyklę, o Node.js aplinkoje grįžta prie `better-sqlite3` arba `sql.js`. - **Automatinis Webpack rinkinio kūrimo priemonės parinkimas kūrimo aplinkoje**: kūrimo režimas (`bun run dev`) automatiškai aptinka Bun ir vietoje Turbopack įjungia Webpack, kad būtų išvengta nesuderinamumo su savosiomis V8 sąsajomis. Gamybinės versijos (`bun run build`) naudoja `OMNIROUTE_USE_TURBOPACK` lygiai taip pat kaip Node aplinkoje: pagal numatytuosius nustatymus naudojama Turbopack, o norint kurti su Webpack — `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` ją pateikia kaip `--build-arg`). - **Specialus Bun Dockerfile**: kelių etapų `Dockerfile.bun`, skirtas saviesiems gamybiniams Bun diegimams (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Įdiekite ir paleiskite naudodami Bun bun install bun run dev ``` **🛠️ Iš pirminio kodo** ```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 # Naudojant Nix flakes nix develop npm run dev # Arba naudojant devbox devbox run npm run dev ``` 📖 [Docker vadovas](docs/guides/DOCKER_GUIDE.md) — Compose profiliai, Caddy HTTPS, Cloudflare tuneliai. **🦭 Podman** ```bash # 1. Paruoškite susietai prijungiamą duomenų katalogą mkdir -p data # 2. Tik Linux ir vietiniam be root veikiančiam Podman (niekada nenaudokite su nuotoliniu Podman Machine klientu): podman unshare chown 1000:1000 ./data # 3. Nustatykite vykdymo aplinkos nuorodą, sukurkite vietinį Compose atvaizdą ir paleiskite echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS arba Windows sistemose Podman naudoja nuotolinę Podman Machine: praleiskite `podman unshare` ir vadovaukitės [konkrečiai topologijai skirtomis duomenų katalogo rekomendacijomis](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Podman vadovas](contrib/podman/README.md) — Compose versijų kūrimas, Podman Machine ir Linux/systemd Quadlet sąranka. **⚡ Greitesnis / lengvesnis diegimas (praleidžiant savosios dalies kūrimą)** Savasis SQLite variklis (`better-sqlite3`) yra **pasirenkama** priklausomybė, todėl visuotinis diegimas niekada neužstringa kompiliuojant iš pirminio kodo: kai jūsų platformai ir Node versijai yra tinkamas iš anksto sukompiliuotas dvejetainis failas, naudojamas jis, o kitu atveju skaidriai pereinama prie grynojo JS variklio (`node:sqlite` naudojant Node 22+, kitu atveju — pridėtas `sql.js` WASM) — kūrimo įrankių nereikia. Norėdami visiškai praleisti po įdiegimo atliekamą **savosios dalies paruošimą** (CI, aplinkose be grafinės sąsajos arba lėtuose kompiuteriuose), naudokite toliau pateiktą komandą. Pastaba: taip praleidžiamas tik savosios SQLite dalies paruošimo veiksmas (`scripts/postinstall.mjs`); dvejetainio failo kopijavimo / taisymo procedūra (`scripts/build/postinstall.mjs`) vis tiek vykdoma įprastai: ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 taip pat jį praleidžia ``` Norėdami diegti greičiausiai, rinkitės **pnpm** (pagal turinį adresuojama saugykla ir kietosios nuorodos — žr. pirmiau). Norėdami naudoti vykdymo aplinką be valdymo skydelio ir grafinės sąsajos, rinkitės Docker `base` profilį (pirmiau) arba [Termux vadovą](docs/guides/TERMUX_GUIDE.md). CLI ir žiniatinklio valdymo skydelį aptarnauja tas pats procesas viename prievade, todėl šiuo metu nėra atskiro, tik CLI skirto paketo.
# 🎬 OmniRoute veikia
## 📹 Vaizdo įrašų vadovai
Skydelio momentinė kopija 2026-10-18 · Neapdorotas katalogas: YT 1.352 | TT 334 | IG 290 · Duomenų naujumas (dienomis): YT 5 | TT 48 | IG 49
Instagram vaizdo įrašas — nick_saraev
🎬 #1 — Instagram
nick_saraev — 3,042,474 peržiūros
Instagram vaizdo įrašas — nnapier7
🎬 #2 — Instagram
nnapier7 — 1,454,535 peržiūros
YouTube — Amidia AI & Tech
🎬 #3 — YouTube
Amidia AI & Tech — 794,974 peržiūros
Instagram vaizdo įrašas — theopenstack
🎬 #4 — Instagram
theopenstack — 692,419 peržiūros
TikTok — migue.baena
🎬 #5 — TikTok
migue.baena — 685,788 peržiūros
**Visas reitingas (pasikartojantys kanoniniai URL pašalinti, `v > 0`, didžiausia aprėptis):** | #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** | Kanoninės metrikos 2026-10-18: **1.976 unikalūs vaizdo įrašai** · **20.220.289 žinomos peržiūros** (`v > 0`) · **1.210 kanalų / profilių visose platformose**. Neapdorotame skydelyje yra 1.976 eilutės (YouTube 1.352 = 740 ilgos trukmės vaizdo įrašų + 612 Shorts · TikTok 334 · Instagram 290); po normalizavimo pagal kanoninį URL, išsaugantį didžiausią kiekvieno vaizdo įrašo peržiūrų skaičių, neliko nė vieno dublikato. YouTube duomenų rinkimas sustabdytas ties 2026-10-13 (API kvota buvo išnaudota nuo 14 iki 18/10), o TikTok/Instagram — nuo 2026-09-02 (nebėra duomenų rinkimo kreditų); 76 vaizdo įrašai vis dar neturi peržiūrų skaičiaus. > 🎬 **Sukūrėte vaizdo įrašą apie OmniRoute?** Atidarykite [problemą](https://github.com/diegosouzapw/OmniRoute/issues/new) arba [diskusiją](https://github.com/diegosouzapw/OmniRoute/discussions) ir pridėkite nuorodą — pristatysime jį čia.
# 📧 Bendruomenė ir pagalba > Viskas vienoje vietoje — sekite prižiūrėtoją, bendraukite su bendruomene arba atidarykite problemą. | Kanalas | Kur / kaip | | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — sekite prižiūrėtoją | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — sekite naujienas ir patarimus | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 pasaulinė grupė** | [prisijungti prie grupės](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazilija** | [prisijungti prie grupės](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Svetainė** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute bendruomenė (nemokama)** | [StHub portalas](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Šaltinio kodas** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Pranešti apie klaidą** | [sukurti problemos įrašą](https://github.com/diegosouzapw/OmniRoute/issues) — pridėkite `npm run system-info` išvestį | | 🤝 **Prisidėti** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Šakų ir leidimų modelis](docs/ops/BRANCHING_MODEL.md) · pasirinkite `good first issue` | | 💚 **Paremti projektą** | [Paramos būdai ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |
---
## 🛠️ Technologijų rinkinys
SluoksnisTechnologija
Vykdymo aplinkaNode.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27
KalbaTypeScript 6.0 — 100% TypeScript visame src/ ir open-sse/ (nuo v2.0 pagrindiniame kode nėra any)
KarkasasNext.js 16 + React 19 + Tailwind CSS 4
Duomenų bazėbetter-sqlite3 (SQLite, WAL žurnalinimas) + LowDB (JSON senoji sistema) — 147 domeno modulių, 233 migracijos
AtmintisSQLite FTS5 viso teksto paieška + int8 kvantuoti vektoriniai įterpiniai, tipizuotas nykimas
SchemosZod 4 — MCP įrankių įvesties / išvesties tikrinimas + API sutartys
ProtokolaiMCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Srautinis perdavimasServerio siunčiami įvykiai (SSE) + WebSocket tiltas (/v1/ws)
Suspaudimas12 variklių konvejeris — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Autentifikavimas ir saugaOAuth 2.0 (PKCE) + JWT + API Keys + MCP ribotos apimties autentifikavimas · AES-256-GCM ramybės būsenoje · DOMPurify
Slaptumaswreq-js — JA3 / JA4 TLS pirštų atspaudų imitavimas, 3 lygių tarpinis serveris
AtsparumasGrandinės pertraukiklis, eksponentinis laukimo laiko didinimas, apsauga nuo vienalaikių užklausų antplūdžio, automatinio derinio savaiminis atkūrimas
Žurnalų registravimaspino — struktūrizuoti JSON žurnalai su užklausos kontekstu
TestavimasNode.js testų vykdyklė + Vitest — 60 000+ statinių testų deklaracijų daugiau nei 8 400 stebimų testų failų (vienetų, integraciniai, E2E, saugos, ekosistemos)
PlatformosStaliniai kompiuteriai (Electron) · Android (Termux) · PWA (bet kuri naršyklė)
CI/CDGitHub Actions — automatinis publikavimas į npm + Docker Hub išleidus versiją
NuorodosInterneto svetainė · npm · Docker Hub

## 📖 Dokumentacija
### 📘 Darbo pradžia
DokumentasAprašymas
Naudotojo vadovasTeikėjai, deriniai, CLI integracija, diegimas
Sąrankos vadovasVisi diegimo būdai, CLI įrankių konfigūracijos, protokolo sąranka, skirtojo laiko derinimas
CLI įrankių vadovasAtskirų įrankių sąranka, skirta Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Nuotolinis režimasNuotolinio OmniRoute (VPS) valdymas iš nešiojamojo kompiuterio CLI naudojant ribotos aprėpties prieigos žetonus
Claude Code konfigūracijaClaude Code prijungimas prie OmniRoute (vietinio / nuotolinio) naudojant launch + kiekvieno modelio profilius
Greitasis paleidimasDiegimas per 3 veiksmus → prijungimas → konfigūravimas
### 🔧 Eksploatavimas ir diegimas
DokumentasAprašymas
Docker vadovasDocker paleidimas, Compose profiliai, Caddy HTTPS, tuneliai, atvaizdų žymos
Podman vadovasQuadlet systemd integracija, podman-compose, SELinux
Diegimas virtualiojoje mašinojeIšsamus vadovas: VM + nginx + Cloudflare sąranka
Diegimas Fly.ioDiegimas į Fly.io naudojant nuolatinę saugyklą
Termux vadovasOmniRoute paleidimas sistemoje Android naudojant Termux
PWA vadovasProgresyviosios žiniatinklio programėlės diegimas, spartinančioji talpykla, architektūra
Pašalinimo vadovasŠvarus pašalinimas naudojant visus diegimo būdus
Aplinkos konfigūracijaVisi .env kintamieji ir nuorodos
### 🧠 Funkcijos ir architektūra
DokumentasAprašymas
ArchitektūraSistemos architektūra, duomenų srautas ir vidiniai komponentai
Glaudinimo vadovas7 parinkčių konvejeris: off / lite / standard / aggressive / ultra / RTK / stacked
RTK glaudinimasKomandų išvesties glaudinimas, filtrai, pasitikėjimas, tikrinimas, neapdorotos išvesties atkūrimas
Glaudinimo varikliaiCaveman, RTK, sudėtiniai konvejeriai, skydelio / API / MCP sąsajos
Glaudinimo taisyklių formatasJSON taisyklių paketų schemos, skirtos Caveman ir RTK filtrams
Glaudinimo kalbų paketaiKalbos aptikimas ir Caveman taisyklių paketų kūrimas
Atsparumo vadovasGrandinės pertraukikliai, atvėsimo laikotarpiai, eilė, apsauga nuo „griausmingos bandos“, TLS klastojimas
Automatinio derinio variklis16 veiksnių vertinimas, režimų paketai, savaiminis taisymas
Tarpinio serverio vadovas3 lygių tarpinių serverių sistema, 1proxy prekyvietė, registro CRUD operacijos
Nemokami planaiSujungtas katalogas: 34 dokumentuoti pasikartojantys telkiniai / 465 kataloguoti nemokamų planų įrašai
Funkcijų galerijaVaizdinė skydelio apžvalga su ekrano kopijomis
Kodo bazės dokumentacijaKodo bazės apžvalga, pritaikyta pradedantiesiems
### 🤖 Protokolai ir API
DokumentasAprašymas
API žinynasVisi galiniai taškai su pavyzdžiais
OpenAPI specifikacijaOpenAPI 3.0 specifikacija
MCP serveris110 MCP įrankių, IDE konfigūracijos, Python/TS/Go klientai
MCP serverio vadovasMCP diegimas, perdavimo protokolai ir įrankių žinynas
A2A serverisJSON-RPC 2.0 protokolas, gebėjimai, srautinis perdavimas, užduočių valdymas
A2A serverio vadovasA2A agento kortelė, užduotys, gebėjimai ir srautinis perdavimas
### 📋 Projektas ir kokybė
DokumentasAprašymas
PrisidėjimasKūrimo aplinkos paruošimas ir gairės
Šakų ir leidimų modelisKur nukreipiami PR (release/*), ką reiškia main ir žymos
Pakeitimų žurnalasIšsami kiekvienos versijos leidimų istorija
Saugumo politikaPažeidžiamumų pranešimai ir saugumo praktika
i18n vadovas67 kalbų palaikymas, vertimo eiga, RTL
Leidimo kontrolinis sąrašasVeiksmai prieš leidimą atliekamam tikrinimui
Aprėpties planasTestų aprėpties strategija daugiau nei 60 000 statinių testų deklaracijų 8 400+ sekamuose testų failuose

# ⭐ Pagrindiniai prisidėjusieji > OmniRoute formuoja entuziastinga atvirojo kodo bendruomenė. Šie žmonės išskirtinai prisidėjo prie projekto, tiesiogiai paveikdami jo kokybę, stabilumą ir pasiekiamumą. **Ačiū.** ### Išoriniai prisidėjusieji pagal sujungtus pull request
VietaPrisidėjusysisSujungti PR~Pakeistos eilutės
1maxmad64bis41825,367,739
2HouMinXi29513,557,796
3pacocartones22281,551
4backryun210270,562
5JxnLexn1983,570,623
6oyi77190411,243
7KooshaPari1515,972,314
8rdself14580,663
9RaviTharuma123500,065
10herjarsa88230,872
11hartmark852,849,623
12jonlwheat2-gif6869,097
13artickc6243,502
14xiaoyaner020159126,220
15chirag127526,661
16xz-dev50245,976
17woodsonl48811,771
18rqzbeh46151,229
19MumuTW4328,166
19QuangBlue4313,112
Surašymas atliktas 2026-11-03 03:01:19 UTC, naudojant aktyvią release/v3.8.53 viršūnę 05bc048d6c. Puslapiuose pateikiamame GitHub GraphQL suraše yra 9 947 sujungti PR: 4 130 iš saugyklos savininko, 240 iš Dependabot, 6 iš kitų robotų / programėlių ir 5 571 išorinis PR iš 883 atskirų prisidėjusiųjų. „Pakeistos eilutės“ yra GitHub pridėjimų ir ištrynimų suma; į ją įtraukiami sugeneruoti failai, užrakinimo failai, katalogai, vertimai ir dokumentacija; tai yra pakeitimų apimtis, o ne autoriaus parašytas LOC skaičius. 53 PR nurodo didesnius nei 500 000 eilučių GitHub skirtumus (pavyzdžiui, #13399, kuriame pridėtas vienas teikėjas, nurodoma 2 347 pakeisti failai), todėl keli pirmiau pateikti bendri skaičiai yra išpūsti. Vienodos vietos reitinge nurodomos kartu. ### GitHub priskirti įsipareigojimai
Dizzle
Dizzle

🥇 418 GitHub priskiriamų įsipareigojimų
Bob.Hou
Bob.Hou

🥈 294 GitHub priskiriami įsipareigojimai
Paijo
Paijo

🥉 229 GitHub priskiriami įsipareigojimai
Paco Cartones
Paco Cartones

🏅 222 GitHub priskiriami įsipareigojimai
backryun
backryun

🏅 202 GitHub priskiriami įsipareigojimai
Jan Leon
Jan Leon

🏅 134 GitHub priskiriami įsipareigojimai
Ravi Tharuma
Ravi Tharuma

🏅 126 GitHub priskiriami įsipareigojimai
Markus Hartung
Markus Hartung

🏅 115 GitHub priskiriami įsipareigojimai
Randi
Randi

🏅 108 GitHub priskiriami įsipareigojimai
Chris
Chris

🏅 70 GitHub priskiriami įsipareigojimai
WebPerson
WebPerson

🏅 68 GitHub priskiriami įsipareigojimai
Koosha Paridehpour
Koosha Paridehpour

🏅 68 GitHub priskiriami įsipareigojimai
Pakartotinai patikrinta 2026-11-03 02:09:16 UTC: GitHub priskiriami įsipareigojimai, kuriuos pateikė saugyklos Contributors API, skirtai numatytajai šakai release/v3.8.53. API grąžino 903 tapatybes (429 naudotojus, 2 robotus, 472 anoniminius); šioje lentelėje neįtrauktas prižiūrėtojas, robotai ir anoniminės tapatybės, taip pat išlaikytos vienodos vietos. Šis sąrašas skiriasi nuo pirmiau pateikto sulietų PR reitingo ir toliau pateikiamo Git metaduomenų surašymo. > 🙏 Šių pagalbininkų funkcijos, klaidų taisymai ir infrastruktūros patobulinimai yra **esminė dalis** to, kas daro OmniRoute patikimą ir turtingą funkcijomis. Svarbus kiekvienas traukimo prašymas, kiekvienas testavimo atvejis ir kiekvienas i18n vertimo failas. Atvirąjį kodą kuria tokie žmonės kaip jie.
---
## 💖 Rėmėjai
Nuoširdžiai dėkojame žmonėms, kurie finansuoja „OmniRoute“ iš savo kišenės — kiekvienas indėlis padeda projektui išlikti nemokamam, nepriklausomam ir toliau vystytis.
Andrew
Andrew

💛 Aktyvus mėnesinis rėmėjas
Vlad I
Vlad I

💛 Aktyvus mėnesinis rėmėjas
小妍儿
小妍儿

💛 Aktyvus mėnesinis rėmėjas
Guilherme Costa
Guilherme Costa

💛 Aktyvus vienkartinis rėmėjas
Henrique Triches Iurkiv
Henrique Iurkiv

💛 Aktyvus vienkartinis rėmėjas
Somesh Ghaturle
Somesh Ghaturle

💛 Aktyvus vienkartinis rėmėjas
Kolonie AI
Kolonie AI

💛 Ankstesnis vienkartinis rėmėjas
Professor Igor Morais Vasconcelos
Prof. Igor Morais

💛 Ankstesnis vienkartinis rėmėjas
Pixma
Pixma

💛 Ankstesnis vienkartinis rėmėjas
Paco Cartones
Paco Cartones

💛 Ankstesnis vienkartinis rėmėjas
longtao
longtao

💛 Ankstesnis vienkartinis rėmėjas
… ir kiti, pageidaujantys išlikti nevieši 💛 Vieši „GitHub Sponsors“ duomenys buvo pakartotinai patikrinti 2026-10-18 naudojant „GitHub Sponsors GraphQL API“: 11 viešų rėmimų (6 aktyvūs, 5 ankstesni) iš 14 iš viso. „GitHub“ būsena isActive lemia pirmiau pateiktas aktyvumo žymas; ankstesniems viešiems vienkartiniams rėmėjams ir toliau dėkojama, o nevieši rėmėjai lieka anonimiški. „Ko-fi“, „Buy Me a Coffee“, „Liberapay“, PIX ir kriptovaliutų aukos sąraše nepateikiamos, nes nėra viešų įrašų apie šiuos rėmėjus.
💖 Tapkite rėmėju → — kiekvienas doleris padeda „OmniRoute“ išlikti nemokamam ir nepriklausomam.

## 👥 Daugiau nei 1 000 bendraautorių
[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) Audituota 2026-11-02 tiesioginės release/v3.8.53 šakos viršūnėje 1c7135e0fb (7 972 pakeitimai): 1 074 normalizuotos tikrų žmonių Git tapatybės — 759 rodomi kaip pakeitimų autoriai (įskaitant prižiūrėtoją), o 315 nurodyti tik aiškiuose Co-authored-by prierašuose. Surašant naudotas .mailmap, el. pašto adresai lyginti neatsižvelgiant į raidžių registrą, skaitmeniniai ir įprasti GitHub noreply adresai sujungti tik tada, kai juose užkoduota ta pati paskyra, atmestos 29 botų, agentų, tarnybinės ir rezervinės tapatybės, o įprasti el. pašto adresai nesujungti vien dėl sutampančių rodomų vardų. 2026-08-24 audito metu paskelbti 639; pakartotinai pritaikius šį metodą to audito bazei ac02c5b42f, gaunami 619, todėl padidėjimą lėmė nauji bendraautoriai, o ne ne tokia griežta metodika. ### Kaip prisidėti 1. Sukurkite saugyklos šaką 2. Sukurkite šaką nuo **aktyvios** `release/vX.Y.Z` viršūnės (ne nuo `main`) — žr. [Šakojimo ir leidimų modelį](docs/ops/BRANCHING_MODEL.md) 3. Sukurkite funkcijos šaką (`git checkout -b feat/amazing-feature`) 4. Įrašykite savo pakeitimus (`git commit -m 'feat: add amazing feature'`) 5. Išsiųskite pakeitimus į šaką (`git push origin feat/amazing-feature`) 6. Atidarykite „Pull Request“, kurio **base = ta `release/vX.Y.Z` šaka** Išsamias gaires rasite faile [CONTRIBUTING.md](CONTRIBUTING.md). ### Naujos versijos išleidimas ```bash # Sukurkite leidimą — npm publish įvykdomas automatiškai VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```
## 📊 Žvaigždutės Žvaigždučių istorijos diagrama
## 🌍 StarMapper StarMapper

## 🙏 Padėkos
OmniRoute remiasi milžinų pečiais. Jis pradėtas kaip **[9router](https://github.com/decolua/9router)** šaka ir Go projekto **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** perkėlimas į TypeScript — o nuo tada kiekvienas toliau nurodytas posistemis buvo įkvėptas atvirojo kodo projekto, kuris tai įgyvendino pirmas. Kiekvienas iš jų suformavo konkrečią OmniRoute dalį. Tai mūsų padėka jiems visiems. 🙏 > ⭐ žvaigždučių skaičius patikrintas naudojant GitHub REST API 2026 m. lapkričio 3 d. — suteikite šiems projektams žvaigždutę. Skaičiai yra tikslus konkrečios datos momentinis vaizdas ir natūraliai keisis. ### 🧬 Kilmė ir šliuzas
Projektas⭐Kaip jis įkvėpė OmniRoute
9router31,861Pradinis projektas, kurio pagrindu sukurta ši šaka — čia išplėstas daugiarūšėmis API ir visiškai perrašytas naudojant TypeScript.
CLIProxyAPI57,329Go realizacija, įkvėpusi šį perkėlimą į JavaScript / TypeScript.
LiteLLM62,580AI šliuzas, kurio viešas kainų duomenų rinkinys naudojamas mūsų išlaidų sekimo sinchronizavimui, o tiekėjų normalizavimo modelis padėjo sukurti mūsų maršrutizavimą.
codex-chatgpt-web15,435MIT šaltinis, pritaikytas į rinkinyje pateikiamą ChatGPT Web → Codex Responses sąsają, įskaitant naršyklės seanso, atsakymų įrėminimo, naudojimo ir žiniatinklio paieškos adapterius.
free-claude-code65,966Šablonai perkelti į srauto atkūrimą, no-thinking pseudonimus, atsarginę žiniatinklio paiešką, slankiojo lango apribojimus, žurnalų redagavimą ir sustiprintus paleidimo procesus.
composer-api347Cursor Composer įrankio pasirinkimo, išvesties apribojimo ir įrankio patvirtinimo šablonai pritaikyti vietiniame Cursor vykdiklyje.
codex-multi-auth561Naujo prisijungimo ir atnaujinimo atpažinimo žetono rotacijos šablonai perkelti į Codex OAuth pakartotinį autentifikavimą.
opencode-anthropic-auth562Su Claude Code suderinami transformavimo numatytieji nustatymai ir atsiskaitymo antraštės elgsena apibendrinti į OmniRoute konfigūracija grindžiamą sąsają.
grok2api-merged2Jo Grok modelių susiejimai, netikras TypeError Statsig generatorius, užklausų ir įrenginio numatytieji nustatymai bei NDJSON atsakymų procesorius buvo reikšmingai pritaikyti OmniRoute Grok Web vykdiklyje.
TQZHR/grok2api707Pagrindinis tranzityvus kodo šaltinis, kuriuo remiasi grok2api-merged; jo modelio, antraščių, naudingosios apkrovos, Statsig ir procesoriaus realizacijos išsaugotos Grok Web kilmės grandinėje.
chenyme/grok2api7,874Pagrindinis MIT šaltinis, iš kurio perimti Grok naudingosios apkrovos ir įrenginio numatytieji nustatymai, Statsig generatorius ir result.response procesorius, perduoti per TQZHR ir grok2api-merged.
grok2api-pro27Tranzityvus šaltinis, kurį grok2api-merged nurodo kaip savo tarpinio serverių telkinio sluoksnio šaltinį; OmniRoute išsaugo šį kilmės pranešimą, tačiau nepretenduoja į tarpinio serverių telkinio perkėlimą savo ribotos apimties Grok Web vykdiklyje.
GrokProxy52Jo slapukais autentifikuojamas Grok tarpinis serveris ir result.response.token srautinio perdavimo šablonas padėjo sukurti OmniRoute Grok Web transportą.
GrokBridge5Naudojantis jo HTTP / naršyklės pirminio serverio dizainu buvo konsultuojamasi kuriant pradinę Grok Web realizaciją; jo tiesioginis HTTP kelias kildinamas iš GrokProxy, todėl nepriklausomas kodo perkėlimas nepriskiriamas.
### 🗜️ Konteksto ir žetonų glaudinimas — varikliai
Projektas⭐Kaip jis įkvėpė OmniRoute
Caveman116,957Virusinis projektas „why use many token when few token do trick“ — jo urvinio žmogaus kalbos filosofija yra mūsų standartinio glaudinimo režimo ir daugiau nei 30 užpildų bei kondensavimo taisyklių pagrindas.
RTK – Rust Token Killer85,350Didelio našumo komandų išvesties glaudinimas — įkvėpė mūsų RTK variklį, JSON filtravimo DSL, neapdorotos išvesties atkūrimą ir sujungtą RTK → Caveman konvejerį.
headroom78,672Grįžtamasis konteksto glaudinimas (SmartCrusher) — įkvėpė mūsų headroom variklį ir ccr atkūrimo žymeklio šabloną.
LLMLingua6,797Užklausų glaudinimo tyrimai (LLMLingua / LLMLingua-2) — įkvėpė mūsų asinchroninį, kodui saugų, atvirai nesėkmę toleruojantį llmlingua variklį.
llmlingua-2-js33JS/ONNX prievadas (MobileBERT / XLM-RoBERTa), naudojamas kaip mūsų LLMLingua variklio darbinės gijos vidinė sistema.
Troglodita50PT-BR žetonų glaudinimas — suteikia galią mūsų pt-BR kalbos paketui: pasikartojimų mažinimui ir užpildų šalinimui, pritaikytam Brazilijos portugalų kalbos gramatikai.
ponytail182,929Virusinis „tingaus vyresniojo programuotojo“ YAGNI programuotojo įgūdis — įkvėpė mūsų less-code išvesties stilių: mažiausio veikiančio pakeitimo kryptingumas, mažinantis _sugeneruotą_ kodą (išvesties ašies atitikmuo Caveman glaustai prozai).
i-have-adhd59,838Jo veiksmais grindžiamas, ADHD turintiems žmonėms pritaikytas atsakymų stilius buvo pritaikytas prie glausto OmniRoute išvesties stiliaus penkiomis kalbomis.
### 🧩 Kompaktiški formatai, žetonų tyrimai ir kodą suprantantys įrankiai
Projektas⭐Kaip jis įkvėpė OmniRoute
TOON25,602Į žetonus orientuotas objektų žymėjimas — jo stulpelinis, antraštės ir eilučių modelis suformavo mūsų lentelių kondensavimo etapą.
GCF – Graph Compact Format61Jo kompaktiškas grafų formatas ir bendrojo profilio dizainas suteikė informacijos OmniRoute lentelių kondensavimui ir Headroom kodeko formatui.
gcf-typescript4MIT TypeScript realizacija, tiesiogiai įtraukta į kodą ir išplėsta kaip Headroom bendrojo profilio kodekas.
token-optimizer-mcp566Brotli/SQLite podėlis ir kiekvienos sesijos konteksto pokytis — įkvėpė mūsų session-dedup variklį.
token-savior1,203Bash išvesties kondensavimas ir MCP profiliai — įkvėpė mūsų glaudinimo atsisakymo discipliną ir MCP įrankių manifesto mažinimą.
token-saver162Turinį suprantantis, kiekvienam failo tipui pritaikytas išvesties glaudinimas su nesėkmes atpažįstančiu atsisakymu — patvirtino mūsų paskirstymą pagal tipą ir praleidimą, kai nauda minimali.
token-optimizer2,853„Raskite vaiduokliškus žetonus“ — jo perkėlimo ir atkuriamos rankenos šablonas suteikė informacijos mūsų CCR perkėlimo idėjoms.
TokenMizer34Sesijos grafiko ir eilučių dublikatų šalinimo tarp pokalbio eilučių planas, suteikęs informacijos mūsų session-dedup dizainui.
OmniCompress3Rust stulpelinis JSON, pagal turinį adresuojamas atkūrimas ir dublikatų šalinimas tarp pranešimų — patvirtino mūsų headroom/ccr/session-dedup variklių dizainą ir podėliui stabilų invariantą „suglaudinta forma nepriklauso nuo pozicijos“.
mcp-compressor140MCP įrankių schemų ir aprašų glaudinimas — suteikė informacijos mūsų MCP įrankių manifesto kardinalumo mažinimui.
RepoMapper218Aider stiliaus saugyklos žemėlapio reitingavimas — suteikė informacijos mūsų saugyklos žemėlapio ir išgavimo reitingavimo tyrimams.
quiet-shell-mcp4Deklaratyvus apvalkalo išvesties mažinimas per MCP — patvirtino mūsų deklaratyvų Bash išvesties kondensavimą.
ts-morph6,222TypeScript kompiliatoriaus API įrankių rinkinys — įkvėpė mūsų analizatoriumi grindžiamą komentarų šalinimą, išsaugantį eilučių, šabloninius ir reguliariųjų išraiškų literalus.
### 🧠 Atmintis ir RAG
Projektas⭐Kaip jis įkvėpė OmniRoute
Mem068,294Universali atminties sritis — jos tarpinio serverio, kaip rašymo / skaitymo ribos, modelis suformavo mūsų atminties architektūrą.
Letta (MemGPT)25,321Agentiškos sistemos su būsena ir hierarchine atmintimi — įkvėpė mūsų Context Control & Recovery (CCR) hierarchinį modelį.
WFGY1,804ProblemMap 16 pasikartojančių RAG/LLM trikčių taksonomija — bendra terminija mūsų trikčių šalinimo vadove.
### 🛰️ Srauto tikrinimas, MITM ir skaidrus tarpinis serveris
Projektas⭐Kaip jis įkvėpė OmniRoute
llm-interceptor81Kodavimo asistento ↔ LLM srauto MITM perėmimas ir analizė padėjo apibrėžti ankstyvuosius Traffic Inspector reikalavimus. Keturi anksčiau išvesti moduliai — SSE sujungimas, pokalbių normalizavimas, paslapčių maskavimas ir antraščių sanitarizavimas — pakeisti nepriklausomomis švariojo kambario realizacijomis, pagrįstomis viešaisiais protokolų standartais. Du pagrindinio kompiuterio praleidimo paviršiai (passthrough.ts ir _internal/bypass.cjs) lieka OmniRoute vidinėmis realizacijomis, klasifikuojamomis atskirai; jie nebuvo perrašyti kaip šio pakeitimo dalis.
ProxyBridge6,978Skaidrus kiekvieno proceso tarpinio serverio maršrutizavimas — įkvėpė mūsų nuo strigčių apsaugotą MITM išjungimą, lizdų neveiklos skirtuosius laikmačius, procesų priskyrimą pagal /proc ir TPROXY fiksavimą.
### 📚 Modelių duomenys, stebimumas ir UI
Projektas⭐Kaip jis įkvėpė OmniRoute
models.dev7,486Atvira AI modelių specifikacijų, kainų ir galimybių duomenų bazė — savaime sinchronizuojama su mūsų modelių katalogu.
React Flow / xyflow38,874Mazgo pagrindu sukurta grafų biblioteka, valdanti mūsų realiojo laiko Compression Studio ir Combo/Routing Studio.
LangGraph44,349LangGraph Studio tiesioginė darbo eigos grafų vizualizacija įkvėpė mūsų Studios realiojo laiko kaskados rodinį.
Langfuse36,907Jo trace → span → generation stebimumo modelis suformavo mūsų Compression Studio krioklio vaizdą.
Kiali3,647Istio paslaugų tinklo stebimumas — įkvėpė mūsų grandinės pertraukiklio ženklelius ir klaidų briaunų vaizdavimą Routing/Combo Studio.
lobe-icons2,666AI/LLM prekių ženklų logotipai, atvaizduojantys tiekėjų piktogramas visoje mūsų valdymo skydelyje.
flag-icons12,499Teikia pagal MIT licenciją platinamas SVG vėliavas, naudojamas README kalbos parinkiklyje.
### 🛡️ Saugumas
Projektas⭐Kaip jis įkvėpė OmniRoute
awesome-secure-defaults723Kruopščiai atrinktas saugiųjų numatytųjų nustatymų bibliotekų sąrašas, padedantis pasirinkti mūsų saugumo sprendimus (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
### 🧭 Papildomi įrankiai
Projektas⭐Kaip jis įkvėpė OmniRoute
ClawRouter6,649Įkvėpė užklausų dublikatų šalinimą, avarinį nemokamą atsarginį variantą, prijungiamas Auto-Combo strategijas ir daugiakalbį ketinimų klasifikavimą.
Antigravity-Manager32,785Jo paskyras atpažįstantis modelių peradresavimas, vykdomųjų failų kelių tikrinimas ir plano etiketės elgsena padėjo suformuoti OmniRoute Antigravity vykdymo aplinką.
vscode-antigravity-cockpit4,852Jo glaustas kvotos atkūrimo atgalinio skaičiavimo formatas įkvėpė atitinkamą tiekėjo limito rodinį OmniRoute.
AionUi33,996Jo ACP integracijos įkvėpė automatinį OmniRoute įdiegtų CLI agentų aptikimą.
CodexBar22,955Nustatė Grok Build kvotos paviršių; vėliau OmniRoute nepriklausomai patikrino ir ištaisė aktyvųjį laidinio protokolo formatą.
## 📄 Licencija MIT licencija – daugiau informacijos rasite [LICENSE](LICENSE). ---
**[⬆ Grįžti į viršų](#-omniroute)** · Sukurta ❤️ atvirojo kodo DI bendruomenei. Sukūrė Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT licencija · omniroute.online