# meajsinghk/asu-nvidia-gpu-hack25 architecture

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

- Interactive diagram: https://gitdiagram.com/meajsinghk/asu-nvidia-gpu-hack25
- Repository: https://github.com/meajsinghk/asu-nvidia-gpu-hack25

## Overview

This is a GPU-computing learning and analysis app: users explore GPU lessons, submit code for comparison or simulation, and inspect results; a separately documented Sol backend handles parking-data analysis, chat, and GPU metrics. The sampled frontend action and AI-flow code supports the multiverse and AI paths, while backend implementation and most page/component wiring were not present in the excerpts, so those links are limited to documented capabilities.

Main entry points: [`src/components/gpu-insights-app.tsx`](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/gpu-insights-app.tsx) (GPU Insights App), [`src/app/actions.ts`](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/actions.ts) (Server Actions), [`src/ai/genkit.ts`](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/genkit.ts) (Genkit Runtime), [`src/app/lab/page.tsx`](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/lab/page.tsx) (GPU Lab)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["GPU Learning"]
  node_home["Home Page<br/>[page.tsx]"]
  node_lab["GPU Lab<br/>[page.tsx]"]
  node_lesson_data["Lesson Modules<br/>[modules.ts]"]
end

subgraph group_analysis["Analysis Interface"]
  node_gpu_app["GPU Insights App"]
  node_controls["Run Controls<br/>[control-panel.tsx]"]
  node_code["Code Editor<br/>[code-panel.tsx]"]
  node_results["Results Charts<br/>[results-panel.tsx]"]
  node_metrics["Metrics Panel<br/>[metrics-panel.tsx]"]
  node_dataset_info["Dataset Details"]
  node_actions["Server Actions<br/>[actions.ts]"]
end

subgraph group_ai["AI Experiences"]
  node_lab_chat["Lab Chat Flow<br/>[lab-chat-flow.ts]"]
  node_perf_ai["Performance Analysis Flow"]
  node_multiverse_flow["Multiverse Flow<br/>[multiverse-flow.ts]"]
  node_ai_runtime["Genkit Runtime<br/>[genkit.ts]"]
  node_multiverse_page["Multiverse Input Page<br/>[page.tsx]"]
  node_universe_launch["Universe Launch<br/>[page.tsx]"]
  node_universe_sim["Universe Simulation<br/>[page.tsx]"]
end

subgraph group_backend["Remote Data Backend"]
  node_sol_client["Sol API Client<br/>[sol-backend.ts]"]
  node_sol_backend["Sol GPU Backend"]
  node_dataset_download["Dataset Downloader"]
end

node_user(("User"))
node_nyc_data["NYC Open Data"]
node_google_ai["Google AI"]
node_multiverse_input(("Code Submission"))

node_user -->|"opens"| node_home
node_user -->|"explores lessons"| node_lab
node_lab -->|"loads modules"| node_lesson_data
node_user -->|"analyzes"| node_gpu_app
node_gpu_app -->|"presents controls"| node_controls
node_gpu_app -->|"presents editor"| node_code
node_gpu_app -->|"presents charts"| node_results
node_gpu_app -->|"presents metrics"| node_metrics
node_gpu_app -->|"presents dataset"| node_dataset_info
node_actions -->|"posts execution request"| node_sol_backend
node_dataset_download -->|"downloads records"| node_nyc_data
node_sol_backend -->|"processes parking data"| node_nyc_data
node_actions -->|"requests analysis"| node_perf_ai
node_actions -->|"requests chat"| node_lab_chat
node_actions -->|"runs simulation"| node_multiverse_flow
node_perf_ai -->|"uses model runtime"| node_ai_runtime
node_lab_chat -->|"uses model runtime"| node_ai_runtime
node_multiverse_flow -->|"uses model runtime"| node_ai_runtime
node_ai_runtime -->|"calls model"| node_google_ai
node_multiverse_input -->|"submits GPU code"| node_multiverse_page
node_multiverse_page -->|"requests multiverse analysis"| node_actions
node_user -->|"opens experience"| node_universe_launch
node_universe_launch -->|"navigates to simulation"| node_universe_sim

click node_home "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/page.tsx"
click node_lab "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/lab/page.tsx"
click node_lesson_data "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/lib/modules.ts"
click node_gpu_app "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/gpu-insights-app.tsx"
click node_controls "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/control-panel.tsx"
click node_code "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/code-panel.tsx"
click node_results "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/results-panel.tsx"
click node_metrics "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/metrics-panel.tsx"
click node_dataset_info "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/dataset-info-panel.tsx"
click node_actions "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/actions.ts"
click node_sol_client "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/lib/sol-backend.ts"
click node_sol_backend "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/tree/master/sol-complete-backend"
click node_dataset_download "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/sol-complete-backend/download_dataset.py"
click node_lab_chat "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/flows/lab-chat-flow.ts"
click node_perf_ai "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/flows/analyze-performance-differences.ts"
click node_multiverse_flow "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/flows/multiverse-flow.ts"
click node_ai_runtime "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/genkit.ts"
click node_multiverse_page "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/test2/page.tsx"
click node_universe_launch "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/universe/page.tsx"
click node_universe_sim "https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/universe/simulation/page.tsx"

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_home,node_lab,node_lesson_data,node_user toneBlue
class node_gpu_app,node_controls,node_code,node_results,node_metrics,node_dataset_info,node_actions toneAmber
class node_lab_chat,node_perf_ai,node_multiverse_flow,node_ai_runtime,node_multiverse_page,node_universe_launch,node_universe_sim toneMint
class node_sol_client,node_sol_backend,node_dataset_download toneRose
class node_nyc_data,node_google_ai,node_multiverse_input toneIndigo
```

## Components

### GPU Learning

- [Home Page](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [GPU Lab](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/lab/page.tsx): `src/app/lab/page.tsx`
- [Lesson Modules](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/lib/modules.ts): `src/lib/modules.ts`

### Analysis Interface

- [GPU Insights App](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/gpu-insights-app.tsx): `src/components/gpu-insights-app.tsx`
- [Run Controls](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/control-panel.tsx): `src/components/control-panel.tsx`
- [Code Editor](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/code-panel.tsx): `src/components/code-panel.tsx`
- [Results Charts](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/results-panel.tsx): `src/components/results-panel.tsx`
- [Metrics Panel](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/metrics-panel.tsx): `src/components/metrics-panel.tsx`
- [Dataset Details](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/components/dataset-info-panel.tsx): `src/components/dataset-info-panel.tsx`
- [Server Actions](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/actions.ts): `src/app/actions.ts`

### AI Experiences

- [Lab Chat Flow](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/flows/lab-chat-flow.ts): `src/ai/flows/lab-chat-flow.ts`
- [Performance Analysis Flow](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/flows/analyze-performance-differences.ts): `src/ai/flows/analyze-performance-differences.ts`
- [Multiverse Flow](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/flows/multiverse-flow.ts): `src/ai/flows/multiverse-flow.ts`
- [Genkit Runtime](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/ai/genkit.ts): `src/ai/genkit.ts`
- [Multiverse Input Page](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/test2/page.tsx): `src/app/test2/page.tsx`
- [Universe Launch](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/universe/page.tsx): `src/app/universe/page.tsx`
- [Universe Simulation](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/app/universe/simulation/page.tsx): `src/app/universe/simulation/page.tsx`

### Remote Data Backend

- [Sol API Client](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/src/lib/sol-backend.ts): `src/lib/sol-backend.ts`
- [Sol GPU Backend](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/tree/master/sol-complete-backend): `sol-complete-backend`
- [Dataset Downloader](https://github.com/meajsinghk/asu-nvidia-gpu-hack25/blob/master/sol-complete-backend/download_dataset.py): `sol-complete-backend/download_dataset.py`

### Other components

- **User**
- **NYC Open Data**
- **Google AI**
- **Code Submission**

## Connections

- User → Home Page: opens
- User → GPU Lab: explores lessons
- GPU Lab → Lesson Modules: loads modules
- User → GPU Insights App: analyzes
- GPU Insights App → Run Controls: presents controls
- GPU Insights App → Code Editor: presents editor
- GPU Insights App → Results Charts: presents charts
- GPU Insights App → Metrics Panel: presents metrics
- GPU Insights App → Dataset Details: presents dataset
- Server Actions → Sol GPU Backend: posts execution request
- Dataset Downloader → NYC Open Data: downloads records
- Sol GPU Backend → NYC Open Data: processes parking data
- Server Actions → Performance Analysis Flow: requests analysis
- Server Actions → Lab Chat Flow: requests chat
- Server Actions → Multiverse Flow: runs simulation
- Performance Analysis Flow → Genkit Runtime: uses model runtime
- Lab Chat Flow → Genkit Runtime: uses model runtime
- Multiverse Flow → Genkit Runtime: uses model runtime
- Genkit Runtime → Google AI: calls model
- Code Submission → Multiverse Input Page: submits GPU code
- Multiverse Input Page → Server Actions: requests multiverse analysis
- User → Universe Launch: opens experience
- Universe Launch → Universe Simulation: navigates to simulation