
MusicGPT
本地运行 LLM,用自然语言一句话生成音乐
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1470
技术标签
使用教程
环境要求
- macOS 或 Linux 系统(可用 Homebrew 安装)
- Windows 系统需下载官方预编译可执行文件(x86_64)
- Docker 方式需已安装 Docker,并具备支持 CUDA 的 GPU 与基础 NVIDIA 驱动
- 无需安装 Python 或任何机器学习框架
安装与启动步骤
-
1Homebrew 安装
在 macOS 或 Linux 上通过 Homebrew 安装 MusicGPT,安装后即可在终端使用 musicgpt 命令。
brew install gabotechs/taps/musicgpt -
2Windows 安装
Windows 用户从 GitHub Releases 下载 musicgpt-x86_64-pc-windows-msvc.exe 可执行文件后直接运行。
-
3拉取镜像
需要 CUDA GPU 加速时推荐使用 Docker 方式,先拉取官方镜像 gabotechs/musicgpt。
docker pull gabotechs/musicgpt -
4启动容器
映射 8642 端口并挂载数据目录,--gpu 启用 GPU 加速,--ui-expose 暴露 UI 界面。
docker run -it --gpus all -p 8642:8642 -v ~/.musicgpt:/root/.local/share/musicgpt gabotechs/musicgpt --gpu --ui-expose -
5选择交互模式
MusicGPT 提供 UI 模式和 CLI 模式两种交互方式,可按需选择其中一种使用。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
-p 8642:8642 | 是 | 将容器默认 8642 端口映射到宿主机,便于访问 UI | 8642:8642 |
-v ~/.musicgpt:/root/.local/share/musicg | 否 | 把容器数据目录挂载到宿主机,便于持久化保存 | ~/.musicgpt:/root/.local/share/musicgpt |
--gpu | 否 | 启动时启用 CUDA GPU 加速 | --gpu |
--ui-expose | 否 | 对外暴露 Web UI 界面 | --ui-expose |
如何确认成功
docker run 执行后终端出现运行日志,浏览器打开 http://localhost:8642 可进入 UI 模式。
常见问题
Q:Windows 上怎么安装 MusicGPT?
A:从 GitHub Releases 页面下载 musicgpt-x86_64-pc-windows-msvc.exe 可执行文件,下载后直接运行即可,不需要额外依赖。
Q:Docker 启动时提示无法使用 GPU 怎么办?
A:宿主机需先安装基础 NVIDIA 驱动与容器工具包,再用带 --gpus all 参数的命令启动容器。
Q:生成的数据保存在哪里?
A:启动命令中通过 -v ~/.musicgpt:/root/.local/share/musicgpt 挂载,数据会持久化到宿主机的 ~/.musicgpt 目录。
Q:支持哪些音乐生成模型?
A:目前仅支持 Meta 的 MusicGen 模型,项目计划后续透明地支持更多音乐生成模型。
Q:如何使用 MusicGPT?
A:README 说明有两种交互方式:UI 模式和 CLI 模式,可根据需要选择。
注意事项
- 目前仅支持 Meta 的 MusicGen 模型,旋律条件生成与无限长音乐流尚未实现
- 项目强调本地运行,无需上传数据到云端,适合隐私敏感场景
- Docker 方式被推荐用于需要 CUDA GPU 加速的场景
核心亮点
- 完全本地运行,保护隐私且无需联网
- 基于 Rust 实现,性能高效且内存安全
- 支持多种 LLM 后端,灵活集成
不足之处
- 生成音乐质量可能不及商业云端服务
- 文档/社区待观察
适用场景
- 离线环境下的音乐灵感创作
- 隐私敏感场景下的 AI 音乐实验
- 开发者集成本地音乐生成功能
替代项目
MusicGen、AudioCraft、Riffusion
上一篇:AudioMuse-AI
下一篇:MOSS-TTSD
同类项目推荐
ZeroTTS
开源
CPU 上实时跑越南语零样本语音克隆
Fast, lightweight zero-shot Vietnamese text-to-speech (TTS) that runs in real time o···
aeneas
开源
上传音频和文本,自动生成逐字字幕时间轴
aeneas is a Python/C library and a set of tools to automagically synchronize audio a···
espeak-ng
开源
轻量离线多语言语音合成,百种语言即用即说
eSpeak NG is an open source speech synthesizer that supports more than hundred langu···
MiniMax-AI.github.io
开源
MiniMax 官方 TTS 开源入口,快速上手语音合成
The official GitHub Page for MiniMax
TellTime
开源
用英式腔调,动嘴就能知道几点
iOS application to tell the time in the British way ⏰
Audio8_TTS
开源
小模型也能合成自然语音,本地部署更省算力
SOTA-Class TTS at Compact Scale
clipboard-narrator
开源
复制网页文字,后台自动朗读成有声书
Turn any web page into an audiobook, works in the background on desktop!
OtosakuTTS-iOS
开源
在 iPhone 上离线生成自然语音,保护隐私不联网。
Swift library for offline text-to-speech synthesis on iOS/macOS. Generate natural sp···
MOSS-TTS-Nano
开源
0.1B 参数,CPU 上实时跑多语言语音克隆
A 100M-parameter multilingual TTS model for real-time CPU inference, voice cloning, ···