## 💰 ~1,62 mljrd. tokenu mēnesī trešo pušu bezmaksas līmeņos
> **Izmantojiet savus pakalpojumu sniedzēju kontus.** Šis ir aptuvens kopsavilkums pa atsevišķi pieejamiem trešo pušu bezmaksas līmeņiem, nevis tokenu piešķīrums no OmniRoute. Reģistrējieties, iegūstiet pieteikšanās datus, kur nepieciešams, un pieslēdziet tos pakalpojumu sniedzējus, kurus varat izmantot; katrs pakalpojumu sniedzējs pats kontrolē savus ierobežojumus, pieejamību un noteikumus.
>
> Bezmaksas līmeņu apvienošana manuāli ir sāpīga — desmitiem SDK, desmitiem pieprasījumu ātruma ierobežojumu un neziņa, cik daudz jums patiesībā ir. OmniRoute katalogizē **467 bezmaksas līmeņu ierakstus 34 atkārtotu kopu atslēgās** un aprēķina tokenu galveno rādītāju no **17 kopām ar publicētu pozitīvu mēneša budžetu plus pieciem Groq ierobežojumiem pa modeļiem**, deduplicējot pēc koplietotām kopām. Kvotas, kas atveras tikai pēc reģionālās identitātes pārbaudes (šobrīd: ModelScope), tiek rādītas atsevišķi — +~6M aiz reģionālās identitātes verifikācijas — un nekad netiek pieskaitītas galvenajam rādītājam. Rezultāts paliek redzams informācijas panelī (`/dashboard/free-tiers`).
> Animēts kopsavilkums par reāllaika `/dashboard/free-tiers` lapu. 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 pret reāllaika katalogu un **mainās abos virzienos** — pakalpojumu sniedzējs pārtrauc bezmaksas līmeni, un skaitlis krītas; parādās jauns, un tas kāpjas. Mēs publicējam to, ko katalogs faktiski aprēķina, nekad ne noapaļotu uz augšu labākā gadījuma skaitli.
⭐ Atzīmējiet repozitoriju ar zvaigzni, ja OMNIROUTE palīdzēja jums ietaupīt naudu un atvieglināt 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 — saņemiet jaunumus par 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, ceļvedis un atbalsts → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Globālais](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 maršrutējiet caur vienu galapunktu
```bash
# Pēc pakalpojumu sniedzēja pievienošanas nokopējiet savu OmniRoute atslēgu sadaļā 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!"}]}'
```
Lai `auto` darbotos, nepieciešams atbilstīgs maršruts. Jaunā instalācijā var nebūt neviena atbilstīga mērķa bez atslēgas, un bezatslēgas pakalpojumu sniedzējs 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).📦 Kopēšanai gatavi ātrās sākšanas skripti priekš **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 izceļas
📊 Pilna metodoloģija un detalizēts katras iespējas 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 izceltie punkti no **v3.8.20 → v3.8.53**. Pilna vēsture [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ `quota-weighted` maršrutēšana** — 20. kombinētā stratēģija izlaiž izsmeltos kontus, pēc tam izlozē starp pārējiem proporcionāli atlikušajai kvotai ÷ aktīvajai slodzei, saglabājot esošās sarunas piespraustas. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless režīms** — `omniroute serve --headless` (vai `OMNIROUTE_HEADLESS=1`) palaiž tikai `/v1/*` starpniekservera dzinēju, ar izslēgtu informācijas paneli un tikai informācijas paneļa apakšsistēmām. → [Headless režīms](docs/guides/HEADLESS.md)
- **🔎 Modeļu atklāšana** — `/v1/models` filtrē pēc iespējām, konteksta, veida un teksta, un `POST /v1/models/query` atgriež īsu deterministisku īssarakstu ar tādu pašu redzamību pa atslēgām. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🔑 Maršrutēšanas kontrole pa atslēgām** — piespraudiet API atslēgu vienam modelim vai kombinācijai ar `forcedModel` un atomiski pievienojiet vai noņemiet atslēgas modeļus un kombinācijas (`/api/keys/{id}/access`). → [API atsauce](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Precīzāka PII kontrole** — atlase pa veidiem, līdz 20 validēti pielāgoti maskēšanas modeļi un atklāšanas skaitītāji pa veidiem; pati maskēšana paliek opt-in. → [Aizsargmehānismi](docs/security/GUARDRAILS.md)
- **🌍 67 valodas** — informācijas panelis, dokumentācijas spoguļi un CLI, ar `npm run i18n:add-locale` pievienojot valodu visur vienā komandā. → [i18n ceļvedis](docs/guides/I18N.md)
- **🎛️ OmniConductor** — ienākoša A2A deleģēšana jūsu aģentu flotei, Conductor prasmes Agent Card kartītē un informācijas paneļa panelis ar Faro push-to-talk balss tērzēšanu. → [A2A serveris](docs/frameworks/A2A-SERVER.md)
- **🛂 Adaptīvā uzņemšana un pārslodzes aizsardzība** — resursietilpīgi tērzēšanas pieprasījumi tiek likti rindā, nevis atgriež 503, ar atomiskām RPM mainīgām īrēm uz savienojumu. → [Noturības ceļvedis](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanoniskā `/v1/models` secība** — viens nepārtraukts, pēc nodrošinātāja grupēts bloks katram nodrošinātājam (kombinācijas piespraustas pirmās), stabils visos kataloga avotos. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🗜️ Saspiešanas nostiprināšana** — pēc noklusējuma ieslēgts inflācijas aizsargs, Caveman pakas DE / FR / JA + ķīniešu (wényán), RTK filtri Gradle & .NET. → [Saspiešana](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Godīgas fiksētas likmes izmaksas** — abonementa / kodēšanas plāna nodrošinātāji izmaksu analītikā rāda **$0**; budžets, kvota un maršrutēšana turpina veikt aplēses. → [API atsauce](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share maršrutēšana** — godīgi sadaliet koplietotā konta kvotu starp apvienotajām atslēgām, darbu saglabājoši, tā ka dīkstāves daļas tiek aizdotas citiem. → [Noturības ceļvedis](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 CLI/aģenta iestatīšana ar vienu komandu** — 15 reģistrētas `setup-*` komandas; `omniroute run` palaiž 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` atbalsta 11 mērķus ar interaktīvu nodrošinātāja+modeļa atlasītāju un favorītiem pa kontekstiem. → [CLI integrācijas](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Attālinātais režīms** — vadiet attālinātu OmniRoute ar ierobežotas darbības jomas tokeniem (`connect` / `contexts` / `tokens`) + `antigravity` OAuth palīgu VPS instalācijām. → [Attālinātais režīms](docs/guides/REMOTE-MODE.md)
- **🧭 Gudrāka automātiskā maršrutēšana** — `auto/:` kombinācijas, **Fusion** (modeļu panelis + tiesnesis), uzdevumam atbilstoša maršrutēšana, modeļa / režīma / USD budžeta pārrakstīšana pa pieprasījumiem. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Piespraužamā saspiešana** — 12 kombinējami dzinēji + Compression Studios: LLMLingua-2, divlīmeņu Ultra, omniglyph, precizitātes slieksnis pa soļiem, GCF v3.2, vilkšanas pārkārtošanas redaktors. → [Saspiešana](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Caurspīdīga MITM atšifrēšana (TPROXY)** — uztveriet CLI, kas ignorē starpniekservera vides mainīgos, ar CA pa SNI + 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 HIT ietaupījumu galvene, USD tēriņu kvotas pa atslēgām. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🧠 Atmiņa, ko kontrolējat jūs** — pēc noklusējuma izslēgta, opt-in int8 vektoru kvantizācija + tipizēta novecošana, `x-omniroute-no-memory` pa pieprasījumiem. → [Atmiņa](docs/frameworks/MEMORY.md)
- **🛡️ Drošība** — uzvedņu injekcijas aizsargs katrā LLM maršrutā (red-team komplekts), opt-in akreditācijas datu maskēšanas aizsargmehānisms (rediģē noplūdušās API atslēgas/noslēpumus abos virzienos), bezmaksas DuckDuckGo pēdējās instances tīmekļa meklēšana un izvēles OIDC pieteikšanās vārti 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 stilā) papildina multivides virsmu. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🎨 Attēlu / video / audio ģenerēšana** — viena API multividei: xAI Grok Imagine & Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind un runas nodrošinātāji, piemēram, ElevenLabs. → [API atsauce](docs/reference/API_REFERENCE.md)
- **🌍 Izvietošana un ekspluatācija** — reversā starpniekservera `basePath`, pārlūkprogrammas valodas automātiska noteikšana, ierīču izsekošana pa atslēgām, MITM uzticamība bez root, 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ūkprogrammas + OAuth pieteikšanos, Ollama pirmās klases kartīte, Claude Opus 5 & Sonnet 5, Kimi oficiālā partnerība (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… un atsvaidzināts **375 nodrošinātāju katalogs**. → [Nodrošinātāji](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Maršrutēšanas caurspīdīgums** — katra atbilde nes `X-OmniRoute-Decision` galveni, kas nosauc to apkalpojošo stratēģiju/nodrošinātāju/latentumu, jauna `cache-optimized` kombinētā stratēģija + Auto-Combo `cacheAffinity` faktors novirza atkārtotus pieprasījumus atpakaļ uz savienojumu, kas glabā kešatmiņā esošo prefiksu, un tikai lasāms `/v1/auto-combo/{channel}/candidates` galapunkts atklāj `auto/*` kanāla reāllaika 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, Bifrost un Mux kā uzraudzīti iegultie pakalpojumi. → [Iegultie pakalpojumi](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Arī komplektā** — spraudņu ietvars + tirgusvieta, Omni/Agent/GitHub prasmju ietvari, Obsidian vault 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ānots žurnālu eksports uz BigQuery, `auto/chaos` paralēlā vairāku modeļu izkliede, Telegram bota 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 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 atsevišķi, bet Qwen/Gemini saņem vienreizlietojamu, 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 # arī: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Katra komanda izmanto aktīvo attālo kontekstu (`omniroute connect `), `--dry-run`
priekšskata precīzos vides mainīgos/argumentus bez izpildes, savukārt `--api-key-env NAME` neļauj noslēpumiem
nonākt čaulas vēsturē. → [CLI integrācijas](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 AI nodrošinātāji — 153 katalogā atzīmēti kā bezmaksas
> **375 reģistrēti nodrošinātāji** kanoniskajās tērzēšanas, multivides, meklēšanas, lokālo, mākoņa aģentu un sistēmas kolekcijās, tostarp **153 ar `hasFree: true` atklāšanas metadatiem**. Tērzēšanas modeļu reģistrs ietver **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 **467 rindas pa modeļiem**, **34 atkārtoti baseini** un **51 atkārtoti/bez atslēgas bezmaksas uz mūžu nodrošinātāji**. Tie apzināti ir atšķirīgi saucēji; definīcijas un ar baseinu deduplikāciju veiktie aprēķini atrodami [Nodrošinātāju atsaucē](docs/reference/PROVIDER_REFERENCE.md) un [Bezmaksas līmeņos](docs/reference/FREE_TIERS.md).
### 🏢 Visas nozīmīgākās laboratorijas — viena galapunkta starpniecībā
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 reāllaikā tiek ielādēta no informācijas paneļa nodrošinātāju kataloga. 📖 [Nodrošinātāju atsauce](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Bezmaksas uz mūžu — $0, bez kartes
OpenCode Zen DeepSeek V4, Nemotron 3 Bez tokenu ierobežojuma
Kilo Code Automātiskais maršrutētājs, Tencent Hy3 Bezmaksas uz mūžu
Requesty GPT-OSS 120B, Nemotron Bezmaksas uz mūžu
SiliconFlow DeepSeek V3.2 / R1 Bezmaksas līmenis
Z.AI GLM GLM-4.7 / 4.5-Flash Bezmaksas uz mūžu
Baidu ERNIE ERNIE 4.0 Bezmaksas uz mūžu
Qoder AI Qwen3-Max, Kimi-K2 Neierobežots BEZMAKSAS
Pollinations GPT, Llama, Claude Atslēga nav nepieciešama
Cloudflare AI 50+ modeļi 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 # 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)
## 🗜️ Ietaupiet 15–95% tokenu — automātiski
### 📖 Kā tas darbojas — konveijers, arhitektūra un ietaupījumu matemātika
Noklusējuma kombinētā konfigurācija izpilda `RTK → Caveman`. Kad abi darbojas ar vienu un to pašu rīku/konteksta slodzi, ietaupījumi reizinās:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Koda bloki, URL adreses, JSON un strukturēti dati ir **vienmēr aizsargāti** ar saglabāšanas dzinēju.
> **Kāpēc tērēt daudz tokenu, ja pietiek ar maz?** Katrs pieprasījums iziet caur OmniRoute saspiešanas konveijeri **pārredzami** — bez jebkādām izmaiņām klienta pusē. Tas tagad ir **12 kombinējamu dzinēju steks**, kas darbojas secībā un tiek brīvi kombinēts katrā maršrutēšanas kombinācijā — balstoties idejās 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 steks
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
Izmet saturu, kas atkārtojas vairākos gājienos (adresēts pēc satura, starp gājieniem)
2
CCR
Arhivē lielus blokus aiz izguves marķieriem; izgūstami pēc pieprasījuma
3
Lite
Tukšatstarpju + attēlu URL apgriešana (bāzes variants ar minimālu aizturi)
4
RTK
Viedā rīku rezultātu filtrēšana, dublējumu noņemšana un nogriešana (apzinās komandas)
ML semantiskā iztīrīšana ar MobileBERT ONNX — droša kodam, asinhrona
11
Ultra
Heuristiska tokenu iztīrīšana ar neobligātu mazmodeļa (SLM) līmeni
12
OmniGlyph
Eksperimentāla konteksta kā attēla kodēšana izmērītajam Claude Fable 5 tiešajā Anthropic savienojumā; GPT 5.6 transformeru modeļi paliek droši slēgti (fail-closed), gaidot nodrošinātāja apstiprinājumus. Četri saspiešanas profili (agresīvs pēc noklusējuma, sabalansēts, kodam drošs, caurlaides) (visagresīvākais; ieslēdzams pēc izvēles)
Koda bloki, URL adreses un strukturēti dati **vienmēr tiek saglabāti** ar baitu precizitāti. **Viena klikšķa sagataves** apvieno dzinējus:
Režīms
Ietaupījums
Vislabāk piemērots
🪶 Lite
~15%
Vienmēr ieslēgts, drošs noklusējums
🪨 Standard (Caveman)
~30%
Ikdienas programmēšana
⚡ Aggressive
~50%
Garas sesijas ar intensīvu rīku lietošanu
🔥 Ultra
~75%
Maksimāls ietaupījums
🧰 RTK
60–90%
Čaulas/testu/būvēšanas/git izvade
🔗 Stacked (RTK → Caveman)
78–95%
Jauktas uzvednes + rīku žurnāli
**Reāls piemērs — režīms Standard:**
> **Pirms (69 tokeni):** _"Iemesls, kāpēc jūsu React komponents tiek atkārtoti renderēts, visticamāk, ir tas, ka katrā renderēšanas ciklā jūs izveidojat jaunu objekta atsauci. Kad jūs kā rekvizītu nododat inline objektu, React seklā salīdzināšana to katru reizi uztver kā citu objektu, kas izraisa atkārtotu renderēšanu. Es ieteiktu izmantot useMemo, lai objektu memoizētu."_
>
> **Pēc (19 tokeni):** _"Jauna objekta atsauce katrā renderējumā. Inline objekts kā rekvizīts = jauna atsauce = pārrenderēšana. Ietiniet useMemo."_
>
> **Tā pati atbilde. Par 72% mazāk tokenu. Bez precizitātes zuduma.** ✅
**PT-BR piemērs — režīms [Troglodita](https://github.com/leninejunior/troglodita):**
> **Pirms (42 tokeni):** _"Problēma ir tā, 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ārtots renderējums: jauna atsauce katrā ciklā (inline objekts tiek veidots no jauna). Izmantot `useMemo`."_
>
> **Tā pati atbilde. ~70% mazāk tokenu. Tehniskā precizitāte saglabāta.** ✅
### 🎚️ Vairāk nekā 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 nonāk **ārā**:
- **🪄 Izvades stili** _(izvades ass vadība)_ — ievada deterministiskas, kešatmiņas ziņā drošas atbilžu veidošanas instrukcijas; kombinējami, katrs ar `lite` / `full` / `ultra` intensitāti. Stila pievienošana ir vienas rindiņas reģistra ieraksts:
- **Kodolīga proza** — atmet pildvārdus / artikulus / mīkstinājumus; saglabā precīzu tehnisko būtību.
- **Mazāk koda** — "slinka vecākā izstrādātāja" YAGNI: mazākā strādājošā izmaiņa, bez neprasīta karkasa.
- **Ponytail (slinkais vecākais izstrādātājs)** — kāp pa YAGNI kāpnēm, novērs pamatcēloni, mazākais strādājošais diff.
- **Man ir ADHD (vispirms darbība)** — nākamā darbība ir pirmajā vietā, soļi numurēti, viens konkrēts nākamais solis, bez ievada.
- **Kodolīgs CJK (文言)** — klasiskās ķīniešu valodas ultrakodolīgs stils (pieejams tikai lokalizācijai `zh`).
- **🎯 Adaptīvais konteksta budžets** _(regulators)_ — viena ieslēgts/izslēgts tokenu sliekšņa vietā pakāpeniski aktivizē lētākos, zudumus neradošos dzinējus tikai tiktāl, cik nepieciešams, lai **ietilptu modeļa konteksta logā**. Politika: `reserve-output` (noklusējuma, ņem vērā modeli) · `percentage` · `absolute`. Režīms: `floor` (garantē ietilpstību) · `replace-autotrigger` (jūsu skaidri izteiktā izvēle ir noteicošā) · `off` (mantotais slieksnis).
- **🎛️ Kur tiek nolemts par saspiešanu** _(prioritāte, augsta → zema)_ — katra pieprasījuma `x-omniroute-compression` galvene › maršrutēšanas kombinācijas pārdefinējums › aktīvais nosauktais profils › adaptīvais / automātiskā aktivizēšana › paneļa noklusējums › izslēgts. Lietotā konfigurācija atspoguļojas atbildes galvenē `X-OmniRoute-Compression: ; source=`.
Automātiskā aktivizēšana pēc tokenu sliekšņa, adaptīvā regulatora ieslēgšana, nosaukta profila piespraušana, vienreizējs iestatījums katram pieprasījumam vai konveijera piešķiršana katrai maršrutēšanas kombinācijai — atkarībā no tā, kas atbilst darba slodzei. Pēc izvēles pieejama bezsaistes **novērtēšanas sistēma** (`npm run eval:compression`) uz fiksēta korpusa novērtē precizitātes un ietaupījumu attiecību, pirms jūs apstiprināt 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ā sākšana
**1) Instalējiet un palaidiet**
```bash
npm install -g omniroute
omniroute
```
> 💡 Redzat `npm warn ERESOLVE` vai peer-dep brīdinājumus? [Tie ir nekaitīgi](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Vai 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ā natīvos izpildlaika failus. Globāli instalējot, atļaujiet npm brīdinājumā minētās pakotnes. Pakotņu kopai, ko norāda OmniRoute 3.8.53:
>
> ```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 turpmākajām globālajām instalācijām, konfigurējiet to vienu reizi un pēc tam instalējiet kā ierasts:
>
> ```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 citu sarakstu, izmantojiet pakotņu nosaukumus no tā brīdinājuma. Atļaujot pakotni, tiek ļauts palaist tās instalācijas skriptus.
> **Vai izmantojat Gemini Web vai citu tīmekļa sīkdatņu pakalpojumu sniedzēju?** npm pakotne ietver
> Playwright, bet ne tā Chromium bināro failu. Pirms pirmā tīmekļa pakalpojumu sniedzēja pieprasījuma skatiet
> [Playwright Chromium iestatīšanas](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> piezīmi.
Informācijas panelis: `http://localhost:20128` · API: `http://localhost:20128/v1`.
**2) Pievienojiet atbilstošu pakalpojumu sniedzēju, izmantojot savu kontu**
Informācijas panelis → **Providers** → izvēlieties sniedzēju, kura pašreizējie noteikumi un kvotas atbilst jūsu lietošanas gadījumam → pievienojiet tā API atslēgu vai pabeidziet konta iestatīšanas plūsmu. Bezmaksas līmeņiem var būt nepieciešama reģistrācija, apstiprināšana vai maksājuma metode. Skatiet [Bezmaksas līmeņu ceļvedi](docs/getting-started/FREE-TIERS-GUIDE.md); pieejamība bez atslēgas nav garantēta, un sniedzēji ar atzīmi `tos: avoid` pēc noklusējuma ir izslēgti no `auto`.
**3) Norādiet savam kodēšanas rīkam**
```txt
Base URL: http://localhost:20128/v1
API Key: [kopējiet no informācijas paneļa → Endpoints]
Model: auto (maršrutē starp atbilstošajiem savienojumiem — vai izvēlieties sniedzēju/modeli)
```
**4) Pārbaudiet, vai tas darbojas**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Jums vajadzētu redzēt savienoto modeļu sarakstu. 🎉 Tas arī viss — sāciet programmēt, un OmniRoute automātiski maršrutēs un pārslēgsies uz rezerves variantu jūsu vietā.
Ja jūsu klients nevar nosūtīt pielāgotas galvenes, OmniRoute piedāvā arī saderības aizstājējus ar tokenu:
```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, kas nevar pievienot `Authorization: Bearer ...`. Autentifikācija ar galveni 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 izpildītājs + Vitest — 56 000+ statiskas testu deklarācijas vairāk nekā 7 800 izsekotos testu failos (vienību, integrācijas, E2E, drošības, ekosistēmas)
Testu pārklājuma stratēģija vairāk nekā 56 000 statiskām testu deklarācijām vairāk nekā 7 800 izsekotos testu failos
# ⭐ Labākie līdzautori
> OmniRoute veido aizrautīga atvērtā pirmkoda kopiena. Šie cilvēki ir devuši izcilu ieguldījumu, kas tieši ietekmē projekta kvalitāti, stabilitāti un sasniedzamību. **Paldies.**
### Ārējie līdzautori pēc sapludināto pull pieprasījumu skaita
Apsekojums veikts 2026-10-18 15:09:09 UTC ar aktuālo release/v3.8.52 galotni 656f01cb43. Lapu pa lapai iegūtajā GitHub GraphQL apsekojumā ir 9,191 sapludināti PR: 3,834 no repozitorija īpašnieka, 229 no Dependabot, 6 no citiem botiem/lietotnēm un 5,122 ārējie PR no 835 dažādiem līdzautoriem. “Mainītās rindas” ir GitHub pievienoto un dzēsto rindu summa, un tajā ietilpst ģenerētie faili, lock faili, katalogi, tulkojumi un dokumentācija; tā ir izmaiņu apjoma metrika (churn), nevis autoru sarakstīto koda rindu skaits (LOC). 49 PR GitHub diff pārsniedz 500,000 rindas (piemēram, #13399 — viena pakalpojumu sniedzēja pievienošana — uzskaita 2,347 mainītus failus), kas palielina vairākas iepriekš minētās kopsummas. Vienādu rezultātu gadījumā vieta tiek dalīta.
### GitHub attiecinātie komiti
Atkārtoti pārbaudīts 2026-10-18 14:44:45 UTC: GitHub piedēvētie komiti, ko repozitorija Contributors API ziņo par noklusējuma zaru release/v3.8.52. API atgrieza 849 identitātes (429 lietotāji, 2 boti, 418 anonīmas); šajā tabulā nav iekļauts uzturētājs, boti un anonīmās identitātes, un tajā ir saglabātas dalītās vietas. Tā atšķiras gan no iepriekš redzamā apvienoto PR reitinga, gan no tālāk redzamās Git metadatu uzskaites.
> 🙏 Šo līdzstrādnieku izstrādātās funkcijas, kļūdu labojumi un infrastruktūras uzlabojumi ir **būtiska daļa** no tā, kas padara OmniRoute uzticamu un funkcijām bagātu. Ir svarīgs katrs pull request, katrs testa gadījums un katrs i18n tulkojuma fails. Atvērto pirmkodu veido tieši 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.
## 👥 900+ līdzautoru
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Audits veikts 2026-10-18 aktuālās release/v3.8.52 zara galotnes ad160ab2d1 stāvoklī (6 826 komiti): 993 normalizētas cilvēku Git identitātes — 707 ir norādītas kā komitu autori (tostarp uzturētājs), bet 286 parādās tikai tieši norādītās Co-authored-by piekabēs. Uzskaitē tiek izmantots .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 26 robotu/aģentu/pakalpojumu/vietturu identitātes, un parastās e-pasta adreses netiek apvienotas tikai tāpēc, ka sakrīt to parādāmie vārdi. 2026-08-24 auditā tika publicēts skaits 639; atkārtoti izmantojot šo metodi minētā audita bāzei ac02c5b42f, tiek iegūts skaits 619, tāpēc pieaugumu rada jauni līdzautori, nevis mazāk stingra metode.
### Kā sniegt ieguldījumu
1. Izveidojiet repozitorija atzarojumu
2. Izveidojiet zaru no **aktīvās** `release/vX.Y.Z` zara galotnes (nevis no `main`) — skatiet [Zarošanas un laidienu modeli](docs/ops/BRANCHING_MODEL.md)
3. Izveidojiet savu 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 pieprasījumu, norādot **base = attiecīgais `release/vX.Y.Z` zars**
Detalizētas vadlīnijas skatiet failā [CONTRIBUTING.md](CONTRIBUTING.md).
### Jaunas versijas izlaide
```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 aizsā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 tālāk minēto apakšsistēmu ir iedvesmojis kāds atvērtā pirmkoda projekts, kas to paveica pirmais. Katrs no tiem ir veidojis kādu konkrētu OmniRoute daļu. Šī ir mūsu pateicība tiem visiem. 🙏
> ⭐ zvaigžņu skaits pārbaudīts, izmantojot GitHub REST API, 2026. gada 18. oktobrī — piešķiriet šiem projektiem zvaigzni. Norādītais skaits ir precīzs momentuzņēmums konkrētajā datumā un laika gaitā, 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 nodrošinātāju normalizācijas modelis palīdzēja veidot mūsu maršrutēšanu.
MIT pirmkods, kas pielāgots iekļautajam ChatGPT Web → Codex Responses tiltam, tostarp pārlūka sesijas, atbilžu kadrēšanas, lietojuma un tīmekļa meklēšanas adapteriem.
Modeļi, kas pārnesti uz straumes atkopšanu, aizstājvārdiem bez spriešanas, rezerves tīmekļa meklēšanu, slīdošā loga ierobežojumiem, žurnālu rediģēšanu un pastiprinātām palaišanas plūsmām.
Tā Grok modeļu kartējumi, viltus TypeError Statsig ģenerators, pieprasījumu un ierīču noklusējuma vērtības, kā arī NDJSON atbilžu procesors tika būtiski pielāgoti OmniRoute Grok Web izpildītājam.
Galvenais netiešais pirmkoda avots, kas ir grok2api-merged pamatā; tā modeļu, galveņu, lietderīgās slodzes, Statsig un procesora implementācijas ir saglabātas Grok Web izcelsmes ķēdē.
Pamatā esošais MIT pirmkods Grok lietderīgās slodzes un ierīču noklusējuma vērtībām, Statsig ģeneratoram un result.response procesoram, kas pārmantots caur TQZHR un grok2api-merged.
Netiešs avots, ko grok2api-merged norādījis sava starpniekserveru pūla slāņa izcelsmei; OmniRoute saglabā šo izcelsmes norādi, taču neapgalvo, ka tā ierobežotajā Grok Web izpildītājā būtu pārnests starpniekserveru pūls.
Sākotnējā Grok Web implementācija izmantoja tā HTTP/pārlūka augšupstraumes dizainu; tās tiešais HTTP ceļš ir atvasināts no GrokProxy, tāpēc netiek apgalvots, ka būtu veikts neatkarīgs koda ports.
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 kondensēšanas kārtulu pamatā.
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.
Vīrusu popularitāti ieguvusī „slinkā vecākā izstrādātāja” YAGNI kodēšanas prasme — iedvesmoja mūsu less-code izvades stilu: virzību uz mazākajām funkcionējošajām izmaiņām, kas samazina _ģenerētā_ koda apjomu (izvades ass līdzinieks Caveman lakoniskajai prozai).
Saturu izprotoša izvades saspiešana katram faila tipam ar kļūmes apzinātu atteikšanos — apstiprināja mūsu tipam atbilstošo maršrutēšanu un saspiešanas izlaišanu, ja ieguvums ir pārāk mazs.
Rust kolonnveida JSON, pēc 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 datplūsmas inspektora 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 caurlaides saskarnes (passthrough.ts un _internal/bypass.cjs) joprojām ir neatkarīgi klasificētas OmniRoute iekšējās implementācijas; šī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 darbības pārtraukšanu, ligzdu dīkstāves noildzes, procesu attiecināšanu, izmantojot /proc, un TPROXY tvēršanu.
### 📚 Modeļu dati, novērojamība un lietotāja saskarne
Atlasīts pēc noklusējuma drošu bibliotēku saraksts, kas nosaka mūsu drošības risinājumu izvēli (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).