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

Desktop-пакет через App Installer

Для графического запуска используйте Windows-пакет Hermes Desktop: откройте файл .appinstaller через Windows App Installer. Документация описывает установку подписанного MSIX-пакета и сохранение источника обновлений. Готовый пакет содержит агент, Python, поддерживаемые зависимости и предварительно собранные интерфейсы, поэтому базовая среда не собирается при первом запуске заново. Доступ к сети всё ещё может понадобиться провайдеру модели и отдельным интеграциям.

Нативная установка через PowerShell

Если графическое приложение не требуется, откройте PowerShell и выполните:

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

Для исходной Windows-установки документация указывает каталог файлов агента %LOCALAPPDATA%\hermes\hermes-agent\, каталог запуска %LOCALAPPDATA%\hermes\bin\ и каталог пользовательских данных по умолчанию %LOCALAPPDATA%\hermes\. Путь к данным можно изменить переменной HERMES_HOME; поэтому не переносите настройки между средами, не проверив фактический каталог. После CLI-установки для запуска Desktop используется команда hermes desktop.

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

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

hermes model

Либо запустите полный мастер:

hermes setup

Для Nous Portal документация также приводит:

hermes setup --portal

Выбранный провайдер требует собственной авторизации. Не подключайте gateway, cron, skills или MCP-серверы до того, как обычный чат заработает.

Проверка первого чата

Запустите базовый интерфейс:

hermes

Для TUI используется:

hermes --tui

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

Сессия и диагностика

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

hermes --continue

Короткая форма — hermes -c. Если сессия не находится, проверьте, что запущен тот же профиль и что предыдущий диалог действительно сохранился. При общем сбое выполните:

hermes doctor

Если проблема появилась после обновления, документация также указывает hermes config check и hermes config migrate; применяйте миграцию только при наличии соответствующей проблемы.

Если антивирус блокирует uv.exe

Если Windows Defender или другой антивирус помещает uv.exe в карантин, не отключайте защиту без проверки. Репозиторий Hermes описывает последовательность: определить версию uv, получить соответствующий архив, проверить GitHub Attestation и сравнить хеши с установленным файлом. В примере используется путь %LOCALAPPDATA%\hermes\bin\uv.exe. Решение о добавлении исключения принимайте только после проверки происхождения файла и согласования с ответственным за безопасность.

Что делать после проверки

После успешного базового чата подключайте дополнительные функции по одной. Для настройки messaging gateway используется hermes gateway setup, а доступные инструменты настраиваются через hermes tools. Перед изменениями подготовьте резервную копию, проверьте права и используйте тестовые данные. Если Hermes нужен для рабочего процесса, Paramiko предлагает отдельно описать входные данные, разрешённые действия, участие человека и обработку ошибок, а затем проверить ограниченный пилот на примерах заказчика.