# The core. This is everything needed to take a script all the way to a
# finished, narrated, animated video. Nothing here needs an account, an API
# key, or a graphics card.
#
#     python -m pip install -r requirements.txt
#
# Roughly 200 MB installed. The optional extras — the web app, the other
# speech engines, image generation, research tools — are listed in
# `Agents skills folder/pack-setup/references/install.md`, along with what
# each one costs and whether it is safe for commercial work.
#
# Versions are the ones this pipeline was proven on. Newer will usually work;
# if something breaks after an upgrade, pin back to these before hunting.

# Speech. This single line also brings in numpy, onnxruntime, phonemizer and
# espeakng-loader — including the espeak-ng binary itself, so there is NO
# separate system install of espeak. That is why setup is one command here and
# a long afternoon in most comparable stacks.
kokoro-onnx==0.6.1

# Pinned explicitly even though kokoro-onnx pulls it, because almost every
# script in the project depends on it and a surprise major version is the
# kind of thing that breaks audio silently rather than loudly.
numpy==2.4.6

# Reading and writing audio files.
soundfile==0.14.0

# Ships a self-contained ffmpeg binary. Used for loudness normalisation, the
# density gate, footage checks and sound design. Avoids asking the user to
# install ffmpeg separately and put it on PATH.
imageio-ffmpeg==0.6.0

# Image handling for the still-frame checks and for background plates.
pillow==12.2.0
