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
BAT_CONFIGURATION.md	Configuring startup scripts (language, port, download source, etc.)
UPDATE_AND_BACKUP.md	For portable package users: Git updates, file backup, conflict resolution

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. BAT file configuration → read guides/BAT_CONFIGURATION.md
9. Portable package 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/BAT_CONFIGURATION.md
• uv not found: See guides/ENVIRONMENT_SETUP.md
• Environment detection issues: See guides/ENVIRONMENT_SETUP.md
• BAT file configuration: See guides/BAT_CONFIGURATION.md
• Portable package update issues: See guides/UPDATE_AND_BACKUP.md
• Update conflicts (portable package): See guides/UPDATE_AND_BACKUP.md
• Inference quality issues: See guides/INFERENCE.md
• Gradio UI not starting: See guides/GRADIO_GUIDE.md