Onju Voice 使用指南
onju-voice A hackable AI home assistant platform 项目地址: https://gitcode.com/gh_mirrors/onj/onju-voice
1. 项目介绍
Onju Voice 是一个开源的智能家居助手平台,采用了 Google Nest Mini (第二代) 的外形。它由一个自定义的 PCB 板(作为原装的替代品,使用 ESP32-S3 处理音频)和一个服务器组成,服务器负责处理转录、生成响应以及多个设备在同一网络上的文本转语音(TTS)。
该项目主要关注实验性的对话大型语言模型(LLM)方面,以复制演示中展示的功能,并不是作为一个完整功能的家务助手替代品。该项目目前没有积极维护,但是已经发布了所有的源代码和设计文件,供其他人接手和继续开发。
2. 项目快速启动
服务器安装
- 确保你可以安装 Whisper 并且至少运行基础模型,如果遇到问题,遵循他们的调试步骤。
- 切换到服务器目录:
cd server
- 安装依赖:
pip install -r requirements.txt
- 在
config.yaml
文件中调整设置,比如处理前的静音时间等。 - 将你的 Elevenlabs 令牌添加到
credentials.json
文件中,并在config.yaml
文件下设置默认的 Elevenlabs 语音。 - 在
config.yaml
文件中设置一个欢迎 WAV 文件,该文件会在设备连接到 WiFi 时发送给设备。
Home Assistant 安装
- 我建议在同一个服务器或者网络中始终插电的设备上设置 Home Assistant,遵循 Docker Compose 指令。
- 完成入门设置,建立一个用户,命名你的设备,并获取一个长期令牌,将其添加到
credentials.json
文件中,包括 URL,例如http://my-local-server:8123/
。
Maubot 安装
- 按照这里的说明设置 Maubot 和你的 Beeper 账户。
- 确保在
config.yaml
文件中设置了正确的 URL,将send_replies
设置为 True,如果你的朋友能忍受偶尔的错误,还可以设置一个footer
。
3. 应用案例和最佳实践
查询和回复消息
使用自定义的 Maubot 插件和Beeper进行消息查询和回复。
灯光控制
与 Home Assistant 集成,实现灯光控制。
添加和检索笔记/备忘录
为大型语言模型添加和检索笔记/备忘录,以便生成响应。
4. 典型生态项目
目前该项目作为一个实验性的平台,并没有明确指定其生态项目。不过,以下是一些可能的典型生态项目:
- 多用户对话处理和识别
- 实时打断和回声消除功能
- 使用更小的本地模型/LLM 进行分类和意图检测,然后路由到大型 LLM
请根据上述指南进行操作,开始你的 Onju Voice 之旅。
onju-voice A hackable AI home assistant platform 项目地址: https://gitcode.com/gh_mirrors/onj/onju-voice