explaingit

ekkolearnai/hermes-web-ui

★ 4,710TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A web dashboard for managing an AI agent that connects to Telegram, Discord, Slack, and other chat platforms from a single browser interface.

Mindmap

mindmap
  root((hermes-web-ui))
    What it does
      Multi-platform chat dashboard
      Token usage tracking
      Cron job scheduling
    Platforms supported
      Telegram
      Discord
      Slack
      WhatsApp
    Features
      Analytics
      File browser
      Web terminal
      Group AI chat
    Setup
      npm global install
      Docker Compose
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Monitor and manage AI conversations across Telegram, Discord, Slack, and WhatsApp from a single browser dashboard.

USE CASE 2

Track AI token usage and estimated costs across all messaging platform sessions in real time.

USE CASE 3

Schedule automated tasks for an AI agent using the built-in cron job manager.

USE CASE 4

Configure credentials and behavior for multiple messaging platforms from one settings page.

Tech stack

TypeScriptNode.jsnpmDocker

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a running Hermes Agent instance and API credentials for each messaging platform you want to connect.

In plain English

Hermes Web UI is a browser-based dashboard for managing the Hermes Agent, an AI assistant that connects to multiple messaging platforms. Rather than interacting with Hermes through a command line or through individual chat apps, this dashboard gives you a single web interface where you can see all your conversations, configure platform connections, track costs, and control the agent's behavior. The dashboard covers a lot of ground. On the chat side, it shows sessions grouped by where they came from, whether that's Telegram, Discord, Slack, WhatsApp, Matrix, or other platforms. You can search across all conversations, switch AI models per session, and see how many tokens each conversation has consumed. The platform configuration section lets you enter credentials and adjust behavior settings for eight different messaging platforms from one page, writing those settings back to the agent's config files automatically. Analytics screens show token usage broken down by input and output, estimated cost over time, cache hit rates, and which models are being used most. A scheduled jobs section lets you create and manage cron tasks that the agent will run automatically at set times. There is also a file browser for accessing files on whatever backend Hermes is running on, a group chat room feature that lets multiple AI agents talk together in real time, a web terminal embedded directly in the dashboard, and a log viewer for debugging. Installation is an npm global install followed by a single start command. The dashboard then runs on a local port and you open it in your browser. A Docker Compose option is also available that bundles the web UI together with a Hermes Agent instance in a single container. A one-line setup script handles Node.js installation automatically on Debian, Ubuntu, and macOS if it is not already present. Authentication is token-based and enabled by default, with a generated token on first run. Username and password login can be added through the settings page, or auth can be turned off entirely with an environment variable.

Copy-paste prompts

Prompt 1
How do I install hermes-web-ui globally with npm and connect it to a Hermes Agent running on my server?
Prompt 2
Show me how to configure the Hermes Web UI to connect to both Telegram and Discord from the platform settings page.
Prompt 3
How do I set up a scheduled cron job in Hermes Web UI so the AI agent sends a daily summary message?
Prompt 4
I want to run Hermes Web UI with Docker Compose alongside the Hermes Agent. Show me a sample docker-compose.yml.
Open on GitHub → Explain another repo

← ekkolearnai on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.