Skip to content
RepoQuarry

HeartMuLa HeartMuLa/heartlib

Apache-2.0 music language model (3B) that generates songs with vocals from lyrics and style tags, plus a codec and lyrics transcriber.

HeartMuLa at a glance

Checked 16 Oct 2026

HeartMuLa is a family of open music models released in January 2026: a 3B music language model that sings lyrics in many languages to style tags, the HeartCodec audio codec, and a lyrics transcriber. Code and all weights moved to Apache-2.0 in January 2026. It runs from a Python script, writes up to 4 minutes by default, and runs at about real-time speed. There is no UI, reference-audio input or section editing yet; covers live in a separate MuLaCover repo. Hardware and OS support are not documented, and the 7B model is not released.

Cite this pageRepoQuarry. “HeartMuLa.” Checked 16 Oct 2026. https://repoquarry.dev/projects/heartmula

How much of Suno does it replace?

1 of 5 jobs. Song generation from lyrics and tags only, from a script; no UI, covers, edits or stems in this repo.

Partial: Full songs with vocals from a prompt or lyrics Partial replacement
No: Instrumental tracks (Instrumental mode) Not covered
No: Covers and restyles of an uploaded song (Cover) Not covered
No: Extending or regenerating part of a song (Extend Not covered
No: Splitting a song into vocal and instrument stems (Get Stems) Not covered

For instrumental tracks (Instrumental mode), covers and restyles of an uploaded song (Cover), extending or regenerating part of a song (Extend, splitting a song into vocal and instrument stems (Get Stems), see other Suno alternatives. You may also need to build an interface, an API server and hosting yourself.

Facts, with sources

Every answer links to where we found it. We read the documentation; we did not install it.

Report a correction
QuestionAnswerSourceChecked
Runs on my machine? Confirmed: Yes, Python script with downloaded checkpoints Clone this repo and install locally. github.com · heartlib#%EF%B8%8F-local-deployment ↗ 1d ago
Code licence Confirmed: Apache-2.0 This repository is licensed under the Apache 2.0 License. github.com · heartlib#%EF%B8%8F-license ↗ 1d ago
Model weights licence Confirmed: Apache-2.0 (HeartMuLa-oss-3B and HeartCodec weights) We update the license of this repo and all related model weights to Apache 2.0. github.com · heartlib#-news ↗ 1d ago
Commercial use Confirmed: Yes, Apache-2.0 code and weights huggingface.co · HeartMuLa-oss-3B-happy-new-year ↗ 1d ago
Paid services needed? Confirmed: None required github.com · heartlib#%EF%B8%8F-local-deployment ↗ 1d ago
Hardware Unknown: Not documented; CUDA GPU by default, with lazy loading or a two-GPU split to save memory Know the answer? —
Operating systems Unknown: Reviewed README documents Python local deployment and CUDA device options, but no Windows/macOS/Linux support matrix; CUDA examples alone are not OS support evidence We recommend using `python=3.10` for local deployment. github.com · heartlib#-local-deployment ↗ today
Setup effort Confirmed: Medium; pip install -e from the repo, then download checkpoints from Hugging Face or ModelScope Download our pretrained checkpoints from huggingface or modelscope using the following command github.com · heartlib#%EF%B8%8F-environment-setup ↗ 1d ago

Get the weekly top 5 and what’s new, every Monday

We’ll email you once a week. Unsubscribe any time. We never share your email.

Cookie preferences

Choose what we may store in your browser. You can change this any time from Cookie settings in the footer.

Essential

Security, and remembering this choice. rq-consent · 12 months

Always on