Awesome
Fastai2 Audio
An audio module for v2 of fastai. We want to help you build audio machine learning applications while minimizing the need for audio domain expertise. Currently under development.
IMPORTANT
This version of the library is no longer being supported. All of the future development can be found here:
https://github.com/fastaudio/fastaudio
Quick Start
Install
In the future we will offer conda and pip installs, but as the code is rapidly changing, we recommend that only those interested in contributing and experimenting install for now. Everyone else should use Fastai audio v1
To install:
pip install packaging
pip install git+https://github.com/rbracco/fastai2_audio.git
If you plan on contributing to the library instead, you will need to do a editable install:
pip install packaging nbdev --upgrade
git clone https://github.com/rbracco/fastai2_audio
cd fastai2_audio
nbdev_install_git_hooks
pip install -e .
Contributing to the library
We are looking for contributors of all skill levels. If you don't have time to contribute, please at least reach out and give us some feedback on the library by posting in the v2 audio thread or contact us via PM @baz or @madeupmasters
How to contribute
Create issues, write documentation, suggest/add features, submit PRs. We are open to anything. A good first step would be posting in the v2 audio thread introducing yourself.
How to submit a PR
The first step to create a new PR is to install jupyter notebook
or jupyterlab
. This library is build using nbdev, meaning that all of the code, documentation and test is written into notebooks, and the .py
python files, online docs and CI tests are created by nbdev based on those notebooks.
All of the files that you will change are present into the nbs/
folder. Your general workflow while developing will be:
- Open the notebooks using jupyter
- Change what is present
- Save the file
- Run
make
and nbdev will update the library files, documentation and run the tests all at once - Check if any errors occured while running the last step, then fix it and run
make
again - Commit the changes
Advanced PR tips
-
The command
nbdev_diff_nbs
can let you know if there is a difference between the local library and the notebooks. -
If you made a change to the notebooks in one of the exported cells, you can update the library with
nbdev_build_lib
ormake fastai2
. Note that this command will only update the library code, so before any commit, you'll need to runmake
as usual to update the docs and run the tests. -
If you made a change to the library, you can export it back to the notebooks with
nbdev_update_lib
.