majorminorlabs/hermes-voice

选用指南

AI 根据 README 整理 · 2026/11/6 02:11:48

使用方式

通过Home Assistant Assist的对话代理使用，可配置会话模式、空闲重置等选项。

查看 README 依据

4. Settings → Voice assistants → your pipeline → Conversation agent → the new Hermes entity. The pipeline also needs speech-to-text and text-to-speech (Wyoming Whisper + Piper, or HA Cloud); `speech_setup.py` in the skill sets those up. 5. Options: session mode, idle reset, voice cleanup, voice instruction, fallback message, timeout, optional memory scope key (`X-Hermes-Session-Key`), stream replies (on), working phrase ("One moment.", said when Hermes starts a tool before saying anything; empty turns it off). Requires Home Assistant 2026.10 or newer (the version tested).

部署要求

需要Hermes Agent安装及可用的模型提供商，Home Assistant 2026.10或更高版本，以及支持echo-dot-assist的Echo设备或Assist卫星。

查看 README 依据

adds one short "answer briefly, for speech" system message (configurable). - **No Home Assistant device control in v0.1.** Hermes gets no HA tools from this integration. To let the agent control devices, give the profile Home Assistant's MCP server. ## What you need - A Hermes Agent install with a working model provider (`hermes setup`). - Docker Desktop on macOS for the one-machine setup shown below. The skill can also configure an existing Home Assistant installation. The Docker examples use `host.docker.internal`; with native

4. Settings → Voice assistants → your pipeline → Conversation agent → the new Hermes entity. The pipeline also needs speech-to-text and text-to-speech (Wyoming Whisper + Piper, or HA Cloud); `speech_setup.py` in the skill sets those up. 5. Options: session mode, idle reset, voice cleanup, voice instruction, fallback message, timeout, optional memory scope key (`X-Hermes-Session-Key`), stream replies (on), working phrase ("One moment.", said when Hermes starts a tool before saying anything; empty turns it off). Requires Home Assistant 2026.10 or newer (the version tested).

Docker on Linux, configure addresses that the Home Assistant container can reach. - A voice device: an Echo Dot running [echo-dot-assist](https://github.com/Gamer92000/echo-dot-assist) (see [devices/echo/README.md](devices/echo/README.md)), or another Assist satellite. ## Quick start (let your Hermes agent set it up) 1. Install the skill: ```bash hermes skills install majorminorlabs/hermes-voice/skill/hermes-voice-setup ``` It carries everything it needs: setup scripts, the Home Assistant integration and the "Hey Hermes" wake word model.

已知限制

v0.1版本不支持Home Assistant设备控制；语音配置文件与主代理共享提供商登录时可能共享速率限制；唤醒词模型仅在单个Echo Dot 2nd gen上测试。

查看 README 依据

adds one short "answer briefly, for speech" system message (configurable). - **No Home Assistant device control in v0.1.** Hermes gets no HA tools from this integration. To let the agent control devices, give the profile Home Assistant's MCP server. ## What you need - A Hermes Agent install with a working model provider (`hermes setup`). - Docker Desktop on macOS for the one-machine setup shown below. The skill can also configure an existing Home Assistant installation. The Docker examples use `host.docker.internal`; with native

0.03 s. Turns with a tool (web search) took 7 s in all, but speech started at about 3 s with "One moment." (streaming, on by default). `voice_profile.py --reasoning low` makes the model answer sooner. - **Rate limits**: a voice profile that shares your main agent's provider login shares its rate limit. On 429/timeout/connection errors hermes_voice speaks a fallback line. Use a separate provider or a fallback chain ([docs/voice-profile.md](docs/voice-profile.md)). - **Memory is per profile**, not per speaker; anything said may be remembered for everyone using that device.

- **Wake word**: the "Hey Hermes" model is tested on one Echo Dot 2nd gen in one home. If it misses you or wakes on its own, adjust its threshold on the Echo's settings page. - Streaming speech needs a text-to-speech engine that supports it (Piper via Wyoming does). With others the full answer is generated before speech starts. ## Development ```bash tests/run.sh # pytest (pytest-homeassistant-custom-component), ruff, mypy in the pinned HA 2026.10.4 image tools/sync_skill_assets.sh # after changing the integration or the wake word model: refresh the skill's copies