heartmula

Generate music from lyrics and tags using HeartMuLa family models and HeartCodec audio reconstruction.

2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/CUexter/hermes-agent --skill heartmula-cuexter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartmula
Source: https://github.com/CUexter/hermes-agent/tree/main/skills/media/heartmula
Command: npx skills add https://github.com/CUexter/hermes-agent --skill heartmula-cuexter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

HeartMuLa provides an open-source, end-to-end music generation pipeline that creates songs conditioned on lyrics and tags, enabling offline or local generation without relying on proprietary services.

Core Features & Use Cases

  • HeartMuLaGen: a music language model that generates music from lyrics and tags.
  • HeartCodec: a 12.5 Hz codec for high-fidelity audio reconstruction.
  • HeartTranscriptor: Whisper-based lyrics transcription.
  • HeartCLAP: audio-text alignment for synchronization.
  • Use Cases: build custom AI music engines, generate songs from textual prompts, or run fully offline on local hardware.

Quick Start

Run the generation workflow locally by supplying lyrics and tags to HeartMuLa and save the resulting track.

Frequently Asked Questions about heartmula

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

FAQPage Schema
How do I generate music from lyrics and tags locally?

You can generate music from lyrics and tags locally by running the open-source HeartMuLa pipeline. It uses HeartMuLaGen for music language modeling and HeartCodec for high-fidelity audio reconstruction, outputting a complete song track fully offline.

What is lyrics-conditioned AI music generation?

Lyrics-conditioned AI music generation produces songs driven by input text lyrics and descriptive tags. The HeartMuLa pipeline leverages a music language model to translate these textual conditions into structured musical compositions.

Do I need GPU acceleration for offline music generation?

GPU acceleration is required for offline music generation to efficiently process the HeartMuLa models and HeartCodec audio reconstruction. The workflow supports a GPU-accelerated local setup to handle multi-model orchestration and environment patching requirements.

Can I use Whisper transcription for AI music alignment?

Whisper transcription supports AI music alignment via the HeartTranscriptor component. It transcribes lyrics and pairs with HeartCLAP for audio-text alignment, synchronizing the generated music with lyrical content during the offline production process.

Best way to set up an open-source AI music engine?

Setting up an open-source AI music engine is best achieved with the HeartMuLa pipeline, which provides an end-to-end local workflow. It handles hardware setup, multi-model orchestration, and environment patching to generate songs without proprietary services.

What are the limitations of offline AI music generation?

Offline AI music generation requires sufficient local hardware for GPU acceleration and manual environment patching. Users must manage multi-model orchestration locally, as the pipeline operates entirely offline without relying on proprietary cloud services.