Terravision is an AI-powered CLI tool that automatically generates professional cloud architecture diagrams from Terraform code, addressing the challenge of maintaining accurate documentation in dynamic cloud environments. It offers a "Docs as Code" solution, benefiting architects and engineers by automating diagram creation, ensuring consistency, and integrating into CI/CD pipelines, all while operating securely client-side.

How It Works

Terravision securely parses Terraform code locally, without cloud access, to dynamically generate visual architecture diagrams. It processes resources, variables, and conditional logic. An optional AI backend (AWS Bedrock or local Ollama) refines diagrams by improving resource grouping, connections, and adherence to best practices, offering a significant advantage over manual methods.

Quick Start & Requirements

• Installation: Clone the repo, install Python dependencies (pip install -r requirements.txt) or use Poetry (poetry install).
• Prerequisites: Python 3.10+, Terraform 1.x, Git, Graphviz. Ollama is optional for local AI.
• Links: Graphviz (https://graphviz.org/download/), Git (https://git-scm.com/downloads), Terraform (https://developer.hashicorp.com/terraform/downloads), Ollama (https://ollama.ai/download/).

Highlighted Details

• AI-powered diagram refinement (AWS Bedrock, Ollama).
• "Docs as Code" integration into CI/CD pipelines.
• 100% client-side execution, no cloud credentials needed.
• Supports custom annotations via YAML files.
• Analyzes local directories, Git repos, or pre-generated JSON.
• Outputs diagrams in PNG, SVG, PDF, BMP formats.

Maintenance & Community

Maintained by patrickchugh. No specific community channels or contributor details are provided in the README.

Licensing & Compatibility

Described as "free and open source" but carries an "Alpha Software Notice" stating it's provided "AS IS, WITHOUT WARRANTIES." Specific license details are absent, requiring clarification for commercial use. AWS support is full; GCP/Azure support is pending.

Limitations & Caveats

The software is in alpha, provided "AS IS" with no warranties, and should be used at the user's risk. Google Cloud Platform and Microsoft Azure support are "Coming soon," limiting immediate multi-cloud utility. AI backend configuration requires additional setup.