How 7yph0n/ai-driven-soc-investigator works
This is an AI-assisted SOC investigation pipeline. It polls Wazuh alerts, then iterates between LLM decisions and controlled endpoint tools until it reaches a verdict; on conclusion it writes a report and creates an osTicket incident. The map preserves alert intake, investigation and evidence collection, shared state, and reporting/ticketing. Tool excerpts show Velociraptor collection details, but not every action tool; those capabilities are represented at the tools module without asserting its unsampled internal calls.
Main entry points: core.py Investigation Loop · parser.py Decision Parser · state_manager.py Investigation State · wazuh_poller_backend.py Alert Poller
Components 13
Alert Intake
- SOC Entrypoint
main.py - Alert Poller
wazuh_poller_backend.py
AI Investigation
- Investigation Loop
core.py - Investigation Prompts
prompts.py - LLM Reasoning
Agents/LLM.py - Investigation State
state_manager.py - Decision Parser
Agents/parser.py
Endpoint Evidence
- Investigation Tools
Tools/tools.py
Incident Outcomes
- Report Generator
report_generator.py - Ticket Creator
Agents/ticket_raiser.py
Other components
- Wazuh Indexer
- Velociraptor
- osTicket
Connections 14
- SOC Entrypoint → Investigation Loop: starts
main.py - Investigation Loop → Alert Poller: gets alerts
core.py - Alert Poller → Wazuh Indexer: queries alerts
wazuh_poller_backend.py - Investigation Loop → Investigation Prompts: builds prompts
core.py - Investigation Loop → Investigation State: updates state
core.py - Investigation Loop → LLM Reasoning: requests analysis
core.py - LLM Reasoning → Investigation State: reads state
Agents/LLM.py - Investigation Loop → Decision Parser: dispatches decisions
core.py - Decision Parser → Investigation State: records evidence
Agents/parser.py - Decision Parser → Investigation Tools: executes tool
Agents/parser.py - Investigation Tools → Velociraptor: collects evidence
Tools/tools.py - Investigation Loop → Report Generator: writes report
core.py - Investigation Loop → Ticket Creator: creates incident
core.py - Ticket Creator → osTicket: posts ticket
Agents/ticket_raiser.py