A Codex and Claude Code skill that turns a topic, article or story into a narrated hand-drawn explainer video, with stroke-by-stroke drawing and Chinese handwriting.
yokel1121/muyang-flat-animation
A Codex Skill that turns a Chinese spoken line or abstract idea into pen-line sketch explainer animation assets with selective colored-pencil fill, generated via Gemini.
- Stars
- 287
- Forks
- 39
- Open issues
- 0
- Last commit
- 3 months ago
What is it?
Muyang Flat Animation is a Codex Skill for producing short explainer video clips in a hand-drawn style: paper-textured pen linework with selective colored-pencil fills. You give it a Chinese sentence, opinion, or abstract concept, and it builds the clip through a three-gate workflow: confirm the visual concept, composition and motion plan first, then generate and approve the final still frame, and finally call the Gemini video API and check the output frame by frame and for audio.
It supports character-led narration as well as content-only visualization without people, custom canvas sizes such as 9:16 and 16:9, several semantic color palettes, and either synchronized light sound effects or silent output. The repository also includes a standalone batch video generator script and an inspection script that checks camera drift, character and hand consistency, style drift, and output specs. Setup requires Python 3.10+, FFmpeg, FFprobe, and a Gemini API key.
Key features
- 01Generates pen-line sketch style explainer clips with selective colored-pencil fills.
- 02Supports character narration and content-only visualizations without people.
- 03Accepts 9:16, 16:9, 3:4, 4:5, 1:1 or custom pixel canvas sizes.
- 04Offers semantic auto colors, built-in presets, or custom color values.
- 05Adds light synchronized sound effects or outputs silent video.
- 06Includes a batch video generator and a QA script for frame and audio checks.
Use cases
- Producing knowledge-explainer short videos for social media or courses.
- Turning a single abstract idea into a visual sketch animation for a presentation.
- Creating vertical 9:16 clips for short-video platforms with a consistent hand-drawn look.
Quick start
- 1
Clone the repository
git clone https://github.com/yokel1121/muyang-flat-animation.git - 2
Install Python dependencies
pip install -r muyang-flat-animation/requirements.txt - 3
Copy the Skill folder into the Codex Skills directory (macOS/Linux)
cp -R ./muyang-flat-animation ~/.codex/skills/muyang-flat-animation - 4
Check the setup
python ~/.codex/skills/muyang-flat-animation/scripts/check_setup.py
Things to know
- Requires a Gemini API key, FFmpeg and FFprobe installed separately.
- Video generation depends on Gemini model names, regions, quotas and billing, which may change; 429 errors are common on limited keys.
- Checking whether pencil or paper friction sounds appear still requires manual listening.
Topics
FAQ
- What is muyang-flat-animation?
- A Codex Skill that turns a Chinese spoken line or abstract idea into pen-line sketch explainer animation assets with selective colored-pencil fill, generated via Gemini. Muyang Flat Animation is a Codex Skill for producing short explainer video clips in a hand-drawn style: paper-textured pen linework with selective colored-pencil fills. You give it a Chinese sentence, opinion, or abstract concept, and it builds the clip through a three-gate workflow: confirm the visual concept, composition and motion plan first, then generate and approve the final still frame, and finally call the Gemini video API and check the output frame by frame and for audio.
- Is muyang-flat-animation free to use? What license does it have?
- muyang-flat-animation is open source under the MIT license. Check the license terms before using it in commercial products.
- Is muyang-flat-animation still maintained?
- Updated within 6 months. The last commit to muyang-flat-animation was on Jul 22, 2026.
- What can I use muyang-flat-animation for?
- Producing knowledge-explainer short videos for social media or courses. Turning a single abstract idea into a visual sketch animation for a presentation. Creating vertical 9:16 clips for short-video platforms with a consistent hand-drawn look.
- How do I install muyang-flat-animation?
- Clone the repository: git clone https://github.com/yokel1121/muyang-flat-animation.git Install Python dependencies: pip install -r muyang-flat-animation/requirements.txt Copy the Skill folder into the Codex Skills directory (macOS/Linux): cp -R ./muyang-flat-animation ~/.codex/skills/muyang-flat-animation Check the setup: python ~/.codex/skills/muyang-flat-animation/scripts/check_setup.py
- Where can I get muyang-flat-animation?
- The source code and installation instructions are on GitHub: https://github.com/yokel1121/muyang-flat-animation
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Turns a written script into a narrated explainer video or product demo, with a local voice, word timing and canvas rendering, driven by a coding agent.
A Codex Skill that turns Chinese explainer scripts or SRT files into hand-drawn videos with stroke-by-stroke drawing, plus program-driven animation.
Code-first Python framework from Google for building, evaluating, and deploying AI agents, optimized for Gemini but model-agnostic.
Open-source speech recognition toolkit for offline and streaming ASR, with VAD, punctuation, speaker labels and OpenAI-compatible serving.
Agentic video generation framework that turns a story idea, screenplay, or novel into a multi-shot video by coordinating script, storyboard, character, and video generation agents.