How jivi001/network-analyzer works
my-sentinel is a terminal network-monitoring and security-analysis tool. Users choose live capture, Nmap scanning, or offline PCAP analysis; packet data is decoded, summarized and checked for threats, then presented and persisted for audit or export. The graph preserves the documented live-capture stages, scanning and forensic branches, plus storage and TUI layers. Edges use README statements and SOURCE INDEX references; unsampled implementation details and less-evidenced wiring are not inferred.
Main entry points: sentinel.py CLI Controller · pipeline.py Detection Pipeline · processor.py Packet Decoder · dashboard.py Live Dashboard
Components 23
Application and UI
- CLI Controller
sentinel.py - Mode Menu
tui/menu.py - Live Dashboard
tui/dashboard.py - History and Result Views
tui/history_view.py - Console Lifecycle
utils/console.py
Capture and Analysis
- Packet Sniffer
core/sniffer.py - Bounded Packet Queue
core/sniffer.py - Packet Decoder
core/processor.py - Traffic Statistics
core/stats.py - Shared Data Models
storage/models.py
Threat Detection
- Detection Pipeline
detection/pipeline.py - Signature Rules
detection/rule_engine.py - Anomaly Detection
detection/anomaly.py - ARP Monitor
detection/arp_monitor.py - Alert Manager
detection/alerts.py
Scanning and Forensics
- Nmap Scanner
core/scanner.py - PCAP Loader
core/pcap_loader.py
Audit and Export
- SQLite Audit Store
storage/database.py - Format Exporter
storage/exporter.py - Data Importer
storage/importer.py
Other components
- Operator
- Network Interface
- Nmap
Connections 29
- Operator → CLI Controller: starts
README.md - CLI Controller → Mode Menu: presents modes
README.md - Mode Menu → Live Dashboard: opens capture
README.md - CLI Controller → Packet Sniffer: starts capture
README.md - Network Interface → Packet Sniffer: supplies packets
README.md - Packet Sniffer → Bounded Packet Queue: enqueues packets
README.md - Bounded Packet Queue → Packet Decoder: feeds worker
README.md - Packet Decoder → Traffic Statistics: updates
README.md - Packet Decoder → Detection Pipeline: evaluates packets
README.md - Detection Pipeline → Signature Rules: evaluates rules
detection/pipeline.py - Detection Pipeline → Anomaly Detection: checks anomalies
detection/pipeline.py - Detection Pipeline → ARP Monitor: checks ARP
detection/pipeline.py - Detection Pipeline → Alert Manager: produces alerts
README.md - Live Dashboard → Traffic Statistics: shows metrics
README.md - Live Dashboard → Alert Manager: shows alerts
README.md - CLI Controller → Nmap Scanner: runs scans
README.md - Nmap Scanner → Nmap: executes scans
README.md - CLI Controller → PCAP Loader: loads captures
README.md - PCAP Loader → Packet Decoder: decodes packets
core/pcap_loader.py - PCAP Loader → Traffic Statistics: aggregates traffic
core/pcap_loader.py - CLI Controller → SQLite Audit Store: persists audit
README.md - CLI Controller → Format Exporter: exports results
README.md - CLI Controller → Data Importer
sentinel.py - CLI Controller → History and Result Views: shows history
README.md - Live Dashboard → Console Lifecycle: renders through
README.md - Packet Decoder → Shared Data Models: uses packet model
core/processor.py - Detection Pipeline → Shared Data Models: uses event models
detection/pipeline.py - Nmap Scanner → Shared Data Models: returns scan models
core/scanner.py - SQLite Audit Store → Shared Data Models: stores records
storage/database.py