figscribe
Desktop GUI for publication-ready scientific plots that exports clean, standalone Matplotlib code instead of a proprietary project file. Pixel-identical preview and export, curve fitting, optional AI assistant. An open-source alternative to Origin.
Install / Use
claude mcp add f4ren -- npx -y github:f4ren/figscribeIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of figscribe
figscribe scores 83/100 on our quality scale, 3006th of 4,728 Development & Engineering skills we index.
Its MCP Server is 20 KB long, well organised into 21 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 9 days ago, so figscribe is actively maintained.
- Our last check on 2026-11-12 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-10. Automated pattern scan on 2026-11-09. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
figscribe compared with similar skills
All 4 of these similar skills score higher than figscribe; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| figscribe (this skill)by f4ren | 83 | 3 | 9d ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 118.1k | 9d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.9k | 10d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 86.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install figscribe?
- Run
claude mcp add f4ren -- npx -y github:f4ren/figscribe. The install tabs above show the steps for each supported agent. - Which AI agents does figscribe work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is figscribe safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is figscribe still maintained?
- The repository was last updated 9 days ago, so figscribe is actively maintained.
Skill content
View source on GitHubfigscribe
A lean desktop application for scientific figures: build and fine-tune plots interactively, and get clean, standalone Python code (Matplotlib) as the result instead of a proprietary project file.
For scientists and engineers who find Origin unwieldy but don't want to hand-write every detail of a Matplotlib figure just to fine-tune it.
- What you see is what you get: the preview, the exported PDF and the generated script draw the same figure, checked pixel by pixel in the tests.
- Sizes as journals state them: millimetres and points, with layouts for single and double columns.
- Everything is undoable, including changes made by an AI assistant.
- Your data stays yours: an assistant sees file and column names, never the values, and can run entirely on your own computer.

Contents
- Status
- Installation
- Getting started
- Features
- The generated code
- AI assistants
- Keyboard and mouse
- Command line
- How it works
- Scope
- Development
Status
Alpha. The features below are implemented and tested on Linux, Windows and macOS with Python 3.11 and 3.13. Behaviour may still change; project files of a release keep opening in later ones. Still to come: style templates, snapping and alignment guides, signed installers, and more plot types, axis formats and fit models (see the roadmap). What changed in each release is in the changelog.
Installation
Installers (no Python needed)
From version 0.3.0 each release has an installer for each system, with the assistant and MCP parts included:
| System | File | Notes |
|---|---|---|
| Linux (x86-64) | figscribe-0.3.0-linux-x86_64.AppImage | chmod +x it and run it. Needs libxcb-cursor0 (Debian, Ubuntu) or xcb-util-cursor (Fedora), which most desktops have. |
| macOS (Apple silicon) | figscribe-0.3.0-macos-arm64.dmg | Open it and drag figscribe to Applications. Intel Macs: use pipx, below. |
| Windows 10/11 | figscribe-0.3.0-windows-x64-setup.exe | Installs for you alone; no administrator needed. |
All releases: github.com/f4ren/figscribe/releases
The installers are not signed yet, so the system asks you once:
- macOS: "figscribe cannot be opened because the developer cannot be
verified". Right-click figscribe in Applications, choose Open, and confirm.
If macOS says the app is damaged, run
xattr -cr /Applications/figscribe.apponce. - Windows: SmartScreen shows "Windows protected your PC". Choose More info, then Run anyway.
The first start takes several seconds longer: Matplotlib builds its font cache.
figscribe script and figscribe mcp are in the same program: on macOS
/Applications/figscribe.app/Contents/MacOS/figscribe, on Windows
figscribe-cli.exe in the install folder.
With Python
figscribe needs Python 3.11 or newer. The simplest way is
pipx or uv, which give
figscribe an environment of its own and put the figscribe command on the
path:
pipx install figscribe # or: uv tool install figscribe
figscribe
pip install figscribe in a virtual environment works as well. With Qt,
Matplotlib and SciPy the installation takes about 1.5 GB. The oldest versions
of the libraries that are tested are NumPy 2.0, SciPy 1.13, Matplotlib 3.10
and PySide6 6.7.
Optional parts:
| Extra | For |
|---|---|
| pipx install "figscribe[chat]" | the built-in AI assistant (Claude, ChatGPT, Gemini, local models) |
| pipx install "figscribe[mcp]" | driving figscribe from an MCP client such as Claude Desktop |
| pipx install "figscribe[chat,mcp]" | both |
To add an extra later, install again with --force. To update:
pipx upgrade figscribe. To work on figscribe itself, see
Development.
Getting started
Start figscribe. The start page offers four ways in:
- Open a data file (CSV,
.npy,.npz). The import dialog detects delimiter, decimal comma, header and unit rows, shows a preview and suggests a first plot, e.g. U against t with error bars dU. - Pick a layout: single column (85 × 60 mm), double column (175 × 70 mm), data with fit and residuals, two panels side by side, or a 16:9 slide.
- Open an example from the gallery: a Gaussian scan, a noisy sensor with its means over the raw line, an RC discharge with fit and residuals, a resonance, a color map and more, twelve in all. Each is a copy in a folder you choose, with its data, ready to change.
Then click anything in the figure or in the contents list to select it, and change it in the property panel on the right. Insert adds data, plots, fits, notes and panels; File > Export writes the figure or its Python script.
Features
Data
- CSV files with automatic detection of delimiter, decimal comma, header and
unit rows, and of the text encoding (UTF-8, or cp1252 and Latin-1 as older
Windows programs write them); NumPy
.npyand.npzfiles (read without pickles, so a data file cannot run code). - A data file is removed with the plots that draw from it, in one undo step; figscribe asks first and names them.
- Each data file is recorded with its SHA-256. If it changes later, figscribe says so instead of silently plotting different data, shows what changed, and takes the new version on request, or lets you point it to where a moved file went.
Plots
- Line, scatter, error bars, histograms, images and color meshes with color bars (linear or logarithmic), notes of one or several lines with or without an arrow (optionally on a background, so they read over a grid), reference lines and shaded ranges.
- Error bars as a shaded band around the line, for dense data.
- The Allan deviation of a time series (fractional frequency or phase), on log-log axes, for the stability of clocks, lasers and sensors.
- Curve fits: linear, polynomial, Gaussian, Lorentzian, exponential, or your
own expression such as
a*exp(-x/tau)+c. Error bars weight the fit; the result shows each parameter with its 1σ uncertainty, the reduced χ² and the residuals, and can be copied. Residuals go into their own panel below, with a line width and a zero line of their own to style. - Fit only a range of x; hold a parameter at its start value or keep it within bounds; change a fit that is already there.
- Leave points out by right-clicking them, or let the fit dialog find outliers and leave them out once you confirm. The data file stays as it is: the points are drawn apart, in light grey or a color and marker of your choice, and the script leaves out the same rows, with the reason.
- Show a plot's values in other units, e.g. seconds as hours since the
start of the measurement or volts as mV, or by a formula such as
x / 60 - 273.15, and draw it from part of its data only. The axis, its marks and the fits follow in the same step. - Draw fewer points than the file has: the mean or median of every n rows, every n-th row, or the mean over intervals of x for unevenly sampled data. An averaged point gets its standard error as error bar (propagated when the plot has errors of its own), fits use the reduced points, and the script does the same arithmetic. Rows left out are removed before averaging, or replaced by the mean of their neighbours.
Layout and style
- Several figures in one project, as tabs above the figure: add one with the look of the others, duplicate, rename, reorder.
- Several panels in a grid: add one to the right, left, above or below, or as an inset. Shared x and y axes, a second y axis on the right.
- Exact figure size in mm, font sizes in pt, linear, log and symlog axes,
axis ranges, major ticks every n with minor ticks between them, tick
marks inward or outward and on all four sides, grid, LaTeX in labels
(
$\Delta U$), units in labels asU (V),U / VorU [V]. - Panel letters, (a), (b), … in the style a journal asks for.
- Axis labels lined up across panels, so that in a column of panels the y labels stand on one line, and a distance for each axis' label.
- Line widths of the frame, the tick marks and the grid, tick lengths, and a dashed or dotted grid.
- Values shown with an SI prefix: frequencies in Hz drawn as
0 … 225with the labelf (kHz), while the data stay in Hz.
Working with the figure
- Click to select, edit in the property panel; every change is one undo step. Click an axis, its numbers or its label, to set its range, ticks and label in plain terms: major ticks every 50, 4 minor ticks between them; with values shown in kHz you type the range in kHz too. Hovering over a field explains it.
- Find a setting by typing (Ctrl+F), or any menu action or setting with the command palette (Ctrl+K). The settings used most come first, the rest are under More. A setting that does nothing in the current state is greyed out, and its tooltip says why.
- Above the settings a path such as Figure › Panel A › X axis shows where you are, each part a link back; the axes are rows in the outline, under their panel.
- Colors come from the figure's color cycle, the colors used lately, or Same as… another plot; a plot's context menu brings it to the front or sends it to the back.
- Numbers can be typed with a decimal comma (
1,5), a minus copied from a PDF (−3) and spaces between thousands (10 000); lists of them are then separated by semicolons (0; 0,5; 1). - Drag the legend and notes into place. Zoom with the mouse wheel and pan by dragging to look closer; Use as axis range keeps that view.
- Double-click an axis label, a title, a legend entry or a note to edit it where it is drawn. Drag an inset's corner to resize it, or the gap between two panels to share the room between them differently. Right-click a plot to style it like another, bring it to the front, fit or hide it.
- The Python code drawer under the figure shows the generated script, live, as you edit.
- Help > About figscribe names the versions of figscribe, Python, Matplotlib and Qt, for a bug report.
Export
- PDF, SVG, EPS, PNG and TIFF (LZW compressed, as journals ask) at the exact size, PNG, TIFF and SVG also with a transparent background; File > Export All Figures… writes every figure of the project at once.
- A standalone Python script (see below).
- The project itself as a readable JSON file (
.figscribe).
The generated code
File > Export Python Script… (or figscribe script PROJECT.figscribe -o plot.py) writes a script that needs only NumPy, Matplotlib and, for fits and
for fewer points drawn, SciPy. It is written the way a person would write it:
no figscribe helpers, named variables, comments where they help. From the
example project's script (shortened):
scan_path = HERE / "scan.csv"
# The figure was made from exactly this file; delete the check to plot a newer one.
if hashlib.sha256(scan_path.read_bytes()).hexdigest() != (
"380a81c153b9c2f47f51c67b4478a251b9e98fd1ba0e533b010e9fb5eab92394"
):
raise SystemExit(f"{scan_path} changed since the figure was made")
t, U, dU = np.loadtxt(scan_path, delimiter=",", skiprows=3, unpack=True)
fig = plt.figur
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
118.1kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.9kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
86.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
