Verbi语音助手本地部署指南：MeloTTS和Piper安装教程

Verbi是一个模块化的语音助手应用程序，支持最新的转录、响应生成和文本转语音模型。本指南将详细介绍如何在本地环境中部署Verbi语音助手，并配置MeloTTS和Piper两种本地TTS模型。

环境准备与项目安装

首先确保您的系统满足以下要求：

• Python 3.10或更高版本
• 虚拟环境（推荐使用）

第一步：克隆项目仓库

git clone https://gitcode.com/GitHub_Trending/ve/Verbi.git
cd Verbi

第二步：创建虚拟环境

python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或 venv\Scripts\activate  # Windows

第三步：安装依赖包

pip install -r requirements.txt

第四步：配置环境变量 创建.env文件并添加必要的API密钥：

OPENAI_API_KEY=your_openai_api_key
GROQ_API_KEY=your_groq_api_key
DEEPGRAM_API_KEY=your_deepgram_api_key

MeloTTS本地TTS安装配置

MeloTTS是一个高质量的本地文本转语音模型，提供自然的语音合成效果。

安装步骤：

1. 参考MeloTTS官方文档安装指南
2. 安装完成后，启动本地API服务器：

python voice_assistant/local_tts_api.py

配置文件修改： 在voice_assistant/config.py中将TTS模型设置为melotts：

TTS_MODEL = 'melotts'

Piper本地TTS安装配置

Piper是一个轻量级且快速的文本转语音引擎，适合资源受限的环境。

安装步骤：

1. 从Piper GitHub页面下载二进制文件
2. 下载所需的语音模型文件（.onnx和.onnx.json）
3. 编辑piper_server.py配置文件：

piper_executable = "./piper/piper"  # Piper二进制路径
model_path = "en_US-lessac-medium.onnx"  # 语音模型路径

启动Piper服务器：

python piper_server.py

配置文件修改： 在voice_assistant/config.py中将TTS模型设置为piper：

TTS_MODEL = 'piper'

运行Verbi语音助手

完成所有配置后，您可以启动语音助手：

python run_voice_assistant.py

系统将开始监听您的语音输入，使用本地TTS模型生成响应，实现完全离线的语音交互体验。

常见问题解决

MeloTTS安装问题：

• 确保系统已安装必要的音频依赖库
• 检查Python版本兼容性

Piper语音质量问题：

• 尝试不同的语音模型文件
• 调整音频采样率和比特率设置

性能优化建议：

• 为MeloTTS分配足够的GPU资源
• 使用Piper时选择适合的语音模型大小

通过本指南，您已经成功在本地部署了Verbi语音助手，并配置了MeloTTS和Piper两种本地TTS解决方案。这两种方案各有优势：MeloTTS提供更自然的语音质量，而Piper则在速度和资源占用方面表现更佳。您可以根据实际需求选择合适的TTS引擎，享受完全离线的语音助手体验。