All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.2.11 - 2025-12-09
- Added model metadata to output
- Added more classes to
__init__.pyfor easier imports - Added skipping of unprocessable inputs
- Loading multiple GPUs in parallel processes was not possible
- Fixed hanging problem after error in processing occurred
- Renamed many of the classes and functions for better clarity
0.2.10 - 2025-11-28
- Added support for Perch model v2
- Removed support for LiteRT on macOS ARM64 due to incompatibility issues
0.2.9 - 2025-11-27
- Added option to supervise progress using callback function during inference
0.2.8 - 2025-11-26
- Added option to predict and encode raw audio numpy arrays
0.2.7 - 2025-11-25
- Added parameter
speedto control playback speed of audio during inference
- Fixed issue with using ProtoBuf CPU backend and TensorFlow GPU being available
- Fixed #17: Issue on macOS with too long ring buffer names
- Fixed #19:
queue.qsize()is not used anymore - Fixed issue with hanging session because of logging
- Fixed issue with downloading same model simultaneously
- Removed
litertinstall option, now litert is always installed if possible - Rename
tflibrary totfliteto better reflect the usage of TFLite/LiteRT - Improved prediction speed, esp. for half-precision models (+10 seg/s)
- Lowered dependencies
- Update
ai-edge-litertto version 2.0.3 onrepro - Better download progress indication of model files
- Model loading in tests is done before running other tests
- Added
reprooption to be able to get reproducible results - Added support for Python 3.13
- Added CI on GitHub Actions for testing on multiple OS and Python versions
- Remove unused dependencies
numbaandresampy
0.2.4 - 2025-11-05
- Fixed issue with loading supported files from a folder
- Increased half-precision prediction speed
- Set "pyarrow==22.0.0"
- Set "numpy==2.0.2" because of compatibility with
perch-hoplite - Set default "half_precision" parameter to False because of lower speed
- Add half precision to CLI
0.2.3 - 2025-11-04
- Added support for Python 3.12
- Changed tensorflow to newest version 2.20.0
0.2.2 - 2025-11-03
- Added support for running multiple sessions in a row or in parallel using threading or multiprocessing
- Each session has its own logger and log file
- Changed naming of the benchmark output files
0.2.1 - 2025-10-29
- Added parameter
is_ravento load function to specify whether a custom Protobuf model is a Raven model or not - Fix int8 acoustic model wrong inference parameters
- Added tests
0.2.0 - 2025-10-27
- Refactored the whole codebase to be able to load model and predict scores in two separate steps
0.2.0a0 - 2025-07-29
- Refactored the whole codebase
0.1.7 - 2025-03-19
- Switched model download links from TUCcloud to Zenodo #10
- Added check for mono files #9
0.1.6 - 2024-09-04
- Support for multiprocessing using
predict_species_within_audio_files_mp
- Separate
ModelV2M4TFLiteintoAudioModelV2M4TFLiteandMetaModelV2M4TFLite - Separate
ModelV2M4ProtobufintoAudioModelV2M4ProtobufandMetaModelV2M4Protobuf - Separate
ModelV2M4intoAudioModelV2M4andMetaModelV2M4 - Move v2.4 models to
birdnet.models.v2m4 - Yield results of
predict_species_within_audio_fileinstead of returning an OrderedDict - Extracted method
predict_species_within_audio_fileandpredict_species_at_location_and_timefrom their respective model - set default value for
batch_sizeto 100
0.1.5 - 2024-08-16
- Custom Raven audio model didn't return same results as custom TFLite model because of sigmoid layer
- TFLite meta model was not returning correct results
- Rename
CustomModelV2M4TFLitetoCustomAudioModelV2M4TFLite - Rename
CustomModelV2M4RaventoCustomAudioModelV2M4Raven
0.1.4 - 2024-08-13
- Support to load custom TFLite models using
CustomModelV2M4TFLite - Support to load custom Raven (Protobuf) models using
CustomModelV2M4Raven
0.1.3 - 2024-08-13
- Make CUDA dependency optional, install with
birdnet[and-cuda]
- Bugfix 'ERROR: Could not find a version that satisfies the requirement nvidia-cuda-nvcc-cu12 (Mac/Ubuntu/Windows)' (#4)
0.1.2 - 2024-08-07
- Add GPU support by introducing the Protobuf model (v2.4)
- Rename class 'ModelV2M4' to 'ModelV2M4TFLite'
- 'ModelV2M4' defaults to Protobuf model now
- Sorting of prediction scores is now: score (desc) & name (asc)
- Bugfix output interval durations are now always of type 'float'
0.1.1 - 2024-08-02
- Add parameter 'chunk_overlap_s' to define overlapping between chunks (#3)
- Remove parameter 'file_splitting_duration_s' instead load files in 3s chunks (#2)
- Remove 'librosa' dependency
0.1.0 - 2024-07-23
- Initial release