How to Install Ace-Step 1.5 XL Locally for AI Music | Alpha | PandaiTech

How to Install Ace-Step 1.5 XL Locally for AI Music

A step-by-step guide on setting up Ace-Step 1.5 on your local machine using the UV package manager and Git, including how to download the Turbo XL model from Hugging Face.

Learning Timeline
Key Insights

Choosing the Right Model

Ace-Step 1.5 offers three models: 'Base' for training, 'SFT' for high quality but slower speeds, and 'Turbo' for fast music generation. For general use, choose the Turbo model.

Benefits of Virtual Environments

UV automatically creates a Virtual Environment that acts like an 'isolated hard drive,' ensuring that Ace-Step libraries do not conflict with or break your computer's original Python settings.

Storage Requirements

Ensure you have at least 30GB-40GB of free space, as Torch requires 3GB and the Turbo XL model alone takes up 20GB.
Step by Step

Step 1: Installing UV Package Manager

  1. Open the Windows Start menu and type 'PowerShell'.
  2. Right-click on Windows PowerShell and select 'Run as Administrator'.
  3. Copy the UV installation command from the official link or description.
  4. Paste it into PowerShell and press Enter.
  5. Wait for the system to confirm that UV has been successfully installed, then close PowerShell.

Step 2: Installing Git

  1. Visit the official Git website and download the Windows installer.
  2. Open the downloaded installer file.
  3. Click 'Next' for the default installation path (Program Files/Git).
  4. Continue clicking 'Next' for all other default settings without changing anything.
  5. Click 'Install' and wait for the process to complete.

Step 3: Cloning the Ace-Step 1.5 Repository

  1. Open File Explorer and navigate to the folder where you want to install Ace-Step (e.g., Desktop).
  2. Click on the address bar at the top of the folder.
  3. Type 'cmd' and press Enter to open Command Prompt directly in that folder.
  4. Type the command 'git clone' followed by the Ace-Step 1.5 repository URL.
  5. Wait for all the files to finish copying to your computer.

Step 4: Setting Up Environment & Dependencies

  1. Enter the newly created 'ACE-Step-1.5' folder.
  2. Click on the folder's address bar, type 'cmd', and press Enter.
  3. Type the command 'uv sync' and press Enter.
  4. The system will begin creating a Virtual Environment and downloading all necessary libraries (including Torch, which is 3GB).
  5. Ensure the process finishes without any error messages before proceeding to the next step.

Step 5: Downloading the Turbo XL Model

  1. Open Command Prompt again within the ACE-Step 1.5 folder.
  2. Copy the HuggingFace CLI command for the Turbo XL model (refer to the Snippet section).
  3. Paste the command into Command Prompt and press Enter.
  4. Wait for the download to complete (the file size is approximately 20GB).
  5. Once finished, the interface and model are ready to be used.

More from Create AI Voice & Music

View All