index-tts

环境要求

• 需先安装 uv 包管理器，README 明确要求用它管理依赖环境
• uv sync 会自动创建 .venv 项目目录，并安装正确版本的 Python 与全部依赖
• 若安装过程出现 CUDA 报错，需系统已安装 NVIDIA CUDA Toolkit 12.8 或更新版本
• Windows 上 DeepSpeed 可能难以安装，可去掉 --all-extras 并手动选择扩展

安装与启动步骤

1. 1准备项目源码

   README 节选从“2. Install Dependencies”开始，未给出获取源码的命令；请先从 GitHub 仓库 index-tts/index-tts 取得代码并进入项目目录，此步不臆造命令。

2. 2安装 uv

   uv 是项目依赖管理的必需工具，README 要求先安装它，否则无法可靠安装依赖。

   pip install -U uv

   复制

3. 3同步全部依赖

   在项目根目录执行，会自动创建 .venv 并安装正确版本的 Python 和所有依赖，包含全部额外功能。

   uv sync --all-extras

   复制

4. 4国内镜像加速

   如果依赖下载缓慢，可改用国内镜像源，README 给出阿里云与清华两种可选地址，二者选其一执行。

   uv sync --all-extras --default-index "https://mirrors.aliyun.com/pypi/simple"

   复制

5. 5按需定制扩展

   不想装全部扩展时，去掉 --all-extras，手动加 --extra webui（推荐）和 --extra deepspeed（可能加速推理）。

   uv sync --extra webui --extra deepspeed

   复制

6. 6检查 CUDA 环境

   若安装时报 CUDA 错误，需确认系统已装 NVIDIA CUDA Toolkit 12.8 或更新版本，装好后重新同步依赖。

如何确认成功

README 未给出启动或验证命令；执行 uv sync 全程无报错、项目目录下生成 .venv 即视为依赖安装成功。

常见问题

注意事项

• README 节选只包含依赖安装说明，未给出模型权重下载与推理/启动命令，需另行查阅仓库完整文档。
• 最新版本为 IndexTTS-2.5，支持中文、英文、日文、西班牙文和阿拉伯文，并支持情感、语速和发音控制。
• 模型权重可从 ModelScope（IndexTeam/IndexTTS-2.5）或 HuggingFace 获取，README 同时提供了在线 Demo 与 Studio 体验入口。
• --all-extras 会装入所有额外功能，按需可只选 --extra webui 或 --extra deepspeed。