Как настроить Hermes Agent Desktop после установки

1. Что нужно подготовить

Сначала определите платформу. Для Windows используется пакет .appinstaller, который открывается через Windows App Installer. Для macOS используется DMG: после открытия приложения Hermes.app нужно скопировать его в Applications. Документация указывает, что macOS-пакет предназначен только для Apple Silicon; для Mac на Intel эта установка не заявлена как поддерживаемая.

Desktop-пакет уже содержит агент, Python, поддерживаемые зависимости и подготовленные интерфейсы, поэтому базовая среда не собирается при первом запуске. При этом доступ к провайдеру модели и необязательным интеграциям может потребовать сетевого подключения.

Не путайте готовый Desktop-пакет с bootstrap-установщиком Hermes-Setup: последний скачивает исходники и собирает Desktop-приложение. Для обычной установки используйте пакет своей платформы.

2. Установите Hermes Desktop

Windows

1. Скачайте установочный пакет Hermes Desktop для Windows.
2. Откройте файл .appinstaller через Windows App Installer.
3. Дождитесь установки подписанного MSIX-пакета.
4. Запустите Hermes Desktop из меню приложений.

macOS

1. Скачайте DMG-пакет.
2. Откройте образ диска.
3. Перетащите Hermes.app в Applications.
4. Запустите приложение из Applications.

Если Desktop уже установлен через командную строку и нужно запустить графическое приложение, документация предусматривает команду hermes desktop. Для полностью новой установки на Windows и macOS предпочтительнее использовать Desktop-пакет.

3. Выполните первичную настройку

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

hermes model

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

hermes setup --portal

Этот режим выполняет вход через OAuth, выбирает Nous как провайдера и включает Tool Gateway. Если вы используете другого провайдера, настройте его через hermes model и подготовьте требуемый ключ или способ входа.

Обычные настройки и секреты разделяются: секреты и токены хранятся в ~/.hermes/.env, а несекретные параметры — в ~/.hermes/config.yaml. Для изменения отдельных значений предусмотрены команды:

hermes config set <параметр> <значение>
hermes config get

Не вставляйте ключи в публичные логи, скриншоты или командные инструкции для коллег.

4. Проверьте первый запуск

После настройки запустите интерфейс:

hermes

Для нового TUI предусмотрен запуск:

hermes --tui

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

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

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

hermes --continue

Если продолжение не находит диалог, проверьте, что запущен тот же профиль и что сессия действительно была сохранена.

5. Подключайте дополнительные возможности по одной

После рабочего базового чата можно открыть настройку инструментов:

hermes tools

Для подключения мессенджеров используется интерактивная команда:

hermes gateway setup

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

Если терминал агента должен работать в изолированной среде или на удалённом сервере, в документации приведены параметры:

hermes config set terminal.backend docker
hermes config set terminal.backend ssh

Это уже изменение рабочего окружения. Перед включением подготовьте тестовую папку, ограничьте доступы и проверьте, какие операции разрешены.

6. Что делать при ошибке

Начните с диагностики:

hermes doctor

Затем используйте подходящую команду:

• API key not set — снова откройте hermes model или задайте нужный секрет через hermes config set;
• отсутствует конфигурация после обновления — выполните hermes config check, затем hermes config migrate;
• модель отвечает пусто или с ошибкой — проверьте провайдера, название модели и авторизацию через hermes model;
• custom endpoint отвечает некорректно — отдельно проверьте базовый URL, имя модели и совместимость endpoint с ожидаемым API;
• не находится старая сессия — выполните hermes sessions list и убедитесь, что выбран тот же профиль;
• gateway запустился, но сообщений нет — повторите hermes gateway setup и проверьте статус через hermes gateway status.

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

Если нужна настройка под рабочий процесс

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

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