Установить Hermes Agent на Windows: Desktop, PowerShell и проверка запуска

Какой способ выбрать

Для Windows есть два основных пути. Если нужен графический интерфейс и готовый пакет, используйте Hermes Desktop. Если достаточно командной строки, установите CLI через PowerShell. WSL2 выбирать необязательно: это отдельная Linux-среда со своими каталогами данных и собственным способом установки.

Вариант 1: Hermes Desktop

Скачайте пакет Hermes Desktop для Windows и откройте файл .appinstaller через Windows App Installer. Пакет устанавливает подписанный MSIX-комплект. Этот вариант подходит, если вы хотите пользоваться Desktop и поставляемыми вместе с ним интерфейсами без ручной сборки окружения.

После установки откройте Hermes Desktop и перейдите к первичной настройке. Наличие установленного приложения ещё не означает, что провайдер модели уже выбран: этот шаг нужно завершить отдельно.

Вариант 2: CLI через PowerShell

Для нативной установки CLI откройте PowerShell и выполните:

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

Скрипт подготавливает исходную установку и зависимости Hermes. Документация указывает, что при отсутствии Git Windows-установщик может подготовить управляемый архив Git for Windows в хранилище инструментов Hermes, не заменяя системный Git.

После завершения откройте новое окно PowerShell или перезагрузите профиль оболочки. Затем проверьте запуск:

hermes

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

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

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

hermes model

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

hermes setup

Если у вас есть доступ к Nous Portal, документация также описывает режим:

hermes setup --portal

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

Проверка первого запуска

Запустите обычный чат командой:

hermes

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

Если установка прошла, но ответ не формируется, сначала снова запустите hermes model и проверьте провайдера, модель и авторизацию. Не подключайте рабочие данные и права на изменение систем до завершения базовой проверки.

Диагностика и ограничения

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

hermes doctor

Команда предназначена для проверки состояния установки и сообщает, что требует внимания. Если проблема связана с отсутствующей командой, перезапустите PowerShell и проверьте окружение. Если ошибка указывает на провайдера, повторно выполните hermes model. Если не хватает или устарела конфигурация, используйте hermes config check, а затем применяйте миграцию только если её необходимость подтверждена диагностикой.

Для установки через WSL2 не переносите команды и каталоги нативной Windows без проверки: WSL2 устанавливает Hermes в Linux-среде, а нативный вариант — в Windows-среде.

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

Рекомендация Paramiko: сначала проверьте Hermes на тестовом запросе и обезличенных данных. Зафиксируйте, какой способ установки выбран, где запускается агент и какой результат считается успешным. До отдельной проверки не выдавайте агенту рабочие секреты и права на изменение данных.

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