Learn-skills.dev acestep-docs

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.

install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/ace-step/ace-step-1.5/acestep-docs" ~/.claude/skills/neversight-learn-skills-dev-acestep-docs && rm -rf "$T"
manifest: data/skills-md/ace-step/ace-step-1.5/acestep-docs/SKILL.md
source content

ACE-Step Documentation

Documentation skill for ACE-Step music generation system.

Quick Reference

Getting Started

DocumentDescription
README.mdInstallation, model download, startup commands
Tutorial.mdGetting started tutorial, best practices
ABOUT.mdProject overview, architecture, model zoo

Guides

DocumentDescription
GRADIO_GUIDE.mdWeb UI usage guide
INFERENCE.mdInference parameters tuning
GPU_COMPATIBILITY.mdGPU/VRAM configuration, hardware recommendations
ENVIRONMENT_SETUP.mdEnvironment detection, uv installation, python_embeded setup (Windows/Linux/macOS)
SCRIPT_CONFIGURATION.mdConfiguring launch scripts: .bat (Windows) and .sh (Linux/macOS)
UPDATE_AND_BACKUP.mdGit updates, file backup, conflict resolution (all platforms)

API (for developers)

DocumentDescription
API.mdREST API documentation
Openrouter_API.mdOpenRouter 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