How zakirkun/deep-eye works
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: scanner_engine.py Scanner engine · vulnerability_scanner.py Vulnerability scan · ai_payload_generator.py Payload generation · report_generator.py Reports and exports
Components 22
Scan orchestration
- CLI entry
deep_eye.py - Scanner engine
core/scanner_engine.py - Scope controls
utils/scope_manager.py - Scan state
core/pentest_state_manager.py
Recon and checks
- Recon engine
modules/reconnaissance/recon_engine.py - Subdomain scan
core/subdomain_scanner.py - Vulnerability scan
core/vulnerability_scanner.py - Attack modules
modules - Browser testing
modules/browser_automation/smart_tester.py - OpenAPI ingest
modules/openapi_ingest/parser.py
AI and intelligence
- Payload generation
core/ai_payload_generator.py - Provider manager
ai_providers/provider_manager.py - Provider adapters
ai_providers - CVE intelligence
modules/cve_intelligence/cve_matcher.py
Findings and reporting
- AI triage
modules/ai_triage - Evidence summaries
modules/evidence_summary - Reports and exports
core/report_generator.py - Diff and retest
core/scan_diff.py - Interactive reports
modules/reporting/interactive_report.py
Runtime support
- HTTP client
utils/http_client.py - Notifications
utils/notification_manager.py
Other components
- Security tester
Connections 23
- Security tester → CLI entry: starts scan
- CLI entry → Scanner engine: runs scan
- Scanner engine → Scope controls: checks scope
core/scanner_engine.py - Scanner engine → Scan state: tracks progress
core/scanner_engine.py - Scanner engine → Recon engine: runs recon
core/scanner_engine.py - Scanner engine → Subdomain scan: scans subdomains
core/scanner_engine.py - Scanner engine → Vulnerability scan: runs checks
core/scanner_engine.py - Vulnerability scan → Attack modules: dispatches checks
core/vulnerability_scanner.py - Scanner engine → Browser testing: tests browser
core/scanner_engine.py - Scanner engine → OpenAPI ingest: seeds scan
- Scanner engine → HTTP client: sends requests
core/scanner_engine.py - Recon engine → HTTP client: fetches target
modules/reconnaissance/recon_engine.py - Subdomain scan → HTTP client: uses requests
core/subdomain_scanner.py - Vulnerability scan → Payload generation: requests payloads
core/scanner_engine.py - Payload generation → CVE intelligence: matches CVEs
core/ai_payload_generator.py - Payload generation → Provider manager: generates with AI
- Provider manager → Provider adapters: initializes providers
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
core/scanner_engine.py