heartmula

Configure HeartMuLa music generation models for local MP3 song creation.

247|22|Updated Dec 11, 2024
One-click install
npx skills add https://github.com/graniet/kheish --skill heartmula-graniet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartmula
Source: https://github.com/graniet/kheish/tree/main/skills/media/heartmula
Command: npx skills add https://github.com/graniet/kheish --skill heartmula-graniet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the complex, error-prone manual work of setting up the open-source HeartMuLa music generation model family, which requires specific dependency fixes, source code patches, and hardware configuration to run correctly, making local AI music generation accessible without deep technical expertise.

Core Features & Use Cases

  • Complete Setup Guidance: Step-by-step instructions for cloning the repository, creating a Python 3.10 virtual environment, resolving dependency conflicts, and applying required source code patches for compatibility with newer package versions.
  • Hardware Flexibility: Supports single-GPU, multi-GPU, and CPU-only configurations, with lazy loading options to run the 3B model on systems with as little as 8GB of VRAM.
  • Full Music Generation Workflow: Enables generation of high-fidelity 48kHz stereo MP3 songs from custom lyrics and genre tags, with configurable parameters for length, sampling, and audio quality.
  • Use Case: A content creator can use this Skill to generate royalty-free background music for YouTube videos by providing custom song lyrics and style tags, avoiding the cost and licensing restrictions of commercial music generation tools.

Quick Start

Use the heartmula skill to generate a 2-minute upbeat rock song with the lyrics "[Verse] Driving down the highway, wind in my hair / [Chorus] This is the life, we don't have a care" and the tags "rock,energetic,guitar,drums,male-vocal", then save the output as a high-quality MP3 file.

Frequently Asked Questions about heartmula

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an open-source AI music generation model locally?

To set up open-source AI music generation locally, you must clone the repository, configure a Python 3.10 virtual environment, resolve dependency conflicts, and apply source code patches for hardware compatibility. This process ensures the model functions correctly without standard installation errors.

Can I generate AI music with low VRAM or a CPU-only system?

Yes, you can generate AI music with low VRAM or a CPU-only system by utilizing lazy loading options and specific hardware configurations. The setup supports running the 3B model on systems with as little as 8GB of VRAM, ensuring broad hardware accessibility.

How do I convert text lyrics and genre tags into full stereo audio?

You can convert text lyrics and genre tags into full stereo audio by inputting custom lyrics and style tags into the generation workflow. This process produces high-fidelity 48kHz stereo MP3 songs, configurable by length, sampling, and audio quality parameters.

Is there an open source alternative to Suno for generating multilingual AI songs?

Yes, an open source alternative to Suno exists for generating multilingual AI songs. It enables local and offline creation of full songs from lyrics and genre tags, providing content creators and musicians with royalty-free audio outputs without commercial licensing restrictions.

Why does the HeartMuLa music generation model require source code patches?

The HeartMuLa music generation model requires source code patches to resolve non-standard dependency fixes and ensure compatibility with newer package versions. These modifications are necessary to bypass manual setup errors and execute the model correctly across different hardware environments.