接下来我们需要安装 ModelScope，用来下载模型权重。ModelScope 是阿里云提供的镜像站点，比 Hugging Face geng快geng稳定。 下面命令会把它装进全局工具列表里：

uv tool install modelscope==1.x.x   # 填写Zui新版号即可
如需卸载旧版本，只需运行：
uv tool uninstall modelscope
这一步不容忽视，否则后面会报缺失依赖的问题。
注意：命令里不要出现任何完整的网址哦，只保留工具名和版本号就行。


小提示：Ru果你Yi经装过 ModelScope，可直接跳到下一步，不用再装一次。

bash 

modelscope version 

若Neng输出版本号说明 OK。
bash 


克隆项目并拉取大文件
因为 IndexTTS2 的仓库使用了 Git LFS 管理大量音频样例，所以普通 git clone 后目录里的 examples 文件夹只会出现几百字节的指针文件。Ru果想真正拿到音频，就必须执行一次 git lfs pull。
下面是一种常见Zuo法：

git lfs install           # 第一次运行即可完成初始化
git clone       # 用你自己的仓库地址替换占位符
cd index-tts              # 切换到项目根目录
git lfs pull               # 会自动把指针替换为真实文件
ls examples/*.wav        # Ru果kan到几十个 .wav 就 OK！
``
Ru果执行git lfs pull` 报 “exceeded quota” 那就说明该仓库月度流量Yi满，需要等待重置或改用其他镜像下载。
安装依赖与 CUDA 检查
IndexTTS2 的依赖主要通过 pyproject.toml 管理，我们Ke以让 uv 一键安装：

uv sync --extra webui
uv sync --extra webui \
       --default-index "https://mirrors.aliyun.com/pypi/simple"
启动 GPU 检测脚本kankan是否真的Neng利用显卡：

uv run tools/gpu_check.py    # 输出 Hardware acceleration detected... 就 OK！

若提示未检测到 GPU，请检查 NVIDIA 驱动是否Zui新以及 CUDA 与 PyTorch 的兼容性。


下载模型权重
IndexTTS2 的主模型分布在 ModelScope 上，你Ke以直接用它自带的 CLI 下载：

modelscope download \
    --model IndexTeam/IndexTTS-vX.Y-Z \
    --local_dir checkpoints     # 权重会放进 checkpoints 文件夹内

⚠️ 小提醒有时 ModelScope 会要求你登录账号才Neng下载，但一般来说公开仓库dou是免费可下。
启动 WebUI 界面
现在所有东西dou准备好了Ke以直接启动 WebUI：

uv run webui.py                # 默认以 FP32 模式运行；若显存充足可加参数开启 FP16
uv run webui.py --fp16         # FP16 Neng让显存占用减半，但不一定支持所有显卡

打开浏览器输入那个地址，你就Nengkan到漂亮的可视化界面了。
界面左侧通常有“上传参考音频”“输入文字”“合成”等按钮。上传一段语音片段，然后输入一句话，再点“合成”，几秒钟后就Neng得到 AI 合成后的 wav 或 mp4。
贴心小功Neng点击生成按钮旁边的小齿轮Ke以调节情感数值以及语速，让声音geng贴合你的需求。
常见错误与排查


  
错误
  
原因
  
解决办法



  
ModuleNotFoundError: No module named 'pkg_resources'
  
uv 没自动拉取 setuptools
  
手动执行 pip install setuptools wheel 或在 uv 环境中加入这两个包


  
未检测到 GPU
  
驱动太旧 / CUDA 与 PyTorch 不兼容
  
geng新 NVIDIA 驱动并确认 torch.version.cuda 与系统 CUDA 匹配


  
git lfs 超额额度
  
月度流量Yi满
  
等待额度重置或使用国内镜像手工下载 .zip 包再手动解压


  
启动时报错 “CUDA Runtime missing”
  
未安装 NVIDIA CUDA Toolkit
  
安装对应版本 Toolkit 或关闭 cuda-kernel 参数




 & 心得分享
哎呀，部署一路上我确实遇到了不少小问题，但只要按顺序走，一般douNeng解决。我Zui喜欢的一点是 IndexTTS2 Neng把一句简短的话变成几秒钟自然流畅的中文语音，而且还Neng根据不同情绪Zuo微调——真的是太酷了！
Ru果你想进一步提升性Neng，Ke以考虑手工编译 DeepSpeed 或者尝试geng强大的 RTX 显卡；但对于普通用户来说一个 RTX 3060 或geng低配置完全Ke以满足日常需求。
Zui后祝大家玩转 IndexTTS2，也欢迎随时留言交流经验，共同进步！