# sujith-mg/neurovision_ai architecture

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

- Interactive diagram: https://gitdiagram.com/sujith-mg/neurovision_ai
- Repository: https://github.com/sujith-mg/neurovision_ai

## Overview

NeuroVision AI is a Streamlit application for brain-MRI classification, tumor segmentation, and visual explanations. Its principal workflow accepts an uploaded MRI, preprocesses it, and presents classification, Grad-CAM, and segmentation results. The README also documents separate classifier and segmenter training workflows, plus home, model-information, and about pages. Edges reflect the sampled Analysis-page calls, SOURCE INDEX references, and README statements; several page and training implementation details were not sampled.

Main entry points: [`pages/2_🔬_Analysis.py`](https://github.com/sujith-mg/neurovision_ai/blob/main/pages/2_%F0%9F%94%AC_Analysis.py) (MRI analysis), [`models`](https://github.com/sujith-mg/neurovision_ai/tree/main/models) (Model weights), [`src/models/classifier.py`](https://github.com/sujith-mg/neurovision_ai/blob/main/src/models/classifier.py) (Tumor classifier), [`src/models/segmenter.py`](https://github.com/sujith-mg/neurovision_ai/blob/main/src/models/segmenter.py) (Tumor segmenter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Streamlit interface"]
  node_app["App entry<br/>[app.py]"]
  node_home["Home page<br/>[1_🏠_Home.py]"]
  node_analysis["MRI analysis<br/>[2_🔬_Analysis.py]"]
  node_modelinfo["Model info<br/>[3_📊_Model_Info.py]"]
  node_about["About page<br/>[4_ℹ️_About.py]"]
end

subgraph group_inference["MRI inference"]
  node_preprocessing["MRI preprocessing<br/>[preprocessing.py]"]
  node_classifier["Tumor classifier<br/>[classifier.py]"]
  node_gradcam["Grad-CAM<br/>[gradcam.py]"]
  node_segmenter["Tumor segmenter<br/>[segmenter.py]"]
  node_visualization["Result visualization<br/>[visualization.py]"]
end

subgraph group_training["Model training"]
  node_classifiertraining["Classifier training"]
  node_segmentertraining["Segmenter training<br/>[train_segmenter.py]"]
  node_weights[("Model weights")]
end

subgraph group_support["Shared support"]
  node_utils["Shared utilities<br/>[utils.py]"]
end

node_user(("MRI user"))

node_user -->|"opens"| node_app
node_app -.->|"serves page"| node_analysis
node_user -->|"uploads MRI"| node_analysis
node_analysis -->|"preprocesses"| node_preprocessing
node_analysis -->|"classifies"| node_classifier
node_analysis -->|"generates explanation"| node_gradcam
node_analysis -->|"segments"| node_segmenter
node_analysis -->|"renders results"| node_visualization
node_home -->|"checks model status"| node_utils
node_analysis -->|"checks model status"| node_utils
node_modelinfo -->|"checks model status"| node_utils
node_classifiertraining -->|"trains"| node_classifier
node_segmentertraining -->|"trains"| node_segmenter
node_classifiertraining -->|"saves weights"| node_weights
node_segmentertraining -->|"saves weights"| node_weights
node_classifier -.->|"loads weights"| node_weights
node_segmenter -.->|"loads weights"| node_weights

click node_app "https://github.com/sujith-mg/neurovision_ai/blob/main/app.py"
click node_home "https://github.com/sujith-mg/neurovision_ai/blob/main/pages/1_%F0%9F%8F%A0_Home.py"
click node_analysis "https://github.com/sujith-mg/neurovision_ai/blob/main/pages/2_%F0%9F%94%AC_Analysis.py"
click node_modelinfo "https://github.com/sujith-mg/neurovision_ai/blob/main/pages/3_%F0%9F%93%8A_Model_Info.py"
click node_about "https://github.com/sujith-mg/neurovision_ai/blob/main/pages/4_%E2%84%B9%EF%B8%8F_About.py"
click node_preprocessing "https://github.com/sujith-mg/neurovision_ai/blob/main/src/preprocessing.py"
click node_classifier "https://github.com/sujith-mg/neurovision_ai/blob/main/src/models/classifier.py"
click node_gradcam "https://github.com/sujith-mg/neurovision_ai/blob/main/src/models/gradcam.py"
click node_segmenter "https://github.com/sujith-mg/neurovision_ai/blob/main/src/models/segmenter.py"
click node_visualization "https://github.com/sujith-mg/neurovision_ai/blob/main/src/visualization.py"
click node_classifiertraining "https://github.com/sujith-mg/neurovision_ai/blob/main/train_classifier.py"
click node_segmentertraining "https://github.com/sujith-mg/neurovision_ai/blob/main/train_segmenter.py"
click node_weights "https://github.com/sujith-mg/neurovision_ai/tree/main/models"
click node_utils "https://github.com/sujith-mg/neurovision_ai/blob/main/src/utils.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_app,node_home,node_analysis,node_modelinfo,node_about,node_user toneBlue
class node_preprocessing,node_classifier,node_gradcam,node_segmenter,node_visualization toneAmber
class node_classifiertraining,node_segmentertraining,node_weights toneMint
class node_utils toneRose
```

## Components

### Streamlit interface

- [App entry](https://github.com/sujith-mg/neurovision_ai/blob/main/app.py): `app.py`
- [Home page](https://github.com/sujith-mg/neurovision_ai/blob/main/pages/1_%F0%9F%8F%A0_Home.py): `pages/1_🏠_Home.py`
- [MRI analysis](https://github.com/sujith-mg/neurovision_ai/blob/main/pages/2_%F0%9F%94%AC_Analysis.py): `pages/2_🔬_Analysis.py`
- [Model info](https://github.com/sujith-mg/neurovision_ai/blob/main/pages/3_%F0%9F%93%8A_Model_Info.py): `pages/3_📊_Model_Info.py`
- [About page](https://github.com/sujith-mg/neurovision_ai/blob/main/pages/4_%E2%84%B9%EF%B8%8F_About.py): `pages/4_ℹ️_About.py`

### MRI inference

- [MRI preprocessing](https://github.com/sujith-mg/neurovision_ai/blob/main/src/preprocessing.py): `src/preprocessing.py`
- [Tumor classifier](https://github.com/sujith-mg/neurovision_ai/blob/main/src/models/classifier.py): `src/models/classifier.py`
- [Grad-CAM](https://github.com/sujith-mg/neurovision_ai/blob/main/src/models/gradcam.py): `src/models/gradcam.py`
- [Tumor segmenter](https://github.com/sujith-mg/neurovision_ai/blob/main/src/models/segmenter.py): `src/models/segmenter.py`
- [Result visualization](https://github.com/sujith-mg/neurovision_ai/blob/main/src/visualization.py): `src/visualization.py`

### Model training

- [Classifier training](https://github.com/sujith-mg/neurovision_ai/blob/main/train_classifier.py): `train_classifier.py`
- [Segmenter training](https://github.com/sujith-mg/neurovision_ai/blob/main/train_segmenter.py): `train_segmenter.py`
- [Model weights](https://github.com/sujith-mg/neurovision_ai/tree/main/models): `models`

### Shared support

- [Shared utilities](https://github.com/sujith-mg/neurovision_ai/blob/main/src/utils.py): `src/utils.py`

### Other components

- **MRI user**

## Connections

- MRI user → App entry: opens (evidence: `README.md`)
- App entry → MRI analysis: serves page
- MRI user → MRI analysis: uploads MRI (evidence: `pages/2_🔬_Analysis.py`)
- MRI analysis → MRI preprocessing: preprocesses (evidence: `pages/2_🔬_Analysis.py`)
- MRI analysis → Tumor classifier: classifies (evidence: `README.md`)
- MRI analysis → Grad-CAM: generates explanation (evidence: `pages/2_🔬_Analysis.py`)
- MRI analysis → Tumor segmenter: segments (evidence: `README.md`)
- MRI analysis → Result visualization: renders results (evidence: `pages/2_🔬_Analysis.py`)
- Home page → Shared utilities: checks model status (evidence: `pages/1_🏠_Home.py`)
- MRI analysis → Shared utilities: checks model status (evidence: `pages/2_🔬_Analysis.py`)
- Model info → Shared utilities: checks model status (evidence: `pages/3_📊_Model_Info.py`)
- Classifier training → Tumor classifier: trains (evidence: `README.md`)
- Segmenter training → Tumor segmenter: trains (evidence: `README.md`)
- Classifier training → Model weights: saves weights (evidence: `README.md`)
- Segmenter training → Model weights: saves weights (evidence: `README.md`)
- Tumor classifier → Model weights: loads weights
- Tumor segmenter → Model weights: loads weights
