callcut 0.1.0

Automatic animal call detection.

CallCut

Installation

callcut relies on the torch ecosystem, thus audio-loading goes through torchaudio and torchcodec which requires ffmpeg.

---

FFmpeg installation

For conda-users, you can use one of:

conda install "ffmpeg"
conda install "ffmpeg" -c conda-forge

But you can also use uv or pip and install ffmpeg as a system dependency:

On Linux:

sudo apt install ffmpeg  # Ubuntu
sudo dnf install ffmpeg  # Fedora

On macOS:

brew install ffmpeg

On Windows:

1. Download the "full-shared" build from https://www.gyan.dev/ffmpeg/builds/
2. Extract somewhere (e.g., C:\ffmpeg)
3. Add the bin\ folder to your system PATH

---

After that, the project can be installed as any python package distributed on PyPI:

pip install callcut

For installation from source using uv:

uv sync

To pull the torch binaries for your platform. Otherwise, you can pick either of the 2 extras with pip install callcut[cpu] or pip install callcut[cu128] which will resolve to the PyPI torch dependencies- or alternatively you can install callcut without any extra and manually install the torch dependencies from your preferred index.