Nendo MusicGen plugin: A state-of-the-art controllable text-to-music model (by Meta Research)
Project description
Nendo Plugin Musicgen
MusicGen: A state-of-the-art controllable text-to-music model (by Meta Research)
Features
- Generate conditional and unconditional music
- Generate outpaintings from a prompt and a
NendoTrack
- Use a
NendoTrack
as melody conditioning to generate music - Use custom finetuned musicgen models
Community Finetunes 🔥
For a list of community finetunes check out community_finetunes.json
.
If you want to contribute one to the list, open a PR
or contact us via Twitter
or Discord!
Requirements
Since we depend on audiocraft
, please make sure that you fulfill their requirements.
You need Pytorch 2.0.0 or higher, which can be installed via
pip install "torch>=2.0"
Note: On Mac OSX, the instructions for installing pytorch differ. Please refer to the pytorch installation instructions. For all other problems please refer to the audiocraft repository.
To run the plugin you also need to install audiocraft
by Meta AI Research, run:
pip install git+https://github.com/facebookresearch/audiocraft
Installation
- Install Nendo
pip install nendo-plugin-musicgen
Usage
Take a look at a basic usage example below. For more detailed information, please refer to the documentation.
For more advanced examples, check out the examples folder. or try it in colab:
from nendo import Nendo, NendoConfig
nd = Nendo(config=NendoConfig(plugins=["nendo_plugin_musicgen"]))
# load track
track = nd.library.add_track(file_path='/path/to/track.mp3')
# run musicgen with custom model
generated_collection = nd.plugins.musicgen(
track=track,
n_samples=5,
prompt="janelle monae, rnb, funky, fast, futuristic",
bpm=116,
key="C",
scale="Major",
duration=30,
conditioning_length=10
)
generated_collection[0].play()
Contributing
Visit our docs to learn all about how to contribute to Nendo: Contributing
License
Nendo: MIT License
AudioCraft: MIT License
Pretrained models: The weights are released under the CC-BY-NC 4.0 license
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file nendo_plugin_musicgen-0.1.6.tar.gz
.
File metadata
- Download URL: nendo_plugin_musicgen-0.1.6.tar.gz
- Upload date:
- Size: 11.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.7.1 CPython/3.9.16 Linux/6.6.21_1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1fbf39cddfc5388f8723c2a11e2faafdb4db8d8217457f09c78870c2cabc4439 |
|
MD5 | 616cdd9abc9330ca9487f8912f8a7eef |
|
BLAKE2b-256 | dbff3634e9c533007b45d78f05423af26040dd4c6d458236fdb868b814cdd919 |
File details
Details for the file nendo_plugin_musicgen-0.1.6-py3-none-any.whl
.
File metadata
- Download URL: nendo_plugin_musicgen-0.1.6-py3-none-any.whl
- Upload date:
- Size: 10.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.7.1 CPython/3.9.16 Linux/6.6.21_1
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8d1ada075f8be8173b4aa090b0374e9f34502abea0cbdfc33f83f8a6e494fbef |
|
MD5 | 617a44bce76443af3202e885209ed226 |
|
BLAKE2b-256 | d29963fe47df195263450ae248c550cc81a4a4eec542d77a5ddb62670ca6718a |