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.