# myleslandais/jupyter architecture

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

- Interactive diagram: https://gitdiagram.com/myleslandais/jupyter
- Repository: https://github.com/myleslandais/jupyter

## Overview

The README identifies ASR model evaluation as the product’s primary goal: evaluate models against datasets, calculate quality and performance metrics, and store comparisons for a leaderboard. The supplied tree does not include the documented adapter or metrics modules, so those capabilities are represented as README-documented subsystems rather than assigned invented source paths. The visible source supports dataset-handler discovery, PostgreSQL result storage, and RunPod management; connections among these and the evaluation workflow are omitted where no call is shown.

Main entry points: [`src/runpod/client.py`](https://github.com/myleslandais/jupyter/blob/master/src/runpod/client.py) (RunPod client), [`src/datasets/manager.py`](https://github.com/myleslandais/jupyter/blob/master/src/datasets/manager.py) (Dataset manager), [`src/providers/asr/storage/postgres_storage.py`](https://github.com/myleslandais/jupyter/blob/master/src/providers/asr/storage/postgres_storage.py) (Result storage), [`src/infra/runpod_manager.py`](https://github.com/myleslandais/jupyter/blob/master/src/infra/runpod_manager.py) (RunPod manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_evaluation["ASR evaluation"]
  node_framework["Evaluation framework"]
  node_adapters["Model adapters"]
  node_metrics["Metrics engine"]
  node_model_services["ASR models"]
end

subgraph group_data["Datasets and results"]
  node_dataset_manager["Dataset manager<br/>[manager.py]"]
  node_dataset_handlers["Dataset handlers"]
  node_result_storage[("Result storage")]
end

subgraph group_infrastructure["Compute infrastructure"]
  node_runpod_manager["RunPod manager<br/>[runpod_manager.py]"]
  node_runpod_client["RunPod client<br/>[client.py]"]
  node_vibe_voice_manager["VibeVoice manager"]
  node_comfy_client["Comfy client<br/>[client.py]"]
end

node_user(("Evaluator"))
node_postgres[("PostgreSQL")]
node_runpod_service["RunPod"]

node_user -.->|"requests evaluation"| node_framework
node_framework -.->|"uses adapters"| node_adapters
node_adapters -.->|"transcribes audio"| node_model_services
node_framework -.->|"calculates metrics"| node_metrics
node_dataset_manager -->|"discovers handlers"| node_dataset_handlers
node_result_storage -->|"reads and writes"| node_postgres
node_runpod_manager -->|"uses client"| node_runpod_client
node_runpod_client -->|"runs commands"| node_runpod_service
node_vibe_voice_manager -->|"imports client"| node_comfy_client

click node_dataset_manager "https://github.com/myleslandais/jupyter/blob/master/src/datasets/manager.py"
click node_dataset_handlers "https://github.com/myleslandais/jupyter/tree/master/src/datasets/handlers"
click node_result_storage "https://github.com/myleslandais/jupyter/blob/master/src/providers/asr/storage/postgres_storage.py"
click node_runpod_manager "https://github.com/myleslandais/jupyter/blob/master/src/infra/runpod_manager.py"
click node_runpod_client "https://github.com/myleslandais/jupyter/blob/master/src/runpod/client.py"
click node_vibe_voice_manager "https://github.com/myleslandais/jupyter/blob/master/src/infra/vibe_voice_manager.py"
click node_comfy_client "https://github.com/myleslandais/jupyter/blob/master/src/comfy/client.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_framework,node_adapters,node_metrics,node_model_services toneBlue
class node_dataset_manager,node_dataset_handlers,node_result_storage,node_postgres toneAmber
class node_runpod_manager,node_runpod_client,node_vibe_voice_manager,node_comfy_client toneMint
class node_user,node_runpod_service toneIndigo
```

## Components

### ASR evaluation

- **Evaluation framework**
- **Model adapters**
- **Metrics engine**
- **ASR models**

### Datasets and results

- [Dataset manager](https://github.com/myleslandais/jupyter/blob/master/src/datasets/manager.py): `src/datasets/manager.py`
- [Dataset handlers](https://github.com/myleslandais/jupyter/tree/master/src/datasets/handlers): `src/datasets/handlers`
- [Result storage](https://github.com/myleslandais/jupyter/blob/master/src/providers/asr/storage/postgres_storage.py): `src/providers/asr/storage/postgres_storage.py`

### Compute infrastructure

- [RunPod manager](https://github.com/myleslandais/jupyter/blob/master/src/infra/runpod_manager.py): `src/infra/runpod_manager.py`
- [RunPod client](https://github.com/myleslandais/jupyter/blob/master/src/runpod/client.py): `src/runpod/client.py`
- [VibeVoice manager](https://github.com/myleslandais/jupyter/blob/master/src/infra/vibe_voice_manager.py): `src/infra/vibe_voice_manager.py`
- [Comfy client](https://github.com/myleslandais/jupyter/blob/master/src/comfy/client.py): `src/comfy/client.py`

### Other components

- **Evaluator**
- **PostgreSQL**
- **RunPod**

## Connections

- Evaluator → Evaluation framework: requests evaluation
- Evaluation framework → Model adapters: uses adapters
- Model adapters → ASR models: transcribes audio
- Evaluation framework → Metrics engine: calculates metrics
- Dataset manager → Dataset handlers: discovers handlers (evidence: `src/datasets/manager.py`)
- Result storage → PostgreSQL: reads and writes (evidence: `src/providers/asr/storage/postgres_storage.py`)
- RunPod manager → RunPod client: uses client (evidence: `src/infra/runpod_manager.py`)
- RunPod client → RunPod: runs commands (evidence: `src/runpod/client.py`)
- VibeVoice manager → Comfy client: imports client (evidence: `src/infra/vibe_voice_manager.py`)