# vaibhavburad15/infra-genie architecture

> Architecture diagram of the GitHub repository vaibhavburad15/infra-genie, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaibhavburad15/infra-genie
- Repository: https://github.com/vaibhavburad15/infra-genie

## Overview

InfraGenie is an AI infrastructure-analysis and deployment platform. Users upload a project or provide a repository, receive static and multi-agent analysis plus generated infrastructure artifacts, review and approve a deployment, then monitor it and use AI assistance. The graph preserves the documented artifact, security, cost, and observability capabilities. Backend task and route relationships are supported by the excerpts and SOURCE INDEX; several UI and feature modules were not sampled, so their internal wiring is not inferred.

Main entry points: [`frontend/src/App.tsx`](https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/App.tsx) (Application shell), [`backend/main.py`](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/main.py) (FastAPI service), [`backend/tasks.py`](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/tasks.py) (Analysis and deploy tasks), [`frontend/src/api.ts`](https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Product interface"]
  node_app["Application shell<br/>[App.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_project_ui["Project workspace<br/>[ProjectsPage.tsx]"]
  node_review_ui["Deployment review"]
  node_cloud_ui["Cloud accounts"]
  node_feature_ui["Feature dashboards"]
  node_assistant_ui["AI assistant<br/>[AIAssistant.tsx]"]
end

subgraph group_api["API and persistence"]
  node_api["FastAPI service<br/>[main.py]"]
  node_models[("Domain models<br/>[models.py]")]
  node_agent_routes["Agent registry API<br/>[agent_routes.py]"]
  node_cloud_routes["Cloud account API<br/>[cloud_routes.py]"]
  node_discovery_routes["Discovery API"]
end

subgraph group_analysis["Analysis and generation"]
  node_task_worker["Background worker<br/>[worker.py]"]
  node_tasks["Analysis and deploy tasks<br/>[tasks.py]"]
  node_static_analysis["Static analysis<br/>[static_analysis.py]"]
  node_agents["Specialist agents<br/>[agents.py]"]
  node_planner["Deployment planner"]
  node_llm["LLM client<br/>[llm.py]"]
end

subgraph group_cloud["Cloud and deployment"]
  node_cloud_service["AWS connection service<br/>[aws_connection.py]"]
  node_discovery["AWS discovery<br/>[aws_discovery.py]"]
  node_aws{{"Customer AWS account"}}
end

node_user(("User"))
node_llm_service{{"OpenAI-compatible LLM"}}

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_project_ui
node_app -->|"routes to"| node_review_ui
node_app -->|"routes to"| node_cloud_ui
node_app -->|"routes to"| node_feature_ui
node_app -->|"renders"| node_assistant_ui
node_project_ui -.->|"uses API"| node_api_client
node_review_ui -.->|"uses API"| node_api_client
node_cloud_ui -.->|"uses API"| node_api_client
node_api_client -.->|"calls"| node_api
node_api -->|"persists"| node_models
node_api -->|"queues analysis"| node_tasks
node_api -->|"registers routes"| node_agent_routes
node_api -->|"registers routes"| node_cloud_routes
node_api -->|"registers routes"| node_discovery_routes
node_agent_routes -->|"reads configuration"| node_models
node_cloud_routes -->|"verifies accounts"| node_cloud_service
node_discovery_routes -->|"runs scans"| node_discovery
node_discovery -->|"uses credentials"| node_cloud_service
node_cloud_service -->|"assumes role"| node_aws
node_task_worker -->|"executes"| node_tasks
node_tasks -->|"analyzes source"| node_static_analysis
node_tasks -->|"runs pipeline"| node_agents
node_tasks -->|"plans deployment"| node_planner
node_agents -->|"requests completions"| node_llm
node_llm -->|"sends prompts"| node_llm_service
node_planner -->|"uses AWS connection"| node_cloud_service
node_user -->|"connects account"| node_cloud_ui
node_user -->|"submits project"| node_project_ui
node_tasks -->|"stores results"| node_models
node_planner -.->|"provisions infrastructure"| node_aws
node_feature_ui -.->|"requests insights"| node_api_client

click node_app "https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/api.ts"
click node_project_ui "https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/pages/ProjectsPage.tsx"
click node_review_ui "https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/pages/DeploymentReviewPage.tsx"
click node_cloud_ui "https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/pages/CloudAccountsPage.tsx"
click node_feature_ui "https://github.com/vaibhavburad15/infra-genie/tree/main/frontend/src/pages"
click node_assistant_ui "https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/components/AIAssistant.tsx"
click node_api "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/main.py"
click node_models "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/models.py"
click node_agent_routes "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/agent_routes.py"
click node_cloud_routes "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/cloud_routes.py"
click node_discovery_routes "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/discovery_routes.py"
click node_task_worker "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/worker.py"
click node_tasks "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/tasks.py"
click node_static_analysis "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/static_analysis.py"
click node_agents "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/agents.py"
click node_planner "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/deployment_planner.py"
click node_llm "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/llm.py"
click node_cloud_service "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/aws_connection.py"
click node_discovery "https://github.com/vaibhavburad15/infra-genie/blob/main/backend/aws_discovery.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_api_client,node_project_ui,node_review_ui,node_cloud_ui,node_feature_ui,node_assistant_ui,node_user toneBlue
class node_api,node_models,node_agent_routes,node_cloud_routes,node_discovery_routes toneAmber
class node_task_worker,node_tasks,node_static_analysis,node_agents,node_planner,node_llm toneMint
class node_cloud_service,node_discovery,node_aws toneRose
class node_llm_service toneIndigo
```

## Components

### Product interface

- [Application shell](https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Project workspace](https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/pages/ProjectsPage.tsx): `frontend/src/pages/ProjectsPage.tsx`
- [Deployment review](https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/pages/DeploymentReviewPage.tsx): `frontend/src/pages/DeploymentReviewPage.tsx`
- [Cloud accounts](https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/pages/CloudAccountsPage.tsx): `frontend/src/pages/CloudAccountsPage.tsx`
- [Feature dashboards](https://github.com/vaibhavburad15/infra-genie/tree/main/frontend/src/pages): `frontend/src/pages`
- [AI assistant](https://github.com/vaibhavburad15/infra-genie/blob/main/frontend/src/components/AIAssistant.tsx): `frontend/src/components/AIAssistant.tsx`

### API and persistence

- [FastAPI service](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/main.py): `backend/main.py`
- [Domain models](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/models.py): `backend/models.py`
- [Agent registry API](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/agent_routes.py): `backend/agent_routes.py`
- [Cloud account API](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/cloud_routes.py): `backend/cloud_routes.py`
- [Discovery API](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/discovery_routes.py): `backend/discovery_routes.py`

### Analysis and generation

- [Background worker](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/worker.py): `backend/worker.py`
- [Analysis and deploy tasks](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/tasks.py): `backend/tasks.py`
- [Static analysis](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/static_analysis.py): `backend/static_analysis.py`
- [Specialist agents](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/agents.py): `backend/agents.py`
- [Deployment planner](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/deployment_planner.py): `backend/deployment_planner.py`
- [LLM client](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/llm.py): `backend/llm.py`

### Cloud and deployment

- [AWS connection service](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/aws_connection.py): `backend/aws_connection.py`
- [AWS discovery](https://github.com/vaibhavburad15/infra-genie/blob/main/backend/aws_discovery.py): `backend/aws_discovery.py`
- **Customer AWS account**

### Other components

- **User**
- **OpenAI-compatible LLM**

## Connections

- User → Application shell: uses
- Application shell → Project workspace: routes to (evidence: `frontend/src/App.tsx`)
- Application shell → Deployment review: routes to (evidence: `frontend/src/App.tsx`)
- Application shell → Cloud accounts: routes to (evidence: `frontend/src/App.tsx`)
- Application shell → Feature dashboards: routes to (evidence: `frontend/src/App.tsx`)
- Application shell → AI assistant: renders (evidence: `frontend/src/App.tsx`)
- Project workspace → API client: uses API
- Deployment review → API client: uses API
- Cloud accounts → API client: uses API
- API client → FastAPI service: calls
- FastAPI service → Domain models: persists (evidence: `backend/main.py`)
- FastAPI service → Analysis and deploy tasks: queues analysis (evidence: `backend/main.py`)
- FastAPI service → Agent registry API: registers routes (evidence: `backend/main.py`)
- FastAPI service → Cloud account API: registers routes (evidence: `backend/main.py`)
- FastAPI service → Discovery API: registers routes (evidence: `backend/main.py`)
- Agent registry API → Domain models: reads configuration (evidence: `backend/agent_routes.py`)
- Cloud account API → AWS connection service: verifies accounts (evidence: `backend/cloud_routes.py`)
- Discovery API → AWS discovery: runs scans (evidence: `backend/discovery_routes.py`)
- AWS discovery → AWS connection service: uses credentials (evidence: `backend/aws_discovery.py`)
- AWS connection service → Customer AWS account: assumes role
- Background worker → Analysis and deploy tasks: executes (evidence: `backend/worker.py`)
- Analysis and deploy tasks → Static analysis: analyzes source (evidence: `backend/tasks.py`)
- Analysis and deploy tasks → Specialist agents: runs pipeline (evidence: `backend/tasks.py`)
- Analysis and deploy tasks → Deployment planner: plans deployment (evidence: `backend/tasks.py`)
- Specialist agents → LLM client: requests completions (evidence: `backend/agents.py`)
- LLM client → OpenAI-compatible LLM: sends prompts (evidence: `backend/llm.py`)
- Deployment planner → AWS connection service: uses AWS connection (evidence: `backend/deployment_planner.py`)
- User → Cloud accounts: connects account
- User → Project workspace: submits project
- Analysis and deploy tasks → Domain models: stores results (evidence: `backend/tasks.py`)
- Deployment planner → Customer AWS account: provisions infrastructure
- Feature dashboards → API client: requests insights
