# dextryayers/hackit architecture

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

- Interactive diagram: https://gitdiagram.com/dextryayers/hackit
- Repository: https://github.com/dextryayers/hackit

## Overview

HackIT is a polyglot offensive-security toolkit whose documented primary workflow starts at the Python CLI, delegates autonomous work to Go, and proceeds through reconnaissance, vulnerability identification, exploitation, and reporting. The repository also contains a substantial web-intelligence UI and a multi-engine port scanner. The README documents the high-level campaign flow; sampled sources establish selected scanner and web-UI relationships. Other subsystem links are omitted where source evidence was not available.

Main entry points: [`hackit/agent/go/autonomous_hunter.go`](https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/autonomous_hunter.go) (Autonomous Hunter), [`hackit/port_scanner/engine_orchestrator.py`](https://github.com/dextryayers/hackit/blob/main/hackit/port_scanner/engine_orchestrator.py) (Port Scan Control), [`hackit/webUI/python/orchestrator.py`](https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/orchestrator.py) (Web Intelligence), [`main.py`](https://github.com/dextryayers/hackit/blob/main/main.py) (Master CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Campaign Control"]
  node_cli["Master CLI<br/>[main.py]"]
  node_hunter["Autonomous Hunter"]
end

subgraph group_recon["Reconnaissance"]
  node_osint["OSINT<br/>[core.py]"]
  node_portflow["Port Scan Control"]
  node_portengines["Port Scan Engines<br/>[engine.go]"]
  node_dirfinder["Directory Discovery<br/>[engine.go]"]
end

subgraph group_assessment["Security Assessment"]
  node_vuln["Vulnerability Analysis<br/>[analyzer.go]"]
  node_cve["CVE Scanner<br/>[scanner.go]"]
  node_exploit["Exploit Execution"]
end

subgraph group_webintel["Web Intelligence"]
  node_webscan["Web Intelligence<br/>[orchestrator.py]"]
  node_crawler["Web Crawler<br/>[crawler_engine.py]"]
  node_search["Search Aggregator"]
  node_webcommon["Finding Helpers<br/>[module_common.py]"]
  node_webmodels["Finding Models<br/>[models.py]"]
end

subgraph group_output["Results"]
  node_report["Campaign Reporting<br/>[report_engine.go]"]
end

node_operator(("Operator"))
node_target(("Authorized Target"))

node_operator -->|"starts campaign"| node_cli
node_cli -->|"delegates campaign"| node_hunter
node_hunter -.->|"reconnaissance"| node_osint
node_hunter -.->|"scans assets"| node_portflow
node_hunter -.->|"discovers paths"| node_dirfinder
node_portflow -->|"dispatches scans"| node_portengines
node_portflow -.->|"scans target"| node_target
node_hunter -.->|"identifies vulnerabilities"| node_vuln
node_hunter -.->|"checks CVEs"| node_cve
node_hunter -.->|"tests exploits"| node_exploit
node_hunter -.->|"generates report"| node_report
node_webscan -->|"runs crawler"| node_crawler
node_webscan -->|"runs module"| node_search
node_crawler -->|"creates findings"| node_webmodels
node_search -->|"builds findings"| node_webcommon
node_webcommon -->|"constructs findings"| node_webmodels

click node_cli "https://github.com/dextryayers/hackit/blob/main/main.py"
click node_hunter "https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/autonomous_hunter.go"
click node_osint "https://github.com/dextryayers/hackit/blob/main/hackit/osint/core.py"
click node_portflow "https://github.com/dextryayers/hackit/blob/main/hackit/port_scanner/engine_orchestrator.py"
click node_portengines "https://github.com/dextryayers/hackit/blob/main/hackit/port_scanner/go/engine.go"
click node_dirfinder "https://github.com/dextryayers/hackit/blob/main/hackit/dir_finder/go/engine.go"
click node_webscan "https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/orchestrator.py"
click node_crawler "https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/crawler_engine.py"
click node_search "https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/modules/search_engine_aggregator.py"
click node_webcommon "https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/module_common.py"
click node_webmodels "https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/models.py"
click node_vuln "https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/analyzer.go"
click node_cve "https://github.com/dextryayers/hackit/blob/main/hackit/cve/go/scanner.go"
click node_exploit "https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/advanced_exploits.go"
click node_report "https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/report_engine.go"

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_hunter toneBlue
class node_osint,node_portflow,node_portengines,node_dirfinder toneAmber
class node_vuln,node_cve,node_exploit toneMint
class node_webscan,node_crawler,node_search,node_webcommon,node_webmodels toneRose
class node_report,node_operator,node_target toneIndigo
```

## Components

### Campaign Control

- [Master CLI](https://github.com/dextryayers/hackit/blob/main/main.py): `main.py`
- [Autonomous Hunter](https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/autonomous_hunter.go): `hackit/agent/go/autonomous_hunter.go`

### Reconnaissance

- [OSINT](https://github.com/dextryayers/hackit/blob/main/hackit/osint/core.py): `hackit/osint/core.py`
- [Port Scan Control](https://github.com/dextryayers/hackit/blob/main/hackit/port_scanner/engine_orchestrator.py): `hackit/port_scanner/engine_orchestrator.py`
- [Port Scan Engines](https://github.com/dextryayers/hackit/blob/main/hackit/port_scanner/go/engine.go): `hackit/port_scanner/go/engine.go`
- [Directory Discovery](https://github.com/dextryayers/hackit/blob/main/hackit/dir_finder/go/engine.go): `hackit/dir_finder/go/engine.go`

### Security Assessment

- [Vulnerability Analysis](https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/analyzer.go): `hackit/agent/go/analyzer.go`
- [CVE Scanner](https://github.com/dextryayers/hackit/blob/main/hackit/cve/go/scanner.go): `hackit/cve/go/scanner.go`
- [Exploit Execution](https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/advanced_exploits.go): `hackit/agent/go/advanced_exploits.go`

### Web Intelligence

- [Web Intelligence](https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/orchestrator.py): `hackit/webUI/python/orchestrator.py`
- [Web Crawler](https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/crawler_engine.py): `hackit/webUI/python/crawler_engine.py`
- [Search Aggregator](https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/modules/search_engine_aggregator.py): `hackit/webUI/python/modules/search_engine_aggregator.py`
- [Finding Helpers](https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/module_common.py): `hackit/webUI/python/module_common.py`
- [Finding Models](https://github.com/dextryayers/hackit/blob/main/hackit/webUI/python/models.py): `hackit/webUI/python/models.py`

### Results

- [Campaign Reporting](https://github.com/dextryayers/hackit/blob/main/hackit/agent/go/report_engine.go): `hackit/agent/go/report_engine.go`

### Other components

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

## Connections

- Operator → Master CLI: starts campaign (evidence: `README.md`)
- Master CLI → Autonomous Hunter: delegates campaign (evidence: `README.md`)
- Autonomous Hunter → OSINT: reconnaissance
- Autonomous Hunter → Port Scan Control: scans assets
- Autonomous Hunter → Directory Discovery: discovers paths
- Port Scan Control → Port Scan Engines: dispatches scans (evidence: `hackit/port_scanner/engine_orchestrator.py`)
- Port Scan Control → Authorized Target: scans target
- Autonomous Hunter → Vulnerability Analysis: identifies vulnerabilities
- Autonomous Hunter → CVE Scanner: checks CVEs
- Autonomous Hunter → Exploit Execution: tests exploits
- Autonomous Hunter → Campaign Reporting: generates report
- Web Intelligence → Web Crawler: runs crawler (evidence: `hackit/webUI/python/orchestrator.py`)
- Web Intelligence → Search Aggregator: runs module (evidence: `hackit/webUI/python/orchestrator.py`)
- Web Crawler → Finding Models: creates findings (evidence: `hackit/webUI/python/crawler_engine.py`)
- Search Aggregator → Finding Helpers: builds findings (evidence: `hackit/webUI/python/modules/search_engine_aggregator.py`)
- Finding Helpers → Finding Models: constructs findings (evidence: `hackit/webUI/python/module_common.py`)
