🤖HermesBlog
Hermes Feature Guides · Teil 48/9/2026

Hermes frisch halten: Aktualisieren & Deinstallieren leicht gemacht

Persistent Memory — AI's Long-Term Memory — easy-to-understand guide based on official docs

hermes-feature-4-memory

Hermes frisch halten: Aktualisieren & Deinstallieren leicht gemacht

Deinen KI-Assistenten aktuell zu halten, sollte sich nicht wie Raketenwissenschaft anfühlen. Deshalb macht Hermes Agent daraus einen Ein-Befehl-Job. Lass uns alles durchgehen, was du über das Aktualisieren wissen musst – und was hinter den Kulissen passiert, damit du mit absoluter Sicherheit aktualisieren kannst.

Das Update mit einem einzigen Befehl

Hermes zu aktualisieren ist so einfach wie:

hermes update

Das war’s. Dieser einzelne Befehl zieht den neuesten Code, aktualisiert alle Abhängigkeiten und fragt dich sogar nach neuen Konfigurationsoptionen, die seit deinem letzten Update hinzugekommen sind. Kein Durchsuchen von Release-Notes, keine manuellen Schritte – nur ein einziger sauberer Befehl.

Was passiert eigentlich während eines Updates?

Du fragst dich vielleicht: „Was geht da wirklich unter der Haube vor sich?“ Hier ist die freundliche Aufschlüsselung der sechs Schritte, die Hermes unternimmt, um dich auf dem neuesten Stand zu halten:

  1. Pre-Update-Snapshot – Bevor sich irgendetwas ändert, speichert Hermes einen leichtgewichtigen Snapshot deiner wichtigen Zustandsdateien (Pairing-Daten, Cron-Jobs, Konfiguration und mehr). Dateien über 1 GiB werden übersprungen, damit eine riesige Datenbank nie etwas verlangsamt. Dieser Snapshot wird für jedes Profil auf deiner Installation erstellt – das gibt dir ein Sicherheitsnetz.

  2. Git Pull – Hermes zieht den neuesten Code vom main-Branch und aktualisiert alle Submodule.

  3. Syntax-Validierung nach dem Pull + automatisches Rollback – Hier kommt der clevere Teil. Nach dem Pull prüft Hermes, ob alle neun kritischen Dateien weiterhin korrekt geparst werden können. Wenn etwas kaputt aussieht (wie ein Merge-Conflict-Marker), wird automatisch auf die vorherige Version zurückgerollt, damit deine Shell bootfähig bleibt. Du kannst das Update einfach erneut ausführen, sobald der Fix upstream verfügbar ist.

  4. Abhängigkeiten installieren – Neue oder geänderte Abhängigkeiten werden automatisch installiert.

  5. Konfigurationsmigration – Hermes erkennt neue Konfigurationsoptionen und fordert dich auf, sie festzulegen. Die Aufforderung verpasst? Kein Problem – führe einfach hermes config check aus, um zu sehen, was fehlt, und dann hermes config migrate, um sie interaktiv hinzuzufügen.

  6. Gateway-Neustart – Laufende Gateways werden aktualisiert, damit der neue Code sofort wirksam wird. Service-verwaltete Gateways starten über den Systemdienst-Manager neu; manuelle starten automatisch neu.

Aktualisieren von einem anderen Branch

Manchmal willst du einen Release-Kandidaten oder einen Feature-Branch testen. Hermes hat dich abgesichert:

hermes update --branch release-candidate
hermes update --check --branch experimental   # nur Vorschau, wie weit du zurückliegst

Wenn dein lokaler Checkout auf einem anderen Branch liegt, stasht Hermes automatisch nicht-committete Arbeit, wechselt zum Ziel-Branch und zieht die Änderungen. Branches, die lokal nicht existieren, werden automatisch vom Remote getrackt. Und wenn ein Branch nirgendwo existiert? Hermes schlägt sauber fehl und stellt deine gestashten Änderungen wieder her – du bleibst nie auf der Strecke.

Was, wenn du auf einem Feature-Branch geparkt bist?

Hast du dich auf einem Feature-Branch wiedergefunden? Hermes geht damit elegant um:

  • Vollständig gemergter Branch – Hermes wechselt dich zurück zu main und sagt dir genau, was passiert ist.
  • Ungemergte Commits, sauberer Baum – Das Update läuft trotzdem zu main weiter (wichtig für nicht-interaktive Updates wie den Desktop-Button), aber deine Commits bleiben unangetastet. Hermes gibt eine deutliche Meldung aus, die deinen Branch nennt und erklärt, wie du zurückkommst.
  • Dreckiger Baum (nicht-committete Änderungen) – Hermes fasst deine Arbeit nicht an. Das Update wird mit SKIPPED markiert, inklusive klarer Warnung und den genauen Befehlen zur Lösung.

Wenn du absichtlich einen eigenen Branch pflegst, setze updates.parked_branch_strategy: update_in_place in deiner config.yaml. Hermes merged dann origin/main in deinen Branch, statt wegzuwechseln – deine Commits überleben und der Code schreitet voran.

Deinstallieren

Während das Aktualisieren der Star der Show ist, ist das Deinstallieren genauso unkompliziert. Der Prozess entfernt Hermes sauber von deinem System, sodass du dich verabschieden kannst, ohne digitales Chaos zu hinterlassen.

Abschließende Gedanken

Hermes Agent behandelt Updates als erstklassiges Erlebnis – sicher, reversibel und transparent. Die Pre-Update-Snapshots, das automatische Rollback bei Syntaxfehlern und die intelligente Branch-Verwaltung bedeuten, dass du mit Vertrauen aktualisieren kannst, in dem Wissen, dass dein Assistent egal was passiert weiter funktioniert.

Also leg los – führe hermes update aus und lass deinen KI-Assistenten mit dir wachsen. Es ist der einfachste Weg, immer auf dem neuesten Stand zu bleiben.

📖 Offizielle Dokumentation

この記事は Hermes Agent のOffizielle Dokumentationに基づいています:Offizielle Dokumentation › user-guide/features/memory