This project offers a Codex skill and local renderer for generating premium, hand-drawn animated architecture diagrams. It targets users creating visuals for articles, system designs, and workflows, providing editable Excalidraw files, static PNGs, and animated GIFs with a distinct dark-canvas, hand-drawn aesthetic.

How It Works

The system renders diagrams from a JSON specification using a local Python script powered by the Pillow library. It supports generating editable .excalidraw files, static .png previews, and animated .gif outputs with dynamic elements like moving glow points and pulsing modules. The design prioritizes a consistent, polished look with a dark canvas, hand-drawn typography, and subtle animations, avoiding external dependencies like browser automation or remote APIs.

Quick Start & Requirements

• Installation: Clone the repository, install dependencies via python3 -m pip install -r requirements.txt, and run the renderer with python3 scripts/render_animated_diagram.py.
• Prerequisites: Python 3.9+ and Pillow 10.0.0+ are required. ffprobe is optional for media inspection.
• Links: Gallery, Quick Start, Spec Format.

Highlighted Details

• Generates .excalidraw, .png, and animated .gif from a single JSON specification.
• Produces genuine animation with moving highlights and pulsing elements.
• Maintains editable, text-based .excalidraw source files.
• Utilizes local Python rendering, eliminating the need for browser automation or external services.
• Includes frame-diff verification to confirm GIF motion and output validation checks.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or roadmaps are present in the provided README.

Licensing & Compatibility

The project is released under the MIT License, which generally permits broad use, including commercial applications, without significant copyleft restrictions.

Limitations & Caveats

The project intentionally employs a narrow, fixed visual system (dark canvas, specific layout elements) to ensure output consistency, which may limit stylistic customization. It relies on specific versions of Python and Pillow for its rendering pipeline.