requirements.txt

# Use Python 3.11+ for this project. The local server will not run correctly on
# older interpreters such as the system Python 3.9 on macOS.

# Core runtime
fastapi>=0.116,<1.0
python-multipart>=0.0.20,<1.0
uvicorn[standard]>=0.35,<1.0
numpy>=1.26,<2.3
scipy>=1.11,<1.17
pydantic>=2.8,<3.0
aiosqlite>=0.21,<1.0
httpx>=0.28,<1.0
pyyaml>=6.0,<7.0

# Local bird-audio classification runtime
# YAMNet is the default classifier backend. BirdNET enables the default
# species-ID chain when YAMNet reports a bird-related label.
# TensorFlow — Mac Apple Silicon (Metal GPU) constraint:
#   tensorflow-metal 1.2.0 is officially compatible only with tensorflow 2.18.x.
#   Versions 2.19+ break the Metal dylib at import on macOS.
#   Required pinned versions for this machine:
#     tensorflow==2.18.1
#     tensorflow-metal==1.2.0  (install separately: pip install tensorflow-metal==1.2.0)
#     tf-keras==2.18.0         (must match TensorFlow)
tensorflow==2.18.*
tf-keras==2.18.*
birdnet>=0.2.12,<1.0

# PTZ camera effector (optional — lazily imported, only required once an
# effector is registered)
onvif-zeep-async>=3.1,<5.0

# Dev / test
pytest>=8.2,<9.0
pytest-asyncio>=0.23,<2.0