# carlcode-dev/cloudgenie architecture

> Architecture diagram of the GitHub repository carlcode-dev/cloudgenie, 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/carlcode-dev/cloudgenie
- Repository: https://github.com/carlcode-dev/cloudgenie

## Overview

CloudGenie is a Streamlit cloud-operations interface. Users view operational status and access SecOps, runbook, and FinOps features; the sampled code also shows AI-assisted security-fix generation through Gemini. The app is a single 62 KB module, so these are responsibilities within one implementation rather than separate services. The README is empty and most of app.py was not excerpted, so links beyond the visible AI-fix call are omitted.

Main entry points: [`app.py`](https://github.com/carlcode-dev/cloudgenie/blob/main/app.py) (CloudGenie app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Operations UI"]
  node_app["CloudGenie app<br/>[app.py]"]
  node_status["System status<br/>[app.py]"]
  node_secops["SecOps auditor<br/>[app.py]"]
  node_runbooks["Runbooks<br/>[app.py]"]
  node_finops["FinOps optimizer<br/>[app.py]"]
end

subgraph group_ai["AI Assistance"]
  node_gemini["Gemini API"]
end

node_user(("Cloud operator"))

node_user -->|"uses"| node_app
node_app -->|"displays"| node_status
node_app -->|"presents findings"| node_secops
node_app -->|"renders steps"| node_runbooks
node_app -->|"generates fixes"| node_gemini

click node_app "https://github.com/carlcode-dev/cloudgenie/blob/main/app.py"
click node_status "https://github.com/carlcode-dev/cloudgenie/blob/main/app.py"
click node_secops "https://github.com/carlcode-dev/cloudgenie/blob/main/app.py"
click node_runbooks "https://github.com/carlcode-dev/cloudgenie/blob/main/app.py"
click node_finops "https://github.com/carlcode-dev/cloudgenie/blob/main/app.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_app,node_status,node_secops,node_runbooks,node_finops toneBlue
class node_gemini toneAmber
class node_user toneIndigo
```

## Components

### Operations UI

- [CloudGenie app](https://github.com/carlcode-dev/cloudgenie/blob/main/app.py): `app.py`
- [System status](https://github.com/carlcode-dev/cloudgenie/blob/main/app.py): `app.py`
- [SecOps auditor](https://github.com/carlcode-dev/cloudgenie/blob/main/app.py): `app.py`
- [Runbooks](https://github.com/carlcode-dev/cloudgenie/blob/main/app.py): `app.py`
- [FinOps optimizer](https://github.com/carlcode-dev/cloudgenie/blob/main/app.py): `app.py`

### AI Assistance

- **Gemini API**

### Other components

- **Cloud operator**

## Connections

- Cloud operator → CloudGenie app: uses (evidence: `app.py`)
- CloudGenie app → System status: displays (evidence: `app.py`)
- CloudGenie app → SecOps auditor: presents findings (evidence: `app.py`)
- CloudGenie app → Runbooks: renders steps (evidence: `app.py`)
- CloudGenie app → Gemini API: generates fixes (evidence: `app.py`)