# kallappa2005/mlops_kidney_disease_cnn architecture

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

- Interactive diagram: https://gitdiagram.com/kallappa2005/mlops_kidney_disease_cnn
- Repository: https://github.com/kallappa2005/mlops_kidney_disease_cnn

## Overview

This repository is a kidney CT image classifier with a training workflow and Flask inference service. Training runs through ingestion, base-model preparation, training, then evaluation; serving accepts an uploaded image, decodes it, and runs the saved model for a Normal/Tumor result. Configuration and shared utilities support these paths, while DVC versioning and MLflow experiment tracking are documented capabilities. Edges reflect the excerpts, source-index references, or README; the internal implementations of several components were not sampled.

Main entry points: [`src/cnnClassifier/config/configuration.py`](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/config/configuration.py) (Configuration manager), [`main.py`](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/main.py) (Training entry), [`src/cnnClassifier/pipeline/stage_01_data_ingestion.py`](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_01_data_ingestion.py) (Data ingestion stage), [`src/cnnClassifier/pipeline/stage_02_prepare_base_model.py`](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_02_prepare_base_model.py) (Base preparation stage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_training["Training workflow"]
  node_main["Training entry<br/>[main.py]"]
  node_ingest_stage["Data ingestion stage"]
  node_prepare_stage["Base preparation stage"]
  node_train_stage["Training stage"]
  node_eval_stage["Evaluation stage"]
end

subgraph group_ml["Model lifecycle"]
  node_ingestion["Dataset ingestion<br/>[data_ingestion.py]"]
  node_base_model["Base model preparation"]
  node_training_component["CNN training<br/>[model_training.py]"]
  node_evaluation["Model evaluation"]
  node_dataset["CT image dataset"]
  node_model_artifact["Saved model<br/>[model.h5]"]
end

subgraph group_serving["Prediction service"]
  node_flask_app["Flask routes<br/>[app.py]"]
  node_web_ui["Upload UI<br/>[index.html]"]
  node_image_decode["Image decoding<br/>[common.py]"]
  node_predictor["Prediction pipeline<br/>[prediction.py]"]
end

subgraph group_support["Configuration and tracking"]
  node_config_manager["Configuration manager<br/>[configuration.py]"]
  node_config_entities["Stage config entities<br/>[config_entity.py]"]
  node_shared_utils["Shared utilities<br/>[common.py]"]
  node_project_config["Project settings<br/>[config.yaml]"]
  node_training_params["Training parameters<br/>[params.yaml]"]
  node_dvc["DVC versioning<br/>[dvc.yaml]"]
  node_tracking[("MLflow tracking")]
end

node_operator(("Pipeline operator"))
node_image_sender(("Image submitter"))

node_operator -->|"runs"| node_main
node_main -->|"runs"| node_ingest_stage
node_main -->|"runs"| node_prepare_stage
node_main -->|"runs"| node_train_stage
node_main -->|"runs"| node_eval_stage
node_ingest_stage -->|"gets config"| node_config_manager
node_ingest_stage -->|"invokes"| node_ingestion
node_prepare_stage -->|"gets config"| node_config_manager
node_prepare_stage -->|"invokes"| node_base_model
node_train_stage -->|"gets config"| node_config_manager
node_train_stage -->|"invokes"| node_training_component
node_eval_stage -->|"gets config"| node_config_manager
node_eval_stage -->|"invokes"| node_evaluation
node_config_manager -->|"builds"| node_config_entities
node_config_manager -->|"reads settings"| node_shared_utils
node_config_manager -->|"loads"| node_project_config
node_config_manager -->|"loads"| node_training_params
node_ingestion -->|"downloads and extracts"| node_dataset
node_training_component -.->|"trains on"| node_dataset
node_evaluation -->|"loads"| node_model_artifact
node_evaluation -->|"logs metrics"| node_tracking
node_dvc -->|"versions data"| node_dataset
node_dvc -->|"versions outputs"| node_model_artifact
node_image_sender -->|"opens"| node_web_ui
node_web_ui -->|"submits image"| node_flask_app
node_flask_app -->|"decodes upload"| node_image_decode
node_flask_app -->|"requests prediction"| node_predictor
node_predictor -->|"loads model"| node_model_artifact

click node_main "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/main.py"
click node_ingest_stage "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_01_data_ingestion.py"
click node_prepare_stage "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_02_prepare_base_model.py"
click node_train_stage "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_03_model_training.py"
click node_eval_stage "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_04_model_evaluation.py"
click node_ingestion "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/components/data_ingestion.py"
click node_base_model "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/components/prepare_base_model.py"
click node_training_component "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/components/model_training.py"
click node_evaluation "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/components/model_evaluation_mlflow.py"
click node_config_manager "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/config/configuration.py"
click node_config_entities "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/entity/config_entity.py"
click node_shared_utils "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/utils/common.py"
click node_project_config "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/config/config.yaml"
click node_training_params "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/params.yaml"
click node_dvc "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/dvc.yaml"
click node_model_artifact "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/model/model.h5"
click node_flask_app "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/app.py"
click node_web_ui "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/templates/index.html"
click node_image_decode "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/utils/common.py"
click node_predictor "https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/prediction.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_main,node_ingest_stage,node_prepare_stage,node_train_stage,node_eval_stage toneBlue
class node_ingestion,node_base_model,node_training_component,node_evaluation,node_dataset,node_model_artifact toneAmber
class node_flask_app,node_web_ui,node_image_decode,node_predictor toneMint
class node_config_manager,node_config_entities,node_shared_utils,node_project_config,node_training_params,node_dvc,node_tracking toneRose
class node_operator,node_image_sender toneIndigo
```

## Components

### Training workflow

- [Training entry](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/main.py): `main.py`
- [Data ingestion stage](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_01_data_ingestion.py): `src/cnnClassifier/pipeline/stage_01_data_ingestion.py`
- [Base preparation stage](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_02_prepare_base_model.py): `src/cnnClassifier/pipeline/stage_02_prepare_base_model.py`
- [Training stage](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_03_model_training.py): `src/cnnClassifier/pipeline/stage_03_model_training.py`
- [Evaluation stage](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/stage_04_model_evaluation.py): `src/cnnClassifier/pipeline/stage_04_model_evaluation.py`

### Model lifecycle

- [Dataset ingestion](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/components/data_ingestion.py): `src/cnnClassifier/components/data_ingestion.py`
- [Base model preparation](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/components/prepare_base_model.py): `src/cnnClassifier/components/prepare_base_model.py`
- [CNN training](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/components/model_training.py): `src/cnnClassifier/components/model_training.py`
- [Model evaluation](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/components/model_evaluation_mlflow.py): `src/cnnClassifier/components/model_evaluation_mlflow.py`
- **CT image dataset**
- [Saved model](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/model/model.h5): `model/model.h5`

### Prediction service

- [Flask routes](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/app.py): `app.py`
- [Upload UI](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/templates/index.html): `templates/index.html`
- [Image decoding](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/utils/common.py): `src/cnnClassifier/utils/common.py`
- [Prediction pipeline](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/pipeline/prediction.py): `src/cnnClassifier/pipeline/prediction.py`

### Configuration and tracking

- [Configuration manager](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/config/configuration.py): `src/cnnClassifier/config/configuration.py`
- [Stage config entities](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/entity/config_entity.py): `src/cnnClassifier/entity/config_entity.py`
- [Shared utilities](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/src/cnnClassifier/utils/common.py): `src/cnnClassifier/utils/common.py`
- [Project settings](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/config/config.yaml): `config/config.yaml`
- [Training parameters](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/params.yaml): `params.yaml`
- [DVC versioning](https://github.com/kallappa2005/mlops_kidney_disease_cnn/blob/main/dvc.yaml): `dvc.yaml`
- **MLflow tracking**

### Other components

- **Pipeline operator**
- **Image submitter**

## Connections

- Pipeline operator → Training entry: runs (evidence: `README.md`)
- Training entry → Data ingestion stage: runs (evidence: `main.py`)
- Training entry → Base preparation stage: runs (evidence: `main.py`)
- Training entry → Training stage: runs (evidence: `main.py`)
- Training entry → Evaluation stage: runs (evidence: `main.py`)
- Data ingestion stage → Configuration manager: gets config (evidence: `src/cnnClassifier/pipeline/stage_01_data_ingestion.py`)
- Data ingestion stage → Dataset ingestion: invokes (evidence: `src/cnnClassifier/pipeline/stage_01_data_ingestion.py`)
- Base preparation stage → Configuration manager: gets config (evidence: `src/cnnClassifier/pipeline/stage_02_prepare_base_model.py`)
- Base preparation stage → Base model preparation: invokes (evidence: `src/cnnClassifier/pipeline/stage_02_prepare_base_model.py`)
- Training stage → Configuration manager: gets config (evidence: `src/cnnClassifier/pipeline/stage_03_model_training.py`)
- Training stage → CNN training: invokes (evidence: `src/cnnClassifier/pipeline/stage_03_model_training.py`)
- Evaluation stage → Configuration manager: gets config (evidence: `src/cnnClassifier/pipeline/stage_04_model_evaluation.py`)
- Evaluation stage → Model evaluation: invokes (evidence: `src/cnnClassifier/pipeline/stage_04_model_evaluation.py`)
- Configuration manager → Stage config entities: builds (evidence: `src/cnnClassifier/config/configuration.py`)
- Configuration manager → Shared utilities: reads settings (evidence: `src/cnnClassifier/config/configuration.py`)
- Configuration manager → Project settings: loads (evidence: `README.md`)
- Configuration manager → Training parameters: loads (evidence: `README.md`)
- Dataset ingestion → CT image dataset: downloads and extracts (evidence: `src/cnnClassifier/components/data_ingestion.py`)
- CNN training → CT image dataset: trains on
- Model evaluation → Saved model: loads (evidence: `src/cnnClassifier/components/model_evaluation_mlflow.py`)
- Model evaluation → MLflow tracking: logs metrics (evidence: `src/cnnClassifier/components/model_evaluation_mlflow.py`)
- DVC versioning → CT image dataset: versions data (evidence: `README.md`)
- DVC versioning → Saved model: versions outputs (evidence: `README.md`)
- Image submitter → Upload UI: opens (evidence: `README.md`)
- Upload UI → Flask routes: submits image (evidence: `README.md`)
- Flask routes → Image decoding: decodes upload (evidence: `app.py`)
- Flask routes → Prediction pipeline: requests prediction (evidence: `app.py`)
- Prediction pipeline → Saved model: loads model (evidence: `src/cnnClassifier/pipeline/prediction.py`)
