acestep-docs

name	acestep-docs
description	ACE-Step documentation and troubleshooting. Use when users ask about installing ACE-Step, GPU configuration, model download, Gradio UI usage, API integration, or troubleshooting issues like VRAM problems, CUDA errors, or model loading failures.
allowed-tools	Read, Glob, Grep

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

1. Installation questions → read getting-started/README.md
2. General usage / best practices → read getting-started/Tutorial.md
3. Project overview / architecture → read getting-started/ABOUT.md
4. Web UI questions → read guides/GRADIO_GUIDE.md
5. Inference parameter tuning → read guides/INFERENCE.md
6. GPU/VRAM issues → read guides/GPU_COMPATIBILITY.md
7. Environment setup (uv, python_embeded) → read guides/ENVIRONMENT_SETUP.md
8. Launch script configuration (.bat/.sh) → read guides/SCRIPT_CONFIGURATION.md
9. Updates and backup → read guides/UPDATE_AND_BACKUP.md
10. 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