README_HF.md

metadata

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