Diagrams as code, editable everywhere

Write a few lines of Python. Get SVG, PNG, PowerPoint with native shapes, and Figma nodes you can keep editing. spinagram does the layout.

Get started Python guide

pip install "spinagram[all]"

from spinagram import Diagramd = Diagram("Q01", "Web app on AWS", subtitle="No coordinates, laid out automatically")users = d.box("Users", icon="aws:users")with d.group("us-east-1", style="aws-region", direction="right"):    with d.group("VPC", style="aws-vpc", direction="right"):        lb = d.box("Load balancer", icon="aws:alb")        api = d.box("API", text="FastAPI on ECS", icon="terrastruct:python")        with d.group():  # no style: a light "soft" zone            db = d.box("Orders DB", text="PostgreSQL", icon="terrastruct:postgres")            cache = d.box("Cache", text="Redis", icon="terrastruct:redis")    s3 = d.box("Uploads", text="S3 bucket", icon="aws:s3")users.to(lb, "HTTPS") >> apiapi.to(db, "SQL")api >> [cache, s3]d.save("out/", formats=["svg", "png", "pptx"])

After the quickstart

What you can do next

Every picture below is rendered by spinagram from a file in examples/. Switch between scenarios, then open the Python and CSS tabs to see the code behind each one.

Five steps

From boxes to a finished slide

Start with boxes and arrows. Add icons, then groups, then numbered steps and a legend. One stylesheet at the end adds your brand. Every step is a few more lines in the same file.

a >> bwith d.group(...)step="Order is stored"d.add_legend()d.stylesheet("brand.css")See how it works →

Real CSS

One diagram, four looks

Classes name a role, never a colour. The stylesheet decides how each role looks, and the legend restyles itself. Swap one file to rebrand a whole deck. The Python stays the same.

box-shadow: 0 0 32px:root { --night: #070B16 }stroke-dasharraymarker-end: open-arrowSee how it works →

Dark canvas with neon outlines and a glowing Orders service

Dark canvases

Architecture slides that look designed

Glass cards, glowing heroes and project colours are all CSS. One shared stylesheet styles the whole Kubernetes platform: Cilium yellow, Gateway API teal, add-ons violet.

group.cluster { fill: var(--night) }group.cluster node::titlebox-shadow: 0 8px 18pxSee how it works →

Anatomy of a Kubernetes workload on a dark canvas

Typed regions

Several diagram types on one canvas

Put a flowchart, a state machine or swimlanes next to your architecture. Each region is laid out by its own engine. Ordinary arrows connect them.

d.flowchart()d.state_machine()d.activity()a.to(b, "triggers")See how it works →

Architecture, a fraud-check flowchart and the payment state machine

Behavior

Flowcharts, state machines and swimlanes

Builders that speak each diagram’s language: decisions with .yes() and .no(), transitions written the UML way, lanes with fork and join bars.

valid.yes(charge)created.on("pay", paid)act.parallel()See how it works →

Checkout flowchart with two decisions and a retry loop

Automatic layout

Clouds and networks that nest themselves

Regions, VPCs, zones, VLANs and racks are with-blocks. Plain Python loops build the repeated parts. You never write a coordinate.

for az, tier in tiers.items():direction="down"route: orthoSee how it works →

Icons

Thousands of icons, one argument

AWS, Google Cloud, Azure, Kubernetes, CNCF, AI, self-hosted, network gear and your own SVG files. Packs download on first use and then work offline.

icon="aws:rds"icon="cncf:cilium"icon="ai:claude"icon="logo.svg"See how it works →

"""Icons from a dozen packs and a local file. An icon is just `icon="pack:name"` or a path next to the spec;
packs download on first use. Find names with `spinagram icons search <word>`."""
from spinagram import Diagram

d = Diagram("I01", "One argument, thousands of icons", subtitle='icon="pack:name" or icon="file.svg"',
            layout={"engine": "flex", "direction": "down", "gap": 24})
d.stylesheet("icons.css")

GROUPS = {
    "Cloud": [("EKS", "aws:eks"), ("BigQuery", "gcp:bigquery"), ("AKS", "azure:aks"), ("Compute", "oci:vm")],
    "Cloud native": [("Pod", "k8s:pod"), ("Cilium", "cncf:cilium"), ("Argo", "cncf:argo"),
                     ("OpenTelemetry", "cncf:otel")],
    "Languages and data": [("Rust", "devicon:rust"), ("Python", "terrastruct:python"),
                           ("PostgreSQL", "devicon:postgresql"), ("Kafka", "devicon:kafka")],
    "Products and AI": [("Terraform", "logos:terraform"), ("GitHub Actions", "logos:github-actions"),
                        ("Datadog", "logos:datadog"), ("Claude", "ai:claude")],
    "Self-hosted": [("Proxmox", "selfhosted:proxmox"), ("Grafana", "selfhosted:grafana"),
                    ("Home Assistant", "selfhosted:hass"), ("OpenStack", "openstack:nova")],
    "Network and yours": [("Firewall", "network:firewall"), ("L3 switch", "network:l3-switch"),
                          ("Access point", "network:ap"), ("Your logo", "acme.svg")],
}
with d.group(id="grid", class_="bare", columns=3, gap=20, padding=0, node_size=(262, 78)):
    for name, items in GROUPS.items():
        with d.group(name, class_=name.lower().replace(" ", "-"), columns=2, gap=12, padding=14):
            for title, icon in items:
                d.box(title, text=icon, icon=icon)

Python26 linesexamples/icons/hybrid.py

Editable everywhere

PowerPoint slides with native shapes and bound connectors, Figma and FigJam nodes, SVG and PNG.

Python first

users >> lb >> api. Groups are with-blocks, lists fan out, loops build the rest.

Automatic layout

No coordinates. Boxes fit their text, groups nest, four engines to choose from.

Thousands of icons

AWS, GCP, Azure, Kubernetes, CNCF projects, product logos, languages and more: twelve packs, downloaded on first use.

Your brand

One theme directory sets colours, fonts, styles and chrome for every output.

Built for review

Overflow checks, a live preview, and numbers that carry their sources.

Find the one closest to yours

Copy an example, run spinagram serve, and edit it with a live preview.

Browse the gallery Get started