macOS 部署安装 IndexTTS2

mixboot2025-10-30 10:33

IndexTTS2 macOS 部署安装步骤

[1. 前置要求](#1. 前置要求)
[2. 克隆仓库](#2. 克隆仓库)
[3. 安装 uv 包管理器](#3. 安装 uv 包管理器)
[4. 安装依赖](#4. 安装依赖)
[5. 下载模型](#5. 下载模型)
[6. 验证安装](#6. 验证安装)
[7. 启动 Web 界面](#7. 启动 Web 界面)
参考

1. 前置要求

首先确保已安装 Git 和 Git-LFS

javascript 复制代码

# 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Git 和 Git-LFS
brew install git git-lfs

# 启用 Git-LFS
git lfs install

2. 克隆仓库

javascript 复制代码

git clone https://github.com/index-tts/index-tts.git
cd index-tts
git lfs pull  # 下载大文件

3. 安装 uv 包管理器

javascript 复制代码

# 方式一：使用 Homebrew（推荐）
brew install uv

4. 安装依赖

javascript 复制代码

# 如果网络较慢，可使用国内镜像
uv sync --all-extras --default-index "https://mirrors.aliyun.com/pypi/simple"

# 或使用清华镜像
uv sync --all-extras --default-index "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"

# 如果网络正常，直接运行
uv sync --all-extras

5. 下载模型

使用 ModelScope

javascript 复制代码

uv tool install "modelscope"
modelscope download --model IndexTeam/IndexTTS-2 --local_dir checkpoints

6. 验证安装

javascript 复制代码

# 检查 PyTorch GPU 加速（macOS 可能不支持 CUDA，但支持 Metal）
uv run tools/gpu_check.py

javascript 复制代码

➜  index-tts git:(main) uv run tools/gpu_check.py
Scanning for PyTorch hardware acceleration devices...

PyTorch: No devices found for NVIDIA CUDA / AMD ROCm backend.
PyTorch: No devices found for Intel XPU backend.
PyTorch: Apple MPS is available!
  * Number of MPS devices found: 1

Hardware acceleration detected. Your system is ready!

7. 启动 Web 界面

javascript 复制代码

uv run webui.py

javascript 复制代码

http://127.0.0.1:7860

javascript 复制代码

sudo asitop

参考

IndexTTS2：情感表达与时长可控的自回归零样本语音合成突破