Install Guide

Как Установить ACE-Step Локально

Полное руководство по настройке для Windows, macOS и Linux — включая устранение наиболее распространённых ошибок.

Последнее обновление: Февраль 2026

Системные Требования

ComponentMinimumRecommended
GPUNVIDIA RTX 2080 (8GB VRAM)NVIDIA RTX 3090/4090 (24GB VRAM)
CPUIntel i7-8700 / AMD Ryzen 7 3700XIntel i9-12900K / AMD Ryzen 9 5900X
RAM16GB DDR432GB+ DDR4
Storage20GB SSD50GB+ NVMe SSD
CUDA Version11.812.1
Python3.93.10 or 3.11
OSWindows 10, macOS 12, Ubuntu 20.04Ubuntu 22.04 LTS (best performance)

Шаги Установки

  1. 1

    Установить Conda или Miniconda

    Скачайте и установите Miniconda с conda.io. Это управляет вашей средой Python и предотвращает конфликты зависимостей.

  2. 2

    Клонировать Репозиторий

    Выполните: git clone https://github.com/ace-step/ACE-Step.git && cd ACE-Step

    git clone https://github.com/ace-step/ACE-Step.git
cd ACE-Step
  3. 3

    Создать Окружение Conda

    Выполните: conda env create -f environment.yml && conda activate ace-step

    conda env create -f environment.yml
conda activate ace-step
  4. 4

    Установить PyTorch с CUDA

    Для CUDA 11.8: pip install torch==2.0.1+cu118 -f https://download.pytorch.org/whl/cu118/torch_stable.html

    pip install torch==2.0.1+cu118 torchvision==0.15.2+cu118 torchaudio==2.0.2+cu118 \
  -f https://download.pytorch.org/whl/cu118/torch_stable.html
  5. 5

    Скачать Веса Модели

    Выполните: python download_models.py для загрузки чекпоинта модели (~15GB) с HuggingFace.

    python download_models.py
  6. 6

    Запустить Web UI

    Выполните: python app.py для запуска веб-интерфейса Gradio на http://localhost:7860

    python app.py

Оптимизация Производительности

Для более быстрой генерации используйте точность FP16 (флаг --fp16) на поддерживаемых GPU. Установите xformers для xFormers-внимания и ускорения на 30-40%.

pip install xformers
python app.py --fp16

Распространённые Проблемы и Решения

Ошибка Нехватки Памяти (OOM)

При ошибках CUDA OOM попробуйте включить 8-битное квантование, добавив --quantize int8 к команде запуска. Также можно включить выгрузку на CPU с --cpu-offload.

python app.py --quantize int8
# or
python app.py --cpu-offload --fp16

Конфликты Зависимостей

ACE-Step требует конкретных версий PyTorch и CUDA. Всегда используйте предоставленный файл окружения conda или requirements.txt.

Порт Уже Занят

Если порт 7860 занят, добавьте --port 7861 (или любой доступный порт) к команде запуска Gradio.

python app.py --port 7861

Путь к Модели Не Найден

Убедитесь, что у вас достаточно места на диске (~15GB для весов модели). Запускайте скрипт загрузки из корневого каталога проекта.

FAQ

Пропустите Настройку Полностью

Не любите команды терминала и ад зависимостей? FM9 предлагает облачную генерацию ИИ-музыки в вашем браузере. Без GPU, без настройки, без ожидания.

Начать Создавать Бесплатно

Связанные Статьи