DuET Piano to Score

DuET Piano to Score

把钢琴录音转写成可读的乐谱，来源可以是上传的文件，也可以是 bilibili 或 抖音 的链接。钢琴家和老师能得到可播放的乐谱，并下载 MusicXML 和 PDF。

由 Wayne42 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：DuET Piano to Score 能听一段钢琴录音，并把它写成可读的乐谱。你给它一个音频或视频文件，或者 bilibili 或 抖音 上的视频链接，它会转写前 240 秒。结果可以在页面里播放，也可以下载成 MusicXML 或 PDF。

适合谁：想从录音得到乐谱的钢琴家、老师和学生，以及想看钢琴转写演示的开发者。

Industry | Who uses it | How they use it | Example
音乐教育 | 钢琴老师 | 从学生的录音得到可读的乐谱 | 把一段练习短片变成可以批注的乐谱
音乐创作 | 钢琴家和编曲人 | 根据一场演奏起草乐谱 | 导出 MusicXML，到记谱软件里再编辑
研究 | 音频研究者 | 在真实录音上试一个钢琴转写模型 | 跑一段短片并阅读它给出的报告

如果你需要转写很长的整段录音，可以跳过它，因为在线演示在 240 秒后就停止。

用在哪里：

• 网页浏览器，在 Hugging Face 上这个 Space 自己的页面里
• 在你自己的电脑上运行副本，用 Windows、macOS 或 Linux 上的 Python 3.12

Use case | Who | What they get back
转写录音 | 钢琴家和老师 | 带播放、跟随音符的光标和自动滚动的乐谱
导出乐谱 | 编曲人 | 同一份乐谱的 MusicXML 和 PDF

如何设置：

• 浏览器，如果你只在线使用这个 Space
• Python 3.12 和 pip，如果你自己运行副本
• packages.txt 里的系统软件包，用 apt-get 安装
• 名为 TIKHUB_API_KEY 的 TikHub 密钥，作为 Space 密钥保存，只用于 bilibili 和 抖音 的链接输入

1. 打开 Hugging Face 上这个 Space 的页面。上传音频或视频不需要安装任何东西。
2. 想在本地运行，先安装 huggingface_hub 包，再下载这个 Space 的文件。
3. 进入新文件夹，然后安装 Gradio 和 requirements.txt 里的包。
4. 用 python 和主文件的路径启动应用。

pip install -U huggingface_hub
hf download Wayne42/DuET-demo --repo-type space --local-dir DuET-demo
cd DuET-demo
pip install gradio==6.30.0
pip install -r requirements.txt

如何使用：在页面上选一个输入来源：Upload audio/video、bilibili 或 抖音。上传文件或粘贴链接，然后运行转写。在自己的电脑上，先启动应用，再打开它提供的页面。

python demo/app.py

Tool | What it does
Upload audio/video | 接收你电脑上的文件
bilibili | 接收视频链接、短链接或带分 P 编号的链接
抖音 | 接收普通视频链接、短链接或完整的分享文字
Web score | 播放乐谱，光标跟随并自动滚动

示例：你选择 Upload audio/video，并加入一段短的钢琴录音。页面会转写前 240 秒，显示一份可以播放的乐谱，然后你把它下载成 MusicXML 或 PDF。

新手与专家：如果你是新手，先上传一段短的钢琴片段，看着乐谱出现。回放一下，听听音符和你的录音是否吻合。

对专家来说，模型是 DuET，一个用于钢琴转写的双编码器 transformer，演示版本是 1.1.0。MusicXML 来自 engraving 1.1.0，带有按上下文判断的调号和音符拼写。PDF 是 MuseScore 的渲染结果，所以浏览器里的分页可能不同。只有演示限制为 240 秒，模型本身没有这个限制。

选择上传、bilibili 或 抖音
获取或读取音频
DuET 转写钢琴音频
乐谱被排版成 MusicXML
你播放它，或下载 MusicXML 或 PDF

注意事项：

• 使用 Gradio 6.30.0 和 Python 3.12 构建，主文件是 demo/app.py
• License: mit
• Cost to run: 链接输入会调用 TikHub，需要一个 TikHub 密钥，来源没有提到其他密钥或付费服务
• Data it reaches: 你上传的音频，链接输入会用到 TikHub、bilibili 和 抖音，另有一个保存一小时的私有音频缓存
• Not for: YouTube 链接，演示不提供；也不适合需要登录的账号，因为它不要求 cookie 或登录
• 从视频中只导出音频，不保存任何视频文件

Hugging Face 上的数据（2026年11月13日）

• 点赞：10
• 构建方式：gradio
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/Wayne42/DuET-demo
• 文件：https://huggingface.co/spaces/Wayne42/DuET-demo/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。