windows部署ACE-Step记录
https://github.com/ace-step/ACE-Step
1.克隆存储库
首先,将 ACE-Step 存储库克隆到本地计算机并导航到项目目录:
git clone https://github.com/ace-step/ACE-Step.git
cd ACE-Step
2. 先决条件
确保已安装以下软件:
Python
:建议使用 3.10 或更高版本。您可以从python.org下载。Conda
或venv
:创建虚拟环境(建议使用 Conda)。
3. 设置虚拟环境
强烈建议使用虚拟环境来管理项目依赖关系并避免冲突。请选择以下方法之一:
选项 A:使用 Conda
-
ace_step
创建以 Python 3.10命名的环境:conda create -n ace_step python=3.10 -y
-
激活环境:
conda activate ace_step
4.安装依赖项
激活虚拟环境后: a.(仅限 Windows)如果您使用的是 Windows 并计划使用 NVIDIA GPU,请先安装支持 CUDA 的 PyTorch:
pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu126
(如果您有不同的 CUDA 版本,请调整 cu126。有关其他 PyTorch 安装选项,请参考PyTorch 官方网站)。
b.安装 ACE-Step 及其核心依赖项:
pip install -e .
高级用法
acestep --checkpoint_path /path/to/checkpoint --port 7865 --device_id 0 --share true --bf16 true
- 如果
--checkpoint_path
设置了并且模型存在于路径中,则从加载checkpoint_path
。 - 如果
--checkpoint_path
设置了,但路径中不存在模型,则自动下载模型到checkpoint_path
。 - 若未
--checkpoint_path
设置,则自动下载模型到默认路径~/.cache/ace-step/checkpoints
。
如果您使用的是 macOS,请使用--bf16 false
以避免错误。
- Windows Powershell
$env:HF_ENDPOINT = "https://hf-mirror.com"