# sakthivarshans/orvion architecture

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

- Interactive diagram: https://gitdiagram.com/sakthivarshans/orvion
- Repository: https://github.com/sakthivarshans/orvion

## Overview

Orvion is an AI SRE platform whose principal workflow is cloud/telemetry collection, anomaly detection, incident correlation, AI-assisted root-cause analysis, and remediation. Its React dashboard presents incidents, predictions, chat, and integrations through a FastAPI gateway. The README documents the major services and their roles; sampled source confirms selected internal calls, including ingestion connector dispatch, orchestrator correlation, and RCA orchestration. Other arrows rely on the README architecture, so unsampled internals are not asserted beyond those documented relationships.

Main entry points: [`modules/orchestrator/service.py`](https://github.com/sakthivarshans/orvion/blob/main/modules/orchestrator/service.py) (Incident Orchestrator), [`modules/rca_engine/analyzer.py`](https://github.com/sakthivarshans/orvion/blob/main/modules/rca_engine/analyzer.py) (Root Cause Analysis), [`modules/chatbot/service.py`](https://github.com/sakthivarshans/orvion/blob/main/modules/chatbot/service.py) (Developer Chatbot), [`integrations`](https://github.com/sakthivarshans/orvion/tree/main/integrations) (DevOps Integrations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User Experience"]
  node_dashboard["SRE Dashboard<br/>[Dashboard.tsx]"]
  node_frontend["Dashboard Shell<br/>[App.tsx]"]
  node_gateway["FastAPI Gateway<br/>[main.py]"]
end

subgraph group_telemetry["Telemetry Intelligence"]
  node_ingestion["Telemetry Ingestion<br/>[service.py]"]
  node_connectors["Cloud Collectors"]
  node_ml["Anomaly Detection<br/>[detector.py]"]
end

subgraph group_response["Incident Response"]
  node_orchestrator["Incident Orchestrator<br/>[service.py]"]
  node_correlator["Anomaly Correlator<br/>[correlator.py]"]
  node_rca["Root Cause Analysis<br/>[analyzer.py]"]
  node_executor["Remediation Executor<br/>[executor.py]"]
end

subgraph group_ai["AI and Memory"]
  node_chat["Developer Chatbot<br/>[service.py]"]
  node_memory["Incident Memory<br/>[store.py]"]
  node_llm["LLM Providers"]
  node_database[("Platform Database<br/>[database.py]")]
end

subgraph group_ecosystem["Integrations"]
  node_devops["DevOps Integrations"]
  node_repo["Repository Analyzer<br/>[repo_analyzer.py]"]
  node_cloud["Cloud Platforms"]
  node_tools["DevOps Tools"]
end

node_sre(("SRE Operator"))

node_sre -->|"uses"| node_dashboard
node_dashboard -->|"renders through"| node_frontend
node_frontend -->|"REST and WebSocket"| node_gateway
node_gateway -->|"routes chat"| node_chat
node_connectors -->|"collects from"| node_cloud
node_ingestion -->|"dispatches collection"| node_connectors
node_ingestion -->|"feeds telemetry"| node_ml
node_ml -->|"publishes anomalies"| node_orchestrator
node_orchestrator -->|"correlates with"| node_correlator
node_orchestrator -->|"requests analysis"| node_rca
node_orchestrator -->|"initiates remediation"| node_executor
node_orchestrator -->|"notifies and tracks"| node_devops
node_executor -->|"executes actions via"| node_devops
node_rca -->|"enriches context"| node_repo
node_chat -->|"generates responses"| node_llm
node_rca -->|"analyzes incidents"| node_llm
node_chat -.->|"uses incident context"| node_memory
node_memory -->|"persists incident knowledge"| node_database
node_devops -->|"integrates with"| node_tools

click node_dashboard "https://github.com/sakthivarshans/orvion/blob/main/frontend/src/pages/Dashboard.tsx"
click node_frontend "https://github.com/sakthivarshans/orvion/blob/main/frontend/src/App.tsx"
click node_gateway "https://github.com/sakthivarshans/orvion/blob/main/modules/api/main.py"
click node_ingestion "https://github.com/sakthivarshans/orvion/blob/main/modules/ingestion/service.py"
click node_connectors "https://github.com/sakthivarshans/orvion/tree/main/connectors"
click node_ml "https://github.com/sakthivarshans/orvion/blob/main/modules/ml_engine/detector.py"
click node_orchestrator "https://github.com/sakthivarshans/orvion/blob/main/modules/orchestrator/service.py"
click node_correlator "https://github.com/sakthivarshans/orvion/blob/main/modules/orchestrator/correlator.py"
click node_rca "https://github.com/sakthivarshans/orvion/blob/main/modules/rca_engine/analyzer.py"
click node_executor "https://github.com/sakthivarshans/orvion/blob/main/modules/action_executor/executor.py"
click node_devops "https://github.com/sakthivarshans/orvion/tree/main/integrations"
click node_repo "https://github.com/sakthivarshans/orvion/blob/main/integrations/github/repo_analyzer.py"
click node_chat "https://github.com/sakthivarshans/orvion/blob/main/modules/chatbot/service.py"
click node_memory "https://github.com/sakthivarshans/orvion/blob/main/modules/memory/store.py"
click node_llm "https://github.com/sakthivarshans/orvion/tree/main/shared/llm"
click node_database "https://github.com/sakthivarshans/orvion/blob/main/shared/database.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_dashboard,node_frontend,node_gateway toneBlue
class node_ingestion,node_connectors,node_ml toneAmber
class node_orchestrator,node_correlator,node_rca,node_executor toneMint
class node_chat,node_memory,node_llm,node_database toneRose
class node_devops,node_repo,node_cloud,node_tools,node_sre toneIndigo
```

## Components

### User Experience

- [SRE Dashboard](https://github.com/sakthivarshans/orvion/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Dashboard Shell](https://github.com/sakthivarshans/orvion/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [FastAPI Gateway](https://github.com/sakthivarshans/orvion/blob/main/modules/api/main.py): `modules/api/main.py`

### Telemetry Intelligence

- [Telemetry Ingestion](https://github.com/sakthivarshans/orvion/blob/main/modules/ingestion/service.py): `modules/ingestion/service.py`
- [Cloud Collectors](https://github.com/sakthivarshans/orvion/tree/main/connectors): `connectors`
- [Anomaly Detection](https://github.com/sakthivarshans/orvion/blob/main/modules/ml_engine/detector.py): `modules/ml_engine/detector.py`

### Incident Response

- [Incident Orchestrator](https://github.com/sakthivarshans/orvion/blob/main/modules/orchestrator/service.py): `modules/orchestrator/service.py`
- [Anomaly Correlator](https://github.com/sakthivarshans/orvion/blob/main/modules/orchestrator/correlator.py): `modules/orchestrator/correlator.py`
- [Root Cause Analysis](https://github.com/sakthivarshans/orvion/blob/main/modules/rca_engine/analyzer.py): `modules/rca_engine/analyzer.py`
- [Remediation Executor](https://github.com/sakthivarshans/orvion/blob/main/modules/action_executor/executor.py): `modules/action_executor/executor.py`

### AI and Memory

- [Developer Chatbot](https://github.com/sakthivarshans/orvion/blob/main/modules/chatbot/service.py): `modules/chatbot/service.py`
- [Incident Memory](https://github.com/sakthivarshans/orvion/blob/main/modules/memory/store.py): `modules/memory/store.py`
- [LLM Providers](https://github.com/sakthivarshans/orvion/tree/main/shared/llm): `shared/llm`
- [Platform Database](https://github.com/sakthivarshans/orvion/blob/main/shared/database.py): `shared/database.py`

### Integrations

- [DevOps Integrations](https://github.com/sakthivarshans/orvion/tree/main/integrations): `integrations`
- [Repository Analyzer](https://github.com/sakthivarshans/orvion/blob/main/integrations/github/repo_analyzer.py): `integrations/github/repo_analyzer.py`
- **Cloud Platforms**
- **DevOps Tools**

### Other components

- **SRE Operator**

## Connections

- SRE Operator → SRE Dashboard: uses
- SRE Dashboard → Dashboard Shell: renders through (evidence: `frontend/src/App.tsx`)
- Dashboard Shell → FastAPI Gateway: REST and WebSocket
- FastAPI Gateway → Developer Chatbot: routes chat (evidence: `modules/api/main.py`)
- Cloud Collectors → Cloud Platforms: collects from (evidence: `connectors/aws/collector.py`)
- Telemetry Ingestion → Cloud Collectors: dispatches collection (evidence: `modules/ingestion/service.py`)
- Telemetry Ingestion → Anomaly Detection: feeds telemetry
- Anomaly Detection → Incident Orchestrator: publishes anomalies
- Incident Orchestrator → Anomaly Correlator: correlates with (evidence: `modules/orchestrator/service.py`)
- Incident Orchestrator → Root Cause Analysis: requests analysis
- Incident Orchestrator → Remediation Executor: initiates remediation
- Incident Orchestrator → DevOps Integrations: notifies and tracks (evidence: `modules/orchestrator/service.py`)
- Remediation Executor → DevOps Integrations: executes actions via (evidence: `modules/action_executor/executor.py`)
- Root Cause Analysis → Repository Analyzer: enriches context
- Developer Chatbot → LLM Providers: generates responses (evidence: `modules/chatbot/service.py`)
- Root Cause Analysis → LLM Providers: analyzes incidents
- Developer Chatbot → Incident Memory: uses incident context
- Incident Memory → Platform Database: persists incident knowledge
- DevOps Integrations → DevOps Tools: integrates with