OpenMontage/lib
calesthio 44baede67f Add documentary-montage pipeline for retrieval-first motion-clip montage
New end-to-end pipeline for building thematic documentary montages from
a locally-indexed corpus of free stock footage (Pexels, Archive.org,
NASA). The agent builds a project-local corpus, CLIP-ranks candidates
per scene slot, edits with motion-aware arc logic, and composes via
ffmpeg. No paid APIs required for the full path.

Pipeline definition and director skills:
- pipeline_defs/documentary-montage.yaml: 5-stage manifest
  (idea -> scene_plan -> assets -> edit -> compose)
- skills/pipelines/documentary-montage/: 6 director skills
  (executive-producer + idea/scene/asset/edit/compose directors)

Corpus and retrieval infrastructure:
- tools/video/corpus_builder.py: multi-source stock fan-out with
  resumable append-only corpus index
- tools/video/clip_search.py: CLIP ViT-B/32 retrieval —
  rank_for_slot, find_similar_set, diversify, stats
- tools/video/stock_sources/: base + pexels + archive_org + nasa
  adapters with a pluggable BaseStockSource contract
- lib/clip_embedder.py: CLIP wrapper
- lib/corpus.py: corpus schema, jsonl append/read, motion-score
  caching

video_compose fix rolled in because any concat-based pipeline depends
on it:
- Replace ambiguous -to with -t duration (was double-trimming cuts)
- Force re-encode + normalize to 1920x1080 @ 30fps (was keyframe-
  snapping with -c copy and breaking concat on mixed-source corpora)
- Add silent-audio anullsrc fallback for clips without an audio
  stream

README: add Documentary Montage row to the pipeline table and bump
the pipeline count from 11 to 12.
2026-04-10 16:04:28 -07:00
..
providers Initial release — OpenMontage: the first open-source agentic video production system 2026-03-29 08:25:17 -07:00
__init__.py Initial release — OpenMontage: the first open-source agentic video production system 2026-03-29 08:25:17 -07:00
checkpoint.py Add reference video input analysis workflow 2026-04-04 10:01:11 -07:00
clip_embedder.py Add documentary-montage pipeline for retrieval-first motion-clip montage 2026-04-10 16:04:28 -07:00
config_model.py Initial release — OpenMontage: the first open-source agentic video production system 2026-03-29 08:25:17 -07:00
corpus.py Add documentary-montage pipeline for retrieval-first motion-clip montage 2026-04-10 16:04:28 -07:00
delivery_promise.py Implementation spec: governance, decision intelligence, theme system, and E2E bug fixes 2026-04-03 09:35:09 -07:00
env_loader.py Initial release — OpenMontage: the first open-source agentic video production system 2026-03-29 08:25:17 -07:00
media_profiles.py Initial release — OpenMontage: the first open-source agentic video production system 2026-03-29 08:25:17 -07:00
pipeline_loader.py Add reference video input analysis workflow 2026-04-04 10:01:11 -07:00
playbook_generator.py Implementation spec: governance, decision intelligence, theme system, and E2E bug fixes 2026-04-03 09:35:09 -07:00
scoring.py Add Grok media providers and improve selector routing 2026-04-05 15:31:37 -07:00
shot_prompt_builder.py Implementation spec: governance, decision intelligence, theme system, and E2E bug fixes 2026-04-03 09:35:09 -07:00
slideshow_risk.py Implementation spec: governance, decision intelligence, theme system, and E2E bug fixes 2026-04-03 09:35:09 -07:00
source_media_review.py Implementation spec: governance, decision intelligence, theme system, and E2E bug fixes 2026-04-03 09:35:09 -07:00
variation_checker.py Implementation spec: governance, decision intelligence, theme system, and E2E bug fixes 2026-04-03 09:35:09 -07:00