ACE-Step-Custom / README.md
ACE-Step Custom
Use official ACE-Step model downloader for automatic model downloads
ee19acb
---
title: ACE-Step 1.5 Custom Edition
emoji: 🎡
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: false
license: mit
python_version: 3.11
---
# ACE-Step 1.5 Custom Edition
A comprehensive music generation system built on ACE-Step 1.5, featuring three specialized interfaces.
**Models will download automatically on first run (~7GB)** from the official ACE-Step repository.
## 🌟 Features
### 1. Standard ACE-Step Interface
Full-featured standard ACE-Step 1.5 GUI with all original capabilities including:
- Text-to-music generation with style control
- Variation generation
- Section repainting
- Lyric editing
### 2. Custom Timeline Workflow
Advanced timeline-based generation system:
- Generate 32-second clips with seamless blending
- Adjustable context length (0-120 seconds) for style consistency
- Master timeline with visual representation
- Extend, inpaint, and remix capabilities
- Automatic crossfading between clips
### 3. LoRA Training Studio
Complete training interface for custom models:
- Upload and preprocess audio files
- Configure training parameters
- Train specialized models for voices, instruments, or styles
- Download and reuse trained models
- Continue training from existing LoRAs
## πŸš€ Quick Start
1. **First Launch**: Models download automatically from `ACE-Step/Ace-Step1.5`
2. **Standard Generation**: Use Tab 1 for traditional text-to-music
3. **Timeline Creation**: Use Tab 2 to build longer songs with consistent style
4. **Custom Training**: Use Tab 3 to create specialized models
## πŸ“š About
Full-featured standard ACE-Step 1.5 GUI with all original capabilities including:
- Text-to-music generation with style control
- Variation generation
- Section repainting
- Lyric editing
### 2. Custom Timeline Workflow
Advanced timeline-based generation system:
- Generate 32-second clips with seamless blending
- Adjustable context length (0-120 seconds) for style consistency
- Master timeline with visual representation
- Extend, inpaint, and remix capabilities
- Automatic crossfading between clips
### 3. LoRA Training Studio
Complete training interface for custom models:
- Upload and preprocess audio files
- Configure training parameters
- Train specialized models for voices, instruments, or styles
- Download and reuse trained models
- Continue training from existing LoRAs
## πŸš€ Quick Start
1. **Standard Generation**: Use Tab 1 for traditional text-to-music
2. **Timeline Creation**: Use Tab 2 to build longer songs with consistent style
3. **Custom Training**: Use Tab 3 to create specialized models
## πŸ’‘ Tips
- Start with context length of 30-60s for best results
- For custom voices, train LoRA with 20+ audio samples
- Adjust temperature between 0.6-0.8 for quality vs creativity
- Use "Extend" in Timeline mode to continue your song
## 🎯 Use Cases
- **Musicians**: Create backing tracks and song ideas
- **Content Creators**: Generate royalty-free music for videos
- **Game Developers**: Create adaptive game soundtracks
- **AI Researchers**: Experiment with music generation and LoRA training
## πŸ“š Documentation
See the repository for full documentation and examples.
## πŸ™ Credits
Built on top of [ACE-Step](https://ace-step.github.io/) by ACE Studio and Step Fun.
## ⚠️ Note
This is a custom implementation focusing on enhanced workflows and training capabilities. Generation quality depends on the base ACE-Step model and your usage patterns.