kymostudio 0.1.1

Diagram-as-code DSL — declarative architecture diagrams to animated SVG/WebP

kymo

Diagram-as-code DSL — declarative architecture diagrams to animated SVG / WebP.

Install

pip install kymostudio
# or
uv tool install kymostudio

Usage

kymo path/to/diagram.diagram             # → path/to/diagram.svg
kymo path/to/diagram.diagram --animate   # → path/to/diagram-animated.svg
kymo path/to/diagram.diagram --figma     # → path/to/diagram.figma.js
kymo path/to/diagram.diagram --excalidraw # → path/to/diagram.excalidraw

See samples/ for complete example .diagram files.

Python API

from kymo import parse, layout, resolve_alignments, render

diagram, layout_spec, external = parse(open("diagram.diagram").read())
if layout_spec:
    layout(diagram, layout_spec, external)
resolve_alignments(diagram)
svg = render(diagram, animate=True)

JavaScript / npm

A browser/Node port of the shared data model + icon library (the DSL parser, layout engine and SVG renderer remain Python-only):

npm install kymostudio

import { makeComponent, makeEdge, anchor, ICONS, getIcon } from "kymostudio";

License

Apache License 2.0 — see LICENSE.