# gokumohandas/made-with-ml architecture

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

- Interactive diagram: https://gitdiagram.com/gokumohandas/made-with-ml
- Repository: https://github.com/gokumohandas/made-with-ml

## Overview

Made With ML is a course and reference implementation for building, evaluating, and serving production-oriented ML workloads. Its code workflow loads and preprocesses project data, trains a SciBERT-based classifier, evaluates checkpoints, and exposes prediction and evaluation endpoints. The README also describes tuning and scalable data/train/tune/serve workloads; tuning is represented as a documented capability, but its implementation was not sampled, so no implementation links are inferred for it.

Main entry points: [`madewithml/train.py`](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/train.py) (Distributed training), [`madewithml/predict.py`](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/predict.py) (Checkpoint prediction), [`madewithml/serve.py`](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/serve.py) (HTTP model deployment), [`madewithml/data.py`](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/data.py) (Load and preprocess)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Data preparation"]
  node_data["Load and preprocess<br/>[data.py]"]
end

subgraph group_model["Model development"]
  node_training["Distributed training<br/>[train.py]"]
  node_model_arch["SciBERT classifier<br/>[models.py]"]
  node_tuning["Hyperparameter tuning<br/>[tune.py]"]
end

subgraph group_ops["Experiment operations"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_utils["Training utilities<br/>[utils.py]"]
  node_evaluation["Metrics and slices<br/>[evaluate.py]"]
end

subgraph group_serving["Model serving"]
  node_prediction["Checkpoint prediction<br/>[predict.py]"]
  node_deployment["HTTP model deployment<br/>[serve.py]"]
  node_serve_job["Deployment entrypoint<br/>[serve_model.py]"]
end

node_user(("Developer / caller"))
node_project_data[("Project datasets")]

node_project_data -->|"reads CSV"| node_data
node_training -->|"loads and splits"| node_data
node_training -->|"trains classifier"| node_model_arch
node_training -->|"records results"| node_utils
node_data -->|"reads settings"| node_config
node_training -->|"imports settings"| node_config
node_evaluation -->|"loads checkpoint"| node_prediction
node_evaluation -->|"saves metrics"| node_utils
node_prediction -->|"preprocesses input"| node_data
node_prediction -->|"loads model"| node_model_arch
node_prediction -->|"collates batches"| node_utils
node_deployment -->|"predicts requests"| node_prediction
node_deployment -->|"evaluates requests"| node_evaluation
node_deployment -->|"configures tracking"| node_config
node_serve_job -->|"reads registry path"| node_config
node_serve_job -->|"binds deployment"| node_deployment
node_user -.->|"runs workload"| node_training
node_user -.->|"runs workload"| node_tuning
node_user -.->|"sends HTTP requests"| node_deployment

click node_project_data "https://github.com/gokumohandas/made-with-ml/tree/main/datasets"
click node_data "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/data.py"
click node_config "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/config.py"
click node_training "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/train.py"
click node_model_arch "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/models.py"
click node_tuning "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/tune.py"
click node_utils "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/utils.py"
click node_evaluation "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/evaluate.py"
click node_prediction "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/predict.py"
click node_deployment "https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/serve.py"
click node_serve_job "https://github.com/gokumohandas/made-with-ml/blob/main/deploy/services/serve_model.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_data toneBlue
class node_training,node_model_arch,node_tuning,node_project_data toneAmber
class node_config,node_utils,node_evaluation toneMint
class node_prediction,node_deployment,node_serve_job toneRose
class node_user toneIndigo
```

## Components

### Data preparation

- [Load and preprocess](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/data.py): `madewithml/data.py`

### Model development

- [Distributed training](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/train.py): `madewithml/train.py`
- [SciBERT classifier](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/models.py): `madewithml/models.py`
- [Hyperparameter tuning](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/tune.py): `madewithml/tune.py`

### Experiment operations

- [Runtime configuration](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/config.py): `madewithml/config.py`
- [Training utilities](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/utils.py): `madewithml/utils.py`
- [Metrics and slices](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/evaluate.py): `madewithml/evaluate.py`

### Model serving

- [Checkpoint prediction](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/predict.py): `madewithml/predict.py`
- [HTTP model deployment](https://github.com/gokumohandas/made-with-ml/blob/main/madewithml/serve.py): `madewithml/serve.py`
- [Deployment entrypoint](https://github.com/gokumohandas/made-with-ml/blob/main/deploy/services/serve_model.py): `deploy/services/serve_model.py`

### Other components

- **Developer / caller**
- [Project datasets](https://github.com/gokumohandas/made-with-ml/tree/main/datasets): `datasets`

## Connections

- Project datasets → Load and preprocess: reads CSV (evidence: `madewithml/data.py`)
- Distributed training → Load and preprocess: loads and splits (evidence: `madewithml/train.py`)
- Distributed training → SciBERT classifier: trains classifier (evidence: `madewithml/train.py`)
- Distributed training → Training utilities: records results (evidence: `madewithml/train.py`)
- Load and preprocess → Runtime configuration: reads settings (evidence: `madewithml/data.py`)
- Distributed training → Runtime configuration: imports settings (evidence: `madewithml/train.py`)
- Metrics and slices → Checkpoint prediction: loads checkpoint (evidence: `madewithml/evaluate.py`)
- Metrics and slices → Training utilities: saves metrics (evidence: `madewithml/evaluate.py`)
- Checkpoint prediction → Load and preprocess: preprocesses input (evidence: `madewithml/predict.py`)
- Checkpoint prediction → SciBERT classifier: loads model (evidence: `madewithml/predict.py`)
- Checkpoint prediction → Training utilities: collates batches (evidence: `madewithml/predict.py`)
- HTTP model deployment → Checkpoint prediction: predicts requests (evidence: `madewithml/serve.py`)
- HTTP model deployment → Metrics and slices: evaluates requests (evidence: `madewithml/serve.py`)
- HTTP model deployment → Runtime configuration: configures tracking (evidence: `madewithml/serve.py`)
- Deployment entrypoint → Runtime configuration: reads registry path (evidence: `deploy/services/serve_model.py`)
- Deployment entrypoint → HTTP model deployment: binds deployment (evidence: `deploy/services/serve_model.py`)
- Developer / caller → Distributed training: runs workload (evidence: `README.md`)
- Developer / caller → Hyperparameter tuning: runs workload (evidence: `README.md`)
- Developer / caller → HTTP model deployment: sends HTTP requests
