Install HeartMuLa Locally with LM Downloader ​

HeartMuLa is a powerful music creation tool that supports multiple music styles and genres, allowing you to easily create, edit, and generate music works.

HeartMuLa supports multilingual functionality, including but not limited to English, Chinese, Japanese, Korean, and Spanish, meeting the needs of global users.

If you have some development experience, you can download the source code from GitHub and deploy it locally. Alternatively, you can use LM Downloader to deploy HeartMuLa locally with one click—the entire process is fully automated, perfect for beginners, and supports both Mac and Windows.

• HeartMuLa Official Website: https://heartmula.github.io/

Note ​

• 32GB RAM recommended. 30GB+ storage recommended.
• macOS 15+: M-series chips required.
• Windows 10/11: NVIDIA GPU (12GB+ VRAM) recommended. Intel or AMD GPU compatibility unverified.

Team Introduction ​

HeartMuLa is developed by a team from the following universities and institutions:

• Peking University
• The Chinese University of Hong Kong
• Scale Global, Ario
• Independent Researchers

Find HeartMuLa in LM Downloader ​

Open LM Downloader, then click "Local Apps" in the left menu. You can see HeartMuLa in the app list. Click the HeartMuLa icon to go to the introduction page.

Click the Install Button. If you are installing an AI app with LM Downloader for the first time, you will be prompted with the installation directory.

Open the Installation Window, and HeartMuLa will be automatically installed. If you already have HeartMuLa installed, don't worry—this can be treated as an update to the latest version of HeartMuLa and won't affect the music works you've created before. Click the View Log button in the bottom right corner to expand the log interface and troubleshoot any issues during installation.

Run HeartMuLa ​

On the application details page, click the Run button on the right to open the execution window. Upon successful launch, your browser will open automatically.

Precision Options ​

In the execution window, you can choose different precision options to balance performance and quality:

In the running window, you can see quick access to common directories such as "Music Works", "Lyric Files", and "Tag Library".

How to Write Lyrics? ​

Lyric Guidelines ​

1. Clear Format: Use sections to separate different parts of the song (such as Verse, Chorus, Bridge, etc.)
2. Consistent Rhythm: Keep the length and rhythm of each line of lyrics relatively consistent
3. Emotional Expression: Express emotions through specific imagery and scenes, avoiding abstraction
4. Concise Language: Use clear and concise language that is easy for listeners to understand and remember
5. Reasonable Rhyme: Use rhyme appropriately, but don't sacrifice content for rhyme

Lyric Examples ​

Example 1: Pop Song ​

[Verse 1]
Morning sun shines through the window
I wake up from my dream
Thinking of your smile
My mood becomes bright

[Chorus]
You are my sunshine
Lighting up my heart
No matter where and when
I'll always be by your side

[Verse 2]
Night stars are twinkling
I wander alone
Missing your tenderness
Looking forward to seeing you

[Chorus]
You are my sunshine
Lighting up my heart
No matter where and when
I'll always be by your side

[Bridge]
Even if wind and rain come
Even if the road is long
With your company
I won't hesitate

[Chorus]
You are my sunshine
Lighting up my heart
No matter where and when
I'll always be by your side

Example 2: Rock Song ​

[Verse 1]
City nights are noisy
I walk aimlessly on the street
Anger burns in my heart
Wanting to release all repression

[Chorus]
Rock and roll!
Let music ignite my soul
Rock and roll!
Let the shout break all bonds

[Verse 2]
Life's pressure suffocates me
Reality's cruelty makes me confused
But I won't give up easily
Because music is my belief

[Chorus]
Rock and roll!
Let music ignite my soul
Rock and roll!
Let the shout break all bonds

[Solo]
(Guitar solo)

[Bridge]
No matter what others say
No matter how hard the road is
I will stick to my dream
Until the end of the world

[Chorus]
Rock and roll!
Let music ignite my soul
Rock and roll!
Let the shout break all bonds

How to Use the Tag System? ​

As HeartMuLa is an open-source model trained on a large-scale multilingual dataset, its tag support logic differs slightly from Suno or Udio. It emphasizes semantic alignment through the HeartCLAP model to understand your natural language.

Based on the project's technical whitepaper and underlying architecture, here is a comprehensive breakdown of HeartMuLa's deeply supported tags, divided into five major categories: Structure, Genre, Mood, Vocal, and Instrumentation:

1. Structural Tags ​

These tags control the logical framework of the song and are typically placed within the lyrics or input through section control parameters.

2. Genre Tags ​

HeartMuLa has excellent support for mainstream genres, especially strengthening popular styles for the Chinese, Japanese, and Korean (CJK) markets.

3. Mood & Atmosphere Tags ​

These tags determine the emotional tone of the audio (controlled through HeartCLAP's semantic space).

4. Vocal Tags ​

Due to HeartMuLa's powerful multilingual capabilities, its vocal control is very precise.

5. Instrumentation & Production Tags ​

You can explicitly specify a particular instrument as the lead.

6. Tempo Tags ​

These tags are used to describe the speed and rhythm of the music.

Tag Usage Tips ​

1. Combine Tags: You can use multiple tags simultaneously to more accurately describe music characteristics
2. Priority: Put the most important tags first
3. Specificity: Try to use specific tags rather than overly broad ones
4. Consistency: Maintain consistency in tag style within the same song
5. Experimentation: Try different tag combinations to explore new music styles

Tag Examples ​

Example 1: Pop Song ​

female_vocal, pop, upbeat, happy, electronic, synthesizer, drums

Example 2: Rock Song ​

male_vocal, rock, energetic, fast, guitar, drums, bass

Example 3: Ambient Music ​

atmospheric, calm, electronic, synthesizer, slow, healing

Example 4: Jazz Song ​

jazz, smooth, romantic, saxophone, piano, moderate

FAQ ​

Q: Which operating systems does HeartMuLa support?

A: HeartMuLa supports Windows and macOS operating systems. Currently, we have Windows and macOS two versions of the client. You can install HeartMuLa on Windows and macOS operating systems. If you have development experience, you can also deploy HeartMuLa on Linux. Refer to this source code repository: https://github.com/lmdown/heartlib-web-demo

Q: How to improve lyric quality?

A: You can refer to excellent lyric works, learn their structure and expression methods; at the same time, practice more, and continuously modify and improve your lyrics.

Q: Is it better to use more tags?

A: No, tags should be precise and accurate. Choose the tags that best represent the music characteristics, generally 5-8 tags are appropriate.

Q: Do I need music foundation to use HeartMuLa?

A: No, HeartMuLa is designed as a user-friendly tool that even beginners without music foundation can easily get started with.