2026: установка Hermes Agent —
macOS / Linux и Telegram Gateway 7×24

Если в 2026 вы смотрите на open-source Hermes Agent от Nous Research, упираетесь обычно не в промпт, а в цепочку скрипт установки, зависимости Python/Node, ключ LLM API, Telegram-бот и сервис Gateway. Этот материал для разработчиков и небольших команд, которым нужно на macOS, Linux или WSL2 довести Hermes от «запускается в терминале» до «Telegram доступен с телефона, хост онлайн 7×24»: сначала шесть типичных заблуждений, затем таблица окружения и матрица хостов, далее воспроизводимые команды curl | bash, hermes doctor, hermes setup и Telegram Gateway (минимум восемь шагов). Архитектура памяти и TCO покупка/аренда — в статье о трёхуровневой памяти и анализе TCO за 24 месяца. Тарифы на странице цен NOVAKVM, заказ через оформить аренду. Команды и версии — по официальной документации; после каждого релиза перепроверяйте ссылки.

[ SECTION_01 ] // PAIN_MAP Шесть частых заблуждений при установке Hermes Agent (2026)

  • «Сначала вручную ставить Python 3.11 и Node 22»: официальный скрипт подтягивает рантаймы через uv; нужен только рабочий Git. Смешение с системным Python часто даёт ModuleNotFoundError.
  • «После установки бот сразу отвечает в Telegram»: CLI-чат и Gateway — разные пути; каналы требуют hermes gateway setup и запущенный daemon.
  • «hermes: command not found — установка сломана»: чаще всего PATH не обновлён — новый терминал или source ~/.zshrc, без полной переустановки.
  • «Любой Linux VPS эквивалентен Mac»: документация полнее на macOS; браузерная автоматизация и macOS-специфичные Skills на чистом Linux ведут себя иначе — перед продом читайте заметки по платформе.
  • «Бот не отвечает в группе при @mention»: в режиме конфиденциальности Telegram группы часто видят только команды /; отключите Group Privacy в BotFather и удалите бота из группы, затем добавьте снова.
  • «Закрытый MacBook годится как production Gateway»: сон приостанавливает процессы; компounding Skills и callbacks каналов требуют постоянно включённого контролируемого хоста — это больше, чем «установка прошла успешно».

Официальные точки входа Hermes — URL установщика и параметры после каждого релиза:

Официальная документация по установке Hermes Agent (Nous Research)

NousResearch/hermes-agent (репозиторий GitHub)

[ SECTION_02 ] // ENV_MATRIX Требования Hermes Agent: минимум и выбор носителя развёртывания

Таблица — прагматичный минимум для локальной установки; Gateway только на облачных API потребляет меньше RAM, чем сценарий с локальным Ollama. Цены и наличие — на странице тарифов.

Требования к окружению Hermes Agent (планировочная таблица, не официальный SLA)
Параметр Минимум Рекомендуется (production Gateway)
ОС macOS 12+, Ubuntu 20.04+, WSL2 macOS 14+ (Apple Silicon) или Ubuntu 24.04 LTS
Память 4 ГБ (только API + Gateway) 16 ГБ; локальный Ollama или большое дерево Skills 24–32 ГБ
Диск около 1,5 ГБ (с кэшем Skills) 20 ГБ+ SSD, запас под рост ~/.hermes/
Сеть Доступ к GitHub raw и LLM API Стабильный низколатентный выход для callbacks Telegram
Зависимости Git 2.30+ Скрипт ставит Python 3.11, Node 22, ripgrep, ffmpeg
После установки: ноутбук / VPS / арендованный Mac Mini M4
Носитель Сложность установки Gateway 7×24 Типичные проблемы
Личный MacBook Низкая (достаточно curl) Сон обрывает — подходит для POC Личные данные и память агента на одном диске
Общий Linux VPS Средняя (опция --skip-browser) Высокая доступность, RTT замедляет циклы инструментов Нет нативного пути браузерной автоматизации macOS
Mac Mini M4 NOVAKVM Низкая (основной путь документации) Выделенный bare metal, daemon launchd Планировать SSH и бэкап ~/.hermes/

Только проверить установку? Ноутбука хватит. Чтобы Telegram и compounding Skills работали неделями, размещайте Gateway на production Mac без сна.

[ SECTION_03 ] // INSTALL One-liner установки Hermes Agent: curl, PATH и hermes doctor

На macOS, Linux, WSL2 или Termux Nous Research рекомендует одну строку (клон репозитория в ~/.hermes/hermes-agent/, глобальная команда hermes):

install.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version

На headless-сервере без браузерной автоматизации можно пропустить browser-зависимости (параметры — в официальной доке):

install-headless.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

hermes doctor проверяет Python, Node, ripgrep, ffmpeg, PATH и API-ключи; при ❌ следуйте подсказкам, не пропускайте. Нативный установщик PowerShell для Windows — ранняя beta; для production надёжнее WSL2 плюс Linux-команды выше (см. раздел Installation).

[ SECTION_04 ] // RUNBOOK Восемь шагов: модель, smoke-тест CLI, Telegram и постоянный Gateway

  1. Завершить установку и загрузить PATH: каталог ~/.hermes на месте, затем hermes doctor без блокеров.
  2. Настроить LLM: новичкам hermes setup; с готовым ключом — hermes model или записи в ~/.hermes/.env (OpenRouter, Anthropic, OpenAI, base URL Ollama).
  3. Smoke-тест CLI: запустить hermes, реальная задача (например распределение типов файлов в текущем каталоге), проверить toolchain и биллинг API.
  4. Создать Telegram-бота: @BotFather, /newbot, сохранить token; числовой ID через @userinfobot.
  5. Конфигурация Gateway: hermes gateway setup с Telegram; или переменные TELEGRAM_BOT_TOKEN и TELEGRAM_ALLOWED_USERS.
  6. Проверка Gateway на переднем плане: hermes gateway, сообщение боту в личке, подтвердить ответ перед фоновым режимом.
  7. Установить daemon: macOS — hermes gateway install + hermes gateway start (launchd); Linux — опционально sudo hermes gateway install --system, логи через journalctl -u hermes-gateway -f.
  8. Дисциплина бэкапов: регулярно архивировать ~/.hermes/; при смене хоста или окончании аренды восстанавливать дерево каталогов — переустановка только бинарников даёт «амнезию».
gateway.env 
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Для групповых чатов Telegram читайте документацию Messaging про режим конфиденциальности; после отключения Group Privacy удалите бота из группы и пригласите снова.

Документация Telegram Hermes Agent (GitHub)

[ SECTION_05 ] // TROUBLESHOOT Ошибки установки и Gateway: матрица симптомов

Ошибки установки и Gateway (частота в сообществе, не официальный SLA)
Симптом Частая причина Действие
hermes: command not found PATH не загружен source ~/.zshrc или новый терминал
API key not set Провайдер не настроен hermes model или правка ~/.hermes/.env
Missing config after update Сдвиг схемы после апгрейда hermes config check и hermes config migrate
ModuleNotFoundError: dotenv Неверный системный Python Бинарник из ~/.hermes/hermes-agent/venv
Группа Telegram молчит Privacy mode / бот не перевыставлен Отключить Group Privacy в BotFather, удалить и добавить бота

Если шаги выполняются на удалённом Mac, baseline подключения и сессий — в центре помощи. Для выделенного Apple Silicon и предсказуемого wipe при checkout оцените помесячную аренду bare metal вместо постоянной работы личного ноутбука.

[ SECTION_06 ] // HARD_FACTS Проверяемые факты и заключение NOVAKVM

  • Поведение установщика: официальный скрипт через uv ставит Python 3.11, Node 22, ripgrep, ffmpeg и размещает репозиторий в ~/.hermes/hermes-agent/. (Источник: документация Installation — перепроверять после релиза.)
  • Корень конфигурации: переменные окружения и токены Gateway по умолчанию в ~/.hermes/.env; межсессионная память и Skills персистятся в том же дереве. (Источник: документация Memory / Setup.)
  • Независимость от модели: Hermes поддерживает Anthropic, OpenAI, OpenRouter, GitHub Copilot, Ollama и др.; ID моделей и тарифы — у провайдера.
  • Расширение MCP: объявить mcp_servers в ~/.hermes/config.yaml, OAuth через hermes mcp login (headless часто с SSH-туннелем).
  • Контроль версий: ориентир — hermes --version и GitHub Releases; не копируйте star-count или рейтинги производительности без источника.

«Установлено» — только старт: личный ноутбук подходит для weekend POC, но сон, обновления ОС и смешение личных данных рвут Gateway и compounding Skills. Чистый Linux VPS держит API-маршрут, но теряет на браузерной автоматизации и macOS toolchain. Если Hermes в CLI оказался долгосрочно полезен, прагматичный production-путь — сначала помесячный выделенный Mac Mini M4, 2–4 недели логов Gateway, затем решение о покупке железа.

На странице тарифов NOVAKVM выберите класс по параллелизму и диску; provision через оформить заказ, затем восемь шагов этой статьи для установки и постоянного Telegram. Для production Hermes с нативным macOS install path, launchd Gateway 7×24 и предсказуемым wipe при окончании аренды аренда bare metal Mac Mini M4 NOVAKVM обычно дешевле по стоимости решения, чем держать основной ноутбук включённым круглосуточно.