Hermes Agent: что это и как начать работу

Что такое Hermes Agent

Hermes Agent — open-source ИИ-агент от Nous Research. В официальных материалах он представлен как инструмент для работы через терминал и подключённые каналы сообщений. Репозиторий также описывает навыки, планировщик задач, шлюз сообщений, работу с инструментами и запуск в разных терминальных окружениях.

Важно различать подтверждённые возможности продукта и предполагаемый сценарий внедрения. Документация подтверждает интерфейсы и команды Hermes Agent, но сама по себе не означает готовую интеграцию с вашей CRM, 1С, почтой или внутренними регламентами.

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

Для Linux, macOS и WSL2 официальная инструкция предлагает запустить:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Для Windows используется PowerShell-команда:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Есть и desktop-пакеты для macOS и Windows. В документации отдельно указано, что macOS-пакет рассчитан на Apple Silicon. Для Android предусмотрен отдельный путь через Termux на устройствах aarch64; desktop/server-скрипт для этого сценария использовать не следует.

После установки в POSIX-окружении перезапустите shell и запустите Hermes:

source ~/.bashrc   # или source ~/.zshrc
hermes

Если команда не найдена, сначала проверьте PATH и перезапустите shell. Для диагностики установленного окружения предусмотрена команда hermes doctor.

Настройка модели и провайдера

После установки выберите провайдера командой:

hermes model

В Quickstart перечислены Nous Portal, OpenAI Codex, Anthropic, OpenRouter, AWS Bedrock, Google AI Studio, локальные и совместимые с OpenAI endpoints, а также другие варианты. Набор действий зависит от провайдера: где-то нужен API-ключ, где-то авторизация через OAuth или адрес собственного endpoint.

Для быстрого режима с Nous Portal документация указывает команду:

hermes setup --portal

Для отдельных значений можно использовать hermes config set, а проверить конфигурацию — hermes config get или hermes config check. Секреты и обычные настройки Hermes хранит раздельно. Не передавайте ключи в общий чат и не добавляйте их в репозиторий.

Отдельное ограничение из Quickstart: выбранная модель должна иметь контекст не менее 64 000 токенов. Для локальной модели проверьте этот параметр в её собственном запуске и конфигурации.

Первый чат и проверка результата

После выбора модели запустите обычный CLI или TUI:

hermes
# либо
hermes --tui

Для первой проверки задайте короткий запрос с легко проверяемым результатом, например попросите перечислить файлы тестового каталога или сделать краткое резюме небольшого репозитория. Успешный запуск означает, что:

1. интерфейс показывает выбранного провайдера и модель;
2. Hermes отвечает без ошибки авторизации;
3. при необходимости инструмент возвращает результат;
4. второй ход диалога продолжает ту же беседу.

Затем проверьте восстановление сессии:

hermes --continue
# или
hermes -c

Если последняя сессия не находится, проверьте, что используется тот же профиль, и посмотрите список сессий командой hermes sessions list. Не переходите к шлюзу, cron или MCP, пока обычный чат не работает стабильно.

Что подключать после базовой проверки

Для бота или постоянно работающего сценария Quickstart предлагает сначала добиться рабочего CLI, а затем выполнить:

hermes gateway setup

Документация перечисляет подключение Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant и Microsoft Teams. Доступные каналы, права и настройки нужно проверять для конкретной платформы.

Инструменты можно настраивать через:

hermes tools

Для расширения контекста предусмотрены навыки и MCP-серверы. Для редакторской интеграции ACP используется:

hermes acp

Это подтверждённые точки настройки продукта. Сам бизнес-сценарий — например, разбор заявок, подготовка черновиков или сводка данных — нужно описать отдельно: указать источник, ожидаемый результат, разрешённые действия и момент передачи человеку.

Ограничения и безопасная проверка

Hermes Agent может работать с инструментами, файлами, терминалом и внешними каналами, поэтому доступы следует выдавать по принципу минимально необходимого. Для теста подготовьте отдельный каталог или профиль и не начинайте с операций, изменяющих рабочие данные.

Рекомендуем проверить:

• что ключи провайдера не попали в логи, промпты или репозиторий;
• какие инструменты включены командой hermes tools;
• куда направляются сообщения шлюза;
• что произойдёт при недоступном провайдере или неверном токене;
• какие действия должны требовать подтверждения человека;
• что резервная копия подготовлена до изменений в рабочей конфигурации.

Для изоляции терминала Quickstart описывает Docker и SSH-бэкенды через настройки terminal.backend. Конкретный режим следует сначала проверить на тестовом окружении: изоляция не отменяет необходимость контролировать разрешения, сетевые доступы и данные, которые получает модель.

Если что-то не работает

Используйте последовательность диагностики:

hermes doctor
hermes model
hermes setup
hermes sessions list
hermes --continue
hermes gateway status

Если Hermes запускается, но отвечает некорректно, сначала перепроверьте провайдера, модель и авторизацию. Для собственного endpoint отдельно проверьте базовый URL, имя модели и совместимость интерфейса. Если шлюз запустился, но сообщения не приходят, проверьте токен, список разрешённых пользователей и настройки платформы.

После исправления повторите минимальный тест: один обычный запрос, второй ход диалога и продолжение сессии. Только затем возвращайте дополнительные инструменты или подключайте рабочие данные.