# ayushgayakwad/raider architecture

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

- Interactive diagram: https://gitdiagram.com/ayushgayakwad/raider
- Repository: https://github.com/ayushgayakwad/raider

## Overview

RAIDER runs an authorized red-team mission: a user supplies a target, the Q-learning commander selects reconnaissance or an exploit action, agents publish findings to shared mission state, and a reporter produces a PDF audit. The README also describes GUI mission control, live intelligence, and a vulnerable local demo target. Edges reflect the sampled CLI, agent, and reporting code or explicit README statements; GUI wiring is less fully sampled.

Main entry points: [`main.py`](https://github.com/ayushgayakwad/raider/blob/main/main.py) (CLI Mission Loop), [`blackboard.py`](https://github.com/ayushgayakwad/raider/blob/main/blackboard.py) (Mission Blackboard), [`gui_app.py`](https://github.com/ayushgayakwad/raider/blob/main/gui_app.py) (Mission Dashboard), [`coordination_core.py`](https://github.com/ayushgayakwad/raider/blob/main/coordination_core.py) (RL Commander)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mission["Mission Control"]
  node_cli["CLI Mission Loop<br/>[main.py]"]
  node_dashboard["Mission Dashboard<br/>[gui_app.py]"]
  node_commander["RL Commander"]
end

subgraph group_agents["Security Agents"]
  node_recon["Network Recon<br/>[agents_recon.py]"]
  node_sqli["SQL Injection<br/>[agents_exploit.py]"]
  node_xss["XSS Scanning<br/>[agents_exploit.py]"]
end

subgraph group_state["Shared Intelligence"]
  node_blackboard[("Mission Blackboard<br/>[blackboard.py]")]
end

subgraph group_outputs["Targets &amp; Reporting"]
  node_reporter["PDF Reporter<br/>[reporting.py]"]
  node_target(("Authorized Target"))
  node_mock["Mock Web App<br/>[mock_target.py]"]
end

node_operator(("Operator"))
node_nmap["Nmap"]
node_gemini["Gemini API"]

node_operator -->|"starts mission"| node_cli
node_operator -->|"controls mission"| node_dashboard
node_cli -->|"requests actions"| node_commander
node_cli -->|"dispatches recon"| node_recon
node_cli -->|"dispatches SQLi"| node_sqli
node_cli -->|"dispatches XSS"| node_xss
node_commander -->|"reads state"| node_blackboard
node_commander -->|"updates policy"| node_commander
node_recon -->|"scans with"| node_nmap
node_recon -->|"publishes scan"| node_blackboard
node_sqli -->|"records findings"| node_blackboard
node_xss -->|"records findings"| node_blackboard
node_sqli -.->|"generates tactics"| node_gemini
node_xss -.->|"generates tactics"| node_gemini
node_sqli -.->|"tests login"| node_target
node_xss -.->|"tests inputs"| node_target
node_cli -->|"starts demo"| node_mock
node_mock -->|"serves demo"| node_target
node_cli -->|"generates report"| node_reporter
node_reporter -->|"reads findings"| node_blackboard
node_dashboard -->|"runs missions"| node_commander
node_dashboard -->|"dispatches scans"| node_recon
node_dashboard -.->|"shows intelligence"| node_blackboard
node_dashboard -->|"opens report"| node_reporter

click node_cli "https://github.com/ayushgayakwad/raider/blob/main/main.py"
click node_dashboard "https://github.com/ayushgayakwad/raider/blob/main/gui_app.py"
click node_commander "https://github.com/ayushgayakwad/raider/blob/main/coordination_core.py"
click node_recon "https://github.com/ayushgayakwad/raider/blob/main/agents_recon.py"
click node_sqli "https://github.com/ayushgayakwad/raider/blob/main/agents_exploit.py"
click node_xss "https://github.com/ayushgayakwad/raider/blob/main/agents_exploit.py"
click node_blackboard "https://github.com/ayushgayakwad/raider/blob/main/blackboard.py"
click node_reporter "https://github.com/ayushgayakwad/raider/blob/main/reporting.py"
click node_mock "https://github.com/ayushgayakwad/raider/blob/main/mock_target.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_cli,node_dashboard,node_commander toneBlue
class node_recon,node_sqli,node_xss toneAmber
class node_blackboard,node_gemini toneMint
class node_reporter,node_target,node_mock toneRose
class node_operator,node_nmap toneIndigo
```

## Components

### Mission Control

- [CLI Mission Loop](https://github.com/ayushgayakwad/raider/blob/main/main.py): `main.py`
- [Mission Dashboard](https://github.com/ayushgayakwad/raider/blob/main/gui_app.py): `gui_app.py`
- [RL Commander](https://github.com/ayushgayakwad/raider/blob/main/coordination_core.py): `coordination_core.py`

### Security Agents

- [Network Recon](https://github.com/ayushgayakwad/raider/blob/main/agents_recon.py): `agents_recon.py`
- [SQL Injection](https://github.com/ayushgayakwad/raider/blob/main/agents_exploit.py): `agents_exploit.py`
- [XSS Scanning](https://github.com/ayushgayakwad/raider/blob/main/agents_exploit.py): `agents_exploit.py`

### Shared Intelligence

- [Mission Blackboard](https://github.com/ayushgayakwad/raider/blob/main/blackboard.py): `blackboard.py`

### Targets & Reporting

- [PDF Reporter](https://github.com/ayushgayakwad/raider/blob/main/reporting.py): `reporting.py`
- **Authorized Target**
- [Mock Web App](https://github.com/ayushgayakwad/raider/blob/main/mock_target.py): `mock_target.py`

### Other components

- **Operator**
- **Nmap**
- **Gemini API**

## Connections

- Operator → CLI Mission Loop: starts mission (evidence: `README.md`)
- Operator → Mission Dashboard: controls mission (evidence: `README.md`)
- CLI Mission Loop → RL Commander: requests actions (evidence: `main.py`)
- CLI Mission Loop → Network Recon: dispatches recon (evidence: `main.py`)
- CLI Mission Loop → SQL Injection: dispatches SQLi (evidence: `main.py`)
- CLI Mission Loop → XSS Scanning: dispatches XSS (evidence: `main.py`)
- RL Commander → Mission Blackboard: reads state (evidence: `coordination_core.py`)
- RL Commander → RL Commander: updates policy (evidence: `coordination_core.py`)
- Network Recon → Nmap: scans with (evidence: `agents_recon.py`)
- Network Recon → Mission Blackboard: publishes scan (evidence: `agents_recon.py`)
- SQL Injection → Mission Blackboard: records findings (evidence: `agents_exploit.py`)
- XSS Scanning → Mission Blackboard: records findings (evidence: `agents_exploit.py`)
- SQL Injection → Gemini API: generates tactics (evidence: `README.md`)
- XSS Scanning → Gemini API: generates tactics (evidence: `README.md`)
- SQL Injection → Authorized Target: tests login (evidence: `README.md`)
- XSS Scanning → Authorized Target: tests inputs (evidence: `README.md`)
- CLI Mission Loop → Mock Web App: starts demo (evidence: `main.py`)
- Mock Web App → Authorized Target: serves demo (evidence: `mock_target.py`)
- CLI Mission Loop → PDF Reporter: generates report (evidence: `main.py`)
- PDF Reporter → Mission Blackboard: reads findings (evidence: `reporting.py`)
- Mission Dashboard → RL Commander: runs missions (evidence: `gui_app.py`)
- Mission Dashboard → Network Recon: dispatches scans (evidence: `gui_app.py`)
- Mission Dashboard → Mission Blackboard: shows intelligence (evidence: `README.md`)
- Mission Dashboard → PDF Reporter: opens report (evidence: `README.md`)
