heartmula

Set up HeartMuLa to generate songs from lyrics and tags.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/TitoPrausee/nexus-toti --skill heartmula-titoprausee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartmula
Source: https://github.com/TitoPrausee/nexus-toti/tree/main/data/skills/media/heartmula
Command: npx skills add https://github.com/TitoPrausee/nexus-toti --skill heartmula-titoprausee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

HeartMuLa removes the complexity of setting up an open-source music generation stack so you can turn lyrics and style tags into complete songs with local control.

Core Features & Use Cases

  • Song Generation: Create full tracks from lyrics plus comma-separated tags for mood, instruments, and genre.
  • Open-Source Music Pipeline: Work with the HeartMuLa model family, including the generator, codec, and transcription components.
  • Practical Deployment: Run locally on GPU or CPU, handle multilingual prompts, and apply the required compatibility fixes for current library versions.
  • Use Case: A creator wants a demo song for a prototype, so they provide lyrics, pick a style like upbeat pop or cinematic ambient, and generate an MP3 directly on their machine.

Quick Start

Ask the assistant to set up HeartMuLa for local song generation, download the required checkpoints, apply the compatibility fixes, and generate an MP3 from your 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 a full song from lyrics locally on my machine?

To generate a full song from lyrics locally, you provide your text lyrics and comma-separated style tags to the music generation stack, which outputs an audio file. This requires setting up a Python 3.10-compatible environment and downloading the required model checkpoints.

Does text-to-song generation require a CUDA GPU to run?

Text-to-song generation does not strictly require a CUDA GPU, as it supports both GPU-assisted and CPU-only execution. However, running the music generation stack on a CUDA-aware setup provides practical deployment benefits for faster audio synthesis.

Can I use multilingual prompts for audio synthesis with this approach?

Yes, you can use multilingual prompts for audio synthesis to generate songs in multiple languages. The music generation stack processes your multilingual text inputs alongside mood and instrument tags to create complete tracks.

How does audio reconstruction work in the music generation pipeline?

Audio reconstruction works through the HeartCodec component, which rebuilds the generated audio into a final playable format. The pipeline also includes the HeartTranscriptor for transcription tasks to align text and audio processing.

Why does my music generation setup fail with current library versions?

Your music generation setup may fail due to transformer and codec incompatibility with current library versions. You need to apply specific compatibility patches to the Python environment to ensure the model components run correctly.

What is the best way to turn text lyrics into an MP3 demo track?

The best way to turn text lyrics into an MP3 demo track is to use a local text-to-song generation pipeline. You input your lyrics and genre tags, run the model to generate the audio, and export the output directly from your machine.