# README (Български) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/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) · 🇷🇸 [sr](../sr/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,62 млрд. безплатни токена/месец · 19 стратегии за маршрутизиране · начало с $0.

## 💰 ~1,62 млрд. токена / месец от безплатните планове на трети страни

> **Използвайте собствените си акаунти при доставчиците.** Това е прогнозна обща стойност от отделни безплатни планове на трети страни, за които отговаряте на условията, а не предоставени от OmniRoute токени. Регистрирайте се, получете идентификационни данни, когато са необходими, и свържете доставчиците, които можете да използвате; всеки доставчик определя своите лимити, наличност и условия. > > Ръчното комбиниране на безплатни планове е мъчително — десетки SDK пакети, десетки ограничения на заявките и никаква представа с какъв общ ресурс действително разполагате. OmniRoute каталогизира **489 записа за безплатни планове в 35 ключа за периодично възстановяващи се пулове** и изчислява обобщения брой токени въз основа на **17-те пула с публикуван положителен месечен бюджет плюс пет лимита на Groq за отделни модели**, като премахва дублирането при споделени пулове. Квотите, които стават достъпни само след регионална проверка на самоличността (към момента: ModelScope), са показани отделно — +~6 млн. след регионална проверка на самоличността — и никога не се включват в обобщената стойност. Резултатът остава видим в таблото (`/dashboard/free-tiers`).

Карта на бюджета за безплатните планове в OmniRoute: устойчиво ~1,62 млрд. безплатни токена месечно и до ~2,22 млрд. през първия месец с кредитите при регистрация, от 35 документирани ключа за периодично възстановяващи се пулове, обхващащи 489 каталогизирани записа за безплатни планове зад една крайна точка. Честно изчисление с премахване на дублирането по пулове — всеки споделен пул се брои веднъж, включително 17 периодично възстановяващи се пула с публикуван положителен месечен бюджет от токени плюс пет лимита на Groq за отделни модели; 13 доставчици са отбелязани за избягване в каталога с рискове, свързани с условията, така че вие решавате. Лентата на бюджета включва Mistral 1 млрд., Nara 210 млн., LLM7 150 млн., xKiro 150 млн., Groq 30 млн. (пет лимита за отделни модели) и по-малки пулове, както и кредити за първия месец при регистрация и постоянно безплатни доставчици без лимит на токените, показани отделно, така че никога да не завишават обобщената стойност. Текущо използвани/оставащи на /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) ### 💬 Присъединете се към общността **👋 Последвайте автора — научавайте първи за нови доставчици, издания и съвети:** [![Последвайте Diego в 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)**
## 📈 Шлюзът продължава да расте

| | 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, като използвате API ключ за OmniRoute и модел 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 (компресиране с 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 е лабораторията за ИИ зад семействата модели с отворени тегла K2 и K3 — Kimi K3 предоставя контекстен прозорец от 1M токена, вградени визуални възможности и програмиране на най-високо ниво на цена, която е само малка част от тази на затворените модели, и работи веднага с Claude Code, Codex и всеки инструмент за програмиране, обслужван от OmniRoute.

Какво осигурява подкрепата на Kimi: API кредитите на Kimi захранват процеса на OmniRoute за издания, валидиран от ИИ — етапа валидиране на сливането, задвижвано от 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: Chat Completions, нативната крайна точка /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: Chat Completions, форматът за комуникация, съвместим с 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 ще изгради виртуална комбинация от свързаните ви доставчици, оценявани в реално време:

Идентификатор на модел	Какво оптимизира
`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** — незабавно, без такси (Бразилия) PIX QR код на OmniRoute

Ключ (случаен): `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 умения в Agent Card и панел в таблото с гласов чат Faro чрез push-to-talk. → [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) - **⚖️ Маршрутизиране Quota-Share** — справедливо разпределя квотата на споделен акаунт между обединени ключове, като неизползваните дялове се предоставят на останалите. → [Ръководство за устойчивост](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 инструменти, които пренебрегват променливите на средата за прокси, със сертифициращ орган за всеки 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 video, 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… и обновен **каталог с 352 доставчика**. → [Доставчици](docs/reference/PROVIDER_REFERENCE.md) - **📡 Прозрачност при маршрутизирането** — всеки отговор съдържа заглавка `X-OmniRoute-Decision`, указваща стратегията/доставчика/закъснението, чрез които е обслужен; нова комбинирана стратегия `cache-optimized` + факторът `cacheAffinity` на Auto-Combo насочват повторните заявки обратно към връзката, която съхранява кеширания префикс, а крайната точка само за четене `/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 API за Batch и Files, семантичен кеш за отговори, игровизация с класации, откриване на 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 инструмента за код + 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 доставчика на ИИ — 154 отбелязани в каталога като безплатни

> **372 регистрирани доставчика** в каноничните колекции за чат, мултимедия, търсене, локални услуги, облачни агенти и системи, включително **154 с метаданни за откриване `hasFree: true`**. Регистърът на чат модели обхваща **237 доставчика / 3 009 уникални двойки доставчик-модел / 1 443 необработени идентификатора на модели**; отделният каталог с безплатни квоти съдържа **491 реда за отделни модели**, **35 периодично възстановяващи се пула** и **54 периодично възстановяващи се/неизискващи ключ доставчика с постоянен безплатен достъп**. По замисъл тези стойности имат различни знаменатели; определенията и изчисленията с премахнато дублиране на пуловете се намират в [Справочника за доставчиците](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…

От самия редактор: отворете изгледа **Разширения**, потърсете **„OmniRoute“** и щракнете върху **Инсталиране** — работи по един и същ начин и в двата магазина. Изходният код, проблемите и ръководството за публикуване се намират в [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 list # ← изпълнява се спрямо ОТДАЛЕЧЕНИЯ сървър omniroute configure codex # ← избира отдалечен модел и записва локален профил на Codex omniroute tokens create --name ci --scope read # създава токени с по-тесен обхват за други машини omniroute contexts use default # ← превключва обратно към локалния сървър ``` Токените имат обхват `read` / `write` / `admin`; маршрутите, стартиращи процеси, остават достъпни само през loopback. _{📖 [Отдалечен режим](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**, **уеб куки** или **отдалечен 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
🔔 Уеб куки	`/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 с приоритет върху запазването без загуби + ограничено диагностично компресиране на изход от shell/patch/search/build (Responses API)
6	Headroom	Таблично уплътняване без загуби на JSON масиви (~30%) чрез вграден GCF кодек
7	Relevance	Оценяване и извличане на изречения спрямо последната потребителска заявка
8	Caveman	Компресиране на проза въз основа на правила (~65–75% за изходните данни)
9	Aggressive	Обобщаване + прогресивно остаряване на старите ходове
10	LLMLingua-2	Семантично отстраняване чрез машинно обучение с MobileBERT ONNX — безопасно за код, асинхронно
11	Ultra	Евристично отстраняване на токени с незадължително ниво, използващо малък модел (SLM)
12	OmniGlyph	Експериментално кодиране на контекста като изображение за измерения Claude Fable 5 при директна връзка с Anthropic; трансформаторите GPT 5.6 остават в режим на защитен отказ в очакване на потвърждения от доставчика. Четири профила за компресиране (агресивен по подразбиране, балансиран, безопасен за програмиране, без обработка) (най-агресивен; включва се изрично)

Кодовите блокове, URL адресите и структурираните данни **винаги се запазват** с точност до байт. **Предварително зададените конфигурации с едно щракване** комбинират механизмите:

Режим	Спестяване	Най-подходящ за
🪶 Lite	~15%	Безопасен режим по подразбиране, който е винаги включен
🪨 Стандартен (Caveman)	~30%	Ежедневно програмиране
⚡ Агресивен	~50%	Дълги сесии с интензивно използване на инструменти
🔥 Ultra	~75%	Максимално спестяване
🧰 RTK	60–90%	Изход от shell/test/build/git
🔗 Комбиниран (RTK → Caveman)	78–95%	Смесени подкани + регистрационни записи от инструменти

**Реален пример — стандартен режим:** > **Преди (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=`. Задайте автоматично задействане чрез праг за токени, включете адаптивния регулатор, фиксирайте именуван профил, задайте еднократна настройка за конкретна заявка или присвоете конвейер към комбинация за маршрутизиране — според нуждите на работното натоварване. Незадължителен офлайн **инструмент за оценяване** (`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 може да блокира скриптовете от жизнения цикъл на пакетите, освен ако не са разрешени. `postinstall` на OmniRoute (`node scripts/build/postinstall.mjs`) е необходим за подготовката на неговите нативни файлове за изпълнение. При глобално инсталиране разрешете пакетите, посочени в предупреждението на 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 binary. Вижте бележката за > [настройването на 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 heap памет, в противен случай процесът завършва с `FATAL ERROR` при около 12 GiB с два припокриващи се дълги контекста. Оразмерете контейнера над размера на heap паметта (собствените буфери са извън V8): | Натоварване | Heap (`-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 — оперативна памет за изпълнение](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`). - **Специализиран Dockerfile за Bun**: Многоетапен `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 flakes 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 mount 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 и настройка на Quadlet за Linux/systemd. **⚡ По-бързо / по-леко инсталиране (пропускане на собствената компилация)** Собственият SQLite енджин (`better-sqlite3`) е **незадължима** зависимост, така че глобалното инсталиране никога не блокира заради компилиране от изходен код: използва предварително компилиран двоичен файл, когато има съвпадащ за вашата платформа/Node, а в противен случай прозрачно преминава към енджин, реализиран изцяло на JS (`node:sqlite` при Node 22+, иначе включения `sql.js` WASM) — не са необходими инструменти за компилиране. За да пропуснете напълно собственото предварително инициализиране след инсталиране (CI, среди без графичен интерфейс или бавни машини): ```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?** Създайте [сигнал](https://github.com/diegosouzapw/OmniRoute/issues/new) или [дискусия](https://github.com/diegosouzapw/OmniRoute/discussions) с връзката — ще го представим тук.

# 📧 Общност и помощ > Всичко на едно място — следвайте поддържащия проекта, разговаряйте с общността или създайте сигнал. | Канал | Къде / как | | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- | | 💼 **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 домейн модула, 202 миграции
Памет	Пълнотекстово търсене чрез 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+ статични декларации на тестове в 5100+ проследявани тестови файла (модулни, интеграционни, 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 + 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 документирани периодично възобновявани пула / 489 каталогизирани записа за безплатни нива
Галерия с функционалности	Визуална обиколка на таблото за управление с екранни снимки
Документация на кодовата база	Преглед на кодовата база, подходящ за начинаещи

### 🤖 Протоколи и 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 се оформя от страстна общност с отворен код. Тези хора са направили изключителен принос, който пряко влияе върху качеството, стабилността и обхвата на проекта. **Благодарим ви.** ### Външни сътрудници по брой слети pull заявки

Място	Сътрудник	Слети 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

_{Данните са фиксирани към актуалния връх dafb4ae808 на release/v3.8.50, със сливания до 2026-08-24 05:26:03 UTC. Страницираното преброяване чрез GitHub GraphQL съдържа 5 911 слети PR заявки: 2 707 от собственика на хранилището, 179 от Dependabot и 3 025 външни PR заявки от 535 различни сътрудници. „Променени редове“ представлява сбора от добавянията и изтриванията в GitHub и включва генерирани файлове, lockfiles, каталози, преводи и документация; това е обемът на промените, а не авторски LOC. Равните резултати на границата са запазени.} ### Комити, приписани от 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 са потвърдени отново на 2026-08-24. Състоянието activeOnly на GitHub определя обозначенията за активност по-горе; публично обявените по-рано еднократни дарители продължават да бъдат споменавани с благодарност, а частните спонсори остават анонимни.} 💖 Станете спонсор → — всеки долар помага OmniRoute да остане безплатен и независим.

## 👥 Над 600 сътрудници

[![Сътрудници](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Проверено на 2026-08-24 при фиксирана база ac02c5b42f и повторно проверено при актуалния връх dafb4ae808 на release/v3.8.50: 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. Направете commit на промените си (`git commit -m 'feat: add amazing feature'`) 5. Изпратете клона (`git push origin feat/amazing-feature`) 6. Отворете Pull Request с **base = съответния клон `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. С това изказваме благодарността си към всички тях. 🙏 > ⭐ броят на звездите е проверен чрез REST API на GitHub на 24 август 2026 г. — подкрепете тези проекти със звезда. Посочените стойности са точна моментна снимка към тази дата и естествено ще се променят. ### 🧬 Произход и шлюз

Проект	⭐	Как вдъхнови OmniRoute
9router	26,161	Оригиналният проект, върху който е изграден този fork — разширен тук с мултимодални 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 отговори бяха съществено адаптирани в изпълнителя за Grok Web на OmniRoute.
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` послужиха като основа за транспорта на Grok Web в OmniRoute.
GrokBridge	5	Първоначалната реализация на Grok Web използва за справка неговия дизайн за HTTP/браузърен upstream; директният му HTTP път произлиза от GrokProxy, затова не се претендира за независимо пренасяне на код.
grok-web-api	14	Неговите Rust схеми за `ChatOptions` и обвивки на отговори послужиха като основа за типовете на TypeScript в OmniRoute за заявки към 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 — вдъхнови нашия изходен стил less-code: насочване към най-малката работеща промяна, което намалява _генерирания_ код (еквивалентът по оста на изхода на лаконичната проза на Caveman).
i-have-adhd	23,526	Неговият ориентиран първо към действията и съобразен с ADHD стил на отговор беше адаптиран в лаконичния изходен стил на OmniRoute за пет езика.

### 🧩 Компактни формати, изследвания на токени и инструменти, отчитащи кода

Проект	⭐	Как е вдъхновил OmniRoute
TOON	25,233	Обектна нотация, ориентирана към токени — нейният колонен модел със заглавки и редове оформи нашия етап за таблично уплътняване.
GCF – Graph Compact Format	41	Неговият компактен графов формат и дизайн с общ профил повлияха на табличното уплътняване на OmniRoute и формата на кодека Headroom.
gcf-typescript	4	TypeScript реализацията под лиценз MIT, директно включена и разширена като кодек с общ профил на 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	Модел със сесиен граф + дедупликация на редове между ходовете, който повлия на дизайна ни за дедупликация между сесии.
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 вдъхнови изгледа на каскадите в реално време в нашите Studios.
Langfuse	33,592	Неговият модел за наблюдаемост trace → span → generation оформи каскадния изглед на нашето 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)** · Създадено с ❤️ за общността на ИИ с отворен код. _{OmniRoute v3.8.52 · Node ≥22.22.2 · MIT лиценз · omniroute.online}