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

Для кого нужен этот справочник

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

Основные возможности Hermes Agent

В проверенной документации ветки v0.22 одно агентное ядро доступно через несколько интерфейсов:

• 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, локальными моделями и другими провайдерами. Модель и провайдера можно менять без замены остальной агентной инфраструктуры.

Общая архитектура

В ветке v0.22 добавлены управляемые локальные модели через llama.cpp, коннекторы Nous Tool Gateway, общая инфраструктура профилей и перенос части расширений из ядра в плагины. Требование модели — окно контекста не менее 64 000 токенов. Локальная модель не делает автоматически локальными поиск, коннекторы и внешние MCP-инструменты.

MCP имеет две независимые роли: клиент подключает внешние серверы через mcp_servers, а официальный плагин mcp-serve предоставляет инструменты Hermes другому клиенту. Установка — hermes plugins install mcp-serve, запуск — hermes mcp-serve. hermes serve — другой сервер, обслуживающий backend Desktop. Документация MCP.

Работу Hermes удобно рассматривать как несколько связанных слоёв:

1. Модель и провайдер. Языковая модель (LLM) планирует действия и вызывает доступные инструменты.
2. Инструменты. Терминал, поиск, серверы MCP, пользовательские плагины, планировщик cron и другие расширения выполняют действия.
3. Память и сессии. Каноническая история хранится в SQLite с полнотекстовым поиском FTS5; отдельные файлы сессий обслуживают маршрутизацию шлюза, дампы запросов и JSONL-транскрипты.
4. Навыки. Переиспользуемые инструкции загружаются по необходимости и сохраняют проверенные процедуры.
5. Интерфейсы. CLI, TUI, desktop, dashboard, IDE и мессенджеры обращаются к тому же агентному контуру.
6. Профили и боты. Профили получают собственные настройки, память, навыки и сессии. В ветке v0.22 на хосте используется один backend и один gateway, обслуживающие несколько профилей.

Такая схема позволяет начать с локального чата, затем подключить Telegram или desktop, не собирая нового агента для каждого интерфейса.

Память, сессии и навыки

Встроенная память Hermes состоит не из одного безграничного архива:

• memories/MEMORY.md хранит факты о среде и работе; стандартный лимит — 2 200 символов.
• memories/USER.md хранит модель пользователя; стандартный лимит — 1 375 символов.
• state.db — каноническая история сессий в SQLite с полнотекстовым поиском FTS5. sessions/ содержит вспомогательные данные маршрутизации, дампы и JSONL-транскрипты.
• Каталог skills/ хранит процедуры в SKILL.md. Сначала агент видит название и описание; полный текст и дополнительные файлы загружаются для подходящей задачи.

Для профиля пути отсчитываются от $HERMES_HOME, а не всегда от ~/.hermes. Память загружается снимком в начале сессии. Запись обновляет файл сразу, но уже созданный снимок системного контекста не заменяется посреди беседы; новая сессия получает обновлённый текст. При переполнении лимита память нужно уплотнить или удалить устаревшее: автоматическое безграничное расширение не обещано.

«Самообучение» здесь означает накопление памяти и процедурных навыков, а не автоматическое изменение весов языковой модели. Успешный ответ ещё не доказывает, что навык сохранён или что процедура верна: проверьте файл навыка и повторите задачу с заданным критерием качества.

Запись памяти по умолчанию не требует подтверждения: memory.write_approval: false. Если нужен контроль каждой записи, включите:

hermes config set memory.write_approval true

В интерактивном CLI запрос можно подтвердить сразу; в других контекстах запись может попасть в очередь. В чате используйте /memory pending, /memory approve <id> и /memory reject <id>. Не переносите это правило автоматически на AGENTS.md, навыки и любые другие файлы: у них собственные механизмы защиты. Проверяйте сторонние инструкции до установки.

Завершённые незакреплённые сессии без активности 90 дней автоматически очищаются при запуске; открытые и закреплённые защищены. Если нужен более длинный архив, заранее отключите sessions.auto_prune и настройте резервное копирование. Старые режимы сброса по времени простоя и дням убраны: новую беседу начинайте через /new или /reset.

Для cron-задач continuity=true переносит предыдущий содержательный вывод в следующий запуск, а context_from подключает результат другой задачи. Это явная передача контекста, не бесконечная общая сессия. Отдельно задаются доставка и возможность продолжить разговор ответом на отчёт.

Curator: проверка перед изменением

Справочник CLI описывает Curator — механизм пересмотра накопленных материалов. Сначала получите состояние и предварительный результат:

hermes curator status
hermes curator run --dry-run

--dry-run не применяет изменения. Обычный hermes curator run запускает пересмотр с моделью и может менять материалы и расходовать токены. Перед ним проверьте резервную копию и доступные команды backup, rollback, pause, resume и pin. Первая запланированная проверка откладывается на семь дней, а не выполняется сразу при первом старте.

Профили, Bot Mode и взаимодействие агентов

Профиль — отдельный набор конфигурации, памяти, навыков и сессий Hermes, но не обязательно отдельный системный процесс. Файлы профилей размещаются внутри ~/.hermes/profiles/. Внутри активной сессии путь к домашнему каталогу профиля следует брать из $HERMES_HOME: жёстко заданный ~/.hermes может обратиться к основному профилю вместо активного.

В настольном приложении доступен режим ботов (Bot Mode). Профили можно представить как именованных ботов, объединять в групповые комнаты и обращаться к конкретному участнику через упоминание. Команда hermes peer регистрирует удалённые gateway и отправляет сообщения в канонические чаты их ботов. Именованный профиль удалённого узла адресуется как <peer>/<agent>. Для профилей одного хоста используется общий backend; не устанавливайте по отдельному gateway-демону для каждой роли.

Практическая схема команды может выглядеть так:

• исследователь собирает и проверяет источники;
• программист получает результаты через межагентное сообщение и вносит изменения;
• редактор готовит итоговый документ;
• cron-задача повторяет процесс по расписанию и учитывает предыдущий выпуск.

Для короткой параллельной работы используется делегирование субагентам. Работающими субагентами можно управлять: просматривать список дочерних процессов, передавать уточнение во время выполнения и досрочно останавливать их с сохранением частичного результата. Для долгих процессов выбирайте профили и расписания с отдельными рабочими областями и лимитами. Не запускайте два независимых агента, записывающих память в один $HERMES_HOME. Локальные инструменты по умолчанию могут видеть обычный HOME системного пользователя: профили не заменяют Docker, отдельного пользователя или удалённую песочницу. Конфигурация среды.

Основные команды

Основные файлы

~/.hermes/
├── config.yaml       # Настройки, не содержащие секретов
├── .env              # API-ключи и другие секреты
├── auth.json         # OAuth-токены и пулы учётных данных
├── memories/         # MEMORY.md и USER.md
├── plugins/          # Установленные расширения
├── state.db          # Каноническое хранилище сессий SQLite + FTS5
├── sessions/         # Маршрутизация, дампы запросов и JSONL-транскрипты
├── skills/           # Установленные навыки
├── profiles/         # Раздельные данные профилей
├── logs/             # Журналы шлюза и ошибок
├── skins/            # Пользовательские темы
├── desktop-plugins/  # Расширения интерфейса desktop
└── tui-widgets/      # Виджеты терминального интерфейса

Для простой настройки используйте hermes config set КЛЮЧ ЗНАЧЕНИЕ; сложные структуры, включая MCP, можно редактировать в config.yaml по документированной схеме. Секреты храните в .env или подходящем хранилище, а не в репозитории. auth.json и архив hermes backup также могут содержать учётные данные. Для SQLite используйте штатную резервную копию, а не копирование одного state.db во время записи. Справочник команд.

Полезные сценарии

Личный агент в нескольких интерфейсах

Настройте модель через hermes setup, проверьте установку командой hermes doctor, затем используйте тот же профиль в CLI, desktop или подключённом мессенджере. Внутри этого профиля история и память остаются частью общего агентного контура. Проверка: запрос из нужного интерфейса виден в истории этого профиля; новый сеанс загружает ожидаемые файлы памяти.

Ограничение: раздельные данные профилей не изолируют команды от хоста; настройки доступа проверяются отдельно.

Команда специализированных ботов

Создайте отдельные профили для исследования, программирования и редактуры, подключите их к Bot Mode и передавайте результаты через канонические чаты ботов; для другого хоста настройте hermes peer. Результат: сообщения появляются в канонических чатах соответствующих ботов и остаются доступными для проверки.

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

Плановый мониторинг с памятью

Настройте повторяющуюся cron-задачу, включите непрерывность между запусками и доставку результата в нужный канал. Результат: новый запуск получает предыдущий вывод и может не отправлять повторно уже обработанные элементы.

Ограничение: точный синтаксис расписания проверяйте в документации установленной версии.

OpenAI-совместимый доступ для другого приложения

Проверьте hermes proxy providers и hermes proxy status, затем запустите hermes proxy start для поддерживаемого OAuth-провайдера и укажите локальный адрес в совместимом клиенте. Документация прокси определяет поддерживаемые upstream-провайдеры; наличие произвольного API-ключа в Hermes недостаточно. Проверка: клиент получает ответ через локальный сервер, а журнал показывает ожидаемого провайдера.

Ограничение: прокси должен быть доступен только доверенным локальным приложениям.

Проверка установки и ответа

Для первичной проверки используйте:

hermes doctor
hermes chat --oneshot -q "Проверка связи"

hermes doctor выполняет проверку состояния установки, а hermes chat --oneshot -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 подходит для персональных и командных агентных контуров, где нужны постоянная память, специализированные роли и повторяемые процессы.

Следующий шаг

Для установки и первоначальной настройки используйте руководство Hermes Agent — установка и быстрый старт.

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

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov