How tonytrapper/automate-dfir works
DFIR AI is an offline Windows-forensics analysis tool: a user supplies Hayabusa exports, snapshots, folders, or ZIP evidence; the CLI ingests and normalizes inputs, applies deterministic detections and temporal correlations, optionally requests local Ollama hypotheses, and writes traceable preliminary reports. Windows acquisition and direct EVTX processing are separate supported branches. The README documents several capabilities whose implementation was not sampled; those links are shown only where documented, and unsampled internals are not inferred.
Main entry points: main.py Analysis CLI · ingest.py Ingest and normalize · ai.py AI review · report.py Report generation
Components 13
Evidence acquisition
- Windows collector
collectors/Collect-WindowsEvidence.ps1 - Evidence ZIP
Ingestion and analysis
- Analysis CLI
main.py - Ingest and normalize
dfir_ia/ingest.py - Events and snapshots
dfir_ia/ingest.py - Rules and correlation
dfir_ia/detect.py - Findings
dfir_ia/detect.py
Optional enrichment
- AI review
dfir_ia/ai.py
Reporting and traceability
- Report generation
dfir_ia/report.py - Reports and timeline
dfir_ia/report.py
Other components
- Analyst
- Hayabusa
- Ollama local
Connections 18
- Analyst → Windows collector: runs acquisition
README.md - Windows collector → Evidence ZIP: packages evidence
README.md - Analyst → Analysis CLI: provides inputs
README.md - Analysis CLI → Ingest and normalize: loads sources
main.py - Ingest and normalize → Hayabusa: invokes for EVTX
dfir_ia/ingest.py - Hayabusa → Ingest and normalize: supplies timeline
dfir_ia/ingest.py - Ingest and normalize → Events and snapshots: normalizes inputs
dfir_ia/ingest.py - Analysis CLI → Rules and correlation: runs detections
main.py - Events and snapshots → Rules and correlation: analyzes events
main.py - Rules and correlation → Findings: returns findings
dfir_ia/detect.py - Analysis CLI → AI review: requests optional review
main.py - Findings → AI review: summarizes findings
dfir_ia/ai.py - AI review → Ollama local: posts locally
dfir_ia/ai.py - AI review → Analysis CLI: returns hypotheses
dfir_ia/ai.py - Analysis CLI → Report generation: builds reports
main.py - Findings → Report generation: includes findings
main.py - Events and snapshots → Report generation: includes timeline and manifest
main.py - Report generation → Reports and timeline: writes outputs
dfir_ia/report.py