# mingrammer/diagrams

:art: Diagram as Code for prototyping cloud system architectures

Repository: https://github.com/mingrammer/diagrams
Canonical: https://ross.abutalabs.com/products/diagrams
Homepage: https://diagrams.mingrammer.com
Language: Python
License: MIT
License Family: permissive
Topics: diagram, diagram-as-code, architecture, graphviz
Last push: 2026-08-16T12:09:29+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 98, release rhythm 57, longevity 100
- inputs: {"age_days": 2404, "days_push": 17, "days_rel": 285, "gap_med": 20, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 42554, forks 2733 (observed 2026-08-28T04:12:08.825915+00:00)

## What it is
Diagrams is a Python library for drawing cloud system architecture diagrams as code, rendering them via Graphviz. It provides node icons for major providers like AWS, Azure, GCP, and Kubernetes, and lets you track diagram changes in version control.

## Use cases
- draw cloud architecture diagrams in python code
- prototype a new system architecture without design tools
- version control architecture diagrams alongside code
- generate AWS, Azure, GCP, or Kubernetes architecture diagrams
- document existing system architecture as an image
- render architecture diagrams in Jupyter notebooks

## When to choose
- you want architecture diagrams defined in code and reviewable in git
- you need icons for major cloud providers and on-premises components
- you prefer prototyping architecture over drag-and-drop diagram tools

## When to avoid
- you need to provision actual cloud resources or generate Terraform/CloudFormation code
- you need highly custom, free-form diagram layouts beyond Graphviz capabilities
- you want a GUI-based diagramming experience

## Facets
- artifact type: library
- maturity: stable
- function: developer-tools, documentation, data-visualization
- domain: developer-tools, cloud-computing, infrastructure-as-code, documentation
- platform: python, cli, cross-platform
- tags: diagram-as-code, graphviz, architecture-diagrams, cloud-architecture, aws, azure, gcp, kubernetes

## Member repositories
- mingrammer/diagrams (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:08.825915+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:22:38.244216+00:00, confidence not recorded.
  - readme: https://github.com/mingrammer/diagrams (fetched 2026-08-28T04:12:08.825915+00:00, sha 2bf7eabc54c9)
  - homepage: https://diagrams.mingrammer.com (fetched 2026-08-29T07:46:11.458189+00:00, sha 9d5bc7738588)
  - site_page: https://diagrams.mingrammer.com/docs/getting-started/installation (fetched 2026-08-29T07:46:11.467548+00:00, sha 38c4737a4e2b)
  - site_page: https://diagrams.mingrammer.com/docs/guides/diagram (fetched 2026-08-29T07:46:11.469965+00:00, sha c73cad1203fc)
  - site_page: https://diagrams.mingrammer.com/docs/nodes/aws (fetched 2026-08-29T07:46:11.472066+00:00, sha 083d9aa2c7c1)
  - site_page: https://diagrams.mingrammer.com/docs/getting-started/examples (fetched 2026-08-29T07:46:11.475688+00:00, sha a6fc8bbf3293)
  - registry_pypi: https://pypi.org/pypi/diagrams/json (fetched 2026-08-29T07:46:11.478606+00:00, sha cf2bd6fc3250)
- Data as of 2026-08-30T08:39:29.467469+00:00.