heartmula

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

7|1|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/paxlabs-inc/ion-agent --skill heartmula-paxlabs-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartmula
Source: https://github.com/paxlabs-inc/ion-agent/tree/main/skills/media/heartmula
Command: npx skills add https://github.com/paxlabs-inc/ion-agent --skill heartmula-paxlabs-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the challenge of generating high-quality, custom music tracks from simple textual descriptions and structural tags, providing a local, open-source alternative to proprietary music generation services.

Core Features & Use Cases

  • Text-to-Music Generation: Create complete songs, including lyrics and instrumentation, based on user-provided style tags and lyrical content.
  • High-Fidelity Reconstruction: Utilizes a specialized music codec to ensure audio output meets professional standards.
  • Use Case: A content creator needs a unique, royalty-free background track for a video; they can use this Skill to generate a custom song by providing specific mood tags and lyrics.

Quick Start

Use the heartmula skill to generate a new song from the lyrics and tags provided in the assets directory.

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 text and tags locally?

To generate music from text and tags locally, you provide lyrical content and stylistic tags to the Skill, which uses open-source foundation models to synthesize high-fidelity audio tracks. You can start by using the assets provided in the directory to create a custom song.

Do I need an NVIDIA GPU to generate high-fidelity music tracks?

Yes, you need an NVIDIA GPU with CUDA support to generate high-fidelity music tracks. The Skill requires specific hardware acceleration to run the open-source foundation models and ensure compatibility with the Python dependencies.

What is text-to-music generation used for?

Text-to-music generation is used to create complete songs, including lyrics and instrumentation, from simple textual descriptions. It is commonly used for creative projects, content production, and generating royalty-free background tracks for videos.

Can I use this with Python and PyTorch for audio synthesis?

Yes, you can use this with Python and PyTorch for audio synthesis. The Skill relies on Python, uv, torch, and transformers to manage model compatibility and process the open-source foundation models for local audio generation.

How does a music codec ensure high-fidelity audio output?

A specialized music codec ensures high-fidelity audio output by encoding and decoding the generated audio signals to meet professional standards. This process preserves the quality of the instrumentation and vocals synthesized from your lyrics and tags.