heartmula

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

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/ghufronbagaskara/agent-im --skill heartmula-ghufronbagaskara
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: heartmula
Source: https://github.com/ghufronbagaskara/agent-im/tree/main/hermes-home/skills/media/heartmula
Command: npx skills add https://github.com/ghufronbagaskara/agent-im --skill heartmula-ghufronbagaskara

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

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

Core Features & Use Cases

  • Lyrics-to-Song Generation: Transforms structured lyrics and descriptive tags into full-length audio tracks.
  • High-Fidelity Codec: Utilizes the HeartCodec model for professional-grade audio reconstruction.
  • Use Case: A content creator can generate custom background music for a video project by providing specific mood tags and verse-chorus structured lyrics directly to the local model.

Quick Start

Use the heartmula skill to generate a song from the lyrics file located at assets/lyrics.txt using the provided tags file.

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

You generate music from lyrics by providing structured text and descriptive tags to the model, which synthesizes high-fidelity audio tracks locally without proprietary cloud services.

Do I need a CUDA-enabled GPU to generate audio tracks?▼

Yes, you need a CUDA-enabled GPU environment with PyTorch and specific model checkpoints to perform high-fidelity local audio synthesis.

Can I use PyTorch and Transformers for AI-assisted songwriting?▼

Yes, you can use PyTorch and Transformers for AI-assisted songwriting by conditioning open-source foundation models on input lyrics and tags to generate original music tracks.

What is the best way to create custom background music for video projects?▼

The best way to create custom background music is providing specific mood tags and verse-chorus structured lyrics directly to the local model for professional-grade audio reconstruction.

How does the HeartCodec model work for audio generation?▼

The HeartCodec model provides professional-grade audio reconstruction, transforming structured lyrics and descriptive tags into full-length, high-fidelity audio tracks.

Are there limitations when using open-source models for music synthesis?▼

Open-source music synthesis limitations include requiring a CUDA-enabled GPU environment and specific model checkpoints, meaning local generation cannot run on standard CPU-only hardware.