How anil-matcha/zack-d-films-ai-video-generator works
This repository is an agent-guided pipeline for turning a topic into a vertical, stylized 3D explainer short. The user or coding agent researches/selects a topic, creates and reviews a beat map, then generates character references, keyframes, motion clips, and narration before assembling the final video. The README describes approval gates and additional editing capabilities; the sampled assembly code confirms clip ordering, impact zooms, transitions, and audio handling. The sampled scripts show MuAPI calls through a shared provider. Other README-described details, including caption behavior, are not independently verified in the excerpts.
Main entry points: script_generator.py beats.json · provider.py MuAPI client · clips.py Motion clips · assemble.py Video assembly
Components 13
Topic and story
- Topic research
scripts/trend_research.py - Beat breakdown
scripts/script_generator.py - beats.json
scripts/script_generator.py
Visual production
- Character sheets
scripts/character_sheets.py - Keyframes
scripts/keyframes.py - Motion clips
scripts/clips.py
Audio and assembly
- Narration audio
scripts/audio.py - Video assembly
scripts/assemble.py - final.mp4
scripts/assemble.py
Provider integration
- MuAPI client
scripts/provider.py
Other components
- User / agent
- MuAPI platform
- FFmpeg / ffprobe
Connections 18
- User / agent → Topic research: explores topics
README.md - User / agent → Beat breakdown: provides topic
README.md - Topic research → Beat breakdown: selects topic
README.md - Beat breakdown → beats.json: writes beats
scripts/script_generator.py - beats.json → Character sheets: defines references
scripts/character_sheets.py - beats.json → Keyframes: describes shots
scripts/keyframes.py - beats.json → Motion clips: describes shots
scripts/clips.py - beats.json → Narration audio: supplies narration
scripts/audio.py - Character sheets → MuAPI client: requests images
scripts/character_sheets.py - Keyframes → MuAPI client: requests images
scripts/keyframes.py - Keyframes → Motion clips: provides keyframes
README.md - Motion clips → MuAPI client: requests animation
scripts/clips.py - Narration audio → MuAPI client: requests narration
scripts/audio.py - Motion clips → Video assembly: provides clips
scripts/assemble.py - Narration audio → Video assembly: provides audio
README.md - Video assembly → FFmpeg / ffprobe: renders with
scripts/assemble.py - Video assembly → final.mp4: writes render
scripts/assemble.py - MuAPI client → MuAPI platform: calls API
scripts/provider.py