10分钟把 Hermes WebUI 接到自己的数据库上【免费下载链接】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以前查个库存你得先在数据库客户端里跑 SQL把结果复制到终端再粘进和 Agent 的聊天框——来回三次光复制粘贴就耗掉两分钟。Hermes WebUI 的数据库集成解决的就是这段路它不要求你额外装什么连接器而是直接读 Hermes Agent 的 SQLite 状态库 state.db会话、消息、token 计量都在里面顺带把工作区里的 CSV、Excel 和看板库一并纳入让查数和看结果发生在同一个界面。速通路径三步确认数据链路是通的不用改任何配置文件最短的验证线就三步。先启动 WebUI本地跑 server.py或者在容器里用 docker-compose.yml。数据源不需要连接——会话和消息就躺在 Agent 主目录下的~/.hermes/state.db里WebUI 以只读方式把它投影成侧栏的会话列表没有连接串、端口或账号要填。然后打开 Insights 页看到每日 token 用量和模型分布链路就通了图里每个数字都来自 state.db 里的消息记录。能力地图三种数据形态各走各的接法Hermes WebUI 的数据来源分三种形态接入门槛差别很大一张表说清数据形态是什么适合场景接入门槛关系型SQLiteAgent 的state.db含sessions、messages表查历史会话、token 账本、导出周报零开箱即用只读文件类工作区里的 CSV、JSON、Excel、Office 文档把表格喂给 Agent 做问答、批量整理低把文件放进工作区即可接口类/api/insights、/api/kanban/*等 REST 端点外部脚本取数、SSE 实时订阅看板事件零直接调用关系型这条线是主干。WebUI 通过 api/agent_sessions.py 以只读 URI 打开 state.db 做纯读投影侧栏会话、消息历史都从这来。看板数据则由 api/kanban_bridge.py 桥接hermes_cli的看板库暴露任务 CRUD、多看板管理、依赖关系和 SSE 实时事件流列状态固定为triage / todo / ready / running / blocked / done六档。文件类数据落在工作区api/office_documents.py 负责解析 docx、xlsx、pptx表格文件可以直接扔给 Agent 问。配置要点真正要碰的只有两处数据库路径。state.db 默认在~/.hermes/state.db。多 profile 场景下路径跟着各自 HOME 走指错目录你会得到一个空的幽灵库——这是最隐蔽的错配下面踩坑部分细说。只读投影的取舍。WebUI 用 read-only 方式连接而不是普通连接原因写在 api/agent_sessions.py 的注释里多 GB 的 WAL 库如果被 WebUI 长时间持有可写句柄Agent 流式写入会被拖累只读投影同时保证 WebUI 永远不写这个库代价是流式过程中的尾巴看不到只能等落库。同步开关。想让 WebUI 侧的 token 用量也进库、在 Insights 里合并展示把sync_to_insights设为true默认false定义在 api/config.py# WebUI 设置中的相关项 sync_to_insights: true # 把 WebUI token 用量镜像进 state.db供 /insights 合并展示敏感值的位置。数据库凭证、API key 一律走环境变量占位符不要写死在配置里export DB_USER${DB_USER} export DB_PASSWORD${DB_PASSWORD}实战场景它替你省掉了什么用自然语言查库存表。把inventory.csv拖进工作区在聊天框问哪个仓库的 B 品低于安全库存。Agent 自己写 SQL、自己执行你在 WebUI 转写里直接看到它跑的语句和返回的行。省掉的是在数据库工具里写查询、导出 CSV、再贴回对话的整条链路。把会话记录做成周报。打开sync_to_insights之后WebUI 的 token 用量会镜像进 state.db写周报时直接在聊天里问本周哪个模型最贵Agent 查库作答Insights 面板同屏佐证。省掉的是每周手动导出用量表、再对一遍 Excel。看板数据盯着进度走。任务挂进看板后状态一变api/kanban_bridge.py 的 SSE 流就把事件推给 WebUI界面实时刷新不用手动点更新。省掉的是每隔十分钟刷新一次项目跟踪表的动作。踩坑记录四个真实会撞上的坑HOME 里冒出一个空 state.db。现象Agent 主目录下多了一个几乎没数据的库侧栏也空。原因WebUI 找不到真正的 state.db 时回退创建了一个空文件也就是代码里说的幽灵库。解法核对 Agent 的 HOME 目录确认 state.db 确实在那里别把 WebUI 指向别的 profile 的目录。以为 WebUI 能写库。现象想找界面里的入口给 state.db 补一行消息找不到。原因WebUI 对 state.db 是刻意只读的。解法写操作走 Agent 侧或者干脆别写——先想清楚这一行数据是不是 Agent 本来就会生成。只读打开直接失败。现象日志里出现read-only open failed然后回退到可写连接。原因文件属主或容器运行用户不一致当前用户没有读权限。解法统一 WebUI 和 Agent 的运行用户至少保证 state.db 可读。Agent 侧查询超时被杀。现象让 Agent 查一张大表命令执行几秒后被中止。原因没加WHERE或LIMIT全表扫描撞上 Agent 的命令超时。解法先SELECT COUNT(*)估量级再写完整查询。收尾Hermes WebUI 的数据库集成本质是让Agent 查数、WebUI 展示和留档合在一处省掉所有复制粘贴的中间环节。下一步按配置要点核对你的 state.db 位置打开 Insights 看一眼数字对不对——对得上就算接好了。【免费下载链接】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），仅供参考
10分钟把 Hermes WebUI 接到自己的数据库上
10分钟把 Hermes WebUI 接到自己的数据库上【免费下载链接】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以前查个库存你得先在数据库客户端里跑 SQL把结果复制到终端再粘进和 Agent 的聊天框——来回三次光复制粘贴就耗掉两分钟。Hermes WebUI 的数据库集成解决的就是这段路它不要求你额外装什么连接器而是直接读 Hermes Agent 的 SQLite 状态库 state.db会话、消息、token 计量都在里面顺带把工作区里的 CSV、Excel 和看板库一并纳入让查数和看结果发生在同一个界面。速通路径三步确认数据链路是通的不用改任何配置文件最短的验证线就三步。先启动 WebUI本地跑 server.py或者在容器里用 docker-compose.yml。数据源不需要连接——会话和消息就躺在 Agent 主目录下的~/.hermes/state.db里WebUI 以只读方式把它投影成侧栏的会话列表没有连接串、端口或账号要填。然后打开 Insights 页看到每日 token 用量和模型分布链路就通了图里每个数字都来自 state.db 里的消息记录。能力地图三种数据形态各走各的接法Hermes WebUI 的数据来源分三种形态接入门槛差别很大一张表说清数据形态是什么适合场景接入门槛关系型SQLiteAgent 的state.db含sessions、messages表查历史会话、token 账本、导出周报零开箱即用只读文件类工作区里的 CSV、JSON、Excel、Office 文档把表格喂给 Agent 做问答、批量整理低把文件放进工作区即可接口类/api/insights、/api/kanban/*等 REST 端点外部脚本取数、SSE 实时订阅看板事件零直接调用关系型这条线是主干。WebUI 通过 api/agent_sessions.py 以只读 URI 打开 state.db 做纯读投影侧栏会话、消息历史都从这来。看板数据则由 api/kanban_bridge.py 桥接hermes_cli的看板库暴露任务 CRUD、多看板管理、依赖关系和 SSE 实时事件流列状态固定为triage / todo / ready / running / blocked / done六档。文件类数据落在工作区api/office_documents.py 负责解析 docx、xlsx、pptx表格文件可以直接扔给 Agent 问。配置要点真正要碰的只有两处数据库路径。state.db 默认在~/.hermes/state.db。多 profile 场景下路径跟着各自 HOME 走指错目录你会得到一个空的幽灵库——这是最隐蔽的错配下面踩坑部分细说。只读投影的取舍。WebUI 用 read-only 方式连接而不是普通连接原因写在 api/agent_sessions.py 的注释里多 GB 的 WAL 库如果被 WebUI 长时间持有可写句柄Agent 流式写入会被拖累只读投影同时保证 WebUI 永远不写这个库代价是流式过程中的尾巴看不到只能等落库。同步开关。想让 WebUI 侧的 token 用量也进库、在 Insights 里合并展示把sync_to_insights设为true默认false定义在 api/config.py# WebUI 设置中的相关项 sync_to_insights: true # 把 WebUI token 用量镜像进 state.db供 /insights 合并展示敏感值的位置。数据库凭证、API key 一律走环境变量占位符不要写死在配置里export DB_USER${DB_USER} export DB_PASSWORD${DB_PASSWORD}实战场景它替你省掉了什么用自然语言查库存表。把inventory.csv拖进工作区在聊天框问哪个仓库的 B 品低于安全库存。Agent 自己写 SQL、自己执行你在 WebUI 转写里直接看到它跑的语句和返回的行。省掉的是在数据库工具里写查询、导出 CSV、再贴回对话的整条链路。把会话记录做成周报。打开sync_to_insights之后WebUI 的 token 用量会镜像进 state.db写周报时直接在聊天里问本周哪个模型最贵Agent 查库作答Insights 面板同屏佐证。省掉的是每周手动导出用量表、再对一遍 Excel。看板数据盯着进度走。任务挂进看板后状态一变api/kanban_bridge.py 的 SSE 流就把事件推给 WebUI界面实时刷新不用手动点更新。省掉的是每隔十分钟刷新一次项目跟踪表的动作。踩坑记录四个真实会撞上的坑HOME 里冒出一个空 state.db。现象Agent 主目录下多了一个几乎没数据的库侧栏也空。原因WebUI 找不到真正的 state.db 时回退创建了一个空文件也就是代码里说的幽灵库。解法核对 Agent 的 HOME 目录确认 state.db 确实在那里别把 WebUI 指向别的 profile 的目录。以为 WebUI 能写库。现象想找界面里的入口给 state.db 补一行消息找不到。原因WebUI 对 state.db 是刻意只读的。解法写操作走 Agent 侧或者干脆别写——先想清楚这一行数据是不是 Agent 本来就会生成。只读打开直接失败。现象日志里出现read-only open failed然后回退到可写连接。原因文件属主或容器运行用户不一致当前用户没有读权限。解法统一 WebUI 和 Agent 的运行用户至少保证 state.db 可读。Agent 侧查询超时被杀。现象让 Agent 查一张大表命令执行几秒后被中止。原因没加WHERE或LIMIT全表扫描撞上 Agent 的命令超时。解法先SELECT COUNT(*)估量级再写完整查询。收尾Hermes WebUI 的数据库集成本质是让Agent 查数、WebUI 展示和留档合在一处省掉所有复制粘贴的中间环节。下一步按配置要点核对你的 state.db 位置打开 Insights 看一眼数字对不对——对得上就算接好了。【免费下载链接】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），仅供参考
