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

# Schritt 1: Erstelle ein Profil, generiere automatisch den coder-Befehl
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

# Modus 1: Ganz neues Profil (leere Konfiguration, integrierte Skills vorgeladen)
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
ModeInhalt kopierenInhalt nicht kopierenAnwendbare Szenarien
Neu (Standard)Nur integrierte Fähigkeiten—Neuen Agenten von Grund auf konfigurieren
--cloneKonfiguration, Umgebungsvariablen, Persona, FähigkeitenGedächtnis, SitzungsverlaufVerschiedene Varianten desselben Agenten
--clone-allKonfiguration, Gedächtnis, Fähigkeiten, geplante Aufgaben, PluginsKonversationsverlaufVollständiges Backup

Wechseln und Verwenden von Profilen

Beispiel

# Methode 1: Verwenden automatisch generierter Befehlsaliase (am häufigsten)
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 Eingabeaufforderungcoder ❯(statt des üblichen❯)
  • Anzeige des StartbannersProfile: coder
  • Führen Siehermes profileAktuellen Profilnamen, Pfad, Modell, Gateway-Status anzeigen

Unterschiede zwischen Profil, Arbeitsverzeichnis und Sandbox

Dies sind die drei am leichtesten zu verwechselnden Konzepte:

KonzepteKontrolliertKonfigurationsmethode
ProfilHermes’ eigener Status (Konfiguration, Gedächtnis, Fähigkeiten, Sitzungen)hermes profile create
ArbeitsverzeichnisWo Terminalbefehle mit der Ausführung beginnenterminal.cwd
SandboxEinschränkung des DateisystemzugriffsbereichsTerminal-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

# Dateipfad: ~/.hermes/config.yaml
# 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

# Unabhängige Gateways starten
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

# Alle Profile und Status auflisten
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

DimensionDistributionBackup (Export/Import)
ZielgruppeAndere (Team, Community)Sie selbst (Migration zwischen Rechnern)
Installationsmethodehermes profile install github.com/...hermes profile import xxx.tar.gz
VersionsverwaltungGit-Repository + TagsKeine
Updatehermes profile updateManueller Re-Export und Import
API-SchlüsselEmpfänger konfiguriert es selbstIm 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

# Dateipfad:~/.hermes/profiles/research-bot/distribution.yaml
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

Profilverzeichnis aufrufen und ein Git-Repository initialisieren
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

# Installation (--alias erstellt einen Befehl mit demselben Namen, z. B. research-bot chat)
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

# ─── Profile verwalten ───────────────────────────────────────────
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
Weitere Erweiterungen