# nachiket1904/agentic-security-auditor- architecture

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

- Interactive diagram: https://gitdiagram.com/nachiket1904/agentic-security-auditor-
- Repository: https://github.com/nachiket1904/agentic-security-auditor-

## Overview

The repository tree contains documentation and project metadata, but no backend or frontend source files. The graph therefore represents the documented MVP architecture rather than verified runtime implementation; component nodes point to README.md as their documentation, not as implementing code. Planned capabilities are omitted.

Main entry points: [`README.md`](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md) (LangGraph)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interface"]
  node_ui["Streamlit UI<br/>[README.md]"]
  node_api["FastAPI<br/>[README.md]"]
end

subgraph group_workflow["Audit Workflow"]
  node_orchestrator["LangGraph<br/>[README.md]"]
  node_fixer["Fixer<br/>[README.md]"]
  node_report["Audit Report<br/>[README.md]"]
  node_diff["Code Diff<br/>[README.md]"]
end

subgraph group_analysis["Security Analysis"]
  node_scanner["Scanner<br/>[README.md]"]
  node_semgrep["Semgrep"]
  node_bandit["Bandit"]
  node_analyst["Analyst<br/>[README.md]"]
  node_llm["Anthropic API"]
end

subgraph group_validation["Remediation Validation"]
  node_validator["Validator<br/>[README.md]"]
  node_tests["Tests<br/>[README.md]"]
  node_rescan["Security Rescan<br/>[README.md]"]
end

node_user(("Developer"))

node_user -->|"submits code"| node_ui
node_ui -->|"sends request"| node_api
node_api -->|"invokes workflow"| node_orchestrator
node_orchestrator -->|"dispatches scan"| node_scanner
node_scanner -->|"runs scanner"| node_semgrep
node_scanner -->|"runs scanner"| node_bandit
node_scanner -->|"provides findings"| node_analyst
node_analyst -->|"requests analysis"| node_llm
node_orchestrator -->|"dispatches remediation"| node_fixer
node_fixer -->|"requests remediation"| node_llm
node_orchestrator -->|"dispatches validation"| node_validator
node_validator -->|"runs tests"| node_tests
node_validator -->|"rescans code"| node_rescan
node_orchestrator -->|"produces report"| node_report
node_orchestrator -->|"produces diff"| node_diff

click node_ui "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_api "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_orchestrator "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_scanner "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_analyst "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_fixer "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_validator "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_tests "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_rescan "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_report "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"
click node_diff "https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md"

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_ui,node_api toneBlue
class node_orchestrator,node_fixer,node_report,node_diff toneAmber
class node_scanner,node_semgrep,node_bandit,node_analyst,node_llm toneMint
class node_validator,node_tests,node_rescan toneRose
class node_user toneIndigo
```

## Components

### User Interface

- [Streamlit UI](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`
- [FastAPI](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`

### Audit Workflow

- [LangGraph](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`
- [Fixer](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`
- [Audit Report](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`
- [Code Diff](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`

### Security Analysis

- [Scanner](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`
- **Semgrep**
- **Bandit**
- [Analyst](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`
- **Anthropic API**

### Remediation Validation

- [Validator](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`
- [Tests](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`
- [Security Rescan](https://github.com/nachiket1904/agentic-security-auditor-/blob/main/README.md): `README.md`

### Other components

- **Developer**

## Connections

- Developer → Streamlit UI: submits code (evidence: `README.md`)
- Streamlit UI → FastAPI: sends request (evidence: `README.md`)
- FastAPI → LangGraph: invokes workflow (evidence: `README.md`)
- LangGraph → Scanner: dispatches scan (evidence: `README.md`)
- Scanner → Semgrep: runs scanner (evidence: `README.md`)
- Scanner → Bandit: runs scanner (evidence: `README.md`)
- Scanner → Analyst: provides findings (evidence: `README.md`)
- Analyst → Anthropic API: requests analysis (evidence: `README.md`)
- LangGraph → Fixer: dispatches remediation (evidence: `README.md`)
- Fixer → Anthropic API: requests remediation (evidence: `README.md`)
- LangGraph → Validator: dispatches validation (evidence: `README.md`)
- Validator → Tests: runs tests (evidence: `README.md`)
- Validator → Security Rescan: rescans code (evidence: `README.md`)
- LangGraph → Audit Report: produces report (evidence: `README.md`)
- LangGraph → Code Diff: produces diff (evidence: `README.md`)
