EKKOLearnAI/hermes-web-ui

⭐ 4,238  ·  TypeScript  ·  GitHub Repo

Web dashboard for Hermes Agent — multi-platform AI chat, session management, scheduled jobs, usage analytics

agent ai-agent chat-ui dashboard hermes hermes-agent hermes-web-ui llm

1-Sentence Summary

Self-hosted web dashboard unifying multi-platform AI chat, session management, analytics, and scheduling for Hermes Agent.

🔥 Key Capabilities & USP

• Unified Multi-Platform Chat Dashboard: Manage conversations from Telegram, Discord, Slack, WhatsApp, Matrix, Feishu, WeChat, and WeCom in a single interface. Solves the pain point of context-switching between native apps for AI interactions.
• Real-Time Streaming & Session Management: SSE-powered streaming chat with multi-session CRUD, SQLite storage, and global search across conversations. Eliminates lost context and fragmented chat histories.
• Usage Analytics & Cost Tracking: Token breakdown, cache hit rates, model distribution charts, and 30-day cost trends. Provides visibility into spending and model performance that self-hosters typically lack.
• Scheduled Jobs & File Browser: Cron-based job creation with trigger execution, plus a file browser supporting local, Docker, SSH, and Singularity backends with full CRUD. Automates recurring tasks and centralizes file management across heterogeneous environments.
• Multi-Agent Group Chat: Socket.IO-powered rooms with @mention routing and context compression. Enables collaborative AI workflows where multiple agents or users interact in shared spaces.

USP: Deep integration with Hermes Agent's ecosystem provides a cohesive experience that standalone chat UIs or generic dashboards cannot match—channel configuration, credential management, and gateway restart are all handled from one pane of glass.

Technical Architecture

Layer	Technology	Role
Frontend	Vue 3 + TypeScript + Vite	Reactive UI with Hermes-specific code under hermes/ directories for multi-agent extensibility
BFF (Backend-for-Frontend)	Koa (port 8648)	API proxy, SSE streaming, file upload/download, session CRUD via CLI, config/credential management, static file serving
Gateway	Hermes Gateway (port 8642)	Core agent routing and multi-platform integration
Storage	SQLite (local)	Session persistence and conversation history
Real-Time	Socket.IO	Group chat messaging and live updates
Deployment	npm global package, Docker, one-line shell script	Multiple paths for different operational preferences

Architectural Highlight: The BFF pattern decouples the frontend from direct gateway access, enabling secure credential management and multi-backend file operations without exposing internal services.

Quick Start Guide

Option 1: npm Global Install (Recommended for developers)

npm install -g hermes-web-ui && hermes-web-ui start

Option 2: One-Line Script (Quick setup)

bash <(curl -fsSL https://raw.githubusercontent.com/EKKOLearnAI/hermes-web-ui/main/scripts/setup.sh)

Option 3: Docker Compose (Production-ready)

WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest docker compose up -d hermes-agent hermes-webui

CLI Commands for Management:

hermes-web-ui start --port 9000
hermes-web-ui stop
hermes-web-ui restart
hermes-web-ui status
hermes-web-ui update
hermes-web-ui -v
hermes-web-ui -h

Pros, Cons & Use Cases

Pros

• Comprehensive feature set covering chat, analytics, scheduling, file management, and multi-platform support in one dashboard
• Self-hosted with flexible deployment (npm, Docker, one-line script) giving full data control
• Real-time streaming and group chat capabilities for interactive workflows
• Extensive configuration and authentication options for enterprise-grade setups

Cons

• Tightly coupled with Hermes Agent ecosystem—cannot be used as a generic LLM dashboard
• Requires Node.js and Hermes Agent installation as prerequisites
• Docker setup requires additional environment variable configuration for production use
• Some features (like WeChat QR login) depend on third-party APIs with potential reliability concerns

Who should NOT use this?

• Teams not using Hermes Agent—this dashboard is purpose-built for the Hermes ecosystem and will not function as a standalone chat UI
• Users seeking a lightweight, single-platform chat interface—the multi-platform complexity adds unnecessary overhead for single-channel use cases
• Organizations requiring cloud-managed SaaS solutions—this is a self-hosted tool requiring infrastructure maintenance

Ideal Use Cases

• Self-hosted AI agent teams managing multiple communication channels (Telegram, Discord, Slack) from a single dashboard
• DevOps teams needing usage analytics and cost tracking for internal LLM deployments
• Multi-agent environments where group chat rooms with @mention routing and context compression are valuable
• Teams with heterogeneous file storage (local, Docker, SSH, Singularity) requiring unified file browser access

Community & Activity

With 4,238 stars and active development through May 2026, Hermes Web UI demonstrates strong community traction and sustained maintenance momentum. The project's comprehensive documentation, multiple deployment options, and active feature development (SSE streaming, Socket.IO group chat, multi-backend file browser) signal a healthy, growing ecosystem. The TypeScript codebase and Vue 3 architecture attract modern web developers, while the CLI tooling and Docker support lower the barrier for operators. This is a project worth watching—and adopting—for anyone serious about self-hosted AI agent management.