kymostudio

Prompt it. See it appear. Watch it animate.

Live Editor · Website · Documentation

Kymostudio turns diagram-as-code source — or prompts from coding agents over MCP — into self-contained, animated SVG, with PNG, WebP, Figma and Excalidraw export.

✨ Features

• Built for coding agents
  A hosted MCP server (mcp.kymo.studio) lets Claude Code, Cursor or Copilot create and edit diagrams that render live in the editor.
• Draws what you actually need
  Software architecture, process flows and standard BPMN, all rendered faithfully.
• Starts from any source
  Author in the .kymo DSL, or feed it BPMN, JSON or Python.
• Write once, export anywhere
  One source compiles to SVG, PNG, WebP, Figma and Excalidraw.
• Diagrams as code
  Describe your diagram in a clean, line-oriented .kymo syntax — no dragging boxes around.
• Animated by default
  Edges come alive with built-in flowing animation, straight to a self-contained SVG.
• Smart auto-layout
  Frames, anchoring, edge routing and canvas sizing are figured out for you.
• A rich icon library
  2,460 icons spanning AWS, Azure, GCP, Kubernetes, on-prem and more.

Install

pip install kymostudio        # Python
npm install kymostudio        # JavaScript
cargo install kymostudio      # Rust

Or grab a prebuilt kymo binary with Homebrew (macOS/Linux):

brew tap kymostudio/brew https://github.com/kymostudio/kymostudio
brew trust kymostudio/brew     # Homebrew 6.0+ only: trust the third-party tap
brew install kymostudio        # the command is `kymo`

Usage

1. Render a diagram

kymo sample.kymo              # → sample.svg
kymo sample.kymo --animate    # → sample-animated.svg
kymo sample.kymo --figma      # → sample.figma.js
kymo sample.kymo --excalidraw # → sample.excalidraw

2. Import BPMN

kymo process.bpmn             # → process.svg
kymo lint process.bpmn        # check for issues

3. Convert SVG to PNG or PDF

Turn any .svg into a PNG image or a vector PDF — no headless browser required.
The output format follows the output file's extension.

kymo diagram.svg out.png      # to PNG
kymo diagram.svg out.pdf      # to PDF

4. Browse the icon catalogue

Explore the bundled icons right from the CLI.

kymo icons list                         # list every icon set
kymo icons list aws                     # list icons in one provider
kymo icons search database              # find icons by keyword
kymo icons describe aws:compute-ec2     # show details for one icon
kymo icons download aws:compute-ec2     # save the icon to a file