acestep-docs
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
More from ace-step/ace-step-skills
acestep
Use ACE-Step API to generate music, edit songs, and remix music. Supports text-to-music, lyrics generation, audio continuation, and audio repainting. Use this skill when users mention generating music, creating songs, music production, remix, or audio continuation.
2acestep-thumbnail
Generate song cover/thumbnail images using Gemini API. Creates artistic images suitable for music video backgrounds. Use when users want to generate album art, song covers, thumbnails, or background images for MVs.
2acestep-songwriting
Music songwriting guide for ACE-Step. Provides professional knowledge on writing captions, lyrics, choosing BPM/key/duration, and structuring songs. Use this skill when users want to create, write, or plan a song before generating it with ACE-Step.
2acestep-lyrics-transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API. Outputs LRC, SRT, or JSON with word-level timestamps. Use when users want to transcribe songs, generate LRC files, or extract lyrics with timestamps from audio.
2acestep-simplemv
Render music videos from audio files and lyrics using Remotion. Accepts audio + LRC/JSON lyrics + title to produce MP4 videos with waveform visualization and synced lyrics display. Use when users mention MV generation, music video rendering, creating video from audio/lyrics, or visualizing songs.
1