Hermes G2 HUD: app and UI for Hermes Agent

Monitor and control Hermes agents from Even Realities G2 smart glasses through a WebSocket gateway

What Hermes G2 HUD does

A WebSocket gateway runs on your server or laptop, on port 9090 by default, and exposes a small REST API. Hermes, or any script or cron hook, posts agent status, notifications and command results to endpoints such as /api/agents, /api/notifications and /api/command-callback. The HUD itself is a Vite and TypeScript web app that runs inside the Even Realities app on your phone, connects to the gateway over WebSocket and draws the data on the glasses over Bluetooth.

On the glasses, a tap advances, a double-tap returns to the Dashboard and scrolling moves through lists. There are four screens: Dashboard with agent counts and status, Agent Detail with task and progress, Notifications with mark-read, and Quick Commands with eight presets such as Health Audit and Cron Status. A tapped command flows back through the gateway to Hermes, using HERMES_CALLBACK_URL when set. Docker Compose is supported, and the project is MIT licensed.

Key features

WebSocket gateway with a REST API for pushing agent updates and notifications
Four glasses screens: Dashboard, Agent Detail, Notifications and Quick Commands
Tap, double-tap and scroll navigation
Commands from the glasses routed back to Hermes through a callback URL
Setup and start scripts, plus Docker Compose

When to use it

Glancing at agent status and CI failure alerts without picking up a phone
Checking which cron jobs are active from a quick command
Triggering a health audit on a Hermes host from the glasses

Who it is for: Hermes Agent users who own Even Realities G2 smart glasses and want ambient status for their agents.

How it fits with Hermes Agent

Built around Hermes: Hermes, a script or a cron hook pushes updates to the gateway, and commands tapped on the glasses are sent back to Hermes.

How to install Hermes G2 HUD

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/zd87pl/hermes-g2-hud.git
cd hermes-g2-hud
./scripts/setup.sh
./scripts/start.sh

Requirements: Python 3.10+, Node.js 18+, npm 9+, the Even Realities app on your phone, and G2 glasses paired over Bluetooth

FAQ

What is Hermes G2 HUD?

Hermes G2 HUD is a gateway and glasses app that displays Hermes agent status, notifications and cron results on Even Realities G2 smart glasses and sends tapped commands back to Hermes.

What hardware does Hermes G2 HUD need?

It needs Even Realities G2 smart glasses paired by Bluetooth to a phone running the Even Realities app, plus a server or laptop to run the gateway.

How do I install Hermes G2 HUD?

Clone the repository, run ./scripts/setup.sh to install dependencies and build the glasses app, then start the gateway with ./scripts/start.sh. You then sideload the app to the glasses with a QR code from npx evenhub qr.