Files
agent-estate-wiki/systems/hermes-ui.md
T

2.0 KiB

title, type, status, created, updated, verified_on, confidence, tags
title type status created updated verified_on confidence tags
hermes-ui (Browser Hermes Desktop) system live 2026-07-30 2026-10-20 2026-10-20 high
hermes
webui
desktop
browser

hermes-ui

The official Hermes Desktop renderer, extracted from the hermes-agent monorepo (apps/desktop) and repackaged as a plain Vite web app — runs in a browser instead of Electron.

  • Repo: https://github.com/przbadu/hermes-ui
  • Upstream: NousResearch/hermes-agent monorepo, commit 56a8e81d33a524f0ba0d68b6d54c8786ed283fb8 (2026-07-08)
  • Extraction date: 2026-07-11
  • License: MIT (Copyright (c) 2025 Nous Research)

Deployments

Host Location Port Status Started
CT460 (this box) /home/hermes/hermes-ui/ 5174 Vite dev server Active
CT450 (hermesagent) /home/hermes/hermes-ui/ 5174 Vite dev server Active (since 2026-07-30)

Re-verified 2026-10-20 — both deployments are up. CT460: 0.0.0.0:5174 held by a node process; CT450: 0.0.0.0:5174 confirmed by ss -ltn inside CT450, and /home/hermes/hermes-ui exists there. Note 5175 on CT460 is a different service — a python3 on 127.0.0.1:5175 (the /ui Tailscale Serve route) — and 8787 is the Hermes WebUI (python, 0.0.0.0:8787, the /webui route). Don't conflate 5174 / 5175 / 8787.

How It Works

  • Runs as a Vite dev server, proxying REST/auth/WebSocket to a running Hermes gateway (http://127.0.0.1:9119 by default).
  • Same-origin proxy via Vite so cookies and the WebSocket work without CORS issues.
  • Electron-only methods are stubbed behind a capability flag in src/web-bridge/.

Quick Start

# Install deps (uses bun)
cd ~/hermes-ui/app && bun install

# Start dev server
cd ~/hermes-ui && bin/dev

# Or skip bin/dev and run vite directly:
bunx vite --port 5174 --host 0.0.0.0

Files

  • PLAN.md — extraction plan
  • UPSTREAM.md — upstream commit diff guide
  • scripts/serve-on-gateway.sh — serve built UI same-origin via hermes serve