---
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`