# zakirkun/deep-eye architecture

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

## Overview

Deep Eye is an AI-assisted penetration-testing scanner. The primary workflow accepts a target, performs reconnaissance and scoped crawling, runs vulnerability checks with context-aware payloads, then produces findings and reports for triage, retesting, and notification. Its documented branches include OpenAPI seeding, CVE intelligence, browser and proxy testing, compliance/export support, and multi-provider AI. Relationships are based on the README and SOURCE INDEX references; unsampled subsystem internals are represented conservatively.

Main entry points: [`core/scanner_engine.py`](https://github.com/zakirkun/deep-eye/blob/main/core/scanner_engine.py) (Scanner engine), [`core/vulnerability_scanner.py`](https://github.com/zakirkun/deep-eye/blob/main/core/vulnerability_scanner.py) (Vulnerability scan), [`core/ai_payload_generator.py`](https://github.com/zakirkun/deep-eye/blob/main/core/ai_payload_generator.py) (Payload generation), [`core/report_generator.py`](https://github.com/zakirkun/deep-eye/blob/main/core/report_generator.py) (Reports and exports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scan["Scan orchestration"]
  node_cli["CLI entry<br/>[deep_eye.py]"]
  node_engine["Scanner engine<br/>[scanner_engine.py]"]
  node_scope["Scope controls<br/>[scope_manager.py]"]
  node_state["Scan state"]
end

subgraph group_checks["Recon and checks"]
  node_recon["Recon engine<br/>[recon_engine.py]"]
  node_subdomains["Subdomain scan"]
  node_vulnscan["Vulnerability scan"]
  node_attackmods["Attack modules"]
  node_browser["Browser testing<br/>[smart_tester.py]"]
  node_openapi["OpenAPI ingest<br/>[parser.py]"]
end

subgraph group_ai["AI and intelligence"]
  node_payloads["Payload generation"]
  node_providers["Provider manager"]
  node_provideradapters["Provider adapters"]
  node_cve["CVE intelligence<br/>[cve_matcher.py]"]
end

subgraph group_findings["Findings and reporting"]
  node_triage["AI triage"]
  node_evidence["Evidence summaries"]
  node_reports["Reports and exports"]
  node_diff["Diff and retest<br/>[scan_diff.py]"]
  node_humanreports["Interactive reports"]
end

subgraph group_support["Runtime support"]
  node_http["HTTP client<br/>[http_client.py]"]
  node_notify["Notifications"]
end

node_operator(("Security tester"))

node_operator -->|"starts scan"| node_cli
node_cli -.->|"runs scan"| node_engine
node_engine -->|"checks scope"| node_scope
node_engine -->|"tracks progress"| node_state
node_engine -->|"runs recon"| node_recon
node_engine -->|"scans subdomains"| node_subdomains
node_engine -->|"runs checks"| node_vulnscan
node_vulnscan -->|"dispatches checks"| node_attackmods
node_engine -->|"tests browser"| node_browser
node_engine -.->|"seeds scan"| node_openapi
node_engine -->|"sends requests"| node_http
node_recon -->|"fetches target"| node_http
node_subdomains -->|"uses requests"| node_http
node_vulnscan -->|"requests payloads"| node_payloads
node_payloads -->|"matches CVEs"| node_cve
node_payloads -.->|"generates with AI"| node_providers
node_providers -->|"initializes providers"| node_provideradapters
node_vulnscan -.->|"triages findings"| node_triage
node_vulnscan -.->|"summarizes evidence"| node_evidence
node_engine -.->|"writes reports"| node_reports
node_reports -.->|"presents findings"| node_humanreports
node_reports -.->|"supports retest"| node_diff
node_engine -->|"sends alerts"| node_notify

click node_cli "https://github.com/zakirkun/deep-eye/blob/main/deep_eye.py"
click node_engine "https://github.com/zakirkun/deep-eye/blob/main/core/scanner_engine.py"
click node_scope "https://github.com/zakirkun/deep-eye/blob/main/utils/scope_manager.py"
click node_state "https://github.com/zakirkun/deep-eye/blob/main/core/pentest_state_manager.py"
click node_recon "https://github.com/zakirkun/deep-eye/blob/main/modules/reconnaissance/recon_engine.py"
click node_subdomains "https://github.com/zakirkun/deep-eye/blob/main/core/subdomain_scanner.py"
click node_vulnscan "https://github.com/zakirkun/deep-eye/blob/main/core/vulnerability_scanner.py"
click node_attackmods "https://github.com/zakirkun/deep-eye/tree/main/modules"
click node_browser "https://github.com/zakirkun/deep-eye/blob/main/modules/browser_automation/smart_tester.py"
click node_openapi "https://github.com/zakirkun/deep-eye/blob/main/modules/openapi_ingest/parser.py"
click node_http "https://github.com/zakirkun/deep-eye/blob/main/utils/http_client.py"
click node_payloads "https://github.com/zakirkun/deep-eye/blob/main/core/ai_payload_generator.py"
click node_providers "https://github.com/zakirkun/deep-eye/blob/main/ai_providers/provider_manager.py"
click node_provideradapters "https://github.com/zakirkun/deep-eye/tree/main/ai_providers"
click node_cve "https://github.com/zakirkun/deep-eye/blob/main/modules/cve_intelligence/cve_matcher.py"
click node_triage "https://github.com/zakirkun/deep-eye/tree/main/modules/ai_triage"
click node_evidence "https://github.com/zakirkun/deep-eye/tree/main/modules/evidence_summary"
click node_reports "https://github.com/zakirkun/deep-eye/blob/main/core/report_generator.py"
click node_diff "https://github.com/zakirkun/deep-eye/blob/main/core/scan_diff.py"
click node_notify "https://github.com/zakirkun/deep-eye/blob/main/utils/notification_manager.py"
click node_humanreports "https://github.com/zakirkun/deep-eye/blob/main/modules/reporting/interactive_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_engine,node_scope,node_state toneBlue
class node_recon,node_subdomains,node_vulnscan,node_attackmods,node_browser,node_openapi toneAmber
class node_payloads,node_providers,node_provideradapters,node_cve toneMint
class node_triage,node_evidence,node_reports,node_diff,node_humanreports toneRose
class node_http,node_notify,node_operator toneIndigo
```

## Components

### Scan orchestration

- [CLI entry](https://github.com/zakirkun/deep-eye/blob/main/deep_eye.py): `deep_eye.py`
- [Scanner engine](https://github.com/zakirkun/deep-eye/blob/main/core/scanner_engine.py): `core/scanner_engine.py`
- [Scope controls](https://github.com/zakirkun/deep-eye/blob/main/utils/scope_manager.py): `utils/scope_manager.py`
- [Scan state](https://github.com/zakirkun/deep-eye/blob/main/core/pentest_state_manager.py): `core/pentest_state_manager.py`

### Recon and checks

- [Recon engine](https://github.com/zakirkun/deep-eye/blob/main/modules/reconnaissance/recon_engine.py): `modules/reconnaissance/recon_engine.py`
- [Subdomain scan](https://github.com/zakirkun/deep-eye/blob/main/core/subdomain_scanner.py): `core/subdomain_scanner.py`
- [Vulnerability scan](https://github.com/zakirkun/deep-eye/blob/main/core/vulnerability_scanner.py): `core/vulnerability_scanner.py`
- [Attack modules](https://github.com/zakirkun/deep-eye/tree/main/modules): `modules`
- [Browser testing](https://github.com/zakirkun/deep-eye/blob/main/modules/browser_automation/smart_tester.py): `modules/browser_automation/smart_tester.py`
- [OpenAPI ingest](https://github.com/zakirkun/deep-eye/blob/main/modules/openapi_ingest/parser.py): `modules/openapi_ingest/parser.py`

### AI and intelligence

- [Payload generation](https://github.com/zakirkun/deep-eye/blob/main/core/ai_payload_generator.py): `core/ai_payload_generator.py`
- [Provider manager](https://github.com/zakirkun/deep-eye/blob/main/ai_providers/provider_manager.py): `ai_providers/provider_manager.py`
- [Provider adapters](https://github.com/zakirkun/deep-eye/tree/main/ai_providers): `ai_providers`
- [CVE intelligence](https://github.com/zakirkun/deep-eye/blob/main/modules/cve_intelligence/cve_matcher.py): `modules/cve_intelligence/cve_matcher.py`

### Findings and reporting

- [AI triage](https://github.com/zakirkun/deep-eye/tree/main/modules/ai_triage): `modules/ai_triage`
- [Evidence summaries](https://github.com/zakirkun/deep-eye/tree/main/modules/evidence_summary): `modules/evidence_summary`
- [Reports and exports](https://github.com/zakirkun/deep-eye/blob/main/core/report_generator.py): `core/report_generator.py`
- [Diff and retest](https://github.com/zakirkun/deep-eye/blob/main/core/scan_diff.py): `core/scan_diff.py`
- [Interactive reports](https://github.com/zakirkun/deep-eye/blob/main/modules/reporting/interactive_report.py): `modules/reporting/interactive_report.py`

### Runtime support

- [HTTP client](https://github.com/zakirkun/deep-eye/blob/main/utils/http_client.py): `utils/http_client.py`
- [Notifications](https://github.com/zakirkun/deep-eye/blob/main/utils/notification_manager.py): `utils/notification_manager.py`

### Other components

- **Security tester**

## Connections

- Security tester → CLI entry: starts scan
- CLI entry → Scanner engine: runs scan
- Scanner engine → Scope controls: checks scope (evidence: `core/scanner_engine.py`)
- Scanner engine → Scan state: tracks progress (evidence: `core/scanner_engine.py`)
- Scanner engine → Recon engine: runs recon (evidence: `core/scanner_engine.py`)
- Scanner engine → Subdomain scan: scans subdomains (evidence: `core/scanner_engine.py`)
- Scanner engine → Vulnerability scan: runs checks (evidence: `core/scanner_engine.py`)
- Vulnerability scan → Attack modules: dispatches checks (evidence: `core/vulnerability_scanner.py`)
- Scanner engine → Browser testing: tests browser (evidence: `core/scanner_engine.py`)
- Scanner engine → OpenAPI ingest: seeds scan
- Scanner engine → HTTP client: sends requests (evidence: `core/scanner_engine.py`)
- Recon engine → HTTP client: fetches target (evidence: `modules/reconnaissance/recon_engine.py`)
- Subdomain scan → HTTP client: uses requests (evidence: `core/subdomain_scanner.py`)
- Vulnerability scan → Payload generation: requests payloads (evidence: `core/scanner_engine.py`)
- Payload generation → CVE intelligence: matches CVEs (evidence: `core/ai_payload_generator.py`)
- Payload generation → Provider manager: generates with AI
- Provider manager → Provider adapters: initializes providers (evidence: `ai_providers/provider_manager.py`)
- Vulnerability scan → AI triage: triages findings
- Vulnerability scan → Evidence summaries: summarizes evidence
- Scanner engine → Reports and exports: writes reports
- Reports and exports → Interactive reports: presents findings
- Reports and exports → Diff and retest: supports retest
- Scanner engine → Notifications: sends alerts (evidence: `core/scanner_engine.py`)
