How md-zakiur-rahman/atlas works
ATLAS is a Windows-focused defensive monitoring desktop application. In normal mode, the launcher starts host monitors and analysis services, which feed telemetry through the event bus for rule, risk, and ML assessment; detections can drive containment and alerts, while results appear in the analyst dashboard and persistence layer. Separate user-facing branches cover password/MFA and optional passkeys, vault encryption, and incident reporting. The README documents these capabilities and the high-level flow; unsampled modules are represented at their supported directory or file paths, without asserting their internal wiring.
Main entry points: event_bus.py Event Bus · app.py Analyst Dashboard · main.py Runtime Launcher · threat_engine.py Threat Engine
Components 28
Monitoring Runtime
- Runtime Launcher
main.py - File Monitor
monitor/file_monitor.py - Process Monitor
monitor/process_monitor.py - Network Monitor
monitor/network_monitor.py - USB Monitor
monitor/usb_monitor.py - Event Bus
monitor/event_bus.py
Threat Analysis
- Feature Extraction
monitor/feature_extractor.py - Detection Rules
monitor/rules.py - Risk Scoring
monitor/risk_engine.py - Anomaly Detection
monitor/ml_detector.py - Threat Engine
monitor/threat_engine.py
Response and State
- Automated Response
monitor/response_engine.py - Alert Delivery
monitor/alert_manager.py - Runtime State
core/runtime_state.py - Persistence
database/db_manager.py
Identity and Vault
- Password and OTP
auth/otp_manager.py - Passkey Pairing
auth/biometric_manager.py - Encryption Service
core/crypto_service.py - Vault
core/vault.py - Email Delivery
notifications/email_sender.py
API and Analyst UI
- Analyst Dashboard
dashboard/app.py - Reports and Views
dashboard/report_tab.py - Flask API
api/flask_app.py
Other components
- Analyst
- Monitored Host
- Supabase
- User
- Email Provider
Connections 38
- Runtime Launcher → File Monitor: starts
main.py - Runtime Launcher → Process Monitor: starts
main.py - Runtime Launcher → Network Monitor: starts
main.py - Runtime Launcher → USB Monitor: starts
main.py - File Monitor → Event Bus: publishes telemetry
- Process Monitor → Event Bus: publishes telemetry
- Network Monitor → Event Bus: publishes telemetry
monitor/network_monitor.py - USB Monitor → Event Bus: publishes telemetry
- Event Bus → Threat Engine: dispatches events
monitor/threat_engine.py - Event Bus → Feature Extraction: feeds features
- Event Bus → Risk Scoring: feeds scoring
monitor/risk_engine.py - Threat Engine → Detection Rules: evaluates
monitor/threat_engine.py - Threat Engine → Alert Delivery: dispatches alerts
monitor/threat_engine.py - Feature Extraction → Anomaly Detection: extracts baseline
- Anomaly Detection → Event Bus: publishes anomalies
- Threat Engine → Automated Response: triggers response
- Automated Response → Runtime State: updates containment
monitor/response_engine.py - Automated Response → Vault: locks vault
monitor/response_engine.py - Automated Response → Email Delivery: sends alerts
monitor/response_engine.py - Alert Delivery → Runtime State: records alerts
- Event Bus → Persistence: logs events
database/db_manager.py - Persistence → Supabase: persists records
- Analyst → Analyst Dashboard: uses
- Analyst Dashboard → Runtime State: reads runtime state
dashboard/app.py - Analyst Dashboard → Reports and Views: opens views
dashboard/app.py - Analyst Dashboard → Encryption Service: requests encryption
- Encryption Service → Vault: delegates vault operations
core/crypto_service.py - Analyst → Flask API: uses authentication
- Flask API → Password and OTP: routes MFA
api/flask_app.py - Flask API → Passkey Pairing: routes passkeys
api/flask_app.py - Flask API → Vault: requests remote lock
- Password and OTP → Email Provider: sends OTP
- Email Delivery → Email Provider: delivers notifications
- User → Analyst Dashboard: signs in
- Monitored Host → File Monitor: provides activity
- Monitored Host → Process Monitor: provides activity
- Monitored Host → Network Monitor: provides activity
- Monitored Host → USB Monitor: provides activity