Hermes agent
The Hermes agent (CLI, gateway, MCP servers, skills). Updated 2026-11-06 to checkout 6b21d0564d (git, stable channel).
- Runs as user
hermes, not root. Install: /usr/local/lib/hermes-agent, owned by hermes since 2026-11-06, so hermes update runs without sudo. Toolchain (Python 3.14, Node) in ~/.hermes/tools; dependency environment in ~/.hermes/installs/<key>/environments/…/venv (Python 3.14.9, nemo-relay 0.11.0). Launchers in /usr/local/lib/hermes-agent/.hermes/bin were repointed from /root/.hermes to /home/hermes/.hermes (backups /tmp/hermes*.launcher.bak).
- Home/config:
~/.hermes/config.yaml. Model anonrouter/uncensored, defined under providers.anonrouter (moved from custom_providers on 2026-11-06; backup config.yaml.bak-20261106-providers). MCP servers: agentmail, deepwiki, context7, semgrep, n8n, postgres, searxng.
- Gateway: user systemd unit
hermes-gateway.service (restart with hermes gateway restart). Profiles: default, plan_b_researcher.
/root/.hermes is an older separate root-owned Hermes home (Sep 2026), left untouched.
- Mnemosyne memory provider: the update flagged it as moved out of core and skipped installing it. Full data was exported 2026-11-06: Mnemosyne Archive; originals in
~/backups/mnemosyne-20261106/. Don't remove the old 3.11 venv until you've decided what replaces it.
- Related: Backups and alerting, Host hermes
- Dashboard:
hermes dashboard --no-open listens on 127.0.0.1:9119 only. WireGuard-only nginx proxy at http://10.88.0.1:9120/ (/etc/nginx/sites-available/hermes-dashboard, ufw allow on wg0). Since 2026-11-12 it is a user service, hermes-dashboard.service (systemctl --user status hermes-dashboard; restarts on failure, MemoryMax 600M, starts on boot, ~190 MB). Do not also run hermes dashboard by hand (port clash); if the service is stopped the proxy returns 502.
- Dashboard theme:
~/.hermes/dashboard-themes/hallmark-soft.yaml ("Hallmark Soft", built 2026-11-12 with the Hallmark skill, restyle depth): paper tones, one clay accent, system fonts only (no external requests), 16px base, sentence-case labels, thumb-sized tap targets and no sub-13px text via customCSS. Pick it from the theme button at the bottom of the dashboard sidebar; switch back to "Nous Blue" the same way. It touches no Hermes source, needs no rebuild and survives hermes update, but its CSS targets Tailwind class names, so a big UI update could make parts of it stop applying. Before/after screenshots and the audit: ~/hallmark-hermes-dashboard/.
- Dashboard over HTTPS (2026-11-14):
https://10.88.0.1:9121/ (nginx, WireGuard only, private-CA cert shared with Cockpit; CA public cert at http://10.88.0.1:8091/hermes-private-ca.crt). Use this instead of http://10.88.0.1:9120/ if you need paste: over plain http the browser has no Clipboard API, and the dashboard's Ctrl/Cmd+V handler cancels the native paste and fails silently. The Chat terminal also turns autocorrect, autocapitalize and spellcheck off on purpose (ChatPage.tsx); a theme can't change that.
Dashboard on a phone: paste, trust warnings (worked out 2026-11-14)
- Use the HTTPS address:
https://10.88.0.1:9121/ (WireGuard on). Plain http://10.88.0.1:9120/ has no browser Clipboard API, so Ctrl/Cmd+V does nothing there (the dashboard cancels the native paste, then fails silently). Typing 10.88.0.1 with no https:// and port makes Brave try HTTPS on the HTTP port and show "doesn't support a secure connection"; that is not a certificate problem.
- Trust the certificate once: with WireGuard on, download
http://10.88.0.1:8091/hermes-private-ca.crt and install it as a CA certificate (Android settings, search "certificate", Install a certificate, CA certificate). The CA is name-constrained to 10.88.0.0/24, localhost and this host, so it cannot vouch for other sites. Cockpit (https://10.88.0.1:9090) uses the same CA.
- Allow the clipboard for the site. Brave/Chrome ask for clipboard permission and silently fail if it was ever blocked: tap the icon at the left of the address bar, open the site's permissions, set Clipboard to Allow (or Settings, Site settings, Clipboard). What exactly unblocked paste on 2026-11-14 was not recorded; this is the likely step, not a confirmed one.
- No-certificate alternative: an SSH tunnel (
ssh -N -L 9119:127.0.0.1:9119 root@45.61.176.215) and http://localhost:9119/. Browsers treat localhost as secure, and paste worked there in a desktop test.
- Autocorrect: the Chat terminal turns autocorrect/autocapitalize/spellcheck off on purpose (a dashboard code choice, not a setting). Type in another app and paste, or ask for a compose-box plugin.
- A temporary paste test page (
/_paste-test.html on port 9121) was used and removed on 2026-11-14; its source is ~/scripts/paste-test.html if needed again.