imkofty/Hermuse

Что это?

Ключевые возможности

• 01Устанавливает Hermes Agent, 9Router и Node.js на Ubuntu одним скриптом.
• 02Подключает Telegram-бота к шлюзу Hermes, используя allowlist числовых ID пользователей.
• 03Открывает публичный доступ к локальной панели управления 9Router через туннель с опросом Cloudflare Pages и D1.
• 04Автоматически перезапускает 9Router, клиент туннеля и шлюз с помощью скриптов-супервизоров и watchdog-процессов в cron.
• 05Обнаруживает зависание опроса Telegram по сигналу активности event loop и активности адаптера.
• 06Предоставляет диагностический скрипт и проверку миграций базы данных туннеля.

Сценарии использования

• Запуск приватного AI-ассистента в Telegram на небольшом Linux VPS.
• Размещение собственной панели управления моделями, доступной из браузера без открытия входящих портов.
• Эксплуатация постоянно работающего бота с автоматическим восстановлением после сбоев или перезагрузок.

Быстрый старт

1. 1

   Установить всё (зависимости, Hermes, 9Router)

   bash scripts/install.sh
2. 2

   Войти в аккаунт провайдера модели через OAuth

   hermes setup --portal
3. 3

   Подключить бота Telegram и настроить список разрешённых числовых ID

   hermes gateway setup
4. 4

   Установить туннель Cloudflare (заменить заполнители на названия проекта и D1)

   bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>

Что важно знать

• !Предназначено для Linux-сервера или виртуальной машины; в README нет инструкций по настройке для macOS и Windows.
• !Для запуска скрипта установки нужны sudo без пароля или права root.
• !Для использования всего стека необходимы аккаунт Cloudflare и токен бота Telegram.

В подборках

Темы

Частые вопросы

Что такое Hermuse?

Скрипты и руководства для запуска Hermes Agent, прокси моделей 9Router и шлюза Telegram-бота на собственном Linux-сервере или виртуальной машине. Hermuse — набор shell-скриптов и документации для запуска личного стека AI-агента на собственном компьютере или VPS. Он объединяет CLI Hermes Agent, совместимый с OpenAI прокси моделей 9Router и шлюз Telegram, чтобы вы могли круглосуточно общаться со своим AI-ботом и открывать панель управления моделями в браузере.

Hermuse можно использовать бесплатно? Какая у него лицензия?

Hermuse распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

Hermuse всё ещё поддерживается?

Активно поддерживается. Последний коммит в Hermuse — 23 окт. 2026 г..

Для чего можно использовать Hermuse?

Запуск приватного AI-ассистента в Telegram на небольшом Linux VPS. Размещение собственной панели управления моделями, доступной из браузера без открытия входящих портов. Эксплуатация постоянно работающего бота с автоматическим восстановлением после сбоев или перезагрузок.

Как установить Hermuse?

Установить всё (зависимости, Hermes, 9Router): bash scripts/install.sh Войти в аккаунт провайдера модели через OAuth: hermes setup --portal Подключить бота Telegram и настроить список разрешённых числовых ID: hermes gateway setup Установить туннель Cloudflare (заменить заполнители на названия проекта и D1): bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>

Где скачать Hermuse?

Исходный код и инструкции по установке — на GitHub: https://github.com/imkofty/Hermuse