Hermes AI Assistant: установка, настройка, рабочий процесс и устранение неполадок
Установка и быстрое начало работы с агентом Hermes для разработчиков
Hermes Agent — это локальный, независимый от модели ИИ-ассистент, который работает на локальной машине или на недорогом VPS, взаимодействует через терминал и мессенджеры, а со временем улучшает свои навыки, превращая повторяющиеся задачи в переиспользуемые умения.
По функциональности он очень похож на OpenClaw, другой стеком ассистентов для локального хостинга, построенном вокруг инструментов, памяти и локального контроля. Многие разработчики перешли на Hermes после того, как Anthropic заблокировала доступ к подписке Claude для OpenClaw в апреле 2026 года — хронология взлета и падения OpenClaw объясняет, почему Hermes стал естественным выбором для пользователей, искавших постоянную локальную автоматизацию без привязки к провайдеру.
Если вам нужен более широкий обзор локальных ассистентов, систем поиска и локальной инфраструктуры вокруг Hermes, этот обзор систем ИИ связывает эти темы с теми проблемами, которые пытается решить Hermes. Для конкретных данных об adoption — звездах GitHub, дневном объеме токенов OpenRouter, количестве загрузок PyPI, истории CVE и настроениях сообщества Reddit — статья OpenClaw vs Hermes Agent: Звезды, загрузки и использование 2026 отслеживает, как Hermes сравнивается с 19 альтернативами по всем измеримым показателям.
Для понимания компромиссов при развертывании и выбора среды выполнения Хостинг LLM в 2026 году: локальный, самообслуживаемый и облачная инфраструктура предоставляет карту хостинга, а Производительность LLM в 2026 году: бенчмарки, узкие места и оптимизация охватывает вопросы пропускной способности и задержки после запуска Hermes. Если вы регулярно используете Qwen или Gemma на локальных средах выполнения, таких как Ollama, настройте параметры температуры и штрафов для многоступенчатого использования инструментов с помощью Параметров агентного вывода LLM для Qwen и Gemma. Для компактной карты команд оболочки (hermes gateway, hermes memory, hermes doctor, слэш-команды и другие) используйте Шпаргалку по CLI Hermes Agent. Если вашим основным входом является мессенджинг на мобильном устройстве, используйте Голосовое управление Hermes с телефона для голосового стека и настройке под конкретную платформу.
Мое субъективное мнение: Hermes наиболее интересен, когда к нему относятся как к инфраструктуре, а не как к вкладке, которую вы время от времени открываете. Как только он запускается как служба и имеет стабильный домашний каталог, ваши промпты начинают выглядеть меньше как «чат» и больше как «операционные задачи».
Что такое Hermes Agent и почему это важно
Hermes Agent — это агент ИИ с открытым исходным кодом, созданный Nous Research. Он предназначен для постоянной работы, использования инструментов (терминал, файлы, веб и др.) и улучшения собственного поведения со временем благодаря системе навыков и памяти.
Два дизайнерских решения заслуживают особого внимания, так как они определяют все остальное в этом руководстве.
Во-первых, Hermes не привязан к одному провайдеру моделей. Официальный процесс настройки поддерживает множество провайдеров и любой endpoint, совместимый с OpenAI, а переключение осуществляется через команду hermes model, а не через редактирование кода.
Во-вторых, Hermes проводит четкую границу между «разговором» и «выполнением». Агент может болтать весь день, но когда ему нужно действовать, он делает это через явные инструменты и настраиваемый бэкенд выполнения. Именно здесь живут безопасность, воспроизводимость и устранение неполадок.
Стоимость и лицензирование радуют своей простотой. Сам Hermes Agent — это бесплатное программное обеспечение под лицензией MIT. Если вы используете облачные модели, текущая стоимость зависит от того, что взимает ваш провайдер. Если вы запускаете локальные модели, вы можете полностью избежать платы за API.
Если ваша настройка Hermes использует Claude через внешние слои инструментов, это изменение в подписке Anthropic является полезным справочным материалом о том, почему биллинг на основе API стал ожидаемым путем.
Установка Hermes Agent
Hermes имеет быстрый путь установки для 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. Это важно, потому что это включает как облачные сервисы, так и локальные endpoint’ы.
Докажите выполнение инструментов на раннем этапе
Прежде чем вы начнете формировать привычки вокруг 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: Как на самом деле работает постоянная память ИИ.
Если вам нужны несколько независимых агентов на одной машине, профили Hermes обеспечивают изоляцию. Каждый профиль получает свою собственную директорию со своей конфигурацией, секретами, памятью, сессиями, навыками, cron-задачами и состоянием шлюза.
Для более глубокого взгляда на то, какие навыки хорошо работают в продакшене по ролям — инженеры, исследователи, операторы и исполнительные рабочие процессы — см. Навыки ИИ-ассистента Hermes для реальных производственных настроек. Когда вы будете готовы создавать или отлаживать сами файлы SKILL.md — метаданные YAML, уровни прогрессивного раскрытия, условная видимость и установка из хабов — используйте Авторство навыков Hermes Agent — Структура SKILL.md и лучшие практики.
Типичный рабочий процесс
Если вы относитесь к Hermes как к агенту, которого вы будете держать рядом, рабочий процесс начинает напоминать сервисную инженерию.
Стабильная базовая линия
Базовая линия, которая склонна не деградировать:
- Установите и запустите первый чат в CLI.
- Выберите провайдера и модель с помощью
hermes model, затем подтвердите затраты. - Настройте наборы инструментов и решите, будет ли выполнение терминала локальным или в песочнице.
- Внесите быстрое изменение в
SOUL.mdтолько после того, как вы какое-то время использовали настройки по умолчанию. Изменения идентичности имеют большее значение, чем люди ожидают, потому что это «слот 1» в системном промпте.
Ежедневное использование, которое накапливается
У Hermes есть терминальный UI, а не веб-UI, и он предназначен для длительных сессий со слэш-командами, возобновляемыми сессиями и потоковым выводом инструментов.
На практике полезный ритм:
- выполняйте работу в именованной сессии для проекта
- сжимайте контекст, когда он становится слишком большим
- позвольте 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. Также отмечается, что возврат к локальному режиму является допустимым шагом при отладке, когда возникает вопрос о конфигурации песочницы.
Для проблем со шлюзом руководство по мессенджингу выделяет списки разрешений и парное соединение как безопасные значения по умолчанию, что означает, что многие инциденты «бот молчит» на самом деле являются работой авторизации.
