# CS522 Course Project - Birdsong Analysis with Machine Learning
## Bryan Burton - Fall 2025

All of the code is contained in `birdsong_id.ipynb`.

Jupyter is required to load and execute the cells in this notebook.

The notebook should be loaded in a Python 3.17 or greater virtual environment with the libraries from `requirements.txt` installed.

The file `EasternUSABirds.csv` is necessary and contains the list of birds selected for this project.
Birds listed in the file will be searched for on Xeno-Canto and downloaded in the notebook.
This CSV should be located in the same directory as the notebook.

The iNaturalist Sounds dataset is unnecessary; some cells in the notebook require it but they can be skipped.
It can be downloaded from this link: [Train Recordings [81 GB]](https://ml-inat-competition-datasets.s3.amazonaws.com/sounds/2024/train.tar.gz).
This will download a tarball named `train.tar.gz`; extract the folder `train` to the same directory as the notebook.

