TerraGuard is a next-generation DevOps platform that brings AI-assisted reasoning, Structured parsing and normalization of IaC, cost intelligence and Graph-based dependency into the Terraform workflow — enabling engineers to understand, visualize, and evaluate infrastructure before it is deployed.
As Infrastructure-as-Code scales, Terraform configurations become increasingly complex, abstract, and difficult to interpret. While existing tools focus on execution and state changes, they lack the ability to explain infrastructure as a system — how components interact, what they represent, and what they are ultimately built for.
👉 Built for terminal-first DevOps workflows, TerraGuard delivers fast, in-context analysis through a powerful TUI — eliminating the need for external dashboards and keeping engineers fully in the CLI.
TerraGuard introduces an intelligent analysis layer on top of Terraform by combining:
- 🧠 AI-powered infrastructure interpretation
- 🧩 Structured parsing and normalization of IaC
- 🌳 Graph-based dependency modeling
- 💰 Cloud pricing intelligence via AWS APIs
👉 transforming raw Terraform into clear, explainable, and actionable infrastructure insights
👉 Even without AI, TerraGuard provides structured analysis, dependency visualization, and cost evaluation, ensuring meaningful insights are always available.
- 🧩 Parse Terraform into structured resource models
- 🌳 Build dependency graphs to represent relationships
- 💰 Evaluate cost using AWS Pricing APIs
- 🧠 Integrate AI to explain infrastructure clearly
- 🖥️ Provide an interactive TUI for exploration
👉 Bridges the gap between writing infrastructure and understanding it
TerraGuard integrates an AI reasoning layer that interprets infrastructure and converts it into clear, concise, and meaningful explanations.
- Translates complex Terraform into human-understandable insights
- Explains both structure and real-world purpose
- Enhances collaboration between developers, DevOps, and teams
👉 AI acts as an interpretation layer over structured infrastructure data, not a replacement for it
TerraGuard transforms Terraform into a structured infrastructure model:
- Extracts resources from
.tfconfigurations - Resolves variables and interpolations
- Interprets dynamic constructs (
count,for_each) - Normalizes infrastructure into a graph-ready representation
👉 Enables deeper analysis beyond raw IaC
Models infrastructure as a directed dependency graph:
- Captures relationships between resources
- Represents connectivity and execution flow
- Enables architectural reasoning before deployment
👉 Allows you to visualize infrastructure before it exists
TerraGuard integrates with the AWS Pricing API (boto3) to perform dynamic cost evaluation:
EC2 → $0.0104/hr
S3 → $0.0023/hr
RDS → Based on instance configuration
- Maps Terraform resources to pricing dimensions
- Resolves region-aware pricing dynamically
- Produces resource-level cost breakdowns
👉 Enables cost-aware infrastructure planning
Terraform focuses on execution. TerraGuard focuses on understanding.
| Feature | Terraform Plan | TerraGuard |
|---|---|---|
| Shows resource changes | ✅ | ✅ |
| Explains architecture | ❌ | ✅ |
| Human-readable understanding | ❌ | ✅ |
| Cost estimation | ❌ | ✅ |
| Dependency visualization | ❌ | ✅ |
| Pre-deployment insight | ✅ Strong |
👉 Terraform answers “what will happen” 👉 TerraGuard explains “what this infrastructure actually is and why it exists”
terraguard init| Key | Action |
|---|---|
| q | Quit |
| c | Copy selected resource |
| C | Copy all resources + cost |
| / | Search |
| e | Explain selected resource |
| E | Explain full infrastructure |
- Unified view of structure, cost, and AI insights
- Designed for efficient DevOps workflows
terraguard/
│
├── cli.py
├── parser.py
├── variable_resolver.py
├── cost_engine.py
├── pricing_engine.py
├── diagram.py
├── formatter.py
├── tui/
├── ai_explainer.py
└── optimizer/
git clone https://github.com/Anantch2005/terraguard-ai.git
cd terraguard-aipython3 -m venv venv
source venv/bin/activate # Linux / Mac
# venv\Scripts\activate # Windowspip install -r requirements.txtpip install .👉 This installs the terraguard command globally in your environment
Create a .env file in the root directory:
GROQ_API_KEY=your_api_key_hereaws configureexport AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_DEFAULT_REGION=us-east-1👉 Without AWS credentials, cost estimation features will be limited
terraguard initcd terraform_examples/basic
terraguard initFor the best visual experience, use a Nerd Font in your terminal to properly render icons in the TUI.
- Python
- Typer
- Rich
- Textual
- python-hcl2
- AWS Pricing API (boto3)
- Groq API
- ☁️ Multi-cloud support (AWS, Azure, GCP) for unified infrastructure analysis
- 🔁 CI/CD integration for automated pre-deployment validation
- 📊 Terraform plan analysis for deeper change visibility
- 🚨 Security & policy validation to detect misconfigurations early
- 💰 Budget enforcement with intelligent cost thresholds
- 🤖 Autonomous infrastructure optimization using AI-driven recommendations
👉 Vision: Evolve TerraGuard into a fully autonomous DevOps AI agent capable of analyzing, securing, and optimizing infrastructure before deployment.
- Understand infrastructure before deployment
- Simplify complex Terraform configurations
- Validate architecture design
- Perform cost-aware planning
- Learn and visualize cloud systems
Built by Anant Chaudhary
DevOps Engineer (aspiring) | Building intelligent cloud systems 🚀
👉 From writing infrastructure → to understanding infrastructure before it exists
TerraGuard represents the future of DevOps where infrastructure is interpreted, visualized, and intelligently analyzed before deployment.