## 💰 ~1,62 mljrd. tokenu mēnesī no trešo pušu bezmaksas līmeņiem
> **Izmantojiet savus pakalpojumu sniedzēju kontus.** Šī ir aptuvenā kopsumma no atsevišķi pieejamiem trešo pušu bezmaksas līmeņiem, nevis OmniRoute piešķirti tokeni. Reģistrējieties, kur nepieciešams, iegūstiet piekļuves datus un pievienojiet pakalpojumu sniedzējus, kurus varat izmantot; katrs pakalpojumu sniedzējs pats nosaka savus ierobežojumus, pieejamību un noteikumus.
>
> Manuāli apvienot bezmaksas līmeņus ir apgrūtinoši — desmitiem SDK, desmitiem ātruma ierobežojumu un nav ne jausmas, cik daudz jums patiesībā ir pieejams. OmniRoute katalogā ir **489 bezmaksas līmeņu ieraksti 35 periodiski atjaunojamās kvotu kopās**, un kopējais tokenu skaits tiek aprēķināts no **17 kvotu kopām ar publicētu pozitīvu mēneša budžetu, kā arī pieciem katram modelim noteiktiem Groq ierobežojumiem**, novēršot koplietotu kvotu kopu dublēšanos. Kvotas, kas kļūst pieejamas tikai pēc reģionālās identitātes pārbaudes (pašlaik: ModelScope), tiek rādītas atsevišķi — +~6 milj. pēc reģionālās identitātes pārbaudes — un nekad netiek pieskaitītas virsrakstā norādītajai summai. Rezultāts vienmēr ir redzams informācijas panelī (`/dashboard/free-tiers`).
> Aktuālās `/dashboard/free-tiers` lapas animēts kopsavilkums. Pilna metodoloģija (kvotu kopu dublēšanās novēršana, kredītu līmeņi, pakalpojumu sniedzēju noteikumi): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Šie skaitļi ik pēc divām nedēļām tiek atkārtoti pārbaudīti, salīdzinot tos ar aktuālo katalogu, un **var mainīties abos virzienos** — ja pakalpojumu sniedzējs pārtrauc bezmaksas līmeni, skaitlis samazinās; ja tiek pievienots jauns, tas palielinās. Mēs publicējam katalogā faktiski aprēķināto rezultātu, nevis uz augšu noapaļotu labāko iespējamo variantu.
⭐ Piešķiriet repozitorijam zvaigzni, ja OMNIROUTE palīdzēja jums ietaupīt naudu un atviegloja darbu.
[](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 — uzziniet par jauniem pakalpojumu sniedzējiem, laidieniem un padomiem pirmie:**
[](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, attīstības plāns un atbalsts → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globāli](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brazīlija](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portāls](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 caur 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. Jaunā instalācijā var nebūt neviena piemērota mērķa, kuram nav nepieciešama atslēga, un pakalpojumu sniedzējs bez atslēgas var noraidīt trešo pušu klientus. Pakalpojumu sniedzēji, kas atzīmēti ar `tos: avoid`, tostarp OpenCode Free un Kiro, pēc noklusējuma netiek iekļauti automātiskajā maršrutēšanā; konta pievienošana šo iestatījumu nepārraksta. Pirms pakalpojumu sniedzēja izvēles skatiet [Bezmaksas līmeņu ceļvedi](docs/getting-started/FREE-TIERS-GUIDE.md).📦 Kopēšanai un ielīmēšanai gatavi ātrās darba sākšanas skripti valodām **Python, Node.js, PHP un cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 Solījums
# 🤔 Kāpēc izvēlēties 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 — galvenā funkcija
> **Kombinācija** ir modeļu ķēde, starp kuriem OmniRoute maršrutē **automātiski**. Ja kvota ir izsmelta, pakalpojumu sniedzējs nedarbojas vai strauji pieaug izmaksas, kombinācija var pāriet pie nākamā piemērotā un darbspējīgā modeļa. 🛡️
### ⚡ Bez konfigurēšanas — vienkārši izmantojiet `auto`
Kombinācija nav jāveido. Iestatiet modeli uz `auto` (vai kādu no tā variantiem), un OmniRoute no jūsu pievienotajiem pakalpojumu sniedzējiem izveidos virtuālu kombināciju, ko novērtēs reāllaikā:
Modeļa ID
Ko tas optimizē
auto
🎯 Līdzsvarots noklusējuma variants (LKGP — turpina izmantot pēdējo sekmīgi izmantoto pakalpojumu sniedzēju)
auto/coding
🧑💻 Koda ģenerēšanai paredzēti svari ar prioritāti kvalitātei
auto/fast
⚡ Vispirms — vismazākais latentums
auto/cheap
💰 Vispirms — zemākā maksa par tokenu
auto/offline
🔋 Vispirms — lielākā kvotas / ātruma ierobežojuma rezerve
auto/smart
🔭 Prioritāte kvalitātei + 10% izpētei, lai atklātu labākus modeļus
auto/lkgp
📌 Nepārprotama piesaiste pēdējam sekmīgi izmantotajam pakalpojumu sniedzējam
auto/chaos
🧪 Paralēla pieprasījumu nosūtīšana modeļu grupai (viens no katra pakalpojumu sniedzēja, pēc noklusējuma 5), atgriežot vienu atbildi; viens augšupstraumes izsaukums katram grupas modelim, nevis kļūmju ievadīšana
##
### 🔀 Vai arī izveidojiet savu — 19 maršrutēšanas stratēģijas
Visas **19** stratēģijas — brīvi kombinējiet tās katrā kombinācijas solī:
#
Stratēģija
Ko tā dara
1
priority
Sakārtots saraksts ar prioritāti pirmajam mērķim — izsmeliet katru, pirms pārejat pie nākamā 🥇
2
fill-first
Pirms pārejas pie nākamā mērķa pilnībā izmantojiet katra mērķa kvotu
3
weighted
Nejauša izvēle, kas svērta pēc katra mērķa svara
4
round-robin
Cikliski pārslēdzas starp mērķiem noteiktajā secībā
5
p2c
Nejauša slodzes līdzsvarošana, izvēloties labāko no diviem variantiem
6
least-used
Izvēlas mērķi ar pašlaik 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 maksu par pieprasījumu, izmantojot reāllaika kataloga cenas 💸
10
headroom
Izvēlas mērķi ar lielāko atlikušo kvotu
11
reset-window
Dod priekšroku mērķim, kura kvotas periods tiks atiestatīts visdrīzāk
12
reset-aware
Sarindo pēc kvotas atiestatīšanas laika — vispirms īsākie periodi 📊
13
context-relay
Ilgās sarunās nodod kontekstu starp mērķiem 🧠
14
context-optimized
Izvēlas pašreizējam konteksta apjomam vispiemērotāko variantu
15
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 🎯
16
lkgp
Pēdējais zināmais sekmīgais ceļš — piesaista pēdējam sekmīgi izmantotajam pakalpojumu sniedzējam un pēc tam atkāpjas uz noteikumiem
17
auto
Visu savienojumu reāllaika novērtēšana pēc 16 faktoriem 🤖
18
fusion
Nosūta pieprasījumu modeļu grupai, un vērtētājs sintezē vienu atbildi 🧬
19
pipeline
Saista soļus ķēdē — katra mērķa izvade tiek nodota 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)
📖 [Automātisko kombināciju dzinis](docs/routing/AUTO-COMBO.md) · [Noturības rokasgrāmata](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Ar ko OmniRoute izceļas
📊 Pilna metodoloģija un detalizēts funkciju salīdzinājums 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 papildinājumi no **v3.8.20 → v3.8.50**. Pilna vēsture pieejama failā [`CHANGELOG.md`](CHANGELOG.md).
- **🎛️ OmniConductor** — ienākošo A2A uzdevumu deleģēšana jūsu aģentu parkam, Conductor prasmes aģenta kartē un informācijas paneļa sadaļa ar Faro balss tērzēšanu, izmantojot rācijsaziņas režīmu. → [A2A serveris](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptīva pieprasījumu uzņemšana un aizsardzība pret pārslodzi** — resursietilpīgi tērzēšanas pieprasījumi tiek ievietoti rindā, nevis saņem 503 kļūdu, izmantojot atomāras RPM slīdošās nomas katram savienojumam. → [Noturības ceļvedis](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanoniska `/v1/models` secība** — katram nodrošinātājam viens nepārtraukts, pēc nodrošinātājiem grupēts bloks (kombinācijas piespraustas sākumā), kas ir stabils visos kataloga avotos. → [API uzziņa](docs/reference/API_REFERENCE.md)
- **🗜️ Kompresijas stiprināšana** — pēc noklusējuma ieslēgta izplešanas aizsardzība, Caveman pakotnes DE / FR / JA un ķīniešu valodai (wényán), RTK filtri Gradle un .NET vajadzībām. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Godīgas fiksētās likmes izmaksas** — abonementu / programmēšanas plānu nodrošinātāji izmaksu analītikā uzrāda **$0**; budžeta, kvotu un maršrutēšanas aplēses tiek saglabātas. → [API uzziņa](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share maršrutēšana** — koplietota konta kvota tiek taisnīgi sadalīta starp apvienotajām atslēgām, vienlaikus saglabājot darba efektivitāti, jo neizmantotās daļas tiek aizdotas. → [Noturības ceļvedis](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 CLI/aģenta iestatīšana ar vienu komandu** — 13 reģistrētas `setup-*` komandas; `omniroute run` palaiž 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` atbalsta 10 mērķus ar interaktīvu nodrošinātāja un modeļa atlasītāju, kā arī katram kontekstam atsevišķu izlasi. → [CLI integrācijas](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Attālais režīms** — pārvaldiet attālu OmniRoute, izmantojot tvērumiem piesaistītus pilnvarojumus (`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 un vērtētājs), uzdevumu apzinoša maršrutēšana, kā arī katram pieprasījumam atsevišķas modeļa / režīma / USD budžeta pārrakstīšanas iespējas. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Paplašināma kompresija** — 12 kombinējami dzinēji un Compression Studios: LLMLingua-2, divu līmeņu Ultra, omniglyph, katra soļa precizitātes vārteja, GCF v3.2 un pārkārtošanas redaktors ar vilkšanu. → [Kompresija](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Caurspīdīga MITM atšifrēšana (TPROXY)** — pārtveriet CLI, kas ignorē starpniekservera vides mainīgos, izmantojot katram SNI atsevišķu CA un uzticamības krātuves instalētāju. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Izmaksu telemetrija visur** — `X-OmniRoute-*` izmaksu/lietošanas galvenes katrā galapunktā, kešatmiņas trāpījumu ietaupījumu galvene un katras atslēgas USD tēriņu kvotas. → [API uzziņa](docs/reference/API_REFERENCE.md)
- **🧠 Jūsu pārvaldīta atmiņa** — pēc noklusējuma izslēgta; pēc izvēles ieslēdzama int8 vektoru kvantēšana un tipizēta novecošana, kā arī katram pieprasījumam pieejams `x-omniroute-no-memory`. → [Atmiņa](docs/frameworks/MEMORY.md)
- **🛡️ Drošība** — uzvedņu injekcijas aizsardzība katrā LLM maršrutā (ar uzbrukumu testu komplektu), pēc izvēles ieslēdzama akreditācijas datu maskēšanas aizsargbarjera (abos virzienos aizklāj nopludinātas API atslēgas/noslēpumus), bezmaksas DuckDuckGo tīmekļa meklēšana kā pēdējais risinājums un izvēles OIDC pieteikšanās vārteja informācijas panelim (pieteikšanās ar paroli vienmēr paliek pieejama). → [Aizsargbarjeras](docs/security/GUARDRAILS.md)
- **🖼️ Jauni galapunkti** — `/v1/ocr` (Mistral OCR) un `/v1/audio/translations` (Whisper tipa) papildina multivides iespēju klāstu. → [API uzziņa](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, kā arī runas pakalpojumu nodrošinātāji, piemēram, ElevenLabs. → [API uzziņa](docs/reference/API_REFERENCE.md)
- **🌍 Izvietošana un ekspluatācija** — reversā starpniekservera `basePath`, automātiska pārlūkprogrammas valodas noteikšana, katras atslēgas ierīču izsekošana, MITM uzticamība bez root piekļuves un zh-TW lokalizācija. → [Vide](docs/reference/ENVIRONMENT.md)
- **🤝 Vairāk nodrošinātāju un aģentu** — mākoņa aģenti (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) ar pārlūkprogrammu un OAuth pieteikšanos, pilnvērtīga Ollama kartīte, Claude Opus 5 un Sonnet 5, oficiāla partnerība ar Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… un atjaunināts **352 nodrošinātāju katalogs**. → [Nodrošinātāji](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Maršrutēšanas pārskatāmība** — katrā atbildē ir `X-OmniRoute-Decision` galvene, kas norāda to apkalpojušo stratēģiju/nodrošinātāju/latentumu; jauna `cache-optimized` kombināciju stratēģija kopā ar Auto-Combo `cacheAffinity` faktoru atkārtotos pieprasījumus novirza atpakaļ uz savienojumu, kurā glabājas kešotais prefikss, savukārt tikai lasāms `/v1/auto-combo/{channel}/candidates` galapunkts atklāj `auto/*` kanāla aktuālo kandidātu kopu. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Lokālā veiktspēja un infrastruktūra** — lokāls Redis ar vienu klikšķi, Cloudflare Workers / Deno Deploy releju izvietotāji, kā arī Bifrost un Mux kā uzraudzīti iegultie pakalpojumi. → [Iegultie pakalpojumi](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Komplektā arī** — 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ēliskošana ar līderu sarakstiem, ACP aģentu atklāšana (15 iebūvēti aģenti), ieplānota žurnālu eksportēšana uz BigQuery, `auto/chaos` paralēla izvēršana vairākos modeļos, Telegram robota tilts, lietotnē iebūvēts versiju pārvaldnieks un LMArena-ELO bezmaksas nodrošinātāju reitingi. → [Dokumentācija](docs/README.md)
## 🤖 Saderīgas CLI un programmēšanas aģenti
> Viena konfigurācija — `http://localhost:20128/v1` — un **ikviena** MI IDE vai CLI darbojas ar bezmaksas un zemu izmaksu modeļiem.
**Palaidiet jebkuru atbalstīto CLI, izmantojot OmniRoute, ar vienu komandu** — netiek rakstīti konfigurācijas faili,
akreditācijas dati tiek ievadīti katram procesam, bet Qwen/Gemini saņem pagaidu izolētu 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 arī interaktīvi izvēlieties nodrošinātāju un modeli un ierakstiet paša rīka konfigurāciju:
omniroute configure codex # pieejami arī: claude opencode qwen aider goose gemini cline continue kilo
```
Katra komanda izmanto aktīvo attālā savienojuma kontekstu (`omniroute connect `), `--dry-run`
parāda precīzus vides mainīgos/argumentus bez izpildes, bet `--api-key-env NAME` neļauj noslēpumiem
nonākt jūsu čaulas vēsturē. → [CLI integrācijas](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 MI pakalpojumu sniedzēji — 154 katalogā atzīmēti kā bezmaksas
> **372 reģistrēti pakalpojumu sniedzēji** kanoniskajās tērzēšanas, multivides, meklēšanas, lokālo, mākoņa aģentu un sistēmu kolekcijās, tostarp **154 ar `hasFree: true` atklāšanas metadatiem**. Tērzēšanas modeļu reģistrs aptver **237 pakalpojumu sniedzējus / 3,009 unikālus pakalpojumu sniedzēja un modeļa pārus / 1,443 neapstrādātus modeļu ID**; atsevišķajā bezmaksas budžeta katalogā ir **491 ieraksts par atsevišķiem modeļiem**, **35 periodiski atjaunojami resursu kopumi** un **54 periodiski atjaunojami vai bezatslēgas bezmaksas pakalpojumu sniedzēji bez laika ierobežojuma**. Šie saucēji pēc būtības ir atšķirīgi; definīcijas un aprēķini ar novērstu resursu kopumu dublēšanos ir pieejami sadaļās [Pakalpojumu sniedzēju uzziņa](docs/reference/PROVIDER_REFERENCE.md) un [Bezmaksas līmeņi](docs/reference/FREE_TIERS.md).
### 🏢 Visas lielākās laboratorijas — caur 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 330+ — katra ikona tiek ielādēta reāllaikā no informācijas paneļa pakalpojumu sniedzēju kataloga. 📖 [Pakalpojumu sniedzēju uzziņa](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Bezmaksas bez laika ierobežojuma — $0, karte nav nepieciešama
OpenCode Zen DeepSeek V4, Nemotron 3 Bez marķieru ierobežojuma
Kilo Code Automātiskais maršrutētājs, 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 un BEZ MAKSAS
Pollinations GPT, Llama, Claude Atslēga nav nepieciešama
Cloudflare AI Vairāk nekā 50 modeļu 10K 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 tieši VS Code vietējā Copilot Chat saskarnē
> Nekādas jaunas sānjoslas vai jaunas tērzēšanas saskarnes — ikviens OmniRoute nodrošinātais modelis tiek parādīts tieši
> **jau izmantotajā Copilot Chat modeļu izvēlnē**. Kopš VS Code 1.122 nodrošinātāju modeļi darbojas
> bez pierakstīšanās GitHub kontā vai Copilot abonementa — aģenta režīms, rīku izsaukšana un attēlu apstrāde
> bez maksas.
Instalē **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** paplašinājumu, norādi tam
savu OmniRoute serveri (pēc noklusējuma `localhost:20128`), pēc tam atver Copilot Chat → modeļu izvēlni
→ **Pārvaldīt modeļus…** → **OmniRoute**.
Redaktorā atver **Paplašinājumu** skatu, meklē **„OmniRoute”** un noklikšķini uz **Instalēt**
— abos veikalos tas darbojas vienādi. Pirmkods, problēmu pieteikumi un publicēšanas instrukcija ir pieejama
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Code Copilot Chat ceļvedis](docs/guides/VSCODE-COPILOT.md) — iestatīšana, modeļu izvēlnes saturs, informācijas panelis cilnē, problēmu novēršana
> `omniroute serve` vislabāk darbojas, ja tas vienmēr ir ieslēgts. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> pārvērš to par vienreiz iestatāmu un aizmirstamu macOS izvēļņu joslas lietotni: tā palaiž serveri, uztur to aktīvu
> pēc pārstartēšanas, atjaunina to uz vietas un padara tavu aktuālo tokenu budžetu pieejamu ar vienu klikšķi — **nav
> jāatstāj atvērts termināļa logs un nav jāuzrauga `npm install -g omniroute`.**
Tā ir veidota ar [Tauri v2](https://v2.tauri.app/) (Rust kodols, kura izmērs ir niecīgs), un komplektācijā ietver
savu parakstīto Node 24 izpildvidi, kā arī pārvalda lietotnei piederošu OmniRoute instalāciju, tāpēc tā nekad nekonfliktē ar tavu
globālo `node`/`bun`. Tā **koplieto tavu esošo `~/.omniroute/` konfigurāciju un datubāzi** — tātad tas ir
tas pats OmniRoute, kuru jau izmanto, tikai tagad ar cepuri. 🎩
Ko tas dara
Kā
🟢 Uzrauga serveri
Palaiž omniroute serve un pievienojas jau palaistai instancei, nevis to dublē
📊 Aktuālais lietojums vienā acu uzmetienā
Nodrošinātāju kvotu joslas, Claude sesijas un nedēļas ierobežojumi ar laika atskaiti līdz atiestatīšanai, 30 dienu izmaksu sadalījums
🔄 Automātiski atjauninājumi uz vietas
Pakāpeniska instalēšana, atomāra nomaiņa, atgriešana iepriekšējā stāvoklī kļūmes gadījumā — vienmēr jaunākais laidiens
🚀 Palaišana piesakoties
Izvēles palaišana, piesakoties sistēmā; tikai sistēmas teknē, bez ikonas Dock joslā
🩺 Diagnostika un žurnāli
Diagnostika ar vienu klikšķi un piekļuve servera žurnāliem
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Vēlaties lejupielādēt? Iegūstiet jaunāko .dmg no sadaļas
Laidieni. Pirmkods, problēmu ziņojumi un būvēšanas
dokumentācija ir pieejama vietnē zoispag/omniroute-tray.
💛 Kopienas projekts, ko izveidojis @zoispag — tas nav 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 # vadīts pirmās palaišanas vednis
omniroute doctor # diagnosticēt nodrošinātā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ā instancē.
```bash
omniroute connect 192.168.0.15 # parole → ierobežota tvēruma pilnvara, saglabāta kā konteksts
omniroute models list # ← tiek izpildīta ATTĀLAJĀ serverī
omniroute configure codex # ← atlasa attālo modeli, izveido lokālu Codex profilu
omniroute tokens create --name ci --scope read # izveidot ierobežotāka tvēruma pilnvaras citām ierīcēm
omniroute contexts use default # ← pārslēgties atpakaļ uz lokālo serveri
```
Pilnvaru tvērumi ir `read` / `write` / `admin`; maršruti, kas palaiž procesus, paliek 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ūst piekļuvi visai vārtejai: maršrutēšanai, nodrošinātā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šana ar Claude Desktop, Cursor vai jebkuru MCP klientu
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 un OCR
🔔 Tīmekļa aizķeres
/api/webhooks
Pieprasījumu un kvotu notikumu nosūtīšana uz Slack, Discord, Telegram vai jebkuru URL
🛰️ Attālā CLI
omniroute connect
Attālas instances pārvaldīšana ar ierobežota tvēruma piekļuves pilnvarām
```bash
# Piešķirt 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)
## 🗜️ Ietaupiet 15–95% tokenu — automātiski
### 📖 Kā tas darbojas — konveijers, arhitektūra un ietaupījuma aprēķins
Noklusējuma secīgā kombinācija izmanto `RTK → Caveman`. Ja abi apstrādā vienu un to pašu rīka/konteksta lietderīgo slodzi, ietaupījums summējas:
```txt
kopā = 1 − (1 − RTK) × (1 − Caveman_ievade)
vidēji = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
diapazons = 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 pietiek ar dažiem?** Katrs pieprasījums **caurspīdīgi** iziet cauri OmniRoute saspiešanas konveijeram — klienta izmaiņas nav nepieciešamas. Tagad tas ir **12 kombinējamu dzinēju kopums**, kas darbojas noteiktā secībā un ko var dažādi kombinēt katrai maršrutēšanas kombinācijai — balstoties uz idejām no [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).
### 🧱 12 dzinēju kopums
Dzinēji darbojas konveijera secībā; katru no tiem var neatkarīgi ieslēgt vai izslēgt un konfigurēt katrai kombinācijai:
#
Dzinējs
Ko tas dara
1
Session-Dedup
Atmet saturu, kas atkārtojas vairākos dialoga soļos (adresēšana pēc satura, starp dialoga soļiem)
2
CCR
Arhivē lielus blokus aiz izgūšanas marķieriem un ielādē tos pēc pieprasījuma
3
Lite
Atstarpju un attēlu URL samazināšana (bāzes režīms ar mazu latentumu)
4
RTK
Vieda rīku rezultātu filtrēšana, dublikātu noņemšana un saīsināšana (ņemot vērā komandu)
5
Responses Tool Output
JSON apstrāde, vispirms saglabājot datus bez zudumiem, un ierobežota diagnostikas saspiešana čaulas/ielāpu/meklēšanas/būvēšanas izvadei (Responses API)
6
Headroom
JSON masīvu tabulāra saspiešana bez zudumiem (~30%), izmantojot komplektācijā iekļautu GCF kodeku
7
Relevance
Ekstraktīva teikumu novērtēšana attiecībā pret pēdējo lietotāja vaicājumu
Kopsavilkumu veidošana un veco dialoga soļu pakāpeniska novecošana
10
LLMLingua-2
Mašīnmācīšanās semantiskā retināšana, izmantojot MobileBERT ONNX — droša kodam, asinhrona
11
Ultra
Heiristiska tokenu retināšana ar izvēles maza modeļa (SLM) līmeni
12
OmniGlyph
Eksperimentāla konteksta kodēšana attēla veidā izmērītajam Claude Fable 5, izmantojot tiešu Anthropic savienojumu; GPT 5.6 transformatori joprojām darbojas kļūmju drošā slēgtā režīmā, gaidot pakalpojuma sniedzēja apliecinājumus. Četri saspiešanas profili (agresīvais pēc noklusējuma, līdzsvarotais, drošs kodēšanai, bez izmaiņām) (visagresīvākais; jāieslēdz manuāli)
Koda bloki, URL un strukturētie dati **vienmēr tiek saglabāti** precīzi līdz pēdējam baitam. **Sākotnējie iestatījumi ar vienu klikšķi** apvieno dzinējus:
Režīms
Ietaupījums
Vispiemērotākais
🪶 Lite
~15%
Drošs noklusējuma režīms pastāvīgai lietošanai
🪨 Standard (Caveman)
~30%
Ikdienas programmēšanai
⚡ Aggressive
~50%
Ilgām sesijām ar intensīvu rīku izmantošanu
🔥 Ultra
~75%
Maksimālam ietaupījumam
🧰 RTK
60–90%
Čaulas/testu/būvēšanas/git izvadei
🔗 Secīgā kombinācija (RTK → Caveman)
78–95%
Jauktām uzvednēm un rīku žurnāliem
**Reāls piemērs — Standard režīms:**
> **Pirms (69 tokeni):** _"Iemesls, kāpēc jūsu React komponents tiek renderēts atkārtoti, visticamāk, ir tas, ka katrā renderēšanas ciklā izveidojat jaunu objekta atsauci. Kad nododat iekļautu objektu kā rekvizītu, React seklā salīdzināšana to katru reizi uztver kā citu objektu, kas izraisa atkārtotu renderēšanu. Es ieteiktu izmantot useMemo, lai saglabātu objektu atmiņā."_
>
> **Pēc (19 tokeni):** _"Katrā renderēšanā jauna objekta atsauce. Iekļauts objekta rekvizīts = jauna atsauce = atkārtota renderēšana. Izmantojiet useMemo."_
>
> **Tā pati atbilde. Par 72% mazāk tokenu. Nekādu precizitātes zudumu.** ✅
**PT-BR piemērs — [Troglodita](https://github.com/leninejunior/troglodita) režīms:**
> **Pirms (42 tokeni):** _"Problēma ir tāda, ka komponents tiek atkārtoti renderēts, jo katrā renderēšanas ciklā tiek izveidota jauna objekta atsauce. Es ieteiktu izmantot useMemo."_
>
> **Pēc (12 tokeni):** _"Atkārtota renderēšana: jauna atsauce katrā ciklā (inline objekts 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 kontrole katram pieprasījumam
Iepriekš minētie 12 dzinēji samazina to, kas nonāk **iekšā**. Vēl trīs slāņi nosaka, **kā**, **kad** un kas iznāk **ārā**:
- **🪄 Izvades stili** _(izvades ass vadība)_ — ievieto deterministiskas, kešatmiņai drošas instrukcijas atbildes formas pielāgošanai; tos var kombinēt, katru ar `lite` / `full` / `ultra` intensitāti. Stila pievienošanai vajadzīgs viens reģistra ieraksts:
- **Īsa proza** — atmest liekvārdību / artikulus / izvairīgus formulējumus; precīzi saglabāt tehnisko būtību.
- **Mazāk koda** — „slinka vecākā izstrādātāja” YAGNI pieeja: mazākās nepieciešamās izmaiņas, bez nepieprasītas papildu struktūras.
- **Ponytail (slinks vecākais izstrādātājs)** — kāpt pa YAGNI kāpnēm, novērst pamatcēloni, veikt mazākās nepieciešamās izmaiņas.
- **Man ir ADHD (vispirms darbība)** — sākt ar nākamo darbību, numurēt soļus, norādīt vienu konkrētu nākamo soli, bez ievada.
- **Īss CJK (文言)** — īpaši īss klasiskās ķīniešu valodas stils (pieejams tikai `zh` lokalizācijai).
- **🎯 Adaptīvais konteksta budžets** _(regulators)_ — viena ieslēgšanas/izslēgšanas tokenu sliekšņa vietā lētākie dzinēji ar vismazākajiem zudumiem tiek pakāpeniski izmantoti tikai tik daudz, cik nepieciešams, lai **iekļautos modeļa konteksta logā**. Politika: `reserve-output` (noklusējums, pielāgots modelim) · `percentage` · `absolute`. Režīms: `floor` (garantē iekļaušanos) · `replace-autotrigger` (jūsu skaidri norādītajai izvēlei ir priekšroka) · `off` (mantotais slieksnis).
- **🎛️ Kur tiek pieņemts lēmums par saspiešanu** _(prioritāte no augstākās uz zemāko)_ — katra pieprasījuma `x-omniroute-compression` galvene › maršrutēšanas kombinācijas pārrakstīšana › aktīvais nosauktais profils › adaptīvā / automātiskā aktivizēšana › paneļa noklusējums › izslēgts. Piemērotais plāns tiek atspoguļots atbildes galvenē `X-OmniRoute-Compression: ; source=`.
Izmantojiet automātisku aktivizēšanu pēc tokenu sliekšņa, ieslēdziet adaptīvo regulatoru, piespraudiet nosauktu profilu, iestatiet vienreizēju opciju katram pieprasījumam vai piešķiriet konveijeru katrai maršrutēšanas kombinācijai — izvēlieties darba slodzei piemērotāko. Izvēles bezsaistes **novērtēšanas rīks** (`npm run eval:compression`) fiksētā korpusā novērtē precizitāti attiecībā pret ietaupījumu, pirms ieviešat izmaiņas.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Ātrā darba sākšana
**1) Instalējiet un palaidiet**
```bash
npm install -g omniroute
omniroute
```
> 💡 Redzat `npm warn ERESOLVE` vai vienādranga atkarību brīdinājumus? [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. Veicot globālu instalēšanu, atļaujiet npm brīdinājumā nosauktās pakotnes. OmniRoute 3.8.51 norādītajai pakotņu kopai:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Lai atkārtoti izmantotu šo atļauto pakotņu sarakstu 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 dažādās versijās var mainīties; ja npm norāda citu sarakstu, izmantojiet šajā brīdinājumā minētos pakotņu nosaukumus. 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 nav iekļauts tā Chromium binārais fails. Pirms pirmā pieprasījuma tīmekļa nodrošinātājam skatiet
> piezīmi par [Playwright Chromium iestatīšanu](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium).
Informācijas panelis pieejams vietnē `http://localhost:20128` · API pieejama vietnē `http://localhost:20128/v1`.
**2) Pievienojiet piemērotu nodrošinātāju, izmantojot savu kontu**
Informācijas panelis → **Nodrošinātāji** → 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 savienošanas procesu. Bezmaksas līmeņiem var būt nepieciešama reģistrācija, apstiprināšana vai maksājuma metode. Izskatiet [bezmaksas līmeņu ceļvedi](docs/getting-started/FREE-TIERS-GUIDE.md); pieejamība bez atslēgas netiek garantēta, un nodrošinātāji, kas atzīmēti ar `tos: avoid`, pēc noklusējuma netiek iekļauti `auto`.
**3) Norādiet savam programmēšanas rīkam**
```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 tas darbojas**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Jums vajadzētu redzēt pievienoto modeļu sarakstu. 🎉 Tas arī viss — sāciet programmēt, un OmniRoute automātiski veiks maršrutēšanu un pārslēgsies uz rezerves variantu.
Ja jūsu klients nevar nosūtīt pielāgotas galvenes, OmniRoute nodrošina arī tokenizē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 ...`. Autentifikācija ar galveni joprojām ir ieteicamais 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 izpildītājs + Vitest — vairāk nekā 39 000 statisku testu deklarāciju vairāk nekā 5100 izsekotos testu failos (vienībtesti, integrācijas testi, E2E, drošības un ekosistēmas testi)
Testu pārklājuma stratēģija vairāk nekā 39 000 statisku testu deklarāciju vairāk nekā 5 100 izsekotos testu failos
# ⭐ Galvenie līdzautori
> OmniRoute veido aizrautīga atvērtā pirmkoda kopiena. Šīs personas ir sniegušas izcilu ieguldījumu, kas tieši ietekmē projekta kvalitāti, stabilitāti un sasniedzamību. **Paldies.**
### Ārējie līdzautori pēc sapludināto izmaiņu pieprasījumu skaita
Fiksēts aktīvā release/v3.8.50 zara galotnē dafb4ae808, iekļaujot sapludinājumus līdz 2026-08-24 05:26:03 UTC. GitHub GraphQL lapotajā uzskaitē ir 5 911 sapludināti PR: 2 707 no repozitorija īpašnieka, 179 no Dependabot un 3 025 ārēji PR no 535 unikāliem līdzautoriem. “Mainītās rindas” ir GitHub pievienoto un dzēsto rindu summa, kas ietver ģenerētus failus, bloķēšanas failus, katalogus, tulkojumus un dokumentāciju; tas ir izmaiņu apjoms, nevis autora rakstīto koda rindu skaits. Vienādie rezultāti uz atlases robežas ir saglabāti.
### GitHub piesaistītie komiti
Bob.Hou 🏅 51 GitHub attiecināts komits · dalīta 10. vieta
Xiangzhe 🏅 51 GitHub attiecināts komits · dalīta 10. vieta
Atkārtoti pārbaudīts 2026-08-24 06:14:31 UTC: repozitorija Contributors API ziņotie GitHub attiecinātie komiti noklusējuma zarā release/v3.8.50. API atgrieza 525 identitātes (415 lietotājus, 2 botus, 108 anonīmus dalībniekus); šajā tabulā nav iekļauts uzturētājs, boti un anonīmas identitātes, bet ir saglabātas dalītās vietas. Tā atšķiras gan no iepriekš redzamā apvienoto izmaiņu pieprasījumu reitinga, gan no tālāk redzamās 639 personu Git metadatu uzskaites.
> 🙏 Šo līdzautoru funkcijas, kļūdu labojumi un infrastruktūras uzlabojumi ir **būtiska daļa** no tā, kas padara OmniRoute uzticamu un funkcijām bagātu. Svarīgs ir ikviens izmaiņu pieprasījums, ikviens testa gadījums un ikviens i18n tulkojuma fails. Atvērto pirmkodu 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īties.
… un citi, kuri dod priekšroku palikt anonīmi 💛Publiskie GitHub Sponsors tika atkārtoti pārbaudīti 2026-08-24. GitHub statuss activeOnly nosaka iepriekš norādītās aktīvā sponsora atzīmes; iepriekš publiski norādītajiem vienreizējiem atbalstītājiem joprojām tiek izteikta pateicība, bet privātie sponsori paliek anonīmi.💖 Kļūstiet par sponsoru → — katrs dolārs palīdz OmniRoute palikt bezmaksas un neatkarīgam.
## 👥 Vairāk nekā 600 līdzautoru
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Audits veikts 2026-08-24, izmantojot fiksēto bāzi ac02c5b42f, un pārbaude atkārtota aktuālā release/v3.8.50 zara galotnē dafb4ae808: 639 normalizētas cilvēku Git identitātes — 407 ir norādītas kā izmaiņu autori (tostarp uzturētājs), bet 232 ir norādītas tikai nepārprotamos Co-authored-by noslēguma laukos. Uzskaitē tiek normalizēti GitHub noreply lietotājvārdi, izslēgtas 26 botu/aģentu/pakalpojumu/vietturu identitātes, un parastās e-pasta adreses netiek apvienotas tikai tādēļ, ka sakrīt to parādāmie vārdi.
### Kā sniegt ieguldījumu
1. Izveidojiet repozitorija atzarojumu
2. Veidojiet zaru no **aktīvā** `release/vX.Y.Z` zara galotnes (nevis no `main`) — skatiet [Zarošanas un laidienu modeli](docs/ops/BRANCHING_MODEL.md)
3. Izveidojiet savas funkcionalitātes zaru (`git checkout -b feat/amazing-feature`)
4. Reģistrējiet savas izmaiņas (`git commit -m 'feat: add amazing feature'`)
5. Nosūtiet izmaiņas uz zaru (`git push origin feat/amazing-feature`)
6. Atveriet izmaiņu apvienošanas pieprasījumu, norādot **base = attiecīgais `release/vX.Y.Z` zars**
Detalizētus norādījumus skatiet failā [CONTRIBUTING.md](CONTRIBUTING.md).
### Jaunas versijas izlaišana
```bash
# Izveidojiet laidienu — npm publicēšana notiek 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)** atzarojums un Go projekta **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** TypeScript ports — un kopš tā laika katru no tālāk minētajām apakšsistēmām ir iedvesmojis kāds atvērtā pirmkoda projekts, kas šo ceļu bija mērojis pirmais. Katrs no tiem ir veidojis konkrētu OmniRoute daļu. Šī ir mūsu pateicība tiem visiem. 🙏
> ⭐ zvaigžņu skaits pārbaudīts, izmantojot GitHub REST API, 2026. gada 24. augustā — piešķiriet šiem projektiem zvaigzni. Norādītais skaits ir precīzs momentuzņēmums konkrētajā datumā, un laika gaitā tas, protams, mainīsies.
### 🧬 Izcelsme un vārteja
MI vārteja, kuras publiskā cenu datu kopa nodrošina mūsu izmaksu uzskaites sinhronizāciju un kuras pakalpojumu sniedzēju normalizācijas modelis palīdzēja veidot mūsu maršrutēšanu.
Modeļi, kas pārnesti uz straumes atkopšanu, aizstājvārdiem bez spriešanas, rezerves meklēšanu tīmeklī, slīdošā loga ierobežojumiem, žurnālu datu aizklāšanu un pastiprināti aizsargātām palaidēja plūsmām.
Tā Grok modeļu kartējumi, viltus TypeError Statsig ģenerators, pieprasījumu un ierīču noklusējumi, kā arī NDJSON atbilžu procesors tika būtiski pielāgoti OmniRoute Grok Web izpildītājam.
Galvenais netiešais grok2api-merged koda avots; tā modeļu, galveņu, slodzes, Statsig un procesora implementācijas ir saglabātas Grok Web izcelsmes ķēdē.
Pamatā esošais MIT pirmkods Grok slodzes un ierīču noklusējumiem, Statsig ģeneratoram un result.response procesoram, kas pārņemts ar TQZHR un grok2api-merged starpniecību.
Netiešs avots, kuru grok2api-merged norāda kā sava starpniekserveru pūla slāņa avotu; OmniRoute saglabā šo izcelsmes norādi, taču neapgalvo, ka tā ierobežotajā Grok Web izpildītājā būtu portēts starpniekserveru pūls.
Sākotnējā Grok Web implementācijā tika izmantots tā HTTP/pārlūka augšupstraumes dizains; tā tiešais HTTP ceļš ir atvasināts no GrokProxy, tāpēc netiek apgalvots, ka būtu veikts neatkarīgs koda portējums.
Vīrusu popularitāti ieguvušais projekts „kāpēc lietot daudz žetonu, ja pietiek ar dažiem” — tā alu cilvēka runas filozofija ir mūsu standarta saspiešanas režīma un vairāk nekā 30 liekvārdības novēršanas un teksta saīsināšanas kārtulu pamatā.
Uzvedņu saspiešanas pētījumi (LLMLingua / LLMLingua-2) — iedvesmoja mūsu asinhrono, kodam drošo un kļūmes gadījumā sākotnējo saturu saglabājošo llmlingua dzini.
pt-BR žetonu saspiešana — nodrošina mūsu pt-BR valodas pakotni: pleonasmu samazināšanu un liekvārdu noņemšanu, kas pielāgota Brazīlijas portugāļu valodas gramatikai.
Saturu izprotoša izvades saspiešana katram failu tipam ar atteikšanos kļūmes gadījumā — apstiprināja mūsu sadali pēc tipa un izlaišanu, ja netiek sasniegts minimālais ieguvums.
Rust kolonnveida JSON, satura adresēta izgūšana un starpziņojumu dublikātu novēršana — apstiprināja mūsu headroom/ccr/session-dedup dziņu dizainu un kešatmiņas stabilitātes invariantu „saspiestā forma nav atkarīga no pozīcijas”.
Kodēšanas asistenta ↔ LLM datplūsmas MITM pārtveršana/analīze palīdzēja noteikt sākotnējās Traffic Inspector prasības. Četri iepriekš atvasināti moduļi — SSE apvienošana, sarunu normalizēšana, noslēpumu maskēšana un galveņu sanitizēšana — ir aizstāti ar neatkarīgām tīrtelpas implementācijām, kuru pamatā ir publiski protokolu standarti. Abas resursdatora tiešās caurlaišanas saskarnes (passthrough.ts un _internal/bypass.cjs) joprojām ir OmniRoute iekšējās implementācijas, kas klasificētas neatkarīgi; šīs aizstāšanas ietvaros tās netika pārrakstītas.
Caurspīdīga starpniekservera maršrutēšana katram procesam — iedvesmoja mūsu pret avārijām drošo MITM slēgšanu, ligzdu dīkstāves taimautus, procesu identificēšanu, izmantojot /proc, un TPROXY pārtveršanu.
### 📚 Modeļu dati, novērojamība un lietotāja saskarne
Rūpīgi atlasīts pēc noklusējuma drošu bibliotēku saraksts, kas nosaka mūsu drošības izvēles (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Tā kontus ņemošā vērā modeļu pārkartēšana, izpildāmā faila ceļa validācija un plānu etiķešu darbība palīdzēja izstrādāt OmniRoute Antigravity izpildvidi.