Hermes Pixel UI: app and UI for Hermes Agent

Pixel-art real-time dashboard that shows Hermes Agent sessions as animated office characters

What Hermes Pixel UI does

Hermes Pixel UI uses the Hermes session_id as the identifier for each visual agent and moves agents between rooms by activity. Terminal, browser and code work happens on the Main Floor, file reads, search and memory in the Archive, LLM calls and planning in the Meeting Room, clarifications and idle time at the Brew Bar, and finished tasks in Recharge. The README says the room mapping is heuristic and lives in backend/server.py.

Events arrive through a pixel-ui-bridge plugin that posts lifecycle events to POST /api/hermes-event, and the FastAPI backend pushes updates to a React frontend over WebSocket. When live events are unavailable, it polls ~/.hermes/sessions for session JSON and JSONL files without overwriting recent live state. A scene editor lets you drag furniture into the office map, with the layout saved in browser storage, and completed agents are removed after a short delay. ./start.sh runs the backend on port 9000 and the Vite frontend on port 9001.

Key features

Hermes sessions shown as animated pixel-art office characters
Live events from a pixel-ui-bridge plugin through POST /api/hermes-event
Fallback polling of ~/.hermes/sessions
Activity-based routing between five rooms
Drag-and-drop scene editor with layout saved in browser storage
WebSocket updates between FastAPI and React

When to use it

Watching several Hermes sessions at once and seeing which are working, waiting or done
Getting a quick visual read on what a multi-agent run is doing
Customizing the office layout to taste

Who it is for: Hermes Agent users who run several sessions and want an at-a-glance visual view of what each is doing.

How it fits with Hermes Agent

It is a visual companion built only for Hermes Agent, reading live plugin events and Hermes session files.

How to install Hermes Pixel UI

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

./start.sh

Requirements: Python 3.9+, Node.js 18+, npm and Hermes Agent installed locally

FAQ

What is Hermes Pixel UI?

Hermes Pixel UI is a real-time pixel-art dashboard for Hermes Agent sessions. Each session appears as an animated character that moves between rooms depending on its activity.

Does Hermes Pixel UI work with Hermes Agent?

Yes. It is built for Hermes Agent and receives live events from a plugin, falling back to reading ~/.hermes/sessions when events are not available.

What do I need to run Hermes Pixel UI?

You need Python 3.9 or newer, Node.js 18 or newer, npm and a local Hermes Agent install. Running ./start.sh serves the backend on port 9000 and the frontend on port 9001.