Hermes AI Assistant — установка, настройка, рабочая среда и устранение неполадок

Hermes Agent — это автономный, не привязанный к конкретной модели AI-ассистент, который работает на локальном компьютере или недорогом VPS, взаимодействует через терминал и интерфейсы обмена сообщениями, а также совершенствуется со временем, превращая повторяющиеся задачи в переиспользуемые навыки.

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

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

Что касается компромиссов развертывания и выбора среды выполнения, Хостинг LLM в 2026 году: Локальный, автономный и облачный инфраструктура предоставляет карту хостинга, а Производительность LLM в 2026 году: Бенчмарки, узкие места и оптимизация охватывает вопросы пропускной способности и задержки после запуска Hermes.

Моя предвзятое мнение: Hermes наиболее интересен, когда к нему относятся как к инфраструктуре, а не как к вкладке, которую вы открываете время от времени. Как только он запускается как служба и имеет стабильный домашний каталог, ваши промпты начинают напоминать не “чат”, а “операционную деятельность” (ops).

Что такое Hermes Agent и почему это важно

Hermes Agent — это агент искусственного интеллекта с открытым исходным кодом, разработанный компанией Nous Research. Он предназначен для постоянного выполнения, использования инструментов (терминал, файлы, веб и многое другое) и улучшения собственного поведения со временем с помощью системы навыков и памяти.

Два дизайнерских решения стоит разъяснить, поскольку они определяют все остальное в этом руководстве.

Во-первых, Hermes не привязан к одному провайдеру модели. Официальный процесс настройки поддерживает несколько провайдеров и любые эндпоинты, совместимые с OpenAI, а переключение выполняется через команду hermes model, а не путем редактирования кода.

Во-вторых, Hermes проводит четкую границу между “разговором” и “выполнением”. Агент может говорить весь день, но когда ему нужно действовать, он делает это через явные инструменты и настраиваемый бэкенд выполнения. Именно здесь находятся безопасность, воспроизводимость и устранение неполадок.

Стоимость и лицензирование приятно скучны. Сам Hermes Agent — это бесплатное программное обеспечение под лицензией MIT. Если вы используете размещенные модели, постоянные расходы — это то, что взимает ваш провайдер. Если вы запускаете локальные модели, вы можете полностью избежать платы за API.

Если ваша установка Hermes использует Claude через внешние слои инструментов, это изменение подписки Anthropic является полезной ссылкой на то, почему биллинг через API теперь является ожидаемым путем.

Установка Hermes Agent

Для Linux, macOS и WSL2 у Hermes есть быстрый путь установки. Официальная документация намеренно сохраняет все простым.

Установка одной строкой

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

После установки перезагрузите оболочку и запустите CLI.

source ~/.bashrc   # или source ~/.zshrc
hermes

Установщик — это не просто тонкая обертка. Согласно руководству по установке, он настраивает зависимости, репозиторий, виртуальную среду и команду hermes, после чего вы попадаете в состояние, готовое к первому чату.

Примечания для Windows и Android

Нативная поддержка Windows отсутствует. В документации рекомендуется использовать WSL2 и запускать Hermes внутри него.

Для Android Hermes поддерживает установку через Termux. Он разработан для обнаружения Termux и соответствующей адаптации настройки зависимостей и окружения.

Быстрый старт

Самый быстрый первый запуск — это буквально просто команда hermes, но осмысленный быстрый старт подразумевает два дополнительных решения: какой провайдер модели использовать и какие инструменты нужно включить.

Выбор провайдера и модели

Hermes предоставляет три взаимодополняющих точки входа:

• hermes model для выбора провайдера и модели по умолчанию
• hermes tools для включения или отключения наборов инструментов
• hermes setup для запуска интерактивного мастера по основным областям конфигурации

Минимальный поток выглядит следующим образом:

hermes model
hermes tools
hermes

Что касается того, что поддерживается на самом деле, то официальный раздел Quickstart перечисляет ряд провайдеров и также указывает, что Hermes работает с API, совместимыми с OpenAI. Это важно, потому что это включает как размещенные сервисы, так и автономные эндпоинты.

Докажите работу инструментов на раннем этапе

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

На практике небольшой промпт “дымовой проверки” выполняет две задачи: он проверяет инструмент терминала и валидирует запросы разрешений.

Пример промпта:

Покажи мне использование диска и пять largest каталогов.

Если Hermes не может запустить инструмент терминала, переходите сразу к разделу “Устранение неполадок”. Неправильная конфигурация бэкенда терминала является одной из самых распространенных причин, и исправление обычно очевидно, если посмотреть на конфигурацию.

Конфигурация, способная масштабироваться

Hermes вознаграждает тех, кто понимает, где хранится его состояние и как он решает конфигурацию. Именно отсюда часто возникают проблемы “вчера работало”.

Где живут конфигурация и состояние

Hermes хранит свои настройки и состояние в каталоге ~/.hermes. Официальное руководство по конфигурации документирует структуру, включая config.yaml для настроек, .env для секретов, auth.json для учетных данных OAuth, SOUL.md для идентичности, а также папки для памяти, навыков, cron, сессий и логов.

Это важно по двум причинам.

• Отладка становится механической, потому что вы точно знаете, где искать.
• Резервное копирование становится простым, потому что один каталог захватывает большую часть состояния агента, которое вас интересует.

Приоритет конфигурации и сохранение секретов вне config.yaml

Hermes решает конфигурацию с учетом порядка приоритетов. Наверху находятся переопределения CLI, затем config.yaml, затем .env, а внизу — встроенные значения по умолчанию.

Хорошая деталь заключается в том, что hermes config set направляет значения в правильный файл: API-ключи в .env, а несекретные настройки в config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes также поддерживает подстановку переменных окружения внутри config.yaml через синтаксис ${VAR_NAME}. Это полезно, когда вы хотите хранить определенные значения в окружении, но при этом ссылаться на них в структурированной конфигурации.

Песочницы и бэкенды выполнения

Hermes поддерживает несколько бэкендов терминала, которые определяют, где фактически выполняются команды оболочки. Руководство по конфигурации перечисляет local, docker, ssh, modal, daytona и singularity.

Субъективный, но не проповеднический способ думать об этом:

• local — самый быстрый и простой, но не изолированный
• docker — прагматичный слой безопасности и воспроизводимости
• ssh — чистый способ разделить устройство для чатов и вычислительный сервер
• modal и daytona подходят для рабочих процессов “serverless, но достаточно постоянных”
• singularity — вариант, дружественный к HPC

Минимальный пример бэкенда Docker:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

Документация также описывает методы усиления безопасности для бэкенда Docker, такие как удаление возможностей и отключение эскалации привилегий.

Навыки, память и профили

У Hermes есть два связанных механизма для накопления ценности.

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

Встроенная память хранится в виде файлов, таких как MEMORY.md и USER.md, в каталоге ~/.hermes, и Hermes также может использовать внешних провайдеров памяти для более глубокого запоминания. Документы по памяти перечисляют несколько плагинов провайдеров, а руководство по провайдерам памяти документирует интерактивный процесс настройки.

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

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

Типичный рабочий процесс

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

Стабильная базовая линия

Базовая линия, которая не склонна к деградации:

1. Установите и запустите первый чат в CLI.
2. Выберите провайдера и модель с помощью hermes model, затем подтвердите расходы.
3. Настройте наборы инструментов и решите, будет ли выполнение терминала локальным или в песочнице.
4. Внесите быстрое изменение в SOUL.md только после того, как вы использовали настройки по умолчанию в течение некоторого времени. Изменения идентичности важнее, чем люди ожидают, потому что это “слот 1” в системном промпте.

Ежедневное использование, которое приносит накопительный эффект

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

На практике полезный ритм выглядит так:

• выполняйте работу в именованной сессии для проекта
• сжимайте контекст, когда он становится слишком большим
• позвольте Hermes превращать повторяющиеся рутины в навыки
• сохраняйте ментальную границу между “спросить” и “действовать”, чтобы выполнение инструментов оставалось проверяемым

Шлюз обмена сообщениями для доступа 24/7

Шлюз обмена сообщениями — это та часть, которая делает Hermes похожим на ассистента, а не на терминальное приложение. Документация описывает его как единый процесс, который подключается к нескольким платформам, обрабатывает сессии, выполняет задания cron и доставляет сообщения.

Настройка вызывается через hermes gateway setup, и шлюз может работать в переднем плане или как пользовательская служба. Справочник CLI документирует подкоманды шлюза, такие как run, install, start, stop, status и restart.

Безопасность для бота, использующего инструменты, имеет значение. Документы шлюза описывают списки разрешений для конкретных платформ и поток парной связи DM, который выдает одноразовые коды парной связи и требует одобрения через hermes pairing approve.

Обновления без драмы

Обновления Hermes — это команда первого класса. Руководство по обновлению документирует hermes update, проверки миграции конфигурации и небольшую рутину валидации после обновления, включая hermes doctor и hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Устранение неполадок и диагностика

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

Быстрые команды для первичной диагностики

Справочник CLI явно позиционирует три команды как основной цикл:

• hermes doctor для интерактивной диагностики
• hermes status для быстрого обзора
• hermes dump для общих, удаленных сводок настроек

Для логов hermes logs выводит файлы, хранящиеся в ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Распространенные ошибки установки

Руководство по часто задаваемым вопросам и устранению неполадок перечисляет несколько повторяющихся проблем и их исправления, включая проблемы с версией Python, отсутствие uv и проблемы с правами, вызванные смешиванием установки с sudo и установки пользователя.

Если вы столкнетесь с этими ошибками, в документации приведены конкретные шаги по восстановлению, такие как обновление Python, установка uv и переустановка Hermes без sudo.

Проблемы провайдера и модели

Когда API-ключи не работают, FAQ рекомендует проверить конфигурацию, повторно запустить hermes model или установить ключ напрямую через hermes config set. Он также указывает на распространенную ловушку: ключи специфичны для провайдера.

Для проблем “модель не найдена” FAQ указывает на использование hermes model для выбора действительного идентификатора и показывает как конфигурационные, так и пересессионные переопределения.

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

Проблемы бэкенда терминала и шлюза

Если команды терминала сразу же не выполняются, руководство по конфигурации включает раздел “распространенные проблемы бэкенда терминала” и указывает на типичные причины для каждого бэкенда, включая отсутствие запуска Docker и отсутствие переменных SSH. Также отмечается, что откат к локальному режиму является валидным шагом отладки, когда конфигурация песочницы вызывает вопросы.

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

Ссылки

• Домашняя страница Hermes Agent
• Навыки AI-ассистента Hermes для настоящих продакшен-установок