Matcha-TTS

环境要求

• Python 3.10（README 建议使用该版本）
• pip（用于安装 matcha-tts）
• conda（可选，README 建议用它创建隔离环境）
• 可访问网络的运行环境（预训练模型会自动下载）

安装与启动步骤

1. 1创建 conda 环境

   README 建议（非必须）先建一个独立环境，指定 Python 3.10，避免与系统环境冲突。

   conda create -n matcha-tts python=3.10 -y

   复制

2. 2激活环境

   创建完成后激活该环境，后续安装和使用都在此环境中进行。

   conda activate matcha-tts

   复制

3. 3pip 安装 Matcha-TTS

   最简安装方式，直接从 PyPI 安装 matcha-tts 包，适合只想调用推理功能。

   pip install matcha-tts

   复制

4. 4从源码安装

   想改代码或本地开发时用这种方式：先装 GitHub 仓库，再进入目录做可编辑安装。

   pip install git+https://github.com/shivammehta25/Matcha-TTS.git
   cd Matcha-TTS
   pip install -e .

   复制

5. 5运行 CLI/gradio

   README 说明可用命令行 CLI、gradio 应用或 Jupyter notebook 三种方式使用，预训练模型会自动下载；具体启动命令请查看仓库最新 README。

如何确认成功

README 未给出明确验证命令；安装过程无报错即基本完成，随后可通过 CLI、gradio 应用或 Jupyter notebook 使用。

常见问题

注意事项

• conda 环境为可选项，README 标注为 suggested but optional。
• README 节选中第 3 步的运行命令被截断，实际 CLI/gradio 启动命令请以仓库最新 README 为准，不要凭猜测执行。
• 预训练模型通过 Google Drive 链接自动下载，网络受限时可能失败。
• 官方提供了 HuggingFace 在线演示，可用于快速评估效果后再决定是否本地部署。