Skip to content

TerraVision

Turn Terraform code into professional cloud architecture diagrams that stay in sync with your infrastructure — automatic, secure, living documents

PyPI version PyPI downloads Python version License Code style: black

Watch a 4-Minute Intro

From Terraform Code → Architecture Diagram

Terraform Code

AWS architecture diagram

Azure architecture diagram

GCP architecture diagram

Why TerraVision?

  • Always up-to-date

    Diagrams generated directly from your Terraform code — no more drift between docs and reality.

  • 100% client-side

    No cloud access required. Runs locally. Your .tf code never leaves your machine.

  • CI/CD ready

    Automate diagram updates on every PR merge. Works with GitHub Actions, GitLab, Jenkins, Azure DevOps.

  • Multi-cloud

    AWS (full), GCP, and Azure (core services) — including multi-cloud architectures on a single diagram.

  • Interactive HTML

    terravision visualise produces a self-contained HTML with clickable nodes, search, and animated data flow.

  • Editable draw.io

    Export to .drawio and open in draw.io, Lucidchart, or any mxGraph editor.

  • Optional AI annotations

    Auto-generate labels, titles, and flow sequences from Ollama (local) or AWS Bedrock.

  • Terragrunt compatible

    Auto-detects single- and multi-module Terragrunt projects. No extra flags needed.

Quick Start

Install with pip:

pip install terravision   # or: pipx install terravision

Generate your first diagram:

terravision draw --source ./path-to-your-terraform --show

Or try the interactive HTML output:

terravision visualise --source ./path-to-your-terraform--show

See the Installation Guide for Docker, Nix, and platform-specific instructions, or jump straight into the Usage Guide.

Try the Interactive Demos

These are real outputs of terravision visualise — click any node to see its metadata, use the search box, and pan/zoom around.

  • 🟧 AWS demo

    Wordpress on ECS Fargate with CloudFront, RDS, and EFS.

  • 🟦 Azure demo

    VM scale set with load balancer and VNet topology.

  • 🟩 GCP demo

    Core GCP networking and compute.

Documentation

  • Installation

    Install via pip, Docker, or Nix. Platform-specific instructions for all dependencies.

  • Usage Guide

    All commands, options, output formats, and advanced usage patterns.

  • Annotations

    Customise your diagrams with YAML annotations, flows, and AI suggestions.

  • CI/CD Integration

    Automate diagrams in GitHub Actions, GitLab, Jenkins, Azure DevOps.

  • FAQ

    Cloud credentials, LLM data, offline use, Terragrunt — the most common questions.

  • Troubleshooting

    Common errors and how to fix them.

Support