# moostanger794/llm-security-gateway architecture

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

- Interactive diagram: https://gitdiagram.com/moostanger794/llm-security-gateway
- Repository: https://github.com/moostanger794/llm-security-gateway

## Overview

AI Security Gateway is a local FastAPI service for heuristic prompt, text, and email security analysis; it does not call an LLM or enforce the returned action. The main request path validates input at the API boundary, dispatches through the orchestrator to detectors, then combines findings into a risk decision and explanation. Email analysis adds sender and URL checks. A separate local evaluation workflow loads labeled datasets, runs analysis, and reports metrics. Source excerpts show the request and detector calls; evaluation links are documented in the README.

Main entry points: [`src/ai_security_gateway/orchestration/orchestrator.py`](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/orchestration/orchestrator.py) (Security Orchestrator), [`src/ai_security_gateway/security/email_guard.py`](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/email_guard.py) (Email Guard), [`src/ai_security_gateway/main.py`](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/main.py) (Application), [`src/ai_security_gateway/api/routes.py`](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/api/routes.py) (Analysis Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_app["Application<br/>[main.py]"]
  node_request_limits["Body Limits<br/>[body_limit.py]"]
  node_routes["Analysis Routes<br/>[routes.py]"]
  node_schemas["Request Schemas<br/>[schemas.py]"]
end

subgraph group_analysis["Security Analysis"]
  node_orchestrator["Security Orchestrator<br/>[orchestrator.py]"]
  node_prompt_guard["Prompt Guard<br/>[prompt_guard.py]"]
  node_rules["Detection Rules<br/>[rules.py]"]
  node_email_guard["Email Guard<br/>[email_guard.py]"]
  node_url_guard["URL Guard<br/>[url_guard.py]"]
  node_normalization["Text Normalization<br/>[normalization.py]"]
  node_email_normalization["Email Normalization"]
end

subgraph group_policy["Decision and Runtime"]
  node_config["Settings<br/>[config.py]"]
  node_logging["Safe Logging<br/>[logging.py]"]
  node_risk_engine["Risk Engine<br/>[risk_engine.py]"]
  node_advisor["Security Advisor<br/>[advisor.py]"]
  node_result["Security Result<br/>[security.py]"]
end

subgraph group_evaluation["Local Evaluation"]
  node_dataset["Evaluation Datasets"]
  node_benchmark["Benchmark Runner<br/>[benchmark.py]"]
  node_dataset_loader["Dataset Loader<br/>[dataset.py]"]
  node_metrics["Evaluation Metrics<br/>[metrics.py]"]
  node_report["Benchmark Report<br/>[benchmark.py]"]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_app
node_app -->|"registers routes"| node_routes
node_app -->|"adds middleware"| node_request_limits
node_app -->|"loads settings"| node_config
node_app -->|"configures logging"| node_logging
node_routes -->|"validates requests"| node_schemas
node_routes -->|"dispatches analysis"| node_orchestrator
node_routes -->|"returns result"| node_result
node_routes -->|"logs decisions"| node_logging
node_schemas -->|"validates text"| node_normalization
node_schemas -->|"validates email"| node_email_normalization
node_orchestrator -->|"detects prompt threats"| node_prompt_guard
node_orchestrator -->|"detects email threats"| node_email_guard
node_orchestrator -->|"normalizes text"| node_normalization
node_orchestrator -->|"validates email fields"| node_email_normalization
node_orchestrator -->|"scores findings"| node_risk_engine
node_orchestrator -->|"builds explanation"| node_advisor
node_orchestrator -->|"constructs result"| node_result
node_prompt_guard -->|"normalizes input"| node_normalization
node_prompt_guard -->|"applies rules"| node_rules
node_email_guard -->|"normalizes email"| node_email_normalization
node_email_guard -->|"normalizes content"| node_normalization
node_email_guard -->|"checks embedded prompts"| node_prompt_guard
node_email_guard -->|"checks extracted URLs"| node_url_guard
node_email_guard -->|"scores findings"| node_risk_engine
node_risk_engine -->|"uses result types"| node_result
node_advisor -->|"uses risk policy"| node_risk_engine
node_dataset -->|"provides records"| node_dataset_loader
node_benchmark -->|"loads datasets"| node_dataset_loader
node_benchmark -->|"runs analysis"| node_orchestrator
node_benchmark -->|"computes metrics"| node_metrics
node_benchmark -->|"writes report"| node_report

click node_app "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/main.py"
click node_request_limits "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/api/body_limit.py"
click node_routes "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/api/routes.py"
click node_schemas "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/api/schemas.py"
click node_config "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/core/config.py"
click node_logging "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/core/logging.py"
click node_orchestrator "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/orchestration/orchestrator.py"
click node_prompt_guard "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/prompt_guard.py"
click node_rules "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/rules.py"
click node_email_guard "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/email_guard.py"
click node_url_guard "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/url_guard.py"
click node_normalization "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/normalization.py"
click node_email_normalization "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/email_normalization.py"
click node_risk_engine "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/risk_engine.py"
click node_advisor "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/orchestration/advisor.py"
click node_result "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/models/security.py"
click node_dataset "https://github.com/moostanger794/llm-security-gateway/tree/main/datasets"
click node_benchmark "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/evaluation/benchmark.py"
click node_dataset_loader "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/evaluation/dataset.py"
click node_metrics "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/evaluation/metrics.py"
click node_report "https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/evaluation/benchmark.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_request_limits,node_routes,node_schemas,node_client toneBlue
class node_orchestrator,node_prompt_guard,node_rules,node_email_guard,node_url_guard,node_normalization,node_email_normalization toneAmber
class node_config,node_logging,node_risk_engine,node_advisor,node_result toneMint
class node_dataset,node_benchmark,node_dataset_loader,node_metrics,node_report toneRose
```

## Components

### HTTP API

- [Application](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/main.py): `src/ai_security_gateway/main.py`
- [Body Limits](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/api/body_limit.py): `src/ai_security_gateway/api/body_limit.py`
- [Analysis Routes](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/api/routes.py): `src/ai_security_gateway/api/routes.py`
- [Request Schemas](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/api/schemas.py): `src/ai_security_gateway/api/schemas.py`

### Security Analysis

- [Security Orchestrator](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/orchestration/orchestrator.py): `src/ai_security_gateway/orchestration/orchestrator.py`
- [Prompt Guard](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/prompt_guard.py): `src/ai_security_gateway/security/prompt_guard.py`
- [Detection Rules](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/rules.py): `src/ai_security_gateway/security/rules.py`
- [Email Guard](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/email_guard.py): `src/ai_security_gateway/security/email_guard.py`
- [URL Guard](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/url_guard.py): `src/ai_security_gateway/security/url_guard.py`
- [Text Normalization](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/normalization.py): `src/ai_security_gateway/security/normalization.py`
- [Email Normalization](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/email_normalization.py): `src/ai_security_gateway/security/email_normalization.py`

### Decision and Runtime

- [Settings](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/core/config.py): `src/ai_security_gateway/core/config.py`
- [Safe Logging](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/core/logging.py): `src/ai_security_gateway/core/logging.py`
- [Risk Engine](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/security/risk_engine.py): `src/ai_security_gateway/security/risk_engine.py`
- [Security Advisor](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/orchestration/advisor.py): `src/ai_security_gateway/orchestration/advisor.py`
- [Security Result](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/models/security.py): `src/ai_security_gateway/models/security.py`

### Local Evaluation

- [Evaluation Datasets](https://github.com/moostanger794/llm-security-gateway/tree/main/datasets): `datasets`
- [Benchmark Runner](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/evaluation/benchmark.py): `src/ai_security_gateway/evaluation/benchmark.py`
- [Dataset Loader](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/evaluation/dataset.py): `src/ai_security_gateway/evaluation/dataset.py`
- [Evaluation Metrics](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/evaluation/metrics.py): `src/ai_security_gateway/evaluation/metrics.py`
- [Benchmark Report](https://github.com/moostanger794/llm-security-gateway/blob/main/src/ai_security_gateway/evaluation/benchmark.py): `src/ai_security_gateway/evaluation/benchmark.py`

### Other components

- **API Client**

## Connections

- API Client → Application: sends requests (evidence: `README.md`)
- Application → Analysis Routes: registers routes (evidence: `src/ai_security_gateway/main.py`)
- Application → Body Limits: adds middleware (evidence: `src/ai_security_gateway/main.py`)
- Application → Settings: loads settings (evidence: `src/ai_security_gateway/main.py`)
- Application → Safe Logging: configures logging (evidence: `src/ai_security_gateway/main.py`)
- Analysis Routes → Request Schemas: validates requests (evidence: `src/ai_security_gateway/api/routes.py`)
- Analysis Routes → Security Orchestrator: dispatches analysis (evidence: `src/ai_security_gateway/api/routes.py`)
- Analysis Routes → Security Result: returns result (evidence: `src/ai_security_gateway/api/routes.py`)
- Analysis Routes → Safe Logging: logs decisions (evidence: `src/ai_security_gateway/api/routes.py`)
- Request Schemas → Text Normalization: validates text (evidence: `src/ai_security_gateway/api/schemas.py`)
- Request Schemas → Email Normalization: validates email (evidence: `src/ai_security_gateway/api/schemas.py`)
- Security Orchestrator → Prompt Guard: detects prompt threats (evidence: `src/ai_security_gateway/orchestration/orchestrator.py`)
- Security Orchestrator → Email Guard: detects email threats (evidence: `src/ai_security_gateway/orchestration/orchestrator.py`)
- Security Orchestrator → Text Normalization: normalizes text (evidence: `src/ai_security_gateway/orchestration/orchestrator.py`)
- Security Orchestrator → Email Normalization: validates email fields (evidence: `src/ai_security_gateway/orchestration/orchestrator.py`)
- Security Orchestrator → Risk Engine: scores findings (evidence: `src/ai_security_gateway/orchestration/orchestrator.py`)
- Security Orchestrator → Security Advisor: builds explanation (evidence: `src/ai_security_gateway/orchestration/orchestrator.py`)
- Security Orchestrator → Security Result: constructs result (evidence: `src/ai_security_gateway/orchestration/orchestrator.py`)
- Prompt Guard → Text Normalization: normalizes input (evidence: `src/ai_security_gateway/security/prompt_guard.py`)
- Prompt Guard → Detection Rules: applies rules (evidence: `src/ai_security_gateway/security/prompt_guard.py`)
- Email Guard → Email Normalization: normalizes email (evidence: `src/ai_security_gateway/security/email_guard.py`)
- Email Guard → Text Normalization: normalizes content (evidence: `src/ai_security_gateway/security/email_guard.py`)
- Email Guard → Prompt Guard: checks embedded prompts (evidence: `src/ai_security_gateway/security/email_guard.py`)
- Email Guard → URL Guard: checks extracted URLs (evidence: `src/ai_security_gateway/security/email_guard.py`)
- Email Guard → Risk Engine: scores findings (evidence: `src/ai_security_gateway/security/email_guard.py`)
- Risk Engine → Security Result: uses result types (evidence: `src/ai_security_gateway/security/risk_engine.py`)
- Security Advisor → Risk Engine: uses risk policy (evidence: `src/ai_security_gateway/orchestration/advisor.py`)
- Evaluation Datasets → Dataset Loader: provides records (evidence: `README.md`)
- Benchmark Runner → Dataset Loader: loads datasets (evidence: `README.md`)
- Benchmark Runner → Security Orchestrator: runs analysis (evidence: `README.md`)
- Benchmark Runner → Evaluation Metrics: computes metrics (evidence: `README.md`)
- Benchmark Runner → Benchmark Report: writes report (evidence: `README.md`)
