whatisgithub

What is figmirror?

vila-lab/figmirror — explained in plain English

Analysis updated 2026-05-18

153PythonAudience · researcherComplexity · 3/5Setup · moderate

In one sentence

A Python tool that takes a research paper's figure as a style reference and redraws your own data to match it, producing an editable matplotlib script and a print-ready PDF.

Mindmap

mindmap
  root((FigMirror))
    What it does
      Matches paper figure style
      Drawer reviewer loop
      Editable matplotlib output
    Tech stack
      Python
      Matplotlib
      Claude Code or Codex
    Use cases
      Match chart style
      3D figure recreation
      Use figure gallery
      Agent skill mode
    Audience
      Researchers
      Paper authors

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

What do people build with it?

USE CASE 1

Match your own chart's colors, fonts, spacing, and layout to a target figure from a published paper.

USE CASE 2

Recreate a paper's 3D figure style, including camera angle and lighting, for your own data.

USE CASE 3

Use a gallery of 139 reference figures to pick a style when you do not have a specific paper figure on hand.

USE CASE 4

Install FigMirror as a skill inside Claude Code or Codex so you can ask the assistant to mirror a figure's style directly.

What is it built with?

Pythonmatplotlib

How does it compare?

vila-lab/figmirrororchestration-agent/agentorchestrationpaddlepaddle/plsc
Stars153155155
LanguagePythonPythonPython
Last pushed2023-06-06
MaintenanceDormant
Setup difficultymoderatehardmoderate
Complexity3/54/54/5
Audienceresearcherops devopsresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing uv and running an install script, plus an AI backend (Claude Code or Codex) for the agentic loop.

No license is stated in the README.

So what is it?

FigMirror is a Python tool that takes a figure from a research paper as a style reference and then redraws your own data to look like it belongs in that same paper. The idea is to eliminate the time researchers spend hand-tuning chart colors, fonts, spacing, and layout to match a target style. You supply an image of the reference figure and your data, and the tool produces both an editable Python script and a print-ready PDF of the new figure. Under the hood, FigMirror runs what it calls a Drawer and Reviewer loop. The Drawer generates a candidate chart using a charting library called matplotlib. The Reviewer then compares the candidate visually against the reference image, lists what needs to change, and notes which elements are already correct and should not drift further. This loop repeats until the output converges. The tool also maintains a running list of preserved style choices so that later iterations do not undo earlier progress. For three-dimensional figures, the system adds extra steps to handle camera angle, scale, lighting, and surface properties specific to 3D charts. The README describes a technique called Grounded Measurement, which lets the AI model read pixel coordinates and colors directly from the reference image and turn those readings into concrete checks during the revision process. You can run FigMirror in two ways. The web interface runs locally in a browser and shows upload controls, iteration history, and a preview panel. The skill mode installs FigMirror as a plugin inside Claude Code or Codex, letting you ask the AI assistant directly to mirror a figure's style. A gallery of 139 reference figures across 25 chart families is hosted online for users who do not have a specific paper figure on hand. The project is open to contributions, with the README pointing to areas like adding showcase examples, improving the reviewer loop, and writing regression tests. The codebase is written in Python and the install script handles dependencies.

Copy-paste prompts

Prompt 1
Install FigMirror for me from https://github.com/VILA-Lab/FigMirror
Prompt 2
Use FigMirror to mirror this figure's style with my data.
Prompt 3
Explain how FigMirror's Drawer and Reviewer loop iterates to match a reference figure's style.
Prompt 4
How does FigMirror's Grounded Measurement technique read pixel coordinates from a reference image?
Prompt 5
Set up FigMirror's local web UI so I can upload a reference figure and preview iterations in a browser.

Frequently asked questions

What is figmirror?

A Python tool that takes a research paper's figure as a style reference and redraws your own data to match it, producing an editable matplotlib script and a print-ready PDF.

What language is figmirror written in?

Mainly Python. The stack also includes Python, matplotlib.

What license does figmirror use?

No license is stated in the README.

How hard is figmirror to set up?

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

Who is figmirror for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.