Система профилей и дистрибутивы
Мы можем использовать Hermes, чтобы создаватьНесколько независимых агентов—один для написания кода, один для операций, один для исследований.
В этой главе объясняется, как система профилей запускает несколько полностью изолированных экземпляров агентов на одной машине и как упаковать целого агента в дистрибутив, чтобы поделиться с другими.
Система профилей: одна машина, несколько независимых агентов
Что такое профиль
Профиль — это отдельный домашний каталог Hermes. Каждый профиль имеет собственную полностью изолированную конфигурацию и данные:
~/.hermes/profiles/<name>/ ├── config.yaml # 模型、工具、终端后端等所有设置 ├── .env # API Key、Bot Token(各档案各自独立) ├── SOUL.md # Agent 人格与身份设定 ├── memories/ # 独立的持久记忆(MEMORY.md、USER.md) ├── skills/ # 独立的技能目录 ├── cron/ # 独立的定时任务 └── state.db # 独立的会话历史数据库
Ключевое решение: После создания профиля он автоматически становится независимой командой. Создайте профиль с именем coder, и вы сразу получитеcoder chat、coder setup、coder gateway startи все подкоманды — совсем как если бы у вас был установлен полностью независимый экземпляр Hermes.
Быстрый старт
Создайте независимого помощника по программированию за три шага:
Пример
hermes profile create coder
# Шаг 2: Настройте ключ API и модель этого профиля
coder setup
# Шаг 3: Начните чат
coder chat
Три режима создания
Пример
hermes profile create mybot
# Режим 2: Клонирование конфигурации (config.yaml + .env + SOUL.md + skills,
# Память и сессии не копируются)
hermes profile create work --clone
# Режим 3: Полное клонирование (включая память, навыки, запланированные задачи, плагины,
# (исключая историю сессий)
hermes profile create backup --clone-all
# Клонировать из указанного профиля
hermes profile create work-backup --clone-from coder --clone-all
| Mode | Копировать содержимое | Не копировать содержимое | Применимые сценарии |
|---|---|---|---|
| Новый (по умолчанию) | Только встроенные навыки | — | Настроить нового агента с нуля |
| --clone | Конфигурация, переменные среды, персона, навыки | Память, история сессий | Различные варианты одного и того же агента |
| --clone-all | конфигурация, память, навыки, запланированные задачи, плагины | История диалога | Полное резервное копирование |
Переключение и использование профилей
Пример
coder chat
coder gateway start
coder skills list
coder config set model.default anthropic/claude-sonnet-4-6
# Способ 2: Явно указать флаг -p
hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q Привет
# Способ 3: Установить текущее значение по умолчанию (аналогично kubectl config use-context)
hermes profile use coder # После этого запуск hermes напрямую будет использовать coder
hermes profile use default # Вернуться к Default
Определите, в каком профиле вы сейчас находитесь:
- Отображение в приглашении командной строки
coder ❯(вместо обычного❯) - Отображение стартового баннера
Profile: coder - Запустите
hermes profileПросмотр текущего имени профиля, пути, модели, статуса шлюза
Различия между профилем, рабочим каталогом и песочницей
Это три наиболее часто путаемых понятия:
| Концепции | Контролируемое содержимое | Способ настройки |
|---|---|---|
| Профиль | Собственный статус Hermes (конфигурация, память, навыки, сессии) | hermes profile create |
| Рабочий каталог | Где начинают выполняться команды терминала | terminal.cwd |
| Песочница | Ограничение области доступа к файловой системе | Терминальный бэкенд (docker/modal и т. д.) |
Профиль — это не песочница: при локальном бэкенде по умолчанию Агент всё ещё имеет те же права доступа к файловой системе, что и вы. Если нужно ограничить область доступа, переключите терминальный бэкенд (см. главу 05).
Сделайте так, чтобы профиль всегда начинал работу из определённого каталога:
Пример
# Закрепить профиль coder для запуска из каталога проекта
terminal:
backend: local
cwd: /absolute/path/to/project
Мультипрофильный шлюз: каждый агент подключается к другой платформе
Каждый профиль запускает собственный независимый процесс шлюза, используя свой токен бота:
Пример
coder gateway start # Telegram-бот привязан к coder
assistant gateway start # Привязка разных ботов
# Установить как постоянную системную службу
coder gateway install # Создать службу systemd hermes-gateway-coder
assistant gateway install # Создать службу hermes-gateway-assistant
Защита безопасности: если два профиля случайно используют один и тот же токен бота, второй шлюз немедленно сообщит об ошибке и укажет имя конфликтующего профиля, поэтому скрытый конфликт не возникнет.
Команды управления профилями
Пример
hermes profile list
# Просмотр подробной информации о профиле
hermes profile show coder
# Переименовать (автоматически обновить псевдонимы и службы)
hermes profile rename coder dev-bot
# Экспортировать как coder.tar.gz
hermes profile export coder
# Импортировать из архива
hermes profile import coder.tar.gz
# Удалить (введите имя для подтверждения)
hermes profile delete coder
# Пропустить подтверждение и удалить сразу
hermes profile delete coder --yes
Невозможно удалить профиль по умолчанию (~/.hermes). Чтобы полностью удалить, используйте hermes uninstall.
Распространение профиля: поделитесь всем агентом с другими
Распространение профиля упаковывает полноценного Hermes-агента — настройки персоны, навыки, запланированные задачи, MCP-подключения, конфигурацию — в Git-репозиторий.
Любой может установить всего агента одной командой и получать ваши обновления, сохраняя свои собственные воспоминания, сессии и API-ключ.
Распространение vs резервное копирование профиля
| Измерение | Дистрибутив | Резервное копирование (экспорт/импорт) |
|---|---|---|
| Целевая аудитория | Другие (команда, сообщество) | Для себя (миграция между машинами) |
| Способ установки | hermes profile install github.com/... | hermes profile import xxx.tar.gz |
| Управление версиями | Git-репозиторий + теги | Отсутствует |
| Update | hermes profile update | Ручной повторный экспорт и импорт |
| Ключ API | Получатель настраивает его самостоятельно | Включено в экспорт |
Сценарии, подходящие для дистрибутивов
- Распространяйте специализированных агентов по командам (мониторинг соответствия, проверка кода, исследовательские ассистенты)
- Разверните одного и того же агента на нескольких машинах без ручного копирования файлов
- Непрерывно дорабатывайте агента, позволяя получателям получать последнюю версию одной командой
- Распространяйте агентов среди сообщества как продукты
Создание и публикация дистрибутивов
Шаг 1: Добавить в существующий профильdistribution.yaml:
Пример
name: research-bot
version: 1.0.0
description: "Автономный помощник по исследованиям, интегрирующий arXiv и веб-инструменты."
hermes_requires: ">=0.12.0"
author: "Ваше имя"
license: "MIT"
# Объявите переменные окружения, которые должен настроить получатель
env_requires:
- name: OPENAI_API_KEY
description: "Ключ API OpenAI (для доступа к модели)"
required: true
- name: SERPAPI_KEY
description: "Ключ SerpAPI (для веб-поиска)"
required: false
default: ""
Шаг 2: Отправка в репозиторий Git:
Пример
cd ~/.hermes/profiles/research-bot
git init
git add .
git commit -m "v1.0.0"
git remote add origin git@github.com:you/research-bot.git
git tag v1.0.0
git push -u origin main --tags
.env и auth.json автоматически исключаются — API-ключи не попадут в репозиторий. Память и история сессий также не включаются.
Установка и обновление дистрибутивов
Пример
hermes profile install github.com/you/research-bot --alias
# Настройка API-ключа после установки
nano ~/.hermes/profiles/research-bot/.env
# Обновление до последней версии (сохраните вашу память и разговоры)
hermes profile update research-bot
Краткий справочник по основным командам
Пример
hermes profile create <name> # Создать новый
hermes profile create <name> --clone # Клонировать конфигурацию
hermes profile create <name> --clone-all # Полное клонирование
hermes profile create <name> --clone-from <src> # Клонировать из указанного профиля
hermes profile list # Показать все
hermes profile show <name> # Просмотреть сведения
hermes profile use <name> # Сделать по умолчанию
hermes profile rename <old> <new> # Переименовать
hermes profile export <name> # Экспортировать резервную копию
hermes profile import <file> # Импортировать резервную копию
hermes profile delete <name> # Удалить
# Псевдонимы команд профиля (автоматически доступны после создания).
<name> chat / setup / gateway start / skills list / doctor
# ─── Релиз ──────────────────────────────────────────────────
hermes profile install github.com/user/repo --alias # Установка
hermes profile update <name> # Update