ACE-Step Documentation

Documentation skill for ACE-Step music generation system.

Quick Reference

Getting Started

Document Description

README.md Installation, model download, startup commands

Tutorial.md Getting started tutorial, best practices

ABOUT.md Project overview, architecture, model zoo

Guides

Document Description

GRADIO_GUIDE.md Web UI usage guide

INFERENCE.md Inference parameters tuning

GPU_COMPATIBILITY.md GPU/VRAM configuration, hardware recommendations

ENVIRONMENT_SETUP.md Environment detection, uv installation, python_embeded setup (Windows/Linux/macOS)

SCRIPT_CONFIGURATION.md Configuring launch scripts: .bat (Windows) and .sh (Linux/macOS)

UPDATE_AND_BACKUP.md Git updates, file backup, conflict resolution (all platforms)

API (for developers)

Document Description

API.md REST API documentation

Openrouter_API.md OpenRouter API integration

Instructions

• Installation questions → read getting-started/README.md

• General usage / best practices → read getting-started/Tutorial.md

• Project overview / architecture → read getting-started/ABOUT.md

• Web UI questions → read guides/GRADIO_GUIDE.md

• Inference parameter tuning → read guides/INFERENCE.md

• GPU/VRAM issues → read guides/GPU_COMPATIBILITY.md

• Environment setup (uv, python_embeded) → read guides/ENVIRONMENT_SETUP.md

• Launch script configuration (.bat/.sh) → read guides/SCRIPT_CONFIGURATION.md

• Updates and backup → read guides/UPDATE_AND_BACKUP.md

• API development → read api/API.md or api/Openrouter_API.md

Common Issues

• Installation problems: See getting-started/README.md

• VRAM insufficient: See guides/GPU_COMPATIBILITY.md

• Model download failed: See getting-started/README.md or guides/SCRIPT_CONFIGURATION.md

• uv not found: See guides/ENVIRONMENT_SETUP.md

• Environment detection issues: See guides/ENVIRONMENT_SETUP.md

• BAT/SH script configuration: See guides/SCRIPT_CONFIGURATION.md

• Update and backup: See guides/UPDATE_AND_BACKUP.md

• Update conflicts: See guides/UPDATE_AND_BACKUP.md

• Inference quality issues: See guides/INFERENCE.md

• Gradio UI not starting: See guides/GRADIO_GUIDE.md