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



Documentation Twitter

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.4.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nendo_plugin_musicgen-0.1.4-py3-none-any.whl (8.7 kB view details)

Uploaded Python 3

File details

Details for the file nendo_plugin_musicgen-0.1.4.tar.gz.

File metadata

  • Download URL: nendo_plugin_musicgen-0.1.4.tar.gz
  • Upload date:
  • Size: 9.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.9.16 Linux/6.5.13_1

File hashes

Hashes for nendo_plugin_musicgen-0.1.4.tar.gz
Algorithm Hash digest
SHA256 ad17cf0b14a333f4361e615118aa544baf32ffa9fdad98a93cb8a61548ceef4e
MD5 f08a3ac64b6f539badf4a979fac37a03
BLAKE2b-256 5ce8dce530e43d00b61b33bdb5fe2f7c1824ada54cc2ea2883bfcbd2e3586686

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for nendo_plugin_musicgen-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 e2c1ceaa1fc02b41ba204b9b405dbe623811fca37d08c1b47a0aefd998b3c2f1
MD5 d9404eef61400141176d96e83b4dc4aa
BLAKE2b-256 af66d49c451592965e3f5accba159b93514b2860e7ddc727791936ade71d2338

See more details on using hashes here.

Supported by

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