Repolode
Submit
patrickchugh

patrickchugh/terravision

Generates cloud architecture diagrams for AWS, Azure and GCP from AI prompts, JSON graphs or Terraform code, with official cloud icons.

Open-source alternative to:LucidchartEraser

View on GitHubWebsite
Stars
1,660
Forks
178
Open issues
17
Last commit
4 hours ago

What is it?

TerraVision is a cloud architecture diagram generator that works in both directions. You can describe an architecture to an AI assistant such as Claude or ChatGPT and get a diagram, or draw a diagram from existing Terraform code. The diagram is derived from terraform plan, so it reflects what the code deploys, with conditionals, count, for_each and modules resolved. It also works from a simple JSON graph format without any Terraform.

Resources are placed inside their VPC, subnet, zone or resource group using official AWS, Azure and GCP icons. Output includes PNG, SVG and editable draw.io files, and an interactive HTML view that lets you click resources to inspect settings. Terraform can also be generated from a diagram. Drawing a Terraform environment needs only the code and a variables file, so prod can be drawn without access to the cloud account.

TerraVision runs locally as a CLI, an MCP server, or a GitHub Action for keeping diagrams current in CI/CD. It is licensed under AGPL-3.0.

Key features

  • 01Draws AWS, Azure and GCP architectures with official cloud icons and grouping by VPC, subnet, zone or resource group.
  • 02Builds diagrams from terraform plan, resolving conditionals, count, for_each and modules.
  • 03Accepts plain-English descriptions through AI assistants and a simple JSON graph format.
  • 04Exports PNG, SVG, editable draw.io files and an interactive HTML view.
  • 05Runs as a CLI, an MCP server or a GitHub Action for CI/CD.

Use cases

  • Documenting an existing Terraform codebase with an up-to-date architecture diagram.
  • Drawing a production or staging environment without access to its cloud account.
  • Sketching a new cloud design in an AI assistant and generating the initial Terraform from it.
  • Keeping architecture diagrams in a repository refreshed automatically on each Terraform change.

In collections

MCP serversAI agent skill libraries

Topics

#cloud-architecture#terraform#infrastructure-as-code#aws#azure#gcp#diagrams-as-code#mcp#agent-skill#architecture-diagram

FAQ

What is terravision?
Generates cloud architecture diagrams for AWS, Azure and GCP from AI prompts, JSON graphs or Terraform code, with official cloud icons. TerraVision is a cloud architecture diagram generator that works in both directions. You can describe an architecture to an AI assistant such as Claude or ChatGPT and get a diagram, or draw a diagram from existing Terraform code. The diagram is derived from terraform plan, so it reflects what the code deploys, with conditionals, count, for_each and modules resolved. It also works from a simple JSON graph format without any Terraform.
Is terravision free to use? What license does it have?
terravision is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is terravision still maintained?
Actively maintained. The last commit to terravision was on Oct 23, 2026.
What can I use terravision for?
Documenting an existing Terraform codebase with an up-to-date architecture diagram. Drawing a production or staging environment without access to its cloud account. Sketching a new cloud design in an AI assistant and generating the initial Terraform from it. Keeping architecture diagrams in a repository refreshed automatically on each Terraform change.
Where can I get terravision?
The source code and installation instructions are on GitHub: https://github.com/patrickchugh/terravision

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects