ENBM
Academyacademy / hermes-101 / easy-updating

Stay current

Update in one command

Hermes ships new features almost every day. One command updates it and keeps your memory, skills, and settings.

  1. 1Checkhermes update --checkPreview only — nothing changes
  2. 2Updatehermes updatePulls the latest, keeps your data
  3. 3Migratehermes config migrateAdd any new settings if asked
  4. 4Verifyhermes doctorConfirm everything is healthy

Keep Hermes Updated

Station 13 — Stay current. Time: 8 min. Pass when you know the command to update Hermes and how to check it worked.

What this is

Hermes is developed in the open and ships new features, fixes, and models almost every day. Keeping it updated is a one-command habit — and it keeps your memory, skills, and settings intact.

The flow above is the whole routine: check, update, migrate settings if asked, verify.

Why it matters

Because Hermes changes so often, a copy from last month can be missing tools, model support, or fixes you would want. Updating regularly is part of owning your agent — like updating any app you rely on.

What to do

Run the update from the terminal:

Terminal command
hermes update

That pulls the latest version, updates dependencies, offers to add any new settings, and restarts the gateway. It auto-detects how you installed Hermes, so you do not need to remember.

Want to look before you leap?

Terminal command
hermes update --check

This previews what would change without touching anything.

If the update mentions new settings and you skipped the prompt:

Terminal command
hermes config check
hermes config migrate

Then confirm it all landed:

Terminal command
hermes doctor
hermes --version

Two more good-to-knows:

  • You can update remotely by sending /update from a connected messaging app like Telegram.
  • If an update ever misbehaves, Hermes can be rolled back to an earlier version — check with your facilitator or the official docs before doing that.

Reference

Updating is an at-home ownership habit, not a live-class step. Do it on your own machine, on your own time.

Common mistakes

  • Never updating, then wondering why a feature from the docs is missing.
  • Ignoring the "new settings" prompt and hitting config errors later.
  • Skipping hermes doctor after an update when something feels off.

Next step

Go to Graduation + VPS Preview.