# datatalksclub/machine-learning-zoomcamp architecture

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

- Interactive diagram: https://gitdiagram.com/datatalksclub/machine-learning-zoomcamp
- Repository: https://github.com/datatalksclub/machine-learning-zoomcamp

## Overview

Machine Learning Zoomcamp is a hands-on course whose central learner workflow runs from framing a problem through preparing data, training and evaluating models, then exposing and deploying them as services. The supplied tree emphasizes deployment examples, including model training, HTTP prediction, Kubernetes/TensorFlow Serving, serverless functions, and KServe. The graph shows those documented course stages and the source-visible calls; it does not imply that separate lesson examples form one executable pipeline. Several deployment implementations are indexed but not excerpted, so their internal wiring is left unspecified.

Main entry points: [`README.md`](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/README.md) (Course materials), [`05-deployment/code/train.py`](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/train.py) (Model training), [`10-kubernetes/workshop/service/app.py`](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/10-kubernetes/workshop/service/app.py) (Prediction API), [`cohorts/2026/homework/05-deployment/train.py`](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/cohorts/2026/homework/05-deployment/train.py) (Lead model training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Course workflow"]
  node_course["Course materials<br/>[README.md]"]
  node_problem["Problem framing<br/>[README.md]"]
end

subgraph group_modeling["Model development"]
  node_data["Data preparation<br/>[train.py]"]
  node_training["Model training<br/>[train.py]"]
  node_evaluation["Model evaluation<br/>[train.py]"]
  node_lead_features["Lead features<br/>[model.py]"]
  node_lead_training["Lead model training<br/>[train.py]"]
  node_lead_artifacts["Model artifacts<br/>[train.py]"]
end

subgraph group_serving["Prediction services"]
  node_prediction_api["Prediction API<br/>[app.py]"]
  node_gateway["Prediction gateway<br/>[gateway.py]"]
  node_tensor_encoding["Tensor encoding<br/>[proto.py]"]
  node_model_service["Model service<br/>[predict.py]"]
end

subgraph group_platforms["Deployment platforms"]
  node_serverless["Lambda inference<br/>[lambda_function.py]"]
  node_kserve["KServe examples"]
  node_deployment["Production deployment<br/>[README.md]"]
end

node_learner(("Learner"))

node_learner -->|"follows"| node_course
node_course -->|"teaches framing"| node_problem
node_course -->|"teaches preparation"| node_data
node_course -->|"teaches training"| node_training
node_course -->|"teaches evaluation"| node_evaluation
node_course -->|"teaches API serving"| node_prediction_api
node_course -->|"teaches deployment"| node_deployment
node_data -->|"prepares inputs"| node_training
node_training -->|"measures AUC"| node_evaluation
node_training -->|"normalizes records"| node_lead_features
node_lead_training -->|"uses normalization"| node_lead_features
node_lead_training -->|"writes artifacts"| node_lead_artifacts
node_learner -->|"submits image URL"| node_prediction_api
node_prediction_api -->|"serves predictions"| node_deployment
node_learner -->|"sends prediction request"| node_gateway
node_gateway -->|"encodes tensor"| node_tensor_encoding
node_course -->|"covers Lambda"| node_serverless
node_course -.->|"covers KServe"| node_kserve
node_course -->|"covers prediction services"| node_model_service

click node_course "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/README.md"
click node_problem "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/README.md"
click node_data "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/train.py"
click node_training "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/train.py"
click node_evaluation "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/train.py"
click node_lead_features "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/cohorts/2026/homework/05-deployment/model.py"
click node_lead_training "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/cohorts/2026/homework/05-deployment/train.py"
click node_lead_artifacts "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/cohorts/2026/homework/05-deployment/train.py"
click node_prediction_api "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/10-kubernetes/workshop/service/app.py"
click node_gateway "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/10-kubernetes/code/gateway.py"
click node_tensor_encoding "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/10-kubernetes/code/proto.py"
click node_serverless "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/09-serverless/code/lambda_function.py"
click node_kserve "https://github.com/datatalksclub/machine-learning-zoomcamp/tree/main/11-kserve/code"
click node_deployment "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/README.md"
click node_model_service "https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/predict.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_course,node_problem toneBlue
class node_data,node_training,node_evaluation,node_lead_features,node_lead_training,node_lead_artifacts toneAmber
class node_prediction_api,node_gateway,node_tensor_encoding,node_model_service toneMint
class node_serverless,node_kserve,node_deployment toneRose
class node_learner toneIndigo
```

## Components

### Course workflow

- [Course materials](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/README.md): `README.md`
- [Problem framing](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/README.md): `README.md`

### Model development

- [Data preparation](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/train.py): `05-deployment/code/train.py`
- [Model training](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/train.py): `05-deployment/code/train.py`
- [Model evaluation](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/train.py): `05-deployment/code/train.py`
- [Lead features](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/cohorts/2026/homework/05-deployment/model.py): `cohorts/2026/homework/05-deployment/model.py`
- [Lead model training](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/cohorts/2026/homework/05-deployment/train.py): `cohorts/2026/homework/05-deployment/train.py`
- [Model artifacts](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/cohorts/2026/homework/05-deployment/train.py): `cohorts/2026/homework/05-deployment/train.py`

### Prediction services

- [Prediction API](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/10-kubernetes/workshop/service/app.py): `10-kubernetes/workshop/service/app.py`
- [Prediction gateway](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/10-kubernetes/code/gateway.py): `10-kubernetes/code/gateway.py`
- [Tensor encoding](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/10-kubernetes/code/proto.py): `10-kubernetes/code/proto.py`
- [Model service](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/05-deployment/code/predict.py): `05-deployment/code/predict.py`

### Deployment platforms

- [Lambda inference](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/09-serverless/code/lambda_function.py): `09-serverless/code/lambda_function.py`
- [KServe examples](https://github.com/datatalksclub/machine-learning-zoomcamp/tree/main/11-kserve/code): `11-kserve/code`
- [Production deployment](https://github.com/datatalksclub/machine-learning-zoomcamp/blob/main/README.md): `README.md`

### Other components

- **Learner**

## Connections

- Learner → Course materials: follows (evidence: `README.md`)
- Course materials → Problem framing: teaches framing (evidence: `README.md`)
- Course materials → Data preparation: teaches preparation (evidence: `README.md`)
- Course materials → Model training: teaches training (evidence: `README.md`)
- Course materials → Model evaluation: teaches evaluation (evidence: `README.md`)
- Course materials → Prediction API: teaches API serving (evidence: `README.md`)
- Course materials → Production deployment: teaches deployment (evidence: `README.md`)
- Data preparation → Model training: prepares inputs (evidence: `05-deployment/code/train.py`)
- Model training → Model evaluation: measures AUC (evidence: `05-deployment/code/train.py`)
- Model training → Lead features: normalizes records
- Lead model training → Lead features: uses normalization (evidence: `cohorts/2026/homework/05-deployment/train.py`)
- Lead model training → Model artifacts: writes artifacts (evidence: `cohorts/2026/homework/05-deployment/train.py`)
- Learner → Prediction API: submits image URL (evidence: `10-kubernetes/workshop/service/app.py`)
- Prediction API → Production deployment: serves predictions (evidence: `10-kubernetes/workshop/service/app.py`)
- Learner → Prediction gateway: sends prediction request (evidence: `10-kubernetes/code/gateway.py`)
- Prediction gateway → Tensor encoding: encodes tensor (evidence: `10-kubernetes/code/gateway.py`)
- Course materials → Lambda inference: covers Lambda (evidence: `README.md`)
- Course materials → KServe examples: covers KServe
- Course materials → Model service: covers prediction services (evidence: `README.md`)
