GitHub radar
Turn a plain system description into an animated diagram for an article
This tool turns a text description of your system into a finished diagram: an editable version, a static image, and an animated GIF with moving dots. You get a visual for an article or deck without a designer.
A Python program reads a file describing your architecture (JSON, a text data format) and draws a diagram — an editable version, a static image, and an animated GIF with glowing dots moving along the connection lines.
When it helps
Useful for a technical article or presentation when a plain box-and-arrow diagram looks too flat. Skip it if you don't make diagrams like this.
Pros
- Runs entirely on your own computer, for free
- Output stays editable after you generate it
- No powerful hardware or GPU needed
- You get a static image and an animated GIF at once
Cons
- You still have to write the diagram description by hand in a JSON file
- There's no visual editor for drawing the diagram
How to set it up — step by step
- 1Clone the repository at https://github.com/cclank/lanshu-animated-architecture-diagram.
- 2Install the dependencies with `pip install -r requirements.txt`.
- 3Run the sample diagram: `python3 scripts/render_animated_diagram.py --spec assets/default-spec.json --outdir outputs --verify`.
- 4Open the outputs folder and check the resulting PNG and GIF.
- 5Open your AI agent (Claude Code or Codex) in your project folder and ask it to describe your system as a JSON file modeled on assets/default-spec.json.
- 6Run the renderer with your new file and check the result in the outputs folder.
▌ More finds