## 💰 ~1.62B tokenit kuus kolmandate osapoolte tasuta kasutustasemetelt
> **Kasuta oma teenusepakkujate kontosid.** See on eraldi kvalifitseeruvate kolmandate osapoolte tasuta kasutustasemete hinnanguline kogumaht, mitte OmniRoute'i antav tokenikogus. Registreeru, hangi vajaduse korral pääsuandmed ja ühenda teenusepakkujad, mida saad kasutada; iga teenusepakkuja määrab ise oma piirangud, saadavuse ja tingimused.
>
> Tasuta kasutustasemete käsitsi ühendamine on vaevarikas — kümneid SDK-sid, kümneid päringusageduse piiranguid ja puudub ülevaade sellest, kui palju sul tegelikult kasutada on. OmniRoute kataloogib **489 tasuta kasutustaseme kirjet 35 korduva ressursikogumi võtme lõikes** ning arvutab tokenite koondnäitaja **17 ressursikogumi põhjal, millel on avaldatud positiivne kuueelarve, ning lisaks viie mudelipõhise Groqi piirangu põhjal**, eemaldades ühiste ressursikogumite duplikaadid. Kvoodid, mis avanevad alles pärast piirkondliku identiteedi kontrollimist (praegu: ModelScope), kuvatakse eraldi — +~6M pärast piirkondliku identiteedi kinnitamist — ning neid ei liideta kunagi koondnäitajale. Tulemus on alati nähtav töölaual (`/dashboard/free-tiers`).
> Reaalajas `/dashboard/free-tiers` lehe animeeritud kokkuvõte. Täielik metoodika (ressursikogumite duplikaatide eemaldamine, krediiditasemed, teenusepakkujate tingimused): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Neid näitajaid auditeeritakse iga kahe nädala järel aktiivse kataloogi põhjal uuesti ja need **muutuvad mõlemas suunas** — kui teenusepakkuja lõpetab tasuta kasutustaseme, siis arv väheneb; kui lisandub uus, siis see suureneb. Avaldame alati selle, mida kataloog tegelikult arvutab, mitte ülespoole ümardatud parimat võimalikku tulemust.
⭐ Lisa repositooriumile tärn, kui OMNIROUTE aitas sul raha säästa ja töö lihtsamaks muuta.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Liitu kogukonnaga
**👋 Jälgi hooldajat — saa uutest teenusepakkujatest, väljalasetest ja nõuannetest teada esimesena:**
[](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)
**Küsimused, teenusepakkujate nõuanded, tegevuskava ja tugi → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Ülemaailmne](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasiilia](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portaal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Lüüs jätkab kasvamist
## 🆓 Paigalda, ühenda teenusepakkuja ja seejärel suuna päringud läbi ühe lõpp-punkti
```bash
# Pärast teenusepakkuja ühendamist kopeeri oma OmniRoute'i võti juhtpaneeli jaotisest 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` vajab sobilikku marsruuti. Värskel paigaldusel ei pruugi olla ühtegi sobilikku võtmeta sihtmärki ning võtmeta teenusepakkuja võib kolmandate osapoolte kliendid tagasi lükata. Märkega `tos: avoid` teenusepakkujad, sealhulgas OpenCode Free ja Kiro, jäetakse vaikimisi automaatsest marsruutimisest välja; konto ühendamine ei alista seda seadistust. Enne teenusepakkuja valimist tutvu [tasuta pakettide juhendiga](docs/getting-started/FREE-TIERS-GUIDE.md).📦 Kopeeritavad ja käivitatavad kiirstardiskriptid **Pythoni, Node.js-i, PHP ja cURL-i** jaoks → [`examples/quickstart/`](examples/quickstart/)
# 💥 Lubadus
# 🤔 Miks OmniRoute?
## 🤝 Meie avatud lähtekoodiga sõprade toetusel
> **Kas soovite liituda avatud lähtekoodiga sõbrana?** Need on ettevõtted, kes toetavad avatud lähtekoodi ja aitavad OmniRoute'i arengut jätkata — ning me avalikustame, milleks iga nende antud token kulub. Võtke ühendust: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Täname Kimit (Moonshot AI), meie asutajast avatud lähtekoodiga sõpra, selle projekti toetamise eest! Kimi on avatud kaaludega K2 ja K3 mudeliperekondade taga olev tehisintellektilabor — Kimi K3 pakub 1M-tokeni kontekstiakent, loomulikku pilditöötlust ja tipptasemel programmeerimisvõimekust murdosa eest suletud mudelite hinnast ning töötab kohe Claude Code'i, Codexi ja kõigi OmniRoute'i toetatavate programmeerimistööriistadega.
Mida Kimi toetus võimaldab: Kimi API-krediidid käitavad OmniRoute'i tehisintellektiga valideeritud väljalaskekonveierit — etappi ühendamise valideerimine Kimi K3 abil, mis kontrollib iga tõmbetaotlust enne selle avaldamist — ning toetavad igapäevast funktsioonide arendust. Kimi esmaklassiline tugi on saadaval mõlema kanali kaudu: otse Kimi API (kimi-k3) ja Kimi Code'i programmeerimispaketi kaudu (OAuth ja API-võti). OmniRoute on ka esimene Brasiilia avatud lähtekoodiga projekt Kimi toetusprogrammis. Hankige Kimi API-võti koos 15% lisakrediidiga →
Cheaper Inference cheaperinference.com
Täname Cheaper Inference'it, OmniRoute'i avatud lähtekoodiga sõpra, selle projekti toetamise eest! Cheaper Inference on hinna järgi optimeeritud lüüs, mis pakub ühe OpenAI-ga ühilduva lõpp-punkti kaudu edasi 42 tipptasemel mudelit — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ja MiniMax — suunates iga päringu odavaima sobiva teenusepakkuja juurde, küsimata kunagi mudeli looja hinnakirjahinnast rohkem.
Esmaklassiline tugi OmniRoute'is: vestluse lõpuleviimised, loomulik /v1/responses lõpp-punkt, pilditöötlus, tööriistakutsed ja 3 pildimudelit (grok-imagine, nano-banana-pro, nano-banana-2, millele pääseb juurde kujul cheaperinference/<model>). Hankige API-võti →
Märgisega aff=omniroute lingid on partnerlingid. Need rahastavad projekti ilma teile lisakulusid tekitamata. 🎟️ Partnerite kampaania — tasuta registreerumiskupongid teenusepakkujatelt, keda me ei sponsoreeri (laiendamiseks klõpsake)See jaotis on mõeldud ainult soovitus- ja kupongikoodidele. Sponsitud partnerlused asuvad ülal jaotises 🤝 Meie avatud lähtekoodiga sõprade toetusel. OmniRoute'il ei ole siin loetletud teenusepakkujatega sponsorlus- ega partnerlussuhet — need on avalikud kupongid, mida igaüks saab kasutada.
AgentRouter agentrouter.org
AgentRouter — partneri kaudu registreerumine · registreerumisel $100 tasuta krediiti (tasuta server, arvestage suurema latentsusega — sobib kõige paremini testimiseks, mitte tootmiskeskkonda). Esmaklassiline tugi OmniRoute'is alates versioonist v3.8.50: vestluse lõpuleviimised, Anthropicuga ühilduv andmevahetusvorming ja OpenAI-ga ühilduv tee. Saadaolevate mudelite hulka kuuluvad claude-opus-4-8, claude-opus-5, gpt-5.6-sol ja teised. Võtke oma $100 →
⚠️ Partnerlink — OmniRoute'il ei ole selle teenusepakkujaga sponsorlus- ega partnerlussuhet.
Kas teate mõnda teist teenusepakkujat, kellel on helde tasuta registreerumiskupong, millest OmniRoute'i kasutajad kasu saaksid? Avage probleem ja me lisame selle siia.
## 🎯 Kombod — lipulaev
> **Kombo** on mudelite ahel, mille vahel OmniRoute päringuid **automaatselt** marsruudib. Kui kvoot saab otsa, teenusepakkuja tõrgub või kulud järsult kasvavad, saab kombo liikuda järgmise sobiva ja töökorras mudeli juurde. 🛡️
### ⚡ Nullseadistus — kasutage lihtsalt mudelit `auto`
Kombot pole vaja luua. Määrake oma mudeliks `auto` (või mõni selle variant) ja OmniRoute koostab teie ühendatud teenusepakkujatest virtuaalse kombo, mida hinnatakse reaalajas:
Mudeli ID
Mille jaoks see optimeerib
auto
🎯 Tasakaalustatud vaikevalik (LKGP — jääb viimase toimiva teenusepakkuja juurde)
auto/coding
🧑💻 Koodi genereerimisel kvaliteeti eelistavad kaalud
auto/fast
⚡ Esmalt väikseim latentsus
auto/cheap
💰 Esmalt väikseim hind tokeni kohta
auto/offline
🔋 Esmalt suurim kvoodi-/päringulimiidi varu
auto/smart
🔭 Esmalt kvaliteet + 10% katsetamist paremate mudelite leidmiseks
auto/lkgp
📌 Selgesõnaline eelistus jääda viimase teadaolevalt toimiva teenusepakkuja juurde
auto/chaos
🧪 Paralleelne hargnemine mudelite paneelile (üks teenusepakkuja kohta, vaikimisi 5), tagastab ühe vastuse; üks ülesvoolupäring iga paneeli mudeli kohta, mitte tõrgete tekitamine
##
### 🔀 Või looge oma kombo — 19 marsruutimisstrateegiat
Kõik **19** strateegiat — kombineerige neid kombo igas etapis:
#
Strateegia
Mida see teeb
1
priority
Esimest sihtmärki eelistav järjestatud loend — ammendab igaühe enne järgmise juurde liikumist 🥇
2
fill-first
Kasutab iga sihtmärgi kvoodi täielikult ära enne järgmise juurde liikumist
3
weighted
Kaalutud juhuvalik sihtmärgi kaalu järgi
4
round-robin
Liigub sihtmärkide vahel järjekorras ringiratast
5
p2c
Kahe juhuvaliku põhine koormuse tasakaalustamine
6
least-used
Valib väikseima praeguse koormusega sihtmärgi
7
random
Ühtlane juhuvalik (duplikaadid eemaldatakse)
8
strict-random
Juhuvalik kordusi eemaldamata 🎲
9
cost-optimized
Minimeerib reaalajas kataloogihindade põhjal päringu maksumust dollarites 💸
10
headroom
Valib suurima allesjäänud kvoodiga sihtmärgi
11
reset-window
Eelistab sihtmärki, mille kvoodiaken lähtestub kõige varem
12
reset-aware
Järjestab kvoodi lähtestamise aja järgi — lühikesed aknad esimesena 📊
13
context-relay
Annab pikkade vestluste konteksti sihtmärkide vahel edasi 🧠
14
context-optimized
Valib praeguse konteksti suurusega kõige paremini sobiva sihtmärgi
15
cache-optimized
Seob iga korduskasutatava viiba prefiksi sama kontoga — maksimeerib viibavahemälu tabamusi 🎯
16
lkgp
Viimane teadaolevalt toimiv tee — seob viimase eduka teenusepakkujaga, seejärel kasutab varuvariandina reegleid
17
auto
Reaalajas hindamine 16 teguri põhjal kõigi ühenduste lõikes 🤖
18
fusion
Hargneb mudelite paneelile + hindaja sünteesib ühe vastuse 🧬
19
pipeline
Aheldab etapid — iga sihtmärgi väljund edastatakse järgmisele 🔗
Auto-Combo mootor hindab iga kandidaati **16 teguri** põhjal (tööseisund, kvoot, maksumus, latentsus, ülesandega sobivus, kvaliteet, seansi saadavus…) — vaadake faili [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Tõrkekindlus on sisse ehitatud (3 sõltumatut kihti)
📖 [Automaatse kombineerimise mootor](docs/routing/AUTO-COMBO.md) · [Töökindluse juhend](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Mille poolest OmniRoute eristub
📊 Täielik metoodika ja funktsioonipõhised üksikasjad võrreldes 9routeri, OpenRouteri, CLIProxyAPI ja LiteLLM-iga → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Toetage OmniRoute'i
OmniRoute'il on MIT-litsents ja seda hooldatakse avalikult. Kui see säästab teie aega või raha, saate selle sõltumatuna hoidmiseks valida endale sobiva viisi. Sponsorlus ei mõjuta kunagi marsruutimise prioriteeti; see annab nähtavust, mitte paremat järjestust.
⚠️ Saatke iga krüptovaluuta ainult näidatud võrgu kaudu — valesse võrku saatmisel võivad vahendid kaotsi minna.
🐛 Leidsite vea või soovite tagasisidet anda? Avage [arutelu](https://github.com/diegosouzapw/OmniRoute/discussions).
Arendaja märkused: Projekt võib npm-i installimise/järelinstallimise ajal arendaja mugavuse huvides genereerida kohaliku .env-faili. Seda faili eiratakse teadlikult .gitignore-faili kaudu (vt .gitignore) ja seda ei tohi kunagi hoidlasse sisse kanda — kui see kogemata sisse kantakse, muutke kõiki avalikuks saanud saladusi ja eemaldage fail ajaloost. Kohalike keskkonnafailide ja saladuste haldamise juhiseid vaadake failist docs/DEVELOPER-ENVIRONMENT.md.
## 📡 OmniRoute Radar
Peamine tasuta taseme näitaja on endiselt **~1.62B tokenit kuus**, tuginedes eespool dokumenteeritud ja
kogumite lõikes duplikaatidest puhastatud kataloogile. Teenusepakkujate ajutised registreerumiskrediidid võivad esimesel
kuul seda eraldi suurendada **~2.22B** tokenini. Radar on valikuline allkirjastatud kataloogikiht neile, kes soovivad
OmniRoute'i väljalasete vahel ajakohasemat tasuta mudelite saadavuse teavet; kogukonna kataloog ja kõik olemasolevad tasuta
funktsioonid jäävad tasuta kättesaadavaks.
Toetajad võivad saada reaalajas kataloogi ja täiendavaid teenusepakkujate võimalusi. Selle eraldiseisev,
muutuv ülempiir on olenevalt teenusepakkujate saadavusest **maksimaalselt ligikaudu 3B tokenit kuus**.
See ülempiir ei ole garantii: teenusepakkujad võivad igal ajal muuta kvoote, sobivusnõudeid, mudeleid või
piirkondi.
Radar on vabatahtlik ja kasutab ainult GET-päringuid. OmniRoute'i klient ei laadi üles viipasid, liiklust, teenusepakkuja
konfiguratsiooni, kasutustelemeetriat ega teadete eiramise kohalikku olekut. Sobivusnõuete ja
praeguse kataloogi kohta leiate teavet aadressilt **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ Mis on uut
> Viimase aja olulisemad muudatused versioonides **v3.8.20 → v3.8.50**. Täielik ajalugu on failis [`CHANGELOG.md`](CHANGELOG.md).
- **🎛️ OmniConductor** — sissetulevate A2A-päringute delegeerimine teie agentide parvele, Conductor-oskused agendikaardil ning juhtpaneeli paneel Faro kõnelemiseks vajutatava nupuga häälvestluse jaoks. → [A2A-server](docs/frameworks/A2A-SERVER.md)
- **🛂 Kohanduv vastuvõtt ja ülekoormuskaitse** — ressursimahukad vestluspäringud suunatakse 503-vea tagastamise asemel järjekorda ning iga ühenduse jaoks kasutatakse atomaarseid RPM-i libisevaid rendiperioode. → [Töökindluse juhend](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanooniline `/v1/models` järjestus** — iga pakkuja kohta üks katkematu pakkuja järgi rühmitatud plokk (kombinatsioonid kinnitatakse ettepoole), mis püsib kõigis kataloogiallikates stabiilsena. → [API viide](docs/reference/API_REFERENCE.md)
- **🗜️ Tugevdatud tihendus** — vaikimisi sisse lülitatud mahu paisumise kaitse, Caveman-paketid DE / FR / JA + hiina keele (wényán) jaoks ning RTK-filtrid Gradle’i ja .NET-i jaoks. → [Tihendus](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Aus kindlasummalise paketi kulu** — tellimuse- ja programmeerimispakettide pakkujate kuluanalüütikas kuvatakse **$0**; eelarve, kvoot ja marsruutimine jätkavad hinnangute arvutamist. → [API viide](docs/reference/API_REFERENCE.md)
- **⚖️ Kvoodiosaku põhine marsruutimine** — jagatud konto kvoot jaotatakse koondatud võtmete vahel õiglaselt ning jõude seisvad osakud laenatakse töö säilitamiseks välja. → [Töökindluse juhend](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 CLI/agentide seadistamine ühe käsuga** — 13 registreeritud `setup-*` käsku; `omniroute run` käivitab 7 CLI-d (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` toetab 10 sihtmärki koos interaktiivse pakkuja ja mudeli valija ning kontekstipõhiste lemmikutega. → [CLI-integratsioonid](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Kaugerežiim** — juhtige OmniRoute’i kauginstallatsiooni piiratud õigustega lubade (`connect` / `contexts` / `tokens`) ja VPS-installide jaoks mõeldud `antigravity` OAuthi abivahendi kaudu. → [Kaugerežiim](docs/guides/REMOTE-MODE.md)
- **🧭 Nutikam automaatne marsruutimine** — `auto/:` kombinatsioonid, **Fusion** (mudelipaneel + hindaja), ülesandeteadlik marsruutimine ning päringupõhised mudeli, režiimi ja USD-eelarve alistused. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Laiendatav tihendus** — 12 kombineeritavat mootorit + Compression Studios: LLMLingua-2, kahetasemeline Ultra, omniglyph, iga etapi täpsusvärav, GCF v3.2 ja lohistamisega järjestatav redaktor. → [Tihendus](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Läbipaistev MITM-dekrüptimine (TPROXY)** — püüdke kinni CLI-de liiklus, mis eiravad puhverserveri keskkonnamuutujaid; sisaldab SNI-põhist CA-d ja usaldushoidla paigaldajat. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Kulutelemeetria kõikjal** — `X-OmniRoute-*` kulu-/kasutuspäised igal lõpp-punktil, cache-HIT-i säästupäis ja võtmepõhised USD-kulukvoodid. → [API viide](docs/reference/API_REFERENCE.md)
- **🧠 Teie kontrollitav mälu** — vaikimisi välja lülitatud, valikuline int8 vektorkvantimine koos tüübipõhise aegumisega ning päringupõhine `x-omniroute-no-memory`. → [Mälu](docs/frameworks/MEMORY.md)
- **🛡️ Turvalisus** — käsuviiba süstimise vastane kaitse igal LLM-marsruudil (red-team testikomplekt), valikuline pääsuandmete maskeerimise kaitsemeede (eemaldab lekkinud API-võtmed ja saladused mõlemas suunas), tasuta DuckDuckGo viimase võimaluse veebiotsing ning juhtpaneeli valikuline OIDC-sisselogimisvärav (parooliga sisselogimine jääb alati saadavale). → [Kaitsemeetmed](docs/security/GUARDRAILS.md)
- **🖼️ Uued lõpp-punktid** — `/v1/ocr` (Mistral OCR) ja `/v1/audio/translations` (Whisperi laadis) täiendavad meediumifunktsioonide valikut. → [API viide](docs/reference/API_REFERENCE.md)
- **🎨 Piltide / videote / heli genereerimine** — üks API kogu meedia jaoks: xAI Grok Imagine’i ja Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind ning kõneteenuste pakkujad, nagu ElevenLabs. → [API viide](docs/reference/API_REFERENCE.md)
- **🌍 Juurutamine ja käitus** — pöördpuhverserveri `basePath`, brauseri keele automaatne tuvastamine, võtmepõhine seadmete jälgimine, juurkasutaja õigusteta MITM-usaldus ning zh-TW lokaliseerimine. → [Keskkond](docs/reference/ENVIRONMENT.md)
- **🤝 Rohkem pakkujaid ja agente** — pilveagendid (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) koos brauseri ja OAuth-sisselogimisega, Ollama täisväärtuslik kaart, Claude Opus 5 ja Sonnet 5, ametlik partnerlus Kimiga (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… ning värskendatud **352 pakkujaga kataloog**. → [Pakkujad](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Marsruutimise läbipaistvus** — iga vastus sisaldab `X-OmniRoute-Decision` päist, mis nimetab selle teenindanud strateegia, pakkuja ja latentsuse; uus `cache-optimized` kombinatsioonistrateegia ning Auto-Combo `cacheAffinity` tegur suunavad korduspäringud tagasi ühendusele, mis hoiab vahemällu salvestatud prefiksit, ja kirjutuskaitstud `/v1/auto-combo/{channel}/candidates` lõpp-punkt avaldab `auto/*` kanali reaalajas kandidaadikogumi. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Kohalik jõudlus ja taristu** — ühe klõpsuga kohalik Redis, Cloudflare Workersi / Deno Deploy releejuurutajad ning Bifrost ja Mux järelevalvega sisseehitatud teenustena. → [Sisseehitatud teenused](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Lisaks sisaldub paketis** — pluginate raamistik + turg, Omni/Agendi/GitHubi oskuste raamistikud, Obsidiani hoidla integratsioon (22 MCP-tööriista), OpenAI-ga ühilduvad Batch- ja Files-API-d, semantiline vastuste vahemälu, edetabelitega mängustamine, ACP-agentide avastamine (15 sisseehitatud agenti), ajastatud logide eksport BigQuerysse, `auto/chaos` paralleelne hargnemine mitmele mudelile, Telegrami botisild, rakendusesisene versioonihaldur ning LMArena-ELO tasuta pakkujate edetabelid. → [Dokumentatsioon](docs/README.md)
## 🤖 Ühilduvad CLI-d ja programmeerimisagendid
> Üks konfiguratsioon — `http://localhost:20128/v1` — ja **iga** tehisintellektil põhinev IDE või CLI töötab tasuta ja soodsate mudelitega.
**Käivitage OmniRoute’i kaudu mis tahes toetatud CLI ühe käsuga** — konfiguratsioonifaile ei kirjutata,
identimisteave edastatakse igale protsessile eraldi ning Qwen/Gemini saavad ajutise isoleeritud kodukataloogi:
```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"
# Või valige teenusepakkuja ja mudel interaktiivselt ning kirjutage tööriista enda konfiguratsioon:
omniroute configure codex # samuti: claude opencode qwen aider goose gemini cline continue kilo
```
Iga käsk kasutab aktiivset kaugkonteksti (`omniroute connect `), `--dry-run`
näitab enne käivitamist täpseid keskkonnamuutujaid ja argumente ning `--api-key-env NAME` hoiab saladused
teie shell’i ajaloost eemal. → [CLI-integratsioonid](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 tehisintellekti pakkujat — 154 kataloogis tasuta teenusena märgitud
> **372 registreeritud pakkujat** kanoonilistes vestlus-, meedia-, otsingu-, kohalike, pilveagentide ja süsteemide kogudes, sealhulgas **154 pakkujat, mille otsingu metaandmetes on `hasFree: true`**. Vestlusmudelite register hõlmab **237 pakkujat / 3 009 unikaalset pakkuja-mudeli paari / 1 443 töötlemata mudeli ID-d**; eraldi tasuta mahu kataloogis on **491 mudelipõhist rida**, **35 korduvat ressursside kogumit** ja **54 korduvat või võtmeta, alatiseks tasuta pakkujat**. Need nimetajad on taotluslikult erinevad; definitsioonid ja ressursside kogumite duplikaate eemaldavad arvutused leiate dokumentidest [Pakkujate teatmik](docs/reference/PROVIDER_REFERENCE.md) ja [Tasuta paketid](docs/reference/FREE_TIERS.md).
### 🏢 Kõik suuremad laborid — ühe lõpp-punkti kaudu
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…ja veel üle 330 — kõik ikoonid laaditakse reaalajas juhtpaneeli pakkujate kataloogist. 📖 [Pakkujate teatmik](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Alatiseks tasuta — $0, kaarti pole vaja
OpenCode Zen DeepSeek V4, Nemotron 3 Tokenipiiranguta
Kilo Code Automaatne ruuter, Tencent Hy3 Igavesti tasuta
Requesty GPT-OSS 120B, Nemotron Igavesti tasuta
SiliconFlow DeepSeek V3.2 / R1 Tasuta pakett
Z.AI GLM GLM-4.7 / 4.5-Flash Igavesti tasuta
Baidu ERNIE ERNIE 4.0 Igavesti tasuta
Qoder AI Qwen3-Max, Kimi-K2 Piiramatult TASUTA
Pollinations GPT, Llama, Claude Võtit pole vaja
Cloudflare AI Üle 50 mudeli 10 000 neuronit päevas
### 🧩 Uus: OmniRoute VS Code'i natiivses Copilot Chatis
> Ei mingit uut külgriba ega uut vestlusliidest — iga OmniRoute'i pakutav mudel kuvatakse otse
> **Copilot Chati mudelivalijas, mida sa juba kasutad**. Alates VS Code 1.122-st töötavad teenusepakkujate mudelid
> ilma GitHubi sisselogimise või Copiloti tellimuseta — agendirežiim, tööriistade kutsumine ja piltnägemine
> tasuta.
Installi laiendus **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, suuna see
oma OmniRoute'i serverile (vaikimisi `localhost:20128`) ja seejärel ava Copilot Chat → mudelivalija
→ **Halda mudeleid…** → **OmniRoute**.
Redaktoris ava vaade **Laiendused**, otsi märksõna **„OmniRoute”** ja klõpsa **Installi**
— see töötab mõlemas poes ühtemoodi. Lähtekood, probleemid ja avaldamise tegevusjuhend asuvad aadressil
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Code Copilot Chati juhend](docs/guides/VSCODE-COPILOT.md) — seadistamine, mida valija näitab, juhtpaneel vahekaardil, tõrkeotsing
### 🎩 Uus: OmniRouteTray — sinu lüüs, mis elab menüüribal
> `omniroute serve` töötab kõige paremini siis, kui see on alati sisse lülitatud. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> muudab selle macOS-i menüüribarakenduseks, mille saad seadistada ja unustada: see käivitab serveri, hoiab seda töös
> ka pärast taaskäivitamist, värskendab seda kohapeal ja teeb sinu reaalajas tokenieelarve kättesaadavaks ühe klõpsuga — **pole vaja
> terminaliakent avatuna hoida ega käsku `npm install -g omniroute` pidevalt valvata.**
See on loodud raamistikuga [Tauri v2](https://v2.tauri.app/) (Rustil põhinev tuum, mille suurus on kaduvväike) ning sisaldab
oma allkirjastatud Node 24 käituskeskkonda ja haldab rakendusele kuuluvat OmniRoute'i installi, mistõttu ei lähe see kunagi vastuollu sinu
globaalse `node`/`bun`-iga. See **kasutab sinu olemasolevat `~/.omniroute/` konfiguratsiooni ja andmebaasi** — seega on tegu
sama OmniRoute'iga, mida sa juba kasutad, ainult et nüüd on sellel müts peas. 🎩
Mida see teeb
Kuidas
🟢 Jälgib serverit
Käivitab käsu omniroute serve ja võtab juba töötava eksemplari üle, selle asemel et seda dubleerida
📊 Reaalajas kasutus ühe pilguga
Teenusepakkujate kvoodiribad, Claude'i seansi- ja nädalapiirangud koos lähtestamiseni jäänud aja loenduritega, 30 päeva kulude jaotus
🔄 Automaatsed kohapealsed värskendused
Etapiviisiline installimine, atomaarne vahetus, tõrke korral tagasipööramine — alati uusim väljalase
🚀 Käivitamine sisselogimisel
Valikuline käivitamine sisselogimisel; ainult süsteemisalves, dokiikooni pole
🩺 Diagnostika ja logid
Ühe klõpsuga diagnostika ja juurdepääs serverilogidele
```sh
brew install --cask zoispag/tap/omniroute-tray
```
Eelistad allalaadimist? Hangi uusim .dmg jaotisest
Väljalasked. Lähtekood, probleemid ja koostamise
dokumentatsioon asuvad aadressil zoispag/omniroute-tray.
💛 Kogukonnaprojekt, mille autor on @zoispag — see ei ole ametlik OmniRoute'i väljalase.
> Lisaks serverile on OmniRoute **täielik käsurea juhtimiskeskus**, millel on **üle 80 käsu**, ning see toetab avatud agendiprotokolle, et tehisintellekti agent saaks seda **iseseisvalt** juhtida.
### ⌨️ Tõeline CLI (mitte ainult `start`)
```bash
omniroute # käivita lüüs + juhtpaneel (port 20128)
omniroute chat # interaktiivne TUI-vestlusklient (kaldkriipsukäsud: /model /combo /skill /memory)
omniroute setup # juhendatud esmakäivituse viisard
omniroute doctor # diagnoosi teenusepakkujaid, porte ja omasõltuvusi
```
### 🛰️ Kaugrežiim — käivitage CLI siin, OmniRoute aga VPS-is
Kas OmniRoute töötab serveris? Juhtige seda oma sülearvutist **sama CLI-ga**. Logige ühe korra
sisse piiratud ulatusega juurdepääsutõendiga; seejärel suunatakse iga käsk kaugserverisse.
```bash
omniroute connect 192.168.0.15 # parool → piiratud ulatusega tõend, salvestatakse kontekstina
omniroute models # ← käivitatakse KAUGSERVERIS
omniroute configure codex # ← valib kaugmudeli, kirjutab kohaliku Codexi profiili
omniroute tokens create --name ci --scope read # loo teistele masinatele kitsama ulatusega tõendid
omniroute contexts use default # ← lülitu tagasi kohalikule serverile
```
Tõendite ulatus on `read` / `write` / `admin`; protsesse käivitavad marsruudid jäävad ainult tagasisideaadressile.
📖 [Kaugrežiim](docs/guides/REMOTE-MODE.md)
### 🤝 Ühendage agent — ja see juhib OmniRoute'i ise
Tehke OmniRoute kättesaadavaks **MCP**, **A2A**, **REST API**, **veebikonksude** või **kaug-CLI** kaudu — iga võimekas agent (või teie enda kood) saab juurdepääsu kogu lüüsile: marsruutimisele, teenusepakkujatele, kombinatsioonidele, vahemälule, tihendamisele ja mälule — autonoomselt. Alltoodud HTTP-lõpp-punkte teenindatakse aadressi `http://localhost:20128` all.
Liides
Lõpp-punkt / käsk
Kasutusotstarve
🧰 MCP (stdio)
omniroute --mcp
Ühendamine Claude Desktopi, Cursori või mis tahes MCP-kliendiga
🌊 MCP (HTTP)
/api/mcp/stream
Kaug-MCP — 110 tööriista, 33 ulatust (jõustamine vabatahtlik), täielik auditijälg
Päringu- ja kvoodisündmuste saatmine Slacki, Discordi, Telegrami või mis tahes URL-ile
🛰️ Kaug-CLI
omniroute connect
Kaugeksemplari juhtimine piiratud ulatusega juurdepääsutõenditega
```bash
# Anna Claude Code'ile MCP kaudu täielik OmniRoute'i tööriistakomplekt:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP-server](docs/frameworks/MCP-SERVER.md) · [A2A-server](docs/frameworks/A2A-SERVER.md) · [Agendiprotokollid](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ Säästa automaatselt 15–95% tokeneid
### 📖 Kuidas see töötab — konveier, arhitektuur ja säästuarvutus
Vaikimisi kihiline kombinatsioon käitab järjestust `RTK → Caveman`. Kui mõlemad töötlevad sama tööriista-/kontekstikoormust, säästud võimenduvad:
```txt
kombineeritud = 1 − (1 − RTK) × (1 − Caveman_sisend)
keskmine = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
vahemik = 78.4 – 94.6%
```
Koodiplokid, URL-id, JSON ja struktureeritud andmed on säilitusmootori poolt **alati kaitstud**.
> **Miks kasutada palju tokeneid, kui piisab vähestest?** Iga päring läbib OmniRoute'i tihenduskonveieri **läbipaistvalt** — klienti pole vaja muuta. Nüüd on see **12 kombineeritavast mootorist koosnev kiht**, mida käitatakse järjest ning mida saab iga marsruutimiskombinatsiooni jaoks vabalt kombineerida — tuginedes projektide [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) ja [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) ideedele.
### 🧱 12 mootorist koosnev kiht
Mootoreid käitatakse konveieri järjekorras; iga mootorit saab iga kombinatsiooni jaoks eraldi sisse või välja lülitada ja seadistada:
#
Mootor
Mida see teeb
1
Session-Dedup
Eemaldab vestlusvoorude vahel korduva sisu (sisupõhine, voorudeülene)
2
CCR
Arhiveerib suured plokid otsingumarkerite taha, kust need vajaduse korral hangitakse
3
Lite
Tühimärkide ja pildi-URL-ide kärpimine (väikese latentsusega baastase)
4
RTK
Nutikas tööriistatulemuste filtreerimine, duplikaatide eemaldamine ja kärpimine (käsuteadlik)
5
Responses Tool Output
Esmalt kadudeta JSON-i tihendamine ning piiratud diagnostiline tihendamine shelli-, paiga-, otsingu- ja ehitusväljunditele (Responses API)
6
Headroom
JSON-massiivide kadudeta tabeltihendus (~30%) kaasatud GCF-kodeki abil
7
Relevance
Lausete ekstraktiivne hindamine viimase kasutajapäringu suhtes
8
Caveman
Reeglipõhine proosatihendus (~65–75% väljundil)
9
Aggressive
Kokkuvõtete loomine ja vanade vestlusvoorude järkjärguline vanandamine
10
LLMLingua-2
ML-põhine semantiline kärpimine MobileBERT ONNX-i kaudu — kooditurvaline, asünkroonne
Katseline konteksti pildina kodeerimine mõõdetud Claude Fable 5 jaoks otseses Anthropic-ühenduses; GPT 5.6 transformaatorid jäävad teenusepakkuja kinnituste saamiseni tõrkekindlalt suletuks. Neli tihendusprofiili (vaikimisi agressiivne, tasakaalustatud, kodeerimisturvaline, muutmata edastus) (kõige agressiivsem; nõuab eraldi lubamist)
Koodiplokid, URL-id ja struktureeritud andmed säilitatakse **alati** bait-baidilt muutumatuna. **Ühe klõpsuga eelseadistused** kombineerivad mootoreid:
Režiim
Sääst
Sobib kõige paremini
🪶 Lite
~15%
Alati sisselülitatud turvaline vaikeseade
🪨 Standard (Caveman)
~30%
Igapäevane programmeerimine
⚡ Aggressive
~50%
Pikad ja tööriistarohked seansid
🔥 Ultra
~75%
Maksimaalne sääst
🧰 RTK
60–90%
Shelli-, testi-, ehitus- ja git-väljund
🔗 Kihiline (RTK → Caveman)
78–95%
Segatüüpi viibad ja tööriistalogid
**Tegelik näide — režiim Standard:**
> **Enne (69 tokenit):** _"Põhjus, miks teie Reacti komponenti uuesti renderdatakse, on tõenäoliselt see, et loote iga renderdustsükli ajal uue objektiviite. Kui edastate reasisese objekti prop'ina, näeb Reacti pindmine võrdlus seda iga kord erineva objektina, mis käivitab uue renderdamise. Soovitan objekti useMemo abil meelde jätta."_
>
> **Pärast (19 tokenit):** _"Igal renderdusel uus objektiviide. Reasisene objekt prop'ina = uus viide = uus renderdus. Kasuta useMemo't."_
>
> **Sama vastus. 72% vähem tokeneid. Täpsuskadu puudub.** ✅
**PT-BR-i näide — režiim [Troglodita](https://github.com/leninejunior/troglodita):**
> **Enne (42 tokenit):** _"Probleem on selles, et komponent renderdatakse uuesti, kuna igas renderdustsüklis luuakse uus objektiviide. Soovitaksin kasutada useMemo't."_
>
> **Pärast (12 tokenit):** _"Uuesti renderdamine: igas tsüklis uus viide (tekstisiseselt loodud objekt). Kasuta `useMemo`."_
>
> **Sama vastus. ~70% vähem tokeneid. Tehniline täpsus säilinud.** ✅
### 🎚️ Lisaks mootoritele — väljundstiilid, kohanduv regulaator ja päringupõhine juhtimine
Ülaltoodud 12 mootorit vähendavad seda, mis läheb **sisse**. Veel kolm kihti kujundavad seda, **kuidas**, **millal** ja mis tuleb **välja**:
- **🪄 Väljundstiilid** _(väljunditelje suunamine)_ — lisavad deterministlikke, vahemälusõbralikke juhiseid vastuse kujundamiseks; neid saab kombineerida ning igaühel on intensiivsus `lite` / `full` / `ultra`. Stiili lisamiseks piisab ühest reast registris:
- **Napp proosa** — eemalda täitesõnad / artiklid / ebakindlust väljendavad fraasid; säilita tehniline sisu täpselt.
- **Vähem koodi** — „laisa vanemarendaja” YAGNI: väikseim toimiv muudatus, ilma soovimata tugistruktuurita.
- **Hobusesaba (laisk vanemarendaja)** — liigu YAGNI-redelil üles, paranda algpõhjus, tee väikseim toimiv muudatus.
- **Mul on ATH (tegevus esmalt)** — alusta järgmisest tegevusest, nummerda sammud, anna üks konkreetne järgmine samm, ilma sissejuhatuseta.
- **Napp CJK (文言)** — klassikalise hiina keele ülinapp stiil (piiratud lokaadiga `zh`).
- **🎯 Kohanduv kontekstieelarve** _(regulaator)_ — ühe sisse-/väljalülitatava tokeniläve asemel rakendatakse odavaimaid ja kõige väiksema kaoga mootoreid ainult nii palju, kui on vaja **mudeli kontekstiaknasse mahtumiseks**. Reegel: `reserve-output` (vaikimisi, mudeliteadlik) · `percentage` · `absolute`. Režiim: `floor` (tagab mahtumise) · `replace-autotrigger` (sinu selgesõnaline valik on ülimuslik) · `off` (pärandrežiimi lävi).
- **🎛️ Kus tihendamine otsustatakse** _(prioriteet kõrgest madalani)_ — päringupõhine `x-omniroute-compression` päis › marsruutimiskombinatsiooni alistus › aktiivne nimega profiil › kohanduv / automaatne käivitus › paneeli vaikeväärtus › väljas. Rakendatud plaan tagastatakse vastuse päises `X-OmniRoute-Compression: ; source=`.
Käivita automaatselt tokeniläve alusel, lülita sisse kohanduv regulaator, kinnita nimega profiil, määra ühekordne väärtus päringu kohta või omista igale marsruutimiskombinatsioonile konveier — vali töökoormusele sobiv lahendus. Valikuline võrguühenduseta **hindamisraamistik** (`npm run eval:compression`) hindab enne muudatuse kasutuselevõttu fikseeritud korpusel täpsuse ja säästu suhet.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Kiirstart
**1) Paigalda ja käivita**
```bash
npm install -g omniroute
omniroute
```
> 💡 Kas näed hoiatust `npm warn ERESOLVE` või partner-sõltuvuste hoiatusi? [Need on ohutud](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Kas kasutad npm 11 või uuemat versiooni?** npm võib blokeerida paketi elutsükli skriptid, kui need pole lubatud. OmniRoute'i `postinstall` (`node scripts/build/postinstall.mjs`) on vajalik selle natiivsete käitusfailide ettevalmistamiseks. Globaalse paigalduse ajal luba npm-i hoiatuses nimetatud paketid. OmniRoute 3.8.51 teatatud paketikomplekti korral:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Selle lubatud pakettide loendi kasutamiseks tulevastel globaalsetel paigaldustel seadista see üks kord ja paigalda seejärel tavapäraselt:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Sõltuvuste loend võib versiooniti muutuda; kui npm teatab teistsugusest loendist, kasuta selles hoiatuses nimetatud pakette. Paketi lubamine võimaldab selle paigaldusskriptide käivitamist.
> **Kas kasutad Gemini Webi või muud veebiküpsistel põhinevat teenusepakkujat?** npm-i pakett sisaldab
> Playwrighti, kuid mitte selle Chromiumi binaarfaili. Enne esimese veebiteenusepakkuja päringu tegemist vaata
> märkust [Playwright Chromiumi seadistamise kohta](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium).
Juhtpaneel asub aadressil `http://localhost:20128` · API asub aadressil `http://localhost:20128/v1`.
**2) Ühenda sobiv teenusepakkuja oma konto abil**
Juhtpaneel → **Teenusepakkujad** → vali teenusepakkuja, kelle kehtivad tingimused ja kvoot sobivad sinu kasutusjuhtumiga → lisa selle API-võti või lõpeta kontoga ühendamise protsess. Tasuta paketid võivad nõuda registreerumist, heakskiitu või makseviisi. Vaata [tasuta pakettide juhendit](docs/getting-started/FREE-TIERS-GUIDE.md); võtmeta saadavus pole garanteeritud ning teenusepakkujad märkega `tos: avoid` jäetakse vaikimisi valikust `auto` välja.
**3) Suuna oma programmeerimistööriist**
```txt
Baas-URL: http://localhost:20128/v1
API-võti: [kopeeri asukohast Juhtpaneel → Lõpp-punktid]
Mudel: auto (marsruudib sobivate ühenduste vahel — või vali teenusepakkuja/mudel)
```
**4) Kontrolli, et see töötab**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Peaksid nägema ühendatud mudelite loendit. 🎉 Ongi kõik — alusta programmeerimist ning OmniRoute marsruudib päringud automaatselt ja kasutab vajaduse korral varuvarianti.
Kui sinu klient ei saa kohandatud päiseid saata, pakub OmniRoute ka tokeniseeritud ühilduvusaliaste:
```txt
OpenAI kataloog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI mudelid: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI vestlus: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI vastused: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama vestlus: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama sildid: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Kasuta neid ainult klientidega, mis ei saa lisada päist `Authorization: Bearer ...`. Päisega autentimine jääb eelistatud viisiks.
## 📦 Rohkem paigaldusviise — Docker, lähtekood, 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` järgib kõrgeimat **avaldatud** stabiilset SemVer-versiooni. See ei järgi git-i haru `main`. GitOpsi jaoks kasuta fikseeritud silti `:X.Y.Z`. Vaata jaotist [Dockeri väljalaskekanalid](docs/guides/DOCKER_GUIDE.md#release-channels). Tõmmispildis on **`OMNIROUTE_MEMORY_MB=1024`** fikseeritud. Sellest piisab juhtpaneeli ja kerge vestluse jaoks. **Programmeerimisagendid** (Claude Code'i, Codexi, Groki jne päringud `POST /v1/responses`) vajavad palju suuremat V8 kuhja, vastasel juhul annab protsess kahe kattuva pika konteksti korral ligikaudu 12 GiB juures vea `FATAL ERROR`. Määra konteineri maht kuhjast suuremaks (natiivsed puhvrid asuvad väljaspool V8-t):
| Töökoormus | Kuhi (`-e OMNIROUTE_MEMORY_MB`) | Konteiner (`--memory`) |
| ---------------------------------------------- | --------------------------------- | ---------------------- |
| Juhtpaneel / kerge vestlus | `1024` (tõmmispildi vaikeväärtus) | ≥2 g |
| Üks programmeerimisagent | `8192` | ≥10 g |
| Kaks samaaegset pikka `/v1/responses` päringut | `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
```
Täielik tabel: [Dockeri juhend — käitusaegne RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Dockeri eelväljalaskekanal:** `diegosouzapw/omniroute:next` ja
> `diegosouzapw/omniroute:next-web` järgivad praegust vaikeharu `release/v*`.
> Need muudetavad sildid on mõeldud ainult avaldamata paranduste testimiseks ja
> neid **ei toetata tootmiskeskkonnas**. Vaata jaotist
> [Dockeri väljalaskekanalid](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
Standardset käsku `bun install` ja globaalset paigaldust (`bun install -g omniroute`) toetatakse Bun-i käituskeskkonna tuvastamise kaudu:
- **Sisseehitatud `bun:sqlite`**: Bun-i all töötades kasutab OmniRoute Bun-i sisseehitatud `bun:sqlite` draiverit ning Node.js-i korral `better-sqlite3` või `sql.js` varuvarianti.
- **Webpacki komplektija automaatne valimine arenduses**: arenduskeskkond (`bun run dev`) tuvastab Bun-i automaatselt ja keelab Turbopacki Webpacki kasuks, et vältida natiivsete V8 siduste ühildamatust. Tootmisjärgud (`bun run build`) järgivad muutujat `OMNIROUTE_USE_TURBOPACK` täpselt samamoodi nagu Node'is: vaikimisi Turbopack, Webpackiga koostamiseks `OMNIROUTE_USE_TURBOPACK=0` (`Dockerfile.bun` pakub seda argumendina `--build-arg`).
- **Eraldi Bun-i Dockerfile**: mitmeetapiline `Dockerfile.bun` natiivsete Bun-i tootmisjuurutuste jaoks (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Paigalda ja käivita Bun-iga
bun install
bun run dev
```
**🛠️ Lähtekoodist**
```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
# Nix flakesi kasutamine
nix develop
npm run dev
# Või devboxi kasutamine
devbox run npm run dev
```
📖 [Dockeri juhend](docs/guides/DOCKER_GUIDE.md) — Compose'i profiilid, Caddy HTTPS, Cloudflare'i tunnelid.
**🦭 Podman**
```bash
# 1. Valmista ette sidushaagitud andmekataloog
mkdir -p data
# 2. Ainult Linux + kohalik juurõigusteta Podman (mitte kunagi Podman Machine'i kaugklient):
podman unshare chown 1000:1000 ./data
# 3. Määra käituskeskkonna vihje, koosta kohalik Compose'i tõmmispilt ja käivita
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
macOS-is või Windowsis kasutab Podman Podman Machine'i kaugmasinat: jäta `podman unshare` vahele ja
järgi [topoloogiapõhiseid andmekataloogi juhiseid](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [Podmani juhend](contrib/podman/README.md) — Compose'i järgud, Podman Machine ja
Linuxi/systemd Quadleti seadistus.
**⚡ Kiirem / kergem paigaldus (jäta natiivne järk vahele)**
Natiivne SQLite'i mootor (`better-sqlite3`) on **valikuline** sõltuvus, mistõttu globaalne
paigaldus ei takerdu kunagi lähtekoodist kompileerimise taha: sobivuse korral kasutatakse
sinu platvormi/Node'i jaoks eelkompileeritud binaarfaili, vastasel juhul minnakse läbipaistvalt
üle puhtalt JS-il põhinevale mootorile (`node:sqlite` Node 22+ korral, muidu komplekti kuuluvale
`sql.js` WASM-ile) — koostamistööriistu pole vaja.
Paigaldusjärgse **natiivse eelsoojenduse** täielikuks vahelejätmiseks (CI, kasutajaliideseta või aeglastel masinatel).
Märkus: see jätab vahele ainult natiivse SQLite'i eelsoojenduse etapi (`scripts/postinstall.mjs`);
binaarfaili kopeerimise/parandamise haak (`scripts/build/postinstall.mjs`) töötab endiselt tavapäraselt:
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # Ka CI=1 jätab selle vahele
```
Kiireimaks paigalduseks eelista **pnpm-i** (sisupõhine hoidla + püsilingid — vaata eespool).
Ilma juhtpaneelita ja kasutajaliideseta käituskeskkonna jaoks kasuta Dockeri profiili `base` (eespool) või
[Termuxi juhendit](docs/guides/TERMUX_GUIDE.md). CLI-d ja veebipõhist juhtpaneeli teenindab
sama protsess ühe pordi kaudu, seega eraldi ainult CLI jaoks mõeldud paketti praegu pole.
Testikatvuse strateegia rohkem kui 39 000 staatilise testideklaratsiooni jaoks enam kui 5 100 jälgitavas testifailis
# ⭐ Parimad kaastöötajad
> OmniRoute'i kujundab kirglik avatud lähtekoodiga kogukond. Need inimesed on andnud erakordse panuse, mis mõjutab otseselt projekti kvaliteeti, stabiilsust ja ulatust. **Aitäh.**
### Välised kaastöötajad ühendatud tõmbetaotluste arvu järgi
Fikseeritud aktiivse release/v3.8.50 haru tipus dafb4ae808, hõlmates ühendamisi kuni 2026-08-24 05:26:03 UTC. Lehekülgedeks jaotatud GitHub GraphQL-i loendus sisaldab 5,911 ühendatud PR-i: 2,707 repositooriumi omanikult, 179 Dependabotilt ja 3,025 välist PR-i 535 erinevalt panustajalt. „Muudetud read” on GitHubi lisamiste ja kustutamiste summa ning sisaldab genereeritud faile, lukufaile, katalooge, tõlkeid ja dokumentatsiooni; see näitab muudatuste mahtu, mitte autori kirjutatud koodiridade arvu. Piirväärtusega võrdsed tulemused on säilitatud.
### GitHubi omistatud sissekanded
Bob.Hou 🏅 51 GitHubile omistatud muudatust · jagatud 10. koht
Xiangzhe 🏅 51 GitHubile omistatud muudatust · jagatud 10. koht
Kontrollitud uuesti 2026-08-24 06:14:31 UTC: hoidla Contributors API esitatud GitHubile omistatud muudatused vaikeharus release/v3.8.50. API tagastas 525 identiteeti (415 kasutajat, 2 robotit, 108 anonüümset); sellest tabelist on välja jäetud hooldaja, robotid ja anonüümsed identiteedid ning säilitatud on jagatud kohad. See erineb nii ülaltoodud ühendatud PR-ide edetabelist kui ka alltoodud 639 inimesest koosnevast Git-metaandmete loendusest.
> 🙏 Nende panustajate loodud funktsioonid, veaparandused ja taristutäiustused on **põhiosa** sellest, mis muudab OmniRoute'i töökindlaks ja funktsioonirikkaks. Iga pull request, iga testjuhtum ja iga i18n-tõlkefail on oluline. Avatud lähtekood sünnib tänu sellistele inimestele nagu nemad.
---
## 💖 Sponsorid
Südamlik tänu inimestele, kes rahastavad OmniRoute'i oma taskust — iga panus aitab hoida projekti tasuta, sõltumatu ja arenevana.
… ja teised, kes eelistavad jääda anonüümseks 💛Avalikud GitHub Sponsorsi andmed kontrolliti uuesti 2026-08-24. GitHubi olek activeOnly määrab ülaltoodud aktiivsuse sildid; varem avalikustatud avalikke ühekordseid toetajaid tänatakse jätkuvalt ning erasponsorid jäävad anonüümseks.💖 Hakka sponsoriks → — iga dollar aitab hoida OmniRoute'i tasuta ja sõltumatuna.
## 👥 Üle 600 panustaja
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Auditeeritud 2026-08-24 fikseeritud baasversiooni ac02c5b42f põhjal ja uuesti kontrollitud aktiivse release/v3.8.50 tipu dafb4ae808 juures: 639 normaliseeritud inimese Git-identiteeti — 407 neist esinevad commiti autoritena (sealhulgas haldaja) ja 232 ainult sõnaselgetes Co-authored-by järelkirjetes. Loendus normaliseerib GitHubi noreply-kasutajanimed, välistab 26 boti, agendi, teenuse või kohatäite identiteeti ega ühenda tavalisi e-posti aadresse pelgalt seetõttu, et nende kuvatavad nimed kattuvad.
### Kuidas panustada
1. Forkige repositoorium
2. Looge haru **aktiivse** `release/vX.Y.Z` tipu põhjal (mitte `main` põhjal) — vaadake dokumenti [Harude ja väljalasete mudel](docs/ops/BRANCHING_MODEL.md)
3. Looge oma funktsiooniharu (`git checkout -b feat/amazing-feature`)
4. Commit'ige oma muudatused (`git commit -m 'feat: add amazing feature'`)
5. Lükake muudatused harusse (`git push origin feat/amazing-feature`)
6. Avage tõmbetaotlus, mille **base = vastav `release/vX.Y.Z` haru**
Üksikasjalikke juhiseid vaadake failist [CONTRIBUTING.md](CONTRIBUTING.md).
### Uue versiooni väljalaskmine
```bash
# Loo väljalase — npm publish käivitub automaatselt
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Tähed
## 🌍 StarMapper
## 🙏 Tänuavaldused
OmniRoute seisab hiiglaste õlgadel. See sai alguse projekti **[9router](https://github.com/decolua/9router)** haruna ja Go projekti **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** TypeScripti pordina — ning sealt edasi sai iga allpool nimetatud alamsüsteem inspiratsiooni mõnest avatud lähtekoodiga projektist, mis oli selle juba varem teoks teinud. Igaüks neist kujundas OmniRoute'i konkreetset osa. See on meie tänu neile kõigile. 🙏
> ⭐ tähtede arv kontrolliti GitHubi REST API kaudu 24. augustil 2026 — minge ja andke neile projektidele täht. Need arvud on täpne kuupäevastatud hetkeseis ning muutuvad aja jooksul loomulikult.
### 🧬 Päritolu ja lüüs
Tehisintellekti lüüs, mille avalik hinnastikuandmestik varustab meie kulujälgimise sünkroonimist ning mille teenusepakkujate normaliseerimise mudel mõjutas meie marsruutimist.
MIT-litsentsiga lähtekood, mis kohandati komplekti lisatud ChatGPT Web → Codex Responses sillaks, sealhulgas brauseriseansi, vastuste raamimise, kasutuse ja veebiotsingu adapterid.
Selle Groki mudelivastendused, võlts-TypeErroriga Statsigi generaator, päringute ja seadmete vaikesätted ning NDJSON-vastuste töötleja kohandati olulisel määral OmniRoute'i Grok Webi täiturisse.
Peamine transitiivne koodiallikas grok2api-mergedi taga; selle mudeli-, päise-, lasti-, Statsigi- ja töötlejateostused on Grok Webi päritoluliinis säilitatud.
Grok-laadungi ja seadme vaikesätete, Statsigi generaatori ning TQZHR-i ja grok2api-mergedi kaudu edasi kantud result.response töötleja aluseks olev MIT-litsentsiga lähtekood.
Transitiivne allikas, millele grok2api-merged viitab oma puhverserverite kogumi kihi puhul; OmniRoute säilitab selle päritolumärke, kuid ei väida, et selle piiritletud Grok Webi täiturisse oleks porditud puhverserverite kogum.
Algne Grok Webi teostus lähtus selle HTTP-/brauseripõhisest ülesvoolu disainist; selle otsene HTTP-tee pärineb GrokProxyst, seega ei väideta, et tegu oleks sõltumatu koodipordiga.
Viiruslik projekt „miks kasutada palju sõnu, kui vähesed ajavad asja ära“ — selle koopainimese kõne filosoofia on meie standardse tihendusrežiimi ning enam kui 30 täitesõnade eemaldamise ja teksti tihendamise reegli alus.
Brasiilia portugali keele tokenite tihendamine — sellel põhineb meie pt-BR keelepakett: pleonasmide vähendamine ja Brasiilia portugali keele grammatikale kohandatud täitesõnade eemaldamine.
Viiruslik „laisa vanemarendaja“ YAGNI-kodeerimisoskus — inspireeris meie less-code-väljundistiili: väikseima toimiva muudatuse eelistamine, mis vähendab _genereeritud_ koodi hulka (Cavemani napi proosa väljundipoolne sugulane).
Sisutundlik failitüübipõhine väljundi tihendamine koos tõrkeid arvestava loobumisega — kinnitas meie tüübipõhise suunamise ja minimaalse kasu korral vahelejätmise lahendust.
Rusti veerupõhine JSON + sisupõhine taastamine + sõnumiteülene deduplikeerimine — kinnitas meie headroom/ccr/session-dedup-mootorite ülesehitust ja vahemälustabiilset invarianti „tihendatud kuju ei sõltu asukohast“.
TypeScript Compiler API tööriistakomplekt — inspireeris meie parseripõhist kommentaaride eemaldamist, mis säilitab sõne-, malli- ja regulaaravaldiste literaalid.
Kodeerimisassistendi ↔ LLM-i liikluse MITM-pealtkuulamine ja -analüüs mõjutasid Traffic Inspectori varaseid nõudeid. Neli varem tuletatud moodulit — SSE ühendamine, vestluste normaliseerimine, saladuste maskeerimine ja päiste sanitiseerimine — on asendatud sõltumatute puhasruumi teostustega, mis põhinevad avalikel protokollistandarditel. Kaks hosti otseedastuse pinda (passthrough.ts ja _internal/bypass.cjs) on endiselt OmniRoute'i sisemised teostused, mis on klassifitseeritud sõltumatult; neid ei kirjutatud selle asendamise käigus ümber.
Läbipaistev protsessipõhine puhverserveri marsruutimine — inspireeris meie krahhikindlat MITM-i sulgemist, soklite jõudeoleku ajalõppe, protsesside omistamist /proc kaudu ja TPROXY hõivet.
Selle kontoteadlik mudelite ümbervastendamine, täitmisfaili tee valideerimine ja paketisiltide käitumine mõjutasid OmniRoute'i Antigravity käituskeskkonda.