Metadata-Version: 2.1
Name: mimikit
Version: 0.1.3
Summary: Python module for generating audio with neural networks
Home-page: https://github.com/k-tonal/mmk
Author: Antoine Daurat
Author-email: ktonalberlin@gmail.com
License: UNKNOWN
Download-URL: https://github.com/k-tonal/mmk
Keywords: audio music sound deep-learning
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Other Audience
Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
Classifier: Topic :: Multimedia :: Sound/Audio :: Sound Synthesis
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: numpy (==1.19.1)
Requires-Dist: pandas (==1.1.3)
Requires-Dist: librosa (==0.8)
Requires-Dist: h5py (==2.10.0)
Requires-Dist: tables (==3.5.1)
Requires-Dist: torch (>=1.7.0)
Requires-Dist: pytorch-lightning (==1.1.2)
Requires-Dist: tqdm (==4.42.1)
Requires-Dist: matplotlib (==3.1.3)
Requires-Dist: scipy (==1.4.1)
Requires-Dist: scikit-learn (==0.23.2)
Requires-Dist: soundfile (>=0.10.2)
Requires-Dist: neptune-client (==0.4.130)
Requires-Dist: neptune-contrib (==0.24.9)
Requires-Dist: test-tube (>=0.7.5)
Requires-Dist: ipython (>=7.12.0)

# mimikit

Do deep-learning on your own audio files like a pro with just a google account.

`mimikit` is a music modelling kit that lets you mimic / transform your own audio files with generative neural-networks.

It contains a collection of models in pytorch and pytorch-lightning as well as powerful ways to :
- prepare & store your data for these models
- train the models online by free gpu providers
- store and track every experiment you make & every sound bits you generate on neptune.ai - also for free

-----

**Table of Contents**

* [Installation](#installation)
* [Quickstart](#quickstart)
* [Usage](#usage)
* [Documentation](#documentation)
* [Contribute](#contribute)
* [License](#license)

## Installation

mimikit is available as a `pip` package. Open a terminal and type :

```bash
$ pip install mimikit
```

## Quickstart

If you never did deep-learning before, we recommend you start with the [quickest intro to practical deep-learning ever]()

- Have a [google account]() and register with it to [neptune.ai]()
- Put some audio files in your google drive or [make a database]() on your computer
- Open the [FreqNet starter notebook]() in colab and follow the instructions

For more, check out the [mimikit-notebooks](), the [mmikit docs]() or the documentation for the [freqnet package]() 

## Usage 

Check out the [mimikit-notebooks]() for client code examples 

## Documentation

TODO !

## Contribute

`mimikit` welcomes all kinds of contributions! From bug-fixes to new cool experimental models or improving coverage of tests and docs : get in touch and/or make a pull request. 


## License

mimikit is distributed under the terms of the [GNU General Public License v3.0](https://choosealicense.com/licenses/gpl-3.0/)


