IndexTTS2
使用教程

IndexTTS2下载:官方正版地址、安装教程与本地部署硬件要求(2026)

开发者在电脑上下载并安装IndexTTS2模型

结论:IndexTTS2的官方正版只在三个地方发布。代码在GitHub仓库index-tts/index-tts,模型权重在Hugging Face和魔搭社区的IndexTeam账号下,官方不提供网盘安装包和整合包。安装用uv管理环境,三条命令装好依赖,再用hf或modelscope命令下载模型,国内用魔搭更快。

硬件上需要NVIDIA显卡,安装报CUDA错误时官方建议装CUDA Toolkit 12.8及以上;官方没有给出具体的显存数字,只说明半精度推理(IndexTTS2用FP16,2.5用BF16)能明显降低显存占用。没有显卡、不想折腾环境,可以直接用在线版。

IndexTTS2官方正版在哪下载?

IndexTTS2的官方正版只在三个地方发布,官方不提供网盘安装包和整合包:

下载什么官方地址说明
代码github.com/index-tts/index-tts官方声明的唯一官方渠道
模型(国际)huggingface.co/IndexTeam/IndexTTS-22.5版在IndexTeam/IndexTTS-2.5
模型(国内)modelscope.cn/models/IndexTeam/IndexTTS-2魔搭社区,国内下载通常更快

数据来源:IndexTTS官方GitHub仓库README,2026年10月查阅。

搜“IndexTTS2下载官方正版”“IndexTTS2百度网盘”时会看到很多网盘链接和整合包。它们都是第三方打包的,可能版本旧、可能被改过。官方仓库原文写明:除GitHub仓库外,其他网站和服务都不是官方的。国内下载慢,用魔搭就行,没必要找网盘。

IndexTTS2和IndexTTS2.5下载的是同一个吗?

不是,两个版本的模型分开存放。现在官方仓库默认是IndexTTS2.5,两者的区别:

项IndexTTS2IndexTTS2.5
支持语言中文、英文中、英、日、西、阿
模型仓库IndexTeam/IndexTTS-2IndexTeam/IndexTTS-2.5
下载到checkpoints_2目录checkpoints目录
推荐精度FP16BF16
启动网页界面uv run webui.py --version 2 --model_dir ./checkpoints_2uv run webui.py

只做中英文情绪配音,下IndexTTS2;要日语、西班牙语,下2.5。两个都下也可以,放在不同目录互不影响。版本区别详见《IndexTTS2与IndexTTS2.5有什么区别》。

IndexTTS2怎么安装?五步完成

官方用uv管理Python环境,不需要自己装特定版本的Python,仓库里的.python-version文件会让uv自动装对的版本。新版本也不再需要Git LFS。

第1步:下载代码

bash
git clone https://github.com/index-tts/index-tts.git
cd index-tts

第2步:安装uv

bash
pip install -U uv

第3步:安装依赖

bash
uv sync --all-extras
# 国内下载慢,换阿里云镜像:
uv sync --all-extras --default-index "https://mirrors.aliyun.com/pypi/simple"

第4步:检查显卡是否被识别

bash
uv run tools/gpu_check.py

第5步:下载模型

bash
# 国内推荐:魔搭社区
uv tool install "modelscope"
modelscope download --model IndexTeam/IndexTTS-2 --local_dir checkpoints_2

# 或者:Hugging Face(国内可设镜像)
export HF_ENDPOINT="https://hf-mirror.com"
uv tool install "huggingface-hub"
hf download IndexTeam/IndexTTS-2 --local-dir=checkpoints_2

下载2.5时把模型名换成IndexTeam/IndexTTS-2.5,目录换成checkpoints。装好后运行启动命令,浏览器打开http://127.0.0.1:7860就是网页界面。

IndexTTS2官方WebUI界面(Hugging Face在线Demo)
官方WebUI界面:本地启动后打开127.0.0.1:7860是同一个界面(图为官方Hugging Face在线Demo)

IndexTTS2本地部署需要什么硬件?

需要NVIDIA显卡;官方没有公布最低显存要求,网上流传的“至少X GB显存”都不是官方数字。官方给出的硬件相关说明只有这几条:

项官方说明
显卡NVIDIA,可用tools/gpu_check.py检查是否识别
CUDA安装报CUDA错误时,建议装CUDA Toolkit 12.8或更高
显存未给出具体数字;半精度推理(IndexTTS2 FP16、2.5 BF16)更快、占显存更少,音质损失很小
测速环境官方推理速度在RTX 4090上测得
DeepSpeed可选,可能加速也可能变慢,建议两种都试

显存够不够,最直接的办法是装好后开半精度跑一段,看会不会爆显存。

安装常见的3个坑

问题原因解决办法
Windows上uv sync卡在DeepSpeedDeepSpeed在Windows上难装去掉--all-extras,只手动加需要的extras
运行infer_v2.py报找不到模型这个脚本里写死了checkpoints/目录,是测速用的IndexTTS2用户改用官方说明里的Python接口调用
模型下载很慢或中断Hugging Face国内访问不稳改用魔搭下载,或设置HF_ENDPOINT镜像

网上的IndexTTS2整合包、一键安装包能用吗?

能不能用要看来源,官方不提供任何整合包。整合包是第三方把代码、模型和运行环境打包在一起,解压就能跑,省去装环境的麻烦,代价是:

  • 版本可能旧:很多整合包还停留在1.5或2.0,没有2.5;
  • 来源不明:包里有可执行文件,可能被改动过;
  • 出了问题没人管:报错只能找打包的人。

用的话,至少做两件事:下载后先杀毒;核对模型文件是否和魔搭、Hugging Face上的官方版本一致。

不想下载安装,怎么直接用IndexTTS2?

两个办法:

  • 官方在线Demo:Hugging Face Space上的IndexTeam/IndexTTS-2.5-Demo,适合试听几句效果,不提供账号和声音模型管理。
  • 第三方在线版:本站indexttsonline.com把官方的IndexTTS2和2.5跑在云端,选中英文调用IndexTTS2,选日语、西班牙语、阿拉伯语自动切到2.5。上传3–10秒录音就能克隆,还有停顿、声音设计、AI降噪等功能。
IndexTTS2在线版声音克隆页面
不想本地部署:IndexTTS2在线版浏览器直接用
本地部署在线版
硬件NVIDIA显卡+CUDA 12.8及以上浏览器即可,手机也能用
上手时间熟手几十分钟,新手可能要一两天注册后几分钟
费用模型免费,电费和显卡自理注册即送150,000字符,超出按会员
适合量大、数据不能上传、要改代码日常配音、没有显卡

本站是第三方在线平台,不是IndexTTS官方。想要官方模型、跟进最新版本,以官方GitHub仓库为准;想打开浏览器就配音,可以直接在本站试。

常见问题

IndexTTS2官方正版在哪下载?
代码在GitHub仓库github.com/index-tts/index-tts,模型在Hugging Face的IndexTeam/IndexTTS-2和魔搭社区的IndexTeam/IndexTTS-2。官方仓库写明GitHub是唯一官方渠道,网盘包和整合包都不是官方发布的。
IndexTTS2和IndexTTS2.5下载有什么不同?
现在官方仓库默认是2.5。2.5的模型下载到checkpoints目录,IndexTTS2下载到checkpoints_2目录;启动网页界面时,IndexTTS2要加参数--version 2 --model_dir ./checkpoints_2。
IndexTTS2本地部署需要什么显卡?
需要NVIDIA显卡。官方没有公布最低显存,只建议用半精度推理降低显存占用;安装遇到CUDA报错,官方建议装CUDA Toolkit 12.8或更高版本。装好后可以运行uv run tools/gpu_check.py检查显卡是否被识别。
IndexTTS2有网盘下载或一键整合包吗?
官方没有。网上的网盘包和整合包都是第三方打包的,版本和安全性没有保证。国内下载慢,用官方的魔搭社区下载就行,不需要网盘。
不想下载安装,能直接在线用IndexTTS2吗?
能。官方在Hugging Face Space有在线Demo可以试听;日常配音可以用第三方在线版,本站注册即送150,000字符,浏览器打开就能用,不需要显卡。