How popla69/hydraflow works
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 Scan CLI · training_hell.py Hell training · evolution.py Evolution engine · training_integration.py Training integration
Components 18
Scan runtime
- Scan CLI
hydraflow.py - Configuration
core/config.py - Task engine
core/engine.py - Logging
core/logger.py - Session state
core/session.py
Discovery
- Reconnaissance
modules/recon.py - Recon tools
- Endpoint classifier
modules/classifier.py
Assessment
- Vulnerability testing
modules - Adaptive rerouting
modules - Finding correlation
modules - Report generation
modules
Evolution and training
- Evolution engine
modules/evolution.py - Training CLI
train_hell.py - Hell training
modules/training_hell.py - Training integration
modules/training_integration.py
Other components
- Operator
- Target
Connections 19
- Operator → Scan CLI: starts scan
README.md - Operator → Training CLI: starts training
README.md - Target → Scan CLI: supplies target
README.md - Scan CLI → Configuration: loads settings
hydraflow.py - Scan CLI → Task engine: coordinates tasks
hydraflow.py - Scan CLI → Logging: sets up logging
hydraflow.py - Scan CLI → Session state: manages session
hydraflow.py - Scan CLI → Reconnaissance: runs reconnaissance
hydraflow.py - Reconnaissance → Recon tools: invokes tools
modules/recon.py - Scan CLI → Endpoint classifier: classifies endpoints
hydraflow.py - Scan CLI → Vulnerability testing: tests endpoints
README.md - Scan CLI → Adaptive rerouting: reroutes obstacles
README.md - Scan CLI → Evolution engine: learns from failures
hydraflow.py - Scan CLI → Finding correlation: correlates findings
README.md - Scan CLI → Report generation: generates reports
README.md - Training CLI → Hell training: runs protocol
train_hell.py - Hell training → Evolution engine: analyzes failures
modules/training_hell.py - Training integration → Hell training: uses trainer
modules/training_integration.py - Training integration → Evolution engine: uses evolution
modules/training_integration.py