Zing 论坛

正文

Hermes WebUI:为本地 AI Agent 打造的 Web 交互界面

Hermes WebUI 是一个为 Hermes Agent 设计的本地优先 Web 界面,支持智能模型路由、多模型对话、视觉识别等功能,采用 FastAPI + Tailwind CSS v4 构建,实现成本高效且稳健的本地 AI 交互体验。

AI AgentWebUIFastAPITailwind CSS本地优先Ollama智能路由离线运行
发布时间 2026/04/26 11:23最近活动 2026/04/26 11:53预计阅读 3 分钟
Hermes WebUI:为本地 AI Agent 打造的 Web 交互界面
1

章节 01

Hermes WebUI导读:本地优先的AI Agent交互界面

Hermes WebUI是为Hermes Agent设计的本地优先Web界面,支持智能模型路由、多模型对话、视觉识别等功能,采用FastAPI + Tailwind CSS v4构建。其核心理念是本地优先,所有数据存储在用户机器,无云端依赖,断网可运行,为命令行中的Hermes Agent提供友好直观的网页交互体验。

2

章节 02

项目背景与设计理念

Hermes是NousResearch开发的开源AI Agent,具备文件操作、代码执行等能力,但原生仅终端可用。Hermes WebUI设计理念是不为Hermes增新功能,而是提供直观网页界面;核心是本地优先,数据存于/.hermes/和/.maan/目录,无需注册、不上传数据,断网仍完整运行。

3

章节 03

技术架构与实现

后端用FastAPI提供异步API,前端用Tailwind CSS v4+原生JS,轻量高效。通过SDK桥接层调用Hermes Agent的run_conversation()方法,确保真实Agent能力、数据实时同步、终端与网页无缝切换。智能模型路由系统自动判断任务类型选模型:简单对话用本地Ollama模型,复杂任务调用工具或云端API,长文本用云端强模型;路由状态以LED指示灯展示,支持用户纠偏。

4

章节 04

核心功能详解

  1. 聊天多模态:支持多会话管理、历史持久化、消息撤回重试,SSE流式传输响应;可粘贴图片、上传文件,终端输出过滤为Markdown并语法高亮。
  2. Agent控制台:状态栏显示执行阶段和耗时,心跳检测(10秒慢提醒/25秒卡死警告),可终止任务;工具面板展示调用的工具参数和结果。
  3. 记忆管理:编辑SOUL.md(个性规则)、MEMORY.md(累积知识)、USER.md(用户信息),与CLI实时同步;支持从对话提炼记忆、记忆快照备份。
  4. 技能管理器:查看、启用/禁用、删除技能,导入ZIP包扩展能力。
  5. 个性化定制:设置Agent和用户的名称、头像,选择预设主题或自定义颜色。
5

章节 05

离线化与隐私保护

前端资源(CSS、字体、图标)自托管,Tailwind v4预构建,Google Fonts和Material Symbols本地服务,断网UI完整加载。后端默认启用Bearer Token认证,token自动生成存于~/.maan/auth_token,开发可禁用认证。

6

章节 06

补充支持与适配

  1. 云端API:支持OpenAI、Anthropic等云端API,复杂任务自动路由,本地优先+云端补充。
  2. 跨平台:Windows双击launch.bat,macOS运行install-macos.sh,Linux用start.sh;WSL2支持路径转换。
  3. 移动端:响应式布局,768px断点切换为滑入式侧边栏。
  4. 自动更新:Support页面检测GitHub新版本,流式展示git pull日志,一键更新。
7

章节 07

使用场景与适用人群

适合:

  • 偏好图形界面的Hermes Agent用户;
  • 需管理Agent记忆和技能的开发者;
  • 重视数据隐私的敏感用户;
  • 经常离线工作的用户;
  • 希望自定义AI助手身份的用户。
8

章节 08

总结

Hermes WebUI专注于为Hermes Agent提供优质交互体验,整合智能模型路由、记忆管理、个性化定制等功能,实现本地优先、隐私至上。对现有Hermes用户是增强工具,对探索本地AI Agent的开发者是优秀参考,代表端侧AI“本地优先”理念的实践。