How sanchitna06-cell/guardian_ids works
Guardian IDS is a modular desktop network-monitoring and intrusion-detection application. Its main workflow captures traffic on a selected interface, normalizes packets, and distributes packet events to statistics and detection services; detected threats feed threat management, persistence, and GUI/analysis features. A separate simulation mode generates attack traffic into the event bus. The graph reflects documented architecture and indexed or excerpted references; some event-bus wiring and unsampled subsystem internals are not shown as direct calls.
Main entry points: event_bus.py Event Bus · application.py Application Core · analysis_engine.py Analysis Engine · detection_engine.py Detection Engine
Components 23
Desktop Interface
- Dashboard GUI
src/gui/components/dashboard.py - Analysis Dialog
src/gui/dialogs/analysis_dialog.py
Network Capture
- Interface Manager
src/network/interface_manager.py - Capture Controller
src/network/capture_controller.py - Packet Sniffer
src/network/packet_sniffer.py - Packet Parser
src/network/packet_parser.py - Guardian Packet
src/network/packet_models.py
Core Processing
- Application Core
src/core/application.py - Event Bus
src/core/event_bus.py - Statistics Engine
src/core/statistics/statistics_engine.py - Detection Engine
src/core/detection/detection_engine.py - Detector Registry
src/core/detection/detector_registry.py
Threat Services
- Threat Manager
src/core/threats/threat_manager.py - Guardian State
src/core/guardian_state_manager.py - SQLite Persistence
src/core/persistence/persistence_manager.py - Analysis Engine
src/core/analysis/analysis_engine.py - Analysis Report
src/core/analysis/analysis_report.py
Simulation
- Simulation Engine
src/simulation/simulation_engine.py - Attack Factory
src/simulation/attack_factory.py - Attack Implementations
src/simulation/attacks - Packet Generator
src/simulation/packet_generator.py
Other components
- Operator
- Network Traffic
Connections 31
- Operator → Dashboard GUI: operates
README.md - Dashboard GUI → Application Core: starts
src/gui/main_window.py - Application Core → Interface Manager: constructs
src/core/application.py - Application Core → Capture Controller: constructs
src/core/application.py - Application Core → Statistics Engine: constructs
src/core/application.py - Application Core → Detection Engine: constructs
src/core/application.py - Application Core → Threat Manager: constructs
src/core/application.py - Application Core → Simulation Engine: constructs
src/core/application.py - Application Core → Analysis Engine: constructs
src/core/application.py - Capture Controller → Interface Manager: selects interface
src/network/capture_controller.py - Capture Controller → Packet Sniffer: starts capture
src/network/capture_controller.py - Network Traffic → Packet Sniffer: supplies packets
README.md - Packet Sniffer → Packet Parser: forwards packets
README.md - Packet Parser → Guardian Packet: normalizes to
src/network/packet_parser.py - Packet Parser → Event Bus: publishes parsed packets
src/network/packet_parser.py - Event Bus → Statistics Engine: dispatches packets
src/core/statistics/statistics_engine.py - Event Bus → Detection Engine: dispatches packets
README.md - Detection Engine → Detector Registry: loads detectors
src/core/detection/detection_engine.py - Detection Engine → Event Bus: emits threats
src/core/detection/detection_engine.py - Event Bus → Threat Manager: delivers threat events
README.md - Threat Manager → SQLite Persistence: stores history
src/core/threats/threat_manager.py - Analysis Dialog → Analysis Engine: requests analysis
- Analysis Engine → Threat Manager: reads active threats
src/core/analysis/analysis_engine.py - Analysis Engine → Analysis Report: builds report
src/core/analysis/analysis_engine.py - Analysis Engine → Event Bus: publishes report
src/core/analysis/analysis_engine.py - Event Bus → Guardian State: delivers threat events
src/core/guardian_state_manager.py - Event Bus → Simulation Engine: starts simulation
src/simulation/simulation_engine.py - Simulation Engine → Attack Factory: creates attack
src/simulation/simulation_engine.py - Attack Factory → Attack Implementations: selects implementation
src/simulation/attack_factory.py - Attack Implementations → Packet Generator: generates packets
src/simulation/attacks/base_attack.py - Simulation Engine → Event Bus: publishes raw packets
src/simulation/simulation_engine.py