# patrickchugh/terravision

Terravision creates Professional Cloud Architecture Diagrams from your Terraform code automatically. Supports AWS, Google and Azure.

Repository: https://github.com/patrickchugh/terravision
Canonical: https://ross.abutalabs.com/products/terravision
Language: Python
License: AGPL-3.0
License Family: copyleft
Last push: 2026-08-10T17:52:31+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 87, longevity 100
- inputs: {"age_days": 1634, "days_push": 23, "days_rel": 88, "gap_med": 10.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1615, forks 173 (observed 2026-08-28T04:05:11.448200+00:00)

## What it is
TerraVision is a Python CLI tool that automatically generates professional cloud architecture diagrams from Terraform code using official AWS, GCP, and Azure icon sets. It outputs interactive HTML and editable draw.io files, runs fully client-side, and includes an optional MCP server for AI agent integration.

## Use cases
- generate architecture diagrams from terraform code
- keep cloud diagrams in sync with infrastructure
- export terraform infrastructure to draw.io
- visualize AWS resources in my terraform project
- auto-update architecture diagrams in CI on every merge
- diagram terragrunt multi-module projects
- let an AI agent generate cloud diagrams via MCP

## When to choose
- you maintain Terraform/Terragrunt infrastructure and need living architecture documentation
- you want diagrams generated locally without sending code to the cloud
- you need editable draw.io output or interactive HTML diagrams
- you want to automate diagram updates in CI/CD pipelines

## When to avoid
- your infrastructure is not defined in Terraform or Terragrunt
- you need full support for GCP or Azure beyond core services
- you need a general-purpose diagramming tool not tied to IaC code

## Facets
- artifact type: cli-tool
- maturity: active
- function: developer-tools, documentation, data-visualization, infrastructure-as-code
- domain: infrastructure-as-code, cloud-computing, documentation, developer-tools
- platform: cli, python, cross-platform
- tags: terraform, cloud-architecture-diagrams, aws, azure, google-cloud, drawio, diagram-generation, terragrunt, mcp-server, devops

## Member repositories
- patrickchugh/terravision (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:11.448200+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-30T03:50:17.641530+00:00, confidence not recorded.
  - readme: https://github.com/patrickchugh/terravision (fetched 2026-08-28T04:05:11.448200+00:00, sha 3d56b60cb2a4)
- Data as of 2026-08-30T08:39:29.467469+00:00.