Pipeline overview
Pipeline overview
PraisonAI PPT supports two main video pipelines. Both separate build steps from QA gates, but they target different project layouts.
Which pipeline?
| Pipeline | Use when | Project layout | Entry CLI |
|---|---|---|---|
| Deck pipeline | HeyGen article decks, YAML/JSON verses, PPTX → MP4 | examples/heygen-*.yaml |
praisonaippt pipeline |
| Daily single pipeline | YouTube walkthrough from create-news handoff, ffmpeg beats | examples/videos/<slug>/ |
daily-single |
flowchart LR
subgraph deck [Deck pipeline]
YAML[deck.yaml] --> PPTX[PPTX build]
PPTX --> MP4[MP4 export]
MP4 --> Gates[validate-deck gates]
end
subgraph daily [Daily single pipeline]
Handoff[create-news handoff] --> Scripts[segment scripts]
Scripts --> VO[ElevenLabs VO]
VO --> ASM[ffmpeg assemble]
ASM --> QA[validate-qa stages]
end
Documentation map
| Guide | Contents |
|---|---|
| Pipeline architecture | Deck YAML orchestration, pipeline: block, report.json |
| Daily single video pipeline | Build commands, script contract, hook montage, validation |
| Video QA (modular stages) | validate-qa stages s00–s10, reports in merge/qa/ |
| Daily single testing | All test types: unit, stage QA, legacy gates, idempotency |
| Video + transcript workflow | HeyGen 50590 end-to-end |
| Slide QA | Golden JPEG MD5, MP4 frame checks (deck pipeline) |
Daily single — quick path
Recommended order with QA gates between phases (full detail in Daily single video):
PROJECT=examples/videos/anthropic-claude-fable-5-mythos-5
daily-single -p $PROJECT write-scripts # if needed
daily-single -p $PROJECT validate-qa --when pre_build
daily-single -p $PROJECT sync-assets
daily-single -p $PROJECT synthesise-vo
daily-single -p $PROJECT validate-qa --when post_vo
daily-single -p $PROJECT bookend-media
daily-single -p $PROJECT validate-qa --when pre_assemble
daily-single -p $PROJECT build-captions
daily-single -p $PROJECT assemble-beats
daily-single -p $PROJECT validate-display
daily-single -p $PROJECT validate-spoken-visual
daily-single -p $PROJECT validate-qa --when post_build
daily-single -p $PROJECT validate-all
Pilot reference: examples/videos/anthropic-claude-fable-5-mythos-5/
Agent skills: .cursor/skills/daily-single-video/, .cursor/skills/daily-single-video-pipeline/ (spoken-visual-sync.md)
Deck pipeline — quick path
praisonaippt pipeline -i examples/heygen-50590-video-audio-heygen.yaml \
--convert-video --video-output examples/heygen-50590-video-audio-heygen.mp4
Gates and report.json: Pipeline architecture.
Testing at a glance
| Layer | Daily single | Deck pipeline |
|---|---|---|
| Unit tests | pytest tests/test_daily_single_*.py tests/test_video_qa.py |
pytest tests/test_*pipeline* |
| Modular QA | validate-qa --when … |
validate-deck / pipeline gates |
| Publish gate | validate-all + validate-sync --runs 3 |
report.json ok |
See Daily single testing for a plain-language breakdown of every check.