BoxenwerkMotorsport-Teile
☰
Wie Hermes selbst lernt — und wie du deine erste SOUL.md schreibst
Ein Agent, der sich merkt, was er gelernt hat, und mit dir mitwächst. In diesem Leitfaden verstehst du in einfachen Worten, wie dieses Gedächtnis funktioniert — und schreibst Schritt für Schritt eine eigene SOUL.md, die dem Agenten seine Persönlichkeit gibt.
Du erklärst, wie ein selbstlernender Agent sein Gedächtnis pflegt, und erstellst eine funktionierende SOUL.md für einen eigenen Agenten.
Was heißt „ein Agent, der dazulernt"?
Ein normaler Chatbot vergisst nach jedem Gespräch fast alles. Der Hermes Agent von Nous Research ist anders gebaut: Er führt ein Gedächtnis in einfachen Textdateien, das über Wochen bestehen bleibt. Deshalb sagt Nous Research: „der Agent, der mit dir wächst".
Stell dir einen neuen Mitarbeiter vor, der ein Notizbuch führt: Wer bist du, wie möchtest du es haben, was hat er über die Firma gelernt. Beim nächsten Mal schlägt er nach — und muss nicht bei null anfangen.
Die drei Gedächtnis-Dateien
Das ganze Gedächtnis steckt in drei einfachen Markdown-Dateien. Sie liegen in einem versteckten Ordner namens ~/.hermes/ auf deinem Rechner (bzw. Server).
| Datei | Was steht drin? | Grenze |
|---|---|---|
SOUL.md | Die Persönlichkeit: Wer ist der Agent, wie spricht er, was vermeidet er? | kurz halten |
USER.md | Fakten über dich: Name, Rolle, Zeitzone, wie du kommunizieren möchtest. | ~1.375 Zeichen |
MEMORY.md | Notizen, die der Agent sich selbst macht: Umgebungsfakten, Konventionen, erledigte Aufgaben. | ~2.200 Zeichen |
Kurz gesagt: SOUL = wer der Agent ist, USER = wer du bist, MEMORY = was er sich gemerkt hat.
Wie das System dazulernt
Lernen passiert bei Hermes auf drei Wegen. Du musst nichts programmieren — der Agent nutzt dafür eigene Werkzeuge.
Fällt ihm ein wichtiger Fakt auf, schreibt er ihn in die MEMORY.md.
Einen gelungenen Arbeitsablauf speichert er als wiederverwendbare Anleitung (SKILL.md).
Über session_search findet er alte Gespräche wieder — auch Wochen später.
Die eingebaute Grenze: warum das Gedächtnis klein bleibt
Das Gedächtnis ist absichtlich klein. USER.md darf rund 1.375 Zeichen fassen, MEMORY.md rund 2.200 Zeichen. Das zwingt den Agenten, nur das wirklich Wichtige zu behalten — wie eine Karteikarte, nicht wie ein Aktenschrank.
Es gibt kein automatisches Löschen. Ist die Datei voll, meldet das Speicher-Werkzeug einen Fehler — der Agent muss dann selbst zusammenfassen oder Altes entfernen, bevor er Neues schreibt. Nichts wird still „weggeworfen".
Was ist die SOUL.md genau?
Die SOUL.md ist die Seele deines Agenten — seine Grundpersönlichkeit. Sie beantwortet: Wer bist du? Wie klingst du? Was tust du nicht? Wie handelst du im Zweifel? Sie steht als Allererstes im Kopf des Agenten und färbt jede Antwort.
USER.md und MEMORY.md sind Fakten. Die SOUL.md ist der Charakter. Sie ist die dauerhafte Stimme, die bleibt — egal, worüber ihr gerade sprecht.
Die vier Bausteine einer SOUL.md
Die offizielle Doku empfiehlt vier einfache Abschnitte. Kein Pflichtschema — aber ein guter, anfängerfreundlicher Rahmen.
Vier Stil-Vorlagen zum Abschauen
Die offizielle Doku nennt vier bewährte Charakter-Archetypen. Such dir einen aus, der zu deiner Aufgabe passt — oder misch sie.
Direkt, knapp, ehrlich über Grenzen. Sagt, was geht und was nicht.
Neugierig, trennt sauber zwischen Vermutung und Beleg.
Geduldig, baut vom einfachen Bild zur komplexen Sache auf.
Fair, aber unverblümt; stellt Korrektheit über Höflichkeit.
Mit den Grund-Einstellungen starten → Unpassendes streichen → 4 bis 8 prägende Zeilen ergänzen → im echten Gebrauch nachjustieren. Die wörtlichen Vorlage-Texte stehen in der offiziellen Doku (siehe „Vertrauenswürdige Quellen").
Beispiel: eine fertige SOUL.md
So könnte die SOUL.md für einen Reporting-Agenten bei Boxenwerk GmbH & Co. KG aussehen. Kurz, konkret, prüfbar — genau richtig für den knappen Platz.
Jede Zeile ist eine Verhaltensregel, keine leere Floskel. Der Agent weiß dadurch genau, wie er klingen und was er lassen soll.
Die USER.md — was du über dich hinterlegst
Während die SOUL.md sagt, wer der Agent ist, sagt die USER.md dem Agenten, wer du bist. So muss er nicht jedes Mal neu fragen, wie du arbeitest. Diese Datei pflegst meist du selbst. Platz: rund 1.375 Zeichen.
Was hineingehört:
- Name, Rolle, Standort/Zeitzone
- wie du kommunizieren möchtest (Sprache, Länge, Ton)
- dein Fachlevel (z. B. „kein Technik-Hintergrund")
- deine aktuellen Schwerpunkte
SOUL.md = wer der Agent ist. USER.md = wer du bist. Die USER.md pflegst du selbst und hältst sie kurz.
Die MEMORY.md — was der Agent sich selbst merkt
Die MEMORY.md ist der Notizblock, den der Agent selbst führt: Umgebungsfakten, Konventionen, wo welche Dateien liegen, was schon erledigt ist. Du musst nichts eintragen — aber du darfst jederzeit reinschauen und korrigieren. Platz: rund 2.200 Zeichen, Einträge mit § getrennt.
Ist die Datei voll, wird nichts still gelöscht — der Agent muss selbst aufräumen (siehe Abschnitt „Grenzen & Limits").
USER.md pflegst du, MEMORY.md pflegt der Agent. Beide bleiben kurz — nur Dauerhaftes gehört hinein.
Die AGENTS.md — Ort & Ablauf statt Charakter
Ein häufiger Anfängerfehler ist, alles in die SOUL.md zu packen. Merke dir diese saubere Trennung:
| Was | Wohin |
|---|---|
| Charakter, Ton, dauerhafte Haltung | SOUL.md |
| Projekt-/Ordner-Regeln, Pfade, technische Konventionen | AGENTS.md |
| Kurzfristiger Stimmungswechsel für eine Sitzung | /personality |
SOUL.md = Wer der Agent ist. AGENTS.md = Wo & nach welchen Regeln er in einem Projekt arbeitet. Vermischt man beides, wird die SOUL.md unübersichtlich und die Persönlichkeit unscharf.
Die Verbindung zu AGENTS.md, Arbeitsverzeichnissen und mehreren Profilen zeigt die Seite Hermes Agent · Profile.
Häufige Fehler
Ganze Absätze über „Werte". Besser: wenige konkrete Verhaltenszeilen.
Pfade, Ports, Ordner-Regeln gehören in die AGENTS.md, nicht in die Seele.
Dein Name/Rolle gehört in die USER.md, gelernte Fakten in die MEMORY.md.
Änderungen wirken erst nach dem Start einer neuen Sitzung.
Ohne „Avoid"-Zeilen wiederholt der Agent typische Ärgernisse.
Das Gedächtnis ist klein — nur Dauerhaftes hinein, Wichtiges verdichten.
Best-Practice-Checkliste für deine SOUL.md
Geh das kurz durch, bevor du die Datei speicherst:
[ ] Identity: Rolle in 1-2 Sätzen klar benannt [ ] Style: Ton, Sprache, Emojis-ja/nein festgelegt [ ] Avoid: mindestens 2 konkrete Grenzen [ ] Defaults: Verhalten bei Unklarheit definiert [ ] Nur Charakter — keine Projektregeln, keine Fakten [ ] Kurz gehalten (wenige, prägnante Zeilen) [ ] Nach dem Speichern neue Sitzung gestartet [ ] Im echten Gebrauch getestet und nachgeschärft
Übungen zum Mitmachen
Vier kleine Übungen zu SOUL.md und dem Gedächtnis — ganz ohne Programmieren. Du sollst nichts von Grund auf schreiben, sondern verstehen, zuordnen, entscheiden und einen Wert anpassen.
Jede Übung ist ein eigener Block mit aufklappbarer Lösung. Versuch es erst selbst, dann klapp die Lösung auf. Dein Trainer kann dir auch sagen: „Mach doch mal Übung C."
Übung A · Welche Datei wofür?
Ziel: die drei Gedächtnis-Dateien auseinanderhalten — nur zuordnen, nichts schreiben.
Welcher Inhalt (1–3) gehört in welche Datei (a–c)? Erinnerung: USER.md = was du hinterlegst · MEMORY.md = was der Agent sich selbst merkt · SOUL.md = dein Stil/Charakter.
| Nr. | Inhalt | Datei | |
|---|---|---|---|
| 1 | „Ich bin Marketing-Managerin und arbeite auf Deutsch.“ | → | a) MEMORY.md |
| 2 | „Antworte knapp und ohne Emojis.“ | → | b) USER.md |
| 3 | „Kundin Berger wünscht Rückrufe vormittags.“ (vom Agent gemerkt) | → | c) SOUL.md |
Übung B · Was gehört in DEINE USER.md?
Ziel: den Nutzen auf dich beziehen — reine Denkübung, keine Technik.
Schreib dir drei Dinge auf, die dein Agent dauerhaft über dich wissen sollte:
- deine Rolle / dein Beruf
- deine Sprache und dein bevorzugter Ton
- eine Vorliebe oder Abneigung (z. B. „lieber Stichpunkte als Fließtext“)
Übung C · Gehört das in die SOUL.md?
Ziel: erkennen, dass die SOUL.md nur den Charakter beschreibt — keine Fakten, keine Projektregeln.
Ja oder nein — gehört das in die SOUL.md?
- 1. „Sei freundlich, aber komm schnell auf den Punkt.“
- 2. „Reports gehören in den Ordner Berichte/.“
- 3. „Unsere Firma heißt Boxenwerk GmbH & Co. KG.“
Übung D · Eine Mini-SOUL.md anpassen
Ziel: ein Erfolgserlebnis — du erfindest nichts, du änderst nur eine einzige Zeile.
Hier ist eine fertige Mini-SOUL.md. Kopier sie und ändere nur die Style-Zeile: statt „locker mit Emojis“ soll dein Agent sachlich und ohne Emojis schreiben.
# Identity Du bist mein Marketing-Assistent für Boxenwerk. # Style Locker, motivierend, ruhig mit Emojis. 🎉 # Avoid Kein Fachjargon. Keine langen Vorreden. # Defaults Bei Unklarheit: kurz nachfragen statt raten.
Vertrauenswürdige Quellen
Alle Fakten dieser Seite stammen aus offiziellen Nous-Research-Quellen und seriösen Fachartikeln. Hier kannst du selbst nachlesen:
NousResearch/hermes-agent — Quellcode, README, MIT-Lizenz.
Offizielle Anleitung inkl. der vier Stil-Vorlagen im Wortlaut.
Zeichen-Limits, USER/MEMORY, kein Auto-Löschen, session_search.
Wie der Agent Arbeitsweisen als Skills speichert und wiederverwendet.
Offizielle Ankündigung: „the open source agent that grows with you."
Fachartikel zum neuen /learn-Befehl (24.06.2026).
Kursierende Dritt-Domains (z. B. „hermes-ai.net", „hermes-agent.org") sind nicht die offiziellen Seiten von Nous Research. Verlässlich sind nur das GitHub-Repo und die Doku unter nousresearch.com.
Kurzfazit
SOUL.md = Wer ist der Agent (Charakter) USER.md = Wer bist du (Fakten über dich) MEMORY.md = Was hat er gelernt (eigene Notizen) Skills = Wie erledigt er Aufgaben (wiederverwendbar)
Hermes lernt, indem er sich Fakten notiert, Arbeitsweisen als Skills speichert und alte Gespräche wiederfindet — alles in kleinen, lesbaren Textdateien mit klaren Grenzen. Deine wichtigste Stellschraube als Einsteiger ist die SOUL.md: vier kurze Abschnitte — Identity, Style, Avoid, Defaults — geben dem Agenten eine klare, verlässliche Persönlichkeit.
Schreib jetzt deine erste SOUL.md mit dem Gerüst aus Abschnitt 08 — und wie du mehrere solcher Agenten sauber trennst, zeigt die Seite Hermes Agent · Profile.