Skip to main content

Nendo MusicGen plugin: A state-of-the-art controllable text-to-music model (by Meta Research)

Project description

Nendo Plugin Musicgen


nendo core


Website Twitter Discord


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

  1. Install Nendo
  2. 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:

Open 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

nendo_plugin_musicgen-0.1.6.tar.gz (11.7 kB view hashes)

Uploaded Source

Built Distribution

nendo_plugin_musicgen-0.1.6-py3-none-any.whl (10.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page