Hermes Agent — открытый агентный фреймворк Nous Research для терминала, настольного приложения, мессенджеров и интеграций со средами разработки (IDE). Он сохраняет память между сессиями, загружает переиспользуемые навыки и позволяет запускать несколько изолированных профилей.
Для кого нужен этот справочник
Материал рассчитан на пользователей, которым нужно выбрать интерфейс Hermes Agent, понять устройство памяти и навыков, а также настроить профили и задачи по расписанию. Для первоначальной установки используйте отдельное руководство, а здесь проверяйте архитектуру, команды и практические сценарии.
Основные возможности Hermes Agent
По состоянию на версию v0.21.0 одно агентное ядро доступно через несколько интерфейсов:
- CLI и терминальный интерфейс Ink TUI;
- нативное настольное приложение;
- веб-панель с чатом и административными настройками;
- ACP-сервер для подключения к VS Code, Zed и JetBrains;
- шлюзы для Telegram, Discord, Slack, WhatsApp, iMessage, Signal, Matrix, Teams, Email и других каналов;
- локальный OpenAI-совместимый прокси для сторонних приложений.
Hermes работает с OpenRouter, Anthropic, OpenAI, Google, DeepSeek, xAI, локальными моделями и другими провайдерами. Модель и провайдера можно менять без замены остальной агентной инфраструктуры.
Общая архитектура
Работу Hermes удобно рассматривать как несколько связанных слоёв:
- Модель и провайдер. Языковая модель (LLM) планирует действия и вызывает доступные инструменты.
- Инструменты. Терминал, поиск, серверы MCP, пользовательские плагины, планировщик cron и другие расширения выполняют действия.
- Память и сессии. Каноническая история хранится в SQLite с полнотекстовым поиском FTS5; отдельные файлы сессий обслуживают маршрутизацию шлюза, дампы запросов и JSONL-транскрипты.
- Навыки. Переиспользуемые инструкции загружаются по необходимости и сохраняют проверенные процедуры.
- Интерфейсы. CLI, TUI, desktop, dashboard, IDE и мессенджеры обращаются к тому же агентному контуру.
- Профили и боты. Изолированные экземпляры получают собственные настройки, память, навыки и сессии.
Такая схема позволяет начать с локального чата, затем подключить Telegram или desktop, не собирая нового агента для каждого интерфейса.
Память, сессии и навыки
Hermes сохраняет сведения о пользователе, рабочей среде и предыдущих разговорах. Каноническое хранилище сессий находится в ~/.hermes/state.db; оно использует SQLite и FTS5. В каталоге ~/.hermes/sessions/ лежат данные маршрутизации шлюза, дампы запросов и транскрипты в формате JSONL.
Навыки представляют собой переиспользуемые рабочие инструкции. Каталог навыков раскрывается постепенно: сначала агенту достаточно названия и описания, а полное содержимое и дополнительные файлы загружаются для подходящей задачи. Это сокращает расход контекста и отделяет факты о пользователе от процедур выполнения работы.
В v0.21.0 и вошедших в него обновлениях задачи планировщика cron получили постоянную память: cron-агенты загружают и обновляют её так же, как обычные агенты. Параметр continuity=true передаёт вывод предыдущего запуска следующему, а отдельный блокнот хранит рабочие заметки задачи. Например, ежедневный монитор может сравнивать новый результат с предыдущим и отфильтровывать уже отправленные элементы.
AGENTS.md), навыки и хранилища памяти защищены: запись в них требует разрешения пользователя. Перед установкой стороннего навыка проверьте его содержимое и запрашиваемые права.Профили, Bot Mode и взаимодействие агентов
Профиль — независимый экземпляр Hermes со своей конфигурацией, памятью, навыками и сессиями. Файлы профилей размещаются внутри ~/.hermes/profiles/. Внутри активной сессии путь к домашнему каталогу профиля следует брать из $HERMES_HOME: жёстко заданный ~/.hermes может обратиться к основному профилю вместо активного.
В v0.21.0 в desktop-приложение вошёл режим ботов (Bot Mode). Профили можно представить как именованных ботов, объединять в групповые комнаты и обращаться к конкретному участнику через упоминание. Команда hermes peer обеспечивает личные сообщения между агентами из разных профилей и шлюзов; переписка сохраняется в канонических чатах ботов.
Практическая схема команды может выглядеть так:
- исследователь собирает и проверяет источники;
- программист получает результаты через межагентное сообщение и вносит изменения;
- редактор готовит итоговый документ;
- cron-задача повторяет процесс по расписанию и учитывает предыдущий выпуск.
Для короткой параллельной работы используется делегирование субагентам. В v0.21.0 работающими субагентами можно управлять: просматривать список дочерних процессов, передавать уточнение во время выполнения и досрочно останавливать их с сохранением частичного результата. Для долгих автономных процессов документация предусматривает отдельные экземпляры Hermes.
Основные команды
| Команда | Что делает | Когда использовать |
hermes | Запускает интерактивный чат | Обычная локальная работа |
hermes chat -q "Запрос" | Выполняет один запрос без интерактивной сессии | Скрипты и разовые задачи |
hermes setup | Запускает мастер первоначальной настройки | Выбор модели и провайдера |
hermes model | Запускает выбор модели и провайдера | Смена модели |
hermes doctor | Проверяет состояние установки | Первичная диагностика |
hermes desktop | Запускает нативное приложение; алиас — hermes gui | Графический интерфейс и Bot Mode |
hermes dashboard | Запускает веб-панель и встроенный чат | Управление каналами, MCP, памятью и профилями |
hermes proxy | Поднимает локальный OpenAI-совместимый прокси | Подключение Codex CLI, Aider, Cline или своего скрипта |
hermes peer | Передаёт сообщения между агентами | Координация профилей и ботов |
Основные файлы
~/.hermes/
├── config.yaml # Настройки, не содержащие секретов
├── .env # API-ключи и другие секреты
├── auth.json # OAuth-токены и пулы учётных данных
├── state.db # Каноническое хранилище сессий SQLite + FTS5
├── sessions/ # Маршрутизация, дампы запросов и JSONL-транскрипты
├── skills/ # Установленные навыки
├── profiles/ # Изолированные профили
├── logs/ # Журналы шлюза и ошибок
├── skins/ # Пользовательские темы
├── desktop-plugins/ # Расширения интерфейса desktop
└── tui-widgets/ # Виджеты терминального интерфейсаНастройки меняйте через hermes config set <key> <value>, а не ручным редактированием YAML. Секреты должны находиться в .env, остальные параметры — в config.yaml.
Полезные сценарии
Личный агент в нескольких интерфейсах
Настройте модель через hermes setup, проверьте установку командой hermes doctor, затем используйте тот же профиль в CLI, desktop или подключённом мессенджере. Внутри этого профиля история и память остаются частью общего агентного контура.
Ограничение: разные профили изолированы, поэтому их настройки и доступы настраиваются отдельно.
Команда специализированных ботов
Создайте отдельные профили для исследования, программирования и редактуры, подключите их к Bot Mode и передавайте результаты через hermes peer. Результат: сообщения появляются в канонических чатах соответствующих ботов и остаются доступными для проверки.
Ограничение: каждому профилю нужны собственные настройки доступов и отдельная проверка разрешений.
Плановый мониторинг с памятью
Настройте повторяющуюся cron-задачу, включите непрерывность между запусками и доставку результата в нужный канал. Результат: новый запуск получает предыдущий вывод и может не отправлять повторно уже обработанные элементы.
Ограничение: точный синтаксис расписания проверяйте в документации установленной версии.
OpenAI-совместимый доступ для другого приложения
Запустите hermes proxy и укажите локальный endpoint в совместимом клиенте. Так Codex CLI, Aider, Cline или собственный скрипт смогут обращаться к провайдеру, авторизованному в Hermes.
Ограничение: прокси должен быть доступен только доверенным локальным приложениям.
Проверка установки и ответа
Для первичной проверки используйте:
hermes doctor
hermes chat -q "Проверка связи"hermes doctor выполняет проверку состояния установки, а hermes chat -q запускает одиночный запрос. Проверка считается успешной, если первая команда не сообщает об ошибках установки, а вторая возвращает ответ выбранной модели.
GEPA: отдельная эволюция навыков
Hermes Agent Self-Evolution — самостоятельный репозиторий Nous Research на базе DSPy и GEPA (Genetic-Pareto Prompt Evolution). Реализованная первая фаза оптимизирует файлы SKILL.md; оптимизация описаний инструментов, системных промптов, кода и непрерывный цикл пока обозначены как будущие этапы.
GEPA анализирует трассы выполнения, создаёт варианты навыка и сравнивает их на оценочном наборе. Каждый вариант должен пройти тесты, ограничение размера навыка в 15 КБ, проверку совместимости с кэшированием и сохранения исходного назначения. Результат отправляется на человеческое ревью через pull request, прямой коммит не используется.
GPU не требуется: вычисления выполняются через API. Официальный репозиторий указывает ориентир около $2–10 за один прогон оптимизации.
Что делать, если возникла проблема
hermes doctor и устраните найденные ошибки.hermes model..env, а обычная настройка — в config.yaml.$HERMES_HOME.state.db и журналы в logs/.Официальные источники
Hermes подходит для персональных и командных агентных контуров, где нужны постоянная память, специализированные роли и повторяемые процессы.
Следующий шаг
Для установки и первоначальной настройки используйте руководство Hermes Agent — установка и быстрый старт.
Если вы проектируете личный или командный агентный контур, этот разбор помогает заранее определить подходящие интерфейсы, границы изоляции и способы проверки.
Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov
