DeepFilterNet3 (ONNX)
ONNX export of the DeepFilterNet3 pretrained model, converted from the PyTorch checkpoint with the upstream export script.
This is an unofficial conversion by a third party. It is not published by the DeepFilterNet authors.
- Original author: Hendrik Schröter and the DeepFilterNet contributors
- Upstream project: https://github.com/Rikorose/DeepFilterNet
- Source checkpoint:
DeepFilterNet3.zipfrom upstream commit82b0c7ad33fc756284104053817d1e855d8d8386(https://github.com/Rikorose/DeepFilterNet/blob/main/models/DeepFilterNet3.zip). Checkpoint epoch 120. - Export script:
df/scripts/export.pyfrom upstream commit7b14b895fe7fc42cab72b4a4c1e49c982bd6404b(2026-11-06), run with default options: opset 12, no simplification, no post-filter. - Versions: PyTorch 2.2.2 (CPU), ONNX 1.23.2, ONNX Runtime 1.32.0.
Usage
The ONNX files contain only the network. DeepFilterNet3Onnx.py in this repository adds the rest in numpy: STFT, ERB features, normalisation, ERB mask and deep filtering. It needs no PyTorch, and no df or libdf packages.
pip install numpy onnxruntime soundfile huggingface_hub
import soundfile as sf
from DeepFilterNet3Onnx import DeepFilterNet3Onnx
model = DeepFilterNet3Onnx("SayedShaun/DeepFilterNet3-onnx") # downloads the files on first use
audio, sr = sf.read("noisy.wav", dtype="float32") # mono, 48 kHz
if audio.ndim > 1:
audio = audio[:, 0]
enhanced = model.enhance(audio, sr=sr) # processes the whole file in one pass
sf.write("enhanced.wav", enhanced, sr)
DeepFilterNet3Onnx also accepts a local folder containing these files. The input must be 48 kHz mono. Processing is not streaming.
Verified: on upstream's assets/noisy_snr0.wav (508,591 samples), the output of this class, run from the Hub repo in an environment with no torch, df or libdf, matches upstream's PyTorch enhance() with the same checkpoint to within a maximum absolute difference of 3.1e-5 (signal RMS 0.055). Each stage (STFT, ERB widths, synthesis) also matches libDF to float32 precision.
Files
enc.onnx: encodererb_dec.onnx: ERB decoderdf_dec.onnx: deep-filter decoderDeepFilterNet3Onnx.py: numpy pre- and post-processing and theDeepFilterNet3Onnxclassconfig.ini: model configuration from the checkpointversion.txt: model name and epochSHA256SUMS.txt: checksums of the files above
Verification
The three ONNX models were run with ONNX Runtime on the input tensors saved during export, and compared with the PyTorch outputs. The maximum absolute difference was 4.8e-6 (encoder), 6.3e-7 (ERB decoder) and 1.2e-7 (DF decoder).
Compared with upstream's DeepFilterNet3_onnx.tar.gz, the sizes of the three ONNX files are within a few kilobytes of upstream's. The bytes are not identical, which is expected for a different PyTorch and ONNX version. Upstream's archive is the reference if you need the exact upstream files.
License
The code and model weights of DeepFilterNet are dual-licensed under the MIT License or the Apache License, Version 2.0, at your option. The license texts are included as LICENSE-MIT and LICENSE-APACHE. Copyright (c) 2021 Hendrik Schröter (per the upstream MIT license).
Upstream license statement: https://github.com/Rikorose/DeepFilterNet#license
- Downloads last month
- 28