v0.4.3

Release 0.4.3

Important

• All official models have been renamed to use the esp-aves2- prefix naming convention
• All official models are now hosted on Hugging Face in safetensors format https://huggingface.co/collections/EarthSpeciesProject/esp-aves2
• After this release the package and the repo will be renamed to avex and will be made public

Improvements

• Add Hugging Face Hub integration for model hosting and downloading
• Add Safetensor support for model weights
• Add probing API to the library for training and evaluating probes
• Add GCS support for YAML config file loading
• Relax numpy, tensorflow, and torch version requirements for better compatibility
• Add extra_config workaround to allow for outside-of-pydantic configuration
• Update to esp-data 1.5.0

Bug Fixes

• Fix EfficientNet float32 dtype mismatch in process_audio (auto-converts float64 input)
• EfficientNet.forward now accepts optional padding_mask consistent with other models
• Fix BirdNet/birdnetlib tensorflow embedding extraction returning constant embeddings
• Fix classifier head loading issue
• Fix EfficientNet checkpoint loading
• Fix: don't create classification head when return_features_only=True (TensorFlow and PyTorch models)
• Fix beats_naturelm model name reference to official esp_aves2_naturelm_audio_v1_beats

Documentation & Examples

• Shift docs from README.md to docs
• Improve documentation across modules
• Update official models to use safetensors format hosted on Hugging Face
• Fix example_05 to load EAT with return_features_only=True for embedding demo
• Add fully fine-tuning results and plots
• Fix and prune integration tests

---

Acknowledgements

Thanks to all the contributors who made this release possible:

• @benjaminsshoffman
• @david-rx
• @GaganNarula
• @inesnolas
• @mil-ad