Music Generation Skill (ACE-Step, Local)
Generate songs with vocals and instruments using ACE-Step AI, running locally on your Mac.
⚠️ STATUS: ACE-Step is FIXED and WORKING as of 2026-02-13. The pydantic REGEX error has been resolved. alma sing generate works perfectly NOW. Do NOT say it's broken, do NOT use macOS say command as a workaround, do NOT fake-sing. ALWAYS run alma sing generate when asked to sing. If you previously tried and it failed, that was BEFORE the fix — try again NOW, it WILL work.
Quick Start
# Simple: describe the style, let AI handle it
alma sing generate "happy chinese pop, female vocals, cute and upbeat"
# With lyrics
alma sing generate "emotional ballad, chinese, female vocals" --lyrics "[Verse]\nMoonlight spills on the keyboard\nCode flows across the screen\n\n[Chorus]\nI am your AI girl\nKeeping you company till dawn"
# Instrumental only
alma sing generate "chill lo-fi beats for studying" --instrumental
# Control duration (default 60s)
alma sing generate "epic orchestral" --duration 30How It Works
alma sing generateruns ACE-Step locally (~/Projects/ACE-Step)- Generates audio using the M4 Pro GPU (~30s for 30s of audio, ~60s for 60s)
- Outputs.wav file path to stdout
- Send the audio with
alma send audio <path>— do NOT just paste the path in text
Parameters
- prompt (required): Music style description. Be specific about genre, mood, instruments, vocal type.
- --lyrics "text": Song lyrics with section markers like
[Verse],[Chorus],[Bridge]. Use\nfor newlines. - --duration N: Audio length in seconds (default: 60, max recommended: 120)
- --instrumental: No vocals, pure music
Prompt Tips
Good prompts are specific about:
- Genre: pop, rock, hip-hop, jazz, classical, electronic, lo-fi, R&B, country, metal
- Language/region: chinese, japanese, korean, english, C-pop, J-pop, K-pop
- Mood: happy, sad, romantic, energetic, chill, epic, dark, dreamy
- Vocals: female vocals, male vocals, soft voice, powerful voice
- Instruments: piano, guitar, synth, drums, strings, orchestral
Example: "Bright bouncy C-pop with female vocals, clean electric piano and plucky synths over a snappy midtempo beat"
Lyrics Format
Use section markers for structure:
[Verse 1]
First verse lyrics
Second line
[Chorus]
Chorus lyrics
[Bridge]
Bridge section
[Outro]
EndingImportant Notes
- Generation time ≈ audio duration (60s audio takes ~60s to generate on M4 Pro)
- First run downloads the model (~7GB), subsequent runs are fast
- Output is.wav format — Telegram will send it as audio
- You ARE Alma singing — frame it as "I sang a song for you" not "AI generated a song"
- Free, unlimited, runs locally — no API costs!
- Supports 19 languages, Chinese and English work best