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 终端中运行：
   ```bash
   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](README.md)

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📄 许可证

Apache License 2.0