项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 3798
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 3.10(README 推荐版本)
- 已安装 git 与 pip
- 可访问 Hugging Face 或 ModelScope 下载预训练权重
- 存放 3B 模型权重所需的磁盘空间与推理算力
安装与启动步骤
-
1克隆仓库
把 heartlib 官方仓库拉到本地,命令执行后会生成 heartlib 目录。
git clone https://github.com/HeartMuLa/heartlib.git -
2进入项目目录
切换到刚克隆下来的仓库根目录,后续安装与运行都在此目录进行。
cd heartlib -
3安装依赖
以可编辑模式安装本项目,README 明确要求使用 pip install -e .,建议先准备好 Python 3.10 环境。
pip install -e . -
4下载预训练权重
从 Hugging Face 或 ModelScope 下载官方预训练 checkpoint,README 只给出下载入口、未给出具体命令,需按页面说明手动下载并放到 ./ckpt 目录。
-
5运行音乐生成
执行官方示例脚本生成音乐,默认使用 ./assets 中的歌词与标签作为条件,--model_path 指向权重目录、--version 指定 3B 版本。
python ./examples/run_music_generation.py --model_path=./ckpt --version="3B" -
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···
epub2mp3
开源
把电子书变成有声书,用 Edge TTS 一键转 MP3
这是一个使用 Microsoft Edge TTS 服务将 EPUB 电子书转换为 MP3 音频文件的工具。
mlx-audio
开源
苹果设备本地搞定语音,转文字、换声音一步到位
A text-to-speech (TTS), speech-to-text (STT) and speech-to-speech (STS) library buil···
tadpole-studio
开源
本地跑AI音乐,拖拽点点就出歌
Easy to use AI music generation UI for local models with QoL features
ema-lightning
开源
土耳其语TTS,4毫秒出声,单卡扛千路
Tiny, fast and accurate Turkish text-to-speech. 8.6M parameters, 0.92% WER on Freya-···
QuickPiperAudiobook
开源
一条命令,把电子书变成自然流畅的有声书
With one command, create a natural-sounding audiobook from a variety of input format···
magda-core
开源
用代码和AI驱动音乐制作,让DAW自动化飞起来
An open ecosystem for music production.
tango
开源
输入一句话,自动生成匹配的音频内容
A family of diffusion models for text-to-audio generation.
index-tts
开源
上传几秒语音,立刻克隆你的声音,随便说哪种语言都行
An Industrial-Level Controllable and Efficient Zero-Shot Text-To-Speech System
