# 🚀 OmniRoute — Bezmaksas MI vārteja
**Radījis [Diego Souza](https://github.com/diegosouzapw)**
## 💰 ~1,62 miljardi marķieru mēnesī trešo pušu bezmaksas plānos
> **Izmantojiet savus pakalpojumu sniedzēju kontus.** Šis ir aptuvens kopsavilkums par atsevišķi pieejamiem trešo pušu bezmaksas plāniem, nevis OmniRoute piešķirts marķieru apjoms. Reģistrējieties, iegūstiet nepieciešamos akreditācijas datus un pievienojiet izmantojamos pakalpojumu sniedzējus; katrs pakalpojumu sniedzējs pats nosaka savus ierobežojumus, pieejamību un lietošanas noteikumus.
>
> Manuāla bezmaksas plānu apvienošana ir apgrūtinoša — desmitiem SDK, desmitiem ātruma ierobežojumu un nav skaidrs, cik daudz jums patiesībā ir pieejams. OmniRoute apkopo **465 bezmaksas plānu ierakstus 34 atkārtoti izmantotās kopu atslēgās** un aprēķina kopējo marķieru apjomu no **17 kopām ar publicētu pozitīvu mēneša budžetu, kā arī pieciem katram modelim paredzētiem Groq ierobežojumiem**, novēršot dublēšanos pēc koplietotās kopas. Kvotas, kas kļūst pieejamas tikai pēc reģionālās identitātes pārbaudes (šobrīd: ModelScope), tiek uzrādītas atsevišķi — +~6 miljoni pēc reģionālās identitātes verifikācijas — un nekad netiek pieskaitītas kopējam apjomam. Rezultāts joprojām ir redzams informācijas panelī (`/dashboard/free-tiers`).
> Animēts tiešraides `/dashboard/free-tiers` lapas kopsavilkums. Pilna metodoloģija (kopu deduplicēšana, kredītu līmeņi, pakalpojumu sniedzēju noteikumi): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Šie skaitļi tiek atkārtoti pārbaudīti ik pēc divām nedēļām, salīdzinot ar aktuālo katalogu, un **mainās abos virzienos** — pakalpojumu sniedzējs pārtrauc bezmaksas plānu, un skaitlis samazinās; tiek pievienots jauns, un tas palielinās. Mēs publicējam to, ko katalogs faktiski aprēķina, nevis noapaļotu labākā gadījuma aplēsi.
⭐ Ja OMNIROUTE palīdzēja jums ietaupīt naudu un atvieglot darbu, piešķiriet repozitorijam zvaigznīti.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Pievienojieties kopienai
**👋 Sekojiet uzturētājam — vispirms uzziniet par jauniem pakalpojumu sniedzējiem, laidieniem un padomiem:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Jautājumi, padomi par pakalpojumu sniedzējiem, ceļvedis un atbalsts → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Vārteja turpina augt
## 🆓 Instalējiet, pievienojiet pakalpojumu sniedzēju un pēc tam maršrutējiet, izmantojot vienu galapunktu
```bash
# Pēc pakalpojumu sniedzēja pievienošanas nokopējiet savu OmniRoute atslēgu no 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` ir nepieciešams piemērots maršruts. Tīrā instalācijā var nebūt neviena piemērota mērķa, kas darbotos bez atslēgas, un pakalpojumu sniedzējs, kas darbojas bez atslēgas, var noraidīt trešo pušu klientus. Pakalpojumu sniedzēji, kas atzīmēti ar `tos: avoid`, tostarp Kiro, pēc noklusējuma ir izslēgti no automātiskās maršrutēšanas; konta pievienošana šo iestatījumu nemaina. Pirms pakalpojumu sniedzēja izvēles skatiet [Bezmaksas līmeņu ceļvedi](docs/getting-started/FREE-TIERS-GUIDE.md).📦 Ātrās darba sākšanas skripti, ko var kopēt un ielīmēt, paredzēti **Python, Node.js, PHP un cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Solījums
# 🤔 Kāpēc OmniRoute?
## 🤝 Atbalsta mūsu atvērtā koda draugi
> **Vēlaties pievienoties kā atvērtā koda draugs?** Šie ir uzņēmumi, kas atbalsta atvērto kodu un palīdz OmniRoute darboties — un mēs publiski paziņojam, kur nonāk katrs viņu mums iedotais žetons. Sazinieties: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Pateicoties Kimi (Moonshot AI), mūsu dibinātājam atvērtā koda draugam, par šī projekta atbalstu! Kimi ir AI laboratorija, kas izstrādājusi atvērtā svara K2 un K3 modeļu saimes — Kimi K3 nodrošina 1M žetonu konteksta logu, vietējo redzi un robežlīmeņa kodēšanu par daļu no slēgto modeļu cenām, un darbojas uzreiz ar Claude Code, Codex un katru kodēšanas rīku, ko OmniRoute apkalpo.
Ko Kimi atbalsts nodrošina: Kimi API kredīti nodrošina OmniRoute AI validēto izlaišanas cauruļvadu — posmu sapludināšanas validācija, ko nodrošina Kimi K3, kas pārskata katru pieprasījumu pirms tā izlaišanas — kā arī ikdienas funkciju izstrādi. Pirmklasīgs Kimi atbalsts tiek piegādāts abos veidos: tiešais Kimi API (kimi-k3) un Kimi Code kodēšanas plāns (OAuth un API atslēga). OmniRoute ir arī pirmais Brazīlijas atvērtā koda projekts Kimi atbalsta programmā. Iegūstiet Kimi API atslēgu ar 15% papildu kredītiem →
Cheaper Inference cheaperinference.com
Pateicoties Cheaper Inference, OmniRoute atvērtā koda draugam, par šī projekta atbalstu! Cheaper Inference ir izmaksu ziņā rangēts vārteja, kas pārdod 42 robežmodeļus — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok un MiniMax — aiz viena OpenAI-saderīga galapunkta, novirzot katru pieprasījumu uz lētāko piemēroto pakalpojumu sniedzēju, nekad neiekasējot vairāk par modeļa ražotāja saraksta cenu.
Pirmklasīgs atbalsts OmniRoute: Tērzēšanas pabeigšana (Chat Completions), vietējais /v1/responses galapunkts, redze, rīku izsaukšana un 3 attēlu modeļi (grok-imagine, nano-banana-pro, nano-banana-2, sasniedzami kā cheaperinference/<model>). Iegūstiet API atslēgu →
Saites, kas marķētas ar aff=omniroute, ir partneru saites. Tās finansē projektu bez papildu izmaksām jums. 🎟️ Filiāļu akcija — bezmaksas reģistrācijas kuponi no pakalpojumu sniedzējiem, kurus mēs nesponsorējam (noklikšķiniet, lai izvērstu)Šī sadaļa ir paredzēta tikai novirzīšanas/kuponu kodiem. Sponsorētas partnerības ir atrodamas sadaļā 🤝 Atbalsta mūsu atvērtā koda draugi augstāk. OmniRoute nav sponsorēšanas vai partnerības ar šeit uzskaitītajiem pakalpojumu sniedzējiem — tie ir publiski kuponi, ko var izmantot ikviens.
AgentRouter agentrouter.org
AgentRouter — filiāles reģistrācija · $100 bezmaksas kredīti reģistrējoties (bezmaksas serveris, sagaidāma lielāka latentums — vislabāk testēšanai, nevis ražošanai). Pirmklasīgs atbalsts OmniRoute kopš v3.8.50: Tērzēšanas pabeigšana (Chat Completions), Anthropic-saderīgs vadu formāts un OpenAI-saderīgs ceļš. Pieejamie modeļi ietver claude-opus-4-8, claude-opus-5, gpt-5.6-sol un citus. Paņemiet savus $100 →
⚠️ Filiāles saite — OmniRoute nav sponsorēšanas vai partnerības ar šo pakalpojumu sniedzēju.
Zināt citu pakalpojumu sniedzēju ar dāsnu bezmaksas reģistrācijas kuponu, kas nāk par labu OmniRoute lietotājiem? Atveriet problēmu, un mēs to pievienosim šeit.
## 🎯 Kombinācijas — flagmanis
> **Kombinācija** ir modeļu ķēde, starp kuriem OmniRoute maršrutē **automātiski**. Ja kvota ir izsmelta, pakalpojumu sniedzējs pārstāj darboties vai izmaksas strauji pieaug, kombinācija var pāriet uz nākamo piemēroto un darbspējīgo modeli. 🛡️
### ⚡ Bez konfigurēšanas — vienkārši izmantojiet `auto`
Kombinācija nav jāizveido. Iestatiet modeli uz `auto` (vai kādu tā variantu), un OmniRoute no jūsu pievienotajiem pakalpojumu sniedzējiem izveidos virtuālu kombināciju, kas tiek novērtēta reāllaikā:
Modeļa ID
Kam tas ir optimizēts
auto
🎯 Līdzsvarots noklusējums (LKGP — turpina izmantot pēdējo veiksmīgo pakalpojumu sniedzēju)
auto/coding
🧑💻 Koda ģenerēšanai paredzēti svari, kuros prioritāte ir kvalitātei
auto/fast
⚡ Vispirms vismazākais latentums
auto/cheap
💰 Vispirms viszemākā maksa par tokenu
auto/subscription
🎟️ Tikai abonementa kvota, par kuru jau maksājat — kļūmes gadījumā darbība tiek pārtraukta, nekad nepārejot uz maksas rezerves variantu (ceļvedis)
auto/thrifty
🪜 Vispirms plāna kvota, pēc tam pa vienam pakāpienam līdz lētākajām maksas iespējām — pēc plāna atiestatīšanas atgriežas pie tā (ceļvedis)
auto/offline
🔋 Vispirms lielākā kvotas / ātruma ierobežojuma rezerve
auto/smart
🔭 Prioritāte kvalitātei + 10% izpētei, lai atrastu labākus modeļus
auto/lkgp
📌 Nepārprotama piesaiste pēdējam zināmajam veiksmīgajam pakalpojumu sniedzējam
auto/chaos
🧪 Paralēla pieprasījumu nosūtīšana modeļu panelim (pa vienam no katra pakalpojumu sniedzēja, pēc noklusējuma 5), atgriežot vienu atbildi; viens ārējais izsaukums katram paneļa modelim, nevis kļūmju injicēšana
##
### 🔀 Vai izveidojiet savu — 20 maršrutēšanas stratēģijas
Visas **20** stratēģijas — kombinējiet tās katrā kombinācijas solī:
#
Stratēģija
Ko tā dara
1
priority
Sakārtots saraksts ar pirmā mērķa prioritāti — izsmeliet katru pirms pāriešanas pie nākamā 🥇
2
fill-first
Pirms pāriešanas pie nākamā mērķa pilnībā izmantojiet katra mērķa kvotu
3
weighted
Nejauša svērtā atlase pēc katra mērķa svara
4
round-robin
Cikliski izmanto mērķus norādītajā secībā
5
p2c
Nejauša slodzes līdzsvarošana ar divu izvēļu metodi
6
least-used
Izvēlas mērķi ar pašreizējo vismazāko slodzi
7
random
Vienmērīgi nejauša izvēle (bez dublikātiem)
8
strict-random
Nejauša izvēle, nenoņemot atkārtojumus 🎲
9
cost-optimized
Samazina izmaksas $ par pieprasījumu, izmantojot aktuālās kataloga cenas 💸
10
headroom
Izvēlas mērķi ar vislielāko atlikušo kvotu
11
quota-weighted
Izlaiž kontus ar izsmeltu kvotu un pēc tam veic atlasi proporcionāli atlikušajai kvotai ÷ izpildē esošajai slodzei — esošās sarunas paliek piesaistītas ⚖️
12
reset-window
Dod priekšroku mērķim, kura kvotas logs tiks atiestatīts visdrīzāk
13
reset-aware
Sarindo pēc kvotas atiestatīšanas laika — īsākie logi vispirms 📊
14
context-relay
Nodod kontekstu starp mērķiem ilgām sarunām 🧠
15
context-optimized
Izvēlas pašreizējam konteksta apjomam vispiemērotāko mērķi
16
cache-optimized
Piesaista katru atkārtoti izmantojamo uzvednes prefiksu vienam un tam pašam kontam — maksimāli palielina uzvedņu kešatmiņas trāpījumu skaitu 🎯
17
lkgp
Pēdējais zināmais veiksmīgais ceļš — piesaista pēdējam veiksmīgajam pakalpojumu sniedzējam un pēc tam atkāpjas uz noteikumiem
18
auto
16 faktoru reāllaika vērtēšana visiem savienojumiem 🤖
19
fusion
Nosūta pieprasījumus modeļu panelim, un vērtētājs sintezē vienu atbildi 🧬
20
pipeline
Sasaista soļus ķēdē — katra mērķa izvade tiek padota nākamajam 🔗
Auto-Combo dzinis novērtē katru kandidātu pēc **16 faktoriem** (darbspēja, kvota, izmaksas, latentums, piemērotība uzdevumam, kvalitāte, sesijas pieejamība…) — skatiet [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Noturība ir iebūvēta (3 neatkarīgi slāņi)
📖 [Auto-Combo dzinis](docs/routing/AUTO-COMBO.md) · [Noturības rokasgrāmata](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Ar ko OmniRoute atšķiras
📊 Pilna metodoloģija un detalizēts salīdzinājums par katru funkciju ar 9router, OpenRouter, CLIProxyAPI un LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Atbalstiet OmniRoute
OmniRoute ir licencēts ar MIT licenci un tiek atklāti uzturēts. Ja tas ietaupa jūsu laiku vai naudu, lūk, kā varat palīdzēt tam saglabāt neatkarību — izvēlieties sev piemērotāko veidu. Sponsorēšana nekad neietekmē maršrutēšanas prioritāti; tā nodrošina redzamību, nevis augstāku vietu.
**🇧🇷 PIX** — tūlītēji, bez komisijas maksas (Brazīlija)
Atslēga (nejauši ģenerēta): `5d865059-bc44-483a-962d-43ceb80126eb`
Kopējamais un ielīmējamais Pix kods:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ Kriptovalūta — BTC · ETH · USDT-TRC20 · USDC-Solana (noklikšķiniet, lai izvērstu)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Katru kriptovalūtu sūtiet tikai norādītajā tīklā — sūtot nepareizajā tīklā, līdzekļi var tikt zaudēti.
🐛 Atrasta kļūda vai vēlaties sniegt atsauksmes? Atveriet [diskusiju](https://github.com/diegosouzapw/OmniRoute/discussions).
Piezīmes izstrādātājiem: Izstrādātāju ērtībai projekts npm instalēšanas vai pēcinstalēšanas laikā var ģenerēt lokālu .env failu. Šis fails ar nolūku tiek ignorēts, izmantojot .gitignore (skatiet .gitignore), un to nekad nedrīkst iekļaut komitā — ja tas nejauši ir iekļauts komitā, nomainiet visus atklātos noslēpumus un izņemiet failu no vēstures. Norādījumus par lokālo vides failu un noslēpumu pārvaldību skatiet dokumentā docs/DEVELOPER-ENVIRONMENT.md.
## 📡 OmniRoute Radar
Galvenais bezmaksas līmeņa rādītājs joprojām ir **~1.62B marķieru mēnesī** no iepriekš dokumentētā kataloga, kurā koplietojamie resursi ir uzskaitīti tikai vienreiz. Pagaidu pakalpojumu sniedzēju reģistrācijas kredīti pirmajā mēnesī šo apjomu var atsevišķi palielināt līdz **~2.22B**. Radar ir neobligāts, parakstīts kataloga pārklājums lietotājiem, kuri vēlas aktuālāku bezmaksas modeļu pieejamības informāciju starp OmniRoute laidieniem; kopienas katalogs un visas esošās bezmaksas funkcijas joprojām ir bez maksas.
Atbalstītāji var saņemt aktuālo katalogu un piekļuvi papildu pakalpojumu sniedzēju iespējām. Tā atsevišķais, mainīgais maksimālais apjoms ir **ne vairāk kā aptuveni 3B marķieru mēnesī** atkarībā no pakalpojumu sniedzēju pieejamības. Šis maksimālais apjoms netiek garantēts: pakalpojumu sniedzēji jebkurā laikā var mainīt kvotas, atbilstības prasības, modeļus vai reģionus.
Radar ir jāiespējo brīvprātīgi, un tas izmanto tikai GET pieprasījumus. OmniRoute klients neaugšupielādē uzvednes, datplūsmas datus, pakalpojumu sniedzēju konfigurāciju, lietojuma telemetriju vai lokālo paziņojumu noraidīšanas stāvokli. Uzziniet par atbilstības prasībām un aktuālo katalogu vietnē **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Kas jauns
> Jaunākie svarīgākie jaunumi no **v3.8.20 → v3.8.54**. Pilna vēsture pieejama [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ `quota-weighted` maršrutēšana** — 20. kombinētā stratēģija izlaiž izsmeltos kontus, pēc tam izvēlas no pārējiem proporcionāli atlikušajai kvotai ÷ aktīvo pieprasījumu slodzei, saglabājot esošo sarunu piesaisti. → [Automātiskās kombinācijas](docs/routing/AUTO-COMBO.md)
- **🧰 Bezekrāna režīms** — `omniroute serve --headless` (vai `OMNIROUTE_HEADLESS=1`) palaiž tikai `/v1/*` starpniekservera dzini, izslēdzot informācijas paneli un tikai informācijas panelim paredzētās apakšsistēmas. → [Bezekrāna režīms](docs/guides/HEADLESS.md)
- **🔎 Modeļu atklāšana** — `/v1/models` filtrē pēc iespējām, konteksta, veida un teksta, bet `POST /v1/models/query` atgriež īsu deterministisku kandidātu sarakstu ar tādu pašu katrai atslēgai piemērojamu redzamību. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🔑 Maršrutēšanas vadība katrai atslēgai** — piesaistiet API atslēgu vienam modelim vai kombinācijai ar `forcedModel` un atomiski pievienojiet vai noņemiet atslēgai pieejamos modeļus un kombinācijas (`/api/keys/{id}/access`). → [API atsauce](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Precīzāka PII vadība** — atlase pēc veida, līdz 20 validētiem pielāgotiem maskēšanas paraugiem un noteikšanas skaitītāji katram veidam; pati maskēšana joprojām ir jāiespējo atsevišķi. → [Aizsargmehānismi](docs/security/GUARDRAILS.md)
- **🌍 67 valodas** — informācijas panelis, dokumentācijas spoguļkopijas un CLI, bet `npm run i18n:add-locale` pievieno valodu visur ar vienu komandu. → [i18n ceļvedis](docs/guides/I18N.md)
- **🎛️ OmniConductor** — ienākoša A2A deleģēšana jūsu aģentu saimei, Conductor prasmes Agent Card un informācijas paneļa sadaļa ar Faro rācijsaziņas balss tērzēšanu. → [A2A serveris](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptīva pieprasījumu pieņemšana un pārslodzes aizsardzība** — smagie tērzēšanas pieprasījumi tiek ievietoti rindā, nevis atgriež 503 kļūdu, izmantojot atomiskas RPM slīdošās nomas katram savienojumam. → [Noturības ceļvedis](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanoniska `/v1/models` secība** — viens nepārtraukts, pēc pakalpojumu sniedzēja grupēts bloks katram pakalpojumu sniedzējam (kombinācijas vispirms), kas ir stabils visos katalogu avotos. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🗜️ Kompresijas nostiprināšana** — pēc noklusējuma ieslēgts izvēršanas aizsargs, Caveman pakotnes DE / FR / JA un ķīniešu (wényán) valodai, RTK filtri Gradle un .NET. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Godīgas fiksētas likmes izmaksas** — abonementu un programmēšanas plānu pakalpojumu sniedzēji izmaksu analītikā tiek uzrādīti kā **$0**; budžeta, kvotu un maršrutēšanas aprēķini turpina darboties. → [API atsauce](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share maršrutēšana** — koplietota konta kvota tiek godīgi sadalīta starp apvienotajām atslēgām; sistēma izmanto pieejamos resursus, aizdodot neaktīvās daļas. → [Noturības ceļvedis](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 CLI/aģentu iestatīšana ar vienu komandu** — 15 reģistrētas `setup-*` komandas; `omniroute run` palaiž 7 CLI rīkus (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` atbalsta 11 mērķus ar interaktīvu pakalpojumu sniedzēja un modeļa izvēli, kā arī kontekstam specifiskiem favorītiem. → [CLI integrācijas](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Attālais režīms** — vadiet attālu OmniRoute ar ierobežotas darbības tvēruma marķieriem (`connect` / `contexts` / `tokens`) un `antigravity` OAuth palīgu VPS instalācijām. → [Attālais režīms](docs/guides/REMOTE-MODE.md)
- **🧭 Viedāka automātiskā maršrutēšana** — `auto/:` kombinācijas, **Fusion** (modeļu panelis + vērtētājs), uzdevumam pielāgota maršrutēšana, kā arī katram pieprasījumam atsevišķi modeļa / režīma / USD budžeta aizstājēji. → [Automātiskās kombinācijas](docs/routing/AUTO-COMBO.md)
- **🗜️ Pieslēdzama kompresija** — 12 kombinējami dziņi un Compression Studios: LLMLingua-2, divu līmeņu Ultra, omniglyph, precizitātes vārteja katram solim, GCF v3.2, vilkšanas un nomešanas redaktors. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Caurspīdīga MITM atšifrēšana (TPROXY)** — uztveršanas CLI rīkiem, kuri ignorē starpniekservera vides mainīgos, ar CA katram SNI un uzticamības krātuves instalētāju. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Izmaksu telemetrija visur** — `X-OmniRoute-*` izmaksu/lietojuma galvenes katrā galapunktā, kešatmiņas HITS ietaupījumu galvene, kā arī USD tēriņu kvotas katrai atslēgai. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🧠 Jūsu kontrolēta atmiņa** — pēc noklusējuma izslēgta, ar iespēju ieslēgt int8 vektoru kvantēšanu un tipizētu noārdīšanos, kā arī izmantot `x-omniroute-no-memory` katram pieprasījumam. → [Atmiņa](docs/frameworks/MEMORY.md)
- **🛡️ Drošība** — uzvedņu ievades uzbrukumu aizsargs katrā LLM maršrutā (ar sarkanās komandas testu komplektu), pēc izvēles ieslēdzams akreditācijas datu maskēšanas aizsargmehānisms (rediģē noplūdušas API atslēgas/noslēpumus abos virzienos), bezmaksas DuckDuckGo tīmekļa meklēšana kā pēdējais risinājums un pēc izvēles ieslēdzama OIDC pieteikšanās barjera informācijas panelim (pieteikšanās ar paroli vienmēr paliek pieejama). → [Aizsargmehānismi](docs/security/GUARDRAILS.md)
- **🖼️ Jauni galapunkti** — `/v1/ocr` (Mistral OCR) un `/v1/audio/translations` (Whisper stila) papildina multivides iespēju klāstu. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🎨 Attēlu / video / audio ģenerēšana** — viena API multividei: xAI Grok Imagine un Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind un runas pakalpojumu sniedzēji, piemēram, ElevenLabs. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🌍 Izvietošana un darbība** — reversā starpniekservera `basePath`, automātiska pārlūkprogrammas valodas noteikšana, ierīču uzskaite katrai atslēgai, MITM uzticamība bez root tiesībām, zh-TW lokalizācija. → [Vide](docs/reference/ENVIRONMENT.md)
- **🤝 Vairāk pakalpojumu sniedzēju un aģentu** — mākoņa aģenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) ar pārlūkprogrammas un OAuth pieteikšanos, pirmās klases Ollama karte, Claude Opus 5 un Sonnet 5, oficiāla Kimi partnerība (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… un atjaunināts **388 pakalpojumu sniedzēja katalogs**. → [Pakalpojumu sniedzēji](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Maršrutēšanas pārredzamība** — katra atbilde ietver `X-OmniRoute-Decision` galveni, kas norāda to apkalpojušo stratēģiju/pakalpojumu sniedzēju/aizturi; jaunā `cache-optimized` kombinētā stratēģija un Auto-Combo `cacheAffinity` faktora maršruts atkārtotus pieprasījumus novirza atpakaļ uz savienojumu, kurā atrodas kešotais prefikss; tikai lasāms `/v1/auto-combo/{channel}/candidates` galapunkts atklāj `auto/*` kanāla aktuālo kandidātu kopu. → [Automātiskās kombinācijas](docs/routing/AUTO-COMBO.md)
- **⚡ Vietējā veiktspēja un infrastruktūra** — lokālais Redis ar vienu klikšķi, Cloudflare Workers / Deno Deploy releju izvietotāji, Bifrost un Mux kā uzraudzīti iegulti pakalpojumi. → [Iegultie pakalpojumi](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Arī komplektā** — spraudņu ietvars un tirgus, Omni/Agent/GitHub prasmju ietvari, Obsidian glabātuves integrācija (22 MCP rīki), ar OpenAI saderīgas Batch un Files API, semantiskā atbilžu kešatmiņa, spēļošana ar līderu tabulām, ACP aģentu atklāšana (15 iebūvēti aģenti), plānota žurnālu eksportēšana uz BigQuery, `auto/chaos` paralēla vairāku modeļu izkliedēšana, Telegram robota tilts, lietotnē iebūvēts versiju pārvaldnieks un LMArena-ELO bezmaksas pakalpojumu sniedzēju reitingi. → [Dokumentācija](docs/README.md)
## 🤖 Saderīgas CLI un kodēšanas aģenti
> Viena konfigurācija — `http://localhost:20128/v1` — un **katrs** AI IDE vai CLI darbojas ar bezmaksas un zemu izmaksu modeļiem.
**Palaidiet jebkuru atbalstīto CLI caur OmniRoute ar vienu komandu** — nav nepieciešami konfigurācijas faili,
akreditācijas dati tiek ievadīti katram procesam, Qwen/Gemini iegūst izolētu pagaidu mājas direktoriju:
```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"
# Vai izvēlieties nodrošinātāju+modeli interaktīvi un uzrakstiet rīka paša konfigurāciju:
omniroute configure codex # arī: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Katra komanda ievēro aktīvo attālināto kontekstu (`omniroute connect `), `--dry-run`
parāda precīzu vidi/argumentus pirms izpildes, un `--api-key-env NAME` pasargā slepenos datus no jūsu čaulas vēstures. → [CLI integrācijas](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 AI nodrošinātāji — 153 katalogā atzīmēti kā bezmaksas
> **388 reģistrēts nodrošinātājs** kanoniskajās tērzēšanas, multivides, meklēšanas, lokālajās, mākoņa aģentu un sistēmu kolekcijās, tostarp **153 ar `hasFree: true` atklāšanas metadatiem**. Tērzēšanas modeļu reģistrs aptver **239 nodrošinātājus / 3 059 atšķirīgus nodrošinātāja–modeļa pārus / 1 475 neapstrādātus modeļu ID**; atsevišķajā bezmaksas budžeta katalogā ir **471 rinda katram modelim**, **34 periodiski resursu pūli** un **52 periodiski / bez atslēgas pieejami nodrošinātāji, kas vienmēr ir bezmaksas**. Šie saucēji pēc būtības atšķiras; definīcijas un aprēķini, kuros pūli tiek uzskaitīti tikai vienreiz, ir pieejami sadaļās [Nodrošinātāju atsauce](docs/reference/PROVIDER_REFERENCE.md) un [Bezmaksas līmeņi](docs/reference/FREE_TIERS.md).
### 🏢 Katra nozīmīgākā laboratorija — izmantojot vienu galapunktu
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…un vēl vairāk nekā 350 — katra ikona tiek dinamiski ielādēta no informācijas paneļa nodrošinātāju kataloga. 📖 [Nodrošinātāju atsauce](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Vienmēr bez maksas — $0, karte nav nepieciešama
OpenCode Zen DeepSeek V4, Nemotron 3 Bez tokenu ierobežojuma
Kilo Code Automātiska maršrutēšana, Tencent Hy3 Bezmaksas uz visiem laikiem
Requesty GPT-OSS 120B, Nemotron Bezmaksas uz visiem laikiem
SiliconFlow DeepSeek V3.2 / R1 Bezmaksas līmenis
Z.AI GLM GLM-4.7 / 4.5-Flash Bezmaksas uz visiem laikiem
Baidu ERNIE ERNIE 4.0 Bezmaksas uz visiem laikiem
Qoder AI Qwen3-Max, Kimi-K2 Neierobežoti BEZ MAKSAS
Pollinations GPT, Llama, Claude Atslēga nav nepieciešama
Cloudflare AI Vairāk nekā 50 modeļu 10 tūkst. neironu dienā
NVIDIA NIM GLM, MiniMax ~40 RPM bez maksas
Cerebras GLM 4.7, GPT-OSS Vienreizējs $5 kredīts; nepieciešama karte
### 🧩 Jaunums: OmniRoute iekšā VS Code vietējā Copilot tērzēšana
> Nav jaunas sānjoslas, nav jaunas tērzēšanas UI — katrs OmniRoute modelis tiek rādīts tieši šeit**Copilot Tērzēšanas modeļu atlasītājs, kuru jau izmantojat** . Kopš VS koda 1.122 pakalpojumu sniedzēju modeļi darbojas bez GitHub pierakstīšanās vai Copilot abonementa — aģenta režīms, rīku izsaukšana un redze bez maksas.
Instalējiet** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** paplašinājumu, novirziet to uz savu OmniRoute serveri (pēc noklusējuma `localhost:20128`), pēc tam atveriet Copilot Chat → modeļu atlasītāju →** Pārvaldīt modeļus…** →**OmniRoute** .
No redaktora iekšpuses: atveriet** Paplašinājumi** apskatīt, meklēt** "OmniRoute"** , noklikšķiniet** Instalējiet** — darbojas vienādi abos veikalos. Avots, izdevumi un publicēšanas rokasgrāmata tiešraidē vietnē [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Kods Copilot Tērzēšanas ceļvedis](docs/guides/VSCODE-COPILOT.md) — iestatīšana, atlasītāja rādītā informācija, informācijas panelis cilnē, problēmu novēršana
### 🎩 Jaunums: OmniRouteTray — jūsu vārteja, kas atrodas izvēļņu joslā
> `omniroute serve` ir vislaimīgākais, kad tas vienmēr ir ieslēgts.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** pārvērš to par macOS izvēlņu joslas iestatīšanas un aizmirstības lietojumprogrammu: tā palaiž serveri, uztur to darbināmu pēc atkārtotas palaišanas, atjaunina to vietā un novieto jūsu reāllaika marķiera budžetu viena klikšķa attālumā —** neviens termināļa logs nav atstāts atvērts, nav `npm install -g omniroute` lai auklētu.**
Tas ir izveidots, izmantojot [Tauri v2](https://v2.tauri.app/) (Rust kodols, kas ir noapaļošanas kļūdas lielums), un tas nodrošina savu parakstīto Node 24 izpildlaiku un pārvalda lietotnei piederošu OmniRoute instalāciju, tāpēc tas nekad necīnās ar jūsu globālo `node`/`bun`. Tas** koplieto jūsu esošo `~/.omniroute/` konfigurāciju un datu bāzi** — tātad tas pats OmniRoute ko tu jau skrien, tikai ar cepuri galvā. 🎩
Ko tas dara
Kā
🟢 Pārrauga serveri
Izveido omniroute serve , pieņem jau darbojošu instanci, nevis to dublē
📊 Tiešsaistes lietojums īsumā
Pakalpojumu sniedzēja kvotu joslas, Claude session/weekly ierobežojumi ar atiestatītu atpakaļskaitīšanu, 30 dienu izmaksu sadalījums
🔄 Automātiskie atjauninājumi vietā
Pakāpeniska instalēšana, atomu maiņa, atcelšana kļūmes gadījumā — vienmēr jaunākajā versijā
🚀 Sākt, piesakoties
Izvēles palaišana pie pieteikšanās; tikai paplātei, nav doka ikonas
🩺 Doctor & žurnāli
diagnostika ar vienu klikšķi un servera žurnāla piekļuve
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Vai vēlaties lejupielādēt? Paņemiet jaunāko .dmg no
Izlaiž . Avots, problēmas un uzbūve
docs tiešraidē zoispag/omniroute-tray.
💛 @zoispag kopienas projekts — nevis oficiāls OmniRoute laidiens.
> Papildus serverim OmniRoute ir **pilnvērtīgs komandrindas vadības centrs** ar **vairāk nekā 80 komandām**, kā arī atvērti aģentu protokoli, lai MI aģents varētu to pārvaldīt **patstāvīgi**.
### ⌨️ Īsta CLI (ne tikai `start`)
```bash
omniroute # palaist vārteju un informācijas paneli (ports 20128)
omniroute chat # interaktīvs TUI tērzēšanas klients (slīpsvītras komandas: /model /combo /skill /memory)
omniroute setup # vednis pirmajai iestatīšanai
omniroute doctor # diagnosticēt pakalpojumu sniedzējus, portus un vietējās atkarības
```
### 🛰️ Attālais režīms — palaidiet CLI šeit, bet OmniRoute — VPS serverī
Vai OmniRoute darbojas serverī? Pārvaldiet to no sava klēpjdatora ar **to pašu CLI**. Vienreiz piesakieties
ar ierobežota tvēruma piekļuves pilnvaru; pēc tam katra komanda tiks izpildīta attālajā serverī.
```bash
omniroute connect 192.168.0.15 # parole → ierobežota tvēruma pilnvara, saglabāta kā konteksts
omniroute models # ← tiek izpildīts ATTĀLAJĀ serverī
omniroute configure codex # ← izvēlas attālu modeli, izveido lokālu Codex profilu
omniroute tokens create --name ci --scope read # izveido šaurāka tvēruma pilnvaras citām ierīcēm
omniroute contexts use default # ← pārslēdzas atpakaļ uz lokālo serveri
```
Pilnvaru tvērumi ir `read` / `write` / `admin`; maršruti, kas palaiž procesus, joprojām ir pieejami tikai atgriezeniskās cilpas saskarnē.
📖 [Attālais režīms](docs/guides/REMOTE-MODE.md)
### 🤝 Pievienojiet aģentu — un tas pats pārvaldīs OmniRoute
Padariet OmniRoute pieejamu, izmantojot **MCP**, **A2A**, **REST API**, **tīmekļa aizķeres** vai **attālo CLI** — jebkurš spējīgs aģents (vai jūsu pašu kods) iegūs piekļuvi visai vārtejai: maršrutēšanai, pakalpojumu sniedzējiem, kombinācijām, kešatmiņai, saspiešanai un atmiņai — autonomi. Tālāk norādītie HTTP galapunkti ir pieejami adresē `http://localhost:20128`.
Saskarne
Galapunkts / komanda
Pielietojums
🧰 MCP (stdio)
omniroute --mcp
Savienošanai ar Claude Desktop, Cursor vai jebkuru MCP klientu
🌊 MCP (HTTP)
/api/mcp/stream
Attālais MCP — 110 rīki, 33 tvērumi (piemērošana pēc izvēles), pilnīga audita vēsture
📡 MCP (SSE)
/api/mcp/sse
Straumēšanas MCP transports
🤝 A2A
/.well-known/agent.json
Saziņa starp aģentiem, JSON-RPC 2.0 + SSE, 6 prasmes
🌐 REST API
/v1/*
Saderīgs ar OpenAI — tērzēšana, iegulumi, attēli, audio, OCR
🔔 Tīmekļa aizķeres
/api/webhooks
Pieprasījumu / kvotu notikumu nosūtīšana uz Slack, Discord, Telegram vai jebkuru URL
🛰️ Attālais CLI
omniroute connect
Attālas instances pārvaldīšana ar ierobežota tvēruma piekļuves pilnvarām
```bash
# Nodrošiniet Claude Code pilnu OmniRoute rīku komplektu, izmantojot 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) · [Aģentu protokoli](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Automātiski ietaupiet 15–95% tokenu
### 📖 Kā tas darbojas — konveijers, arhitektūra un ietaupījumu aprēķins
Noklusējuma kombinācija izpilda `RTK → Caveman`. Kad abi darbojas ar vienu un to pašu rīka/konteksta saturu, ietaupījumi summējas:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Koda blokus, URL, JSON un strukturētos datus saglabāšanas dzinējs **vienmēr aizsargā**.
> **Kāpēc izmantot daudz tokenu, ja to pašu var panākt ar dažiem?** Katrs pieprasījums **caurskatāmi** iziet cauri OmniRoute saspiešanas konveijeram — bez izmaiņām klientā. Tagad tas ir **12 kombinējamu dzinēju kopums**, kas darbojas noteiktā secībā un tiek kombinēts katrai maršrutēšanas kombinācijai — balstoties uz [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) un [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) idejām.
### 🧱 12 dzinēju kopums
Dzinēji darbojas konveijera secībā; katru no tiem var neatkarīgi ieslēgt, izslēgt un konfigurēt katrai kombinācijai:
#
Dzinējs
Darbība
1
Session-Dedup
Noņem saturu, kas atkārtojas starp mijiedarbības reizēm (balstīts uz saturu, starp mijiedarbības reizēm)
2
CCR
Lielus blokus arhivē aiz izgūšanas marķieriem, kas pēc pieprasījuma tiek ielādēti
3
Lite
Atstarpju un attēlu URL saīsināšana (mazas aizkaves pamata režīms)
4
RTK
Vieda rīku rezultātu filtrēšana, dublikātu noņemšana un saīsināšana (ņemot vērā komandas)
5
Responses Tool Output
Vispirms bezzudumu JSON un ierobežota diagnostikas saspiešana čaulas, labojumu, meklēšanas un būvēšanas rezultātiem (Responses API)
Teikumu izvilkuma vērtēšana, salīdzinot ar pēdējo lietotāja vaicājumu
8
Caveman
Uz noteikumiem balstīta prozas saspiešana (~65–75% izvadei)
9
Aggressive
Kopsavilkumu veidošana un veco mijiedarbības reižu pakāpeniska novecošana
10
LLMLingua-2
ML semantiskā retināšana, izmantojot MobileBERT ONNX — droša kodam, asinhrona
11
Ultra
Heiristiska tokenu retināšana ar neobligātu maza modeļa (SLM) līmeni
12
OmniGlyph
Eksperimentāla konteksta kodēšana attēlā izmērītam Claude Fable 5 tiešajā Anthropic kanālā; GPT 5.6 transformatori paliek drošā neizpildes režīmā, līdz tiek saņemti pakalpojumu sniedzēja apstiprinājumi. Četri saspiešanas profili (agresīvais noklusējuma, līdzsvarotais, kodam drošais, caurlaides) (visagresīvākais; jāiespējo)
Koda bloki, URL un strukturētie dati tiek **vienmēr saglabāti baitu līmenī**. **Ar vienu klikšķi aktivizējami sākotnējie iestatījumi** kombinē dzinējus:
Režīms
Ietaupījums
Vispiemērotākais
🪶 Lite
~15%
Vienmēr ieslēgts drošais noklusējuma režīms
🪨 Standard (Caveman)
~30%
Ikdienas programmēšanai
⚡ Aggressive
~50%
Garām sesijām ar daudziem rīkiem
🔥 Ultra
~75%
Maksimālam ietaupījumam
🧰 RTK
60–90%
Čaulas/testu/būvēšanas/git izvadei
🔗 Stacked (RTK → Caveman)
78–95%
Jauktiem aicinājumiem un rīku žurnāliem
**Reāls piemērs — Standard režīms:**
> **Pirms (69 tokeni):** _"Iemesls, kāpēc jūsu React komponents tiek atkārtoti renderēts, visticamāk, ir jaunas objekta atsauces izveide katrā renderēšanas ciklā. Kad nododat iekļautu objektu kā rekvizītu, React seklais salīdzinājums to katru reizi uztver kā citu objektu, kas izraisa atkārtotu renderēšanu. Ieteiktu izmantot useMemo, lai objektu saglabātu atmiņā."_
>
> **Pēc (19 tokeniem):** _"Jauna objekta atsauce katrā renderēšanā. Iekļauts objekta rekvizīts = jauna atsauce = atkārtota renderēšana. Ietveriet useMemo."_
>
> **Tā pati atbilde. Par 72% mazāk tokenu. Precizitāte nav zaudēta.** ✅
**PT-BR piemērs — [Troglodita](https://github.com/leninejunior/troglodita) režīms:**
> **Pirms (42 tokeni):** _"Problēma ir tā, ka komponents tiek renderēts atkārtoti, jo katrā renderēšanas ciklā tiek izveidota jauna objekta atsauce. Ieteiktu izmantot useMemo."_
>
> **Pēc (12 tokeniem):** _"Atkārtota renderēšana: jauna atsauce katrā ciklā (iekļautais objekts tiek izveidots no jauna). Izmantot `useMemo`."_
>
> **Tā pati atbilde. Par ~70% mazāk tokenu. Tehniskā precizitāte saglabāta.** ✅
### 🎚️ Vairāk nekā tikai dzinēji — izvades stili, adaptīvais regulators un vadība katram pieprasījumam
Iepriekš minētie 12 dzinēji samazina to, kas **ieiet**. Vēl trīs slāņi nosaka **kā**, **kad** un kas nonāk **izvadē**:
- **🪄 Izvades stili** _(izvades ass vadība)_ — ievieto deterministiskas, kešatmiņai drošas instrukcijas atbildes veidošanai; tos var kombinēt, un katram ir `lite` / `full` / `ultra` intensitātes līmenis. Stila pievienošana ir viena reģistra ieraksta jautājums:
- **Īsa proza** — izlaist aizpildījumu / artikulus / piesardzīgus formulējumus; saglabāt tehnisko būtību precīzu.
- **Mazāk koda** — YAGNI pēc “slinka seniora izstrādātāja” principa: mazākās darbojošās izmaiņas, bez nepieprasītas infrastruktūras.
- **Zirgaste (slinks seniora izstrādātājs)** — pakāpties pa YAGNI kāpnēm, novērst pamatcēloni, veikt mazāko darbojošos izmaiņu.
- **Man ir ADHD (vispirms darbība)** — nākamā darbība pirmajā vietā, soļi numurēti, viena konkrēta nākamā darbība, bez ievada.
- **Īss CJK (文言)** — īpaši īss klasiskās ķīniešu valodas stils (lokalizācija ierobežota līdz `zh`).
- **🎯 Adaptīvais konteksta budžets** _(regulators)_ — viena ieslēgšanas/izslēgšanas tokenu sliekšņa vietā aktivizē lētākos un vismazāk zudumus radošos dzinējus tikai tik lielā mērā, cik nepieciešams, lai **ietilptu modeļa konteksta logā**. Politika: `reserve-output` (noklusējums, atkarīgs no modeļa) · `percentage` · `absolute`. Režīms: `floor` (garantē ietilpšanu) · `replace-autotrigger` (prioritāte ir jūsu skaidri norādītajai izvēlei) · `off` (mantotais slieksnis).
- **🎛️ Kur tiek pieņemts saspiešanas lēmums** _(prioritāte no augstākās uz zemāko)_ — katra pieprasījuma `x-omniroute-compression` galvene › maršrutēšanas kombinācijas aizstājējiestatījums › aktīvais nosauktais profils › adaptīvais režīms / automātiskais aktivizētājs › paneļa noklusējums › izslēgts. Piemērotais plāns tiek atgriezts `X-OmniRoute-Compression: ; source=` atbildes galvenē.
Aktivizējiet automātisku darbību pēc tokenu sliekšņa, ieslēdziet adaptīvo regulatoru, piesaistiet nosauktu profilu, iestatiet vienreizēju konfigurāciju katram pieprasījumam vai piešķiriet konveijeru katrai maršrutēšanas kombinācijai — izvēlieties to, kas vislabāk atbilst darba slodzei. Pēc izvēles izmantojamā bezsaistes **novērtēšanas vide** (`npm run eval:compression`) novērtē precizitāti un ietaupījumu attiecībā pret fiksētu korpusu, pirms izmaiņu ieviešanas.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Ātrais sākums
**1) Instalējiet un palaidiet**
```bash
npm install -g omniroute
omniroute
```
> 💡 Redzat `npm warn ERESOLVE` vai brīdinājumus par atkarībām? [Tie ir nekaitīgi](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Izmantojat npm 11 vai jaunāku versiju?** npm var bloķēt pakotņu dzīves cikla skriptus, ja vien tie nav atļauti. OmniRoute `postinstall` (`node scripts/build/postinstall.mjs`) ir nepieciešams, lai sagatavotu tā vietējās izpildlaika datnes. Instalējot globāli, atļaujiet npm brīdinājumā norādītās pakotnes. OmniRoute 3.8.54 norādītajam pakotņu kopumam:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Lai šo atļauto pakotņu sarakstu izmantotu arī turpmākām globālām instalācijām, konfigurējiet to vienreiz un pēc tam instalējiet kā parasti:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Atkarību saraksts starp laidieniem var mainīties; ja npm ziņo par citu sarakstu, izmantojiet pakotņu nosaukumus no šī brīdinājuma. Pakotnes atļaušana ļauj izpildīt tās instalēšanas skriptus.
> **Izmantojat Gemini Web vai citu tīmekļa sīkdatņu nodrošinātāju?** npm pakotnē ir iekļauts
> Playwright, bet ne tā Chromium binārais fails. Pirms pirmā tīmekļa nodrošinātāja pieprasījuma skatiet
> [Playwright Chromium iestatīšanas](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> piezīmi.
Informācijas panelis atrodas `http://localhost:20128` · API atrodas `http://localhost:20128/v1`.
**2) Savienojiet piemērotu nodrošinātāju, izmantojot savu kontu**
Informācijas panelis → **Providers** → izvēlieties nodrošinātāju, kura pašreizējie noteikumi un kvota atbilst jūsu lietošanas gadījumam → pievienojiet tā API atslēgu vai pabeidziet konta iestatīšanas procesu. Bezmaksas plāniem var būt nepieciešama reģistrācija, apstiprinājums vai maksāšanas metode. Pārskatiet [Bezmaksas plānu ceļvedi](docs/getting-started/FREE-TIERS-GUIDE.md); pieejamība bez atslēgas nav garantēta, un nodrošinātāji ar marķējumu `tos: avoid` pēc noklusējuma tiek izslēgti no `auto`.
**3) Norādiet savu programmēšanas rīku**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) Pārbaudiet, vai viss darbojas**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Jums vajadzētu redzēt uzskaitītus savienotos modeļus. 🎉 Tas arī viss — sāciet programmēt, un OmniRoute automātiski izvēlēsies maršrutu un pārslēgsies uz rezerves iespēju jūsu vietā.
Ja jūsu klients nevar nosūtīt pielāgotas galvenes, OmniRoute piedāvā arī ar tokenu papildinātus saderības aizstājvārdus:
```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
```
Izmantojiet tos tikai klientiem, kuri nevar pievienot `Authorization: Bearer ...`. Galvenes autentifikācija joprojām ir vēlamais režīms.
## 📦 Vairāk instalēšanas veidu — Docker, pirmkods, 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` seko augstākajai **publicētajai** stabilajai SemVer versijai. Tas neseko git zaram `main`. GitOps vajadzībām piesaistiet `:X.Y.Z`. Skatiet [Docker laidienu kanālus](docs/guides/DOCKER_GUIDE.md#release-channels). Attēlā ir iestatīts **`OMNIROUTE_MEMORY_MB=1024`**. Ar to pietiek informācijas panelim un nelielai tērzēšanai. **Programmēšanas aģentiem** (`POST /v1/responses` no Claude Code, Codex, Grok, …) ir nepieciešama daudz lielāka V8 kaudze, citādi process beidzas ar `FATAL ERROR` pie aptuveni 12 GiB, ja pārklājas divi gari konteksti. Konteinera atmiņu iestatiet lielāku par kaudzi (vietējie buferi atrodas ārpus V8):
| Darba slodze | Kaudze (`-e OMNIROUTE_MEMORY_MB`) | Konteiners (`--memory`) |
| ---------------------------------------- | --------------------------------- | ----------------------- |
| Informācijas panelis / neliela tērzēšana | `1024` (attēla noklusējums) | ≥2 g |
| Viens programmēšanas aģents | `8192` | ≥10 g |
| Divi vienlaicīgi gari `/v1/responses` | `10240`–`12288` | ≥12–16 g |
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
Pilna tabula: [Docker ceļvedis — izpildlaika RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Docker pirmsizlaides kanāls:** `diegosouzapw/omniroute:next` un
> `diegosouzapw/omniroute:next-web` seko pašreizējam noklusējuma `release/v*`
> zaram. Šie mainīgie tagi ir paredzēti tikai neizlaistu labojumu testēšanai un
> **netiek atbalstīti produkcijas vidē**. Skatiet
> [Docker laidienu kanālus](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
Standarta `bun install` un globālā instalēšana (`bun install -g omniroute`) tiek atbalstīta, izmantojot Bun izpildvides noteikšanu:
- **Iebūvētais `bun:sqlite`**: darbojoties Bun vidē, OmniRoute izmanto Bun iebūvēto `bun:sqlite` draiveri, bet Node.js vidē atkāpjas uz `better-sqlite3` vai `sql.js`.
- **Automātiska Webpack komplektētāja atlase izstrādes laikā**: izstrādes režīms (`bun run dev`) automātiski nosaka Bun un atspējo Turbopack par labu Webpack, lai novērstu nesaderību ar vietējiem V8 saistījumiem. Produkcijas būvējumi (`bun run build`) precīzi ievēro `OMNIROUTE_USE_TURBOPACK` tāpat kā Node vidē: pēc noklusējuma Turbopack, bet `OMNIROUTE_USE_TURBOPACK=0`, lai būvētu ar Webpack (`Dockerfile.bun` to nodrošina kā `--build-arg`).
- **Atsevišķs Bun Dockerfile**: vairākposmu `Dockerfile.bun` vietējiem Bun produkcijas izvietojumiem (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Instalēšana un palaišana ar Bun
bun install
bun run dev
```
**🛠️ No pirmkoda**
```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
# Izmantojot Nix flakes
nix develop
npm run dev
# Vai izmantojot devbox
devbox run npm run dev
```
📖 [Docker ceļvedis](docs/guides/DOCKER_GUIDE.md) — Compose profili, Caddy HTTPS, Cloudflare tuneļi.
**🦭 Podman**
```bash
# 1. Sagatavojiet piesaistīto datu direktoriju
mkdir -p data
# 2. Tikai Linux + lokāls bezsaknes Podman (nekad attāls Podman Machine klients):
podman unshare chown 1000:1000 ./data
# 3. Iestatiet izpildvides norādi, izveidojiet lokālo Compose attēlu un palaidiet
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
macOS vai Windows vidē Podman izmanto attālu Podman Machine: izlaidiet `podman unshare` un
ievērojiet [konkrētajai topoloģijai paredzētos norādījumus par datu direktoriju](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Podman ceļvedis](contrib/podman/README.md) — Compose būvējumi, Podman Machine un
Linux/systemd Quadlet iestatīšana.
**⚡ Ātrāka / kompaktāka instalēšana (izlaižot vietējo būvēšanu)**
Vietējais SQLite dzinis (`better-sqlite3`) ir **neobligāta** atkarība, tādēļ globāla
instalēšana nekad netiek bloķēta, gaidot kompilēšanu no pirmkoda: tā izmanto iepriekš kompilētu bināro failu, ja tāds atbilst
jūsu platformai/Node, bet citādi nemanāmi pāriet uz tīru JS dzini
(`node:sqlite` Node 22+ vidē, pretējā gadījumā uz komplektācijā iekļauto `sql.js` WASM) — būvēšanas rīki nav nepieciešami.
Lai pilnībā izlaistu vietējo pēcieinstalēšanas iesildīšanu (CI, bezgrafikas vai lēnās iekārtās):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # Arī CI=1 to izlaiž
```
Visātrākai instalēšanai dodiet priekšroku **pnpm** (pēc satura adresēta krātuve + cietās saites — skatiet iepriekš).
Izpildvidei bez informācijas paneļa un grafiskās saskarnes izmantojiet Docker `base` profilu (iepriekš) vai
[Termux ceļvedi](docs/guides/TERMUX_GUIDE.md). CLI un tīmekļa informācijas paneli nodrošina viens un tas pats
process vienā portā, tādēļ pašlaik nav atsevišķas, tikai CLI paredzētas pakotnes.
pino — strukturēti JSON žurnāli ar pieprasījuma kontekstu
Testēšana
Node.js testu palaidējs + Vitest — 60 000+ statisku testu deklarāciju vairāk nekā 8 400 izsekotos testu failos (vienību, integrācijas, E2E, drošības, ekosistēmas)
Testu pārklājuma stratēģija vairāk nekā 60 000 statisku testu deklarācijām vairāk nekā 8 400 uzskaitītos testu failos
# ⭐ Galvenie ieguldītāji
> OmniRoute veido aizrautīga atvērtā pirmkoda kopiena. Šie cilvēki ir snieguši izcilu ieguldījumu, kas tieši ietekmē projekta kvalitāti, stabilitāti un sasniedzamību. **Paldies!**
### Ārējie ieguldītāji pēc apvienoto pull request skaita
Uzskaite veikta 2026-11-03 03:01:19 UTC, izmantojot aktīvās release/v3.8.53 virsotni 05bc048d6c. Lapu dalītais GitHub GraphQL uzskaitījums satur 9,947 apvienotus PR: 4,130 no repozitorija īpašnieka, 240 no Dependabot, 6 no citiem robotiem/lietotnēm un 5,571 ārēju PR no 883 atšķirīgiem ieguldītājiem. “Mainītās rindas” ir GitHub pievienojumu un dzēsumu summa, un tajā ietilpst ģenerētie faili, bloķēšanas faili, katalogi, tulkojumi un dokumentācija; tas ir izmaiņu apjoms, nevis autora LOC. 53 PR GitHub diff datos uzrāda vairāk nekā 500,000 rindu (piemēram, #13399, kurā pievienots viens nodrošinātājs, norādīti 2,347 mainīti faili), tādējādi palielinot vairākas iepriekš minētās kopsummas. Vienādas vērtības tiek ierindotas kopā.
### GitHub piedēvētie komiti
Pārbaudīts atkārtoti 2026-11-03 02:09:16 UTC: ar GitHub saistītie komiti, par kuriem ziņo repozitorija Contributors API noklusējuma atzarā release/v3.8.53. API atgrieza 903 identitātes (429 lietotājus, 2 robotus, 472 anonīmas identitātes); šajā tabulā nav iekļauts uzturētājs, roboti un anonīmās identitātes, kā arī ir saglabāti vienādi rezultāti. Šis saraksts atšķiras gan no iepriekš norādītā sapludināto PR reitinga, gan no tālāk redzamās Git metadatu uzskaites.
> 🙏 Šo ieguldītāju funkcijas, kļūdu labojumi un infrastruktūras uzlabojumi ir **būtiska daļa** no tā, kas padara OmniRoute uzticamu un ar plašu funkcionalitāti. Katrs izmaiņu pieprasījums, katrs testa gadījums un katrs i18n tulkojuma fails ir nozīmīgs. Atvērtā pirmkoda programmatūru veido tādi cilvēki kā viņi.
---
## 💖 Sponsori
Sirsnīgs paldies cilvēkiem, kuri finansē OmniRoute no saviem līdzekļiem — ikviens ieguldījums palīdz projektam palikt bezmaksas, neatkarīgam un turpināt attīstību.
… un citi, kuri vēlas saglabāt privātumu 💛Publiskie GitHub sponsori atkārtoti pārbaudīti 2026-10-18, izmantojot GitHub Sponsors GraphQL API: 11 publiski sponsorējumi (6 aktīvi, 5 iepriekšēji) no kopumā 14. GitHub statuss isActive nosaka iepriekš norādītos aktīvo sponsoru apzīmējumus; iepriekšējiem publiskajiem vienreizējiem atbalstītājiem joprojām tiek izteikta pateicība, bet privātie sponsori paliek anonīmi. Ko-fi, Buy Me a Coffee, Liberapay, PIX un kriptovalūtu ziedojumi nav norādīti, jo tiem nav publiska sponsora ieraksta.💖 Kļūstiet par sponsoru → — katrs dolārs palīdz OmniRoute palikt bezmaksas un neatkarīgam.
## 👥 1,000+ Līdzautoru
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Pārbaudīts 2026-11-02 aktīvās release/v3.8.53 virsotnē 1c7135e0fb (7,972 komiti): 1,074 normalizētas cilvēku Git identitātes — 759 tiek parādītas kā komitu autori (tostarp uzturētājs), bet 315 — tikai skaidri norādītās Co-authored-by piekabēs. Tautas skaitīšanā tiek piemērots .mailmap, e-pasta adreses tiek salīdzinātas, neņemot vērā reģistru, skaitliskās un parastās GitHub noreply adreses tiek apvienotas tikai tad, ja tās kodē vienu un to pašu lietotājvārdu, tiek izslēgtas 29 bota/aģenta/pakalpojuma/viettura identitātes, un parastās e-pasta adreses netiek apvienotas tikai tāpēc, ka to parādāmais vārds sakrīt. 2026-08-24 auditā tika publicētas 639; atkārtoti piemērojot šo metodi šī audita bāzei ac02c5b42f, tiek iegūtas 619, tāpēc pieaugumu rada jauni līdzautori, nevis brīvāka metode.
### Kā sniegt ieguldījumu
1. Izveidojiet repozitorija dakšu
2. Izveidojiet atzaru no **aktīvās** `release/vX.Y.Z` virsotnes (nevis `main`) — skatiet [Atzarošanas un laidienu modeli](docs/ops/BRANCHING_MODEL.md)
3. Izveidojiet savu funkcionalitātes atzaru (`git checkout -b feat/amazing-feature`)
4. Apstipriniet savas izmaiņas (`git commit -m 'feat: add amazing feature'`)
5. Nosūtiet atzaru uz attālo repozitoriju (`git push origin feat/amazing-feature`)
6. Atveriet Pull Request ar **base = šo `release/vX.Y.Z` atzaru**
Detalizētas vadlīnijas skatiet vietnē [CONTRIBUTING.md](CONTRIBUTING.md).
### Jaunas versijas izlaišana
```bash
# Izveidojiet laidienu — npm publish tiek izpildīts automātiski
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Zvaigznes
## 🌍 StarMapper
## 🙏 Pateicības
OmniRoute balstās uz milžu pleciem. Tas sākās kā **[9router](https://github.com/decolua/9router)** atzars un Go projekta **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** TypeScript ports — un no turienes katra tālāk minētā apakšsistēma tika iedvesmota ar atvērtā pirmkoda projektu, kas šo risinājumu izveidoja pirmais. Katrs no tiem veidoja konkrētu OmniRoute daļu. Šī ir mūsu pateicība viņiem visiem. 🙏
> ⭐ zvaigžņu skaits pārbaudīts, izmantojot GitHub REST API, 2026. gada 3. novembrī — dodieties piešķirt šiem projektiem zvaigzni. Skaits ir precīzs konkrētā datuma momentuzņēmums un dabiski mainīsies.
### 🧬 Izcelsme un vārteja
AI vārteja, kuras publiskais cenu datu kopums nodrošina mūsu izmaksu uzskaites sinhronizāciju un kuras pakalpojumu sniedzēju normalizācijas modelis ietekmēja mūsu maršrutēšanu.
MIT pirmkods pielāgots iekļautajam ChatGPT Web → Codex Responses tiltam, tostarp pārlūkprogrammas sesijas, atbildes ietvara, lietojuma un tīmekļa meklēšanas adapteriem.
Modeļi pārnesti uz straumes atkopšanu, bezdomāšanas aizstājvārdiem, rezerves tīmekļa meklēšanu, slīdošā loga ierobežojumiem, žurnālu datu maskēšanu un nostiprinātām palaidēja darbplūsmām.
Tā Grok modeļu kartējumi, viltus TypeError Statsig ģenerators, pieprasījumu un ierīces noklusējumi, kā arī NDJSON atbilžu procesors būtiski pielāgoti OmniRoute Grok Web izpildītājam.
Galvenais tranzitīvais koda avots, kas ir pamatā grok2api-merged; tā modeļa, galvenes, datnes, Statsig un procesora implementācijas saglabātas Grok Web izcelsmes ķēdē.
Pamata MIT pirmkods Grok datnes un ierīces noklusējumiem, Statsig ģeneratoram un result.response procesoram, kas pārnests caur TQZHR un grok2api-merged.
Tranzitīvs avots, ko grok2api-merged norāda savai starpniekserveru kopas slāņa izveidei; OmniRoute saglabā šo izcelsmes paziņojumu, taču nepretendē uz starpniekserveru kopas pārnesi savā ierobežotajā Grok Web izpildītājā.
Sākotnējā Grok Web implementācija tika izmantota, izstrādājot HTTP/pārlūkprogrammas augšupējā servera struktūru; tās tiešais HTTP ceļš izriet no GrokProxy, tāpēc neatkarīga koda pārnese netiek apgalvota.
Vīrālais projekts “kāpēc izmantot daudz tokenu, ja ar dažiem tokeniem var paveikt to pašu” — tā alu cilvēka runas filozofija nodrošina mūsu standarta saspiešanas režīmu un vairāk nekā 30 aizpildītājteksta/kondensācijas noteikumus.
PT-BR tokenu saspiešana — nodrošina mūsu pt-BR valodas pakotni: pleonazmu samazināšanu un aizpildītājteksta noņemšanu, kas pielāgota brazīliešu portugāļu gramatikai.
Vīrāla “slinka pieredzējuša izstrādātāja” YAGNI kodētāja prasme — iedvesmoja mūsu less-code Output Style: vadība, kas veic mazāko darbojošos izmaiņu un samazina _ģenerēto_ kodu (Caveman īsās prozas izvades ass līdzinieks).
Saturspecifiska, katram faila tipam pielāgota izvades saspiešana ar kļūmju apzinātu atteikšanos — apstiprināja mūsu dispatch pēc tipa un minimālā ieguvuma izlaišanu.
Rust kolonnveida JSON + uz saturu adresēta izgūšana + dedublikācija starp ziņojumiem — apstiprināja mūsu headroom/ccr/session-dedup dzinu dizainu un kešatmiņai stabilo invariantu “sablīvētā forma nav atkarīga no pozīcijas”.
TypeScript Compiler API rīkkopa — iedvesmoja mūsu uz parsētāju balstīto komentāru noņemšanu, kas saglabā virkņu, veidņu un regulāro izteiksmju literāļus.
Kodēšanas asistenta ↔ LLM datplūsmas MITM pārtveršana un analīze palīdzēja noteikt sākotnējās Traffic Inspector prasības. Četri iepriekš atvasinātie moduļi — SSE sapludināšana, sarunu normalizēšana, noslēpumu maskēšana un galveņu sanitizācija — ir aizstāti ar neatkarīgām tīras telpas implementācijām, kuru pamatā ir publiski protokolu standarti. Abas resursdatora caurlaides virsmas (passthrough.ts un _internal/bypass.cjs) joprojām ir OmniRoute iekšējas implementācijas, kas klasificētas neatkarīgi; tās netika pārrakstītas šīs aizstāšanas ietvaros.
Caurspīdīga starpniekservera maršrutēšana katram procesam — iedvesmoja mūsu avārijdrošo MITM pārtraukšanu, ligzdu dīkstāves taimautus, procesu piesaisti, izmantojot /proc, un TPROXY pārtveršanu.
### 📚 Modeļu dati, novērojamība un lietotāja saskarne
Identificēja Grok Build kvotas saskarni; pēc tam OmniRoute neatkarīgi pārbaudīja un izlabojis aktīvo vadu formātu.
## 📄 Licence
MIT licence — sīkāku informāciju skatiet sadaļā [LICENSE](LICENSE).
---
**[⬆ Atgriezties augšdaļā](#-omniroute)** · Izveidots ❤️ atvērtā pirmkoda MI kopienai.
Izveidoja Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT licence · omniroute.online