Hermes Switch UI — Install Paths

Four methods to get both processes running — pick the one that fits your setup

Docker most users — managed images Electron Desktop single-user laptop — no terminal pnpm dev contributors, debugging Production Node Build self-hosted server / remote deploy git clone Interstellar-code/hermes-switchui cp .env.example .env copy env template add API key to .env ANTHROPIC_API_KEY etc. docker compose up starts UI + agent containers download installer .dmg / .exe / .AppImage run installer follow OS install wizard launch app agent auto-starts on first run git clone Interstellar-code/hermes-switchui pnpm install install node dependencies cp .env.example .env copy env template pnpm dev UI + agent auto-start git clone Interstellar-code/hermes-switchui pnpm install install node dependencies pnpm build compiles to .output/ start hermes-agent separately python -m hermes_agent on :8642 pnpm start runs .output/server/index.mjs on :3000 Verify install 1. Open browser to localhost:3000 2. Check agent health: localhost:8642/health 3. Send a test chat message — tokens should stream back

Docker (recommended)

  • • Both processes in pre-built containers
  • • Survives reboots via restart policy
  • • Minimal local tooling required
  • • GPU passthrough possible via compose

Electron Desktop

  • • Native installer — no terminal after setup
  • • Agent auto-starts with the app window
  • • Auto-updater handles future releases
  • • Single-user, local-machine focus

pnpm dev / Production Node

  • • Source checkout — hot reload in dev mode
  • • pnpm dev auto-starts the agent sidecar
  • • Production build outputs to .output/
  • • Bind HERMES_PASSWORD for remote access

Hermes Switch UI • install paths • all methods converge on localhost:3000 + :8642/health