Skip to content
Mordred

Quickstart

Four commands.

Copy, paste, done. Setup is safe to run again.

Set up with AI A 7-step guide: Hermes Desktop, Venice, Mordred, then your Telegram chats.

  1. Install

    One line. Adds the mordred plugin to Hermes.

    curl -fsSL https://raw.githubusercontent.com/mordredagent/hermes-mordred/main/scripts/install.sh | bash

  2. Set up

    Pick a route, create your keys.

    hermes-mordred setup

  3. Check

    See what's on, what's off.

    hermes-mordred status

  4. Run

    Use Hermes as usual — now protected.

    hermes

Safe to re-run — finished steps are skipped.

Upgrading from 0.1.0a20 or earlier

Re-run the installer (step 1). Old mordred_* names in plugins.enabled and plugins.disabled are migrated automatically, by the installer, configure and upgrade. hermes-mordred plugins migrate does only that.

hermes-mordred plugins migrate

What just happened

Two config files written

~/.hermes/config.yaml and mordred/policy.json.

Your keyvault is ready

Secure Enclave, Keychain or TPM.

Everything stays local

Audit log on your disk. Nothing sent to us.

Next

Try the Lab Features CLI reference
Remove Mordred Open

Quit Hermes Desktop and stop hermes gateway first. --dry-run prints the plan. The uninstall decrypts .env, config.yaml and memory first, and stops before removing anything if it cannot. Mordred's own data and keys (vault, keyvault, Telegram archive, audit log, device keys) are kept unless you add --purge-data and confirm by typing “delete my data”.

hermes-mordred uninstall --dry-run
hermes-mordred uninstall

If hermes-mordred isn't on your PATH (Hermes Desktop, for example), run the uninstall through the installer. The Mordred page in Hermes Desktop also has an “Uninstall Mordred…” button.

curl -fsSL https://raw.githubusercontent.com/mordredagent/hermes-mordred/main/scripts/install.sh | \ bash -s -- --uninstall