# imranansari033/autorecon architecture

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

- Interactive diagram: https://gitdiagram.com/imranansari033/autorecon
- Repository: https://github.com/imranansari033/autorecon

## Overview

AutoRecon is a command-line reconnaissance and vulnerability-assessment framework. The user supplies a target and selects passive, active, or full scanning; the CLI coordinates WHOIS, DNS and subdomain enumeration, then optional port scanning and service detection. In full mode, detected service versions are looked up against NVD and risk-classified before JSON and/or HTML reports are generated. The graph follows calls visible in main.py and sampled modules; external lookup services are shown where their use is explicit in source.

Main entry points: [`main.py`](https://github.com/imranansari033/autorecon/blob/main/main.py) (Scan Coordinator), [`core/passive/whois_enum.py`](https://github.com/imranansari033/autorecon/blob/main/core/passive/whois_enum.py) (WHOIS Lookup), [`core/passive/dns_enum.py`](https://github.com/imranansari033/autorecon/blob/main/core/passive/dns_enum.py) (DNS Enumeration), [`core/passive/subdomain_enum.py`](https://github.com/imranansari033/autorecon/blob/main/core/passive/subdomain_enum.py) (Subdomain Enumeration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orchestration"]
  node_cli["Scan Coordinator<br/>[main.py]"]
end

subgraph group_passive["Passive Recon"]
  node_whois["WHOIS Lookup<br/>[whois_enum.py]"]
  node_dns["DNS Enumeration<br/>[dns_enum.py]"]
  node_subdomains["Subdomain Enumeration<br/>[subdomain_enum.py]"]
end

subgraph group_active["Active Scanning"]
  node_ports["Port Scanner<br/>[port_scanner.py]"]
  node_services["Service Detection<br/>[service_detect.py]"]
end

subgraph group_assessment["Assessment and Reporting"]
  node_cve["CVE Lookup<br/>[cve_lookup.py]"]
  node_classifier["Risk Classifier<br/>[risk_classifier.py]"]
  node_dataset[("CVE Dataset<br/>[cve_dataset.csv]")]
  node_json_report["JSON Report<br/>[json_report.py]"]
  node_html_report["HTML Report<br/>[html_report.py]"]
end

node_user(("CLI User"))
node_whois_service{{"WHOIS Service"}}
node_dns_service{{"DNS Service"}}
node_nvd{{"NVD API"}}

node_user -->|"starts scan"| node_cli
node_cli -->|"runs lookup"| node_whois
node_cli -->|"runs enumeration"| node_dns
node_cli -->|"runs enumeration"| node_subdomains
node_whois -->|"queries"| node_whois_service
node_dns -->|"resolves records"| node_dns_service
node_subdomains -->|"resolves candidates"| node_dns_service
node_cli -->|"runs scan"| node_ports
node_cli -->|"detects banners"| node_services
node_cli -->|"looks up CVEs"| node_cve
node_cve -->|"queries API"| node_nvd
node_cli -->|"classifies risks"| node_classifier
node_classifier -->|"trains from"| node_dataset
node_cli -->|"generates report"| node_json_report
node_cli -->|"generates report"| node_html_report

click node_cli "https://github.com/imranansari033/autorecon/blob/main/main.py"
click node_whois "https://github.com/imranansari033/autorecon/blob/main/core/passive/whois_enum.py"
click node_dns "https://github.com/imranansari033/autorecon/blob/main/core/passive/dns_enum.py"
click node_subdomains "https://github.com/imranansari033/autorecon/blob/main/core/passive/subdomain_enum.py"
click node_ports "https://github.com/imranansari033/autorecon/blob/main/core/active/port_scanner.py"
click node_services "https://github.com/imranansari033/autorecon/blob/main/core/active/service_detect.py"
click node_cve "https://github.com/imranansari033/autorecon/blob/main/core/vuln/cve_lookup.py"
click node_classifier "https://github.com/imranansari033/autorecon/blob/main/core/vuln/risk_classifier.py"
click node_dataset "https://github.com/imranansari033/autorecon/blob/main/data/cve_dataset.csv"
click node_json_report "https://github.com/imranansari033/autorecon/blob/main/core/report/json_report.py"
click node_html_report "https://github.com/imranansari033/autorecon/blob/main/core/report/html_report.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_user toneBlue
class node_whois,node_dns,node_subdomains toneAmber
class node_ports,node_services,node_nvd toneMint
class node_cve,node_classifier,node_dataset,node_json_report,node_html_report toneRose
class node_whois_service,node_dns_service toneIndigo
```

## Components

### Orchestration

- [Scan Coordinator](https://github.com/imranansari033/autorecon/blob/main/main.py): `main.py`

### Passive Recon

- [WHOIS Lookup](https://github.com/imranansari033/autorecon/blob/main/core/passive/whois_enum.py): `core/passive/whois_enum.py`
- [DNS Enumeration](https://github.com/imranansari033/autorecon/blob/main/core/passive/dns_enum.py): `core/passive/dns_enum.py`
- [Subdomain Enumeration](https://github.com/imranansari033/autorecon/blob/main/core/passive/subdomain_enum.py): `core/passive/subdomain_enum.py`

### Active Scanning

- [Port Scanner](https://github.com/imranansari033/autorecon/blob/main/core/active/port_scanner.py): `core/active/port_scanner.py`
- [Service Detection](https://github.com/imranansari033/autorecon/blob/main/core/active/service_detect.py): `core/active/service_detect.py`

### Assessment and Reporting

- [CVE Lookup](https://github.com/imranansari033/autorecon/blob/main/core/vuln/cve_lookup.py): `core/vuln/cve_lookup.py`
- [Risk Classifier](https://github.com/imranansari033/autorecon/blob/main/core/vuln/risk_classifier.py): `core/vuln/risk_classifier.py`
- [CVE Dataset](https://github.com/imranansari033/autorecon/blob/main/data/cve_dataset.csv): `data/cve_dataset.csv`
- [JSON Report](https://github.com/imranansari033/autorecon/blob/main/core/report/json_report.py): `core/report/json_report.py`
- [HTML Report](https://github.com/imranansari033/autorecon/blob/main/core/report/html_report.py): `core/report/html_report.py`

### Other components

- **CLI User**
- **WHOIS Service**
- **DNS Service**
- **NVD API**

## Connections

- CLI User → Scan Coordinator: starts scan (evidence: `main.py`)
- Scan Coordinator → WHOIS Lookup: runs lookup (evidence: `main.py`)
- Scan Coordinator → DNS Enumeration: runs enumeration (evidence: `main.py`)
- Scan Coordinator → Subdomain Enumeration: runs enumeration (evidence: `main.py`)
- WHOIS Lookup → WHOIS Service: queries (evidence: `core/passive/whois_enum.py`)
- DNS Enumeration → DNS Service: resolves records (evidence: `core/passive/dns_enum.py`)
- Subdomain Enumeration → DNS Service: resolves candidates (evidence: `core/passive/subdomain_enum.py`)
- Scan Coordinator → Port Scanner: runs scan (evidence: `main.py`)
- Scan Coordinator → Service Detection: detects banners (evidence: `main.py`)
- Scan Coordinator → CVE Lookup: looks up CVEs (evidence: `main.py`)
- CVE Lookup → NVD API: queries API (evidence: `core/vuln/cve_lookup.py`)
- Scan Coordinator → Risk Classifier: classifies risks (evidence: `main.py`)
- Risk Classifier → CVE Dataset: trains from (evidence: `core/vuln/risk_classifier.py`)
- Scan Coordinator → JSON Report: generates report (evidence: `main.py`)
- Scan Coordinator → HTML Report: generates report (evidence: `main.py`)
