# anandpandit-001/pc_health_monitor architecture

> Architecture diagram of the GitHub repository anandpandit-001/pc_health_monitor, 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/anandpandit-001/pc_health_monitor
- Repository: https://github.com/anandpandit-001/pc_health_monitor

## Overview

This is a local system-monitoring dashboard: the operator starts a Streamlit page that launches six Dash services and embeds them as iframes. The live panels report CPU, RAM, battery, disk, upload, and download metrics. Separate Matplotlib animation modules implement alternate visualizations, but the shown launcher does not invoke them. Edges reflect the launcher's factory calls and iframe references; the README provides no additional capability details.

Main entry points: [`main.py`](https://github.com/anandpandit-001/pc_health_monitor/blob/master/main.py) (Dashboard launcher), [`cpu_usage_plotly.py`](https://github.com/anandpandit-001/pc_health_monitor/blob/master/cpu_usage_plotly.py) (CPU panel), [`ram_usage_plotly.py`](https://github.com/anandpandit-001/pc_health_monitor/blob/master/ram_usage_plotly.py) (RAM panel), [`battery_percentage_plotly.py`](https://github.com/anandpandit-001/pc_health_monitor/blob/master/battery_percentage_plotly.py) (Battery panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_launcher["Dashboard launcher<br/>[main.py]"]
end

subgraph group_live["Live metrics"]
  node_cpu_live["CPU panel"]
  node_ram_live["RAM panel"]
  node_battery_live["Battery panel"]
  node_disk_live["Disk panel"]
  node_upload_live["Upload panel"]
  node_download_live["Download panel"]
end

subgraph group_alternate["Alternate charts"]
  node_cpu_alt["CPU animation<br/>[cpu_usage.py]"]
  node_ram_alt["RAM animation<br/>[ram_usage.py]"]
  node_battery_alt["Battery animation"]
  node_disk_alt["Disk animation"]
end

node_operator(("Operator"))

node_operator -->|"starts"| node_launcher
node_launcher -->|"starts service"| node_upload_live
node_launcher -->|"starts service"| node_download_live
node_launcher -->|"starts service"| node_cpu_live
node_launcher -->|"starts service"| node_ram_live
node_launcher -->|"starts service"| node_battery_live
node_launcher -->|"starts service"| node_disk_live
node_launcher -->|"embeds panel"| node_upload_live
node_launcher -->|"embeds panel"| node_download_live
node_launcher -->|"embeds panel"| node_cpu_live
node_launcher -->|"embeds panel"| node_ram_live
node_launcher -->|"embeds panel"| node_battery_live
node_launcher -->|"embeds panel"| node_disk_live

click node_launcher "https://github.com/anandpandit-001/pc_health_monitor/blob/master/main.py"
click node_cpu_live "https://github.com/anandpandit-001/pc_health_monitor/blob/master/cpu_usage_plotly.py"
click node_ram_live "https://github.com/anandpandit-001/pc_health_monitor/blob/master/ram_usage_plotly.py"
click node_battery_live "https://github.com/anandpandit-001/pc_health_monitor/blob/master/battery_percentage_plotly.py"
click node_disk_live "https://github.com/anandpandit-001/pc_health_monitor/blob/master/disk_space_plotly.py"
click node_upload_live "https://github.com/anandpandit-001/pc_health_monitor/blob/master/network_speed_with_Gauge_dash_plotly_upload.py"
click node_download_live "https://github.com/anandpandit-001/pc_health_monitor/blob/master/network_speed_with_Gauge_dash_plotly_download.py"
click node_cpu_alt "https://github.com/anandpandit-001/pc_health_monitor/blob/master/cpu_usage.py"
click node_ram_alt "https://github.com/anandpandit-001/pc_health_monitor/blob/master/ram_usage.py"
click node_battery_alt "https://github.com/anandpandit-001/pc_health_monitor/blob/master/battery_percentage.py"
click node_disk_alt "https://github.com/anandpandit-001/pc_health_monitor/blob/master/disk_space_calculation.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_launcher toneBlue
class node_cpu_live,node_ram_live,node_battery_live,node_disk_live,node_upload_live,node_download_live toneAmber
class node_cpu_alt,node_ram_alt,node_battery_alt,node_disk_alt toneMint
class node_operator toneIndigo
```

## Components

### Dashboard

- [Dashboard launcher](https://github.com/anandpandit-001/pc_health_monitor/blob/master/main.py): `main.py`

### Live metrics

- [CPU panel](https://github.com/anandpandit-001/pc_health_monitor/blob/master/cpu_usage_plotly.py): `cpu_usage_plotly.py`
- [RAM panel](https://github.com/anandpandit-001/pc_health_monitor/blob/master/ram_usage_plotly.py): `ram_usage_plotly.py`
- [Battery panel](https://github.com/anandpandit-001/pc_health_monitor/blob/master/battery_percentage_plotly.py): `battery_percentage_plotly.py`
- [Disk panel](https://github.com/anandpandit-001/pc_health_monitor/blob/master/disk_space_plotly.py): `disk_space_plotly.py`
- [Upload panel](https://github.com/anandpandit-001/pc_health_monitor/blob/master/network_speed_with_Gauge_dash_plotly_upload.py): `network_speed_with_Gauge_dash_plotly_upload.py`
- [Download panel](https://github.com/anandpandit-001/pc_health_monitor/blob/master/network_speed_with_Gauge_dash_plotly_download.py): `network_speed_with_Gauge_dash_plotly_download.py`

### Alternate charts

- [CPU animation](https://github.com/anandpandit-001/pc_health_monitor/blob/master/cpu_usage.py): `cpu_usage.py`
- [RAM animation](https://github.com/anandpandit-001/pc_health_monitor/blob/master/ram_usage.py): `ram_usage.py`
- [Battery animation](https://github.com/anandpandit-001/pc_health_monitor/blob/master/battery_percentage.py): `battery_percentage.py`
- [Disk animation](https://github.com/anandpandit-001/pc_health_monitor/blob/master/disk_space_calculation.py): `disk_space_calculation.py`

### Other components

- **Operator**

## Connections

- Operator → Dashboard launcher: starts (evidence: `main.py`)
- Dashboard launcher → Upload panel: starts service (evidence: `main.py`)
- Dashboard launcher → Download panel: starts service (evidence: `main.py`)
- Dashboard launcher → CPU panel: starts service (evidence: `main.py`)
- Dashboard launcher → RAM panel: starts service (evidence: `main.py`)
- Dashboard launcher → Battery panel: starts service (evidence: `main.py`)
- Dashboard launcher → Disk panel: starts service (evidence: `main.py`)
- Dashboard launcher → Upload panel: embeds panel (evidence: `main.py`)
- Dashboard launcher → Download panel: embeds panel (evidence: `main.py`)
- Dashboard launcher → CPU panel: embeds panel (evidence: `main.py`)
- Dashboard launcher → RAM panel: embeds panel (evidence: `main.py`)
- Dashboard launcher → Battery panel: embeds panel (evidence: `main.py`)
- Dashboard launcher → Disk panel: embeds panel (evidence: `main.py`)
