Profil-System und Distributionen
Wir können Hermes verwenden, ummehrere unabhängige Agentenzu erstellen — einen zum Schreiben von Code, einen für den Betrieb, einen für die Forschung.
Dieses Kapitel erklärt, wie das Profil-System mehrere vollständig isolierte Agent-Instanzen auf einer Maschine ausführt und wie man einen gesamten Agenten als Distribution paketiert, um ihn mit anderen zu teilen.
Profil-System: eine Maschine, mehrere unabhängige Agenten
Was ist ein Profil
Ein Profil ist ein eigenständiges Hermes-Home-Verzeichnis. Jedes Profil hat seine eigene vollständig isolierte Konfiguration und Daten:
~/.hermes/profiles/<name>/ ├── config.yaml # 模型、工具、终端后端等所有设置 ├── .env # API Key、Bot Token(各档案各自独立) ├── SOUL.md # Agent 人格与身份设定 ├── memories/ # 独立的持久记忆(MEMORY.md、USER.md) ├── skills/ # 独立的技能目录 ├── cron/ # 独立的定时任务 └── state.db # 独立的会话历史数据库
Schlüsseldesign: Nach dem Erstellen eines Profils wird es automatisch ein unabhängiger Befehl. Erstellen Sie ein Profil namens coder und Sie haben sofortcoder chat、coder setup、coder gateway startund alle Unterbefehle – genau wie eine vollständig unabhängige Hermes-Instanz installiert zu haben.
Schnellstart
Erstelle einen unabhängigen Coding-Assistenten in drei Schritten:
Beispiel
hermes profile create coder
# Schritt 2: API-Schlüssel und Modell dieses Profils konfigurieren
coder setup
# Schritt 3: Chat starten
coder chat
Drei Erstellungsmodi
Beispiel
hermes profile create mybot
# Modus 2: Konfiguration klonen (config.yaml + .env + SOUL.md + skills,
# Speicher und Sitzungen werden nicht kopiert)
hermes profile create work --clone
# Modus 3: Vollständiger Klon (einschließlich Speicher, Fähigkeiten, geplante Aufgaben, Plugins,
# (ohne Sitzungsverlauf)
hermes profile create backup --clone-all
# Klonen von angegebenem Profil
hermes profile create work-backup --clone-from coder --clone-all
| Mode | Inhalt kopieren | Inhalt nicht kopieren | Anwendbare Szenarien |
|---|---|---|---|
| Neu (Standard) | Nur integrierte Fähigkeiten | — | Neuen Agenten von Grund auf konfigurieren |
| --clone | Konfiguration, Umgebungsvariablen, Persona, Fähigkeiten | Gedächtnis, Sitzungsverlauf | Verschiedene Varianten desselben Agenten |
| --clone-all | Konfiguration, Gedächtnis, Fähigkeiten, geplante Aufgaben, Plugins | Konversationsverlauf | Vollständiges Backup |
Wechseln und Verwenden von Profilen
Beispiel
coder chat
coder gateway start
coder skills list
coder config set model.default anthropic/claude-sonnet-4-6
# Methode 2: Das -p-Flag explizit angeben
hermes -p coder chat
hermes --profile=coder doctor
hermes chat -p coder -q Hallo
# Methode 3: Aktuellen Standard festlegen (ähnlich wie kubectl config use-context)
hermes profile use coder # Danach wird beim direkten Ausführen von hermes coder verwendet
hermes profile use default # Auf Default zurücksetzen
Ermittle, in welchem Profil du dich gerade befindest:
- Anzeige der Eingabeaufforderung
coder ❯(statt des üblichen❯) - Anzeige des Startbanners
Profile: coder - Führen Sie
hermes profileAktuellen Profilnamen, Pfad, Modell, Gateway-Status anzeigen
Unterschiede zwischen Profil, Arbeitsverzeichnis und Sandbox
Dies sind die drei am leichtesten zu verwechselnden Konzepte:
| Konzepte | Kontrolliert | Konfigurationsmethode |
|---|---|---|
| Profil | Hermes’ eigener Status (Konfiguration, Gedächtnis, Fähigkeiten, Sitzungen) | hermes profile create |
| Arbeitsverzeichnis | Wo Terminalbefehle mit der Ausführung beginnen | terminal.cwd |
| Sandbox | Einschränkung des Dateisystemzugriffsbereichs | Terminal-Backend (docker/modal, usw.) |
Ein Profil ist keine Sandbox – mit dem standardmäßigen lokalen Backend hat der Agent weiterhin dieselben Dateisystemberechtigungen wie du. Wenn du den Zugriffsbereich einschränken musst, wechsle das Terminal-Backend (siehe Kapitel 05).
Ein Profil immer von einem bestimmten Verzeichnis aus mit der Arbeit beginnen lassen:
Beispiel
# coder-Profil so festlegen, dass es vom Projektverzeichnis aus startet
terminal:
backend: local
cwd: /absolute/path/to/project
Multi-Profil-Gateway: Jeder Agent verbindet sich mit einer anderen Plattform
Jedes Profil führt seinen eigenen unabhängigen Gateway-Prozess aus und verwendet sein eigenes Bot-Token:
Beispiel
coder gateway start # Telegram-Bot an coder gebunden
assistant gateway start # Verschiedene Bots binden
# Als persistenten Systemdienst installieren
coder gateway install # systemd-Dienst hermes-gateway-coder erstellen
assistant gateway install # den Dienst hermes-gateway-assistant erstellen
Sicherheitsschutz: Wenn zwei Profile versehentlich dasselbe Bot-Token verwenden, meldet das zweite Gateway sofort einen Fehler und gibt den Namen des in Konflikt stehenden Profils an, sodass kein stiller Konflikt auftritt.
Befehle zur Profilverwaltung
Beispiel
hermes profile list
# Detaillierte Informationen eines Profils anzeigen
hermes profile show coder
# Umbenennen (Aliase und Dienste automatisch aktualisieren)
hermes profile rename coder dev-bot
# Exportieren als coder.tar.gz
hermes profile export coder
# Aus Archiv importieren
hermes profile import coder.tar.gz
# Löschen (Namen zur Bestätigung eingeben)
hermes profile delete coder
# Bestätigung überspringen und direkt löschen
hermes profile delete coder --yes
Das Standardprofil (~/.hermes) kann nicht gelöscht werden. Um vollständig zu deinstallieren, verwenden Sie hermes uninstall.
Profilverteilung: einen gesamten Agenten mit anderen teilen
Profilverteilung verpackt einen vollständigen Hermes-Agenten – Persona-Einstellungen, Fähigkeiten, geplante Aufgaben, MCP-Verbindungen, Konfiguration – in ein Git-Repository.
Jeder kann den gesamten Agenten mit einem einzigen Befehl installieren und Ihre Updates erhalten, während er seine eigenen Erinnerungen, Sitzungen und API-Schlüssel behält.
Verteilung vs. Profil-Backup
| Dimension | Distribution | Backup (Export/Import) |
|---|---|---|
| Zielgruppe | Andere (Team, Community) | Sie selbst (Migration zwischen Rechnern) |
| Installationsmethode | hermes profile install github.com/... | hermes profile import xxx.tar.gz |
| Versionsverwaltung | Git-Repository + Tags | Keine |
| Update | hermes profile update | Manueller Re-Export und Import |
| API-Schlüssel | Empfänger konfiguriert es selbst | Im Export enthalten |
Für Distributionen geeignete Szenarien
- Spezialisierte Agenten an Teams verteilen (Compliance-Überwachung, Code-Review, Recherche)
- Denselben Agenten auf mehreren Maschinen bereitstellen, ohne Dateien manuell zu kopieren
- Den Agenten kontinuierlich weiterentwickeln, sodass Empfänger die neueste Version mit einem Befehl erhalten
- Agenten als Produkte an die Community verteilen
Distributionen erstellen und veröffentlichen
Schritt 1: Zu einem bestehenden Profil hinzufügendistribution.yaml:
Beispiel
name: research-bot
version: 1.0.0
description: "Autonomer Recherche-Assistent, der arXiv und Web-Tools integriert."
hermes_requires: ">=0.12.0"
author: "Ihr Name"
license: "MIT"
# Deklariere Umgebungsvariablen, die der Empfänger konfigurieren muss
env_requires:
- name: OPENAI_API_KEY
description: "OpenAI API-Schlüssel (für Modellzugriff)"
required: true
- name: SERPAPI_KEY
description: "SerpAPI-Schlüssel (für Websuche)"
required: false
default: ""
Schritt 2: Push in ein Git-Repository:
Beispiel
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 und auth.json werden automatisch ausgeschlossen – API-Schlüssel gelangen nicht ins Repository. Speicher- und Sitzungsverlauf sind ebenfalls nicht enthalten.
Distributionen installieren und aktualisieren
Beispiel
hermes profile install github.com/you/research-bot --alias
# API-Schlüssel nach der Installation konfigurieren
nano ~/.hermes/profiles/research-bot/.env
# Auf die neueste Version aktualisieren (Speicher und Konversationen beibehalten)
hermes profile update research-bot
Kurzreferenz für gängige Befehle
Beispiel
hermes profile create <name> # Neu erstellen
hermes profile create <name> --clone # Konfiguration klonen
hermes profile create <name> --clone-all # Vollständiger Klon
hermes profile create <name> --clone-from <src> # Von angegebenem Profil klonen
hermes profile list # Alle auflisten
hermes profile show <name> # Details anzeigen
hermes profile use <name> # Als Standard festlegen
hermes profile rename <old> <new> # Umbenennen
hermes profile export <name> # Backup exportieren
hermes profile import <file> # Backup importieren
hermes profile delete <name> # Löschen
# Profil-Befehlsaliase (nach der Erstellung automatisch verfügbar).
<name> chat / setup / gateway start / skills list / doctor
# ─── Release ──────────────────────────────────────────────────
hermes profile install github.com/user/repo --alias # Installieren
hermes profile update <name> # Aktualisieren