Metadata-Version: 2.1
Name: nendo
Version: 0.1.1
Summary: The Nendo AI Audio Tool Suite
Home-page: https://okio.ai
License: MIT
Keywords: AI,Machine Learning,Audio,Generative,Music,Audio Production,Audio Generation,Audio Analysis
Author: Okio Team
Author-email: team@okio.ai
Requires-Python: >=3.8,<3.11
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Multimedia :: Sound/Audio
Provides-Extra: dev
Provides-Extra: doc
Requires-Dist: GitPython (>=3.1.40,<4.0.0) ; extra == "doc"
Requires-Dist: alembic (>=1.12.0,<2.0.0) ; extra == "dev"
Requires-Dist: black (>=23.1.0,<24.0.0) ; extra == "dev"
Requires-Dist: coverage (>=7.3.2,<8.0.0) ; extra == "dev"
Requires-Dist: duckdb-engine (>=0.9.0,<0.10.0)
Requires-Dist: freezegun (>=1.2.2,<2.0.0) ; extra == "dev"
Requires-Dist: git_changelog (>=2.3.2,<3.0.0) ; extra == "dev"
Requires-Dist: librosa (>=0.10.0,<0.11.0)
Requires-Dist: markdown-callouts (>=0.3.0,<0.4.0) ; extra == "doc"
Requires-Dist: markdown-exec (>=1.7.0,<2.0.0) ; extra == "doc"
Requires-Dist: materialx (>=1.38.8,<2.0.0) ; extra == "doc"
Requires-Dist: mkdocs (>=1.5.3,<2.0.0) ; extra == "doc"
Requires-Dist: mkdocs-autorefs (>=0.5.0,<0.6.0) ; extra == "doc"
Requires-Dist: mkdocs-coverage (>=1.0.0,<2.0.0) ; extra == "doc"
Requires-Dist: mkdocs-gen-files (>=0.5.0,<0.6.0) ; extra == "doc"
Requires-Dist: mkdocs-git-committers-plugin-2 (>=2.2.0,<3.0.0) ; extra == "doc"
Requires-Dist: mkdocs-literate-nav (>=0.6.1,<0.7.0) ; extra == "doc"
Requires-Dist: mkdocs-material (>=9.4.7,<10.0.0) ; extra == "doc"
Requires-Dist: mkdocs-minify-plugin (>=0.7.1,<0.8.0) ; extra == "doc"
Requires-Dist: mkdocs-monorepo-plugin (>=1.0.5,<2.0.0) ; extra == "doc"
Requires-Dist: mkdocs-pymdownx-material-extras (>=2.5.5,<3.0.0) ; extra == "doc"
Requires-Dist: mkdocs-redirects (>=1.2.1,<2.0.0) ; extra == "doc"
Requires-Dist: mkdocstrings-python (>=1.7.3,<2.0.0) ; extra == "doc"
Requires-Dist: numpy (>=1.20,<2.0)
Requires-Dist: psycopg2 (>=2.9.9,<3.0.0)
Requires-Dist: pydantic (>=2.0.0,<2.5.0)
Requires-Dist: pydantic-settings (>=2.1.0,<3.0.0)
Requires-Dist: pytest (>=7.3.0,<8.0.0) ; extra == "dev"
Requires-Dist: pytz (==2023.3.post1)
Requires-Dist: rich (>=12.5.1,<13.0.0)
Requires-Dist: ruff (>=0.0.275,<0.0.276) ; extra == "dev"
Requires-Dist: setuptools (>=67.6.1,<68.0.0) ; extra == "dev"
Requires-Dist: sounddevice (>=0.4.6,<0.5.0)
Requires-Dist: soundfile (>=0.12,<0.13)
Requires-Dist: sqlalchemy (>=2.0.16,<3.0.0)
Requires-Dist: sqlalchemy-json (>=0.5.0,<0.6.0)
Requires-Dist: tinytag (>=1.8,<2.0)
Requires-Dist: toml (>=0.10.2,<0.11.0) ; extra == "dev"
Project-URL: Repository, https://github.com/okio-ai/nendo
Description-Content-Type: text/markdown

<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/nendo.ai" alt="Documentation">
</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/XpkUsjwXTp" target="_blank">
    <img src="https://dcbadge.vercel.app/api/server/XpkUsjwXTp?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">https://okio.ai/</a>

**Documentation**: <a href="https://okio.ai/docs" target="_blank">https://okio.ai/docs/</a>

**Source Code**: <a href="https://github.com/okio-ai/nendo" target="_blank">https://github.com/okio-ai/nendo</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.

## Requirements

Nendo requires the following software packages 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!

## Usage

For example, install the [musicgen plugin](https://github.com/okio-ai/nendo_plugin_musicgen):

```bash
pip install nendo-plugin-musicgen
```

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.

