# 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) · 🇷🇸 [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) · 🇵🇰 [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 — безкоштовний ШІ-шлюз

OmniRoute — ніколи не припиняйте програмувати. Усі інструменти ШІ → 372 провайдери, понад 150 безкоштовних — через єдину кінцеву точку. Claude Code, Codex, Cursor, Cline, Copilot і Antigravity із БЕЗКОШТОВНИМИ Claude / GPT / Gemini та автоматичним резервним перемиканням. Комбіноване стиснення RTK + Caveman заощаджує 15–95% токенів (у середньому ~89%) — забудьте про перевищення лімітів. 372 ШІ-провайдери · понад 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 Brasil](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	🏆 Що вирізняє OmniRoute
⚙️ Функції	🎯 Комбінації	🌐 Провайдери	🔌 CLI і MCP
	🗜️ Стиснення	🖥️ Де працює	🔒 Конфіденційність
👀 Перегляд	🎬 У дії	✨ Що нового	🤖 Сумісні CLI
💚 Підтримка	💚 Підтримати / Зробити пожертву	💬 Спільнота	💖 Спонсори
📦 Проєкт	🛠️ Технологічний стек	📖 Документація	👥 Учасники

🌐 67 мовами

## 🆓 Установіть, підключіть провайдера, а потім маршрутизуйте через єдину кінцеву точку

Три кроки: установіть і запустіть OmniRoute, підключіть сумісного провайдера за допомогою власного облікового запису або ключа API, а потім спрямуйте свій інструмент на localhost:20128/v1, використовуючи ключ API OmniRoute і модель auto. Маршрутизація залежить від доступних сумісних підключень і обмежень провайдера.

```bash # Після підключення провайдера скопіюйте свій ключ OmniRoute з Панелі керування → Кінцеві точки: 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 забезпечує контекстне вікно на 1 мільйон токенів, нативне бачення та кодування на передовому рівні за частку ціни закритих моделей, і працює "з коробки" з Claude Code, Codex та всіма інструментами кодування, які підтримує OmniRoute.

Що підтримує Kimi: Кредити API Kimi забезпечують конвеєр випуску OmniRoute, перевірений ШІ — етап перевірки злиття за допомогою Kimi K3, який перевіряє кожен запит на злиття перед його відправкою — а також щоденну розробку функцій. Першокласна підтримка Kimi доступна на обох шляхах: прямий Kimi API (kimi-k3) та план кодування Kimi Code (OAuth та ключ API). OmniRoute також є першим бразильським проектом з відкритим кодом у програмі підтримки Kimi. Отримайте ключ API Kimi з 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? Відкрийте issue, і ми додамо його сюди.}

## 🎯 Комбо — флагманська функція

Анімація всіх 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-key 12× / local 2×, скидається через 60s/30s/15s у режим HALF-OPEN для перевірки, відкладене відновлення; доки стан OPEN, комбінація переспрямовує запити до наступного постачальника. Рівень 2: затримка повторного підключення (один ключ/обліковий запис): базова затримка 5s OAuth / 3s API-key, експоненційне відтермінування ×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** — миттєво, без комісій (Бразилія) QR-код PIX для підтримки OmniRoute

Ключ (випадковий): `5d865059-bc44-483a-962d-43ceb80126eb` Pix copia-e-cola: ``` 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).

Примітки для розробників: Під час npm install/postinstall проєкт може створити локальний файл .env для зручності розробників. Цей файл навмисно ігнорується через .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 у режимі 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, 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` + фактор 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 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 для роботи з кодом + 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 моделей 10 тис. нейронів/день}	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 командами**, а також відкритими агентними протоколами, завдяки яким ШІ-агент може керувати ним **самостійно**. ### ⌨️ Справжній 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 насамперед без утрат і обмежене діагностичне стиснення виводу оболонки, виправлень, пошуку та збирання (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 токенів):** _"Повторний рендеринг: нове посилання кожного циклу (вбудований об’єкт створюється заново). Використати `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` або попередження про однорангові залежності? [Вони нешкідливі](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 або іншого постачальника з автентифікацією через веб-cookie?** Пакет npm містить > Playwright, але не його бінарний файл Chromium. Перегляньте примітку про > [налаштування Chromium для Playwright](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`. Для GitOps закріпіть `:X.Y.Z`. Див. [Канали випусків Docker](docs/guides/DOCKER_GUIDE.md#release-channels). В образі зафіксовано **`OMNIROUTE_MEMORY_MB=1024`**. Цього достатньо для панелі керування та нескладного чату. **Агентам для програмування** (`POST /v1/responses` від Claude Code, Codex, Grok, …) потрібна значно більша купа V8, інакше процес завершується з `FATAL ERROR` приблизно за 12 ГіБ при двох тривалих контекстах, що перекриваються. Виділяйте контейнеру більше пам’яті, ніж розмір купи (нативні буфери розташовуються поза V8): | Робоче навантаження | Купа (`-e OMNIROUTE_MEMORY_MB`) | Контейнер (`--memory`) | | ------------------------------------- | ------------------------------- | ---------------------- | | Панель керування / нескладний чат | `1024` (типове значення образу) | ≥2 ГБ | | Один агент для програмування | `8192` | ≥10 ГБ | | Два одночасні тривалі `/v1/responses` | `10240`–`12288` | ≥12–16 ГБ | ```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`**: під час роботи в Bun OmniRoute використовує вбудований драйвер Bun `bun:sqlite`, а в Node.js — `better-sqlite3` або `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+, інакше — вбудований WASM `sql.js`) — інструменти для збирання не потрібні. Щоб повністю пропустити нативну підготовку після встановлення (для 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?** Відкрийте [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](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 — імітація відбитків TLS JA3 / JA4, трирівневе проксі
Відмовостійкість	Автоматичний вимикач, експоненційна затримка повторних спроб, захист від лавиноподібних запитів, самовідновлення auto-combo
Журналювання	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 факторами, пакети режимів, самовідновлення
Посібник із проксі	Трирівнева система проксі, маркетплейс 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 розвивається завдяки натхненній спільноті відкритого коду. Ці люди зробили винятковий внесок, який безпосередньо впливає на якість, стабільність і поширення проєкту. **Дякуємо.** ### Зовнішні учасники за кількістю об’єднаних запитів на злиття

Місце	Учасник	Об’єднані 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, що включає згенеровані файли, файли блокування, каталоги, переклади та документацію; це обсяг змін, а не кількість авторських рядків коду. У разі однакових результатів на межі рейтингу враховано всіх учасників.} ### Коміти з атрибуцією 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 надійним і функціонально насиченим. Кожен pull request, кожен тестовий сценарій і кожен файл перекладу 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. Створіть форк репозиторію 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. Відкрийте запит на злиття, указавши **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-порт проєкту **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**, написаного мовою Go, — а відтоді кожна наведена нижче підсистема надихалася проєктом із відкритим кодом, який реалізував її раніше. Кожен із них сформував конкретну частину OmniRoute. Так ми висловлюємо подяку всім їм. 🙏 > ⭐ кількість зірок перевірено через REST API GitHub 24 серпня 2026 року — поставте зірку цим проєктам. Наведені значення є точним знімком станом на вказану дату й закономірно змінюватимуться. ### 🧬 Походження та шлюз

Проєкт	⭐	Як він надихнув OmniRoute
9router	26,161	Оригінальний проєкт, на основі якого створено цей форк, — тут його розширено мультимодальними API та повністю переписано на TypeScript.
CLIProxyAPI	48,497	Реалізація на Go, що надихнула на створення цього порту на JavaScript / TypeScript.
LiteLLM	57,100	Шлюз ШІ, загальнодоступний набір даних про ціни якого використовується для нашої синхронізації відстеження витрат, а модель нормалізації провайдерів вплинула на нашу маршрутизацію.
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 з автентифікацією за допомогою cookie та шаблон потокового передавання `result.response.token` вплинули на транспорт Grok Web в OmniRoute.
GrokBridge	5	Початкова реалізація Grok Web спиралася на його дизайн взаємодії з upstream через HTTP/браузер; її прямий HTTP-шлях походить від GrokProxy, тому не заявляється про незалежне перенесення коду.
grok-web-api	14	Його схеми Rust `ChatOptions` та конверта відповідей вплинули на типи запитів Grok і потокових відповідей у TypeScript в OmniRoute.

### 🗜️ Стиснення контексту й токенів — рушії

Проєкт	⭐	Як він надихнув 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	Його орієнтований на дію та зручний для людей із РДУГ стиль відповідей було адаптовано в лаконічний стиль виводу 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	Схема графа сеансу та дедуплікації рядків між обмінами, яка вплинула на архітектуру нашого `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 — надихнув нас на видалення коментарів за допомогою парсера зі збереженням рядкових, шаблонних і regex-літералів.

### 🧠 Пам’ять і RAG

Проєкт	⭐	Як він надихнув OmniRoute
Mem0	63,902	Універсальний шар пам’яті — його модель проксі як межі запису/читання сформувала нашу архітектуру пам’яті.
Letta (MemGPT)	24,382	Агенти зі збереженням стану та багаторівневою пам’яттю — надихнули нашу багаторівневу модель керування контекстом і відновлення (CCR).
WFGY	1,781	Таксономія ProblemMap із 16 повторюваних режимів відмов RAG/LLM — спільна термінологія в нашому посібнику з усунення несправностей.

### 🛰️ Перевірка трафіку, MITM і прозорий проксі

Проєкт	⭐	Як він надихнув OmniRoute
llm-interceptor	66	MITM-перехоплення й аналіз трафіку між асистентом із написання коду та LLM вплинули на початкові вимоги до інспектора трафіку. Чотири раніше похідні модулі — об’єднання SSE, нормалізація розмов, маскування секретів і санітизація заголовків — було замінено незалежними реалізаціями, створеними з нуля на основі загальнодоступних стандартів протоколів. Дві поверхні наскрізного передавання хоста (`passthrough.ts` і `_internal/bypass.cjs`) залишаються внутрішніми реалізаціями OmniRoute, класифікованими незалежно; їх не переписували в межах цієї заміни.
ProxyBridge	5,995	Прозора маршрутизація через проксі для кожного процесу — надихнула нас на стійке до збоїв завершення роботи MITM, тайм-аути бездіяльності сокетів, визначення належності процесів через `/proc` і перехоплення TPROXY.

### 📚 Дані моделей, спостережуваність та інтерфейс

Проєкт	⭐	Як він надихнув OmniRoute
models.dev	6,555	Відкрита база даних специфікацій, цін і можливостей моделей ШІ — синхронізується безпосередньо з нашим каталогом моделей.
React Flow / xyflow	38,108	Бібліотека вузлових графів, на якій працюють наші студії стиснення та комбінування/маршрутизації в реальному часі.
LangGraph	40,314	Візуалізація графа робочого процесу в реальному часі у LangGraph Studio надихнула на створення каскадного подання в реальному часі в наших студіях.
Langfuse	33,592	Її модель спостережуваності «трасування → проміжок → генерація» сформувала каскадне подання в нашій студії стиснення.
Kiali	3,631	Спостережуваність сервісної сітки Istio — надихнула на створення значків автоматичних вимикачів і візуалізації ребер із помилками в студії маршрутизації/комбінування.
lobe-icons	2,428	Логотипи брендів ШІ/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 надихнули на створення в OmniRoute автоматичного виявлення встановлених CLI-агентів.
CodexBar	20,507	Виявив інтерфейс квоти Grok Build; після цього OmniRoute незалежно перевірив і виправив актуальний формат передавання даних.

## 📄 Ліцензія Ліцензія MIT — подробиці див. у файлі [LICENSE](LICENSE). ---

**[⬆ Повернутися нагору](#-omniroute)** · Створено з ❤️ для спільноти ШІ з відкритим кодом. _{OmniRoute v3.8.52 · Node ≥22.22.2 · Ліцензія MIT · omniroute.online}