hermes-webui 数据库集成3 步把 Agent 的 SQLite 状态搬上网页【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webuiHermes WebUI 是 Hermes Agent 的浏览器界面它的数据库集成功能直接读取 Agent 的本地 SQLite 数据库 state.db 并展示在网页上。读完本文你可以在 3 步内让看板任务进度、token 用量统计出现在浏览器里不用写一行代码。今天任务跑到哪了不开终端也能看 痛点是看板任务、会话记录、token 消耗都写在 Agent 主目录下的 SQLite 文件里想看进度得开终端查。hermes-webui 的 api/kanban_bridge.py 把看板数据库包成 /api/kanban/* 接口Insights 把 state.db 汇总成每日统计原来藏在文件里的数据直接在浏览器里看。图hermes-webui 数据库集成的会话界面会话与状态数据来自 Agent 的 state.db图看板视图数据源是 Agent 的 kanban SQLite 数据库WebUI 与 Agent 共用同一份数据快速上手 把仓库克隆到本地git clone https://gitcode.com/GitHub_Trending/he/hermes-webui安装 Python 依赖pip install -r requirements.txt启动服务默认端口 8787./start.sh浏览器打开 http://127.0.0.1:8787看板与 Insights 面板走 api/routes.py 里的 /api/kanban/* 和 /api/insights 路由实时读取 Agent 的 SQLite 数据。图Insights 面板按天汇总 state.db 中的 token 用量与模型分布配置要点 ️服务端口与绑定地址配置项作用推荐值HERMES_WEBUI_PORTWebUI 监听端口8787HERMES_WEBUI_HOST绑定地址127.0.0.1远程访问改 0.0.0.0.env 文件加载环境变量start.sh 启动时自动加载仓库根目录的 .env端口、Agent 路径等变量写进去即可免去每次 export.env 里的 UID/GID 等只读变量会被脚本过滤不会导致启动崩溃定位与备份 state.dbstate.db 是 Agent 的 SQLite 状态数据库位于 Agent 主目录下可用 HERMES_HOME 环境变量指定位置WebUI 以只读方式打开它见 api/agent_sessions.py直接复制文件就能备份数据库较大时选 Agent 空闲时段备份避免 WAL 文件不一致常见问题 ❓现象原因处理start.sh 提示 already running已有实例占用端口./ctl.sh restart重启服务看板面板是空的Agent 的 kanban 数据库还没有看板数据先用 Hermes Agent 跑一个看板任务再刷新浏览器Insights 显示 0 tokenstate.db 里还没有会话记录聊几轮后再看 Insights 面板Agent 更新数据后页面不刷新浏览器缓存强制刷新CtrlShiftR看板数据实时读取数据库延伸阅读README.md、api/kanban_bridge.py、api/agent_sessions.py把看板和 token 统计搬进浏览器之后Agent 的运行状态就可以直接交给整个团队查看。【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考