# debadrita-mukhopadhyay5/visionguardai architecture

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

- Interactive diagram: https://gitdiagram.com/debadrita-mukhopadhyay5/visionguardai
- Repository: https://github.com/debadrita-mukhopadhyay5/visionguardai

## Overview

VisionGuard AI is a Streamlit civic-safety inspection app. Its main workflow accepts one or more images, detects hazards, checks image reliability, computes a transparent risk score, and presents prioritized results; single inspections can also generate and download a report. The graph preserves the separate detection, quality, scoring, AI guidance, report formatting, and batch-prioritization stages. Edges are limited to calls visible in the sampled source or the README; external AI services are shown as optional integrations.

Main entry points: [`app.py`](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/app.py) (Streamlit App), [`detector.py`](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/detector.py) (Hazard Detection), [`genai.py`](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/genai.py) (AI Report Generation), [`config.py`](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/config.py) (Runtime Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Inspection UI"]
  node_app["Streamlit App<br/>[app.py]"]
  node_batch["Batch Prioritization<br/>[app.py]"]
end

subgraph group_analysis["Image Analysis"]
  node_detector["Hazard Detection<br/>[detector.py]"]
  node_quality["Image Reliability<br/>[quality.py]"]
  node_risk["Risk Scoring<br/>[risk_engine.py]"]
  node_config["Runtime Config<br/>[config.py]"]
end

subgraph group_guidance["Guidance &amp; Reports"]
  node_genai["AI Report Generation<br/>[genai.py]"]
  node_report["Report Formatting<br/>[report.py]"]
end

node_inspector(("Inspector"))
node_roboflow{{"Roboflow API"}}
node_anthropic{{"Anthropic API"}}

node_inspector -->|"uploads images"| node_app
node_app -->|"detects hazards"| node_detector
node_app -->|"assesses quality"| node_quality
node_app -->|"calculates risk"| node_risk
node_app -->|"requests report"| node_genai
node_app -->|"formats download"| node_report
node_app -->|"prioritizes batch"| node_batch
node_detector -->|"reads settings"| node_config
node_detector -->|"posts image"| node_roboflow
node_genai -->|"reads settings"| node_config
node_genai -->|"requests generation"| node_anthropic

click node_app "https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/app.py"
click node_detector "https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/detector.py"
click node_quality "https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/quality.py"
click node_risk "https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/risk_engine.py"
click node_config "https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/config.py"
click node_genai "https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/genai.py"
click node_report "https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/report.py"
click node_batch "https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/app.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_batch toneBlue
class node_detector,node_quality,node_risk,node_config toneAmber
class node_genai,node_report,node_roboflow,node_anthropic toneMint
class node_inspector toneIndigo
```

## Components

### Inspection UI

- [Streamlit App](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/app.py): `app.py`
- [Batch Prioritization](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/app.py): `app.py`

### Image Analysis

- [Hazard Detection](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/detector.py): `detector.py`
- [Image Reliability](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/quality.py): `quality.py`
- [Risk Scoring](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/risk_engine.py): `risk_engine.py`
- [Runtime Config](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/config.py): `config.py`

### Guidance & Reports

- [AI Report Generation](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/genai.py): `genai.py`
- [Report Formatting](https://github.com/debadrita-mukhopadhyay5/visionguardai/blob/main/report.py): `report.py`

### Other components

- **Inspector**
- **Roboflow API**
- **Anthropic API**

## Connections

- Inspector → Streamlit App: uploads images (evidence: `app.py`)
- Streamlit App → Hazard Detection: detects hazards (evidence: `app.py`)
- Streamlit App → Image Reliability: assesses quality (evidence: `app.py`)
- Streamlit App → Risk Scoring: calculates risk (evidence: `app.py`)
- Streamlit App → AI Report Generation: requests report (evidence: `app.py`)
- Streamlit App → Report Formatting: formats download (evidence: `app.py`)
- Streamlit App → Batch Prioritization: prioritizes batch (evidence: `app.py`)
- Hazard Detection → Runtime Config: reads settings (evidence: `detector.py`)
- Hazard Detection → Roboflow API: posts image (evidence: `detector.py`)
- AI Report Generation → Runtime Config: reads settings (evidence: `genai.py`)
- AI Report Generation → Anthropic API: requests generation (evidence: `genai.py`)
