# msoedov/agentic_security architecture

> Architecture diagram of the GitHub repository msoedov/agentic_security, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/msoedov/agentic_security
- Repository: https://github.com/msoedov/agentic_security

## Overview

##### Main Components Identification

a) Core Components:
- HTTP API Server (FastAPI-based)
- Probe System
- Security Scanning Engine
- Data Management System
- Report Generation System

b) Specialized Modules:
- Probe Actor Module
- Probe Data Module
- Refusal Classifier
- Multiple Testing Modules (Garak, InspectAI, Adaptive Attacks)

**┌─ Client Layer ─────────────────┐**
- Web UI (Static HTML/JS)      │
- CI/CD Integration            │
- Command Line Interface       │
- ┘

**┌─ API Routes ──────────────────┐**
- Probe Endpoints             │
- Proxy Routes               │
- Report Generation          │
- Scan Configuration         │
- ┘

**┌─ Security Scanner Core ───────┐**
- ┌─ Probe Actor ─────┐        │
- Fuzzer          │        │
- Refusal Testing │        │
- ┘        │

- ┌─ Probe Data ──────┐       │
- Data Generators │       │
- Attack Modules  │       │
- ┘       │
- ┘

**┌─ Integration Modules ─────────┐**
- Garak Tool                 │
- InspectAI Tool            │
- Adaptive Attacks          │
- Fine-tuned Models         │
- ┘

##### Data Flow Representation

- Client requests → API endpoints
- API endpoints → Core Processing
- Core Processing → Testing Modules
- Testing Modules → Target LLM Systems
- Results → Report Generation
- Reports → Client Interface

##### Technical Details

- FastAPI server configuration
- HTTP specification handling
- Dataset registry system
- Module registration system
- CI/CD integration points

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client["Client Layer"]
        WebUI["Web UI"]:::client
        CICD["CI/CD Integration"]:::client
        CLI["Command Line Interface"]:::client
    end

    subgraph API["API Layer"]
        ProbeEP["Probe Endpoints"]:::api
        ProxyEP["Proxy Routes"]:::api
        ReportEP["Report Generation"]:::api
        ScanEP["Scan Configuration"]:::api
    end

    subgraph Core["Security Scanner Core"]
        subgraph ProbeActor["Probe Actor"]
            Fuzzer["Fuzzer"]:::core
            RefusalTest["Refusal Testing"]:::core
        end

        subgraph ProbeData["Probe Data"]
            DataGen["Data Generators"]:::core
            AttackMod["Attack Modules"]:::core
        end

        subgraph Modalities["Input Modalities"]
            TextMod["Text Processing"]:::modality
            ImageMod["Image Processing"]:::modality
            AudioMod["Audio Processing"]:::modality
            VideoMod["Video Processing"]:::modality
        end

        RefusalClass["Refusal Classifier"]:::core
        HTTPSpec["HTTP Specification"]:::core
    end

    subgraph Testing["Testing Modules"]
        Garak["Garak Tool"]:::testing
        InspectAI["InspectAI Tool"]:::testing
        AdaptiveAtt["Adaptive Attacks"]:::testing
        FineTuned["Fine-tuned Models"]:::testing
    end

    %% Connections
    WebUI --> ProbeEP
    WebUI --> ProxyEP
    WebUI --> ReportEP
    WebUI --> ScanEP
    
    CICD --> ProbeEP
    CLI --> ProbeEP

    ProbeEP --> Fuzzer
    ProbeEP --> RefusalTest
    
    Fuzzer --> DataGen
    RefusalTest --> RefusalClass
    
    DataGen --> Modalities
    Modalities --> AttackMod
    AttackMod --> Garak
    AttackMod --> InspectAI
    AttackMod --> AdaptiveAtt
    AttackMod --> FineTuned

    %% Click Events
    click WebUI "https://github.com/msoedov/agentic_security/tree/main/agentic_security/static"
    click ProbeEP "https://github.com/msoedov/agentic_security/blob/main/agentic_security/routes/probe.py"
    click ProxyEP "https://github.com/msoedov/agentic_security/blob/main/agentic_security/routes/proxy.py"
    click ReportEP "https://github.com/msoedov/agentic_security/blob/main/agentic_security/routes/report.py"
    click ScanEP "https://github.com/msoedov/agentic_security/blob/main/agentic_security/routes/scan.py"
    click Fuzzer "https://github.com/msoedov/agentic_security/blob/main/agentic_security/probe_actor/fuzzer.py"
    click RefusalTest "https://github.com/msoedov/agentic_security/blob/main/agentic_security/probe_actor/refusal.py"
    click RefusalClass "https://github.com/msoedov/agentic_security/tree/main/agentic_security/refusal_classifier"
    click HTTPSpec "https://github.com/msoedov/agentic_security/blob/main/agentic_security/http_spec.py"
    click DataGen "https://github.com/msoedov/agentic_security/tree/main/agentic_security/probe_data"
    click AttackMod "https://github.com/msoedov/agentic_security/tree/main/agentic_security/probe_data/modules"
    click Garak "https://github.com/msoedov/agentic_security/blob/main/agentic_security/probe_data/modules/garak_tool.py"
    click InspectAI "https://github.com/msoedov/agentic_security/blob/main/agentic_security/probe_data/modules/inspect_ai_tool.py"
    click AdaptiveAtt "https://github.com/msoedov/agentic_security/blob/main/agentic_security/probe_data/modules/adaptive_attacks.py"
    click FineTuned "https://github.com/msoedov/agentic_security/blob/main/agentic_security/probe_data/modules/fine_tuned.py"

    %% Styles
    classDef client fill:#2374ab
    classDef api fill:#48a9a6
    classDef core fill:#4caf50
    classDef testing fill:#ff9800
    classDef modality fill:#e91e63

    %% Legend
    subgraph Legend
        Client_L["Client Component"]:::client
        API_L["API Component"]:::api
        Core_L["Core Component"]:::core
        Testing_L["Testing Component"]:::testing
        Modality_L["Modality Component"]:::modality
    end
```
