# ganeshkumar-133/handwritten-digit-recognition- architecture

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

- Interactive diagram: https://gitdiagram.com/ganeshkumar-133/handwritten-digit-recognition-
- Repository: https://github.com/ganeshkumar-133/handwritten-digit-recognition-

## Overview

This is an MNIST handwritten-digit classifier with two user-facing workflows: `main.py` trains and evaluates an MLP, while the desktop uploader predicts a digit from an image and displays confidence. Training loads and preprocesses MNIST, builds and fits the model, then saves a checkpoint and training curves; evaluation reloads the checkpoint and reports metrics with a confusion matrix. Image prediction preprocesses an uploaded image before model inference. Edges reflect the shown calls and documented workflow; unsampled artifacts are included only where their roles are supported.

Main entry points: [`src/train.py`](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/train.py) (Model training), [`config.py`](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/config.py) (Project configuration), [`src/evaluate.py`](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/evaluate.py) (Model evaluation), [`src/upload_app.py`](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/upload_app.py) (Image uploader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow"]
  node_pipeline["Pipeline entry<br/>[main.py]"]
  node_uploader["Image uploader<br/>[upload_app.py]"]
end

subgraph group_learning["Training and evaluation"]
  node_mnist[("MNIST dataset")]
  node_data["Data preprocessing<br/>[data_loader.py]"]
  node_architecture["MLP architecture<br/>[model.py]"]
  node_training["Model training<br/>[train.py]"]
  node_evaluation["Model evaluation<br/>[evaluate.py]"]
end

subgraph group_inference["Image inference"]
  node_prediction["Digit prediction<br/>[predict.py]"]
end

subgraph group_artifacts["Shared configuration and artifacts"]
  node_config["Project configuration<br/>[config.py]"]
  node_model_file["Saved model<br/>[mlp_mnist.h5]"]
  node_training_curves["Training curves"]
  node_evaluation_output["Evaluation report"]
end

node_user(("User"))

node_user -->|"runs"| node_pipeline
node_pipeline -->|"starts training"| node_training
node_pipeline -->|"then evaluates"| node_evaluation
node_user -->|"uploads image"| node_uploader
node_uploader -->|"requests prediction"| node_prediction
node_mnist -->|"provides data"| node_data
node_training -->|"loads data"| node_data
node_training -->|"builds model"| node_architecture
node_training -->|"saves checkpoint"| node_model_file
node_training -->|"saves curves"| node_training_curves
node_evaluation -->|"loads test data"| node_data
node_evaluation -->|"loads checkpoint"| node_model_file
node_evaluation -->|"saves matrix"| node_evaluation_output
node_prediction -->|"loads model"| node_model_file
node_uploader -->|"loads model"| node_model_file
node_training -->|"reads settings"| node_config
node_data -->|"reads settings"| node_config
node_architecture -->|"reads settings"| node_config
node_evaluation -->|"reads settings"| node_config
node_prediction -->|"reads settings"| node_config
node_uploader -->|"reads model path"| node_config

click node_pipeline "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/main.py"
click node_uploader "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/upload_app.py"
click node_data "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/data_loader.py"
click node_architecture "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/model.py"
click node_training "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/train.py"
click node_evaluation "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/evaluate.py"
click node_prediction "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/predict.py"
click node_config "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/config.py"
click node_model_file "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/models/mlp_mnist.h5"
click node_training_curves "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/tree/master/outputs"
click node_evaluation_output "https://github.com/ganeshkumar-133/handwritten-digit-recognition-/tree/master/outputs"

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_pipeline,node_uploader,node_user toneBlue
class node_mnist,node_data,node_architecture,node_training,node_evaluation toneAmber
class node_prediction toneMint
class node_config,node_model_file,node_training_curves,node_evaluation_output toneRose
```

## Components

### Workflow

- [Pipeline entry](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/main.py): `main.py`
- [Image uploader](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/upload_app.py): `src/upload_app.py`

### Training and evaluation

- **MNIST dataset**
- [Data preprocessing](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/data_loader.py): `src/data_loader.py`
- [MLP architecture](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/model.py): `src/model.py`
- [Model training](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/train.py): `src/train.py`
- [Model evaluation](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/evaluate.py): `src/evaluate.py`

### Image inference

- [Digit prediction](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/src/predict.py): `src/predict.py`

### Shared configuration and artifacts

- [Project configuration](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/config.py): `config.py`
- [Saved model](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/blob/master/models/mlp_mnist.h5): `models/mlp_mnist.h5`
- [Training curves](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/tree/master/outputs): `outputs`
- [Evaluation report](https://github.com/ganeshkumar-133/handwritten-digit-recognition-/tree/master/outputs): `outputs`

### Other components

- **User**

## Connections

- User → Pipeline entry: runs (evidence: `README`)
- Pipeline entry → Model training: starts training (evidence: `main.py`)
- Pipeline entry → Model evaluation: then evaluates (evidence: `main.py`)
- User → Image uploader: uploads image (evidence: `README`)
- Image uploader → Digit prediction: requests prediction (evidence: `src/upload_app.py`)
- MNIST dataset → Data preprocessing: provides data (evidence: `src/data_loader.py`)
- Model training → Data preprocessing: loads data (evidence: `src/train.py`)
- Model training → MLP architecture: builds model (evidence: `src/train.py`)
- Model training → Saved model: saves checkpoint (evidence: `src/train.py`)
- Model training → Training curves: saves curves (evidence: `src/train.py`)
- Model evaluation → Data preprocessing: loads test data (evidence: `src/evaluate.py`)
- Model evaluation → Saved model: loads checkpoint (evidence: `src/evaluate.py`)
- Model evaluation → Evaluation report: saves matrix (evidence: `src/evaluate.py`)
- Digit prediction → Saved model: loads model (evidence: `src/predict.py`)
- Image uploader → Saved model: loads model (evidence: `src/upload_app.py`)
- Model training → Project configuration: reads settings (evidence: `src/train.py`)
- Data preprocessing → Project configuration: reads settings (evidence: `src/data_loader.py`)
- MLP architecture → Project configuration: reads settings (evidence: `src/model.py`)
- Model evaluation → Project configuration: reads settings (evidence: `src/evaluate.py`)
- Digit prediction → Project configuration: reads settings (evidence: `src/predict.py`)
- Image uploader → Project configuration: reads model path (evidence: `src/upload_app.py`)
