README (Русский)
🛠️ Технологический стек
Заголовок раздела «🛠️ Технологический стек»| Уровень | Технология |
|---|---|
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 journaling) + LowDB (JSON legacy) — 122 доменных модуля, 183 миграции | |
| полнотекстовый поиск 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 Keys + авторизация MCP по областям · AES-256-GCM в состоянии покоя · DOMPurify | |
| wreq-js — подмена отпечатков JA3 / JA4 TLS, 3-уровневый прокси | |
| автоматический выключатель, экспоненциальная задержка, защита от эффекта «громовой толпы», автокомбинированное самовосстановление | |
| pino — структурированные JSON-логи с контекстом запроса | |
| Node.js test runner + Vitest — 39,000+ статических объявлений тестов в более чем 5,100 отслеживаемых тестовых файлах (модульные, интеграционные, E2E, безопасность, экосистема) | |
| Десктоп (Electron) · Android (Termux) · PWA (любой браузер) | |
| GitHub Actions — автоматическая публикация npm + Docker Hub при релизе | |
| Веб-сайт · npm · Docker Hub |
📖 Документация
Заголовок раздела «📖 Документация»📘 Начало работы
Заголовок раздела «📘 Начало работы»| Документ | Описание |
|---|---|
| Провайдеры, комбинации, интеграция с CLI, развёртывание | |
| Все способы установки, конфигурации инструментов CLI, настройка протоколов, оптимизация тайм-аутов | |
| Настройка отдельных инструментов: Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot | |
| Управление удалённым OmniRoute (VPS) из CLI на ноутбуке с помощью токенов доступа с ограниченной областью действия | |
Подключение Claude Code к OmniRoute (локальному или удалённому) с помощью launch и отдельных профилей для моделей | |
| 3 шага: установка → подключение → настройка |
🔧 Эксплуатация и развёртывание
Заголовок раздела «🔧 Эксплуатация и развёртывание»| Документ | Описание |
|---|---|
| Docker run, профили Compose, Caddy HTTPS, туннели, теги образов | |
| Интеграция Quadlet с systemd, podman-compose, SELinux | |
| Полное руководство: настройка виртуальной машины, nginx и Cloudflare | |
| Развёртывание на Fly.io с постоянным хранилищем | |
| Запуск OmniRoute на Android через Termux | |
| Установка прогрессивного веб-приложения, кэширование, архитектура | |
| Полное удаление для всех способов установки | |
Полный список переменных .env и справочные сведения |
🧠 Возможности и архитектура
Заголовок раздела «🧠 Возможности и архитектура»| Документ | Описание |
|---|---|
| Архитектура системы, поток данных и внутреннее устройство | |
| Конвейер с 7 вариантами: выключено / облегчённое / стандартное / агрессивное / ультра / RTK / составное | |
| Сжатие вывода команд, фильтры, доверие, проверка, восстановление необработанного вывода | |
| Caveman, RTK, составные конвейеры, интерфейсы панели управления/API/MCP | |
| Схемы пакетов правил JSON для фильтров Caveman и RTK | |
| Определение языка и создание пакетов правил Caveman | |
| Автоматические выключатели, периоды ожидания, очередь, защита от лавинообразной нагрузки, подмена TLS | |
| Оценка по 16 факторам, пакеты режимов, самовосстановление | |
| Трёхуровневая система прокси, торговая площадка 1proxy, CRUD-операции с реестром | |
| Сводный каталог: 35 документированных возобновляемых пулов / 489 каталогизированных предложений бесплатного уровня | |
| Визуальный обзор панели управления со снимками экрана | |
| Понятный для начинающих обзор кодовой базы |
🤖 Протоколы и API
Заголовок раздела «🤖 Протоколы и API»| Документ | Описание |
|---|---|
| Все конечные точки с примерами | |
| Спецификация OpenAPI 3.0 | |
| 110 инструментов MCP, конфигурации IDE, клиенты Python/TS/Go | |
| Установка MCP, транспорты и справочник инструментов | |
| Протокол JSON-RPC 2.0, навыки, потоковая передача, управление задачами | |
| Карточка агента A2A, задачи, навыки и потоковая передача |
📋 Проект и качество
Заголовок раздела «📋 Проект и качество»| Документ | Описание |
|---|---|
| Настройка среды разработки и рекомендации | |
На какие ветки нацелены PR (release/*) и что означают main и теги | |
| Полная история выпусков по версиям | |
| Сообщение об уязвимостях и методы обеспечения безопасности | |
| Поддержка 42 языков, процесс перевода, RTL | |
| Этапы проверки перед выпуском | |
| Стратегия тестового покрытия для более чем 39 000 статических объявлений тестов в более чем 5 100 отслеживаемых файлах тестов |
⭐ Ведущие участники
Заголовок раздела «⭐ Ведущие участники»OmniRoute развивается благодаря увлечённому сообществу открытого исходного кода. Эти люди внесли выдающийся вклад, непосредственно повлиявший на качество, стабильность и охват проекта. Спасибо.
Внешние участники по количеству объединённых pull request
Заголовок раздела «Внешние участники по количеству объединённых pull request»| Место | Участник | Объединённые 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
Заголовок раздела «Коммиты, атрибутированные 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. Статус GitHub activeOnly определяет указанные выше активные категории; мы по-прежнему благодарим ранее объявленных публичных разовых спонсоров, а частные спонсоры остаются анонимными.
💖 Стать спонсором → — каждый доллар помогает OmniRoute оставаться бесплатным и независимым.
👥 Более 600 участников
Заголовок раздела «👥 Более 600 участников»Аудит проведён 2026-08-24 на зафиксированной базе ac02c5b42f, а повторная проверка — на актуальной вершине release/v3.8.50 dafb4ae808: 639 нормализованных Git-идентификаторов людей — 407 указаны как авторы коммитов (включая сопровождающего проекта), а 232 встречаются только в явных трейлерах Co-authored-by. При подсчёте нормализуются идентификаторы GitHub noreply, исключаются 26 идентификаторов ботов, агентов, сервисов и заполнителей, а обычные адреса электронной почты не объединяются только на основании совпадения отображаемых имён.
Как внести вклад
Заголовок раздела «Как внести вклад»- Создайте форк репозитория
- Создайте ветку от вершины активной ветки
release/vX.Y.Z(не отmain) — см. Модель ветвления и выпуска - Создайте ветку для своей функциональности (
git checkout -b feat/amazing-feature) - Зафиксируйте изменения (
git commit -m 'feat: add amazing feature') - Отправьте изменения в ветку (
git push origin feat/amazing-feature) - Откройте Pull Request, указав base = эта ветка
release/vX.Y.Z
Подробные рекомендации см. в CONTRIBUTING.md.
Выпуск новой версии
Заголовок раздела «Выпуск новой версии»# Создайте релиз — публикация в npm произойдёт автоматическиVERSION=x.y.zgh release create "v${VERSION}" --title "v${VERSION}" --generate-notes📊 Звёзды
Заголовок раздела «📊 Звёзды»🌍 StarMapper
Заголовок раздела «🌍 StarMapper»🙏 Благодарности
Заголовок раздела «🙏 Благодарности»OmniRoute стоит на плечах гигантов. Он начинался как форк 9router и порт проекта CLIProxyAPI с Go на TypeScript, а затем каждая из перечисленных ниже подсистем создавалась под влиянием проекта с открытым исходным кодом, который уже реализовал подобную идею. Каждый из них сформировал определённую часть OmniRoute. Так мы выражаем им всем свою благодарность. 🙏
⭐ количество звёзд проверено через REST API GitHub 24 августа 2026 года — поставьте звезду этим проектам. Указанные значения являются точным снимком на эту дату и со временем, естественно, изменятся.
🧬 Происхождение и шлюз
Заголовок раздела «🧬 Происхождение и шлюз»| Проект | ⭐ | Как он повлиял на OmniRoute |
|---|---|---|
| 26,161 | Исходный проект, на основе которого создан этот форк, — здесь он расширен мультимодальными API и полностью переписан на TypeScript. | |
| 48,497 | Реализация на Go, вдохновившая на создание этого порта на JavaScript / TypeScript. | |
| 57,100 | Шлюз ИИ, чей общедоступный набор данных о ценах используется для синхронизации отслеживания наших затрат, а модель нормализации провайдеров легла в основу нашей маршрутизации. | |
| 1,410 | Исходный код под лицензией MIT, адаптированный во встроенный мост ChatGPT Web → Codex Responses, включая адаптеры браузерных сеансов, фрейминга ответов, учёта использования и веб-поиска. | |
| 48,112 | Шаблоны, перенесённые в восстановление потоков, псевдонимы без рассуждений, резервный веб-поиск, ограничения скользящего окна, редактирование журналов и усиленные процессы запуска. | |
| 322 | Шаблоны Cursor Composer для выбора инструментов, ограничений вывода и фиксации инструментов, адаптированные для нативного исполнителя Cursor. | |
| 457 | Шаблоны нового входа и ротации токенов обновления, перенесённые в повторную аутентификацию Codex OAuth. | |
| 510 | Совместимые с Claude Code стандартные преобразования и поведение заголовков биллинга, обобщённые в управляемом конфигурацией мосте OmniRoute. | |
| 2 | Его сопоставления моделей Grok, генератор Statsig с имитацией TypeError, стандартные параметры запросов и устройств, а также обработчик ответов NDJSON были существенно адаптированы для исполнителя Grok Web в OmniRoute. | |
| 705 | Основной транзитивный источник кода для grok2api-merged; его реализации моделей, заголовков, полезных нагрузок, Statsig и обработчиков сохранены в цепочке происхождения Grok Web. | |
| 7,520 | Базовый исходный код под лицензией MIT для полезной нагрузки Grok и стандартных параметров устройств, генератора Statsig и обработчика result.response, унаследованных через TQZHR и grok2api-merged. | |
| 27 | Транзитивный источник, указанный grok2api-merged для слоя пула прокси; OmniRoute сохраняет упоминание об этом происхождении, но не заявляет о переносе пула прокси в свой ограниченный исполнитель Grok Web. | |
| 50 | Его прокси Grok с аутентификацией по cookie и шаблон потоковой передачи result.response.token повлияли на транспорт Grok Web в OmniRoute. | |
| 5 | При создании исходной реализации Grok Web учитывалась его архитектура вышестоящего HTTP/браузерного взаимодействия; прямой HTTP-путь основан на GrokProxy, поэтому о независимом переносе кода не заявляется. | |
| 14 | Его схемы Rust ChatOptions и конвертов ответов легли в основу типов запросов Grok и потоковых ответов на TypeScript в OmniRoute. |
🗜️ Сжатие контекста и токенов — движки
Заголовок раздела «🗜️ Сжатие контекста и токенов — движки»| Проект | ⭐ | Как он вдохновил OmniRoute |
|---|---|---|
| 100,538 | Вирусный проект «зачем много токен, если мало токен делать дело» — его философия пещерной речи лежит в основе нашего стандартного режима сжатия и более 30 правил удаления слов-паразитов и уплотнения текста. | |
| 77,185 | Высокопроизводительное сжатие вывода команд — вдохновило нас на создание движка RTK, DSL для фильтрации JSON, восстановление необработанного вывода и составной конвейер RTK → Caveman. | |
| 67,310 | Обратимое сжатие контекста (SmartCrusher) — вдохновило нас на создание движка headroom и шаблона маркера извлечения ccr. | |
| 6,598 | Исследования по сжатию промптов (LLMLingua / LLMLingua-2) — вдохновили нас на создание асинхронного, безопасного для кода и отказоустойчивого движка llmlingua. | |
| 31 | Порт на JS/ONNX (MobileBERT / XLM-RoBERTa), используемый как бэкенд на основе рабочего потока для нашего движка LLMLingua. | |
| 40 | Сжатие токенов для PT-BR — лежит в основе нашего языкового пакета pt-BR: сокращение плеоназмов и удаление слов-паразитов с учётом грамматики бразильского варианта португальского языка. | |
| 108,957 | Вирусный навык YAGNI-программиста в стиле «ленивого сеньора» — вдохновил нас на создание стиля вывода less-code: ориентации на минимальные работающие изменения, которая сокращает _генерируемый_ код (аналог лаконичной прозы Caveman для оси вывода). | |
| 23,526 | Его ориентированный на действия и удобный для людей с СДВГ стиль ответов был адаптирован в лаконичный стиль вывода OmniRoute на пяти языках. |
🧩 Компактные форматы, исследования токенов и инструменты с учётом кода
Заголовок раздела «🧩 Компактные форматы, исследования токенов и инструменты с учётом кода»| Проект | ⭐ | Как он вдохновил OmniRoute |
|---|---|---|
| 25,233 | Токен-ориентированная объектная нотация — её колоночная модель с заголовком и строками определила структуру нашего этапа табличного уплотнения. | |
| 41 | Его компактный формат графов и универсальная архитектура профилей повлияли на табличное уплотнение OmniRoute и формат кодека Headroom. | |
| 4 | Реализация на TypeScript под лицензией MIT, непосредственно встроенная и расширенная в качестве кодека универсального профиля Headroom. | |
| 494 | Кэш Brotli/SQLite и дельта контекста для каждого сеанса — вдохновили нас на создание движка session-dedup. | |
| 1,122 | Уплотнение вывода Bash и профили MCP — вдохновили наш принцип отказа от неэффективного сжатия и сокращение манифестов инструментов MCP. | |
| 138 | Учитывающее содержимое сжатие вывода для каждого типа файлов с отказом при неудаче — подтвердило правильность нашей маршрутизации по типам и пропуска при недостаточном выигрыше. | |
| 1,951 | «Найдите токены-призраки» — его схема выгрузки с восстанавливаемыми дескрипторами повлияла на наш подход к выгрузке CCR. | |
| 28 | Архитектура графа сеанса и межрепликовой дедупликации строк, повлиявшая на структуру нашего механизма session-dedup. | |
| 3 | Колоночный JSON на Rust, адресуемое по содержимому извлечение и межсообщенческая дедупликация — подтвердили правильность архитектуры наших движков headroom/ccr/session-dedup и стабильного для кэша инварианта «сжатая форма не зависит от позиции». | |
| 113 | Сжатие схем и описаний инструментов MCP — повлияло на наш подход к сокращению количества элементов в манифестах инструментов MCP. | |
| 197 | Ранжирование карт репозитория в стиле Aider — повлияло на наши исследования карт репозиториев и ранжирования результатов извлечения. | |
| 4 | Декларативное сокращение вывода командной оболочки через MCP — подтвердило правильность нашего декларативного уплотнения вывода Bash. | |
| 6,162 | Инструментарий TypeScript Compiler API — вдохновил нас на удаление комментариев на основе парсера с сохранением строковых, шаблонных и литералов регулярных выражений. |
🧠 Память и RAG
Заголовок раздела «🧠 Память и RAG»| Проект | ⭐ | Как он вдохновил OmniRoute |
|---|---|---|
| 63,902 | Универсальный слой памяти — его модель прокси как границы записи и чтения сформировала нашу архитектуру памяти. | |
| 24,382 | Агенты с сохранением состояния и многоуровневой памятью — они вдохновили нашу многоуровневую модель управления контекстом и восстановления (CCR). | |
| 1,781 | Таксономия ProblemMap, включающая 16 повторяющихся режимов отказа RAG/LLM, — общий словарь терминов в нашем руководстве по устранению неполадок. |
🛰️ Анализ трафика, MITM и прозрачный прокси
Заголовок раздела «🛰️ Анализ трафика, MITM и прозрачный прокси»| Проект | ⭐ | Как он вдохновил OmniRoute |
|---|---|---|
| 66 | MITM-перехват и анализ трафика между ассистентом для программирования и LLM повлияли на ранние требования к Traffic Inspector. Четыре ранее заимствованных модуля — объединение SSE, нормализация диалогов, маскирование секретов и очистка заголовков — были заменены независимыми реализациями, созданными с нуля на основе общедоступных стандартов протоколов. Два компонента сквозной передачи на уровне хоста (passthrough.ts и _internal/bypass.cjs) остаются внутренними реализациями OmniRoute, классифицированными независимо; они не переписывались в рамках этой замены. | |
| 5,995 | Прозрачная маршрутизация через прокси для отдельных процессов — она вдохновила нашу отказоустойчивую деинициализацию MITM, тайм-ауты бездействия сокетов, атрибуцию процессов через /proc и перехват TPROXY. |
📚 Данные о моделях, наблюдаемость и пользовательский интерфейс
Заголовок раздела «📚 Данные о моделях, наблюдаемость и пользовательский интерфейс»| Проект | ⭐ | Как он вдохновил OmniRoute |
|---|---|---|
| 6,555 | Открытая база данных со спецификациями, ценами и возможностями моделей ИИ — она напрямую синхронизируется с нашим каталогом моделей. | |
| 38,108 | Библиотека узловых графов, на которой работают наши Compression Studio и Combo/Routing Studio в реальном времени. | |
| 40,314 | Визуализация графа рабочих процессов в реальном времени из LangGraph Studio вдохновила аналогичное каскадное представление в наших студиях. | |
| 33,592 | Его модель наблюдаемости «трассировка → интервал → генерация» сформировала каскадное представление в нашем Compression Studio. | |
| 3,631 | Наблюдаемость сервисной сетки Istio — она вдохновила значки автоматического выключателя и визуализацию рёбер с ошибками в Routing/Combo Studio. | |
| 2,428 | Логотипы брендов ИИ/LLM, используемые для отображения значков поставщиков на нашей панели управления. | |
| 12,354 | Предоставляет SVG-флаги по лицензии MIT, используемые в селекторе языка README. |
🛡️ Безопасность
Заголовок раздела «🛡️ Безопасность»| Проект | ⭐ | Как он вдохновил OmniRoute |
|---|---|---|
| 721 | Тщательно подобранный список библиотек с безопасными настройками по умолчанию, которым мы руководствуемся при выборе средств безопасности (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink). |
🧭 Дополняющие инструменты
Заголовок раздела «🧭 Дополняющие инструменты»| Проект | ⭐ | Как он вдохновил OmniRoute |
|---|---|---|
| 6,564 | Вдохновил дедупликацию запросов, аварийный бесплатный резервный вариант, подключаемые стратегии Auto-Combo и многоязычную классификацию намерений. | |
| 30,652 | Его переназначение моделей с учётом учётных записей, проверка путей к исполняемым файлам и логика меток тарифных планов повлияли на среду выполнения Antigravity в OmniRoute. | |
| 4,817 | Его компактный формат обратного отсчёта до сброса квоты вдохновил соответствующее отображение лимитов поставщиков в OmniRoute. | |
| 32,230 | Его интеграции ACP вдохновили автоматическое обнаружение установленных CLI-агентов в OmniRoute. | |
| 20,507 | Выявил интерфейс квот Grok Build; затем OmniRoute независимо проверил и исправил фактический формат передаваемых данных. |
📄 Лицензия
Заголовок раздела «📄 Лицензия»Лицензия MIT — подробности см. в файле LICENSE.
⬆ Вернуться наверх · Создано с ❤️ для сообщества разработчиков ИИ с открытым исходным кодом.
OmniRoute v3.8.51 · Node ≥22.22.2 · Лицензия MIT · omniroute.online
HagiCode
HagiCode — агентная среда разработки со структурированными процессами, параллельным выполнением несколькими агентами и интерфейсами Hero Dungeon.
Превращайте идеи в полезное ПО с более умным, быстрым и увлекательным агентным рабочим процессом.

- SmartСтруктурированные процессы превращают намерение в исполнимый путь от идеи до готового изменения.
- EfficientМультиагентные процессы параллельно продвигают исследование, реализацию и проверку.
- FunHero Dungeon делает длительную совместную разработку наглядной и увлекательной.




