51 lines
1.6 KiB
Markdown
51 lines
1.6 KiB
Markdown
---
|
|
title: hermes-ui (Browser Hermes Desktop)
|
|
type: system
|
|
status: live
|
|
created: 2026-07-30
|
|
updated: 2026-07-30
|
|
verified_on: 2026-07-30
|
|
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) |
|
|
|
|
## 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` |