03 / Open source
Ad Video Engine
A brief-driven Python engine that plans, selects, and packages short-form ad campaigns into reviewable production artifacts.
One validated brief produces six concepts and three stable ad specifications plus posting copy, QA, and a manifest; production ranking remains private.
Problem
Why this exists
Creative production becomes difficult to repeat when strategy, prompting, selection, rendering, and review live in separate tools.
Role
What I owned
Product definition, campaign contract, planner abstraction, private ranking boundary, CLI, tests, and documentation.
Original contribution
- Defined a required promotion-brief contract around audience, offer, pain, proof, and tone.
- Added interchangeable local-model and deterministic planners.
- Defined a replaceable ranking boundary without publishing production weights or competitive heuristics.
- Kept every campaign artifact reviewable before paid generation or publication.
System / Architecture
How it works
- 01
YAML brief validation establishes the campaign boundary.
- 02
A planner proposes themes, hooks, scripts, and prompts.
- 03
An injectable private policy can rank concepts; the public edition preserves model order and creates AdSpec records.
- 04
Output services write specifications, posting copy, QA, and a manifest.
Limits
What this does not prove
- The repository does not claim generated campaigns outperform human creative direction.
- Paid rendering requires separate credentials and human review.
- The public example contains no real client data or performance outcome.
Inspect the work