57 lines
2.0 KiB
Markdown
57 lines
2.0 KiB
Markdown
---
|
|
title: hermes-ui (Browser Hermes Desktop)
|
|
type: system
|
|
status: live
|
|
created: 2026-07-30
|
|
updated: 2026-10-20
|
|
verified_on: 2026-10-20
|
|
confidence: high
|
|
tags: [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
|
|
|
|
```bash
|
|
# 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` |