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

HostLocationPortStatusStarted
CT460 (this box)/home/hermes/hermes-ui/5174Vite dev serverActive
CT450 (hermesagent)/home/hermes/hermes-ui/5174Vite dev serverActive (since 2026-07-30)

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