# mlops-zhaw/mlops_labs architecture

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

- Interactive diagram: https://gitdiagram.com/mlops-zhaw/mlops_labs
- Repository: https://github.com/mlops-zhaw/mlops_labs

## Overview

This repository is a collection of MLOps course labs and tutorials, not one deployed application. Its principal end-to-end example is the Vertex AI text-classification pipeline: fetch labeled text, train and evaluate a classifier, then deploy it to an endpoint. Other branches teach image-data preparation and modeling, chatbot interfaces, model checks, experiment management, workflow orchestration, data-centric practices, and model serving. The README establishes these capabilities; some have no sampled implementation, so their internal links are intentionally omitted. The graph’s code-level relationships are limited to those visible in the supplied excerpts.

Main entry points: [`VertexAI/main.py`](https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py) (Pipeline orchestration), [`lab01/src/data/mnist.py`](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/data/mnist.py) (MNIST data module), [`lab01/src/data/base_data_module.py`](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/data/base_data_module.py) (Data module base), [`lab04/deepchecks_intro/train.py`](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab04/deepchecks_intro/train.py) (Image training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vertex["Vertex AI workflow"]
  node_vertex_pipeline["Pipeline orchestration<br/>[main.py]"]
  node_bigquery_fetch["BigQuery data fetch<br/>[main.py]"]
  node_classifier_train["Classifier training<br/>[main.py]"]
  node_model_deploy["Model deployment<br/>[main.py]"]
  node_dataset_prep["Dataset preparation<br/>[prepare_dataset.py]"]
end

subgraph group_learning["Model development"]
  node_mnist_data["MNIST data module<br/>[mnist.py]"]
  node_data_module["Data module base"]
  node_mnist_metadata["MNIST metadata<br/>[mnist.py]"]
  node_shared_metadata["Shared data paths<br/>[shared.py]"]
  node_image_stem["Image transforms<br/>[image.py]"]
  node_cnn_model["CNN model<br/>[cnn.py]"]
  node_deepchecks_data["Image dataset<br/>[data.py]"]
  node_deepchecks_train["Image training<br/>[train.py]"]
end

subgraph group_operations["MLOps practices"]
  node_experiment_lab["Experiment management"]
  node_model_checks["Model checks"]
  node_pipeline_lab["Batch pipelines"]
  node_data_centric["Data-centric workflows"]
end

subgraph group_deployment["Serving and interfaces"]
  node_vertex_serving["Prediction serving<br/>[main.py]"]
  node_vertex_webapp["Web application<br/>[main.py]"]
  node_chatbot["Chatbot interface"]
  node_model_deployment_lab["Model deployment lab"]
end

node_user(("Course learner"))
node_bigquery[("BigQuery")]
node_vertex_endpoint["Vertex AI endpoint"]
node_course(("MLOps course"))

node_vertex_pipeline -->|"dispatches"| node_bigquery_fetch
node_vertex_pipeline -->|"dispatches"| node_classifier_train
node_vertex_pipeline -->|"dispatches"| node_model_deploy
node_bigquery_fetch -->|"queries"| node_bigquery
node_model_deploy -->|"deploys model"| node_vertex_endpoint
node_mnist_data -->|"extends"| node_data_module
node_mnist_data -->|"reads settings"| node_mnist_metadata
node_mnist_data -->|"transforms images"| node_image_stem
node_data_module -->|"reads data path"| node_shared_metadata
node_deepchecks_train -->|"loads dataset"| node_deepchecks_data
node_user -->|"uses"| node_course
node_course -->|"teaches tuning"| node_experiment_lab
node_course -->|"teaches checks"| node_model_checks
node_course -->|"teaches orchestration"| node_pipeline_lab
node_course -->|"teaches practices"| node_data_centric
node_course -->|"teaches deployment"| node_model_deployment_lab
node_course -->|"teaches chatbot"| node_chatbot

click node_vertex_pipeline "https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py"
click node_bigquery_fetch "https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py"
click node_classifier_train "https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py"
click node_model_deploy "https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py"
click node_dataset_prep "https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/prepare_dataset.py"
click node_vertex_serving "https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/serving/main.py"
click node_vertex_webapp "https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/webapp/main.py"
click node_mnist_data "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/data/mnist.py"
click node_data_module "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/data/base_data_module.py"
click node_mnist_metadata "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/metadata/mnist.py"
click node_shared_metadata "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/metadata/shared.py"
click node_image_stem "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/stems/image.py"
click node_cnn_model "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/models/cnn.py"
click node_deepchecks_data "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab04/deepchecks_intro/data.py"
click node_deepchecks_train "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab04/deepchecks_intro/train.py"
click node_chatbot "https://github.com/mlops-zhaw/mlops_labs/blob/main/lab02/snippets/chatbot_solution.py"
click node_experiment_lab "https://github.com/mlops-zhaw/mlops_labs/tree/main/lab03"
click node_model_checks "https://github.com/mlops-zhaw/mlops_labs/tree/main/lab04/deepchecks_advanced"
click node_pipeline_lab "https://github.com/mlops-zhaw/mlops_labs/tree/main/lab05"
click node_data_centric "https://github.com/mlops-zhaw/mlops_labs/tree/main/lab06"
click node_model_deployment_lab "https://github.com/mlops-zhaw/mlops_labs/tree/main/lab07"

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_vertex_pipeline,node_bigquery_fetch,node_classifier_train,node_model_deploy,node_dataset_prep toneBlue
class node_mnist_data,node_data_module,node_mnist_metadata,node_shared_metadata,node_image_stem,node_cnn_model,node_deepchecks_data,node_deepchecks_train,node_bigquery toneAmber
class node_experiment_lab,node_model_checks,node_pipeline_lab,node_data_centric toneMint
class node_vertex_serving,node_vertex_webapp,node_chatbot,node_model_deployment_lab toneRose
class node_user,node_vertex_endpoint,node_course toneIndigo
```

## Components

### Vertex AI workflow

- [Pipeline orchestration](https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py): `VertexAI/main.py`
- [BigQuery data fetch](https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py): `VertexAI/main.py`
- [Classifier training](https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py): `VertexAI/main.py`
- [Model deployment](https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/main.py): `VertexAI/main.py`
- [Dataset preparation](https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/prepare_dataset.py): `VertexAI/prepare_dataset.py`

### Model development

- [MNIST data module](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/data/mnist.py): `lab01/src/data/mnist.py`
- [Data module base](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/data/base_data_module.py): `lab01/src/data/base_data_module.py`
- [MNIST metadata](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/metadata/mnist.py): `lab01/src/metadata/mnist.py`
- [Shared data paths](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/metadata/shared.py): `lab01/src/metadata/shared.py`
- [Image transforms](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/stems/image.py): `lab01/src/stems/image.py`
- [CNN model](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab01/src/models/cnn.py): `lab01/src/models/cnn.py`
- [Image dataset](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab04/deepchecks_intro/data.py): `lab04/deepchecks_intro/data.py`
- [Image training](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab04/deepchecks_intro/train.py): `lab04/deepchecks_intro/train.py`

### MLOps practices

- [Experiment management](https://github.com/mlops-zhaw/mlops_labs/tree/main/lab03): `lab03`
- [Model checks](https://github.com/mlops-zhaw/mlops_labs/tree/main/lab04/deepchecks_advanced): `lab04/deepchecks_advanced`
- [Batch pipelines](https://github.com/mlops-zhaw/mlops_labs/tree/main/lab05): `lab05`
- [Data-centric workflows](https://github.com/mlops-zhaw/mlops_labs/tree/main/lab06): `lab06`

### Serving and interfaces

- [Prediction serving](https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/serving/main.py): `VertexAI/serving/main.py`
- [Web application](https://github.com/mlops-zhaw/mlops_labs/blob/main/VertexAI/webapp/main.py): `VertexAI/webapp/main.py`
- [Chatbot interface](https://github.com/mlops-zhaw/mlops_labs/blob/main/lab02/snippets/chatbot_solution.py): `lab02/snippets/chatbot_solution.py`
- [Model deployment lab](https://github.com/mlops-zhaw/mlops_labs/tree/main/lab07): `lab07`

### Other components

- **Course learner**
- **BigQuery**
- **Vertex AI endpoint**
- **MLOps course**

## Connections

- Pipeline orchestration → BigQuery data fetch: dispatches (evidence: `VertexAI/main.py`)
- Pipeline orchestration → Classifier training: dispatches (evidence: `VertexAI/main.py`)
- Pipeline orchestration → Model deployment: dispatches (evidence: `VertexAI/main.py`)
- BigQuery data fetch → BigQuery: queries (evidence: `VertexAI/main.py`)
- Model deployment → Vertex AI endpoint: deploys model (evidence: `VertexAI/main.py`)
- MNIST data module → Data module base: extends (evidence: `lab01/src/data/mnist.py`)
- MNIST data module → MNIST metadata: reads settings (evidence: `lab01/src/data/mnist.py`)
- MNIST data module → Image transforms: transforms images (evidence: `lab01/src/data/mnist.py`)
- Data module base → Shared data paths: reads data path (evidence: `lab01/src/data/base_data_module.py`)
- Image training → Image dataset: loads dataset (evidence: `lab04/deepchecks_intro/train.py`)
- Course learner → MLOps course: uses (evidence: `README.md`)
- MLOps course → Experiment management: teaches tuning (evidence: `README.md`)
- MLOps course → Model checks: teaches checks (evidence: `README.md`)
- MLOps course → Batch pipelines: teaches orchestration (evidence: `README.md`)
- MLOps course → Data-centric workflows: teaches practices (evidence: `README.md`)
- MLOps course → Model deployment lab: teaches deployment (evidence: `README.md`)
- MLOps course → Chatbot interface: teaches chatbot (evidence: `README.md`)
