heartmula

Generate music tracks from lyrics and tags using open-source foundation models.

Updated Jun 17, 2026
One-click install
npx skills add https://github.com/cxnaive/hermes-agent-llbot --skill heartmula-cxnaive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartmula
Source: https://github.com/cxnaive/hermes-agent-llbot/tree/main/optional-skills/creative/heartmula
Command: npx skills add https://github.com/cxnaive/hermes-agent-llbot --skill heartmula-cxnaive

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires torch, transformers, datasets, torchtune, and includes assets (resource) components.

What problem does it solve?

HeartMuLa solves the challenge of creating high-quality, original music locally without relying on expensive or restrictive proprietary cloud services.

Core Features & Use Cases

  • Lyrics-to-Song Generation: Transform text-based lyrics and descriptive tags into full-length audio tracks.
  • High-Fidelity Reconstruction: Utilizes the HeartCodec model to ensure professional-grade audio output.
  • Use Case: A content creator can generate custom background music for a video project by providing specific mood tags and structural lyric markers like Verse and Chorus.

Quick Start

Use the heartmula skill to generate a song from the lyrics file located in the assets directory using the 3B model version.

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 locally without using cloud services?

Generate high-fidelity music locally by providing text-based lyrics and descriptive mood tags to open-source foundation models, bypassing restrictive proprietary cloud services. This approach requires a CUDA-enabled GPU and specific model checkpoints for audio synthesis.

What do I need to set up a CUDA environment for local audio synthesis?

Local audio synthesis requires a CUDA-enabled GPU environment alongside specific Python dependencies including torch, transformers, datasets, and torchtune. You must also acquire the necessary model checkpoints to execute the generation pipeline correctly.

Can I use descriptive tags to control the structure and mood of AI generated songs?

Yes, you can control song structure and mood by providing specific descriptive tags and structural lyric markers like Verse and Chorus. The foundation models use these tags to condition the high-fidelity audio generation for your creative projects.

How does the HeartCodec model ensure high-fidelity audio output?

The HeartCodec model ensures professional-grade audio output by reconstructing high-fidelity audio from the generated representations. This mechanism allows the system to transform text-based lyrics and tags into full-length, high-quality audio tracks.

What is the best way to include structural markers like Verse and Chorus in lyrics for song generation?

The best way to guide song generation is to embed structural lyric markers like Verse and Chorus directly within your text-based lyrics file. Combined with descriptive mood tags, these markers condition the foundation model to produce structurally coherent audio tracks.