# hermes-web-ui

**Repository Path**: dongdong-git/hermes-web-ui

## Basic Information

- **Project Name**: hermes-web-ui
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hermes WebUI

浏览器端的 Hermes Agent 聊天界面。轻量、自包含、SSE 流式输出。

## 快速开始

```bash
bash run.sh
# 打开 http://localhost:8000
```

## 特性

- 流式输出：逐 token 实时显示，非转圈等待
- 多会话：创建、切换、删除，消息持久化
- 暗色主题，Markdown + 代码高亮
- 零构建，纯 HTML/CSS/JS + FastAPI

## 文档

| 文档 | 路径 |
|------|------|
| 架构总览 | [docs/architecture/overview.md](docs/architecture/overview.md) |
| 后端设计（流式机制） | [docs/backend/streaming.md](docs/backend/streaming.md) |
| 前端设计（SSE 消费） | [docs/frontend/streaming.md](docs/frontend/streaming.md) |
| API 参考 | [docs/api/reference.md](docs/api/reference.md) |
| 开发指南 | [docs/development/guide.md](docs/development/guide.md) |

## 项目结构

```
/opt/hermes-webui/
├── backend.py           # FastAPI 后端
├── run.sh               # 启动脚本
├── sessions/            # 会话持久化
├── static/
│   └── index.html       # 前端单页
├── docs/                # 文档
└── test_aiagent.py      # AIAgent 测试
```