All notable changes to this project are documented here. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
- BYOL objective (
BYOLModel) with a scheduled EMA target network. Embedder/load_pretrainedhigh-level embedding API with mean/max/cls pooling.- Offline spectrogram precomputation (
precompute_folder,PrecomputedMelDataset). resona embedCLI subcommand and YAML config support.docs/set: architecture, usage, design notes and API reference.
Trainernow auto-coerces spectrograms to the encoder's expected shape.
- Contrastive objective (
ContrastiveModel) with the NT-Xent loss. - Spectrogram augmentations: SpecAugment, mixup, random resize crop, noise.
Trainerwith warmup-cosine scheduling and gradient clipping.resona pretrain/resona infoCLI.
- Positional embeddings switched to fixed 2-D sin-cos.
- Pure-PyTorch log-mel frontend (
LogMelSpectrogram) with Slaney/HTK filterbanks. - Patch embedding and the MAE-style
random_masking/restore_tokensutilities. AudioTransformerencoder and theMaskedSpectrogramModelobjective.- Synthetic dataset, project scaffolding, CI and tests.