# nudgebee/nudgebee architecture

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

- Interactive diagram: https://gitdiagram.com/nudgebee/nudgebee
- Repository: https://github.com/nudgebee/nudgebee

## Overview

Nudgebee is an SRE copilot spanning observability, cloud and Kubernetes cost optimization, incident investigation, runbook automation, and ChatOps. The principal workflow is operator or signal → ingestion and cloud scans → ranked findings → investigation and remediation, with runbooks and ticketing/notifications supporting response. The graph combines README-documented capabilities with sampled modules; some subsystem links are documented at product level rather than verified as direct calls, so those edges are dashed.

Main entry points: [`api-server/services/event`](https://github.com/nudgebee/nudgebee/tree/main/api-server/services/event) (Incident findings), [`app/src`](https://github.com/nudgebee/nudgebee/tree/main/app/src) (SRE web app), [`llm/llm-server/agents`](https://github.com/nudgebee/nudgebee/tree/main/llm/llm-server/agents) (LLM investigation), [`collector-server`](https://github.com/nudgebee/nudgebee/tree/main/collector-server) (Signal collectors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Signal ingestion"]
  node_collectors["Signal collectors"]
  node_integrations["Provider integrations"]
  node_event_ingest["Event processing"]
  node_cloud_scan["Cloud scans"]
end

subgraph group_insights["Findings and insights"]
  node_kg["Service graph"]
  node_finops["Cost optimization<br/>[storage_pricing.go]"]
  node_anomaly["Anomaly detection"]
  node_incident["Incident findings"]
end

subgraph group_response["Investigation and response"]
  node_triage["LLM investigation"]
  node_rag["Knowledge retrieval<br/>[db_query.py]"]
  node_runbooks["Runbook automation<br/>[service.go]"]
  node_tickets["Ticketing"]
  node_notifications["Notifications and ChatOps<br/>[channel_ingest.py]"]
end

subgraph group_connect["Operator interfaces"]
  node_web["SRE web app"]
  node_cloud_metrics["Live cloud metrics"]
  node_workflow_ui["Workflow layout"]
end

subgraph group_platform["Shared platform"]
  node_api["Service API<br/>[api.go]"]
  node_database[("Postgres data<br/>[rdbms.go]")]
  node_qdrant[("Vector store<br/>[client.py]")]
end

node_operator(("SRE operator"))

node_operator -.->|"uses"| node_web
node_collectors -.->|"ingests signals"| node_event_ingest
node_integrations -.->|"delivers events"| node_event_ingest
node_cloud_scan -.->|"surfaces resources"| node_finops
node_collectors -.->|"contributes telemetry"| node_kg
node_event_ingest -.->|"produces findings"| node_incident
node_kg -.->|"supports impact"| node_incident
node_finops -.->|"shows recommendations"| node_web
node_anomaly -.->|"flags anomalies"| node_incident
node_incident -.->|"investigates"| node_triage
node_triage -.->|"retrieves context"| node_rag
node_triage -.->|"proposes remediation"| node_runbooks
node_operator -.->|"triggers"| node_runbooks
node_incident -.->|"syncs tickets"| node_tickets
node_incident -.->|"sends alerts"| node_notifications
node_notifications -.->|"notifies"| node_operator
node_web -.->|"requests data"| node_api
node_api -.->|"reads and writes"| node_database
node_rag -.->|"queries vectors"| node_qdrant
node_web -->|"renders metrics"| node_cloud_metrics
node_cloud_metrics -->|"queries provider metrics"| node_web
node_workflow_ui -.->|"lays out workflows"| node_web

click node_collectors "https://github.com/nudgebee/nudgebee/tree/main/collector-server"
click node_integrations "https://github.com/nudgebee/nudgebee/tree/main/api-server/services/integrations"
click node_event_ingest "https://github.com/nudgebee/nudgebee/tree/main/api-server/services/event"
click node_cloud_scan "https://github.com/nudgebee/nudgebee/tree/main/api-server/services/knowledge_graph/sources"
click node_kg "https://github.com/nudgebee/nudgebee/tree/main/api-server/services/knowledge_graph/core"
click node_finops "https://github.com/nudgebee/nudgebee/blob/main/api-server/services/scan_orchestrator/storage_pricing.go"
click node_anomaly "https://github.com/nudgebee/nudgebee/tree/main/api-server/services/anomoly"
click node_incident "https://github.com/nudgebee/nudgebee/tree/main/api-server/services/event"
click node_triage "https://github.com/nudgebee/nudgebee/tree/main/llm/llm-server/agents"
click node_rag "https://github.com/nudgebee/nudgebee/blob/main/llm/rag-server/rag/core/utils/db_query.py"
click node_runbooks "https://github.com/nudgebee/nudgebee/blob/main/runbook-server/internal/workflow/service.go"
click node_tickets "https://github.com/nudgebee/nudgebee/tree/main/ticket-server/services"
click node_notifications "https://github.com/nudgebee/nudgebee/blob/main/notifications-server/notifications_server/services/channel_ingest.py"
click node_web "https://github.com/nudgebee/nudgebee/tree/main/app/src"
click node_cloud_metrics "https://github.com/nudgebee/nudgebee/blob/main/app/src/components/cloudaccount/cloud-metrics/useLiveResourceMetrics.ts"
click node_workflow_ui "https://github.com/nudgebee/nudgebee/blob/main/app/src/components/workflow/utils/workflowLayoutEngine.ts"
click node_api "https://github.com/nudgebee/nudgebee/blob/main/api-server/services/api/api.go"
click node_database "https://github.com/nudgebee/nudgebee/blob/main/api-server/services/internal/database/rdbms.go"
click node_qdrant "https://github.com/nudgebee/nudgebee/blob/main/llm/rag-server/rag/qdrant/client.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_collectors,node_integrations,node_event_ingest,node_cloud_scan toneBlue
class node_kg,node_finops,node_anomaly,node_incident toneAmber
class node_triage,node_rag,node_runbooks,node_tickets,node_notifications toneMint
class node_web,node_cloud_metrics,node_workflow_ui toneRose
class node_api,node_database,node_qdrant,node_operator toneIndigo
```

## Components

### Signal ingestion

- [Signal collectors](https://github.com/nudgebee/nudgebee/tree/main/collector-server): `collector-server`
- [Provider integrations](https://github.com/nudgebee/nudgebee/tree/main/api-server/services/integrations): `api-server/services/integrations`
- [Event processing](https://github.com/nudgebee/nudgebee/tree/main/api-server/services/event): `api-server/services/event`
- [Cloud scans](https://github.com/nudgebee/nudgebee/tree/main/api-server/services/knowledge_graph/sources): `api-server/services/knowledge_graph/sources`

### Findings and insights

- [Service graph](https://github.com/nudgebee/nudgebee/tree/main/api-server/services/knowledge_graph/core): `api-server/services/knowledge_graph/core`
- [Cost optimization](https://github.com/nudgebee/nudgebee/blob/main/api-server/services/scan_orchestrator/storage_pricing.go): `api-server/services/scan_orchestrator/storage_pricing.go`
- [Anomaly detection](https://github.com/nudgebee/nudgebee/tree/main/api-server/services/anomoly): `api-server/services/anomoly`
- [Incident findings](https://github.com/nudgebee/nudgebee/tree/main/api-server/services/event): `api-server/services/event`

### Investigation and response

- [LLM investigation](https://github.com/nudgebee/nudgebee/tree/main/llm/llm-server/agents): `llm/llm-server/agents`
- [Knowledge retrieval](https://github.com/nudgebee/nudgebee/blob/main/llm/rag-server/rag/core/utils/db_query.py): `llm/rag-server/rag/core/utils/db_query.py`
- [Runbook automation](https://github.com/nudgebee/nudgebee/blob/main/runbook-server/internal/workflow/service.go): `runbook-server/internal/workflow/service.go`
- [Ticketing](https://github.com/nudgebee/nudgebee/tree/main/ticket-server/services): `ticket-server/services`
- [Notifications and ChatOps](https://github.com/nudgebee/nudgebee/blob/main/notifications-server/notifications_server/services/channel_ingest.py): `notifications-server/notifications_server/services/channel_ingest.py`

### Operator interfaces

- [SRE web app](https://github.com/nudgebee/nudgebee/tree/main/app/src): `app/src`
- [Live cloud metrics](https://github.com/nudgebee/nudgebee/blob/main/app/src/components/cloudaccount/cloud-metrics/useLiveResourceMetrics.ts): `app/src/components/cloudaccount/cloud-metrics/useLiveResourceMetrics.ts`
- [Workflow layout](https://github.com/nudgebee/nudgebee/blob/main/app/src/components/workflow/utils/workflowLayoutEngine.ts): `app/src/components/workflow/utils/workflowLayoutEngine.ts`

### Shared platform

- [Service API](https://github.com/nudgebee/nudgebee/blob/main/api-server/services/api/api.go): `api-server/services/api/api.go`
- [Postgres data](https://github.com/nudgebee/nudgebee/blob/main/api-server/services/internal/database/rdbms.go): `api-server/services/internal/database/rdbms.go`
- [Vector store](https://github.com/nudgebee/nudgebee/blob/main/llm/rag-server/rag/qdrant/client.py): `llm/rag-server/rag/qdrant/client.py`

### Other components

- **SRE operator**

## Connections

- SRE operator → SRE web app: uses
- Signal collectors → Event processing: ingests signals
- Provider integrations → Event processing: delivers events
- Cloud scans → Cost optimization: surfaces resources
- Signal collectors → Service graph: contributes telemetry
- Event processing → Incident findings: produces findings
- Service graph → Incident findings: supports impact
- Cost optimization → SRE web app: shows recommendations
- Anomaly detection → Incident findings: flags anomalies
- Incident findings → LLM investigation: investigates
- LLM investigation → Knowledge retrieval: retrieves context
- LLM investigation → Runbook automation: proposes remediation
- SRE operator → Runbook automation: triggers
- Incident findings → Ticketing: syncs tickets
- Incident findings → Notifications and ChatOps: sends alerts
- Notifications and ChatOps → SRE operator: notifies
- SRE web app → Service API: requests data
- Service API → Postgres data: reads and writes
- Knowledge retrieval → Vector store: queries vectors
- SRE web app → Live cloud metrics: renders metrics (evidence: `app/src/components/cloudaccount/cloud-metrics/useServiceResources.ts`)
- Live cloud metrics → SRE web app: queries provider metrics (evidence: `app/src/components/cloudaccount/cloud-metrics/useLiveResourceMetrics.ts`)
- Workflow layout → SRE web app: lays out workflows (evidence: `app/src/components/workflow/utils/workflowLayoutEngine.ts`)
