# wahyubudiprastowo/agenticaisoc architecture

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

- Interactive diagram: https://gitdiagram.com/wahyubudiprastowo/agenticaisoc
- Repository: https://github.com/wahyubudiprastowo/agenticaisoc

## Overview

This is a multi-service agentic SOC: security events enter through Syslog, M365/Defender, or Wazuh; SOC Core normalizes, filters, enriches, detects, and persists findings; Hermes adds asynchronous AI analysis, with Jev providing reasoning and Qdrant-backed memory; the dashboard presents findings and analytics. The graph preserves the documented threat-intelligence and detection branches. Some subsystem links rely on README-level architecture because their implementation was not excerpted.

Main entry points: [`hermes/app/worker.py`](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/worker.py) (Hermes orchestrator), [`soc-core/app/worker.py`](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/worker.py) (SOC event worker), [`soc-core/app/redis_client.py`](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/redis_client.py) (Raw event queue), [`m365-collector/app/main.py`](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/m365-collector/app/main.py) (M365 collector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Event collection"]
  node_syslog["Syslog collector<br/>[main.py]"]
  node_m365["M365 collector<br/>[main.py]"]
  node_m365auth["Microsoft OAuth<br/>[auth.py]"]
end

subgraph group_soc["SOC processing"]
  node_wazuhclient["Wazuh polling<br/>[wazuh_client.py]"]
  node_rawqueue["Raw event queue<br/>[redis_client.py]"]
  node_socworker["SOC event worker<br/>[worker.py]"]
  node_detections["Detection rules<br/>[detections.py]"]
  node_taxonomy["Detection taxonomy<br/>[taxonomy.py]"]
  node_socdb[("Events and findings<br/>[db.py]")]
  node_filteredqueue["Filtered event queue<br/>[redis_client.py]"]
end

subgraph group_intel["Threat intelligence"]
  node_intelapi["Threat intel API<br/>[main.py]"]
  node_providers["IOC providers<br/>[providers.py]"]
  node_intelfeeds["Threat intel feeds<br/>[cyfirma_feeds.py]"]
end

subgraph group_ai["AI enrichment"]
  node_hermes["Hermes orchestrator<br/>[worker.py]"]
  node_skills["Detection skills<br/>[skill_loader.py]"]
  node_agents["Analysis agents<br/>[agents.py]"]
  node_jevclient["Jev reasoning client<br/>[jev_client.py]"]
  node_jev["Jev reasoning service<br/>[reasoning.py]"]
  node_memory["AI memory<br/>[memory.py]"]
  node_hermesdb[("Finding enrichment<br/>[db.py]")]
end

subgraph group_presentation["Findings interface"]
  node_dashboard["Dashboard API<br/>[main.py]"]
  node_aggregations["Finding analytics<br/>[aggregations.py]"]
end

node_securitysources(("Security event sources"))
node_redis["Redis"]
node_postgres[("PostgreSQL")]
node_qdrant[("Qdrant")]
node_analyst(("SOC analyst"))

node_securitysources -->|"send syslog"| node_syslog
node_syslog -->|"normalize and enqueue"| node_rawqueue
node_securitysources -->|"provide activity"| node_m365
node_m365 -->|"authenticate"| node_m365auth
node_m365 -->|"normalize and enqueue"| node_rawqueue
node_securitysources -->|"provide alerts"| node_wazuhclient
node_wazuhclient -->|"poll events"| node_socworker
node_rawqueue -->|"consume events"| node_socworker
node_socworker -->|"classify events"| node_detections
node_detections -->|"resolve categories"| node_taxonomy
node_socworker -->|"persist findings"| node_socdb
node_socworker -->|"enrich indicators"| node_intelapi
node_intelapi -->|"query providers"| node_providers
node_intelapi -->|"serve feed data"| node_intelfeeds
node_socworker -->|"queue filtered events"| node_filteredqueue
node_filteredqueue -->|"claim events"| node_hermes
node_hermes -->|"load skills"| node_skills
node_hermes -->|"run analysis"| node_agents
node_hermes -->|"request reasoning"| node_jevclient
node_jevclient -->|"call reasoning API"| node_jev
node_hermes -->|"use memory"| node_memory
node_hermes -->|"save enrichment"| node_hermesdb
node_socdb -->|"serve findings"| node_dashboard
node_dashboard -->|"aggregate results"| node_aggregations
node_dashboard -->|"present findings"| node_analyst
node_rawqueue -.->|"store queue data"| node_redis
node_filteredqueue -.->|"store queue data"| node_redis
node_socdb -.->|"persist records"| node_postgres
node_hermesdb -.->|"persist enrichment"| node_postgres
node_memory -.->|"retrieve memory"| node_qdrant

click node_syslog "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/syslog-collector/app/main.py"
click node_m365 "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/m365-collector/app/main.py"
click node_m365auth "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/m365-collector/app/auth.py"
click node_wazuhclient "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/wazuh_client.py"
click node_rawqueue "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/redis_client.py"
click node_socworker "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/worker.py"
click node_detections "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/detections.py"
click node_taxonomy "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/shared/taxonomy.py"
click node_socdb "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/db.py"
click node_filteredqueue "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/redis_client.py"
click node_intelapi "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/threat-intel/app/main.py"
click node_providers "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/threat-intel/app/providers.py"
click node_intelfeeds "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/threat-intel/app/cyfirma_feeds.py"
click node_hermes "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/worker.py"
click node_skills "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/skill_loader.py"
click node_agents "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/agents.py"
click node_jevclient "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/jev_client.py"
click node_jev "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/jev-client/app/reasoning.py"
click node_memory "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/memory.py"
click node_hermesdb "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/db.py"
click node_dashboard "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/dashboard/app/main.py"
click node_aggregations "https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/dashboard/app/aggregations.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_syslog,node_m365,node_m365auth toneBlue
class node_wazuhclient,node_rawqueue,node_socworker,node_detections,node_taxonomy,node_socdb,node_filteredqueue,node_redis,node_postgres,node_qdrant toneAmber
class node_intelapi,node_providers,node_intelfeeds toneMint
class node_hermes,node_skills,node_agents,node_jevclient,node_jev,node_memory,node_hermesdb toneRose
class node_dashboard,node_aggregations,node_securitysources,node_analyst toneIndigo
```

## Components

### Event collection

- [Syslog collector](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/syslog-collector/app/main.py): `syslog-collector/app/main.py`
- [M365 collector](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/m365-collector/app/main.py): `m365-collector/app/main.py`
- [Microsoft OAuth](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/m365-collector/app/auth.py): `m365-collector/app/auth.py`

### SOC processing

- [Wazuh polling](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/wazuh_client.py): `soc-core/app/wazuh_client.py`
- [Raw event queue](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/redis_client.py): `soc-core/app/redis_client.py`
- [SOC event worker](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/worker.py): `soc-core/app/worker.py`
- [Detection rules](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/detections.py): `soc-core/app/detections.py`
- [Detection taxonomy](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/shared/taxonomy.py): `shared/taxonomy.py`
- [Events and findings](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/db.py): `soc-core/app/db.py`
- [Filtered event queue](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/soc-core/app/redis_client.py): `soc-core/app/redis_client.py`

### Threat intelligence

- [Threat intel API](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/threat-intel/app/main.py): `threat-intel/app/main.py`
- [IOC providers](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/threat-intel/app/providers.py): `threat-intel/app/providers.py`
- [Threat intel feeds](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/threat-intel/app/cyfirma_feeds.py): `threat-intel/app/cyfirma_feeds.py`

### AI enrichment

- [Hermes orchestrator](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/worker.py): `hermes/app/worker.py`
- [Detection skills](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/skill_loader.py): `hermes/app/skill_loader.py`
- [Analysis agents](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/agents.py): `hermes/app/agents.py`
- [Jev reasoning client](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/jev_client.py): `hermes/app/jev_client.py`
- [Jev reasoning service](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/jev-client/app/reasoning.py): `jev-client/app/reasoning.py`
- [AI memory](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/memory.py): `hermes/app/memory.py`
- [Finding enrichment](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/hermes/app/db.py): `hermes/app/db.py`

### Findings interface

- [Dashboard API](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/dashboard/app/main.py): `dashboard/app/main.py`
- [Finding analytics](https://github.com/wahyubudiprastowo/agenticaisoc/blob/main/dashboard/app/aggregations.py): `dashboard/app/aggregations.py`

### Other components

- **Security event sources**
- **Redis**
- **PostgreSQL**
- **Qdrant**
- **SOC analyst**

## Connections

- Security event sources → Syslog collector: send syslog
- Syslog collector → Raw event queue: normalize and enqueue (evidence: `syslog-collector/app/main.py`)
- Security event sources → M365 collector: provide activity
- M365 collector → Microsoft OAuth: authenticate (evidence: `m365-collector/app/main.py`)
- M365 collector → Raw event queue: normalize and enqueue (evidence: `m365-collector/app/main.py`)
- Security event sources → Wazuh polling: provide alerts
- Wazuh polling → SOC event worker: poll events (evidence: `soc-core/app/worker.py`)
- Raw event queue → SOC event worker: consume events (evidence: `soc-core/app/worker.py`)
- SOC event worker → Detection rules: classify events (evidence: `soc-core/app/worker.py`)
- Detection rules → Detection taxonomy: resolve categories (evidence: `soc-core/app/detections.py`)
- SOC event worker → Events and findings: persist findings (evidence: `soc-core/app/worker.py`)
- SOC event worker → Threat intel API: enrich indicators
- Threat intel API → IOC providers: query providers (evidence: `threat-intel/app/main.py`)
- Threat intel API → Threat intel feeds: serve feed data (evidence: `threat-intel/app/main.py`)
- SOC event worker → Filtered event queue: queue filtered events (evidence: `soc-core/app/worker.py`)
- Filtered event queue → Hermes orchestrator: claim events
- Hermes orchestrator → Detection skills: load skills (evidence: `hermes/app/worker.py`)
- Hermes orchestrator → Analysis agents: run analysis (evidence: `hermes/app/worker.py`)
- Hermes orchestrator → Jev reasoning client: request reasoning (evidence: `hermes/app/worker.py`)
- Jev reasoning client → Jev reasoning service: call reasoning API
- Hermes orchestrator → AI memory: use memory (evidence: `hermes/app/worker.py`)
- Hermes orchestrator → Finding enrichment: save enrichment (evidence: `hermes/app/worker.py`)
- Events and findings → Dashboard API: serve findings
- Dashboard API → Finding analytics: aggregate results (evidence: `dashboard/app/main.py`)
- Dashboard API → SOC analyst: present findings
- Raw event queue → Redis: store queue data
- Filtered event queue → Redis: store queue data
- Events and findings → PostgreSQL: persist records
- Finding enrichment → PostgreSQL: persist enrichment
- AI memory → Qdrant: retrieve memory
