sprezzature-figures
Figures
How to get a figure
Ask our tool:
- "make a figure"
- "chart this"
- "treemap"
- "candlestick"
- "heatmap"
- "sankey"
- "SHAP plot"
- "render this diagram"
Every figure below carries a kit: a zip with the data as a CSV, the generator that reads it, and the interactive SVG it writes. Two Python files, no build step, and for most of them nothing to install at all. The five glyph maps sit on the maps page and the two animated Gapminder generators on the Hans ROSLING tribute; with the 160 below, that is the whole 168-kind catalogue.
Simulates the default figure through a reader's eyes (normal vision for zoom).
Comparison & ranking
Rank and contrast categories: bars, lollipops, dumbbells and their kin.
Time series & trends
How a value moves over an ordered axis: lines, areas and event timelines.
Distributions
The shape, spread and skew of one variable: histograms, boxes, densities.
Correlation & multivariate
Relationships between two or more measures: scatters, pair matrices, projections.
Matrices & heatmaps
Values on a grid, colour-encoded: heatmaps, clustermaps, confusion and correlation.
Part-to-whole & composition
Slices and nested parts of a whole: donuts, treemaps, waffles, flows into stages.
Hierarchies, networks & flows
Nodes, edges and movement: trees, graphs, chords, Sankeys.
Maps & spatial
Values in geographic or directional space: thematic maps, spike maps, wind and vector fields.
Model evaluation & science
Diagnostics and scientific plots: ROC, calibration, survival, forest, volcano.
Gauges, 3-D, sets & the rest
KPI gauges, projected 3-D, set intersections, and one-of-a-kind figures.
No figure matches. Try another term.
Frequently asked questions
How do I install sprezzature-figures?
Run pip install sprezzature-figures (Python 3.10 to 3.13): one command installs the generators, the command line, the HTTP API, the MCP server and Sprezzature Studio, with no extras to choose. It is free and open source under the BSD 3-Clause licence, and sprezzature-figures render bar --out check.svg checks the install.
How many chart types does sprezzature-figures have?
sprezzature-figures has +150 chart types in its catalogue, all marked stable, and sprezzature-figures list prints them. The gallery on this page shows all but seven of them on purpose: the five glyph maps are on the maps page and the two animated Gapminder figures on the Hans ROSLING page.
Which file formats can sprezzature-figures export?
sprezzature-figures writes SVG by default, self-contained with its fonts embedded, and the --out extension also picks .png, .jpg, .pdf or .html. PNG, JPEG and PDF are rasterised from that SVG inside Python, and --scale 3 upsamples them for high-density screens.
What is the Ralph Eyeball Loop?
The Ralph Eyeball Loop is how sprezzature-figures looks at a figure before calling it done: it renders an SVG, an HTML page or a TikZ source to PNG, writes an assessment, and you edit the source and run it again. By default the agent running it reads the picture; with --local, the vision model qwen3-vl:8b served by Ollama writes the critique offline. It is the script scripts/ralph_eyeball_loop.py in the repository, explained on its own page.
Does sprezzature-figures send my data to a cloud service?
No: sprezzature-figures renders, recommends and checks figures on your machine with no model and no account. The three steps that use a model (redraw, the Studio chat and the eyeball loop's --local mode) call one served by Ollama locally by default, through best-engine-ai-helper. Used as a skill, the agent itself follows its own provider's data policy.
What does sprezzature-figures need besides pip?
sprezzature-figures needs nothing more to render and check figures: the rasteriser and the fonts come with the package. redraw, which rebuilds a chart from a screenshot without inventing its numbers, and the Studio chat need a model served by Ollama. The Ralph Eyeball Loop also uses system renderers (Chrome for HTML, tectonic for TikZ, rsvg-convert), and --check-tools lists which ones you have.
Can I use sprezzature-figures without Claude Code, for example in CI?
Yes: sprezzature-figures is also a Python library (make_figure), a command line, an HTTP API with a Docker image, and the MCP server sprezzature-figures-mcp for any MCP client; the Claude Code skill is one of five ways in. In CI, sprezzature-figures check figure.svg exits 1 on any finding (labels printed over each other, text off the canvas, a dropped title), and --format json prints them for a program.
How is sprezzature-figures different from matplotlib, Plotly or Vega-Lite?
matplotlib, Plotly and Vega-Lite give you an API or a grammar to compose a chart; sprezzature-figures gives you +150 finished chart kinds by name, each writing its SVG directly with no charting library underneath, and a checker that reads the result. For a live dashboard, a very large table or matplotlib's twenty years of answered questions, those tools remain the better choice, as LANDSCAPE.md in the repository says.