ai-agent

Diagrams

:art: Diagram as Code for prototyping cloud system architectures
42,520 stars2,734 forksPythonUpdated 8/16/2026100% free · open source
What it does

Creates professional cloud‑architecture diagrams by writing Python code instead of dragging shapes.

When to use it
  • You need to version‑control architecture diagrams alongside your codebase.
  • You want to quickly prototype or iterate on AWS/GCP/Azure designs without a GUI.
  • You need reproducible diagrams for docs, presentations, or CI pipelines.
Ready-to-paste prompt
python - <<'PY'
from diagrams import Diagram
from diagrams.aws.compute import ECS, ECR
from diagrams.aws.network import ALB
from diagrams.aws.database import RDS

with Diagram("Microservice Architecture", show=False, direction="LR"):
    lb = ALB("frontend")
    svc = ECS("service")
    db = RDS("db")
    lb >> svc >> db
PY
Heads up: The library only renders after Graphviz is installed and available on your PATH; missing Graphviz will cause a `FileNotFoundError` at runtime.
Saves to your device
Use with Claude
New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install
Claude Code
mkdir -p ~/.claude/skills/diagrams && curl -fsSL https://workflowstacks.com/api/skills/diagrams/claude-skill -o ~/.claude/skills/diagrams/SKILL.md
Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)
claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How Diagrams works
Codeflow
Free to inspect

Diagrams is a medium Python project (~11k lines across 320 code files, plus 5 test files). Expect some technical setup — comfortable with a terminal, or ask a developer. Last commit this month, MIT license, has a test suite.

Size
Medium codebase
~11k lines · 320 code files · ~2 h to skim
Setup
Some technical setup
Comfortable with a terminal? 20–40 min. Otherwise ask a dev.
Runs on
Python
No API keys detected
Python 62%TypeScript 27%CSS 7%JavaScript 2%HTML 1%
Where to start reading
  1. 1
    README.md
    Start here — what it does and how to install it
  2. 2
    diagrams/cli.py
    Where the program starts running
  3. 3
    pyproject.toml
    Dependencies and the commands it exposes
  4. 4
    diagrams/__init__.py
    Inside diagrams/ — the main logic begins here
What's in each folder
diagrams/Core code — the actual logic257 files
playground/Examples you can copy62 files
docs/Documentation26 files
templates/Templates3 files
website/Project website2586 files
resources/Folder2535 files
scripts/Helper scripts3 files
docker/Deployment / infrastructure1 files
READMEHas testsDocumentedCI checksMIT licenseUpdated this month
Quick Actions
Details
Creator
mingrammer
Language
Python
Category
ai-agent
Published
2/2/2020

Are you the creator of this tool? Claim your listing → and earn 85% of every sale.