How valorz1/hookline works
HookLine analyzes suspicious emails through one shared pipeline: parse the message, extract observables, check for red flags, optionally query VirusTotal, then score the evidence into a verdict. Users can start that workflow from the terminal, a web upload, or a reporting inbox. The web app also streams VirusTotal progress to the result page. The README documents inbox OAuth and VT caching; sampled source shows the main analysis, web routes, and lookup implementation, but not the full inbox or browser UI internals.
Main entry points: pipeline.py Analysis orchestrator · app.py Web upload · virustotal.py VirusTotal lookup · main.py Terminal CLI
Components 17
Email intake
- Email parser
analyser/parser.py
Analysis pipeline
- Analysis orchestrator
analyser/pipeline.py - Observable extraction
analyser/observables.py - Red-flag checks
analyser/checks.py - Verdict scoring
analyser/verdict.py
Threat intelligence
- Lookup selection
analyser/virustotal.py - VirusTotal lookup
analyser/virustotal.py - Lookup cache
analyser/virustotal.py
User interfaces
- Terminal CLI
main.py - Web upload
app.py - Web views
templates - Browser behavior
static/hookline.js - Inbox processor
inbox.py
Other components
- Email submitter
- Reporting mailbox
- Browser user
- VirusTotal service
Connections 23
- Email submitter → Terminal CLI: runs analysis
README.md - Email submitter → Web upload: uploads email
README.md - Email submitter → Reporting mailbox: forwards report
README.md - Browser user → Web upload: submits email
README.md - Reporting mailbox → Inbox processor: provides reports
inbox.py - Terminal CLI → Email parser: reads email
main.py - Terminal CLI → Analysis orchestrator: runs analysis
main.py - Web upload → Email parser: parses upload
app.py - Web upload → Analysis orchestrator: runs quick checks
app.py - Web upload → Lookup selection: selects targets
app.py - Web upload → Web views: renders views
app.py - Browser behavior → Web upload: receives live events
static/hookline.js - Inbox processor → Email parser: parses attachment
inbox.py - Inbox processor → Analysis orchestrator: runs analysis
inbox.py - Analysis orchestrator → Observable extraction: extracts evidence
analyser/pipeline.py - Analysis orchestrator → Red-flag checks: runs checks
analyser/pipeline.py - Red-flag checks → Observable extraction: uses URL helpers
analyser/checks.py - Analysis orchestrator → Lookup selection: selects lookups
analyser/pipeline.py - Analysis orchestrator → VirusTotal lookup: queries targets
analyser/pipeline.py - Analysis orchestrator → Verdict scoring: scores findings
analyser/pipeline.py - Verdict scoring → Red-flag checks: formats findings
analyser/verdict.py - VirusTotal lookup → Lookup cache: reads and writes
README.md - VirusTotal lookup → VirusTotal service: requests intelligence
analyser/virustotal.py