MusicGPT

本地运行 LLM，用自然语言一句话生成音乐

MusicGPT 是一个基于 Rust 的本地音乐生成工具，它利用本地运行的大语言模型（LLM）理解自然语言提示，并生成对应的音乐。该项目解决了在无网络、隐私敏感环境下，用户无法使用云端 AI 音乐生成服务的问题。其核心能力包括：通过自然语言描述（如风格、情绪、乐器）生成音乐片段，支持多种本地 LLM 后端（如 llama.cpp），并提供命令行交互界面。它允许用户完全掌控生成过程，无需上传数据到云端，同时保证了低延迟和离线可用性。MusicGPT 适合音乐爱好者、开发者和研究人员探索 AI 音乐创作，尤其注重隐私和定制化。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1458

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队gabotechs

所属国家

官网地址

GitHubhttps://github.com/gabotechs/MusicGPT

定价模式free

价格说明开源项目，MIT许可证，本地部署，完全免费。

访问状态

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型ai,gpt,llm,machine-learning,music

GitHub 星标★ 1458

30天Star增速

HF 下载量

上线时间2024-05-03 00:00:00

最近更新2026-09-23 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：入门约 15 分钟部署方式：本地安装 5 步

环境要求

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

项目介绍

MusicGPT 是音频音乐领域的开源项目，由 gabotechs 开发，2024 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,458）位列前 30%，在音频音乐分类的 738 个项目里位列前 13%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。MIT许可证，本地部署，完全免费。

它主要面向的使用场景是：离线环境下的音乐灵感创作。同类可对比的替代方案包括 MusicGen、AudioCraft、Riffusion。

上一篇：AudioMuse-AI

下一篇：MOSS-TTSD