Hermes Client: app and UI for Hermes Agent

Web chat interface for Hermes Agent that maps each Hermes profile to a separate agent

What Hermes Client does

Every agent in the UI maps one to one to a Hermes profile, with its own home directory, config and sessions. Adding, renaming or deleting an agent runs the matching hermes profile command underneath. Each chat turn spawns the hermes CLI in quiet chat mode and streams its output to the browser over Server-Sent Events, so no hermes gateway, extra port or separate API server is needed.

Sessions started in a standalone hermes REPL show up in the sidebar within seconds, and a web conversation can be resumed from the terminal. An xterm.js drawer hosts the real hermes model and config commands for setup, files can be dragged into the composer, and views for cron, skills and plugins sit in the same shell. It also has JWT login with a default admin account, colour themes and an installable PWA.

Key features

One UI agent per Hermes profile, with add, rename and delete from the interface
Streaming chat over Server-Sent Events with no hermes gateway or extra API server
Sessions started in the terminal REPL appear in the sidebar and can be continued from either side
Embedded xterm.js terminal for model and config commands
File uploads, with images passed to Hermes through --image
Cron, skills and plugins views, JWT login, themes and an installable PWA

When to use it

Managing several Hermes profiles from a browser instead of the terminal
Continuing a terminal Hermes conversation in a web chat
Configuring cron jobs, skills and plugins from a single interface

Who it is for: Hermes Agent users who prefer a browser UI for chatting with and managing multiple profiles.

How it fits with Hermes Agent

Built for Hermes Agent; it drives the locally installed hermes CLI and maps each Hermes profile to an agent in the UI.

How to install Hermes Client

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/lotsoftick/hermes_client.git
cd hermes_client
npm start

Requirements: Node.js 18+ and Hermes Agent installed with hermes on the PATH; on Windows also Git for Windows and Visual Studio Build Tools.

FAQ

What is Hermes Client?

Hermes Client is a web-based chat interface for Hermes Agent. It manages multiple Hermes profiles as separate agents and streams conversations in the browser.

How do I install Hermes Client?

Clone the repository, change into it and run npm start. The README says npm start builds everything, deploys to ~/.hermes_client, sets up auto-start and installs a global hermes_client command.

What do I need to run Hermes Client?

You need Node.js 18 or newer and Hermes Agent installed with the hermes command on your PATH. No hermes gateway or API server configuration is required.