batdetect2/docs/source/tutorials/run-inference-on-folder.md

Tutorial: Run inference on a folder of audio files

This tutorial walks through a first end-to-end inference run with the CLI.

Before you start

• BatDetect2 installed in your environment.
• A folder containing .wav files.
• A model checkpoint path.

Tutorial steps

1. Choose your input and output directories.
2. Run prediction with the CLI.
3. Verify output files were written.
4. Inspect predictions and confidence scores.

Example command

batdetect2 predict directory \
  path/to/model.ckpt \
  path/to/audio_dir \
  path/to/outputs

What to do next

• Use {doc}../how_to/tune-detection-threshold to tune sensitivity.
• Use {doc}../reference/cli/index for full command options.

This page is a starter scaffold and will be expanded with a full worked example.