Files
Arch1Panel/apps/hermes-web-ui
arch3rPro 7dd542c436 feat(hermes-web-ui): 分离 Web UI 与 Agent 服务并更新文档
分离 Hermes Web UI 与 Agent 服务,改为独立部署模式
添加 Hermes Agent 网关地址配置项
更新 README 说明部署步骤和配置参数
简化 docker-compose 配置,移除内置 Agent 服务
2026-05-10 02:53:01 +08:00
..

Hermes Web UI

A full-featured web dashboard for Hermes Agent. Manage AI chat sessions, monitor usage & costs, configure platform channels, schedule cron jobs, browse skills — all from a clean, responsive web interface.

Deployment

This is a standalone Web UI app that does not include the Hermes Agent service. Install the official Hermes Agent from 1Panel app store first, then install this app to connect to your existing Agent.

Setup Steps

  1. Install Hermes Agent from 1Panel app store (official app)
  2. Install Hermes Web UI (this app)
  3. Configure the "Hermes Agent Gateway" URL during installation (default: http://hermes-agent:8642)
  4. If you changed the Agent container name, adjust the hostname in the gateway URL accordingly

Networking

Both apps use the 1panel-network and communicate via Docker internal networking — no additional ports need to be exposed.

Features

  • AI Chat — Real-time streaming via SSE, multi-session management, Markdown rendering with syntax highlighting
  • Platform Channels — Unified configuration for 8 platforms (Telegram, Discord, Slack, WhatsApp, Matrix, Feishu, WeChat, WeCom)
  • Usage Analytics — Token usage breakdown, cost tracking, model distribution charts
  • Scheduled Jobs — Create, edit, pause, resume, delete cron jobs
  • Model Management — Auto-discover providers, add custom OpenAI-compatible endpoints
  • Multi-Profile — Create, clone, import/export Hermes profiles
  • File Browser — Browse, upload, download files on remote backends
  • Group Chat — Multi-agent chat rooms with @mention support and context compression
  • Skills & Memory — Browse installed skills, user notes management
  • Log Viewer — Filter and view agent/gateway/error logs
  • Authentication — Token-based auth (auto-generated on first run)
  • Web Terminal — Integrated terminal with multi-session support

Usage

Default Port

  • Web UI: 6060 (configurable during installation)

Configuration Parameters

Parameter Default Description
Web UI Port 6060 Web dashboard access port
Agent Gateway http://hermes-agent:8642 Hermes Agent gateway URL

Default Credentials

  • Auth Token is auto-generated on first run. View it via container logs:
    docker logs <container-name> | grep token
    
  • You can also set a custom token via AUTH_TOKEN environment variable

Data Directories

  • ./webui-data — Web UI data (auth token, etc.)

Model Configuration

Make sure to configure your AI model API keys via the Hermes Agent web interface or this app's Model Management page before use.