# popla69/hydraflow architecture

> Architecture diagram of the GitHub repository popla69/hydraflow, 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/popla69/hydraflow
- Repository: https://github.com/popla69/hydraflow

## Overview

HydraFlow is a multi-channel security-testing framework. Its scan workflow takes a target through reconnaissance, endpoint classification, adaptive vulnerability testing, finding correlation, and reporting; the CLI also supports resumable sessions. The repository documents adaptive rerouting and reporting, but their implementations—and several other advertised scan modules—are absent from the supplied tree, so those are represented at the documented `modules/` boundary. Hell Training is a separate workflow that exercises and evolves adaptive techniques. Edges reflect sampled calls or README-described behavior; unsampled module internals are not inferred.

Main entry points: [`hydraflow.py`](https://github.com/popla69/hydraflow/blob/main/hydraflow.py) (Scan CLI), [`modules/training_hell.py`](https://github.com/popla69/hydraflow/blob/main/modules/training_hell.py) (Hell training), [`modules/evolution.py`](https://github.com/popla69/hydraflow/blob/main/modules/evolution.py) (Evolution engine), [`modules/training_integration.py`](https://github.com/popla69/hydraflow/blob/main/modules/training_integration.py) (Training integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Scan runtime"]
  node_cli["Scan CLI<br/>[hydraflow.py]"]
  node_config["Configuration<br/>[config.py]"]
  node_engine["Task engine<br/>[engine.py]"]
  node_logger["Logging<br/>[logger.py]"]
  node_session["Session state<br/>[session.py]"]
end

subgraph group_discovery["Discovery"]
  node_recon["Reconnaissance<br/>[recon.py]"]
  node_recon_tools["Recon tools"]
  node_classifier["Endpoint classifier<br/>[classifier.py]"]
end

subgraph group_assessment["Assessment"]
  node_testing["Vulnerability testing"]
  node_rerouter["Adaptive rerouting"]
  node_chainer["Finding correlation"]
  node_reporter["Report generation"]
end

subgraph group_learning["Evolution and training"]
  node_evolution["Evolution engine<br/>[evolution.py]"]
  node_training_cli["Training CLI<br/>[train_hell.py]"]
  node_training["Hell training<br/>[training_hell.py]"]
  node_training_integration["Training integration"]
end

node_user(("Operator"))
node_target(("Target"))

node_user -->|"starts scan"| node_cli
node_user -->|"starts training"| node_training_cli
node_target -->|"supplies target"| node_cli
node_cli -->|"loads settings"| node_config
node_cli -->|"coordinates tasks"| node_engine
node_cli -->|"sets up logging"| node_logger
node_cli -->|"manages session"| node_session
node_cli -->|"runs reconnaissance"| node_recon
node_recon -->|"invokes tools"| node_recon_tools
node_cli -->|"classifies endpoints"| node_classifier
node_cli -->|"tests endpoints"| node_testing
node_cli -->|"reroutes obstacles"| node_rerouter
node_cli -->|"learns from failures"| node_evolution
node_cli -->|"correlates findings"| node_chainer
node_cli -->|"generates reports"| node_reporter
node_training_cli -->|"runs protocol"| node_training
node_training -->|"analyzes failures"| node_evolution
node_training_integration -->|"uses trainer"| node_training
node_training_integration -->|"uses evolution"| node_evolution

click node_cli "https://github.com/popla69/hydraflow/blob/main/hydraflow.py"
click node_config "https://github.com/popla69/hydraflow/blob/main/core/config.py"
click node_engine "https://github.com/popla69/hydraflow/blob/main/core/engine.py"
click node_logger "https://github.com/popla69/hydraflow/blob/main/core/logger.py"
click node_session "https://github.com/popla69/hydraflow/blob/main/core/session.py"
click node_recon "https://github.com/popla69/hydraflow/blob/main/modules/recon.py"
click node_classifier "https://github.com/popla69/hydraflow/blob/main/modules/classifier.py"
click node_testing "https://github.com/popla69/hydraflow/tree/main/modules"
click node_rerouter "https://github.com/popla69/hydraflow/tree/main/modules"
click node_chainer "https://github.com/popla69/hydraflow/tree/main/modules"
click node_reporter "https://github.com/popla69/hydraflow/tree/main/modules"
click node_evolution "https://github.com/popla69/hydraflow/blob/main/modules/evolution.py"
click node_training_cli "https://github.com/popla69/hydraflow/blob/main/train_hell.py"
click node_training "https://github.com/popla69/hydraflow/blob/main/modules/training_hell.py"
click node_training_integration "https://github.com/popla69/hydraflow/blob/main/modules/training_integration.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_config,node_engine,node_logger,node_session toneBlue
class node_recon,node_recon_tools,node_classifier toneAmber
class node_testing,node_rerouter,node_chainer,node_reporter toneMint
class node_evolution,node_training_cli,node_training,node_training_integration toneRose
class node_user,node_target toneIndigo
```

## Components

### Scan runtime

- [Scan CLI](https://github.com/popla69/hydraflow/blob/main/hydraflow.py): `hydraflow.py`
- [Configuration](https://github.com/popla69/hydraflow/blob/main/core/config.py): `core/config.py`
- [Task engine](https://github.com/popla69/hydraflow/blob/main/core/engine.py): `core/engine.py`
- [Logging](https://github.com/popla69/hydraflow/blob/main/core/logger.py): `core/logger.py`
- [Session state](https://github.com/popla69/hydraflow/blob/main/core/session.py): `core/session.py`

### Discovery

- [Reconnaissance](https://github.com/popla69/hydraflow/blob/main/modules/recon.py): `modules/recon.py`
- **Recon tools**
- [Endpoint classifier](https://github.com/popla69/hydraflow/blob/main/modules/classifier.py): `modules/classifier.py`

### Assessment

- [Vulnerability testing](https://github.com/popla69/hydraflow/tree/main/modules): `modules`
- [Adaptive rerouting](https://github.com/popla69/hydraflow/tree/main/modules): `modules`
- [Finding correlation](https://github.com/popla69/hydraflow/tree/main/modules): `modules`
- [Report generation](https://github.com/popla69/hydraflow/tree/main/modules): `modules`

### Evolution and training

- [Evolution engine](https://github.com/popla69/hydraflow/blob/main/modules/evolution.py): `modules/evolution.py`
- [Training CLI](https://github.com/popla69/hydraflow/blob/main/train_hell.py): `train_hell.py`
- [Hell training](https://github.com/popla69/hydraflow/blob/main/modules/training_hell.py): `modules/training_hell.py`
- [Training integration](https://github.com/popla69/hydraflow/blob/main/modules/training_integration.py): `modules/training_integration.py`

### Other components

- **Operator**
- **Target**

## Connections

- Operator → Scan CLI: starts scan (evidence: `README.md`)
- Operator → Training CLI: starts training (evidence: `README.md`)
- Target → Scan CLI: supplies target (evidence: `README.md`)
- Scan CLI → Configuration: loads settings (evidence: `hydraflow.py`)
- Scan CLI → Task engine: coordinates tasks (evidence: `hydraflow.py`)
- Scan CLI → Logging: sets up logging (evidence: `hydraflow.py`)
- Scan CLI → Session state: manages session (evidence: `hydraflow.py`)
- Scan CLI → Reconnaissance: runs reconnaissance (evidence: `hydraflow.py`)
- Reconnaissance → Recon tools: invokes tools (evidence: `modules/recon.py`)
- Scan CLI → Endpoint classifier: classifies endpoints (evidence: `hydraflow.py`)
- Scan CLI → Vulnerability testing: tests endpoints (evidence: `README.md`)
- Scan CLI → Adaptive rerouting: reroutes obstacles (evidence: `README.md`)
- Scan CLI → Evolution engine: learns from failures (evidence: `hydraflow.py`)
- Scan CLI → Finding correlation: correlates findings (evidence: `README.md`)
- Scan CLI → Report generation: generates reports (evidence: `README.md`)
- Training CLI → Hell training: runs protocol (evidence: `train_hell.py`)
- Hell training → Evolution engine: analyzes failures (evidence: `modules/training_hell.py`)
- Training integration → Hell training: uses trainer (evidence: `modules/training_integration.py`)
- Training integration → Evolution engine: uses evolution (evidence: `modules/training_integration.py`)
