Metadata-Version: 2.1
Name: fastaudio
Version: 1.0.0
Summary: Audio Module for fastai version 2
Home-page: https://github.com/fastaudio/fastaudio
Author: scart97
Author-email: scart.lucas@gmail.com
License: mit
Project-URL: Documentation, https://fastaudio.github.io/
Description: ![Tests](https://github.com/fastaudio/fastaudio/workflows/Python%20package/badge.svg)
        [![Docs](https://img.shields.io/badge/docs-latest-green)](https://fastaudio.github.io/)
        [![codecov](https://codecov.io/gh/fastaudio/fastaudio/branch/master/graph/badge.svg)](https://codecov.io/gh/fastaudio/fastaudio)
        
        
        # Fastaudio
        > An audio module for fastai v2. We want to help you build audio machine learning applications while minimizing the need for audio domain expertise. Currently under development.
        
        # Quick Start
        
        [Google Colab Notebook](https://colab.research.google.com/github/fastaudio/fastaudio/blob/master/docs//ESC50:%20Environmental%20Sound%20Classification.ipynb)
        
        [Zachary Mueller's class](https://youtu.be/0IQYJNkAI3k?t=1665)
        
        ## Install
        
        
        Install using pip:
        
        ```
        pip install fastaudio
        ```
        
        ---
        
        If you plan on **contributing** to the library instead, you will need to do a editable install:
        
        ```
        # Optional step if using conda
        conda create -n fastaudio python=3.7
        conda activate fastaudio
        ```
        
        ```
        # Editable install
        git clone https://github.com/fastaudio/fastaudio.git
        cd fastaudio
        pip install -e .[dev,testing]
        pre-commit install
        ```
        
        # Testing
        To run the tests and verify everything is working, run the following command from the `fastaudio/` folder (only applicable after doing the editable install steps):
        
        ```
        pytest
        ```
        
        This will run all of the test suit, reporting if there are any errors and also giving a code coverage report. Adittionally, there are extra checks that `pre-commit` run automatically every commit to verify the formatting and flake8 violations. If you want to run those manually, the command is `pre-commit run`
        
        # 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.
        
        Make sure that you have activated the environment that you used `pre-commit install` in so that pre-commit knows where to run the git hooks.
        
        ### 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](https://forums.fast.ai/t/fastai-v2-audio/53535) introducing yourself.
        
        ## Note
        
        This project has been set up using PyScaffold 3.2.3. For details and usage
        information on PyScaffold see https://pyscaffold.org/.
        
        ## Citation
        
        If you used this library in any research, please cite us.
        
        ```
        @misc{coultas_blum_scart_bracco_2020,
         title={Fastaudio},
         url={https://github.com/fastaudio/fastaudio},
         journal={GitHub},
         author={Coultas Blum, Harry A and Scart, Lucas G. and Bracco, Robert},
         year={2020},
         month={Aug}
        }
        ```
        
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Provides-Extra: testing
Provides-Extra: dev
