TuneFlow Python SDK

English | 简体中文

什么是 TuneFlow 和 tuneflow-py？

TuneFlow 是一款新一代数字音频工作站，旨在通过 AI 的力量提升音乐制作效率。与传统 DAW 不同，TuneFlow 拥有一个插件系统，专为几乎所有音乐制作领域提供支持，包括但不限于 歌曲创作、编曲、自动化、混音、乐谱转录……你可以轻松编写自己的算法，或将 AI 模型直接集成到歌曲制作流程中。tuneflow-py 是 TuneFlow 插件的 Python SDK。

安装

pip install tuneflow-py

更喜欢其他语言吗？

查看其他语言的 SDK：

• TypeScript: https://www.github.com/tuneflow/tuneflow
• 其他：欢迎贡献！

为什么选择 tuneflow-py？

TuneFlow 插件系统的核心理念是：你只需关注数据模型，而无需关心具体实现。插件的唯一目标就是修改乐曲，DAW 会自动应用这些更改。

与传统 DAW 插件只能处理单个音轨上的 MIDI/音频信号不同，该插件系统允许你访问和修改项目的任何部分，非常适合集成复杂的算法和 AI 模型。

更令人兴奋的是，这种执行模式支持远程处理，这意味着你可以在本地编写和测试插件，并将其部署到任何地方；DAW 可以通过简单的网络请求运行你的插件。

以下是插件执行流程的示意图：

开始使用

请访问 https://help.tuneflow.com/en/developer 获取开发者文档。

示例

⌨️ AudioLDM

根据文本提示生成语音、音效、音乐等。

仓库：https://github.com/tuneflow/AudioLDM

🎙️ 歌唱转录

将音频中的歌声转录为 MIDI。即使存在背景噪音或音乐也能正常工作。

仓库：https://github.com/tuneflow/singing-transcription-plugin

✂️ Demucs

将原始音乐音频分离为人声、鼓、贝斯和其他乐器。

仓库：https://github.com/tuneflow/tuneflow-plugin-demucs

🥁 Pocket Drum

根据给定的风格并可选地结合旋律 MIDI，生成鼓点模式。

仓库：待更新。

更多示例插件，请访问 https://www.github.com/tuneflow/tuneflow-py-demos

贡献

请查看 贡献指南。

资源

TuneFlow 官网

TypeScript SDK

TuneFlow Python SDK 快速上手指南

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux
• Python 版本：Python 3.8 或更高版本
• 前置依赖：
  • 已安装 pip 包管理工具
  • （可选）建议创建虚拟环境以隔离依赖：

    python -m venv venv
    # Windows
    venv\Scripts\activate
    # macOS/Linux
    source venv/bin/activate
    

安装步骤

使用 pip 直接安装官方发布的 tuneflow-py 包。

标准安装命令：

pip install tuneflow-py

国内加速安装（推荐中国开发者使用）： 如果您在国内遇到下载速度慢的问题，建议使用清华或阿里镜像源进行安装：

pip install tuneflow-py -i https://pypi.tuna.tsinghua.edu.cn/simple

基本使用

tuneflow-py 的核心设计理念是：插件只关注数据模型，不关心具体实现。您的代码只需负责修改歌曲数据（Song Model），TuneFlow DAW 会自动应用这些更改。

最简单的插件示例

以下是一个基础的插件结构示例，展示如何定义一个插件并修改歌曲中的音符：

from tuneflow import Plugin, Song, Note

class MyFirstPlugin(Plugin):
    def name(self) -> str:
        return "My First AI Plugin"

    def description(self) -> str:
        return "A simple example to modify notes."

    def run(self, song: Song) -> None:
        # 获取第一个轨道
        track = song.get_tracks()[0]
        
        # 遍历并修改音符（例如：将所有音符音调提高一个半音）
        for note in track.get_notes():
            note.pitch += 1
            
        # 无需返回任何内容，直接修改 song 对象即可

运行与测试

1. 将上述代码保存为 .py 文件。
2. 在 TuneFlow DAW 中配置插件路径指向该文件所在目录。
3. 或者，利用其支持的远程处理模式，在本地运行脚本作为服务，通过局域网让 DAW 调用您的算法（适合集成大型 AI 模型）。

更多完整示例（如 AudioLDM 语音生成、Demucs 人声分离等）请参考官方演示仓库： https://www.github.com/tuneflow/tuneflow-py-demos