# TuneFlow Python SDK
[English](./README.md) | [简体中文](./README.zh.md)
![TuneFlow Screenshots](docs/images/tuneflow_wall_thin.jpg)
[![Build Status](https://dev.azure.com/zeostudio/tuneflow-public/_apis/build/status/tuneflow.tuneflow-py?branchName=main)](https://dev.azure.com/zeostudio/tuneflow-public/_build/latest?definitionId=32&branchName=main)
[![Code Coverage](https://img.shields.io/azure-devops/coverage/zeostudio/tuneflow-public/32/main?logo=azure-pipelines)](https://dev.azure.com/zeostudio/tuneflow-public/_build/latest?definitionId=32&branchName=main)
[![PyPI](https://img.shields.io/pypi/v/tuneflow-py?color=blue&label=tuneflow-py&logo=pypi)](https://pypi.org/project/tuneflow-py/)
[![Discord](https://img.shields.io/discord/1076012137161424906?color=%237289da&logo=discord)](https://discord.com/channels/1076012137161424906/1076012755250851860)
![License](https://img.shields.io/github/license/tuneflow/tuneflow-py)
## What is `TuneFlow` and `tuneflow-py`?
[TuneFlow](https://www.tuneflow.com) is a next-gen DAW that aims to boost music making productivity through the power of AI. Unlike traditional DAWs, TuneFlow has a plugin system designed to facilitate music production in almost all areas, including but not limited to **song writing**, **arrangement**, **automation**, **mixing**, **transcription**...... You can easily write your own algorithms or integrate your AI models directly into the song-making process. `tuneflow-py` is the Python SDK of TuneFlow plugins.
## Installation
```bash
pip install tuneflow-py
```
## Prefer another language?
Check out the SDKs in other languages:
- **Typescript**: https://www.github.com/tuneflow/tuneflow
- Other: Contributions welcome!
## Why `tuneflow-py`?
The core idea of TuneFlow's plugin system is that you only care about the data model, NOT the implementation. A plugin's only goal is to modify the song, and the DAW will apply the changes automatically.
Unlike traditional DAW plugins where you can only process MIDI/audio signals from one track, this plugin system allows you to access and modify any part of the project, which is perfect for integrating complex algorithms and AI models.
What's more exciting is that this execution model allows remote processing, which means you can write and test your plugin locally and deploy it anywhere you like, and the DAW can run your plugin through simple network requests.
Below is an illustration of the plugin execution flow:
![Plugin Flow](docs/images/pipeline_flow_en.jpg)
## Getting Started
Visit [https://help.tuneflow.com/en/developer](https://help.tuneflow.com/en/developer) for developer documentation.
## Examples
### ⌨️ AudioLDM
Generate speech, sound effects, music and more from text prompt.
Repo: https://github.com/tuneflow/AudioLDM
<img src="./docs/images/demos/audioldm_cn.gif" width="500" />
### 🎙️ Singing Transcription
Transcribe a singing vocal from audio to MIDI. Works with background noise or music.
Repo: https://github.com/tuneflow/singing-transcription-plugin
<img src="./docs/images/demos/singing_transcription_icassp2021.gif" width="500" />
### ✂️ Demucs
Separate a raw music audio clip into vocal, drums, bass and others.
Repo:https://github.com/tuneflow/tuneflow-plugin-demucs
<img src="./docs/images/demos/demucs_cn.gif" width="500" />
### 🥁 Pocket Drum
Generate a drum pattern with the given style and optionally a melody midi.
Repo: To be updated.
<img src="./docs/images/demos/pocket_drum_cn.gif" width="500" />
For a comprehensive of example plugins, check out https://www.github.com/tuneflow/tuneflow-py-demos
## Contribute
Checkout [contribution guidelines](./CONTRIBUTE.md).
## Resources
[TuneFlow Website](https://tuneflow.com)
[Typescript SDK](https://www.github.com/tuneflow/tuneflow)
Raw data
{
"_id": null,
"home_page": "",
"name": "tuneflow-py",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "AI,music,DAW,TuneFlow,composition,songwriting,music production,music generation,music transcription,mixing,music theory,music information retrieval,MIR,music analysis,song analysis",
"author": "",
"author_email": "TuneFlow <contact@info.tuneflow.com>",
"download_url": "https://files.pythonhosted.org/packages/bf/c4/582c04675c4fbdb2572057b3b65b5372b33b0105611ba9fcfb6331023b08/tuneflow-py-0.8.4.tar.gz",
"platform": null,
"description": "# TuneFlow Python SDK\n\n[English](./README.md) | [\u7b80\u4f53\u4e2d\u6587](./README.zh.md)\n\n![TuneFlow Screenshots](docs/images/tuneflow_wall_thin.jpg)\n\n[![Build Status](https://dev.azure.com/zeostudio/tuneflow-public/_apis/build/status/tuneflow.tuneflow-py?branchName=main)](https://dev.azure.com/zeostudio/tuneflow-public/_build/latest?definitionId=32&branchName=main)\n[![Code Coverage](https://img.shields.io/azure-devops/coverage/zeostudio/tuneflow-public/32/main?logo=azure-pipelines)](https://dev.azure.com/zeostudio/tuneflow-public/_build/latest?definitionId=32&branchName=main)\n[![PyPI](https://img.shields.io/pypi/v/tuneflow-py?color=blue&label=tuneflow-py&logo=pypi)](https://pypi.org/project/tuneflow-py/)\n[![Discord](https://img.shields.io/discord/1076012137161424906?color=%237289da&logo=discord)](https://discord.com/channels/1076012137161424906/1076012755250851860)\n![License](https://img.shields.io/github/license/tuneflow/tuneflow-py)\n\n## What is `TuneFlow` and `tuneflow-py`?\n\n[TuneFlow](https://www.tuneflow.com) is a next-gen DAW that aims to boost music making productivity through the power of AI. Unlike traditional DAWs, TuneFlow has a plugin system designed to facilitate music production in almost all areas, including but not limited to **song writing**, **arrangement**, **automation**, **mixing**, **transcription**...... You can easily write your own algorithms or integrate your AI models directly into the song-making process. `tuneflow-py` is the Python SDK of TuneFlow plugins.\n\n## Installation\n\n```bash\npip install tuneflow-py\n```\n\n## Prefer another language?\n\nCheck out the SDKs in other languages:\n\n- **Typescript**: https://www.github.com/tuneflow/tuneflow\n- Other: Contributions welcome!\n\n## Why `tuneflow-py`?\n\nThe core idea of TuneFlow's plugin system is that you only care about the data model, NOT the implementation. A plugin's only goal is to modify the song, and the DAW will apply the changes automatically.\n\nUnlike traditional DAW plugins where you can only process MIDI/audio signals from one track, this plugin system allows you to access and modify any part of the project, which is perfect for integrating complex algorithms and AI models.\n\nWhat's more exciting is that this execution model allows remote processing, which means you can write and test your plugin locally and deploy it anywhere you like, and the DAW can run your plugin through simple network requests.\n\nBelow is an illustration of the plugin execution flow:\n\n![Plugin Flow](docs/images/pipeline_flow_en.jpg)\n\n## Getting Started\n\nVisit [https://help.tuneflow.com/en/developer](https://help.tuneflow.com/en/developer) for developer documentation.\n\n## Examples\n\n### \u2328\ufe0f AudioLDM\n\nGenerate speech, sound effects, music and more from text prompt.\n\nRepo: https://github.com/tuneflow/AudioLDM\n\n<img src=\"./docs/images/demos/audioldm_cn.gif\" width=\"500\" />\n\n### \ud83c\udf99\ufe0f Singing Transcription\n\nTranscribe a singing vocal from audio to MIDI. Works with background noise or music.\n\nRepo: https://github.com/tuneflow/singing-transcription-plugin\n\n<img src=\"./docs/images/demos/singing_transcription_icassp2021.gif\" width=\"500\" />\n\n### \u2702\ufe0f Demucs\n\nSeparate a raw music audio clip into vocal, drums, bass and others.\n\nRepo\uff1ahttps://github.com/tuneflow/tuneflow-plugin-demucs\n\n<img src=\"./docs/images/demos/demucs_cn.gif\" width=\"500\" />\n\n### \ud83e\udd41 Pocket Drum\n\nGenerate a drum pattern with the given style and optionally a melody midi.\n\nRepo: To be updated.\n\n<img src=\"./docs/images/demos/pocket_drum_cn.gif\" width=\"500\" />\n\nFor a comprehensive of example plugins, check out https://www.github.com/tuneflow/tuneflow-py-demos\n\n## Contribute\n\nCheckout [contribution guidelines](./CONTRIBUTE.md).\n\n## Resources\n\n[TuneFlow Website](https://tuneflow.com)\n\n[Typescript SDK](https://www.github.com/tuneflow/tuneflow)\n",
"bugtrack_url": null,
"license": "",
"summary": "Implement your music models and algorithms directly in TuneFlow - The next-gen DAW for the AI era",
"version": "0.8.4",
"project_urls": {
"Bug Tracker": "https://github.com/tuneflow/tuneflow-py/issues",
"Homepage": "https://github.com/tuneflow/tuneflow-py"
},
"split_keywords": [
"ai",
"music",
"daw",
"tuneflow",
"composition",
"songwriting",
"music production",
"music generation",
"music transcription",
"mixing",
"music theory",
"music information retrieval",
"mir",
"music analysis",
"song analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "390c5b4bcf52bb4cf9c9d5c9d251e2cc2b2d6d3612038aced6d4362e9b89daa6",
"md5": "6b1bdda161f05c03259293f31ceb13c5",
"sha256": "1ede0a9f70efbd71c84915ba83bc9cfcf3d3c0848cd4eba0017eedb0729906c3"
},
"downloads": -1,
"filename": "tuneflow_py-0.8.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6b1bdda161f05c03259293f31ceb13c5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 48585,
"upload_time": "2023-06-06T20:46:24",
"upload_time_iso_8601": "2023-06-06T20:46:24.170293Z",
"url": "https://files.pythonhosted.org/packages/39/0c/5b4bcf52bb4cf9c9d5c9d251e2cc2b2d6d3612038aced6d4362e9b89daa6/tuneflow_py-0.8.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bfc4582c04675c4fbdb2572057b3b65b5372b33b0105611ba9fcfb6331023b08",
"md5": "19d7db0be3c830a5dcea597391f2b6c5",
"sha256": "a564a8143d0c0f340950566f94ebecc085dae53ec2f1cf693c0078c298924bd4"
},
"downloads": -1,
"filename": "tuneflow-py-0.8.4.tar.gz",
"has_sig": false,
"md5_digest": "19d7db0be3c830a5dcea597391f2b6c5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 58216,
"upload_time": "2023-06-06T20:46:26",
"upload_time_iso_8601": "2023-06-06T20:46:26.058288Z",
"url": "https://files.pythonhosted.org/packages/bf/c4/582c04675c4fbdb2572057b3b65b5372b33b0105611ba9fcfb6331023b08/tuneflow-py-0.8.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-06 20:46:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tuneflow",
"github_project": "tuneflow-py",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "tuneflow-py"
}