nendo-plugin-musicgen


Namenendo-plugin-musicgen JSON
Version 0.1.6 PyPI version JSON
download
home_pagehttps://okio.ai
SummaryNendo MusicGen plugin: A state-of-the-art controllable text-to-music model (by Meta Research)
upload_time2024-03-19 17:14:14
maintainer
docs_urlNone
authorAaron Abebe
requires_python>=3.8,<3.11
licenseMIT
keywords nendo plugin ai machine learning audio generative music audio production audio generation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Nendo Plugin Musicgen 

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

---

MusicGen: A state-of-the-art controllable text-to-music model (by [Meta Research](https://github.com/facebookresearch/audiocraft))

## 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`](docs/community_finetunes.json).
If you want to contribute one to the list, open a PR 
or contact us via [Twitter](https://twitter.com/okio_ai) 
or [Discord](https://discord.gg/gaZMZKzScj)!

## 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](https://pytorch.org/get-started/locally/). For all other problems please refer to the [audiocraft repository](https://github.com/facebookresearch/audiocraft/).

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](https://github.com/okio-ai/nendo#installation)
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](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/1krbzz1OqwCXcLWm5JUIa-otas4TeKZCt?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_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](https://okio.ai/docs/contributing/)


## License 

Nendo: MIT License

AudioCraft: MIT License

Pretrained models: The weights are released under the CC-BY-NC 4.0 license

            

Raw data

            {
    "_id": null,
    "home_page": "https://okio.ai",
    "name": "nendo-plugin-musicgen",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8,<3.11",
    "maintainer_email": "",
    "keywords": "Nendo,Plugin,AI,Machine Learning,Audio,Generative,Music,Audio Production,Audio Generation",
    "author": "Aaron Abebe",
    "author_email": "aaron@okio.ai",
    "download_url": "https://files.pythonhosted.org/packages/db/ff/3634e9c533007b45d78f05423af26040dd4c6d458236fdb868b814cdd919/nendo_plugin_musicgen-0.1.6.tar.gz",
    "platform": null,
    "description": "# Nendo Plugin Musicgen \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\nMusicGen: A state-of-the-art controllable text-to-music model (by [Meta Research](https://github.com/facebookresearch/audiocraft))\n\n## Features\n\n- Generate conditional and unconditional music\n- Generate outpaintings from a prompt and a `NendoTrack`\n- Use a `NendoTrack` as melody conditioning to generate music\n- Use custom finetuned musicgen models\n\n## Community Finetunes \ud83d\udd25\n\nFor a list of community finetunes check out [`community_finetunes.json`](docs/community_finetunes.json).\nIf you want to contribute one to the list, open a PR \nor contact us via [Twitter](https://twitter.com/okio_ai) \nor [Discord](https://discord.gg/gaZMZKzScj)!\n\n## Requirements\n\nSince we depend on `audiocraft`, please make sure that you fulfill their requirements. \nYou need Pytorch 2.0.0 or higher, which can be installed via\n\n`pip install \"torch>=2.0\"`\n\n> Note: On Mac OSX, the instructions for installing pytorch differ. Please refer to the [pytorch installation instructions](https://pytorch.org/get-started/locally/). For all other problems please refer to the [audiocraft repository](https://github.com/facebookresearch/audiocraft/).\n\nTo run the plugin you also need to install `audiocraft` by Meta AI Research, run:\n\n`pip install git+https://github.com/facebookresearch/audiocraft`\n\n## Installation\n\n1. [Install Nendo](https://github.com/okio-ai/nendo#installation)\n2. `pip install nendo-plugin-musicgen`\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/1krbzz1OqwCXcLWm5JUIa-otas4TeKZCt?usp=sharing\">\n    <img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/>\n</a>\n\n\n```python\nfrom nendo import Nendo, NendoConfig\n\nnd = Nendo(config=NendoConfig(plugins=[\"nendo_plugin_musicgen\"]))\n\n# load track\ntrack = nd.library.add_track(file_path='/path/to/track.mp3')\n\n# run musicgen with custom model\ngenerated_collection = nd.plugins.musicgen(\n    track=track,\n    n_samples=5,\n    prompt=\"janelle monae, rnb, funky, fast, futuristic\",\n    bpm=116,\n    key=\"C\",\n    scale=\"Major\",\n    duration=30,\n    conditioning_length=10\n)\ngenerated_collection[0].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\n## License \n\nNendo: MIT License\n\nAudioCraft: MIT License\n\nPretrained models: The weights are released under the CC-BY-NC 4.0 license\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Nendo MusicGen plugin: A state-of-the-art controllable text-to-music model (by Meta Research)",
    "version": "0.1.6",
    "project_urls": {
        "Homepage": "https://okio.ai",
        "Repository": "https://github.com/okio-ai/nendo_plugin_musicgen"
    },
    "split_keywords": [
        "nendo",
        "plugin",
        "ai",
        "machine learning",
        "audio",
        "generative",
        "music",
        "audio production",
        "audio generation"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d29963fe47df195263450ae248c550cc81a4a4eec542d77a5ddb62670ca6718a",
                "md5": "617a44bce76443af3202e885209ed226",
                "sha256": "8d1ada075f8be8173b4aa090b0374e9f34502abea0cbdfc33f83f8a6e494fbef"
            },
            "downloads": -1,
            "filename": "nendo_plugin_musicgen-0.1.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "617a44bce76443af3202e885209ed226",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8,<3.11",
            "size": 10880,
            "upload_time": "2024-03-19T17:11:31",
            "upload_time_iso_8601": "2024-03-19T17:11:31.048069Z",
            "url": "https://files.pythonhosted.org/packages/d2/99/63fe47df195263450ae248c550cc81a4a4eec542d77a5ddb62670ca6718a/nendo_plugin_musicgen-0.1.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "dbff3634e9c533007b45d78f05423af26040dd4c6d458236fdb868b814cdd919",
                "md5": "616cdd9abc9330ca9487f8912f8a7eef",
                "sha256": "1fbf39cddfc5388f8723c2a11e2faafdb4db8d8217457f09c78870c2cabc4439"
            },
            "downloads": -1,
            "filename": "nendo_plugin_musicgen-0.1.6.tar.gz",
            "has_sig": false,
            "md5_digest": "616cdd9abc9330ca9487f8912f8a7eef",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8,<3.11",
            "size": 11739,
            "upload_time": "2024-03-19T17:14:14",
            "upload_time_iso_8601": "2024-03-19T17:14:14.346478Z",
            "url": "https://files.pythonhosted.org/packages/db/ff/3634e9c533007b45d78f05423af26040dd4c6d458236fdb868b814cdd919/nendo_plugin_musicgen-0.1.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-19 17:14:14",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "okio-ai",
    "github_project": "nendo_plugin_musicgen",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "nendo-plugin-musicgen"
}
        
Elapsed time: 0.20743s