rvbcrs/hermes-client repository overview

⁠HermesClient — your Hermes AI chats, on any screen

A modern, self-hosted web client for Hermes Agent⁠ by Nous Research. Start a conversation from your iPhone, follow an answer on your tablet, or browse your chat history on your computer — all through your own Hermes gateway.

This image runs the web client. Connect it to an existing Hermes installation; Hermes Agent and your model providers are configured separately.

• Source and documentation: GitHub⁠
• Issues and questions: Issue tracker⁠
• Support the project: GitHub Sponsors⁠ · Buy Me a Coffee⁠ · PayPal⁠

⁠What it does

• Live conversations: start, continue and stop chats, with streaming answers, typing indicators and tool activity shown in order.
• Your chat history: browse earlier conversations, follow active Hermes Desktop chats and spot unread answers with a blue dot.
• Files and photos: add attachments through the + menu or paste an image into the message field. Photos sent through the client remain visible in chat history.
• Conversation management: search, rename, pin and archive chats.
• Copy text and code: copy complete messages, code blocks or individual text proposals with one click.
• Model selection: choose an available model from Settings.
• Make it yours: Classic, Ion, Prism and Glacier designs, dark and light modes, sepia and adjustable text sizes.
• Built for smaller screens: a responsive interface, compact chat list and iPhone home-screen support.
• Four languages: English, Dutch, German and French.
• Remote sign-in: gateway authentication, including Authelia/OIDC.

Features depend on your Hermes version and connection. File uploads, search, conversation management and active Desktop chat discovery require the matching Hermes dashboard. Image input requires a model that supports it.

⁠Quick start

Requirements: Docker Compose, a reachable Hermes gateway and its API key. The client does not include the agent or an AI model.

docker pull rvbcrs/hermes-client:latest

1. Follow the Docker installation guide⁠ for the Compose configuration and gateway connection.
2. Keep the gateway key in a separate secret file and mount a persistent volume at /data.
3. Start the container with docker compose up -d and open the configured server address on port 8787.
4. For remote access, follow the gateway authentication and OIDC guide⁠.

Supported platform: Linux amd64 (Intel/AMD 64-bit), suitable for compatible NAS devices, servers and mini PCs.

⁠Tags

⁠Data and updates

Keep the /data volume when updating. It contains client settings, authentication state and saved image previews. Conversations and uploaded files are stored on the connected Hermes installation.

docker compose pull
docker compose up -d

See the configuration reference⁠ for connection options and the compatibility notes⁠ for current limitations.