heartlib

输入文字,本地生成完整音乐,开源可商用

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 音频音乐 🍴 复刻 477 🐛 待处理 101 👀 关注 62
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 3798
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,无在线服务

项目预览

heartlib 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类音频音乐
开发团队HeartMuLa
定价模式🏷️完全免费
价格说明开源免费,无在线服务
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型ai-music,audio-codec,cover-song,music-ai,music-generation,music-remix,pytorch,text-to-music
GitHub 星标★ 3798
上线时间2026-01-15 00:00:00
代码更新2026-11-15
仓库体积10.2 MB
本站数据更新2026-11-15
维护状态活跃
收录时间2026-10-02
浏览次数2

项目介绍

heartlib 是 HeartMuLa 音乐生成模型的官方开源仓库,定位为 2026 年最强的开源音乐生成模型。它面向需要从文本或条件生成音乐(歌曲、伴奏、旋律片段)的开发者和创作者,提供完整的模型推理与生成代码,让用户无需从零训练即可在本地或自有算力上生成音乐。核心能力包括:基于文本描述生成音乐、支持多种音乐风格与结构控制、提供可复现的推理流程和预训练权重加载,并针对 Python 生态做了封装,便于集成到音频工作流、内容创作工具或研究中。相比闭源音乐生成服务,它把模型权重和代码开放出来,降低了二次开发和商业落地的门槛,适合做 AI 作曲、短视频配乐、游戏动态音乐等场景的原型与产品。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 3798

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 30 分钟 部署方式:本地安装 6 步

环境要求

  • Python 3.10(README 推荐版本)
  • 已安装 git 与 pip
  • 可访问 Hugging Face 或 ModelScope 下载预训练权重
  • 存放 3B 模型权重所需的磁盘空间与推理算力

安装与启动步骤

  1. 1克隆仓库

    把 heartlib 官方仓库拉到本地,命令执行后会生成 heartlib 目录。

    git clone https://github.com/HeartMuLa/heartlib.git
  2. 2进入项目目录

    切换到刚克隆下来的仓库根目录,后续安装与运行都在此目录进行。

    cd heartlib
  3. 3安装依赖

    以可编辑模式安装本项目,README 明确要求使用 pip install -e .,建议先准备好 Python 3.10 环境。

    pip install -e .
  4. 4下载预训练权重

    从 Hugging Face 或 ModelScope 下载官方预训练 checkpoint,README 只给出下载入口、未给出具体命令,需按页面说明手动下载并放到 ./ckpt 目录。

  5. 5运行音乐生成

    执行官方示例脚本生成音乐,默认使用 ./assets 中的歌词与标签作为条件,--model_path 指向权重目录、--version 指定 3B 版本。

    python ./examples/run_music_generation.py --model_path=./ckpt --version="3B"
  6. 6查看生成结果

    运行结束后到 ./assets 目录查看生成的音乐文件,默认输出为 output.mp3。

关键配置

配置项必填说明示例
model_path是指定预训练权重所在目录,示例脚本按此路径加载模型。./ckpt
version是指定使用的模型版本,README 示例中为 3B。3B

如何确认成功

示例脚本执行无报错,并在 ./assets 目录下生成 output.mp3 音乐文件即表示成功。

常见问题

Q:必须用 Python 3.10 吗?

A:README 推荐使用 python=3.10 做本地部署,其他版本未在文档中说明,建议按推荐版本创建环境以避免依赖冲突。

Q:权重下载命令是什么?

A:README 中该段命令为空,未给出具体下载命令,需自行前往 Hugging Face 或 ModelScope 的 HeartMuLa-oss-3B-happy-new-year 页面按说明下载。

Q:生成的音乐保存在哪里?

A:默认保存在 ./assets/output.mp3,这是 README 中给出的默认输出路径。

Q:没有歌词和标签能生成吗?

A:默认示例会读取 ./assets 目录下提供的歌词与标签作为生成条件,README 未说明留空时的行为。

注意事项

  • README 未给出预训练权重的具体下载命令,需自行从 Hugging Face 或 ModelScope 获取并放到 --model_path 指定目录。
  • 示例默认读取 ./assets 中的歌词与标签,输出固定为 ./assets/output.mp3,可据此替换自己的输入素材。
  • 仓库还包含 HeartCodec、HeartTranscriptor 等组件,本次仅依据 README 节选整理核心的音乐生成流程。

核心亮点

  • 开源模型权重与推理代码,可本地部署,不依赖闭源 API
  • 主打 2026 年最强开源音乐生成,生成质量和风格覆盖是核心卖点
  • Python 实现,便于集成到现有音频处理与内容生成流水线

不足之处

  • 仓库较新,文档与使用示例可能不够完善
  • 本地生成对显存和算力要求较高,普通设备体验受限

适用场景

  • 短视频/播客自动配乐生成
  • 游戏或应用中的动态背景音乐
  • 音乐创作者用文本快速生成旋律草稿

替代项目

MusicGen、Stable Audio Open

上一篇:qwentts.cpp

下一篇:ACE-Step-1.5

同类项目推荐

AceForge 开源

在 Mac 上离线完成 AI 作曲、人声分离和语音合成

AceForge is a local-first AI music workstation for Apple/OSX based on Ace-Step, DeMu···

★ 95 2026-08-09
epub2mp3 开源

把电子书变成有声书,用 Edge TTS 一键转 MP3

这是一个使用 Microsoft Edge TTS 服务将 EPUB 电子书转换为 MP3 音频文件的工具。

★ 87 2026-08-09
mlx-audio 开源

苹果设备本地搞定语音,转文字、换声音一步到位

A text-to-speech (TTS), speech-to-text (STT) and speech-to-speech (STS) library buil···

★ 8271 2026-08-09
tadpole-studio 开源

本地跑AI音乐,拖拽点点就出歌

Easy to use AI music generation UI for local models with QoL features

★ 80 2026-08-09
ema-lightning 开源

土耳其语TTS,4毫秒出声,单卡扛千路

Tiny, fast and accurate Turkish text-to-speech. 8.6M parameters, 0.92% WER on Freya-···

★ 306 2026-10-11
QuickPiperAudiobook 开源

一条命令,把电子书变成自然流畅的有声书

With one command, create a natural-sounding audiobook from a variety of input format···

★ 1061 2026-08-09
magda-core 开源

用代码和AI驱动音乐制作,让DAW自动化飞起来

An open ecosystem for music production.

★ 264 2026-08-09
tango 开源

输入一句话,自动生成匹配的音频内容

A family of diffusion models for text-to-audio generation.

★ 1244 2026-08-09
index-tts 开源

上传几秒语音,立刻克隆你的声音,随便说哪种语言都行

An Industrial-Level Controllable and Efficient Zero-Shot Text-To-Speech System

★ 25103 2026-08-09