README_HF_SPACES.md

Reachy Mini Home Assistant Voice Assistant - Hugging Face Spaces

这是一个可以通过 Hugging Face Spaces 一键安装的 Reachy Mini 语音助手应用，用于连接 Home Assistant。

🚀 通过 Hugging Face Spaces 安装

1. 访问你的 Reachy Mini 仪表板
2. 进入 "Applications" -> "Install from Hugging Face"
3. 搜索 "reachy-mini-ha-voice"
4. 点击 "Install" 按钮
5. 等待安装完成

安装完成后，应用程序将出现在 "Applications" 列表中。

⚙️ 配置

安装后，点击应用设置图标进行配置：

• Device Name: 设备名称（默认: ReachyMini）
• Enable Reachy: 启用 Reachy Mini 机器人集成（默认: true）
• Audio Input Device: 音频输入设备索引
• Audio Output Device: 音频输出设备索引
• Wake Word: 唤醒词（默认: okay_nabu）

🔌 连接到 Home Assistant

1. 在 Home Assistant 中，进入 "设置" -> "设备与服务"
2. 点击 "添加集成" 按钮
3. 选择 "ESPHome" 然后选择 "设置另一个 ESPHome 实例"
4. 输入 Reachy Mini 的 IP 地址和端口 6053
5. 点击 "提交"

📝 使用说明

启动应用

在 Reachy Mini 仪表板中：

1. 找到 "reachy-mini-ha-voice" 应用
2. 点击 "Run" 按钮启动
3. 应用将在端口 6053 上运行

唤醒词

默认唤醒词是 "Okay Nabu"。你可以说：

• "Okay Nabu, turn on the lights"
• "Okay Nabu, what's the weather?"
• "Okay Nabu, set a timer for 5 minutes"

Reachy Mini 动作

当启用 Reachy Mini 集成时，机器人会对不同的语音状态做出反应：

• 唤醒时: 头部抬起
• 监听中: 头部轻微摆动
• 响应中: 点头
• 停止时: 摇头

🔧 故障排除

音频设备问题

如果无法检测到音频设备：

1. 在 Reachy Mini 终端中运行：

   python -m reachy_mini_ha_voice --list-input-devices
   python -m reachy_mini_ha_voice --list-output-devices
   

2. 在应用配置中设置正确的设备索引

连接问题

如果无法连接到 Home Assistant：

1. 检查 Reachy Mini 和 Home Assistant 是否在同一网络
2. 确认端口 6053 未被防火墙阻止
3. 查看 Home Assistant 日志中的连接错误

调试模式

启用调试日志：

在应用配置中添加环境变量：

DEBUG=true

📚 更多信息

完整文档请访问: README.md

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

Apache License 2.0