快速搭建 xiao/xiaozhi 环境：5分钟启动你的AI语音助手

快速搭建 xiao/xiaozhi 环境：5分钟启动你的AI语音助手

【免费下载链接】xiaozhiBuild your own AI friend项目地址: https://gitcode.com/gh_mirrors/xiao/xiaozhi

xiao/xiaozhi是一款能够帮助你构建专属AI朋友的开源项目，通过简单的配置即可实现语音交互功能。本文将带你快速完成环境搭建，让你在5分钟内拥有自己的AI语音助手。

📋 准备工作

在开始搭建前，请确保你的系统已安装以下依赖：

• Node.js（建议v14+）
• Python 3.7+
• Git

首先，克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/xiao/xiaozhi cd xiaozhi

🔧 后端服务配置

1. ASR服务（语音识别）

进入ASR服务目录并安装依赖：

cd asr-server npm install

配置文件位于 asr-server/config.js，主要包含以下端口设置：

• asrFrontendPort：前端WebSocket端口
• asrBackendPort：后端任务分发端口

启动ASR服务：

node app.js

启动成功后会显示"ASR前端服务器正在监听端口"的提示信息。

2. TTS服务（语音合成）

打开新终端，进入TTS服务目录并安装依赖：

cd tts-server npm install

配置文件位于 tts-server/config.js，主要配置项：

• ttsFrontendPort：TTS前端服务端口

启动TTS服务：

node app.js

启动成功后会显示"TTS 前端服务已启动，监听端口"的提示信息。

3. ASR Worker（语音识别处理）

打开新终端，进入ASR Worker目录并安装依赖：

cd asr-worker pip install -r requirements.txt

需要配置环境变量（具体变量可参考 asr-worker/README.md），然后启动Worker：

python app.py

🚀 启动与测试

当所有服务都成功启动后，你可以通过WebSocket连接到相应端口进行测试：

• ASR服务默认端口：通过配置文件设置
• TTS服务默认端口：通过配置文件设置

测试TTS合成功能可以使用ffplay播放生成的音频：

ffplay -f s16le -ar 24000 -ac 1 tts.pcm

⚙️ 常见问题解决

1. 端口冲突：如果启动时报端口占用错误，可修改对应服务的config.js文件中的端口配置
2. 依赖安装失败：
   • Node依赖：尝试使用npm install --force
   • Python依赖：建议使用虚拟环境并升级pip

📝 总结

通过以上步骤，你已经成功搭建了xiao/xiaozhi的AI语音助手环境。这个项目包含了完整的语音识别(asr-server/)和语音合成(tts-server/)功能，通过简单配置即可实现自然的语音交互体验。

如果需要进一步定制，可以查看各模块的README文件了解更多高级配置选项。现在，开始与你的AI朋友对话吧！

【免费下载链接】xiaozhiBuild your own AI friend项目地址: https://gitcode.com/gh_mirrors/xiao/xiaozhi