Web terminal and official Hermes dashboard for running Hermes Agent on umbrelOS.
This repo builds the web-facing container for Hermes Agent on umbrelOS. It does not package Hermes itself — it layers a terminal UI and onboarding flow on top of the official Hermes Agent Docker image. It provides:
- A web-based terminal UI (xterm.js) that drops you straight into chat with Hermes
- Automatic setup detection — runs the setup wizard on first launch, then chat on subsequent visits
- The official Hermes web dashboard, proxied through the terminal server and protected by umbrelOS authentication
- A separate gateway container (official Hermes image, untouched) for messaging platform integrations (Telegram, Discord, WhatsApp, etc.)
- Sandboxing so Hermes runs in its own environment that can't mess up other Umbrel apps
Two containers share a single data volume (/opt/data):
- web — Node.js server providing the terminal UI (xterm.js + PTY) and the official Hermes dashboard (running as a background process, proxied via localhost). This is the main entry point behind the umbrelOS app proxy.
- gateway — Official Hermes Agent image (
nousresearch/hermes-agent) running the messaging gateway for platform integrations. Used as-is with no modifications.
The terminal is served at /terminal (the umbrelOS app entry point). The dashboard owns / and all other paths are proxied to it, ensuring it's protected by umbrelOS authentication.
MIT