# sdthakur/kidneydiseaseclassification architecture

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

- Interactive diagram: https://gitdiagram.com/sdthakur/kidneydiseaseclassification
- Repository: https://github.com/sdthakur/kidneydiseaseclassification

## Overview

KidneyAI is a research prototype for classifying CT images as normal or tumor. Its user workflow accepts an image through a Flask web/API entry point, decodes it, runs multi-crop model inference, and returns a class and confidence values. A separate training workflow orchestrates ingestion, model preparation, training, and evaluation. The README documents additional console features and MLflow tracking; those subsystems are represented, though their implementation details were not sampled. Edges are limited to relationships shown in excerpts or documented in the README.

Main entry points: [`app.py`](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/app.py) (Flask routes), [`main.py`](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/main.py) (Training orchestrator), [`src/cnnClassifier/config/configuration.py`](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/config/configuration.py) (Configuration manager), [`src/cnnClassifier/entity/config_entity.py`](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/entity/config_entity.py) (Stage config types)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_serving["Inference and console"]
  node_flask["Flask routes<br/>[app.py]"]
  node_decoder["Image decoder<br/>[common.py]"]
  node_prediction["Multi-crop inference<br/>[prediction.py]"]
  node_weights[("Trained weights<br/>[model.h5]")]
  node_console["Diagnostic console<br/>[index.html]"]
end

subgraph group_workflow["Training workflow"]
  node_training_runner["Training orchestrator<br/>[main.py]"]
  node_ingestion_stage["Ingestion stage"]
  node_prepare_stage["Preparation stage"]
  node_training_stage["Training stage"]
  node_evaluation_stage["Evaluation stage"]
end

subgraph group_ml["Model lifecycle"]
  node_ingestion["Dataset ingestion<br/>[data_ingestion.py]"]
  node_base_model["VGG16 preparation"]
  node_trainer["Model training<br/>[model_training.py]"]
  node_evaluation["Metrics evaluation"]
  node_mlflow["MLflow tracking"]
end

subgraph group_config["Configuration"]
  node_configuration["Configuration manager<br/>[configuration.py]"]
  node_config_types["Stage config types<br/>[config_entity.py]"]
  node_utilities["Shared utilities<br/>[common.py]"]
end

node_user(("Browser / API client"))

node_user -->|"sends requests"| node_flask
node_flask -->|"renders page"| node_console
node_flask -->|"decodes image"| node_decoder
node_flask -->|"invokes inference"| node_prediction
node_prediction -->|"loads weights"| node_weights
node_flask -->|"returns prediction"| node_user
node_user -->|"requests training"| node_training_runner
node_flask -->|"launches runner"| node_training_runner
node_training_runner -->|"runs stage"| node_ingestion_stage
node_training_runner -->|"runs stage"| node_prepare_stage
node_training_runner -->|"runs stage"| node_training_stage
node_training_runner -->|"runs stage"| node_evaluation_stage
node_ingestion_stage -->|"gets config"| node_configuration
node_ingestion_stage -->|"runs ingestion"| node_ingestion
node_prepare_stage -->|"gets config"| node_configuration
node_prepare_stage -->|"prepares model"| node_base_model
node_training_stage -->|"gets config"| node_configuration
node_training_stage -->|"runs training"| node_trainer
node_evaluation_stage -->|"gets config"| node_configuration
node_evaluation_stage -->|"runs evaluation"| node_evaluation
node_configuration -->|"reads YAML"| node_utilities
node_configuration -->|"builds configs"| node_config_types
node_ingestion -->|"uses config"| node_config_types
node_base_model -->|"uses config"| node_config_types
node_trainer -->|"uses config"| node_config_types
node_evaluation -->|"uses config"| node_config_types
node_evaluation -->|"saves metrics"| node_utilities
node_evaluation -->|"logs metrics"| node_mlflow

click node_flask "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/app.py"
click node_decoder "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/utils/common.py"
click node_prediction "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/pipeline/prediction.py"
click node_weights "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/model/model.h5"
click node_console "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/templates/index.html"
click node_training_runner "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/main.py"
click node_ingestion_stage "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/pipeline/stage_01_data_ingestion.py"
click node_prepare_stage "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/pipeline/stage_02_prepare_base_model.py"
click node_training_stage "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/pipeline/stage_03_model_training.py"
click node_evaluation_stage "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/pipeline/stage_04_model_evaluation.py"
click node_ingestion "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/components/data_ingestion.py"
click node_base_model "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/components/prepare_base_model.py"
click node_trainer "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/components/model_training.py"
click node_evaluation "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/components/model_evaluation_mlflow.py"
click node_configuration "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/config/configuration.py"
click node_config_types "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/entity/config_entity.py"
click node_utilities "https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/utils/common.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_flask,node_decoder,node_prediction,node_weights,node_console,node_user toneBlue
class node_training_runner,node_ingestion_stage,node_prepare_stage,node_training_stage,node_evaluation_stage toneAmber
class node_ingestion,node_base_model,node_trainer,node_evaluation,node_mlflow toneMint
class node_configuration,node_config_types,node_utilities toneRose
```

## Components

### Inference and console

- [Flask routes](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/app.py): `app.py`
- [Image decoder](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/utils/common.py): `src/cnnClassifier/utils/common.py`
- [Multi-crop inference](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/pipeline/prediction.py): `src/cnnClassifier/pipeline/prediction.py`
- [Trained weights](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/model/model.h5): `model/model.h5`
- [Diagnostic console](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/templates/index.html): `templates/index.html`

### Training workflow

- [Training orchestrator](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/main.py): `main.py`
- [Ingestion stage](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/pipeline/stage_01_data_ingestion.py): `src/cnnClassifier/pipeline/stage_01_data_ingestion.py`
- [Preparation stage](https://github.com/sdthakur/kidneydiseaseclassification/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/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/pipeline/stage_03_model_training.py): `src/cnnClassifier/pipeline/stage_03_model_training.py`
- [Evaluation stage](https://github.com/sdthakur/kidneydiseaseclassification/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/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/components/data_ingestion.py): `src/cnnClassifier/components/data_ingestion.py`
- [VGG16 preparation](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/components/prepare_base_model.py): `src/cnnClassifier/components/prepare_base_model.py`
- [Model training](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/components/model_training.py): `src/cnnClassifier/components/model_training.py`
- [Metrics evaluation](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/components/model_evaluation_mlflow.py): `src/cnnClassifier/components/model_evaluation_mlflow.py`
- **MLflow tracking**

### Configuration

- [Configuration manager](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/config/configuration.py): `src/cnnClassifier/config/configuration.py`
- [Stage config types](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/entity/config_entity.py): `src/cnnClassifier/entity/config_entity.py`
- [Shared utilities](https://github.com/sdthakur/kidneydiseaseclassification/blob/main/src/cnnClassifier/utils/common.py): `src/cnnClassifier/utils/common.py`

### Other components

- **Browser / API client**

## Connections

- Browser / API client → Flask routes: sends requests (evidence: `README.md`)
- Flask routes → Diagnostic console: renders page (evidence: `app.py`)
- Flask routes → Image decoder: decodes image (evidence: `app.py`)
- Flask routes → Multi-crop inference: invokes inference (evidence: `app.py`)
- Multi-crop inference → Trained weights: loads weights (evidence: `src/cnnClassifier/pipeline/prediction.py`)
- Flask routes → Browser / API client: returns prediction (evidence: `README.md`)
- Browser / API client → Training orchestrator: requests training
- Flask routes → Training orchestrator: launches runner (evidence: `app.py`)
- Training orchestrator → Ingestion stage: runs stage (evidence: `main.py`)
- Training orchestrator → Preparation stage: runs stage (evidence: `main.py`)
- Training orchestrator → Training stage: runs stage (evidence: `main.py`)
- Training orchestrator → Evaluation stage: runs stage (evidence: `main.py`)
- Ingestion stage → Configuration manager: gets config (evidence: `src/cnnClassifier/pipeline/stage_01_data_ingestion.py`)
- Ingestion stage → Dataset ingestion: runs ingestion (evidence: `src/cnnClassifier/pipeline/stage_01_data_ingestion.py`)
- Preparation stage → Configuration manager: gets config (evidence: `src/cnnClassifier/pipeline/stage_02_prepare_base_model.py`)
- Preparation stage → VGG16 preparation: prepares model (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 → Model training: runs training (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 → Metrics evaluation: runs evaluation (evidence: `src/cnnClassifier/pipeline/stage_04_model_evaluation.py`)
- Configuration manager → Shared utilities: reads YAML (evidence: `src/cnnClassifier/config/configuration.py`)
- Configuration manager → Stage config types: builds configs (evidence: `src/cnnClassifier/config/configuration.py`)
- Dataset ingestion → Stage config types: uses config (evidence: `src/cnnClassifier/components/data_ingestion.py`)
- VGG16 preparation → Stage config types: uses config (evidence: `src/cnnClassifier/components/prepare_base_model.py`)
- Model training → Stage config types: uses config (evidence: `src/cnnClassifier/components/model_training.py`)
- Metrics evaluation → Stage config types: uses config (evidence: `src/cnnClassifier/components/model_evaluation_mlflow.py`)
- Metrics evaluation → Shared utilities: saves metrics (evidence: `src/cnnClassifier/components/model_evaluation_mlflow.py`)
- Metrics evaluation → MLflow tracking: logs metrics (evidence: `README.md`)
