如何用LLM生成古典乐？NotaGen使用全指南

1. 快速上手：启动与访问

1.1 启动NotaGen WebUI

NotaGen是基于大语言模型（LLM）范式构建的高质量符号化古典音乐生成系统，由开发者“科哥”完成WebUI二次开发。该工具将自然语言处理中的序列建模思想迁移到音乐创作领域，通过训练在大量古典乐谱数据上的LLM实现风格化作曲。

要启动NotaGen服务，请在终端中执行以下命令之一：

cd /root/NotaGen/gradio && python demo.py

或使用预设的快捷脚本：

/bin/bash /root/run.sh

成功运行后，您将看到如下提示信息：

================================================== 🎵 NotaGen WebUI ================================================== 访问地址: http://0.0.0.0:7860 ==================================================

这表示Web服务已成功启动，并监听本地7860端口。

1.2 访问用户界面

打开浏览器，输入地址：

http://localhost:7860

即可进入NotaGen图形化操作界面。整个UI布局清晰，分为左右两大功能区，左侧为控制面板用于配置生成参数，右侧为输出区域实时展示生成结果。

重要提示：确保运行环境具备至少8GB显存以支持模型推理，否则可能出现加载失败或生成缓慢的问题。

2. 界面详解：功能模块解析

2.1 左侧控制面板

风格选择区域

• 时期（Period）
  提供三个主要西方古典音乐历史时期的选项：

  • 巴洛克（Baroque）
  • 古典主义（Classical）
  • 浪漫主义（Romantic）

  不同时期对应不同的和声语言、节奏特征与结构逻辑。

• 作曲家（Composer）
  根据所选时期动态更新可选作曲家列表。例如选择“浪漫主义”后，可选肖邦、李斯特、德彪西等具有鲜明个人风格的作曲家。

• 乐器配置（Instrumentation）
  进一步细化作品类型，如“键盘”、“管弦乐”、“室内乐”等。系统会验证组合的有效性，仅当三者构成合理搭配时才允许生成。

高级生成参数

建议初学者保持默认设置，在熟悉生成效果后再尝试调整这些解码策略参数。

2.2 右侧输出面板

• 生成过程日志
  实时显示patch生成进度及中间状态信息，帮助判断是否正常运行。

• 最终乐谱输出
  生成完成后显示ABC格式文本乐谱，支持复制、保存或导出为标准MusicXML文件。

3. 使用流程：四步生成古典音乐

3.1 选择风格组合

生成高质量音乐的关键在于构建合理的风格三元组：时期 → 作曲家 → 乐器配置。

步骤示例：生成一首莫扎特风格的室内乐

1. 在“时期”下拉菜单中选择古典主义
2. “作曲家”自动更新为贝多芬、莫扎特、海顿等，选择莫扎特
3. “乐器配置”随之变为该作曲家常用编制，选择室内乐

系统内置112种合法组合，确保生成内容符合历史语境与作曲规范。

3.2 调整生成参数（可选）

若希望获得更保守或更具创意的结果，可微调高级参数：

• 追求稳定性和风格忠实度：降低Temperature至0.8~1.0
• 增强多样性与新颖性：提高Temperature至1.5以上
• 提升连贯性：适当增加Top-K至15~20

注意极端参数可能导致语法错误或偏离目标风格。

3.3 开始生成音乐

点击“生成音乐”按钮，系统将执行以下流程：

1. 验证输入组合合法性
2. 初始化LLM解码器并加载对应风格的隐式先验知识
3. 分块（patch-based）生成符号化音符序列
4. 拼接并格式化为完整ABC记谱

整个过程耗时约30~60秒，具体取决于硬件性能。

3.4 保存生成结果

生成结束后，点击“保存文件”按钮，系统会自动将两种格式的乐谱保存至：

/root/NotaGen/outputs/

命名规则为：

{作曲家}_{乐器}_{时间戳}.abc {作曲家}_{乐器}_{时间戳}.xml

其中：

• .abc文件为轻量级文本乐谱，便于分享与编辑
• .xml文件为MusicXML标准格式，兼容MuseScore、Sibelius等专业打谱软件

4. 支持风格组合一览

NotaGen覆盖广泛的历史风格与代表性作曲家，以下是部分有效组合参考：

巴洛克时期

古典主义时期

浪漫主义时期

所有组合均经过训练数据验证，确保生成内容在风格学意义上成立。

5. 典型应用场景实践

场景一：创作浪漫派钢琴小品

目标：生成一段类似肖邦夜曲风格的独奏作品

操作路径：

1. 时期：浪漫主义
2. 作曲家：肖邦
3. 乐器配置：键盘
4. 参数保持默认
5. 点击生成

生成后的ABC乐谱可导入MuseScore进行可视化排版与音频渲染。

场景二：模拟贝多芬交响乐片段

目标：探索古典主义大型管弦乐写作

操作路径：

1. 时期：古典主义
2. 作曲家：贝多芬
3. 乐器配置：管弦乐
4. Temperature设为1.0（增强结构性）
5. 生成并保存MusicXML文件

后续可在DAW中加载虚拟乐器进行混音制作。

场景三：对比不同作曲家键盘语言

研究目的：分析巴赫 vs 肖邦在键盘织体上的差异

方法：

1. 固定“键盘”配置
2. 分别选择巴赫与肖邦生成乐谱
3. 对比其旋律轮廓、和声进行与装饰音使用习惯

此方式可用于音乐风格教学或辅助作曲分析。

6. 输出格式说明与后期处理

ABC记谱法简介

ABC是一种基于ASCII字符的简写乐谱格式，适合程序生成与传输。示例如下：

X:1 T:Generated by NotaGen C:Chopin-style M:4/4 L:1/8 K:C z4 | E2 G2 c2 e2 | d2 B2 A2 F2 | G2 c2 e2 g2 | f2 d2 c2 A2 |

特点：

• 易读性强，可用文本编辑器直接修改
• 支持在线转换工具（如abcnotation.com）
• 可被LilyPond、EasyABC等工具转为PDF乐谱

MusicXML：专业级交换格式

• 符合W3C标准的XML结构
• 包含音高、时值、力度、表情记号等完整演奏信息
• 被主流打谱软件原生支持
• 适合进一步编辑、打印或集成到数字乐谱平台

7. 故障排查与常见问题

问题1：点击“生成音乐”无反应

可能原因：未完成有效三元组选择

解决方案：

• 确认已完整选择“时期-作曲家-乐器”
• 查看是否有红色错误提示
• 尝试刷新页面重新加载

问题2：生成速度过慢或卡住

可能原因：GPU资源不足或显存溢出

建议措施：

• 关闭其他占用显存的应用
• 检查系统是否满足8GB显存要求
• 若持续失败，尝试重启服务

问题3：无法保存文件

可能原因：尚未生成乐谱即点击保存

正确流程：

1. 成功生成ABC乐谱并显示在右侧
2. 再点击“保存文件”
3. 检查/root/NotaGen/outputs/目录是否存在且可写

问题4：生成结果质量不稳定

优化建议：

• 多次生成取最优结果（AI创作常态）
• 微调Temperature（推荐范围1.0~1.5）
• 更换作曲家或乐器配置尝试新风格

8. 高级技巧与进阶用法

技巧1：参数调优指南

可通过反复试验建立自己的“最佳实践”参数库。

技巧2：批量生成与筛选机制

虽然当前WebUI不支持一键批量生成，但可通过以下方式实现：

1. 记录一组满意参数
2. 多次点击生成获取多个候选作品
3. 手动挑选最具艺术价值的一版
4. 导出并归档用于后续编曲

未来版本有望加入批处理模式。

技巧3：后期人工润色与再创作

AI生成仅为起点，建议进行以下后期处理：

1. 将.xml文件导入MuseScore调整指法、分句
2. 添加踏板标记、强弱变化等演奏指示
3. 转换为MIDI后接入DAW添加真实音色
4. 在此基础上进行二次作曲扩展

真正实现“人机协同创作”。

9. 注意事项与使用建议

1. 版权说明：本项目开源，但需保留原始作者“科哥”署名
2. 资源需求：运行时需约8GB GPU显存，请提前确认设备能力
3. 生成质量波动：受随机采样影响，每次结果不同，建议多试几次
4. 文件路径固定：所有输出默认保存于/root/NotaGen/outputs/
5. 非商业用途优先：适用于教育、研究与个人创作场景

10. 获取帮助与技术支持

• 技术文档：查看项目根目录CLAUDE.md
• 开发日志：查阅todo.md了解更新计划
• 部署说明：参考镜像说明.md进行定制化部署
• 联系作者：微信 312088415（科哥）

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。