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

结论: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-2 | 2.5版在IndexTeam/IndexTTS-2.5 |
| 模型(国内) | modelscope.cn/models/IndexTeam/IndexTTS-2 | 魔搭社区,国内下载通常更快 |
数据来源:IndexTTS官方GitHub仓库README,2026年10月查阅。
搜“IndexTTS2下载官方正版”“IndexTTS2百度网盘”时会看到很多网盘链接和整合包。它们都是第三方打包的,可能版本旧、可能被改过。官方仓库原文写明:除GitHub仓库外,其他网站和服务都不是官方的。国内下载慢,用魔搭就行,没必要找网盘。
IndexTTS2和IndexTTS2.5下载的是同一个吗?
不是,两个版本的模型分开存放。现在官方仓库默认是IndexTTS2.5,两者的区别:
| 项 | IndexTTS2 | IndexTTS2.5 |
|---|---|---|
| 支持语言 | 中文、英文 | 中、英、日、西、阿 |
| 模型仓库 | IndexTeam/IndexTTS-2 | IndexTeam/IndexTTS-2.5 |
| 下载到 | checkpoints_2目录 | checkpoints目录 |
| 推荐精度 | FP16 | BF16 |
| 启动网页界面 | uv run webui.py --version 2 --model_dir ./checkpoints_2 | uv run webui.py |
只做中英文情绪配音,下IndexTTS2;要日语、西班牙语,下2.5。两个都下也可以,放在不同目录互不影响。版本区别详见《IndexTTS2与IndexTTS2.5有什么区别》。
IndexTTS2怎么安装?五步完成
官方用uv管理Python环境,不需要自己装特定版本的Python,仓库里的.python-version文件会让uv自动装对的版本。新版本也不再需要Git LFS。
第1步:下载代码
git clone https://github.com/index-tts/index-tts.git
cd index-tts第2步:安装uv
pip install -U uv第3步:安装依赖
uv sync --all-extras
# 国内下载慢,换阿里云镜像:
uv sync --all-extras --default-index "https://mirrors.aliyun.com/pypi/simple"第4步:检查显卡是否被识别
uv run tools/gpu_check.py第5步:下载模型
# 国内推荐:魔搭社区
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本地部署需要什么硬件?
需要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卡在DeepSpeed | DeepSpeed在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降噪等功能。

| 本地部署 | 在线版 | |
|---|---|---|
| 硬件 | 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字符,浏览器打开就能用,不需要显卡。