Terravision

Turn Terraform or JSON files into professional cloud architecture diagrams with the official AWS, Azure and GCP icons

📖 Full documentation site →

Watch a 4-Minute Intro

What is TerraVision?

TerraVision automatically converts your Terraform code, or a plain JSON graph of Terraform resource names, into professional-grade cloud architecture diagrams using the official AWS, GCP, and Azure icon sets. Your diagrams stay in sync with your infrastructure — no more outdated Visio, draw.io or Lucidchart files.

Most diagram tools that AI assistants reach for (Mermaid, PlantUML, hand-drawn SVG) produce boxes and arrows. TerraVision produces the diagram a cloud architect would draw: real provider icons, VPCs and subnets nested correctly, resource groups, regions and zones. It runs entirely on your machine, needs no cloud credentials, and outputs PNG, SVG, PDF or an editable draw.io file.

Why TerraVision?

• ✅ JSON graph input — describe an architecture in a few lines of JSON and render it, resources match Terraform names so no need to learn a custom DSL (Graph Format)
• ✅ Always up-to-date — diagrams generated directly from your Terraform code
• ✅ 100% client-side — no cloud access required, runs locally, your code never leaves your machine
• ✅ CI/CD ready — automate diagram updates on every PR merge
• ✅ Free & open source — no expensive diagramming tool licenses
• ✅ Multi-cloud — AWS (full), GCP, and Azure (core services)
• ✅ Interactive HTML output — clickable nodes, pan/zoom, search, animated data flow
• ✅ Editable draw.io export — open in draw.io, Lucidchart, or any mxGraph editor
• ✅ Optional AI annotations — labels, titles, and flow sequences from Ollama (local) or AWS Bedrock
• ✅ Terragrunt compatible — auto-detects single- and multi-module Terragrunt projects
• ✅ MCP server and agent skill — let AI agents generate diagrams from a JSON graph or your Terraform, see the guide

Supported Cloud Providers

Full list: Node types.

Quick Start

Install

pipx install terravision   # or: uv tool install terravision
                           # or: pip install terravision in a virtual env