# Hermes Web UI — Multi-Platform AI Chat Dashboard

> Hermes Web UI is an open-source web dashboard for the Hermes Agent, providing multi-platform AI chat management, session history, scheduled jobs, and usage analytics in a self-hosted interface.

## Install

Save in your project root:

# Hermes Web UI — Multi-Platform AI Chat Dashboard

## Quick Use
```bash
git clone https://github.com/EKKOLearnAI/hermes-web-ui.git
cd hermes-web-ui
pnpm install
cp .env.example .env
pnpm dev
```

## Introduction
Hermes Web UI is an open-source web dashboard designed for the Hermes Agent ecosystem. It provides a centralized interface for managing AI chat sessions across multiple platforms, reviewing conversation history, configuring scheduled automation jobs, and tracking token usage and costs. Built with Vue 3 and TypeScript, it is fully self-hostable.

## What Hermes Web UI Does
- Manages AI chat sessions across multiple model providers from a single dashboard
- Displays conversation history with search and filtering capabilities
- Configures and monitors scheduled automation jobs for recurring AI tasks
- Tracks token consumption and cost analytics across different models
- Provides user and session management for multi-user deployments

## Architecture Overview
The frontend is built with Vue 3, TypeScript, and a component-based UI architecture. It communicates with the Hermes Agent backend through REST and WebSocket APIs. Chat sessions are stored and indexed for history browsing. The dashboard pulls usage metrics from the agent backend and renders them as charts and summary cards. The application is designed as a single-page application that can be deployed as static files behind any web server.

## Self-Hosting & Configuration
- Clone the repository and install dependencies with pnpm
- Configure the backend API endpoint in the environment variables
- Set up authentication credentials for accessing the dashboard
- Build for production and serve with Nginx, Caddy, or any static file server
- Optionally deploy with Docker using the included Dockerfile

## Key Features
- Unified dashboard for managing conversations across multiple AI providers
- Real-time chat interface with streaming response support
- Usage analytics with token count and cost tracking per session
- Scheduled job management for automated recurring AI workflows
- Clean Vue 3 interface with responsive design for desktop and mobile

## Comparison with Similar Tools
- **Open WebUI** — focused on Ollama integration; Hermes Web UI is built for the Hermes Agent ecosystem
- **LobeChat** — multi-model chat client; Hermes Web UI adds scheduled jobs and usage analytics
- **LibreChat** — API-key-based multi-provider chat; Hermes Web UI integrates with Hermes Agent backend
- **Jan** — desktop-native offline chat; Hermes Web UI is a web-based dashboard for remote access
- **ChatGPT UI clones** — typically single-provider; Hermes Web UI manages sessions across platforms

## FAQ
**Q: Does Hermes Web UI require the Hermes Agent backend?**
A: Yes. The dashboard is designed as a frontend for the Hermes Agent system and communicates with its API.

**Q: What AI models can I use through the dashboard?**
A: Any model supported by the Hermes Agent backend, which typically includes OpenAI, Anthropic, and other providers.

**Q: Can multiple users share one Hermes Web UI instance?**
A: Yes. The dashboard supports user management for multi-user deployments.

**Q: How is usage tracked?**
A: Token consumption and estimated costs are captured per session and displayed in the analytics view.

## Sources
- https://github.com/EKKOLearnAI/hermes-web-ui

---
Source: https://tokrepo.com/en/workflows/asset-30d850e0
Author: AI Open Source