# README (Српски) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Бесплатни AI мрежни пролаз

OmniRoute — Никада не престајте да програмирате. Сваки AI алат → 372 добављача — 150+ бесплатних — преко једне крајње тачке. Claude Code, Codex, Cursor, Cline, Copilot и Antigravity повезани са БЕСПЛАТНИМ Claude / GPT / Gemini моделима уз аутоматско пребацивање. Комбинована RTK + Caveman компресија штеди 15–95% токена (~89% у просеку) — никада не достижите ограничења. 372 AI добављача · 150+ бесплатних нивоа · ~1.62B бесплатних токена месечно · 19 стратегија усмеравања · почетна цена $0.

## 💰 ~1,62B токена месечно преко бесплатних пакета трећих страна

> **Користите сопствене налоге код добављача.** Ово је процењени збир засебно доступних бесплатних пакета трећих страна, а не додела токена од стране OmniRoute-а. Региструјте се, прибавите акредитиве тамо где су потребни и повежите добављаче које можете да користите; сваки добављач контролише сопствена ограничења, доступност и услове. > > Ручно комбиновање бесплатних пакета је мучно — десетине SDK-ова, десетине ограничења брзине и никаква представа о томе колико заправо имате. OmniRoute каталогизује **485 ставки бесплатних пакета у оквиру 35 кључева периодичних скупова** и израчунава истакнути број токена на основу **17 скупова са објављеним позитивним месечним буџетом и пет Groq ограничења по моделу**, уз уклањање дупликата за дељене скупове. Квоте које постају доступне тек након регионалне провере идентитета (тренутно: ModelScope) приказане су засебно, +~6M након регионалне провере идентитета, и никада се не сабирају са истакнутим бројем. Резултат остаје видљив на контролној табли (`/dashboard/free-tiers`).

Картица буџета бесплатних пакета OmniRoute-а: стабилних ~1,62B бесплатних токена месечно, до ~2,22B током првог месеца са кредитима за регистрацију, из 35 документованих кључева периодичних скупова који обухватају 485 каталогизованих ставки бесплатних пакета иза једне крајње тачке. Искрен прорачун са уклоњеним дупликатима скупова — сваки дељени скуп рачуна се једном, укључујући 17 периодичних скупова са објављеним позитивним месечним буџетом токена и пет Groq ограничења по моделу; 13 добављача означено је за избегавање у каталогу ризика услова коришћења, како бисте сами одлучили. Трака буџета укључује Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (пет ограничења по моделу) и мање скупове, као и кредите за регистрацију у првом месецу и трајно бесплатне добављаче без ограничења токена, приказане засебно како никада не би вештачки увећали истакнути број. Актуелна потрошња/преостали износ на /dashboard/free-tiers.

> Анимирани резиме активне странице `/dashboard/free-tiers`. Потпуна методологија (уклањање дупликата скупова, нивои кредита, услови добављача): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Ове бројке се поново проверавају сваке две недеље у односу на активни каталог и **мењају се у оба смера** — када добављач укине бесплатни пакет, број опада; када се појави нови, број расте. Објављујемо оно што каталог заиста израчунава, никада заокружену најповољнију варијанту.}

⭐ Означите репозиторијум звездицом ако вам је OMNIROUTE помогао да уштедите новац и олакшате рад.

[![Звездице](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Ранг историје звездица](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Придружите се заједници **👋 Пратите одржаваоца — први сазнајте за нове добављаче, издања и савете:** [![Пратите Diega на LinkedIn-у](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Пратите @diegosouzapw на GitHub-у](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp глобално](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Бразил](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Веб-сајт](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Питања, савети о добављачима, план развоја и подршка → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Глобално](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Бразил](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Портал](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway наставља да расте

| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | --------------------------------------- | :-------------------: | :---------: | :-------------------: | | 🌐 Провајдери | 352 | **358** | 372 | | 🧠 Јединствени ID-ови модела за ћаскање | 1320 | **1374** | 1443 | | 🖼️ Мост модалитета | 🆕 вид + звук + видео | ✓ | ✓ | | 📡 Бесплатни Radar каталог | 🆕 уз пријаву | ✓ | ✓ | | ⚖️ Распоређивање према квоти | 🆕 Quota-Share | ✓ | ✓ | | 📊 Телеметрија квоте | 🆕 уживо | ✓ | ✓ | | 🧰 Режим без корисничког интерфејса | — | — | 🆕 `serve --headless` | | 🛤️ Инфраструктура LTS гране | — | — | 🆕 канали издања | **→ [План развоја](ROADMAP.md) — на путу ка `v3.9.0 LTS`**

## 🧩 Доступно [![npm верзија](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Месечно на NPM-у](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Лиценца: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker преузимања](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron преузимања](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Почетак	🚀 Брзи почетак	📦 Инсталација	🆓 Повежите добављача
💡 Сазнајте више	💥 Обећање	🤔 Зашто OmniRoute	🏆 По чему се издваја
⚙️ Функције	🎯 Комбинације	🌐 Добављачи	🔌 CLI и MCP
	🗜️ Компресија	🖥️ Где се покреће	🔒 Приватност
👀 Погледајте	🎬 На делу	✨ Шта је ново	🤖 Компатибилни CLI алати
💚 Подршка	💚 Подршка / Донације	💬 Заједница	💖 Спонзори
📦 Пројекат	🛠️ Технолошки стек	📖 Документација	👥 Сарадници

🌐 На 67 језика

## 🆓 Инсталирајте, повежите добављача, а затим усмеравајте преко једне крајње тачке

Три корака: инсталирајте и покрените OmniRoute, повежите одговарајућег добављача помоћу сопственог налога или API кључа, а затим усмерите свој алат на localhost:20128/v1 користећи OmniRoute API кључ и модел auto. Усмеравање зависи од доступних одговарајућих веза и ограничења добављача.

```bash # Након повезивања добављача, копирајте свој OmniRoute кључ из 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` је потребна одговарајућа рута. Нова инсталација можда нема ниједно одговарајуће одредиште без кључа, а добављач који не захтева кључ може одбити клијенте трећих страна. Добављачи означени са `tos: avoid`, укључујући OpenCode Free и Kiro, подразумевано су искључени из аутоматског усмеравања; повезивање налога не поништава ту поставку. Пре него што изаберете добављача, погледајте [Водич за бесплатне нивое](docs/getting-started/FREE-TIERS-GUIDE.md).} _{📦 Скрипте за брзи почетак које можете директно копирати и налепити за **Python, Node.js, PHP и cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Обећање

# 🤔 Зашто OmniRoute?

Ток OmniRoute захтева: ваш IDE или CLI (Claude Code, Cursor, Cline…) позива једну локалну крајњу тачку (http://localhost:20128/v1); OmniRoute Smart Router (RTK + Caveman компресија, 19 стратегија усмеравања, прекидачи кола, TLS прикривање, MCP, A2A, заштитни механизми) може резервно да прелази између 4 нивоа добављача све док постоји одговарајуће исправно одредиште — Ниво 1 Претплата, Ниво 2 API кључ, Ниво 3 Јефтино и Ниво 4 Бесплатно.

## 🤝 Подршка наших пријатеља отвореног кода

> **Желите да нам се придружите као пријатељ отвореног кода?** Ово су компаније које подржавају отворени код и помажу да OmniRoute настави да напредује — а ми јавно објављујемо на шта одлази сваки токен који нам обезбеде. Јавите нам се: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Хвала компанији Kimi (Moonshot AI), нашем оснивачком пријатељу отвореног кода, што подржава овај пројекат! Kimi је AI лабораторија која стоји иза породица модела K2 и K3 са отвореним тежинама — Kimi K3 пружа контекстни прозор од 1 милиона токена, изворну подршку за визуелни садржај и програмирање на нивоу водећих модела, по делићу цене затворених модела, а одмах ради са алатима Claude Code, Codex и сваким алатом за програмирање који OmniRoute опслужује.

Шта омогућава подршка компаније Kimi: Kimi API кредити покрећу OmniRoute-ов процес издавања који проверава AI — фазу провере спајања коју покреће Kimi K3, а која прегледа сваки захтев за спајање пре објављивања — као и свакодневни развој функција. Првокласна подршка за Kimi испоручује се путем оба канала: директног Kimi API-ја (kimi-k3) и Kimi Code плана за програмирање (OAuth и API кључ). OmniRoute је такође први бразилски пројекат отвореног кода у Kimi програму подршке. Набавите Kimi API кључ са 15% додатних кредита →

Cheaper Inference
_{cheaperinference.com} Хвала компанији Cheaper Inference, OmniRoute-овом пријатељу отвореног кода, што подржава овај пројекат! Cheaper Inference је мрежни пролаз рангиран према трошковима који препродаје 42 водећа модела — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok и MiniMax — преко једне крајње тачке компатибилне са OpenAI-јем, усмеравајући сваки захтев најјефтинијем одговарајућем добављачу, а да никада не наплаћује више од каталошке цене произвођача модела.

Првокласна подршка у OmniRoute-у: довршавање ћаскања, изворна крајња тачка /v1/responses, визуелни садржај, позивање алата и 3 модела за слике (grok-imagine, nano-banana-pro, nano-banana-2, доступни као cheaperinference/<model>). Набавите API кључ →

_{Везе означене са aff=omniroute су партнерске везе. Оне финансирају пројекат без додатних трошкова за вас.}

_{🎟️ Промоције партнера — бесплатни купони за регистрацију од добављача које не спонзоришемо (кликните да проширите)}

_{Овај одељак је намењен искључиво кодовима за препоруке/купоне. Спонзорска партнерства налазе се у одељку 🤝 Подршка наших пријатеља отвореног кода изнад. OmniRoute нема спонзорски нити партнерски однос са добављачима наведеним овде — ово су јавни купони које свако може да користи.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — партнерска регистрација · $100 бесплатних кредита при регистрацији (бесплатан сервер, очекујте веће кашњење — најбоље за тестирање, не за продукцију). Првокласна подршка у OmniRoute-у од верзије v3.8.50: довршавање ћаскања, формат преноса компатибилан са Anthropic-ом и путања компатибилна са OpenAI-јем. Доступни модели обухватају claude-opus-4-8, claude-opus-5, gpt-5.6-sol и друге. Преузмите својих $100 →}

_{⚠️ Партнерска веза — OmniRoute нема спонзорски нити партнерски однос са овим добављачем.}

_{Знате за још неког добављача са издашним бесплатним купоном за регистрацију који користи OmniRoute корисницима? Отворите пријаву проблема и додаћемо га овде.}

## 🎯 Комбинације — главна функција

Анимација свих 19 стратегија усмеравања комбинација — по једно поље за сваку стратегију: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. Погледајте табелу изнад да бисте видели шта свака од њих ради.

> **Комбинација** је ланац модела између којих OmniRoute усмерава **аутоматски**. Ако се квота потроши, добављач услуге откаже или трошкови нагло порасту, комбинација може да пређе на следећи одговарајући исправан модел. 🛡️ ### ⚡ Без конфигурације — само користите `auto` Не морате да правите комбинацију. Подесите модел на `auto` (или неку варијанту) и OmniRoute ће направити виртуелну комбинацију од ваших повезаних добављача услуга, оцењених у реалном времену:

ID модела	За шта је оптимизован
`auto`	🎯 Уравнотежена подразумевана опција (LKGP — задржава последњег поузданог добављача услуге)
`auto/coding`	🧑💻 Пондери који дају предност квалитету при генерисању кода
`auto/fast`	⚡ Прво најмање кашњење
`auto/cheap`	💰 Прво најнижа цена по токену
`auto/offline`	🔋 Прво највећа преостала квота / резерва ограничења брзине
`auto/smart`	🔭 Прво квалитет + 10% истраживања ради проналажења бољих модела
`auto/lkgp`	📌 Изричито задржавање последњег познатог поузданог добављача услуге
`auto/chaos`	🧪 Паралелно слање панелу модела (по један за сваког добављача услуге, подразумевано 5), уз враћање једног одговора; један позив узводном сервису по моделу у панелу, а не убризгавање грешака

## ### 🔀 Или направите сопствену комбинацију — 19 стратегија усмеравања Свих **19** стратегија — комбинујте их по жељи за сваки корак комбинације:

#	Стратегија	Шта ради
1	`priority`	Уређена листа са првим циљем — исцрпите сваки пре преласка на следећи 🥇
2	`fill-first`	Потпуно искористите квоту сваког циља пре него што пређете на следећи
3	`weighted`	Пондерисани насумични избор према пондеру сваког циља
4	`round-robin`	Кружно пролазите кроз циљеве по редоследу
5	`p2c`	Насумично балансирање оптерећења методом избора између две опције
6	`least-used`	Изаберите циљ са најмањим тренутним оптерећењем
7	`random`	Равномеран насумични избор (без дупликата)
8	`strict-random`	Насумични избор без уклањања поновљених вредности 🎲
9	`cost-optimized`	Смањите цену у $ по захтеву на основу актуелних цена из каталога 💸
10	`headroom`	Изаберите циљ са највећом преосталом квотом
11	`reset-window`	Дајте предност циљу чији се период квоте најраније ресетује
12	`reset-aware`	Рангирајте према времену ресетовања квоте — прво краћи периоди 📊
13	`context-relay`	Преносите контекст између циљева током дугих разговора 🧠
14	`context-optimized`	Изаберите циљ који најбоље одговара тренутној величини контекста
15	`cache-optimized`	Вежите сваки поново употребљиви префикс упита за исти налог — максимално искористите поготке кеша упита 🎯
16	`lkgp`	Последња позната поуздана путања — задржава последњег успешног добављача услуге, а затим прелази на резервна правила
17	`auto`	Оцењивање сваке везе у реалном времену на основу 16 фактора 🤖
18	`fusion`	Шаље захтев панелу модела, а модел-судија обједињује један одговор 🧬
19	`pipeline`	Повезује кораке у ланац — излаз сваког циља прослеђује се следећем 🔗

_{Механизам Auto-Combo оцењује сваког кандидата на основу **16 фактора** (стање, квота, цена, кашњење, прикладност за задатак, квалитет, доступност сесије…) — погледајте [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Отпорност је уграђена (3 независна слоја)

Отпорност система OmniRoute — 3 независна слоја за самоопоравак, одговарајући слој за одговарајући отказ. Слој 1 — прекидач кола добављача (цео добављач): активира се само при грешкама 408/5xx, прагови су OAuth 8× / API кључ 12× / локално 2×, ресетује се након 60s/30s/15s и прелази у HALF-OPEN пробу, опоравак по потреби; док је стање OPEN, комбинација преусмерава захтеве на следећег добављача. Слој 2 — период хлађења везе (један кључ/налог): основно трајање је 5s за OAuth / 3s за API кључ, експоненцијално одлагање ×2 са заштитом од истовременог навирања захтева, код 429 поштује се Retry-After, успех брише целокупно стање грешке; један кључ у периоду хлађења се прескаче, док остали кључеви настављају да опслужују захтеве. Слој 3 — блокада модела (један модел): 429 по моделу, локална грешка 404 или одбијања режима блокирају само тај модел — никада целу везу. Крајња стања (забрањен приступ, истекао рок, потрошени кредити) захтевају поступање оператера, а не период хлађења.

_{📖 [Механизам за аутоматско комбиновање](docs/routing/AUTO-COMBO.md) · [Водич за отпорност](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 По чему се OmniRoute издваја

_{📊 Комплетна методологија и детаљи по функцијама у поређењу са 9router, OpenRouter, CLIProxyAPI и LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Подржите OmniRoute OmniRoute је лиценциран под MIT лиценцом и одржава се јавно. Ако вам штеди време или новац, ево како можете помоћи да остане независан — изаберите оно што вам одговара. Спонзорство никада не утиче на приоритет рутирања; оно доноси видљивост, а не бољи ранг.

⭐ Означите репозиторијум звездицом	Бесплатно — заиста помаже видљивости	Означите OmniRoute звездицом
🐙 GitHub Sponsors	Једнократно или месечно · без накнаде платформе	github.com/sponsors/diegosouzapw
☕ Ko-fi	Брза једнократна донација, без регистрације донатора	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Мали, неформални гест	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Периодично · непрофитно · отвореног кода	liberapay.com/diegosouzapw
🇧🇷 PIX (Бразил)	Тренутно, без накнада	кључ и QR испод
₿ Криптовалуте	BTC · ETH · USDT-TRC20 · USDC-Solana	адресе испод

**🇧🇷 PIX** — тренутно, без накнада (Бразил) OmniRoute PIX QR кôд

Кључ (насумични): `5d865059-bc44-483a-962d-43ceb80126eb` Pix за копирање и лепљење: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Криптовалуте — BTC · ETH · USDT-TRC20 · USDC-Solana (кликните да бисте проширили)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Сваки новчић шаљите само преко приказане мреже — слање преко погрешне мреже може довести до губитка средстава.}

🐛 Пронашли сте грешку или имате повратне информације? Отворите [Дискусију](https://github.com/diegosouzapw/OmniRoute/discussions).

Напомене за програмере: Пројекат може да генерише локалну .env датотеку током npm install/postinstall ради погодности програмера. Ова датотека се намерно игнорише путем .gitignore (погледајте .gitignore) и никада не сме бити послата у репозиторијум — ако је случајно послата, промените све изложене тајне и уклоните датотеку из историје. Погледајте docs/DEVELOPER-ENVIRONMENT.md за смернице о управљању локалним датотекама окружења и тајнама.

## 📡 OmniRoute Radar Главна бројка за бесплатни ниво остаје **~1,62 млрд. токена месечно** из горе наведеног документованог каталога, из ког су уклоњена преклапања између група. Привремени кредити за регистрацију код добављача могу засебно повећати обим током првог месеца на **~2,22 млрд.** Radar је опционални, потписани слој каталога за кориснике који желе ажурнију доступност бесплатних модела између OmniRoute издања; каталог заједнице и све постојеће бесплатне функционалности остају бесплатни. Подржаваоци могу добити актуелни каталог и додатне могућности добављача. Његова засебна, променљива горња граница износи **највише приближно 3 млрд. токена месечно**, у зависности од доступности добављача. Та горња граница није загарантована: добављачи могу у било ком тренутку променити квоте, услове испуњавања, моделе или регионе. Radar се користи по избору и подржава само GET. OmniRoute клијент не отпрема упите, саобраћај, конфигурацију добављача, телеметрију коришћења нити локално стање одбацивања обавештења. Сазнајте више о условима испуњавања и актуелном каталогу на **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Шта је ново

> Најважније новине од **v3.8.20 → v3.8.50**. Комплетна историја је у датотеци [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — долазно A2A делегирање вашој групи агената, Conductor вештине на картици агента и панел контролне табле са Faro гласовним ћаскањем по принципу „притисни и говори“. → [A2A сервер](docs/frameworks/A2A-SERVER.md) - **🛂 Прилагодљиви пријем и заштита од преоптерећења** — захтевни захтеви за ћаскање стављају се у ред уместо да враћају 503, уз атомске RPM ротирајуће закупе по вези. → [Водич за отпорност](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Канонски редослед за `/v1/models`** — по један непрекидан блок груписан по добављачу за сваког добављача (комбинације су закачене на почетку), стабилан у свим изворима каталога. → [API референца](docs/reference/API_REFERENCE.md) - **🗜️ Ојачавање компресије** — подразумевано укључена заштита од прекомерне декомпресије, Caveman пакети за DE / FR / JA + кинески (wényán), RTK филтери за Gradle и .NET. → [Компресија](docs/compression/COMPRESSION_ENGINES.md) - **💸 Реалан фиксни трошак** — добављачи са претплатом / програмом за кодирање приказују **$0** у аналитици трошкова; буџет, квота и усмеравање настављају да користе процене. → [API референца](docs/reference/API_REFERENCE.md) - **⚖️ Усмеравање према уделу квоте** — праведно дели квоту заједничког налога између обједињених кључева, уз очување искоришћености тако што се неактивни удели уступају другима. → [Водич за отпорност](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Подешавање CLI-ја/агента једном командом** — 13 регистрованих `setup-*` команди; `omniroute run` покреће 7 CLI алата (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` подржава 10 одредишта, уз интерактивни избор добављача и модела и омиљене ставке по контексту. → [CLI интеграције](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Удаљени режим** — управљајте удаљеним OmniRoute-ом помоћу токена ограниченог опсега (`connect` / `contexts` / `tokens`) и OAuth помоћника `antigravity` за VPS инсталације. → [Удаљени режим](docs/guides/REMOTE-MODE.md) - **🧭 Паметније аутоматско усмеравање** — комбинације `auto/:`, **Fusion** (панел модела + судија), усмеравање прилагођено задатку и замене модела / режима / USD буџета по захтеву. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Проширива компресија** — 12 компонујућих механизама + Compression Studios: LLMLingua-2, двостепени Ultra, omniglyph, контрола верности по кораку, GCF v3.2 и уређивач за промену редоследа превлачењем. → [Компресија](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Транспарентно MITM дешифровање (TPROXY)** — пресретање CLI алата који игноришу променљиве окружења проксија, уз CA по SNI-ју и инсталатор складишта поверења. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Телеметрија трошкова свуда** — `X-OmniRoute-*` заглавља трошкова/коришћења на свакој крајњој тачки, заглавље уштеде при поготку кеша и USD квоте потрошње по кључу. → [API референца](docs/reference/API_REFERENCE.md) - **🧠 Меморија коју ви контролишете** — подразумевано искључена, опциона int8 векторска квантизација + типизирано опадање, `x-omniroute-no-memory` по захтеву. → [Меморија](docs/frameworks/MEMORY.md) - **🛡️ Безбедност** — заштита од убризгавања упита на свакој LLM рути (пакет red-team тестова), опциона заштита маскирањем акредитива (редигује процуреле API кључеве/тајне у оба смера), бесплатна DuckDuckGo веб-претрага као последња опција и опциона OIDC пријава за контролну таблу (пријава лозинком остаје увек доступна). → [Заштитне мере](docs/security/GUARDRAILS.md) - **🖼️ Нове крајње тачке** — `/v1/ocr` (Mistral OCR) и `/v1/audio/translations` (у стилу Whisper-а) заокружују подршку за медије. → [API референца](docs/reference/API_REFERENCE.md) - **🎨 Генерисање слика / видео-снимака / звука** — један API за медије: xAI Grok Imagine и Novita AI видео, ComfyUI, Magnific, Adobe Firefly, Segmind и добављачи говора као што је ElevenLabs. → [API референца](docs/reference/API_REFERENCE.md) - **🌍 Примена и операције** — `basePath` за обрнути прокси, аутоматско откривање језика прегледача, праћење уређаја по кључу, MITM поверење без root привилегија и zh-TW локализација. → [Окружење](docs/reference/ENVIRONMENT.md) - **🤝 Више добављача и агената** — агенти у облаку (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) са прегледачем + OAuth пријавом, првокласна картица за Ollama, Claude Opus 5 и Sonnet 5, званично партнерство са Kimi-јем (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… и освежен **каталог са 372 добављача**. → [Добављачи](docs/reference/PROVIDER_REFERENCE.md) - **📡 Транспарентност усмеравања** — сваки одговор садржи заглавље `X-OmniRoute-Decision` које наводи стратегију/добављача/кашњење који су га опслужили, нова комбинована стратегија `cache-optimized` + Auto-Combo фактор `cacheAffinity` усмерава поновљене захтеве назад ка вези која чува кеширани префикс, а крајња тачка `/v1/auto-combo/{channel}/candidates` само за читање открива тренутни скуп кандидата канала `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Локалне перформансе и инфраструктура** — локални Redis једним кликом, алати за примену посредничких сервиса на Cloudflare Workers / Deno Deploy, као и Bifrost и Mux као надгледане уграђене услуге. → [Уграђене услуге](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Такође укључено** — оквир додатака + продавница, оквири Omni/Agent/GitHub вештина, интеграција са Obsidian трезором (22 MCP алата), OpenAI-компатибилни Batch и Files API-ји, семантички кеш одговора, гејмификација са табелама лидера, ACP откривање агената (15 уграђених агената), планирани извоз евиденције у BigQuery, `auto/chaos` паралелно прослеђивање ка више модела, мост за Telegram бота, уграђени менаџер верзија и LMArena-ELO рангирање бесплатних добављача. → [Документација](docs/README.md)

## 🤖 Компатибилни CLI алати и агенти за програмирање > Једна конфигурација — `http://localhost:20128/v1` — и **сваки** AI IDE или CLI ради на бесплатним и јефтиним моделима.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ такође ради са · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · било којим алатом компатибилним са OpenAI

_{📖 Подешавање сваког алата за свих 36 алата (26 CLI Code алата + 10 CLI агената) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode додатак → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Покрените било који подржани CLI преко OmniRoute-а једном командом** — без уписивања конфигурационих датотека, акредитиви се убацују засебно за сваки процес, а Qwen/Gemini добијају привремени изоловани матични директоријум: ```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" # Или интерактивно изаберите добављача и модел и упишите сопствену конфигурацију алата: omniroute configure codex # такође: claude opencode qwen aider goose gemini cline continue kilo ``` Свака команда поштује активни удаљени контекст (`omniroute connect `), `--dry-run` приказује тачне променљиве окружења/аргументе без извршавања, а `--api-key-env NAME` спречава да тајне заврше у историји ваше љуске. → [CLI интеграције](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 372 AI провајдера — 154 означена у каталогу као бесплатна

> **372 регистрована провајдера** у оквиру канонских колекција за ћаскање, медије, претрагу, локалне системе, агенте у облаку и системске функције, укључујући **154 са метаподацима за откривање `hasFree: true`**. Регистар модела за ћаскање обухвата **237 провајдера / 3.009 различитих парова провајдер-модел / 1.443 необрађена ID-а модела**; засебни каталог бесплатних квота садржи **485 редова по моделу**, **35 периодично обнављаних скупова** и **53 трајно бесплатна провајдера са периодичним обнављањем квоте или без потребе за кључем**. Ови имениоци су намерно различити; дефиниције и прорачуни са уклоњеним дупликатима скупова налазе се у документима [Референца провајдера](docs/reference/PROVIDER_REFERENCE.md) и [Бесплатни нивои](docs/reference/FREE_TIERS.md).

### 🏢 Свака велика лабораторија — преко једне крајње тачке

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…и још 330+ — свака икона се уживо учитава из каталога провајдера контролне табле. 📖 [Референца провајдера](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Заувек бесплатно — $0, без картице

OpenCode Zen _{DeepSeek V4, Nemotron 3 Без ограничења броја токена}	Kilo Code _{Аутоматско усмеравање, Tencent Hy3 Заувек бесплатно}	Requesty _{GPT-OSS 120B, Nemotron Заувек бесплатно}	SiliconFlow _{DeepSeek V3.2 / R1 Бесплатни ниво}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Заувек бесплатно}	Baidu ERNIE _{ERNIE 4.0 Заувек бесплатно}
Qoder AI _{Qwen3-Max, Kimi-K2 НЕОГРАНИЧЕНО БЕСПЛАТНО}	Pollinations _{GPT, Llama, Claude Кључ није потребан}	Cloudflare AI _{50+ модела 10K неурона дневно}	NVIDIA NIM _{GLM, MiniMax ~40 RPM бесплатно}	Cerebras _{GLM 4.7, GPT-OSS Једнократни кредит од $5; картица је обавезна}	OpenRouter _{:free модели +$10 → већи RPM}

📖 Комплетан машински читљив каталог → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Где OmniRoute ради — свуда

> Иста апликација, ваш уређај, ваша правила. Од глобалне npm инсталације до **вашег телефона** путем Termux-а.

Платформа	Инсталација	Најважније
📦 npm (глобално)	`npm install -g omniroute`	Једна команда, било који ОС
🐳 Docker	`docker run … diegosouzapw/omniroute`	Више архитектура: AMD64 + ARM64
🖥️ Десктоп (Electron)	`npm run electron:build`	Изворни прозор + системска палета — Windows / macOS / Linux
🎩 Трака менија (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Надгледа и аутоматски ажурира сервер — macOS
💪 ARM	изворни `arm64`	Raspberry Pi, ARM сервери, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Ради на вашем телефону, непрекидно, без root приступа
📲 PWA	"Додај на почетни екран"	Преко целог екрана, ради ван мреже, може се инсталирати из прегледача
🧩 OpenCode додатак	`@omniroute/opencode-provider`	Изворна OpenCode интеграција
🤖 VS Code Copilot Chat	инсталирајте проширење OmniCopilot	Сваки OmniRoute модел у изворном бирачу модела Copilot Chat-а — стабилној и Insiders верзији
🛠️ Из изворног кода	`npm install && npm run dev`	Мењајте га, доприносите развоју

_{📖 [Водич за Docker](docs/guides/DOCKER_GUIDE.md) · [Десктоп](electron/README.md) · [Системска палета у траци менија](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Ново: OmniRoute унутар изворног Copilot Chat-а у VS Code-у

> Без нове бочне траке и новог интерфејса за ћаскање — сваки модел који OmniRoute послужује појављује се директно у > **бирачу модела Copilot Chat-а који већ користите**. Од верзије VS Code 1.122, модели добављача раде > без пријављивања на GitHub или претплате на Copilot — агентски режим, позивање алата и рад са сликама, > бесплатно. Инсталирајте проширење **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, усмерите га ка свом OmniRoute серверу (подразумевано је `localhost:20128`), а затим отворите Copilot Chat → бирач модела → **Управљај моделима…** → **OmniRoute**.

Продавница	Веза	Ради са
🧩 VS Code Marketplace	Инсталирај →	VS Code — стабилна и Insiders верзија
🔓 Open VSX Registry	Инсталирај →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Унутар уређивача: отворите приказ **Extensions**, потражите **"OmniRoute"**, кликните на **Install** — ради на исти начин у обе продавнице. Изворни код, пријаве проблема и упутство за објављивање налазе се на [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Водич за VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — подешавање, шта бирач приказује, контролна табла у картици, решавање проблема}

### 🎩 Ново: OmniRouteTray — ваш мрежни пролаз у траци менија

> `omniroute serve` најбоље ради када је стално укључен. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)** > претвара га у macOS апликацију у траци менија коју једном подесите и заборавите: покреће сервер, одржава га активним > након поновних покретања, ажурира га на лицу места и омогућава приступ тренутном буџету токена једним кликом — **без > остављања отвореног прозора терминала и без надгледања команде `npm install -g omniroute`.** Направљен помоћу [Tauri v2](https://v2.tauri.app/) (Rust језгро занемарљиве величине), испоручује се са сопственим потписаним Node 24 извршним окружењем и управља OmniRoute инсталацијом у власништву апликације, тако да никада није у сукобу са вашим глобалним `node`/`bun` окружењем. **Дели вашу постојећу `~/.omniroute/` конфигурацију и базу података** — тако да је то исти OmniRoute који већ користите, само са шеширом. 🎩

Шта ради	Како
🟢 Надгледа сервер	Покреће `omniroute serve` и преузима већ покренуту инстанцу уместо да је дуплира
📊 Тренутна потрошња на први поглед	Траке квота добављача, ограничења Claude сесије и недељна ограничења са одбројавањем до ресетовања, преглед трошкова за 30 дана
🔄 Аутоматски се ажурира на лицу места	Фазна инсталација, атомска замена, враћање на претходну верзију у случају неуспеха — увек на најновијем издању
🚀 Покретање при пријављивању	Опционо покретање при пријављивању; само системска палета, без иконе у Dock-у
🩺 Дијагностика и евиденције	Дијагностика једним кликом и приступ евиденцијама сервера

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Радије бисте преузели апликацију? Преузмите најновији .dmg са странице
Издања. Изворни кôд, пријаве проблема и документација за
изградњу доступни су на zoispag/omniroute-tray.

💛 Пројекат заједнице који је направио @zoispag — није званично OmniRoute издање.}

## 🔒 Приватно и локално на првом месту

_{📖 [Ауторизација](docs/architecture/AUTHZ_GUIDE.md) · [Заштитне мере](docs/security/GUARDRAILS.md) · [Усклађеност](docs/security/COMPLIANCE.md)}

## 🔌 Потпуни CLI + A2A и MCP

> Поред сервера, OmniRoute је **потпуна командна контролна табла** са **више од 80 команди**, уз отворене протоколе за агенте, тако да AI агент може да управља њиме **самостално**. ### ⌨️ Прави CLI (не само `start`) ```bash omniroute # покрени мрежни пролаз + контролну таблу (порт 20128) omniroute chat # интерактивни TUI клијент за ћаскање (косе команде: /model /combo /skill /memory) omniroute setup # вођени чаробњак за прво покретање omniroute doctor # дијагностикуј провајдере, портове и изворне зависности ``` ### 🛰️ Удаљени режим — покрените CLI овде, а OmniRoute на VPS-у OmniRoute је на серверу? Управљајте њиме са лаптопа помоћу **истог CLI-ја**. Пријавите се једном помоћу приступног токена ограниченог опсега; свака наредна команда биће усмерена ка удаљеном серверу. ```bash omniroute connect 192.168.0.15 # лозинка → токен ограниченог опсега, сачуван као контекст omniroute models # ← извршава се на УДАЉЕНОМ серверу omniroute configure codex # ← бира удаљени модел, уписује локални Codex профил omniroute tokens create --name ci --scope read # направи токене ужег опсега за друге машине omniroute contexts use default # ← врати се на локални сервер ``` Токени имају опсег `read` / `write` / `admin`; руте које покрећу процесе остају доступне само преко локалне повратне адресе. _{📖 [Удаљени режим](docs/guides/REMOTE-MODE.md)}

Анимирани терминал који демонстрира OmniRoute CLI — omniroute providers list, omniroute combo list и omniroute health — смењујући 86 команди највишег нивоа: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 Повежите агента — и он сам управља OmniRoute-ом Изложите OmniRoute преко **MCP-а**, **A2A**, **REST API-ја**, **webhook-ова** или **удаљеног CLI-ја** — сваки способан агент (или ваш код) добија приступ целом мрежном пролазу: рутирању, провајдерима, комбинацијама, кешу, компресији и меморији — аутономно. HTTP крајње тачке у наставку доступне су на `http://localhost:20128`.

Интерфејс	Крајња тачка / команда	Користите за
🧰 MCP (stdio)	`omniroute --mcp`	Повезивање са Claude Desktop-ом, Cursor-ом или било којим MCP клијентом
🌊 MCP (HTTP)	`/api/mcp/stream`	Удаљени MCP — 110 алата, 33 опсега (примена по избору), потпун ревизијски траг
📡 MCP (SSE)	`/api/mcp/sse`	Стриминг MCP транспорт
🤝 A2A	`/.well-known/agent.json`	Комуникација између агената, JSON-RPC 2.0 + SSE, 6 вештина
🌐 REST API	`/v1/*`	Компатибилан са OpenAI-јем — ћаскање, угнежђивања, слике, звук, OCR
🔔 Webhook-ови	`/api/webhooks`	Шаљите догађаје захтева / квота у Slack, Discord, Telegram или на било који URL
🛰️ Удаљени CLI	`omniroute connect`	Управљајте удаљеном инстанцом помоћу приступних токена ограниченог опсега

```bash # Омогућите Claude Code-у потпун OmniRoute скуп алата преко MCP-а: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP сервер](docs/frameworks/MCP-SERVER.md) · [A2A сервер](docs/frameworks/A2A-SERVER.md) · [Протоколи за агенте](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Уштедите 15–95% токена — аутоматски

### 📖 Како функционише — ток обраде, архитектура и прорачун уштеде

OmniRoute ток компресије: илустративни клијентски захтев од 10.000 токена пролази кроз 12 комбинованих механизама — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra и OmniGlyph — и у документованом примеру са наслаганим механизмима може стићи до добављача са приближно 1.080 токена. Структурирани садржај заштићен је механизмима за очување и проверама верности у сваком кораку; експлицитни режими са губицима или експериментални режими могу трансформисати одговарајући садржај.

Подразумевана наслагана комбинација покреће `RTK → Caveman`. Када оба механизма делују на исти садржај алата/контекста, уштеде се множе: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Блокови кода, URL адресе, JSON и структурирани подаци су **увек заштићени** механизмом за очување. > **Зашто користити много токена када је довољно неколико?** Сваки захтев пролази кроз OmniRoute ток компресије **транспарентно** — без измена на клијенту. Сада је то **скуп од 12 комбинованих механизама** који се извршавају редом и комбинују за сваку комбинацију рутирања — надовезујући се на идеје из пројеката [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) и [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Скуп од 12 механизама Механизми се извршавају редоследом тока обраде; сваки се може независно укључити или искључити и конфигурисати за сваку комбинацију:

#	Механизам	Шта ради
1	Session-Dedup	Уклања садржај који се понавља у више размена (адресиран садржајем, између размена)
2	CCR	Архивира велике блокове иза ознака за преузимање, доступне на захтев
3	Lite	Скраћивање размака и URL адреса слика (основни режим са малим кашњењем)
4	RTK	Паметно филтрирање, уклањање дупликата и скраћивање резултата алата (уз разумевање команди)
5	Responses Tool Output	JSON компресија првенствено без губитака + ограничена дијагностичка компресија за излазе љуске/закрпа/претраге/изградње (Responses API)
6	Headroom	Табеларно сажимање JSON низова без губитака (~30%) помоћу уграђеног GCF кодека
7	Relevance	Екстрактивно оцењивање реченица у односу на последњи кориснички упит
8	Caveman	Компресија прозе заснована на правилима (~65–75% на излазу)
9	Aggressive	Сажимање + прогресивно старење претходних размена
10	LLMLingua-2	ML семантичко орезивање помоћу MobileBERT ONNX — безбедно за код, асинхроно
11	Ultra	Хеуристичко орезивање токена са опционим нивоом малог модела (SLM)
12	OmniGlyph	Експериментално кодирање контекста као слике за измерени Claude Fable 5 при директној Anthropic комуникацији; GPT 5.6 трансформатори остају подразумевано онемогућени док се не добију потврде добављача. Четири профила компресије (подразумевани агресивни, уравнотежени, безбедан за кодирање, без измена) (најагресивнији; захтева експлицитно укључивање)

Блокови кода, URL адресе и структурирани подаци се **увек чувају** савршено, бајт по бајт. **Унапред подешени режими једним кликом** комбинују механизме:

Режим	Уштеда	Најбоље за
🪶 Lite	~15%	Безбедан подразумевани режим који је увек укључен
🪨 Standard (Caveman)	~30%	Свакодневно програмирање
⚡ Aggressive	~50%	Дуге сесије са интензивном употребом алата
🔥 Ultra	~75%	Максимална уштеда
🧰 RTK	60–90%	Излаз љуске/тестова/изградње/git-а
🔗 Наслагано (RTK → Caveman)	78–95%	Мешовити упити + евиденције алата

**Стварни пример — режим Standard:** > **Пре (69 токена):** _„Разлог због којег се ваша React компонента поново приказује вероватно је то што у сваком циклусу приказивања правите нову референцу на објекат. Када проследите уграђени објекат као својство, React-ово површно поређење сваки пут га види као други објекат, што покреће поновно приказивање. Препоручујем да употребите useMemo како бисте мемоизовали објекат.“_ > > **После (19 токена):** _„Нова референца објекта при сваком приказивању. Уграђени објекат као својство = нова референца = поновно приказивање. Обмотајте у useMemo.“_ > > **Исти одговор. 72% мање токена. Без губитка тачности.** ✅ **PT-BR пример — режим [Troglodita](https://github.com/leninejunior/troglodita):** > **Пре (42 токена):** _„Проблем је у томе што се компонента поново рендерује јер се у сваком циклусу рендеровања креира нова референца на објекат. Препоручио бих употребу useMemo.“_ > > **После (12 токена):** _„Поновно рендеровање: нова реф. у сваком циклусу (inline објекат поново креиран). Користити `useMemo`.“_ > > **Исти одговор. ~70% мање токена. Техничка прецизност очувана.** ✅
### 🎚️ Више од механизама — стилови излаза, адаптивни регулатор и контрола по захтеву Наведених 12 механизама смањују оно што **улази**. Још три слоја обликују **како**, **када** и шта **излази**: - **🪄 Стилови излаза** _(усмеравање по оси излаза)_ — умећу детерминистичка упутства за обликовање одговора која су безбедна за кеширање; могу се комбиновати, сваки са интензитетом `lite` / `full` / `ultra`. Додавање стила је једнолинијски унос у регистар: - **Сажета проза** — избацује поштапалице / чланове / ограђивање; техничка суштина остаје потпуно прецизна. - **Мање кода** — YAGNI приступ „лењег сениор програмера“: најмања функционална измена, без незатражене пратеће структуре. - **Коњски реп (лењи сениор програмер)** — напредује YAGNI лествицом, отклања основни узрок, најмањи функционални diff. - **Имам ADHD (прво радња)** — почиње следећом радњом, нумерисани кораци, један конкретан следећи корак, без увода. - **Сажети CJK (文言)** — ултрасажети стил класичног кинеског (ограничен на локал `zh`). - **🎯 Адаптивни буџет контекста** _(регулатор)_ — уместо једног укљученог/искљученог прага токена, постепено активира најјефтиније механизме са најмање губитака, само онолико колико је потребно да се садржај **уклопи у контекстни прозор модела**. Политика: `reserve-output` (подразумевано, прилагођено моделу) · `percentage` · `absolute`. Режим: `floor` (гарантује уклапање) · `replace-autotrigger` (ваш изричити избор има предност) · `off` (застарели праг). - **🎛️ Где се одлучује о компресији** _(приоритет, од високог ка ниском)_ — заглавље `x-omniroute-compression` по захтеву › замена за комбинацију рутирања › активни именовани профил › адаптивно / аутоматско активирање › подразумевано подешавање панела › искључено. Примењени план се враћа у заглављу одговора `X-OmniRoute-Compression: ; source=`. Користите аутоматско активирање према прагу токена, укључите адаптивни регулатор, закачите именовани профил, поставите једнократно подешавање по захтеву или доделите pipeline свакој комбинацији рутирања — шта год одговара радном оптерећењу. Опционо offline **окружење за евалуацију** (`npm run eval:compression`) оцењује верност у односу на уштеду на фиксираном корпусу пре него што примените измену. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Брзи почетак

**1) Инсталирајте и покрените** ```bash npm install -g omniroute omniroute ``` > 💡 Видите `npm warn ERESOLVE` или упозорења о peer зависностима? [Безопасна су](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Користите npm 11 или новији?** npm може блокирати скрипте животног циклуса пакета ако нису дозвољене. OmniRoute-ов `postinstall` (`node scripts/build/postinstall.mjs`) неопходан је за припрему његових изворних runtime датотека. При глобалној инсталацији дозволите пакете наведене у npm упозорењу. За скуп пакета који пријављује OmniRoute 3.8.51: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Да бисте ову листу дозвољених пакета поново користили за будуће глобалне инсталације, подесите је једном, а затим инсталирајте на уобичајен начин: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Листа зависности може да се мења између издања; ако npm пријави другачију листу, користите називе пакета из тог упозорења. Дозвољавање пакета омогућава извршавање његових инсталационих скрипти. > **Користите Gemini Web или другог добављача заснованог на веб колачићима?** npm пакет садржи > Playwright, али не и његову Chromium бинарну датотеку. Пре слања првог захтева веб добављачу погледајте > напомену о [подешавању Playwright Chromium-а](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium). Контролна табла је на `http://localhost:20128` · API је на `http://localhost:20128/v1`. **2) Повежите одговарајућег добављача користећи сопствени налог** Контролна табла → **Добављачи** → изаберите добављача чији тренутни услови и квота одговарају вашем случају употребе → додајте његов API кључ или довршите поступак повезивања налога. Бесплатни нивои могу захтевати регистрацију, одобрење или начин плаћања. Прегледајте [Водич за бесплатне нивое](docs/getting-started/FREE-TIERS-GUIDE.md); доступност без кључа није загарантована, а добављачи означени са `tos: avoid` подразумевано су изузети из `auto`. **3) Усмерите свој алат за програмирање** ```txt Основни URL: http://localhost:20128/v1 API кључ: [копирајте из Контролна табла → Крајње тачке] Модел: auto (рутира између одговарајућих веза — или изаберите добављача/модел) ``` **4) Проверите да ли ради** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Требало би да видите листу повезаних модела. 🎉 То је све — почните да програмирате, а OmniRoute ће аутоматски рутирати захтеве и прелазити на резервну опцију. Ако ваш клијент не може да шаље прилагођена заглавља, OmniRoute такође нуди токенизоване алијасе за компатибилност: ```txt OpenAI каталог: http://localhost:20128/vscode/YOUR_KEY/ OpenAI модели: http://localhost:20128/vscode/YOUR_KEY/models OpenAI ћаскање: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI одговори: http://localhost:20128/vscode/YOUR_KEY/responses Ollama ћаскање: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama ознаке: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Користите их само за клијенте који не могу да додају `Authorization: Bearer ...`. Аутентификација путем заглавља остаје препоручени режим.
## 📦 Још начина инсталације — Docker, изворни код, 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` прати највишу **објављену** стабилну SemVer верзију. Не прати git `main`. Закуцајте `:X.Y.Z` за GitOps. Погледајте [Канале издања за Docker](docs/guides/DOCKER_GUIDE.md#release-channels).Слика фиксира **`OMNIROUTE_MEMORY_MB=1024`**. То је довољно за контролну таблу и лагану преписку. **Агенти за кодирање** (`POST /v1/responses` из Claude Code, Codex, Grok, …) захтевају много већи V8 хеап, иначе процес доживи `FATAL ERROR` на ~12 GiB под два дуга контекста која се преклапају. Димензионишите контејнер изнад хеапа (нативни бафери се налазе изван V8): | Радно оптерећење | Хеап (`-e OMNIROUTE_MEMORY_MB`) | Контејнер (`--memory`) | | --------------------------------------- | ------------------------------- | ---------------------- | | Контролна табла / лагана преписка | `1024` (подразумевано за слику) | ≥2 g | | Један агент за кодирање | `8192` | ≥10 g | | Два истовремена дугачка `/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 ``` Пуна табела: [Водич за Docker — RAM у време извршавања](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Docker канал за претходна издања:** `diegosouzapw/omniroute:next` и > `diegosouzapw/omniroute:next-web` прате тренутну подразумевану грану `release/v*`. > Ове промењиве ознаке намењене су само за тестирање необјављених исправки и > **нису подржане за продукцију**. Погледајте > [Канале издања за Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Стандардни `bun install` и глобална инсталација (`bun install -g omniroute`) су подржани кроз детекцију Bun окружења: - **Уграђени `bun:sqlite`**: OmniRoute користи Bun-ов уграђени `bun:sqlite` драјвер када се извршава под Bun-ом, а враћа се на `better-sqlite3` на Node.js или `sql.js`. - **Аутоматски избор Webpack бандлера у развоју**: Развој (`bun run dev`) аутоматски детектује Bun и онемогућава Turbopack у корист Webpack-а како би се спречиле некомпатибилности нативних V8 везивања. Продукцијске изградње (`bun run build`) следе `OMNIROUTE_USE_TURBOPACK` потпуно исто као на Node-у: Turbopack је подразумеван, `OMNIROUTE_USE_TURBOPACK=0` за изградњу са Webpack-ом (`Dockerfile.bun` га излаже као `--build-arg`). - **Наменски Bun Dockerfile**: Вишефазна `Dockerfile.bun` за нативна Bun продукцијска распоређивања (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Инсталирање и покретање са Bun-ом bun install bun run dev ``` **🛠️ Из изворног кода** ```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 flake-ова nix develop npm run dev # Или коришћењем devbox-а devbox run npm run dev ``` 📖 [Водич за Docker](docs/guides/DOCKER_GUIDE.md) — Compose профили, Caddy HTTPS, Cloudflare тунели. **🦭 Podman** ```bash # 1. Припремите директоријум података монтиран преко bind-а mkdir -p data # 2. Само Linux + локални rootless Podman (никад удаљени клијент Podman Machine): podman unshare chown 1000:1000 ./data # 3. Поставите назнаку окружења, изградите локалну Compose слику и покрените echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` На macOS-у или Windows-у Podman користи удаљени Podman Machine: прескочите `podman unshare` и пратите [упутства за директоријум података специфична за топологију](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Водич за Podman](contrib/podman/README.md) — Compose изградње, Podman Machine и подешавање Linux/systemd Quadlet-а. **⚡ Бржа / лакша инсталација (прескочите нативну изградњу)** Нативни SQLite мотор (`better-sqlite3`) је **опциона** зависност, тако да се глобална инсталација никада не блокира на компајлирању из изворног кода: користи унапред изграђени бинарни фајл када одговара вашој платформи/Node-у, а у супротном се транспарентно враћа на чисто-JS мотор (`node:sqlite` на Node 22+, иначе уграђени `sql.js` WASM) — алати за изградњу нису потребни. Да у потпуности прескочите **нативно загревање** након инсталације (CI, без графичког интерфејса или споре машине). Напомена: ово прескаче само корак нативног SQLite загревања (`scripts/postinstall.mjs`); кука за копирање/поправку бинарног фајла (`scripts/build/postinstall.mjs`) се и даље извршава нормално: ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 такође га прескаче ``` За најбрже инсталације преферирајте **pnpm** (складиште са адресирањем садржаја + тврде везе — види горе). За извршавање без контролне табле и без графичког интерфејса користите Docker `base` профил (горе) или [водич за Termux](docs/guides/TERMUX_GUIDE.md). CLI и веб контролна табла се служе из истог процеса на једном порту, тако да данас не постоји засебан пакет само за CLI.

# 🎬 OmniRoute у акцији

## 📹 Видео водичи

_{Снимак контролне табле на 2026-08-24 · Сирови каталог: YT 809 | TT 137 | IG 124 · Свежина (дана): YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — 3.042.474 прегледа}

🎬 #2 — Instagram
_{theopenstack — 692.419 прегледа}

🎬 #3 — TikTok
_{milesreevesai — 620.400 прегледа}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391.109 прегледа}

🎬 #5 — Instagram
_{buildwithai.club — 347.652 прегледа}

**Комплетан ранг (канонски URL-ови без дупликата, `v > 0`, највећи домет):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3.042.474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692.419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620.400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391.109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347.652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331.973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263.744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218.174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186.786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177.800** | Канонске метрике на 2026-08-24: **1.029 јединствених видео снимака** · **11.132.922 познатих прегледа** (`v > 0`) · **639 канала/профила по мрежи**. Сирова табла садржи 1.070 редова; 41 дупликат са Instagram-а је нормализован преко канонског URL-а, задржавајући највећи број по видео снимку. > 🎬 **Направили сте видео о OmniRoute?** Отворите [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) или [discussion](https://github.com/diegosouzapw/OmniRoute/discussions) са линком — објавићемо га овде.

# 📧 Заједница и помоћ > Све на једном месту — пратите одржаваоца, разговарајте са заједницом или отворите issue. | Канал | Где / како | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — прати одржаваоца | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — прати због издања и савета | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Глобални** | [придружи се групи](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Бразил** | [придружи се групи](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Веб-сајт** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute заједница (бесплатно)** | [sthub портал](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Изворни код** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Пријави грешку** | [отвори пријаву](https://github.com/diegosouzapw/OmniRoute/issues) — приложи излаз команде `npm run system-info` | | 🤝 **Допринеси** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Модел гранања и издавања](docs/ops/BRANCHING_MODEL.md) · изабери `good first issue` | | 💚 **Подржи пројекат** | [Начини подршке ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Технолошки стек

Слој	Технологија
Извршно окружење	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Језик	TypeScript 6.0 — 100% TypeScript у директоријумима `src/` и `open-sse/` (без иједног `any` у језгру од верзије v2.0)
Радни оквир	Next.js 16 + React 19 + Tailwind CSS 4
База података	better-sqlite3 (SQLite, WAL вођење дневника) + LowDB (наслеђени JSON) — 137 доменских модула, 208 миграције
Меморија	SQLite FTS5 претрага целог текста + векторска угњежђивања квантизована на int8, типизирано опадање
Шеме	Zod 4 — валидација улаза/излаза MCP алата + API уговори
Протоколи	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Стримовање	Server-Sent Events (SSE) + WebSocket мост (`/v1/ws`)
Компресија	ток обраде са 12 механизама — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Аутентификација и безбедност	OAuth 2.0 (PKCE) + JWT + API кључеви + MCP аутентификација ограниченог опсега · AES-256-GCM за податке у мировању · DOMPurify
Прикривеност	wreq-js — имитирање JA3 / JA4 TLS отиска, прокси у 3 нивоа
Отпорност	прекидач кола, експоненцијално одлагање, спречавање навале истовремених захтева, самостално опорављање аутоматских комбинација
Евидентирање	pino — структурирани JSON дневници са контекстом захтева
Тестирање	Node.js покретач тестова + Vitest — 39.000+ статичких декларација тестова у више од 5.100 праћених тестних датотека (јединични, интеграциони, E2E, безбедносни и екосистемски тестови)
Платформе	Десктоп (Electron) · Android (Termux) · PWA (било који прегледач)
CI/CD	GitHub Actions — аутоматско објављивање на npm и Docker Hub при издавању
Везе	Веб-сајт · npm · Docker Hub

## 📖 Документација

### 📘 Почетак рада

Документ	Опис
Кориснички водич	Провајдери, комбинације, CLI интеграција, постављање
Водич за подешавање	Сви начини инсталације, конфигурације CLI алата, подешавање протокола, подешавање временског ограничења
Водич за CLI алате	Подешавање по алату за Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Удаљени режим	Управљајте удаљеним OmniRoute-ом (VPS) из CLI-ја на свом лаптопу путем приступних токена ограниченог опсега
Конфигурација Claude Code-а	Усмерите Claude Code на OmniRoute (локални/удаљени) помоћу `launch` + профила за сваки модел
Брзи почетак	Инсталација у 3 корака → повезивање → конфигурисање

### 🔧 Операције и постављање

Документ	Опис
Водич за Docker	Docker run, Compose профили, Caddy HTTPS, тунели, ознаке слика
Водич за Podman	Интеграција Quadlet-а са systemd-ом, podman-compose, SELinux
Постављање на VM	Комплетан водич: подешавање VM-а + nginx-а + Cloudflare-а
Постављање на Fly.io	Постављање на Fly.io са трајним складиштем
Водич за Termux	Покретање OmniRoute-а на Android-у путем Termux-а
Водич за PWA	Инсталација прогресивне веб-апликације, кеширање, архитектура
Водич за деинсталацију	Потпуно уклањање за све начине инсталације
Конфигурација окружења	Све променљиве и референце за `.env`

### 🧠 Функционалности и архитектура

Документ	Опис
Архитектура	Архитектура система, ток података и унутрашњи механизми
Водич за компресију	Ток обраде са 7 опција: искључено / лагано / стандардно / агресивно / ултра / RTK / наслагано
RTK компресија	Компресија излаза команди, филтери, поверење, провера, опоравак сировог излаза
Механизми компресије	Caveman, RTK, наслагани токови обраде, површине контролне табле/API-ја/MCP-а
Формат правила компресије	Шеме JSON пакета правила за Caveman и RTK филтере
Језички пакети за компресију	Откривање језика и израда Caveman пакета правила
Водич за отпорност	Прекидачи кола, периоди хлађења, ред, спречавање наглог масовног оптерећења, TLS лажирање
Механизам Auto-Combo	Бодовање на основу 16 фактора, пакети режима, самоопоравак
Водич за прокси	Прокси систем са 3 нивоа, 1proxy тржиште, CRUD регистра
Бесплатни нивои	Обједињени директоријум: 35 документованих периодичних скупова / 485 каталогизованих ставки бесплатног нивоа
Галерија функционалности	Визуелни обилазак контролне табле са снимцима екрана
Документација базе кода	Преглед базе кода прилагођен почетницима

### 🤖 Протоколи и API-ји

Документ	Опис
Референтна документација API-ја	Све крајње тачке са примерима
OpenAPI спецификација	OpenAPI 3.0 спецификација
MCP сервер	110 MCP алата, IDE конфигурације, Python/TS/Go клијенти
Водич за MCP сервер	Инсталација MCP-а, транспорти и референтна документација алата
A2A сервер	JSON-RPC 2.0 протокол, вештине, стримовање, управљање задацима
Водич за A2A сервер	Картица A2A агента, задаци, вештине и стримовање

### 📋 Пројекат и квалитет

Документ	Опис
Доприношење	Подешавање развојног окружења и смернице
Модел гранања и издавања	Ка којим гранама се усмеравају PR-ови (`release/*`) и шта означавају `main` и ознаке
Дневник измена	Потпуна историја издања по верзијама
Безбедносна политика	Пријављивање рањивости и безбедносне праксе
Водич за i18n	Подршка за 42 језика, ток рада на превођењу, RTL
Контролна листа за издавање	Кораци за проверу пре издавања
План покривености	Стратегија покривености тестовима за више од 39.000 статичких декларација тестова у више од 5.100 праћених тестних датотека

# ⭐ Најистакнутији доприносиоци > OmniRoute обликује посвећена заједница отвореног кода. Ови појединци су дали изузетне доприносе који непосредно утичу на квалитет, стабилност и досег пројекта. **Хвала вам.** ### Спољни доприносиоци према броју спојених захтева за измене

Место	Доприносилац	Спојени PR-ови	~Измењених линија
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{Замрзнуто на актуелном врху гране release/v3.8.50, комит dafb4ae808, са спајањима закључно са 2026-08-24 05:26:03 UTC. Страничени GitHub GraphQL попис садржи 5.911 спојених PR-ова: 2.707 од власника репозиторијума, 179 од Dependabot-а и 3.025 спољних PR-ова од 535 различитих доприносилаца. „Измењене линије“ представљају збир додавања и брисања на GitHub-у и обухватају генерисане датотеке, lockfile датотеке, каталоге, преводе и документацију; то је обим измена, а не број ауторских линија кода. Изједначења на граничној позицији су задржана.} ### Комитови приписани на GitHub-у

backryun _{🥇 220 комитова приписаних на GitHub-у}	Paijo _{🥈 219 комитова приписаних на GitHub-у}	Randi _{🥉 108 комитова приписаних на GitHub-у}	Ravi Tharuma _{🏅 81 комит приписан на GitHub-у}	Chris _{🏅 70 комитова приписаних на GitHub-у}	Markus Hartung _{🏅 69 комитова приписаних на GitHub-у · деле 6. место}
Dizzle _{🏅 69 комитова приписаних на GitHub-у · деле 6. место}	Jan Leon _{🏅 64 комита приписана на GitHub-у}	zenobit _{🏅 62 комита приписана на GitHub-у}	Bob.Hou _{🏅 51 комит приписан на GitHub-у · деле 10. место}	Xiangzhe _{🏅 51 комит приписан на GitHub-у · деле 10. место}

_{Поново проверено 2026-08-24 06:14:31 UTC: комитови приписани на GitHub-у које је пријавио API репозиторијума за доприносиоце за подразумевану грану release/v3.8.50. API је вратио 525 идентитета (415 корисника, 2 бота, 108 анонимних); ова табела изоставља одржаваоца, ботове и анонимне идентитете и задржава дељена места. Разликује се и од горенаведеног рангирања спојених PR-ова и од пописа 639 особа на основу Git метаподатака у наставку.} > 🙏 Функционалности, исправке грешака и побољшања инфраструктуре ових доприносилаца представљају **кључни део** онога што OmniRoute чини поузданим и богатим функционалностима. Сваки захтев за спајање, сваки тестни случај и свака датотека i18n превода су важни. Отворени код граде људи попут њих.

---
## 💖 Спонзори

Од срца хвала људима који финансирају OmniRoute из сопственог џепа — сваки допринос одржава пројекат бесплатним, независним и активним.

Andrew
_{💛 Активни месечни спонзор}

Vlad I
_{💛 Активни месечни спонзор}

Paco Cartones
_{💛 Активни једнократни спонзор}

Prof. Igor Morais
_{💛 Бивши једнократни подржавалац}

longtao
_{💛 Бивши једнократни подржавалац}

_{… и други који желе да остану приватни 💛} _{Јавни GitHub Sponsors налози поново су проверени 2026-08-24. GitHub-ов статус activeOnly одређује активне ознаке изнад; претходно објављени јавни једнократни подржаваоци и даље су наведени уз захвалност, док приватни спонзори остају анонимни.} 💖 Постаните спонзор → — сваки долар одржава OmniRoute бесплатним и независним.

## 👥 600+ доприносилаца

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Проверено 2026-08-24 на замрзнутој основи ac02c5b42f и поново проверено на тренутном врху release/v3.8.50 гране dafb4ae808: 639 нормализованих људских Git идентитета — 407 се појављује као аутор комита (укључујући одржаваоца), а 232 само у експлицитним завршним ознакама Co-authored-by. Попис нормализује GitHub noreply ручице, искључује 26 идентитета ботова/агената/сервиса/резервисаних места и не спаја обичне адресе е-поште само зато што им се приказана имена поклапају.} ### Како допринети 1. Направите fork репозиторијума 2. Направите грану на основу **активног** врха `release/vX.Y.Z` (не `main`) — погледајте [Модел гранања и издавања](docs/ops/BRANCHING_MODEL.md) 3. Направите своју грану функције (`git checkout -b feat/amazing-feature`) 4. Комитујте измене (`git commit -m 'feat: add amazing feature'`) 5. Пошаљите измене на грану (`git push origin feat/amazing-feature`) 6. Отворите Pull Request са **основом = том граном `release/vX.Y.Z`** Погледајте [CONTRIBUTING.md](CONTRIBUTING.md) за детаљна упутства. ### Објављивање нове верзије ```bash # Креирајте издање — npm publish се извршава аутоматски VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Звездице

## 🌍 StarMapper

## 🙏 Захвалнице

OmniRoute стоји на раменима дивова. Настао је као форк пројекта **[9router](https://github.com/decolua/9router)** и TypeScript порт Go пројекта **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — а одатле је сваки подсистем у наставку инспирисан пројектом отвореног кода који је то већ остварио. Сваки од њих обликовао је конкретан део пројекта OmniRoute. Овим путем захваљујемо свима њима. 🙏 > ⭐ број звездица је проверен путем GitHub REST API-ја 24. августа 2026. — подржите ове пројекте звездицом. Наведени бројеви представљају тачан снимак стања на тај датум и временом ће се природно мењати. ### 🧬 Порекло и мрежни пролаз

Пројекат	⭐	Како је инспирисао OmniRoute
9router	26,161	Оригинални пројекат на којем је овај форк заснован — овде проширен мултимодалним API-јима и потпуно преписан у TypeScript-у.
CLIProxyAPI	48,497	Имплементација у језику Go која је инспирисала овај порт за JavaScript / TypeScript.
LiteLLM	57,100	AI мрежни пролаз чији јавни скуп података о ценама служи за нашу синхронизацију праћења трошкова и чији је модел нормализације добављача утицао на наше усмеравање.
codex-chatgpt-web	1,410	MIT изворни код прилагођен и укључен као мост ChatGPT Web → Codex Responses, укључујући адаптере за сесију прегледача, уоквиравање одговора, употребу и веб-претрагу.
free-claude-code	48,112	Обрасци пренети у опоравак стрима, алијасе без размишљања, резервну веб-претрагу, ограничења клизног прозора, редакцију евиденције и ојачане токове покретача.
composer-api	322	Обрасци избора алата, ограничења излаза и потврђивања алата из Cursor Composer-а прилагођени су изворном Cursor извршиоцу.
codex-multi-auth	457	Обрасци нове пријаве и ротације токена за освежавање пренети су у поновну аутентификацију за Codex OAuth.
opencode-anthropic-auth	510	Подразумеване трансформације компатибилне са Claude Code-ом и понашање заглавља за наплату уопштени су у OmniRoute-ов мост вођен конфигурацијом.
grok2api-merged	2	Његова мапирања Grok модела, Statsig генератор лажне грешке TypeError, подразумеване вредности захтева и уређаја и процесор NDJSON одговора у значајној мери су прилагођени за OmniRoute-ов Grok Web извршилац.
TQZHR/grok2api	705	Главни транзитивни извор кода иза пројекта grok2api-merged; његове имплементације модела, заглавља, корисног садржаја, Statsig-а и процесора очуване су у развојној линији Grok Web-а.
chenyme/grok2api	7,520	Основни MIT изворни код за подразумеване вредности Grok корисног садржаја и уређаја, Statsig генератор и процесор `result.response`, пренет кроз TQZHR и grok2api-merged.
grok2api-pro	27	Транзитивни извор који grok2api-merged наводи као заслужан за свој слој скупа проксија; OmniRoute задржава ту напомену о пореклу, али не тврди да је пренео скуп проксија у свој ограничени Grok Web извршилац.
GrokProxy	50	Његов Grok прокси са аутентификацијом помоћу колачића и образац стримовања `result.response.token` утицали су на OmniRoute-ов Grok Web транспорт.
GrokBridge	5	Оригинална имплементација Grok Web-а ослањала се на његов дизајн узводне HTTP/прегледачке везе; њена директна HTTP путања потиче из GrokProxy-ја, па се не тврди да је извршен независан пренос кода.
grok-web-api	14	Његове Rust шеме за `ChatOptions` и омотач одговора утицале су на OmniRoute-ове TypeScript типове за Grok захтеве и стримоване одговоре.

### 🗜️ Компресија контекста и токена — механизми

Пројекат	⭐	Како је инспирисао OmniRoute
Caveman	100,538	Вирални пројекат „зашто користити много токена кад мало токена ради посао“ — његова филозофија пећинског говора покреће наш стандардни режим компресије и више од 30 правила за уклањање поштапалица и сажимање.
RTK – Rust Token Killer	77,185	Компресија излаза команди високих перформанси — инспирисала је наш RTK механизам, DSL за JSON филтере, опоравак сировог излаза и надовезани ток обраде RTK → Caveman.
headroom	67,310	Реверзибилна компресија контекста (SmartCrusher) — инспирисала је наш механизам `headroom` и образац маркера за преузимање `ccr`.
LLMLingua	6,598	Истраживање компресије упита (LLMLingua / LLMLingua-2) — инспирисало је наш асинхрони механизам `llmlingua`, безбедан за кôд и отпоран на грешке.
llmlingua-2-js	31	JS/ONNX порт (MobileBERT / XLM-RoBERTa) који се користи као позадински систем у радној нити за наш LLMLingua механизам.
Troglodita	40	Компресија токена за PT-BR — покреће наш језички пакет за pt-BR: смањивање плеоназама и уклањање поштапалица прилагођено граматици бразилског португалског.
ponytail	108,957	Вирална YAGNI вештина кодирања „лењег старијег програмера“ — инспирисала је наш излазни стил мање кода: усмеравање ка најмањој функционалној измени које смањује _генерисани_ кôд (пандан сажетој прози Caveman-а на оси излаза).
i-have-adhd	23,526	Његов стил одговора усмерен прво на радњу и прилагођен особама са ADHD-ом преобликован је у сажети излазни стил OmniRoute-а на пет језика.

### 🧩 Компактни формати, истраживање токена и алати који разумеју кôд

Пројекат	⭐	Како је инспирисао OmniRoute
TOON	25,233	Објектна нотација оријентисана на токене — њен колонарни модел са заглављем и редовима обликовао је нашу фазу табеларног сажимања.
GCF – Graph Compact Format	41	Његов компактни формат графова и дизајн генеричког профила утицали су на табеларно сажимање OmniRoute-а и формат Headroom кодека.
gcf-typescript	4	MIT имплементација за TypeScript, директно уграђена и проширена као Headroom кодек генеричког профила.
token-optimizer-mcp	494	Brotli/SQLite кеш + разлика контекста по сесији — инспирисали су наш механизам `session-dedup`.
token-savior	1,122	Сажимање Bash излаза + MCP профили — инспирисали су нашу дисциплину одустајања од компресије и смањивање манифеста MCP алата.
token-saver	138	Компресија излаза која узима у обзир садржај и тип сваке датотеке, са одустајањем при грешци — потврдила је наш избор обраде по типу и прескакање када нема минималног добитка.
token-optimizer	1,951	„Пронађи токене духове“ — његов образац издвајања и обновљивих ручки утицао је на наш приступ CCR издвајању.
TokenMizer	28	Нацрт графа сесије и дедупликације редова кроз више размена који је утицао на дизајн нашег механизма session-dedup.
OmniCompress	3	Колонарни JSON у Rust-у + преузимање адресирано садржајем + дедупликација између порука — потврдили су дизајн наших механизама `headroom`/`ccr`/`session-dedup` и инваријанту стабилну за кеш: „компримовани облик не зависи од позиције“.
mcp-compressor	113	Компресија шема и описа MCP алата — утицала је на наше смањивање кардиналности манифеста MCP алата.
RepoMapper	197	Рангирање мапе репозиторијума у Aider стилу — утицало је на наше истраживање мапе репозиторијума и рангирања преузимања.
quiet-shell-mcp	4	Декларативно смањивање излаза љуске преко MCP-а — потврдило је наше декларативно сажимање Bash излаза.
ts-morph	6,162	Комплет алата за TypeScript Compiler API — инспирисао је наше уклањање коментара засновано на парсеру, које чува стринговске, шаблонске и регуларне литерале.

### 🧠 Меморија и RAG

Пројекат	⭐	Како је инспирисао OmniRoute
Mem0	63,902	Универзални слој меморије — његов модел проксија као границе за упис/читање обликовао је нашу архитектуру меморије.
Letta (MemGPT)	24,382	Агенти са стањем и вишеслојном меморијом — инспирисали су наш вишеслојни модел контроле и опоравка контекста (CCR).
WFGY	1,781	ProblemMap таксономија 16 понављајућих режима отказа RAG/LLM система — заједнички речник у нашем водичу за решавање проблема.

### 🛰️ Инспекција саобраћаја, MITM и транспарентни прокси

Пројекат	⭐	Како је инспирисао OmniRoute
llm-interceptor	66	MITM пресретање/анализа саобраћаја између асистента за програмирање и LLM-а утицали су на ране захтеве за Traffic Inspector. Четири претходно изведена модула — спајање SSE токова, нормализација разговора, маскирање тајни и санитизација заглавља — замењена су независним имплементацијама развијеним од нуле на основу јавних стандарда протокола. Две површине за директно прослеђивање ка хосту (`passthrough.ts` и `_internal/bypass.cjs`) остају интерне имплементације OmniRoute-а које су засебно класификоване; нису поново написане у оквиру те замене.
ProxyBridge	5,995	Транспарентно усмеравање проксија по процесу — инспирисало је наше безбедно гашење MITM-а у случају пада, временска ограничења неактивности сокета, приписивање процеса путем `/proc` и TPROXY хватање саобраћаја.

### 📚 Подаци о моделима, опсервабилност и кориснички интерфејс

Пројекат	⭐	Како је инспирисао OmniRoute
models.dev	6,555	Отворена база података са спецификацијама, ценама и могућностима AI модела — изворно синхронизована са нашим каталогом модела.
React Flow / xyflow	38,108	Библиотека графова заснована на чворовима која покреће наше Compression Studio и Combo/Routing Studio приказе у реалном времену.
LangGraph	40,314	LangGraph Studio визуелизација графа тока рада уживо инспирисала је каскадни приказ у реалном времену у нашим Studio приказима.
Langfuse	33,592	Његов модел опсервабилности траг → распон → генерисање обликовао је наш водопадни приказ у Compression Studio-у.
Kiali	3,631	Опсервабилност Istio сервисне мреже — инспирисала је наше ознаке прекидача кола и визуелне приказе грана са грешкама у Routing/Combo Studio-у.
lobe-icons	2,428	Логотипи AI/LLM брендова који приказују иконе добављача широм наше контролне табле.
flag-icons	12,354	Обезбеђује SVG заставе под MIT лиценцом које користи бирач језика у README-у.

### 🛡️ Безбедност

Пројекат	⭐	Како је инспирисао OmniRoute
awesome-secure-defaults	721	Пажљиво одабрана листа библиотека које су подразумевано безбедне и која усмерава наше безбедносне изборе (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Комплементарни алати

Пројекат	⭐	Како је инспирисао OmniRoute
ClawRouter	6,564	Инспирисао је дедупликацију захтева, резервну опцију без трошкова за хитне случајеве, прикључиве Auto-Combo стратегије и вишејезичну класификацију намера.
Antigravity-Manager	30,652	Његово пресликавање модела уз свест о налогу, провера путање извршне датотеке и понашање ознака планова утицали су на Antigravity окружење за извршавање у OmniRoute-у.
vscode-antigravity-cockpit	4,817	Његов компактни формат одбројавања до ресетовања квоте инспирисао је одговарајући приказ ограничења добављача у OmniRoute-у.
AionUi	32,230	Његове ACP интеграције инспирисале су аутоматско откривање инсталираних CLI агената у OmniRoute-у.
CodexBar	20,507	Идентификовао је површину квоте Grok Build-а; OmniRoute је затим независно проверио и исправио актуелни формат комуникације.

## 📄 Лиценца MIT лиценца — погледајте [LICENSE](LICENSE) за детаље. ---

**[⬆ Назад на врх](#-omniroute)** · Направљено са ❤️ за AI заједницу отвореног кода. _{OmniRoute v3.8.52 · Node ≥22.22.2 · MIT лиценца · omniroute.online}