Metadata-Version: 2.4
Name: audio-clean-booster
Version: 0.1.2
Summary: Recommended no-reference speech cleanup pipeline using MossFormer2 plus post-processing.
Author: audio-clean-booster contributors
License: MIT
Project-URL: Homepage, https://github.com/tchamna/audio-clean-booster
Project-URL: Repository, https://github.com/tchamna/audio-clean-booster
Keywords: audio,speech,denoise,dereverb,enhancement
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: soundfile
Provides-Extra: deepfilter
Requires-Dist: deepfilternet==0.5.6; extra == "deepfilter"
Requires-Dist: noisereduce>=3.0.0; extra == "deepfilter"
Requires-Dist: torch; extra == "deepfilter"
Requires-Dist: torchaudio; extra == "deepfilter"
Provides-Extra: clearvoice
Requires-Dist: clearvoice==0.1.2; extra == "clearvoice"
Provides-Extra: quality
Requires-Dist: noisereduce>=3.0.0; extra == "quality"
Provides-Extra: all
Requires-Dist: clearvoice==0.1.2; extra == "all"
Requires-Dist: deepfilternet==0.5.6; extra == "all"
Requires-Dist: noisereduce>=3.0.0; extra == "all"
Requires-Dist: torch; extra == "all"
Requires-Dist: torchaudio; extra == "all"
Dynamic: license-file

# audio-clean-booster

The recommended pipeline is no-reference:

```text
MossFormer2 speech enhancement + built-in post-processing
```

You only need the noisy WAV. A clean reference is optional for advanced experiments.

## Install

```bash
pip install "audio-clean-booster[clearvoice]"
```

## Use

```bash
acb clean noisy_16k.wav noisy_16k_final.wav
```

To keep the intermediate MossFormer2 output:

```bash
acb clean noisy_16k.wav noisy_16k_final.wav --keep-mossformer noisy_16k_mossformer2.wav
```

## Python

```python
from audio_clean_booster import clean_with_best

clean_with_best(
    "noisy_16k.wav",
    "noisy_16k_final.wav",
)
```

## Compare Chunks

```bash
acb compare \
  --source noisy:noisy_16k.wav \
  --source final:noisy_16k_final.wav
```

Open `compare_chunks.html`.

## Advanced Commands

The lower-level commands remain available for experiments:

```bash
acb mossformer noisy.wav mossformer.wav
acb deepfilter noisy.wav deepfilter.wav
acb reference-match mossformer.wav reference.wav final.wav --mode strict
```

For all optional backends:

```bash
pip install "audio-clean-booster[all]"
```
