terraformgraph 1.0.3

Generate interactive architecture diagrams from Terraform configurations

terraformgraph

Generate interactive architecture diagrams from your Terraform configurations. Supports AWS resources with automatic service grouping, relationship detection, and beautiful SVG/HTML output.

Features

• Automatic parsing of Terraform HCL files
• Smart resource grouping into logical services (ECS, RDS, S3, etc.)
• Relationship detection based on resource references
• Interactive HTML output with drag-and-drop positioning
• PNG/JPG export directly from the browser
• Customizable via YAML configuration files
• No cloud credentials required - works entirely offline

Installation

From PyPI

pip install terraformgraph

From Source

git clone https://github.com/ferdinandobons/terraformgraph.git
cd terraformgraph
pip install -e .

Quick Start

Basic Usage

Generate a diagram from a Terraform directory:

terraformgraph -t ./infrastructure

This creates diagram.html in the current directory.

With Environment Subdirectories

If your Terraform is organized by environment:

terraformgraph -t ./infrastructure -e prod -o prod-diagram.html

With AWS Icons

For beautiful AWS service icons, download the AWS Architecture Icons and extract them:

terraformgraph -t ./infrastructure -i ./AWS_Icons

Command Line Options

Option	Required	Description
-t, --terraform	Yes	Path to Terraform directory
-e, --environment	No	Environment subdirectory (dev, staging, prod)
-i, --icons	No	Path to AWS icons directory
-o, --output	No	Output HTML file path (default: diagram.html)
-v, --verbose	No	Enable debug output

Configuration

Custom Aggregation Rules

Create ~/.terraformgraph/aggregation_rules.yaml to customize how resources are grouped:

compute:
  my_custom_service:
    primary: ["aws_my_resource"]
    secondary: ["aws_my_helper"]
    in_vpc: true

Custom Connections

Create ~/.terraformgraph/logical_connections.yaml to define service relationships:

connections:
  - source: my_service
    target: another_service
    label: "Custom Connection"
    type: data_flow

Supported Resources

The tool supports 100+ AWS resource types including:

• Compute: ECS, EC2, Lambda, Auto Scaling
• Networking: VPC, ALB/NLB, Route53, CloudFront
• Storage: S3, EBS, EFS
• Database: RDS, DynamoDB, ElastiCache
• Messaging: SQS, SNS, EventBridge
• Security: IAM, KMS, Secrets Manager, WAF
• And many more...

Output

The generated HTML file includes:

• Interactive diagram with pan and zoom
• Drag-and-drop to reposition services
• Click connections to highlight data flows
• Export buttons for PNG and JPG
• Save/Load layout using browser storage

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.