# neatlabs-ai/packet-capture-analyzer architecture

> Architecture diagram of the GitHub repository neatlabs-ai/packet-capture-analyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/neatlabs-ai/packet-capture-analyzer
- Repository: https://github.com/neatlabs-ai/packet-capture-analyzer

## Overview

NeatLabs Packet Capture Analyzer is a Python network-forensics tool for analyzing PCAP/PCAPNG captures through a documented parse, dissect, reconstruct, analyze, detect, score, and report workflow. Users can start a GUI investigation or run the command-line pipeline; results include traffic intelligence, threat findings, and HTML or JSON output. The repository is a single 102 KB Python module, so distinct responsibilities share its path. The workflow and capabilities below follow the README; source excerpts are partial, so internal call details cannot be independently verified.

Main entry points: [`packet_capture_analyzer.py`](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py) (Traffic Analyzer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["Command Line"]
  node_gui["Analysis Dashboard"]
end

subgraph group_inspection["Capture Inspection"]
  node_parser["Capture Parser"]
  node_dissector["Protocol Dissector"]
  node_flows["Flow Reconstruction"]
end

subgraph group_intelligence["Traffic Intelligence"]
  node_traffic["Traffic Analyzer"]
  node_iocs["IOC &amp; DNS/HTTP"]
  node_tls["TLS Inspection"]
end

subgraph group_findings["Threat Assessment"]
  node_detections["Threat Detection"]
  node_risk["Risk Scoring"]
end

subgraph group_presentation["Results &amp; Reporting"]
  node_report["Report Generator"]
  node_html["HTML Report"]
  node_json["JSON Output"]
  node_dashboard["Investigation Summary"]
end

node_analyst(("Analyst"))
node_capture["Capture File"]

node_analyst -->|"runs analysis"| node_cli
node_analyst -->|"starts investigation"| node_gui
node_capture -->|"supplies capture"| node_cli
node_cli -->|"analyzes capture"| node_parser
node_gui -.->|"starts analysis"| node_parser
node_parser -->|"parses into protocols"| node_dissector
node_dissector -->|"feeds reconstruction"| node_flows
node_flows -->|"feeds analysis"| node_traffic
node_traffic -.->|"extracts intelligence"| node_iocs
node_traffic -.->|"inspects encryption"| node_tls
node_traffic -->|"checks threats"| node_detections
node_detections -->|"scores findings"| node_risk
node_risk -->|"provides findings"| node_report
node_report -->|"generates"| node_html
node_report -->|"exports"| node_json
node_report -->|"summarizes analysis"| node_dashboard
node_dashboard -.->|"displays results"| node_gui

click node_cli "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_gui "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_parser "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_dissector "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_flows "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_traffic "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_iocs "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_tls "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_detections "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_risk "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_report "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py"
click node_dashboard "https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.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_gui toneBlue
class node_parser,node_dissector,node_flows toneAmber
class node_traffic,node_iocs,node_tls toneMint
class node_detections,node_risk toneRose
class node_report,node_html,node_json,node_dashboard,node_analyst,node_capture toneIndigo
```

## Components

### User Interfaces

- [Command Line](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`
- [Analysis Dashboard](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`

### Capture Inspection

- [Capture Parser](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`
- [Protocol Dissector](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`
- [Flow Reconstruction](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`

### Traffic Intelligence

- [Traffic Analyzer](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`
- [IOC & DNS/HTTP](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`
- [TLS Inspection](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`

### Threat Assessment

- [Threat Detection](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`
- [Risk Scoring](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`

### Results & Reporting

- [Report Generator](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`
- **HTML Report**
- **JSON Output**
- [Investigation Summary](https://github.com/neatlabs-ai/packet-capture-analyzer/blob/main/packet_capture_analyzer.py): `packet_capture_analyzer.py`

### Other components

- **Analyst**
- **Capture File**

## Connections

- Analyst → Command Line: runs analysis (evidence: `README.md`)
- Analyst → Analysis Dashboard: starts investigation (evidence: `README.md`)
- Capture File → Command Line: supplies capture (evidence: `README.md`)
- Command Line → Capture Parser: analyzes capture (evidence: `README.md`)
- Analysis Dashboard → Capture Parser: starts analysis (evidence: `packet_capture_analyzer.py`)
- Capture Parser → Protocol Dissector: parses into protocols (evidence: `README.md`)
- Protocol Dissector → Flow Reconstruction: feeds reconstruction (evidence: `README.md`)
- Flow Reconstruction → Traffic Analyzer: feeds analysis (evidence: `README.md`)
- Traffic Analyzer → IOC & DNS/HTTP: extracts intelligence (evidence: `packet_capture_analyzer.py`)
- Traffic Analyzer → TLS Inspection: inspects encryption (evidence: `packet_capture_analyzer.py`)
- Traffic Analyzer → Threat Detection: checks threats (evidence: `README.md`)
- Threat Detection → Risk Scoring: scores findings (evidence: `README.md`)
- Risk Scoring → Report Generator: provides findings (evidence: `README.md`)
- Report Generator → HTML Report: generates (evidence: `README.md`)
- Report Generator → JSON Output: exports (evidence: `README.md`)
- Report Generator → Investigation Summary: summarizes analysis (evidence: `README.md`)
- Investigation Summary → Analysis Dashboard: displays results (evidence: `packet_capture_analyzer.py`)
