Skip to main content

GitHub Workflow Status GitHub GitHub issues GitHub Repo stars GitHub all releases

mayavoz is a Pytorch-based opensource toolkit for speech enhancement. It is designed to save time for audio researchers. Is provides easy to use pretrained audio enhancement models and facilitates highly customisable model training.

| Quick Start | Installation | Tutorials | Available Recipes | Demo

Key features :key:

  • Various pretrained models nicely integrated with huggingface :hugs: that users can select and use without any hastle.
  • :package: Ability to train and validation your own custom speech enhancement models with just under 10 lines of code!
  • :magic_wand: A command line tool that facilitates training of highly customisable speech enhacement models from the terminal itself!
  • :zap: Supports multi-gpu training integrated with Pytorch Lightning.

Demo

Noisy audio followed by enhanced audio.

https://user-images.githubusercontent.com/25312635/203756185-737557f4-6e21-4146-aa2c-95da69d0de4c.mp4

Quick Start :fire:

from mayavoz.models import Mayamodel

model = Mayamodel.from_pretrained("shahules786/mayavoz-waveunet-valentini-28spk")
model.enhance("noisy_audio.wav")

Recipes

Model Dataset STOI PESQ URL
WaveUnet Valentini-28spk 0.836 2.78 shahules786/mayavoz-waveunet-valentini-28spk
Demucs Valentini-28spk 0.961 2.56 shahules786/mayavoz-demucs-valentini-28spk
DCCRN Valentini-28spk 0.724 2.55 shahules786/mayavoz-dccrn-valentini-28spk
Demucs MS-SNSD-20hrs 0.56 1.26 shahules786/mayavoz-demucs-ms-snsd-20

Test scores are based on respective test set associated with train dataset.

See tutorials to train your custom model

Installation

Only Python 3.8+ is officially supported (though it might work with Python 3.7)

  • With Pypi
pip install mayavoz
  • With conda
conda env create -f environment.yml
conda activate mayavoz
  • From source code
git clone url
cd mayavoz
pip install -e .

Support

For commercial enquiries and scientific consulting, please contact me.

Acknowledgements

Sincere gratitude to AMPLYFI for supporting this project.

Release files for mayavoz 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mayavoz 0.0.1
File Size Uploaded
mayavoz-0.0.1.tar.gz 29.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mayavoz 0.0.1
File Interpreter ABI Platform
mayavoz-0.0.1-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 67.9 kB

Release files / mayavoz-0.0.1.tar.gz

Download URL mayavoz-0.0.1.tar.gz
Size 29.9 kB
Tags Source
SHA-256 checksum
How to use checksums
0bdc1e6e38f5cb9ee600578889ff7b723f3e282e485eb562f98b3be2644e250a
BLAKE2b-256 checksum
How to use checksums
3d817d744b57d5059044104aed097a5b8d197804931c0dff3ad8d2e7ffe891b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.8.13

Release files / mayavoz-0.0.1-py2.py3-none-any.whl

Download URL mayavoz-0.0.1-py2.py3-none-any.whl
Size 38.1 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
3ed9c7788cbcb227b9e1fde04e3a0672639189acb47b62be74e8cef826f32b70
BLAKE2b-256 checksum
How to use checksums
4ef05b70e8bce998aa168b574f16c6182f0c5d23a0f179b75b6fe1969a86ca54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.8.13

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page