Système de profils et distributions
Nous pouvons utiliser Hermes pour créerplusieurs agents indépendants—un pour écrire du code, un pour les opérations, un pour la recherche.
Ce chapitre explique comment le système de profils exécute plusieurs instances d’agent totalement isolées sur une même machine, et comment empaqueter un agent entier sous forme de distribution à partager avec d’autres.
Système de profils : une seule machine, plusieurs agents indépendants
Qu’est-ce qu’un profil ?
Un profil est un répertoire personnel Hermes autonome. Chaque profil dispose de sa propre configuration et de ses propres données totalement isolées :
~/.hermes/profiles/<name>/ ├── config.yaml # 模型、工具、终端后端等所有设置 ├── .env # API Key、Bot Token(各档案各自独立) ├── SOUL.md # Agent 人格与身份设定 ├── memories/ # 独立的持久记忆(MEMORY.md、USER.md) ├── skills/ # 独立的技能目录 ├── cron/ # 独立的定时任务 └── state.db # 独立的会话历史数据库
Conception clé: Après avoir créé un profil, il devient automatiquement une commande indépendante. Créez un profil nommé coder et vous avez immédiatementcoder chat、coder setup、coder gateway startet toutes les sous-commandes — comme si vous disposiez d'une instance Hermes complètement indépendante installée.
Démarrage rapide
Créez un assistant de codage indépendant en trois étapes :
Exemple
hermes profile create coder
# Étape 2 : Configurer la clé API et le modèle de ce profil
coder setup
# Étape 3 : Commencer à discuter
coder chat
Trois modes de création
Exemple
hermes profile create mybot
# Mode 2 : Cloner la configuration (config.yaml + .env + SOUL.md + compétences,
# La mémoire et les sessions ne sont pas copiées)
hermes profile create work --clone
# Mode 3 : clonage complet (y compris la mémoire, les compétences, les tâches planifiées, les plugins,
# (à l'exclusion de l'historique des sessions)
hermes profile create backup --clone-all
# Cloner depuis le profil spécifié
hermes profile create work-backup --clone-from coder --clone-all
| Mode | Copier le contenu | Ne pas copier le contenu | Scénarios applicables |
|---|---|---|---|
| Nouveau (par défaut) | Uniquement les compétences intégrées | — | Configurer un nouvel agent à partir de zéro |
| --clone | Configuration, variables d'environnement, persona, compétences | Mémoire, historique de session | Différentes variantes du même Agent |
| --clone-all | configuration, mémoire, compétences, tâches planifiées, plugins | Historique de conversation | Sauvegarde complète |
Basculer et utiliser les profils
Exemple
coder chat
coder gateway start
coder skills list
coder config set model.default anthropic/claude-sonnet-4-6
# Méthode 2 : spécifier explicitement l'option -p
hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q Bonjour
# Méthode 3 : définir le profil par défaut actuel (similaire à kubectl config use-context)
hermes profile use coder # Après cela, exécuter hermes directement utilisera coder
hermes profile use default # Revenir à Default
Déterminer dans quel profil vous êtes actuellement :
- Affichage de l'invite de commande
coder ❯(plutôt que l'habituel❯) - Affichage de la bannière de démarrage
Profile: coder - Exécutez
hermes profileAfficher le nom du profil actuel, le chemin, le modèle, l'état de la passerelle
Différences entre profil, répertoire de travail et bac à sable
Ce sont les trois concepts les plus souvent confondus :
| Concepts | Contenu contrôlé | Méthode de configuration |
|---|---|---|
| Profil | L'état propre d'Hermes (configuration, mémoire, compétences, sessions) | hermes profile create |
| Répertoire de travail | Où les commandes du terminal commencent à s'exécuter | terminal.cwd |
| Bac à sable | Restriction de la portée d'accès au système de fichiers | Backend de terminal (docker/modal, etc.) |
Un profil n'est pas un bac à sable — avec le backend local par défaut, l'Agent dispose toujours des mêmes permissions d'accès au système de fichiers que vous. Si vous devez restreindre la portée d'accès, changez de backend de terminal (voir chapitre 05).
Faire en sorte qu'un profil commence toujours à travailler depuis un répertoire spécifique :
Exemple
# Épingler le profil coder pour qu'il démarre depuis le répertoire du projet
terminal:
backend: local
cwd: /absolute/path/to/project
Passerelle multi-profils : chaque Agent se connecte à une plateforme différente
Chaque Profil exécute son propre processus de passerelle indépendant, en utilisant son propre jeton de bot :
Exemple
coder gateway start # Bot Telegram lié à coder
assistant gateway start # Associer différents bots
# Installer comme service système persistant
coder gateway install # Créer le service systemd hermes-gateway-coder
assistant gateway install # Créer le service hermes-gateway-assistant
Protection de sécurité : si deux Profils utilisent accidentellement le même jeton de bot, la seconde passerelle signalera immédiatement une erreur et indiquera le nom du Profil en conflit, afin qu'aucun conflit silencieux ne se produise.
Commandes de gestion des profils
Exemple
hermes profile list
# Afficher les informations détaillées d'un profil
hermes profile show coder
# Renommer (mettre à jour automatiquement les alias et les services)
hermes profile rename coder dev-bot
# Exporter sous coder.tar.gz
hermes profile export coder
# Importer depuis une archive
hermes profile import coder.tar.gz
# Supprimer (saisir le nom pour confirmer)
hermes profile delete coder
# Ignorer la confirmation et supprimer directement
hermes profile delete coder --yes
Impossible de supprimer le profil par défaut (~/.hermes). Pour désinstaller complètement, utilisez hermes uninstall.
Distribution de profil : partager un Agent entier avec d'autres
Distribution de profil empaquette un Agent Hermes complet—paramètres de persona, compétences, tâches planifiées, connexions MCP, configuration—dans un dépôt Git.
N'importe qui peut installer l'Agent entier avec une seule commande, et recevoir vos mises à jour tout en conservant ses propres mémoires, sessions et clé API.
Distribution vs sauvegarde de profil
| Dimension | Distribution | Sauvegarde (export/import) |
|---|---|---|
| Public cible | Autres (équipe, communauté) | Vous-même (migration entre machines) |
| Méthode d'installation | hermes profile install github.com/... | hermes profile import xxx.tar.gz |
| Gestion des versions | Dépôt Git + tags | Aucune |
| Update | hermes profile update | Réexportation et importation manuels |
| Clé API | Le destinataire le configure lui-même | Inclus dans l'export |
Scénarios adaptés aux distributions
- Distribuer des Agents spécialisés aux équipes (surveillance de la conformité, revue de code, assistants de recherche)
- Déployer le même Agent sur plusieurs machines sans copier manuellement les fichiers
- Itérer en continu sur l'Agent, permettant aux destinataires d'obtenir la dernière version avec une seule commande
- Distribuer des Agents à la communauté en tant que produits
Création et publication de distributions
Étape 1 : Ajouter à un Profil existantdistribution.yaml:
Exemple
name: research-bot
version: 1.0.0
description: "Assistant de recherche autonome, intégrant arXiv et des outils web."
hermes_requires: ">=0.12.0"
author: "Votre nom"
license: "MIT"
# Déclarer les variables d'environnement que le récepteur doit configurer
env_requires:
- name: OPENAI_API_KEY
description: "Clé API OpenAI (pour l'accès au modèle)"
required: true
- name: SERPAPI_KEY
description: "Clé SerpAPI (pour la recherche web)"
required: false
default: ""
Étape 2 : Pousser vers un dépôt Git :
Exemple
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 et auth.json sont automatiquement exclus—les clés API n'entreront pas dans le dépôt. La mémoire et l'historique de session ne sont pas inclus non plus.
Installation et mise à jour des distributions
Exemple
hermes profile install github.com/you/research-bot --alias
# Configurer la clé API après l'installation
nano ~/.hermes/profiles/research-bot/.env
# Mettre à jour vers la dernière version (préserver votre mémoire et vos conversations)
hermes profile update research-bot
Référence rapide des commandes courantes
Exemple
hermes profile create <name> # Créer un nouveau
hermes profile create <name> --clone # Cloner la configuration
hermes profile create <name> --clone-all # Clone complet
hermes profile create <name> --clone-from <src> # Cloner depuis le profil spécifié
hermes profile list # Tout lister
hermes profile show <name> # Voir les détails
hermes profile use <name> # Définir par défaut
hermes profile rename <old> <new> # Renommer
hermes profile export <name> # Exporter la sauvegarde
hermes profile import <file> # Importer la sauvegarde
hermes profile delete <name> # Supprimer
# Alias de commandes de profil (automatiquement disponibles après la création).
<name> chat / setup / gateway start / skills list / doctor
# ─── Version ──────────────────────────────────────────────────
hermes profile install github.com/user/repo --alias # Installer
hermes profile update <name> # Update