README_HF.md

---
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.