<p align="center">
<a href="https://github.com/okio-ai/nendo"><img src="https://okio.ai/docs/assets/nendo_core_logo.png" width="750" alt="Nendo Core"></a>
</p>
<p align="center">
<em>The AI audio tool suite for developers, powering next-gen audio applications.</em>
</p>
<p align="center">
<a href="https://okio.ai" target="_blank">
<img src="https://img.shields.io/website/https/okio.ai" alt="Website">
</a>
<a href="https://github.com/okio-ai/nendo/actions/workflows/test.yml" target="_blank">
<img src="https://github.com/okio-ai/nendo/actions/workflows/test.yml/badge.svg" alt="Test">
</a>
<a href="https://coverage-badge.samuelcolvin.workers.dev/redirect/okio-ai/nendo" target="_blank">
<img src="https://coverage-badge.samuelcolvin.workers.dev/okio-ai/nendo.svg" alt="Coverage">
</a>
<a href="https://coverage-badge.samuelcolvin.workers.dev/redirct/okio-ai/nendo" target="_blank">
<img src="" alt="">
</a>
<a href="https://pypi.org/project/nendo" target="_blank">
<img src="https://img.shields.io/pypi/v/nendo?color=%2334D058&label=pypi%20package" alt="Package version">
</a>
<a href="https://opensource.org/licenses/MIT" target="_blank">
<img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT">
</a>
<a href="https://discord.gg/gaZMZKzScj" target="_blank">
<img src="https://dcbadge.vercel.app/api/server/gaZMZKzScj?compact=true&style=flat" alt="Discord">
</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>
</p>
---
**Website**: <a href="https://okio.ai/" target="_blank">okio.ai</a>
**Documentation**: <a href="https://okio.ai/docs" target="_blank">okio.ai/docs</a>
**Nendo Platform**: <a href="https://github.com/okio-ai/Nendo-Platform" target="_blank">Repository</a>
---
Nendo core is the AI audio tool suite allowing you to effortlessly develop audio apps that amplify efficiency & creativity across all aspects of audio production.
**[Features](#features)** - **[Requirements](#requirements)** - **[Installation](#installation)** - **[Usage](#usage)** - **[Plugins](#plugins)** - **[Contributing](#contributing)**
## Features
- Easy to use, lightweight framework to develop AI audio applications fast.
- Integrated essentials for audio processing and library management.
- An extensible plugin architecture and growing ecosystem of AI Audio plugins.
- Easily combinable tools that together address a wide range of use cases.
- Support for storing, managing and retrieving embedding vectors.
## Requirements
**Nendo core requires Python version 3.8, 3.9 or 3.10.**
> It is recommended to use a [virtual environment](https://docs.python.org/3/library/venv.html) for installing nendo core, in order to avoid dependency conflicts. You can use your favorite virtual environment management system, like [conda](https://docs.conda.io/en/latest/), [poetry](https://python-poetry.org/), or [pyenv](https://github.com/pyenv/pyenv) for example.
Furthermore, the following software packages need to be installed in your system:
- **Ubuntu**: `sudo apt-get install ffmpeg libsndfile1 libportaudio2`
- **Mac OS**: `brew install ffmpeg libsndfile portaudio`
- **Windows**
> Windows support is currently under development. For the time being, we highly recommend using [Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/install) and then following the linux instructions. If you still want to try to get Nendo Core to work natively on Windows, you will need to install the following software packages: [ffmpeg](https://ffmpeg.org/download.html), [libsndfile](https://github.com/libsndfile/libsndfile), and [portaudio](https://files.portaudio.com/download.html)
## Installation
You can install Nendo Core directly via `pip`:
```bash
pip install nendo
```
Then you can run nendo in your python shell, notebook or application as follows:
```python
from nendo import Nendo
nendo = Nendo()
```
... and just like that, you're ready to go! Now, there are multiple ways to configure Nendo, refer to the [relevant documentation pages](https://okio.ai/docs/usage/config/) for more information.
## Usage
For example, [install the musicgen nendo plugin](https://github.com/okio-ai/nendo_plugin_musicgen#requirements).
And then run it using nendo:
```python
from nendo import Nendo
nd = Nendo(plugins=["nendo_plugin_musicgen"])
songs = nd.plugins.musicgen(prompt="funky 70s disco", bpm=120)
songs[0].export("funky_disco.mp3")
```
Please refer to the [documentation](https://okio.ai/docs/usage/) to learn more about how to use nendo.
## Plugins
Nendo thrives on its rich [plugin](https://okio.ai/docs/plugins) ecosystem. There are plugins for many different audio processing tasks and the list is growing:
- Audio Generation
- Source Separation
- Audio Analysis
- Voice Generation
- Midi Generation
- Audio Transcription
- Audio Post-Processing
- Audio Quantization
- Audio Loop-Extraction
If you want to develop your own plugin for nendo, consult the [plugin development documentation](https://okio.ai/docs/development/plugindev/), you'll be surprised how simple it is.
## Contributors
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tbody>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://breathdance.net"><img src="https://avatars.githubusercontent.com/u/5659844?v=4" width="100px;" alt="Felix Lorenz"/><br /><sub><b>Felix Lorenz</b></sub></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/aaronabebe"><img src="https://avatars.githubusercontent.com/u/17432850?v=4" width="100px;" alt="Aaron Abebe"/><br /><sub><b>Aaron Abebe</b></sub></td>
<td align="center" valign="top" width="14.28%"><a href="https://samim.io"><img src="https://avatars.githubusercontent.com/u/2211475?v=4" width="100px;" alt="Samim"/><br /><sub><b>Samim</b></sub></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/shiehn"><img src="https://avatars.githubusercontent.com/u/826261?v=4" width="100px;" alt="Steve Hiehn"/><br /><sub><b>Steve Hiehn</b></sub></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/JLenzy"><img src="https://avatars.githubusercontent.com/u/64747969?v=4" width="100px;" alt="Julian Lenz"/><br /><sub><b>Julian Lenz</b></sub></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/philibb"><img src="https://avatars.githubusercontent.com/u/23077713?v=4" width="100px;" alt="Philipp Braun"/><br /><sub><b>Philipp Braun</b></sub></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/M-HO"><img src="https://avatars.githubusercontent.com/u/4912712?v=4" width="100px;" alt="Michal Ho"/><br /><sub><b>Michal Ho</b></sub></td>
</tr>
</tbody>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
Want to be part of the AI audio revolution? All contributions are welcome! Check out our [contribution guide](https://okio.ai/docs/contributing) to learn more about how to develop with and for nendo.
Raw data
{
"_id": null,
"home_page": "https://okio.ai",
"name": "nendo",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<3.11",
"maintainer_email": "",
"keywords": "AI,Machine Learning,Audio,Generative,Music,Audio Production,Audio Generation,Audio Analysis",
"author": "Okio Team",
"author_email": "team@okio.ai",
"download_url": "https://files.pythonhosted.org/packages/62/ba/87562ddb63c52e84bb5cba01fc01e517f3a5c9279cde105e56dc0741386d/nendo-0.2.4.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"https://github.com/okio-ai/nendo\"><img src=\"https://okio.ai/docs/assets/nendo_core_logo.png\" width=\"750\" alt=\"Nendo Core\"></a>\n</p>\n\n<p align=\"center\">\n <em>The AI audio tool suite for developers, powering next-gen audio applications.</em>\n</p>\n\n<p align=\"center\">\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://github.com/okio-ai/nendo/actions/workflows/test.yml\" target=\"_blank\">\n <img src=\"https://github.com/okio-ai/nendo/actions/workflows/test.yml/badge.svg\" alt=\"Test\">\n</a>\n<a href=\"https://coverage-badge.samuelcolvin.workers.dev/redirect/okio-ai/nendo\" target=\"_blank\">\n <img src=\"https://coverage-badge.samuelcolvin.workers.dev/okio-ai/nendo.svg\" alt=\"Coverage\">\n</a>\n<a href=\"https://coverage-badge.samuelcolvin.workers.dev/redirct/okio-ai/nendo\" target=\"_blank\">\n <img src=\"\" alt=\"\">\n</a>\n<a href=\"https://pypi.org/project/nendo\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/v/nendo?color=%2334D058&label=pypi%20package\" alt=\"Package version\">\n</a>\n<a href=\"https://opensource.org/licenses/MIT\" target=\"_blank\">\n <img src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\">\n</a>\n<a href=\"https://discord.gg/gaZMZKzScj\" target=\"_blank\">\n <img src=\"https://dcbadge.vercel.app/api/server/gaZMZKzScj?compact=true&style=flat\" alt=\"Discord\">\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</p>\n\n---\n\n**Website**: <a href=\"https://okio.ai/\" target=\"_blank\">okio.ai</a>\n\n**Documentation**: <a href=\"https://okio.ai/docs\" target=\"_blank\">okio.ai/docs</a>\n\n**Nendo Platform**: <a href=\"https://github.com/okio-ai/Nendo-Platform\" target=\"_blank\">Repository</a>\n\n---\n\nNendo core is the AI audio tool suite allowing you to effortlessly develop audio apps that amplify efficiency & creativity across all aspects of audio production.\n\n**[Features](#features)** - **[Requirements](#requirements)** - **[Installation](#installation)** - **[Usage](#usage)** - **[Plugins](#plugins)** - **[Contributing](#contributing)**\n\n## Features\n\n- Easy to use, lightweight framework to develop AI audio applications fast.\n- Integrated essentials for audio processing and library management.\n- An extensible plugin architecture and growing ecosystem of AI Audio plugins.\n- Easily combinable tools that together address a wide range of use cases.\n- Support for storing, managing and retrieving embedding vectors.\n\n## Requirements\n\n**Nendo core requires Python version 3.8, 3.9 or 3.10.**\n\n> It is recommended to use a [virtual environment](https://docs.python.org/3/library/venv.html) for installing nendo core, in order to avoid dependency conflicts. You can use your favorite virtual environment management system, like [conda](https://docs.conda.io/en/latest/), [poetry](https://python-poetry.org/), or [pyenv](https://github.com/pyenv/pyenv) for example.\n\nFurthermore, the following software packages need to be installed in your system:\n\n- **Ubuntu**: `sudo apt-get install ffmpeg libsndfile1 libportaudio2`\n- **Mac OS**: `brew install ffmpeg libsndfile portaudio`\n- **Windows**\n\n > Windows support is currently under development. For the time being, we highly recommend using [Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/install) and then following the linux instructions. If you still want to try to get Nendo Core to work natively on Windows, you will need to install the following software packages: [ffmpeg](https://ffmpeg.org/download.html), [libsndfile](https://github.com/libsndfile/libsndfile), and [portaudio](https://files.portaudio.com/download.html)\n\n## Installation\n\nYou can install Nendo Core directly via `pip`:\n\n```bash\npip install nendo\n```\n\nThen you can run nendo in your python shell, notebook or application as follows:\n\n```python\nfrom nendo import Nendo\n\nnendo = Nendo()\n```\n\n... and just like that, you're ready to go! Now, there are multiple ways to configure Nendo, refer to the [relevant documentation pages](https://okio.ai/docs/usage/config/) for more information.\n\n## Usage\n\nFor example, [install the musicgen nendo plugin](https://github.com/okio-ai/nendo_plugin_musicgen#requirements).\n\nAnd then run it using nendo:\n\n```python\nfrom nendo import Nendo\n\nnd = Nendo(plugins=[\"nendo_plugin_musicgen\"])\nsongs = nd.plugins.musicgen(prompt=\"funky 70s disco\", bpm=120)\nsongs[0].export(\"funky_disco.mp3\")\n```\n\nPlease refer to the [documentation](https://okio.ai/docs/usage/) to learn more about how to use nendo.\n\n## Plugins\n\nNendo thrives on its rich [plugin](https://okio.ai/docs/plugins) ecosystem. There are plugins for many different audio processing tasks and the list is growing:\n\n- Audio Generation\n- Source Separation\n- Audio Analysis\n- Voice Generation\n- Midi Generation\n- Audio Transcription\n- Audio Post-Processing\n- Audio Quantization\n- Audio Loop-Extraction\n\nIf you want to develop your own plugin for nendo, consult the [plugin development documentation](https://okio.ai/docs/development/plugindev/), you'll be surprised how simple it is.\n\n## Contributors\n\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n<table>\n <tbody>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://breathdance.net\"><img src=\"https://avatars.githubusercontent.com/u/5659844?v=4\" width=\"100px;\" alt=\"Felix Lorenz\"/><br /><sub><b>Felix Lorenz</b></sub></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/aaronabebe\"><img src=\"https://avatars.githubusercontent.com/u/17432850?v=4\" width=\"100px;\" alt=\"Aaron Abebe\"/><br /><sub><b>Aaron Abebe</b></sub></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://samim.io\"><img src=\"https://avatars.githubusercontent.com/u/2211475?v=4\" width=\"100px;\" alt=\"Samim\"/><br /><sub><b>Samim</b></sub></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/shiehn\"><img src=\"https://avatars.githubusercontent.com/u/826261?v=4\" width=\"100px;\" alt=\"Steve Hiehn\"/><br /><sub><b>Steve Hiehn</b></sub></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/JLenzy\"><img src=\"https://avatars.githubusercontent.com/u/64747969?v=4\" width=\"100px;\" alt=\"Julian Lenz\"/><br /><sub><b>Julian Lenz</b></sub></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/philibb\"><img src=\"https://avatars.githubusercontent.com/u/23077713?v=4\" width=\"100px;\" alt=\"Philipp Braun\"/><br /><sub><b>Philipp Braun</b></sub></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/M-HO\"><img src=\"https://avatars.githubusercontent.com/u/4912712?v=4\" width=\"100px;\" alt=\"Michal Ho\"/><br /><sub><b>Michal Ho</b></sub></td>\n </tr>\n </tbody>\n</table>\n<!-- markdownlint-restore -->\n<!-- prettier-ignore-end -->\n\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n\nWant to be part of the AI audio revolution? All contributions are welcome! Check out our [contribution guide](https://okio.ai/docs/contributing) to learn more about how to develop with and for nendo.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The Nendo AI Audio Tool Suite",
"version": "0.2.4",
"project_urls": {
"Homepage": "https://okio.ai",
"Repository": "https://github.com/okio-ai/nendo"
},
"split_keywords": [
"ai",
"machine learning",
"audio",
"generative",
"music",
"audio production",
"audio generation",
"audio analysis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "03a13ba17df5cfc7aeed6dc4df204636521f3be3989714c838eed234bd6d52b7",
"md5": "4039fd396e81ad10825dc4386b3c8ec1",
"sha256": "4b81a813cf0b2669e642c3d8db7ae47b04761ca45eb7cf9268dca13ece90f60d"
},
"downloads": -1,
"filename": "nendo-0.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4039fd396e81ad10825dc4386b3c8ec1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<3.11",
"size": 60245,
"upload_time": "2024-03-05T09:19:34",
"upload_time_iso_8601": "2024-03-05T09:19:34.444210Z",
"url": "https://files.pythonhosted.org/packages/03/a1/3ba17df5cfc7aeed6dc4df204636521f3be3989714c838eed234bd6d52b7/nendo-0.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "62ba87562ddb63c52e84bb5cba01fc01e517f3a5c9279cde105e56dc0741386d",
"md5": "134e5a2816c001963ff9485d39e8df43",
"sha256": "bbd8c08f04a7a8a11bc6bc5c5c1a17ad7a18c306bc040ed45ab2bb74265bec96"
},
"downloads": -1,
"filename": "nendo-0.2.4.tar.gz",
"has_sig": false,
"md5_digest": "134e5a2816c001963ff9485d39e8df43",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<3.11",
"size": 59256,
"upload_time": "2024-03-05T09:19:36",
"upload_time_iso_8601": "2024-03-05T09:19:36.160079Z",
"url": "https://files.pythonhosted.org/packages/62/ba/87562ddb63c52e84bb5cba01fc01e517f3a5c9279cde105e56dc0741386d/nendo-0.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-05 09:19:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "okio-ai",
"github_project": "nendo",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nendo"
}
JSON
