Как установить Hermes Agent: руководство по настройке для начинающих

Hermes Agent — ИИ-агент с открытым исходным кодом от Nous Research, который запускается из терминала, подключается к разным провайдерам моделей, сохраняет полезный контекст между сессиями и расширяется с помощью инструментов, навыков, шлюзов для обмена сообщениями и автоматизации. Это руководство поможет вам установить Hermes. Для стандартной установки на macOS или Windows не нужно вручную устанавливать Python или Node.js: официальный установщик сам настроит основные зависимости.

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

• macOS: откройте «Терминал» через «Программы» > «Утилиты» > «Терминал» либо нажмите Command + Space и найдите «Терминал».

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

Также потребуется Git. Проверьте, установлен ли Git:

Ожидаемый вывод:

Если отображается git: command not found, сначала установите Git:

Если на macOS у вас нет Homebrew, установите Git из Apple Command Line Tools, выполнив команду:

Скопируйте и вставьте в терминал команду официального установщика:

Установщик скачивает Hermes Agent, подготавливает среду Python, устанавливает необходимые зависимости и добавляет команду hermes в путь оболочки. При обычной установке для пользователя данные Hermes хранятся в ~/.hermes/.

Когда команда завершится, перезагрузите оболочку:

Если вы используете Zsh, что часто встречается на macOS, выполните:

Ожидаемый результат:

Теперь убедитесь, что команда Hermes Agent доступна:

Ожидаемый результат:

Точный номер версии может меняться по мере обновления Hermes Agent.

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

Мастер настройки позволяет выбрать провайдера, например Kimi/Moonshot. Не настраивайте маршрутизацию, резервные варианты, шлюз или cron, пока не заработает базовый чат.

Выберите модель по умолчанию. Kimi K3 — новейшая флагманская модель Kimi; если вам в основном нужно программирование, лучше выбрать kimi-k2.7-code.

Если вы уже знаете значение, которое хотите задать, используйте hermes config set. Например:

Перед использованием Kimi API с Hermes Agent активируйте свой ключ Kimi API на платформе Kimi. Мы рекомендуем пополнить баланс на $20 или больше, чтобы получить доступ к Tier 2: это снизит задержку и обеспечит более стабильную работу при выполнении сложных многошаговых задач.

Перейдите в раздел API Keys на платформе Kimi и нажмите Create API Key. Не забудьте скопировать API-ключ и сохранить его в безопасном месте, поскольку он отображается только один раз — при создании.

Вставьте свой ключ Kimi API и подключите Hermes Agent.

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

Или попробуйте новый терминальный интерфейс:

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

Успешный результат выглядит так:

Если Hermes Agent запускается, но выдаёт ошибки модели или аутентификации, выполните:

Затем снова выберите провайдера и проверьте API-ключ или вход через OAuth.

Как и OpenClaw, Hermes Agent может работать в качестве бота и подключаться к вашим чат-приложениям:

После настройки проверьте статус шлюза:

Используйте шлюз только после того, как провайдер модели заработает в терминале. Если CLI не может выполнить базовый чат, бот обычно не сможет сделать этого по той же причине.

Причина: терминал ещё не применил изменения PATH.

Решение:

Или:

Затем попробуйте:

Причина: Git не установлен.

Решение для Ubuntu, Debian или WSL2:

Решение для macOS с Homebrew:

Причина: Hermes Agent установлен, но ключ провайдера или вход не настроены.

Решение:

Или задайте ключ вручную:

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

Решение:

Причина: неверно указаны базовый URL, название модели или длина контекста.

Решение: сначала проверьте endpoint в отдельном клиенте, убедитесь в его совместимости с OpenAI и в том, что модель поддерживает контекст не менее 64K для обычных сценариев работы Hermes Agent.

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