gitwtfhub

wtf is drawio-scientific-illustrator?

icebird1998/drawio-scientific-illustrator — explained in plain English

Analysis updated 2026-08-13

1,322JavaScriptAudience · researcherComplexity · 3/5LicenseSetup · moderate

TL;DR

A Codex plugin that lets an AI agent draw scientific figures live inside the draw.io desktop app, step by step. Now legacy, superseded by scientific-illustrator.

Mindmap

mindmap
  root((drawio-scientific-illustrator))
    What it does
      Live draw.io figure drawing
      Step by step visible process
      Legacy, superseded project
    Tech stack
      JavaScript
      Node.js
      MCP servers
    Use cases
      Scientific figure creation
      Diagram export
      Codex plugin workflow
    Audience
      Researchers
      Codex users
      Scientific illustrators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Recreate a reference scientific figure step by step inside draw.io using an AI agent.

REASON 2

Generate editable diagrams with labels, arrows, and legends for a scientific paper.

REASON 3

Export a finished draw.io figure as PNG, SVG, PDF, or JPG.

What's in the stack?

JavaScriptNode.jsMCPdraw.io

How it stacks up

icebird1998/drawio-scientific-illustratortandpfun/wardrobeyyx990803/pod
Stars1,3221,3261,335
LanguageJavaScriptJavaScriptJavaScript
Last pushed2020-10-31
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audienceresearchervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Codex with plugin support, draw.io desktop installed, and Node.js 22 or newer, superseded by scientific-illustrator.

Use freely for any purpose, including commercial use, under the MIT license, as long as you keep the copyright notice.

Wtf does this do

drawio-scientific-illustrator is a plugin for Codex, an AI coding assistant, that lets the AI draw scientific figures live inside the actual draw.io desktop application. Instead of generating a finished file and opening it afterward, the AI controls draw.io's own graph tools directly, so a person can watch shapes, labels, arrows, and layout appear on screen step by step as the drawing is built. The project is important to note as legacy: the README states clearly that development has moved to a new repository called scientific-illustrator, and this older version no longer receives feature updates or compatibility fixes, though it remains publicly available for existing users. New and existing users are pointed toward the newer project instead. Under the hood, this repository combines two pieces. First, it includes MCP servers, small background programs that expose callable tools, one that connects to the visible draw.io editor and edits its graph in real time, and another that validates saved drawio files and exports them as PNG, SVG, PDF, or JPG images. Second, it includes a Codex skill, instructions that teach the AI agent how to look at a reference image, break it down into simple editable shapes, draw them with pacing so the process is visible, review sections visually, refine what it drew, and only save the file once the drawing already exists on screen. To use it, someone needs the Codex desktop app or CLI with plugin support, draw.io desktop installed locally, Git, and Node.js version 22 or newer. Installation can happen through a one line script for Windows, macOS, or Linux, or by cloning the repository and registering it manually as a Codex plugin marketplace. Once installed, a user attaches a reference image such as a PNG or PDF page, mentions the plugin by name, and describes the pacing and output formats they want, and the AI redraws the figure inside draw.io using a fixed sequence of tools: launching the editor, checking its status, adding shapes and edges, taking screenshots to inspect progress, correcting details, and finally saving and exporting the result. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Use Draw.io Scientific Illustrator to redraw this reference figure step by step in draw.io.
Prompt 2
Help me install the legacy drawio-scientific-illustrator Codex plugin, or point me to its replacement, scientific-illustrator.
Prompt 3
Walk me through the drawio_live tool sequence used to build and save a scientific figure.

Frequently asked questions

wtf is drawio-scientific-illustrator?

A Codex plugin that lets an AI agent draw scientific figures live inside the draw.io desktop app, step by step. Now legacy, superseded by scientific-illustrator.

What language is drawio-scientific-illustrator written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, MCP.

What license does drawio-scientific-illustrator use?

Use freely for any purpose, including commercial use, under the MIT license, as long as you keep the copyright notice.

How hard is drawio-scientific-illustrator to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is drawio-scientific-illustrator for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.