# Nendo Plugin Vampnet
<br>
<p align="left">
<img src="https://okio.ai/docs/assets/nendo_core_logo.png" width="350" alt="nendo core">
</p>
<br>
<p align="left">
<a href="https://okio.ai" target="_blank">
<img src="https://img.shields.io/website/https/okio.ai" alt="Website">
</a>
<a href="https://twitter.com/okio_ai" target="_blank">
<img src="https://img.shields.io/twitter/url/https/twitter.com/okio_ai.svg?style=social&label=Follow%20%40okio_ai" alt="Twitter">
</a>
<a href="https://discord.gg/gaZMZKzScj" target="_blank">
<img src="https://dcbadge.vercel.app/api/server/XpkUsjwXTp?compact=true&style=flat" alt="Discord">
</a>
</p>
---
Nendo Plugin for VampNet: Music Generation via Masked Acoustic Token Modeling
(by [Hugo Flores Garcia](https://github.com/hugofloresgarcia/vampnet)).
## Features
- Generate unconditional variations
- Use custom finetuned vampnet models
- Generate in- and outpaintings from a `NendoTrack`
## Requirements
Due to madmom versions < 0.17 errors with python 3.10, we require the latest version of the package from git, where this is fixed. See also this related issue.
Run:
`pip install git+https://github.com/CPJKU/madmom.git@0551aa8`
This plugin also requires the manual installation of `vampnet` via its git repository:
`pip install git+https://github.com/hugofloresgarcia/vampnet.git@0c0c6bc`
For further information, please refer to the original [vampnet repository](https://github.com/hugofloresgarcia/vampnet).
## Installation
1. [Install Nendo](https://github.com/okio-ai/nendo#installation)
2. `pip install nendo-plugin-vampnet`
## Usage
Take a look at a basic usage example below.
For more detailed information, please refer to the [documentation](https://okio.ai/docs/plugins).
For more advanced examples, check out the examples folder.
or try it in colab:
<a target="_blank" href="https://colab.research.google.com/drive/1IRH3gXLgqtMjfOknMkEmSqPmrEdiKAxM?usp=sharing">
<img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/>
</a>
```python
from nendo import Nendo, NendoConfig
nd = Nendo(config=NendoConfig(plugins=["nendo_plugin_vampnet"]))
track = nd.library.add_track(file_path='/path/to/track.mp3')
vamp = nd.plugins.vampnet(track=track, prefix_secs=2, suffix_secs=0)
vamp.play()
```
## Contributing
Visit our docs to learn all about how to contribute to Nendo: [Contributing](https://okio.ai/docs/contributing/)
## License
Nendo: MIT License
Vampnet: MIT License
Pretrained Models: The weights for the models are licensed CC BY-NC-SA 4.0. Likewise, any VampNet models fine-tuned on the pretrained models are also licensed CC BY-NC-SA 4.0.
Raw data
{
"_id": null,
"home_page": "https://okio.ai",
"name": "nendo-plugin-vampnet",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<3.11",
"maintainer_email": "",
"keywords": "Nendo,AI,Machine Learning,Audio,Generative,Music,Audio Production,Audio Generation,Plugin",
"author": "Aaron Abebe",
"author_email": "aaron@okio.ai",
"download_url": "https://files.pythonhosted.org/packages/18/59/9f6b4afc9f8a50f7f7a229086eb5988543716a28484e770701e00cc200ef/nendo_plugin_vampnet-0.1.3.tar.gz",
"platform": null,
"description": "# Nendo Plugin Vampnet\n\n<br>\n<p align=\"left\">\n <img src=\"https://okio.ai/docs/assets/nendo_core_logo.png\" width=\"350\" alt=\"nendo core\">\n</p>\n<br>\n\n<p align=\"left\">\n<a href=\"https://okio.ai\" target=\"_blank\">\n <img src=\"https://img.shields.io/website/https/okio.ai\" alt=\"Website\">\n</a>\n<a href=\"https://twitter.com/okio_ai\" target=\"_blank\">\n <img src=\"https://img.shields.io/twitter/url/https/twitter.com/okio_ai.svg?style=social&label=Follow%20%40okio_ai\" alt=\"Twitter\">\n</a>\n<a href=\"https://discord.gg/gaZMZKzScj\" target=\"_blank\">\n <img src=\"https://dcbadge.vercel.app/api/server/XpkUsjwXTp?compact=true&style=flat\" alt=\"Discord\">\n</a>\n</p>\n\n---\n\nNendo Plugin for VampNet: Music Generation via Masked Acoustic Token Modeling \n(by [Hugo Flores Garcia](https://github.com/hugofloresgarcia/vampnet)).\n\n## Features \n\n- Generate unconditional variations\n- Use custom finetuned vampnet models\n- Generate in- and outpaintings from a `NendoTrack`\n \n## Requirements\n\nDue to madmom versions < 0.17 errors with python 3.10, we require the latest version of the package from git, where this is fixed. See also this related issue.\n\nRun:\n\n`pip install git+https://github.com/CPJKU/madmom.git@0551aa8`\n\nThis plugin also requires the manual installation of `vampnet` via its git repository:\n\n`pip install git+https://github.com/hugofloresgarcia/vampnet.git@0c0c6bc`\n\nFor further information, please refer to the original [vampnet repository](https://github.com/hugofloresgarcia/vampnet).\n\n## Installation\n\n1. [Install Nendo](https://github.com/okio-ai/nendo#installation)\n2. `pip install nendo-plugin-vampnet`\n\n## Usage\n\nTake a look at a basic usage example below.\nFor more detailed information, please refer to the [documentation](https://okio.ai/docs/plugins).\n\nFor more advanced examples, check out the examples folder.\nor try it in colab:\n\n<a target=\"_blank\" href=\"https://colab.research.google.com/drive/1IRH3gXLgqtMjfOknMkEmSqPmrEdiKAxM?usp=sharing\">\n <img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/>\n</a>\n\n```python\nfrom nendo import Nendo, NendoConfig\n\nnd = Nendo(config=NendoConfig(plugins=[\"nendo_plugin_vampnet\"]))\ntrack = nd.library.add_track(file_path='/path/to/track.mp3')\n\nvamp = nd.plugins.vampnet(track=track, prefix_secs=2, suffix_secs=0)\nvamp.play()\n```\n\n## Contributing\n\nVisit our docs to learn all about how to contribute to Nendo: [Contributing](https://okio.ai/docs/contributing/)\n\n## License\n\nNendo: MIT License\n\nVampnet: MIT License\n\nPretrained Models: The weights for the models are licensed CC BY-NC-SA 4.0. Likewise, any VampNet models fine-tuned on the pretrained models are also licensed CC BY-NC-SA 4.0.",
"bugtrack_url": null,
"license": "MIT",
"summary": "Nendo Plugin for VampNet: Music Generation via Masked Acoustic Token Modeling.",
"version": "0.1.3",
"project_urls": {
"Homepage": "https://okio.ai",
"Repository": "https://github.com/okio-ai/nendo_plugin_vampnet"
},
"split_keywords": [
"nendo",
"ai",
"machine learning",
"audio",
"generative",
"music",
"audio production",
"audio generation",
"plugin"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "286d730c59c5fea2a59f749a53c78850eb057d700a20d1507bdfc47745059aa9",
"md5": "818dc1f34b8a9f30c33fceb2449ba222",
"sha256": "69c59aa7d688cce35066a771bab3aa196919b7c703cf82ac71fb7075bb1a149c"
},
"downloads": -1,
"filename": "nendo_plugin_vampnet-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "818dc1f34b8a9f30c33fceb2449ba222",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<3.11",
"size": 7999,
"upload_time": "2024-02-21T09:46:59",
"upload_time_iso_8601": "2024-02-21T09:46:59.865082Z",
"url": "https://files.pythonhosted.org/packages/28/6d/730c59c5fea2a59f749a53c78850eb057d700a20d1507bdfc47745059aa9/nendo_plugin_vampnet-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "18599f6b4afc9f8a50f7f7a229086eb5988543716a28484e770701e00cc200ef",
"md5": "6ec7b8d90cafa8f4d7bc041feb15100b",
"sha256": "c2f2c46c61fff837dfe5bcb1b5a54cd8b07a63c5e8f06d3f8a82eac4df7612a1"
},
"downloads": -1,
"filename": "nendo_plugin_vampnet-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "6ec7b8d90cafa8f4d7bc041feb15100b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<3.11",
"size": 7517,
"upload_time": "2024-02-21T09:47:01",
"upload_time_iso_8601": "2024-02-21T09:47:01.847106Z",
"url": "https://files.pythonhosted.org/packages/18/59/9f6b4afc9f8a50f7f7a229086eb5988543716a28484e770701e00cc200ef/nendo_plugin_vampnet-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-21 09:47:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "okio-ai",
"github_project": "nendo_plugin_vampnet",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "nendo-plugin-vampnet"
}