majorminorlabs/hermes-voice

项目介绍

Hermes Voice 在 Home Assistant 里新增一个对话智能体，把 Assist 的每一轮语音请求转给某个 Hermes Agent 配置，并以流式方式把回复读出来。它面向已经运行 Home Assistant 和 Hermes、想通过语音终端（包括刷了 echo-dot-assist 的闲置 Amazon Echo Dot）与智能体交谈的人。

对话历史保留在 Hermes 一侧：集成只发送新的用户消息并附带稳定的 X-Hermes-Session-Id，因此配置里的 SOUL.md 和长期记忆会生效。会话模式可选 per_conversation（静默 5 分钟后开启新会话）或 per_device（每个设备一个会话，空闲 idle_reset_minutes 后重置，默认 30 分钟）。回复流式返回并做轻量语音清理，出错时朗读简短兜底句而不是原始错误文本。

仓库还附带一个 Hermes 技能、手写语音配置指南，以及可复现的 "Hey Hermes" microWakeWord 训练流程。

快速使用

推荐让 Hermes 智能体自己完成配置。先从仓库安装技能：

hermes skills install majorminorlabs/hermes-voice/skill/hermes-voice-setup

然后让智能体使用 hermes-voice-setup 技能创建语音助手。它会询问几个问题、逐步给出 --dry-run，再执行配置、Home Assistant、语音和验证脚本。文档给出的命令序列如下：

voice_profile.py --profile voice --create --write-soul --tools safe --reasoning low --service
ha_setup.py --profile voice --docker --config-dir ~/hermes-voice/ha-config --set-default
speech_setup.py --docker --data-dir ~/hermes-voice/speech --set-default --internal-url http://<LAN-IP>:8123 --piper-voice en_US-ryan-high
verify.py --recall

--tools 决定 Hermes 被语音调用时能做什么：safe（网页搜索、记忆）、home（增加 Home Assistant 控制）、full（终端、文件、代码）或自定义列表，具体权限选项见语音配置指南。最后按设备指南用 echo-dot-assist 设置 Echo 并切换到 "Hey Hermes" 唤醒词。

也支持手动安装：先准备语音配置并启动其 API 服务，再通过 HACS 以 Integration 分类添加本仓库（或把发布包解压到 <config>/custom_components/），在集成中添加 Hermes Voice 并填写网关地址和配置的 API_SERVER_KEY，最后在 Assist 流水线中选中新的对话实体。步骤见手动安装说明。

使用约束

• 需要 Home Assistant 2026.10 或更新版本，这是项目测试过的版本。
• 需要一个可用的 Hermes Agent 模型提供方，以及一个语音终端。只有经 echo-dot-assist 刷写的 Echo Dot 二代被记录为端到端测试过，其他 Echo 机型和 Assist 终端预计可用但未经本项目测试。
• 文档中的单机 Docker 方案基于 macOS 的 Docker Desktop；在 Linux 原生 Docker 下需要为 Home Assistant 容器配置可达地址。
• 如果语音配置与主智能体共用模型提供方账号，就会共享限流；遇到 429、超时或连接错误时，集成朗读兜底句而非错误文本。
• 记忆按配置划分而非按说话人划分，设备上所有人说过的话都可能被记住。
• 随附的 hey_hermes.tflite 唤醒词模型仅限非商业使用，代码本身为 MIT 许可。
• v0.1 中 Hermes 不会获得 Home Assistant 设备控制工具，除非给该配置接入 Home Assistant 的 MCP 服务器。

HotRepo 点评

在 HotRepo 的新项目榜中，Hermes Voice 于 2026-11-05 出现在 Python 榜，当天从早上开始约 14 小时的窗口内新增 105 个 Star 和 7 个 Fork。这只是单次快照，不能当作趋势，且该项目还没有记录到 GitHub 全语言日榜名次。数据能说明的是它的定位很窄：只在 Hermes、Home Assistant Assist 和 echo-dot-assist 之上补齐对话智能体、配置技能、配置文档和唤醒词模型，不重复实现这些既有组件。README 明确给出约 3.5 秒的单轮延迟（主要来自模型）和唯一测试过的 Echo 机型，因此它适合已有 Hermes 与 Home Assistant 环境的用户，不适合期待开箱即用语音助手的人。