# ansshahzadd/neural-network-model-to-predict-handwritten-digits architecture

> Architecture diagram of the GitHub repository ansshahzadd/neural-network-model-to-predict-handwritten-digits, 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/ansshahzadd/neural-network-model-to-predict-handwritten-digits
- Repository: https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits

## Overview

This is a small MNIST digit-classification training project, not a deployed inference service in the repository. Its main workflow loads MNIST, prepares image and label tensors, trains a CNN, evaluates test accuracy, and saves the model. The README also documents a Colab notebook route and links to a hosted drawing demo; the demo implementation is external. Internal stages share main.py because the script implements them together.

Main entry points: [`main.py`](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py) (Training script), [`train.ipynb`](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/train.ipynb) (Colab training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_training["Model training"]
  node_script["Training script<br/>[main.py]"]
  node_mnist[("MNIST dataset<br/>[main.py]")]
  node_prep["Data preparation<br/>[main.py]"]
  node_augment["Image augmentation<br/>[main.py]"]
  node_cnn["CNN classifier<br/>[main.py]"]
  node_fit["Model training<br/>[main.py]"]
  node_evaluate["Test evaluation<br/>[main.py]"]
  node_artifact["Saved model<br/>[main.py]"]
  node_notebook["Colab training<br/>[train.ipynb]"]
end

subgraph group_demo["Hosted demo"]
  node_hosted["Hosted drawing demo"]
end

node_user(("Digit user"))

node_script -->|"loads"| node_mnist
node_script -->|"prepares"| node_prep
node_script -->|"configures"| node_augment
node_script -->|"defines"| node_cnn
node_script -->|"trains"| node_fit
node_script -->|"evaluates"| node_evaluate
node_script -->|"saves"| node_artifact
node_fit -->|"fits"| node_cnn
node_evaluate -->|"tests"| node_cnn
node_user -->|"runs training"| node_notebook
node_user -->|"draws digits"| node_hosted

click node_script "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py"
click node_mnist "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py"
click node_prep "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py"
click node_augment "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py"
click node_cnn "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py"
click node_fit "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py"
click node_evaluate "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py"
click node_artifact "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py"
click node_notebook "https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/train.ipynb"

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_script,node_mnist,node_prep,node_augment,node_cnn,node_fit,node_evaluate,node_artifact,node_notebook,node_user toneBlue
class node_hosted toneAmber
```

## Components

### Model training

- [Training script](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py): `main.py`
- [MNIST dataset](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py): `main.py`
- [Data preparation](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py): `main.py`
- [Image augmentation](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py): `main.py`
- [CNN classifier](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py): `main.py`
- [Model training](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py): `main.py`
- [Test evaluation](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py): `main.py`
- [Saved model](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/main.py): `main.py`
- [Colab training](https://github.com/ansshahzadd/neural-network-model-to-predict-handwritten-digits/blob/main/train.ipynb): `train.ipynb`

### Hosted demo

- **Hosted drawing demo**

### Other components

- **Digit user**

## Connections

- Training script → MNIST dataset: loads (evidence: `main.py`)
- Training script → Data preparation: prepares (evidence: `main.py`)
- Training script → Image augmentation: configures (evidence: `main.py`)
- Training script → CNN classifier: defines (evidence: `main.py`)
- Training script → Model training: trains (evidence: `main.py`)
- Training script → Test evaluation: evaluates (evidence: `main.py`)
- Training script → Saved model: saves (evidence: `main.py`)
- Model training → CNN classifier: fits (evidence: `main.py`)
- Test evaluation → CNN classifier: tests (evidence: `main.py`)
- Digit user → Colab training: runs training (evidence: `README.md`)
- Digit user → Hosted drawing demo: draws digits (evidence: `README.md`)
