Repolode
yokel1121

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. 1

    Clone the repository

    git clone https://github.com/yokel1121/muyang-flat-animation.git
  2. 2

    Install Python dependencies

    pip install -r muyang-flat-animation/requirements.txt
  3. 3

    Copy the Skill folder into the Codex Skills directory (macOS/Linux)

    cp -R ./muyang-flat-animation ~/.codex/skills/muyang-flat-animation
  4. 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