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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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

Hashes for nendo_plugin_musicgen-0.1.6.tar.gz
Algorithm Hash digest
SHA256 1fbf39cddfc5388f8723c2a11e2faafdb4db8d8217457f09c78870c2cabc4439
MD5 616cdd9abc9330ca9487f8912f8a7eef
BLAKE2b-256 dbff3634e9c533007b45d78f05423af26040dd4c6d458236fdb868b814cdd919

See more details on using hashes here.

File details

Details for the file nendo_plugin_musicgen-0.1.6-py3-none-any.whl.

File metadata

File hashes

Hashes for nendo_plugin_musicgen-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 8d1ada075f8be8173b4aa090b0374e9f34502abea0cbdfc33f83f8a6e494fbef
MD5 617a44bce76443af3202e885209ed226
BLAKE2b-256 d29963fe47df195263450ae248c550cc81a4a4eec542d77a5ddb62670ca6718a

See more details on using hashes here.

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