About
What is TKK?
TKK is a video pipeline that produces short-form educational TikTok videos. Each video follows a "mystery arc" narrative structure — presenting a historical or scientific puzzle, walking through wrong assumptions, then revealing the surprising truth.
Everything is automated: a screenplay file goes in, and a fully rendered vertical video with animated graphics and narration comes out. No manual editing, no After Effects, no drag-and-drop — just code.
The Mystery Arc
Every video follows a 6-beat narrative structure designed to hook viewers and keep them watching to the end:
Explore
Engines
Two rendering engines — Manim (Python, 60+ videos) and Remotion (React, in migration). How they compare and when each is used.
Pipeline
How a video gets made, step by step: screenplay, TTS, preview, QA, render. Plus the MCP server that drives it all.
Values
Design philosophy: deterministic over autonomous, code as source of truth, visual-first storytelling, quality gates.
Roadmap
Where the project is heading: Remotion migration, word-level captions, batch rendering, and the essay-to-video vision.