How flipforensics/aift works
AIFT is a local forensic-triage application with browser, CLI, REST API, and MCP interfaces. Its main workflow discovers and hashes evidence, parses selected Windows/Linux artifacts, analyzes parsed data with a configured AI provider, and produces reports and exports for analyst review. The graph also shows profiles, multi-image analysis, chat, and audit/case management. Several relationships are documented in the README or referenced by the SOURCE INDEX; unsampled subsystem internals are represented conservatively.
Main entry points: engine.py Automation engine · handlers.py Browser UI · discovery.py Evidence discovery · aift_cli.py CLI
Components 21
User interfaces
- Browser UI
app/routes/handlers.py - CLI
aift_cli.py - REST API
app/routes/automation.py - MCP server
app/automation/mcp_server.py - Automation engine
app/automation/engine.py
Evidence and selection
- Evidence discovery
app/automation/discovery.py - Archive handling
app/evidence/archives.py - Evidence hashing
app/utils/hasher.py - Artifact profiles
app/utils/artifact_profiles.py - Artifact registry
app/parser/registry.py
Parsing and analysis
- Dissect parser
app/parser/core.py - Forensic analysis
app/analyzer/core.py - Multi-image analysis
app/analyzer/multi_image.py - AI providers
app/ai_providers/base.py
Review and outputs
- HTML reports
app/reporter/generator.py - JSON export
app/automation/json_export.py - Results chat
app/chat/manager.py
Shared services
- Case management
app/logging/case_manager.py - Audit logging
app/logging/audit.py - Configuration
app/utils/config.py
Other components
- DFIR analyst
Connections 26
- DFIR analyst → Browser UI: uses
- DFIR analyst → CLI: uses
- DFIR analyst → REST API: uses
- DFIR analyst → MCP server: uses
- Browser UI → Evidence discovery: submits evidence
- Browser UI → Artifact profiles: selects artifacts
- CLI → Automation engine: runs pipeline
aift_cli.py - REST API → Automation engine: runs pipeline
- MCP server → Automation engine: starts runs
- Automation engine → Evidence discovery: discovers
app/automation/engine.py - Automation engine → Evidence hashing: hashes evidence
app/automation/engine.py - Automation engine → Dissect parser: parses artifacts
app/automation/engine.py - Automation engine → Forensic analysis: analyzes data
app/automation/engine.py - Automation engine → HTML reports: generates report
app/automation/engine.py - Automation engine → JSON export: exports JSON
app/automation/engine.py - Automation engine → Case management: manages cases
app/automation/engine.py - Automation engine → Audit logging: records audit
app/automation/engine.py - Automation engine → Configuration: loads settings
app/automation/engine.py - Evidence discovery → Archive handling: opens archives
- Dissect parser → Artifact registry: uses registry
app/parser/core.py - Artifact profiles → Artifact registry: resolves artifacts
app/utils/artifact_profiles.py - Forensic analysis → AI providers: requests analysis
app/analyzer/core.py - Automation engine → Multi-image analysis: analyzes images
- Browser UI → Results chat: chats on results
- Results chat → Audit logging: logs activity
app/chat/manager.py - HTML reports → JSON export: shares normalized data
app/reporter/generator.py