---

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