MusicGPT

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

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 172 🐛 待处理 21 👀 关注 23
GitHub ↗
GitHub 星标 ★ 1470
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,本地部署,完全免费。

项目预览

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

项目数据

分类开源模型
开发团队gabotechs
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,本地部署,完全免费。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Rust
技术栈/模型ai,gpt,llm,machine-learning,music
GitHub 星标★ 1470
上线时间2024-05-03 00:00:00
代码更新2025-02-09
仓库体积1.8 MB
本站数据更新2026-11-08
维护状态低维护
收录时间2026-08-09
浏览次数7

项目介绍

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

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1470

使用教程

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

环境要求

  • macOS 或 Linux 系统(可用 Homebrew 安装)
  • Windows 系统需下载官方预编译可执行文件(x86_64)
  • Docker 方式需已安装 Docker,并具备支持 CUDA 的 GPU 与基础 NVIDIA 驱动
  • 无需安装 Python 或任何机器学习框架

安装与启动步骤

  1. 1Homebrew 安装

    在 macOS 或 Linux 上通过 Homebrew 安装 MusicGPT,安装后即可在终端使用 musicgpt 命令。

    brew install gabotechs/taps/musicgpt
  2. 2Windows 安装

    Windows 用户从 GitHub Releases 下载 musicgpt-x86_64-pc-windows-msvc.exe 可执行文件后直接运行。

  3. 3拉取镜像

    需要 CUDA GPU 加速时推荐使用 Docker 方式,先拉取官方镜像 gabotechs/musicgpt。

    docker pull gabotechs/musicgpt
  4. 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. 5选择交互模式

    MusicGPT 提供 UI 模式和 CLI 模式两种交互方式,可按需选择其中一种使用。

关键配置

配置项必填说明示例
-p 8642:8642是将容器默认 8642 端口映射到宿主机,便于访问 UI8642: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···

★ 327 2026-10-01
aeneas 开源

上传音频和文本,自动生成逐字字幕时间轴

aeneas is a Python/C library and a set of tools to automagically synchronize audio a···

★ 2874 2026-08-09
espeak-ng 开源

轻量离线多语言语音合成,百种语言即用即说

eSpeak NG is an open source speech synthesizer that supports more than hundred langu···

★ 7010 2026-08-09
TellTime 开源

用英式腔调,动嘴就能知道几点

iOS application to tell the time in the British way ⏰

★ 67 2026-08-09
Audio8_TTS 开源

小模型也能合成自然语音,本地部署更省算力

SOTA-Class TTS at Compact Scale

★ 2397 2026-11-08
clipboard-narrator 开源

复制网页文字,后台自动朗读成有声书

Turn any web page into an audiobook, works in the background on desktop!

★ 69 2026-08-09
OtosakuTTS-iOS 开源

在 iPhone 上离线生成自然语音,保护隐私不联网。

Swift library for offline text-to-speech synthesis on iOS/macOS. Generate natural sp···

★ 65 2026-08-09
MOSS-TTS-Nano 开源

0.1B 参数,CPU 上实时跑多语言语音克隆

A 100M-parameter multilingual TTS model for real-time CPU inference, voice cloning, ···

★ 4644 2026-08-09