# HeartMuLa

> 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.

- Repository: https://github.com/HeartMuLa/heartlib
- Official docs: https://github.com/HeartMuLa/heartlib#readme
- Checked: 2026-10-16

## What it replaces
- Suno: Full songs with vocals from a prompt or lyrics (partial). Song generation from lyrics and tags only, from a script; no UI, covers, edits or stems in this repo.

## Facts, with sources

| Question | Status | Answer | Source | Checked |
|---|---|---|---|---|
| Runs on my machine? | Confirmed | Yes, Python script with downloaded checkpoints | https://github.com/HeartMuLa/heartlib#%EF%B8%8F-local-deployment | 2026-10-15 |
| Code licence | Confirmed | Apache-2.0 | https://github.com/HeartMuLa/heartlib#%EF%B8%8F-license | 2026-10-15 |
| Model weights licence | Confirmed | Apache-2.0 (HeartMuLa-oss-3B and HeartCodec weights) | https://github.com/HeartMuLa/heartlib#-news | 2026-10-15 |
| Commercial use | Confirmed | Yes, Apache-2.0 code and weights | https://huggingface.co/HeartMuLa/HeartMuLa-oss-3B-happy-new-year | 2026-10-15 |
| Paid services needed? | Confirmed | None required | https://github.com/HeartMuLa/heartlib#%EF%B8%8F-local-deployment | 2026-10-15 |
| Hardware | Unknown | Not documented; CUDA GPU by default, with lazy loading or a two-GPU split to save memory | none found | - |
| 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 | https://github.com/HeartMuLa/heartlib#-local-deployment | 2026-10-16 |
| Setup effort | Confirmed | Medium; pip install -e from the repo, then download checkpoints from Hugging Face or ModelScope | https://github.com/HeartMuLa/heartlib#%EF%B8%8F-environment-setup | 2026-10-15 |

GitHub: 3754 stars, 472 forks, last push 2026-10-08, archived: no.
---
Source: RepoQuarry (https://repoquarry.dev/projects/heartmula). Data licence: CC BY 4.0. Quotes are from project documentation and belong to their authors.