heartmula

Generate music from lyrics and tags using HeartMuLa models.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/ChimeraFoundationa/Agentx --skill heartmula-chimerafoundationa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartmula
Source: https://github.com/ChimeraFoundationa/Agentx/tree/main/skills/media/heartmula
Command: npx skills add https://github.com/ChimeraFoundationa/Agentx --skill heartmula-chimerafoundationa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

HeartMuLa provides open-source, on-device music generation from lyrics and tags using a family of models (HeartMuLa, HeartCodec, HeartTranscriptor, HeartCLAP). It enables localized, offline creation of music without relying on proprietary services.

Core Features & Use Cases

  • Open-source music generation conditioned on lyrics and tags (3B/7B HeartMuLa models).
  • High-fidelity audio reconstruction with HeartCodec and lyrics transcription via HeartTranscriptor.
  • Local/offline generation with CPU or GPU hardware; supports multi-GPU setups for larger workloads.
  • Includes multiple components suitable for end-to-end music pipelines (HeartMuLa family, codecs, transcription, alignment).

Quick Start

Clone the heartlib repo, create a Python virtual environment, install dependencies, and run the basic music generation workflow using lyrics and tags.

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 offline?

You can generate music from lyrics and tags offline by cloning the heartlib repository, configuring a Python virtual environment, installing dependencies, and running the HeartMuLa models locally on CPU or GPU.

Can I run open-source music generation on a multi-GPU setup?

Yes, open-source music generation supports multi-GPU setups, allowing you to scale larger workloads and accelerate local audio generation using HeartMuLa models across multiple hardware devices.

Does offline music generation require an internet connection after setup?

Offline music generation requires an internet connection only to clone the heartlib repository and download model checkpoints, enabling fully localized audio generation without relying on proprietary services afterwards.

What is the best way to transcribe lyrics for local music generation?

The best way to transcribe lyrics for local music generation is using HeartTranscriptor, which handles lyrics transcription and alignment to condition the HeartMuLa models during the offline audio creation process.