v0.2 — 455+ Pretrained Models on HuggingFace

Build, Train & Evaluate
Deepfake Audio Detectors

A modular, configuration-driven framework. Mix frontends, backends, and losses via YAML — no code changes needed.

Raw Audio
Frontend
Backend
Loss
Score

Why DeepFense?

Everything you need for deepfake audio detection research, in one framework.

Modular Design

Swap Wav2Vec2 for WavLM, or AASIST for MLP, with a single line of YAML. All components are decoupled and interchangeable.

Configuration-Driven

Define model architecture, data pipeline, augmentations, loss functions, and training schedule in one YAML file.

HuggingFace Integration

Download any of 455+ pretrained models and 12 benchmark datasets with a single CLI command.

Standardized Metrics

Automatic tracking of EER, minDCF, actDCF, F1, and Accuracy with WandB logging and checkpointing.

Rich Augmentations

Built-in RawBoost, RIR, Codec, AdditiveNoise, SpeedPerturb, AddBabble, DropFreq, DropChunk, and more.

Reproducible Research

Configs are saved with every experiment. Same seed + same config = identical results.

Core Modules

All components are plug-and-play via the registry pattern. Use built-in ones or add your own.

Frontends

Pretrained SSL feature extractors

  • Wav2Vec 2.0
  • WavLM
  • HuBERT
  • MERT
  • EAT

Backends

Classifier heads

  • AASIST
  • ECAPA-TDNN
  • Nes2Net
  • RawNet2
  • MLP
  • TCM

Loss Functions

Training objectives

  • CrossEntropy
  • OC-Softmax
  • AM-Softmax
  • A-Softmax

Augmentations

Data augmentation pipeline

  • RawBoost
  • RIR
  • Codec
  • AdditiveNoise
  • SpeedPerturb
  • AddBabble
  • DropFreq
  • DropChunk

Metrics

Evaluation metrics

  • EER
  • minDCF
  • actDCF
  • ACC
  • F1

Optimizers

Optimization & scheduling

  • Adam
  • AdamW
  • SGD
  • CosineAnnealing
  • StepLR

DeepFense Hugging Face

455+ pretrained models and 12 benchmark datasets, ready to download.

455+ Pretrained Models

Checkpoints across 12 datasets, multiple frontends (WavLM, Wav2Vec2, EAT, MERT), backends (AASIST, Nes2Net, MLP, TCM), and seeds.

deepfense download model ASV19_WavLM_Nes2Net_NoAug_Seed42

12 Benchmark Datasets

ASVSpoof19, CompSpoof, DECRO, SONICS, SpeechFake, WaveFake, FakeMusicCaps, and more — as ready-to-use Parquet files.

deepfense download dataset CompSpoof

Browse & Filter

Search for models by frontend, backend, dataset, or seed from the CLI. Download the config and checkpoint in one command.

deepfense download list-models --filter WavLM

Get Started

Install, download, and train in under 5 minutes.

1. Install
pip install deepfense
Or install from source
git clone https://github.com/Yaselley/deepfense-framework
cd deepfense-framework
pip install -e .
2. Download a dataset & model
deepfense download dataset CompSpoof
deepfense download model ASV19_WavLM_Nes2Net_NoAug_Seed42
3. Train
deepfense train --config deepfense/config/train.yaml
4. Test
deepfense test \
    --config models/ASV19_WavLM_Nes2Net_NoAug_Seed42/config.yaml \
    --checkpoint models/ASV19_WavLM_Nes2Net_NoAug_Seed42/best_model.pth
5. List all components
deepfense list

Full documentation with tutorials, config reference, and extension guides.

Documentation PyPI

Open Source

DeepFense is Apache 2.0 licensed. Contributions welcome — add new models, datasets, augmentations, or improvements.

Contribute on GitHub