heartmula

Generate MP3 songs from lyrics and style tags using HeartMuLa checkpoints.

4|Updated May 18, 2026
One-click install
npx skills add https://github.com/ZardLi1115/zedclaw --skill heartmula-zardli1115
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartmula
Source: https://github.com/ZardLi1115/zedclaw/tree/main/skills/media/heartmula
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill heartmula-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

HeartMuLa turns written lyrics and stylistic tags into full-length, music-like audio so you can create song drafts without composing melodies, harmonies, or instrumentation manually.

Core Features & Use Cases

  • Lyrics + Tags Music Generation: Produces complete songs conditioned on lyrics formatted with structural sections (e.g., Intro/Verse/Chorus).
  • Open-Source Foundation Models: Uses HeartMuLa (generation), HeartCodec (audio reconstruction), HeartTranscriptor (lyrics transcription), and HeartCLAP (audio-text alignment).
  • Multilingual, Local Execution: Runs locally with configurable model precision and optional lazy loading to fit within available VRAM.

Quick Start

Ask the skill to generate an MP3 song using your provided lyrics file and comma-separated tags, loading the 3B model from your local checkpoint directory and saving the output to an MP3 path.

Frequently Asked Questions about heartmula

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate MP3 songs from lyrics and style tags?

To generate MP3 songs from lyrics and style tags, provide a lyrics file formatted with structural sections like Intro and Chorus alongside comma-separated tags. The skill processes these inputs locally to output a full-length MP3 track without manual composition.

Can I run audio synthesis locally without an internet connection?

Yes, you can run audio synthesis locally and offline. The skill requires local HeartMuLa checkpoints and supports configurable device or dtype settings, allowing music generation entirely on your own machine without needing external API calls.

Does music generation work with CPU if I lack GPU VRAM?

Music generation does work with CPU if you lack GPU VRAM. The skill supports both GPU and CPU execution and includes optional lazy loading for VRAM efficiency, allowing you to configure model precision to fit your local hardware constraints.

What is the best way to structure lyrics for multilingual music generation?

The best way to structure lyrics for multilingual music generation is to format them with explicit structural sections such as Intro, Verse, and Chorus. This conditions the audio synthesis to align accurately with your specified lyrical progression.

Why do I need local checkpoints for offline song drafting?

You need local checkpoints for offline song drafting because the skill relies on open-source foundation models like HeartMuLa for generation and HeartCodec for audio reconstruction. Loading these models locally ensures deterministic generation without internet dependency.