Hermes Agent: как установить, настроить и проверить первый запуск

Что такое Hermes Agent и чем он отличается от Desktop

## Что такое Hermes Agent и чем он отличается от Desktop

Hermes Agent — агент Nous Research, а Hermes Desktop — графический интерфейс для того же агента. По официальной документации Desktop использует те же конфигурацию, ключи, сессии, навыки и память, что и CLI. Поэтому выбор Desktop не означает создание отдельной версии агента: начатую в терминале сессию можно продолжить в приложении, а настройки, сделанные в одном интерфейсе, доступны в другом.

Для первого знакомства Desktop удобнее пользователям, которым не нужен терминал. CLI полезен там, где важны скрипты, удалённый сервер или привычная работа через SSH. Но интерфейс не меняет границы ответственности: Hermes Agent не становится автоматически CRM, оператором бизнеса или безопасным исполнителем любых действий только потому, что у него есть графическая оболочка.

Источники: Hermes Desktop

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

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

Официальная матрица поддержки выделяет macOS на Apple Silicon, Windows 10/11, Linux и WSL2, а также Docker как основные варианты. Для macOS и Windows доступен Hermes Desktop; Linux и WSL2 обычно устанавливаются через install.sh. На Windows есть нативный вариант, поэтому WSL2 не является обязательным условием. При этом у разных платформ могут отличаться доступные функции, поэтому для рабочего компьютера лучше заранее определить, нужен ли именно Desktop, CLI или серверный запуск.

Для бизнес-проверки начните с одной изолированной среды и не подключайте сразу рабочие ключи, базы и права на запись. Сначала проверьте установку и ответы на обезличенных данных. Это не требование конкретной команды Hermes, а разумное ограничение пилота, если агент затем будет получать доступ к рабочим инструментам.

Источники: Platform Support · Hermes Agent Quickstart

Установка на macOS или Windows через Desktop

## Установка на macOS или Windows через Desktop

Официальная инструкция рекомендует для macOS и Windows скачать и запустить установщик Hermes Desktop. Этот путь предназначен для тех, кто хочет получить одновременно графическое приложение и командную строку без ручной сборки окружения. После установки откройте приложение и пройдите первоначальную настройку.

Если Hermes уже установлен через CLI, документация предлагает запустить команду `hermes desktop`. В этом случае Desktop использует существующие конфигурацию, ключи, сессии и навыки. Такой вариант удобен, когда сначала проверяли агент в терминале, а затем понадобился визуальный интерфейс.

Результат шага: приложение запускается, видит локальный runtime, а настройки не создаются заново. Если Desktop не видит рабочий runtime, не переходите сразу к подключению бизнес-сервисов — сначала исправьте базовую установку.

Источники: Installation | Hermes Agent · Hermes Desktop

Установка CLI на Linux, macOS, WSL2 и Windows

## Установка CLI на Linux, macOS, WSL2 и Windows

Для Linux, macOS, WSL2 и Termux официальная инструкция приводит установку через `install.sh`. Для нативной Windows предусмотрен PowerShell-скрипт `install.ps1`. Установщик, согласно документации, подготавливает зависимости, репозиторий, виртуальное окружение, глобальную команду `hermes` и первичную конфигурацию провайдера.

После завершения нужно перезапустить оболочку или загрузить обновлённый профиль, чтобы команда `hermes` стала доступна. Затем запустите сам агент. Если команда не находится, проверьте PATH и используйте именно инструкции для вашей ОС, а не случайный сторонний гайд.

Не смешивайте данные нативной Windows и WSL2 без необходимости: официальная Windows-документация указывает, что эти среды используют разные каталоги данных. Для рабочего пилота заранее выберите одну среду, чтобы не потерять сессии и настройки.

Источники: Installation | Hermes Agent · Источник: hermes-agent.nousresearch.com

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

## Первичная настройка и проверка результата

После установки сначала выполните `hermes setup` или выберите провайдера через `hermes model`. Официальный quickstart рекомендует сначала добиться нормального рабочего чата и только затем добавлять gateway, cron, навыки, голосовые функции или маршрутизацию между моделями.

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

Для внутреннего B2B-пилота добавьте контрольный набор из обезличенных задач: несколько типовых вопросов, один неоднозначный пример и один запрос, где агент должен честно сообщить о недостатке данных. Человек оценивает не только полезность ответа, но и случаи, когда агент должен остановиться и передать решение сотруднику.

Источники: Hermes Agent Quickstart · Installation | Hermes Agent

Что подключать после рабочего чата

## Что подключать после рабочего чата

Если базовый диалог стабилен, можно изучать дополнительные интерфейсы. Quickstart отдельно указывает gateway как следующий этап для bot- или always-on-сценариев. Desktop-документация также описывает CLI, TUI и web dashboard как разные интерфейсы, работающие с одним агентом.

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

Официальные материалы подтверждают технические интерфейсы Hermes Agent, но не доказывают, что конкретный процесс компании можно без доработок подключить к агенту. Поэтому интеграцию с CRM, 1С, почтой или мессенджерами нужно проектировать как отдельный пилот, а не считать частью установки.

Источники: Hermes Agent Quickstart · Hermes Desktop

Типичные ошибки и ограничения

## Типичные ошибки и ограничения

Первая ошибка — добавлять инструменты до проверки обычного чата. Вторая — считать Desktop отдельным продуктом и повторно настраивать ключи и сессии. Третья — смешивать нативную Windows, WSL2 и удалённый сервер, не определив, где находятся конфигурация и данные. Четвёртая — давать агенту права на запись до того, как измерены ошибки на тестовых примерах.

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

Для Paramiko корректная следующая услуга — не обещание «настроить Hermes за один шаг», а обследование процесса, подготовка ограниченного пилота и интеграция только тех систем, для которых подтверждены доступы, API и правила контроля.

Источники: Hermes Agent Quickstart · Источник: hermes-agent.nousresearch.com · Hermes Desktop