Система профилей и дистрибутивы

Мы можем использовать 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.

Быстрый старт

Создайте независимого помощника по программированию за три шага:

Пример

# Шаг 1: Создайте профиль, автоматически сгенерируйте команду coder
hermes profile create coder

# Шаг 2: Настройте ключ API и модель этого профиля
coder setup

# Шаг 3: Начните чат
coder chat

Три режима создания

Пример

# Режим 1: Совершенно новый профиль (пустой config, встроенные skills предзагружены)
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конфигурация, память, навыки, запланированные задачи, плагиныИстория диалогаПолное резервное копирование

Переключение и использование профилей

Пример

# Способ 1: использование автоматически созданных псевдонимов команд (наиболее распространённый)
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).

Сделайте так, чтобы профиль всегда начинал работу из определённого каталога:

Пример

# Путь к файлу: ~/.hermes/config.yaml
# Закрепить профиль 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-репозиторий + тегиОтсутствует
Updatehermes profile updateРучной повторный экспорт и импорт
Ключ APIПолучатель настраивает его самостоятельноВключено в экспорт

Сценарии, подходящие для дистрибутивов

  • Распространяйте специализированных агентов по командам (мониторинг соответствия, проверка кода, исследовательские ассистенты)
  • Разверните одного и того же агента на нескольких машинах без ручного копирования файлов
  • Непрерывно дорабатывайте агента, позволяя получателям получать последнюю версию одной командой
  • Распространяйте агентов среди сообщества как продукты

Создание и публикация дистрибутивов

Шаг 1: Добавить в существующий профильdistribution.yaml:

Пример

# Путь к файлу:~/.hermes/profiles/research-bot/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:

Пример

Перейдите в каталог Profile и инициализируйте репозиторий 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-ключи не попадут в репозиторий. Память и история сессий также не включаются.

Установка и обновление дистрибутивов

Пример

# Установка (--alias создаёт команду с таким же именем, например, research-bot chat)
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
Другие расширения