figio

Declarative build orchestrator for reproducible scientific figures.

Distribution name: figio Import package: figio CLI: figio

figio coordinates existing plotting libraries (Matplotlib, Vega-Lite, etc.) through a YAML manifest (FigureSpec) that describes panels, layout, annotations, and style tokens — then assembles them into a single, validated SVG suitable for journal submission.

figio is an orchestration system, not a rendering engine. Panels are opaque — figio doesn't reach inside them. It coordinates their output into a composed figure with validated positioning, annotations, and journal compliance checks.

Install

pip install figio                # core orchestrator
pip install "figio[mpl]"         # + Matplotlib adapter
pip install "figio[export]"      # + PDF/PNG export via CairoSVG
pip install "figio[all]"         # everything

Quick start

# Scaffold a figure spec
figio init

# Build a figure from spec
figio build figures/fig1.yaml

# Validate against journal target
figio validate figures/fig1.yaml --target nature

# Inspect spec metadata
figio inspect figures/fig1.yaml

Architecture

FigureSpec (YAML) → Adapters → Panel SVGs → Composer → Composed SVG → Export (PDF/PNG)

Part of the projio ecosystem

figio integrates with projio as the figure orchestration layer. When used through projio's MCP server, it exposes tools for AI-assisted figure authoring: figio_build, figio_inspect, figio_validate, figio_edit_spec, figio_query_output.

License

MIT