scripts

Scripts

Reusable helper scripts collected from across the zoomcamps. Each is self-contained — copy the folder you need into a camp, or run it from here. Python scripts use uv (uv run <script>.py).

Script	From	What it does
check-zoomcamp/	this repo	Checks a course repository against the curriculum conventions in ../STRUCTURE.md: layout, manifests, unit page shape, link and image containment. Run it locally before pushing; every course repo also runs it on pull requests through a pinned reusable workflow.
generate-thumbnails/	Data Engineering	Self-hosts YouTube thumbnails: downloads the raw frame, overlays a play button, commits it under images/, and rewrites the markdown link. Idempotent. Replaces the flaky external thumbnail service.
youtube-upload/	LLM	Video publishing pipeline: rename clips, clip transcripts, add chapters, and upload to YouTube from a manifest.
chop-specs/	LLM	chop.sh plus per-module .spec files to chop long recordings into per-lesson clips. See ../docs/video-lesson-chopping.md.
generate-pages/	ML, MLOps	Notebooks that generate course pages / descriptions from the module structure.

Conventions

• Python tooling uses uv, either with a committed pyproject.toml + uv.lock (see generate-thumbnails) or with PEP 723 inline metadata in the script itself (see check-zoomcamp, which is run straight from a URL and so must carry its own dependencies).
• Keep scripts idempotent where possible so they can be re-run safely.
• When you improve a script in one camp, update it here so the others benefit.