v0.1.0 — first PyPI release

First public release of diagrammer — a tiny tool that turns a JSON spec into a clean blueprint-style SVG diagram. Built for technical writers who want 3Blue1Brown-meets-Excalidraw output without opening a design tool.

pipx install diagrammer
echo '{"nodes":[{"id":"a","type":"box","label":"client"},{"id":"b","type":"box","label":"api"}],"edges":[{"from":"a","to":"b"}]}' | diagrammer - > flow.svg

Or use it from Claude Code as a skill:

/plugin marketplace add Anish-Reddy-K/text-to-diagram
/plugin install diagrammer@diagrammer-tools

Then ask Claude: "draw an SVG diagram of a request flow: client → api → db".

What's in 0.1.0

• render(spec) -> svg_string — pure stdlib, no rendering deps
• Built-in node types: box, circle, text, database, stack, group, note, custom
• Edge labels, dashed/solid styles, thin/thick weights, self-loops, orthogonal routing
• Auto-layout with direction (LR/TB), per-spec col_gap / row_gap / margin
• Top-level defs block for shared SVG defs (gradients, custom markers, filters)
• LLM-first JSON spec — minimal nodes + edges produces a usable diagram
• CLI (diagrammer spec.json or stdin via -), MCP server, and Claude Code plugin
• Snapshot tests for every built-in component

Sample output

The two SVGs attached to this release (mlp.svg, transformer.svg) were rendered by the tool itself from the specs in examples/.

Links

• PyPI: https://pypi.org/project/diagrammer/0.1.0/
• Spec docs: run diagrammer prompt or see src/diagrammer/prompt.md
• Examples: examples/