# skygod07/arm architecture

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

- Interactive diagram: https://gitdiagram.com/skygod07/arm
- Repository: https://github.com/skygod07/arm

## Overview

Arm AI Benchmark Lab is a benchmarking and profiling product with both an interactive CLI and a React dashboard backed by a FastAPI service. The primary dashboard workflow selects a workload, gathers host hardware information, accepts run parameters, requests a benchmark, and presents metric comparisons and visualizations. The backend benchmarks tensor workloads and calculates baseline-versus-optimized metrics; the CLI also launches CPU/SIMD and memory-stride experiments. UI wiring beyond shown excerpts and unsampled experiment internals are represented only where the README or source index supports the relationship.

Main entry points: [`src/App.jsx`](https://github.com/skygod07/arm/blob/main/src/App.jsx) (Dashboard App), [`cli.py`](https://github.com/skygod07/arm/blob/main/cli.py) (Interactive CLI), [`src/backend/api.py`](https://github.com/skygod07/arm/blob/main/src/backend/api.py) (REST API), [`src/backend/benchmark_engine.py`](https://github.com/skygod07/arm/blob/main/src/backend/benchmark_engine.py) (Benchmark Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["Interactive CLI<br/>[cli.py]"]
  node_app["Dashboard App<br/>[App.jsx]"]
  node_entry["React Entry<br/>[main.jsx]"]
  node_selector["Workload Selector"]
  node_controls["Run Controls"]
  node_metric["Metric Cards<br/>[MetricCard.jsx]"]
  node_comparison["Comparison Table"]
  node_radar["Optimization Radar"]
  node_hardwarecard["Hardware Card"]
  node_mockdata["UI Workload Defaults<br/>[mockData.js]"]
end

subgraph group_service["API Service"]
  node_api["REST API<br/>[api.py]"]
end

subgraph group_benchmark["Benchmark Engine"]
  node_models["Workload Definitions<br/>[models.py]"]
  node_hardware["Hardware Profiler<br/>[system_info.py]"]
  node_engine["Benchmark Engine"]
end

subgraph group_experiments["Micro-Experiments"]
  node_cpu["Scalar SIMD Experiment"]
  node_memory["Cache Stride Experiment"]
end

node_user(("Engineer"))

node_user -->|"runs"| node_cli
node_user -->|"uses"| node_app
node_entry -->|"renders"| node_app
node_app -->|"requests benchmarks"| node_api
node_app -->|"requests system info"| node_api
node_app -->|"renders"| node_selector
node_app -->|"renders"| node_controls
node_app -->|"renders"| node_metric
node_app -->|"renders"| node_comparison
node_app -->|"renders"| node_radar
node_app -->|"renders"| node_hardwarecard
node_app -->|"reads defaults"| node_mockdata
node_api -->|"validates workload"| node_models
node_api -->|"runs benchmark"| node_engine
node_api -->|"gets system profile"| node_hardware
node_engine -->|"reads definitions"| node_models
node_engine -->|"gets host profile"| node_hardware
node_cli -->|"profiles host"| node_hardware
node_cli -->|"lists workloads"| node_models
node_cli -->|"runs and reports"| node_engine
node_cli -->|"runs experiment"| node_cpu
node_cli -->|"runs experiment"| node_memory

click node_cli "https://github.com/skygod07/arm/blob/main/cli.py"
click node_app "https://github.com/skygod07/arm/blob/main/src/App.jsx"
click node_entry "https://github.com/skygod07/arm/blob/main/src/main.jsx"
click node_selector "https://github.com/skygod07/arm/blob/main/src/components/WorkloadSelector.jsx"
click node_controls "https://github.com/skygod07/arm/blob/main/src/components/WorkloadControls.jsx"
click node_metric "https://github.com/skygod07/arm/blob/main/src/components/MetricCard.jsx"
click node_comparison "https://github.com/skygod07/arm/blob/main/src/components/ComparisonTable.jsx"
click node_radar "https://github.com/skygod07/arm/blob/main/src/components/OptimizationRadar.jsx"
click node_hardwarecard "https://github.com/skygod07/arm/blob/main/src/components/SystemHardwareCard.jsx"
click node_mockdata "https://github.com/skygod07/arm/blob/main/src/data/mockData.js"
click node_api "https://github.com/skygod07/arm/blob/main/src/backend/api.py"
click node_models "https://github.com/skygod07/arm/blob/main/src/backend/models.py"
click node_hardware "https://github.com/skygod07/arm/blob/main/src/backend/system_info.py"
click node_engine "https://github.com/skygod07/arm/blob/main/src/backend/benchmark_engine.py"
click node_cpu "https://github.com/skygod07/arm/blob/main/experiments/01_cpu_baseline/scalar_vs_vector.py"
click node_memory "https://github.com/skygod07/arm/blob/main/experiments/02_memory/cache_stride_access.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_cli,node_app,node_entry,node_selector,node_controls,node_metric,node_comparison,node_radar,node_hardwarecard,node_mockdata toneBlue
class node_api toneAmber
class node_models,node_hardware,node_engine toneMint
class node_cpu,node_memory toneRose
class node_user toneIndigo
```

## Components

### User Interfaces

- [Interactive CLI](https://github.com/skygod07/arm/blob/main/cli.py): `cli.py`
- [Dashboard App](https://github.com/skygod07/arm/blob/main/src/App.jsx): `src/App.jsx`
- [React Entry](https://github.com/skygod07/arm/blob/main/src/main.jsx): `src/main.jsx`
- [Workload Selector](https://github.com/skygod07/arm/blob/main/src/components/WorkloadSelector.jsx): `src/components/WorkloadSelector.jsx`
- [Run Controls](https://github.com/skygod07/arm/blob/main/src/components/WorkloadControls.jsx): `src/components/WorkloadControls.jsx`
- [Metric Cards](https://github.com/skygod07/arm/blob/main/src/components/MetricCard.jsx): `src/components/MetricCard.jsx`
- [Comparison Table](https://github.com/skygod07/arm/blob/main/src/components/ComparisonTable.jsx): `src/components/ComparisonTable.jsx`
- [Optimization Radar](https://github.com/skygod07/arm/blob/main/src/components/OptimizationRadar.jsx): `src/components/OptimizationRadar.jsx`
- [Hardware Card](https://github.com/skygod07/arm/blob/main/src/components/SystemHardwareCard.jsx): `src/components/SystemHardwareCard.jsx`
- [UI Workload Defaults](https://github.com/skygod07/arm/blob/main/src/data/mockData.js): `src/data/mockData.js`

### API Service

- [REST API](https://github.com/skygod07/arm/blob/main/src/backend/api.py): `src/backend/api.py`

### Benchmark Engine

- [Workload Definitions](https://github.com/skygod07/arm/blob/main/src/backend/models.py): `src/backend/models.py`
- [Hardware Profiler](https://github.com/skygod07/arm/blob/main/src/backend/system_info.py): `src/backend/system_info.py`
- [Benchmark Engine](https://github.com/skygod07/arm/blob/main/src/backend/benchmark_engine.py): `src/backend/benchmark_engine.py`

### Micro-Experiments

- [Scalar SIMD Experiment](https://github.com/skygod07/arm/blob/main/experiments/01_cpu_baseline/scalar_vs_vector.py): `experiments/01_cpu_baseline/scalar_vs_vector.py`
- [Cache Stride Experiment](https://github.com/skygod07/arm/blob/main/experiments/02_memory/cache_stride_access.py): `experiments/02_memory/cache_stride_access.py`

### Other components

- **Engineer**

## Connections

- Engineer → Interactive CLI: runs (evidence: `README.md`)
- Engineer → Dashboard App: uses (evidence: `README.md`)
- React Entry → Dashboard App: renders (evidence: `src/main.jsx`)
- Dashboard App → REST API: requests benchmarks (evidence: `src/App.jsx`)
- Dashboard App → REST API: requests system info (evidence: `src/App.jsx`)
- Dashboard App → Workload Selector: renders (evidence: `src/App.jsx`)
- Dashboard App → Run Controls: renders (evidence: `src/App.jsx`)
- Dashboard App → Metric Cards: renders (evidence: `src/App.jsx`)
- Dashboard App → Comparison Table: renders (evidence: `src/App.jsx`)
- Dashboard App → Optimization Radar: renders (evidence: `src/App.jsx`)
- Dashboard App → Hardware Card: renders (evidence: `src/App.jsx`)
- Dashboard App → UI Workload Defaults: reads defaults (evidence: `src/App.jsx`)
- REST API → Workload Definitions: validates workload (evidence: `src/backend/api.py`)
- REST API → Benchmark Engine: runs benchmark (evidence: `src/backend/api.py`)
- REST API → Hardware Profiler: gets system profile (evidence: `src/backend/api.py`)
- Benchmark Engine → Workload Definitions: reads definitions (evidence: `src/backend/benchmark_engine.py`)
- Benchmark Engine → Hardware Profiler: gets host profile (evidence: `src/backend/benchmark_engine.py`)
- Interactive CLI → Hardware Profiler: profiles host (evidence: `cli.py`)
- Interactive CLI → Workload Definitions: lists workloads (evidence: `cli.py`)
- Interactive CLI → Benchmark Engine: runs and reports (evidence: `cli.py`)
- Interactive CLI → Scalar SIMD Experiment: runs experiment (evidence: `cli.py`)
- Interactive CLI → Cache Stride Experiment: runs experiment (evidence: `cli.py`)
