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

Установка и быстрый старт агента Hermes для разработчиков

Содержимое страницы

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

По функциональности он очень похож на OpenClaw, другой стэком для автономных ассистентов, построенным вокруг инструментов, памяти и локального контроля. Многие разработчики обратились к Hermes после того, как Anthropic заблокировала доступ к подписке Claude для OpenClaw в апреле 2026 года — хронология роста и падения OpenClaw объясняет, почему Hermes стал естественной альтернативой для пользователей, желающих получить постоянную автономную автоматизацию без зависимости от провайдера.

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

Что касается компромиссов при развертывании и выбора среды выполнения, то Хостинг LLM в 2026 году: локальные, автономные и облачные инфраструктуры в сравнении предоставляет карту хостинг-решений, а Производительность LLM в 2026 году: бенчмарки, узкие места и оптимизация освещает аспекты пропускной способности и задержки после запуска Hermes. Для компактной карты команд оболочки (hermes gateway, hermes memory, hermes doctor, косые штрихи и другие) используйте [Шпаргалку по CLI Hermes Agent](https://www.glukhov.org/ru/ai-systems/hermes/hermes-agent-cli-cheatsheet/ “Быстрая справка по CLI Hermes Agent — установка, hermes chat, gateway, skills, memory, diagnostics и slash-команды.}). Если вашим основным способом взаимодействия является общение с мобильного устройства, используйте Голосовое управление Hermes с телефона для голосового стека и специфичной для платформы настройки.

персональный-и-ассистент на ноутбуке

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

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

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

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

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

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

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

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

Установка Hermes Agent

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

Установка Hermes на Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
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 явно предлагает использование терминала в качестве первой функции для проверки.

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

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

Покажи использование диска и пять крупнейших директорий.

Если 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 подходят для рабочих процессов «серверлесс, но достаточно постоянных»
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, такое как отказ от возможностей (capabilities) и отключение повышения привилегий.

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

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

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

Встроенная память хранится в файлах, таких как MEMORY.md и USER.md, в директории ~/.hermes, и Hermes также может использовать внешних провайдеров памяти для более глубокого воспоминания. Документация по памяти перечисляет несколько плагинов провайдеров, а руководство по провайдерам памяти документирует интерактивный процесс настройки. Для полного технического разбора того, как работает архитектура памяти — замороженные снимки, лимиты символов, восемь внешних провайдеров и философия ограниченной памяти — см. [Система памяти Hermes Agent: Как действительно работает постоянная память ИИ](https://www.glukhov.org/ru/ai-systems/hermes/hermes-agent-memory-system/ “Глубокое техническое руководство по архитектуре памяти Hermes Agent — от ограниченной базовой памяти из 2 файлов до 8 подключаемых внешних провайдеров.}).

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

Для более глубокого взгляда на то, какие навыки хорошо работают в производстве по ролям — инженеры, исследователи, операторы и исполнительные рабочие процессы — см. [Навыки ИИ-ассистента Hermes для реальных производственных настроек](https://www.glukhov.org/ru/ai-systems/hermes/production-setup/ “Руководство, ориентированное на профили, по настройке Hermes Agent и навыкам для инженеров, исследователей, операторов и исполнительных рабочих процессов в производстве.}). Когда вы будете готовы создавать или отлаживать сами файлы SKILL.md — метаданные YAML, уровни прогрессивного раскрытия, условная видимость и установка из хабов — используйте [Создание навыков Hermes Agent — Структура SKILL.md и лучшие практики](https://www.glukhov.org/ru/ai-systems/hermes/authoring-hermes-skill/ “Создавайте навыки Hermes с YAML-фронтматтером, прогрессивным раскрытием, условной активацией, секретами против конфигурации и устранением неполадок индекса.}).

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

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

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

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

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

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

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

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

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

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

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

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

Для многоагентных бэклогов и контролируемого планирования см. Kanban в Hermes Agent для рабочих процессов автономных LLM, который охватывает лимиты диспетчера, цепочки зависимостей и пакетную обработку на основе cron.

Безопасность для бота, использующего инструменты, имеет значение. Документация шлюза описывает списки разрешений для конкретных платформ и поток паринга 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

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

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

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

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

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

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

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

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

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

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