TTS-Mini 项目在 Ubuntu 24 服务器上的安装指南

TTS-Mini 项目在 Ubuntu 24 服务器上的安装指南

系统要求

• Ubuntu 24 服务器

• sudo 权限用户

📋 完整安装步骤

1. 安装系统依赖

bash

sudo apt update
sudo apt install -y git python3 python3-pip python3-venv espeak-ng

2. 添加 Python 3.11 支持（Ubuntu 24 必需步骤）

bash

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update
sudo apt install -y python3.11 python3.11-venv python3.11-dev

3. 获取项目代码

bash

git clone https://github.com/Akyl-AI/tts-mini.git
cd tts-mini

4. 创建 Python 3.11 虚拟环境

bash

python3.11 -m venv venv
source venv/bin/activate

5. 安装项目依赖

bash

pip install --upgrade pip
pip install -r requirements.txt

6. 以可编辑模式安装项目

bash

pip install -e .

🚀 使用方法

安装完成后，可以使用 matcha-tts 命令：

bash

# 示例：合成语音
matcha-tts --text "你好，这是一个语音合成测试"

⚠️ 注意事项

1. 关键步骤：Ubuntu 24 必须通过 PPA 安装 Python 3.11

2. 虚拟环境：务必使用 Python 3.11 创建虚拟环境

3. 可编辑安装：pip install -e . 确保命令行工具可用

🔧 故障排除

如果遇到问题：

• 确认 Python 版本：python --version 应该显示 3.11.x

• 确认虚拟环境已激活：命令行前应有 (venv) 提示

• 检查依赖安装：pip list | grep matcha