# priyanshu-18-soni/admission-predictor architecture

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

- Interactive diagram: https://gitdiagram.com/priyanshu-18-soni/admission-predictor
- Repository: https://github.com/priyanshu-18-soni/admission-predictor

## Overview

This is a Streamlit graduate-admission predictor. A student enters seven applicant attributes, submits them, and receives a predicted admission probability with a threshold-based interpretation. The app loads a saved Linear Regression model or trains one from the CSV when loading fails; a separate script can train and save the model. The source excerpts show these flows, but the CSV and serialized model contents were not inspected.

Main entry points: [`app.py`](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py) (Prediction), [`train_model.py`](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/train_model.py) (Training script), [`model.pkl`](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/model.pkl) (Saved model), [`admission_data.csv`](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/admission_data.csv) (Applicant dataset)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student experience"]
  node_form["Applicant form<br/>[app.py]"]
  node_encoding["Input encoding<br/>[app.py]"]
  node_result["Chance result<br/>[app.py]"]
end

subgraph group_runtime["Prediction runtime"]
  node_loader["Model loader<br/>[app.py]"]
  node_inference["Prediction<br/>[app.py]"]
  node_fallback["Fallback training<br/>[app.py]"]
  node_artifact["Saved model<br/>[model.pkl]"]
end

subgraph group_training["Model training"]
  node_dataset[("Applicant dataset<br/>[admission_data.csv]")]
  node_trainer["Training script<br/>[train_model.py]"]
end

node_student(("Student"))

node_student -->|"enters scores"| node_form
node_form -->|"collects inputs"| node_encoding
node_encoding -->|"submits features"| node_inference
node_loader -->|"loads model"| node_artifact
node_loader -->|"trains if needed"| node_fallback
node_fallback -->|"reads data"| node_dataset
node_fallback -->|"fits model"| node_inference
node_loader -->|"provides model"| node_inference
node_inference -->|"predicts chance"| node_result
node_trainer -->|"reads data"| node_dataset
node_trainer -->|"saves model"| node_artifact

click node_form "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py"
click node_encoding "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py"
click node_result "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py"
click node_loader "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py"
click node_inference "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py"
click node_fallback "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py"
click node_artifact "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/model.pkl"
click node_dataset "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/admission_data.csv"
click node_trainer "https://github.com/priyanshu-18-soni/admission-predictor/blob/main/train_model.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_form,node_encoding,node_result toneBlue
class node_loader,node_inference,node_fallback,node_artifact toneAmber
class node_dataset,node_trainer toneMint
class node_student toneIndigo
```

## Components

### Student experience

- [Applicant form](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py): `app.py`
- [Input encoding](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py): `app.py`
- [Chance result](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py): `app.py`

### Prediction runtime

- [Model loader](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py): `app.py`
- [Prediction](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py): `app.py`
- [Fallback training](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/app.py): `app.py`
- [Saved model](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/model.pkl): `model.pkl`

### Model training

- [Applicant dataset](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/admission_data.csv): `admission_data.csv`
- [Training script](https://github.com/priyanshu-18-soni/admission-predictor/blob/main/train_model.py): `train_model.py`

### Other components

- **Student**

## Connections

- Student → Applicant form: enters scores (evidence: `README.md`)
- Applicant form → Input encoding: collects inputs (evidence: `app.py`)
- Input encoding → Prediction: submits features (evidence: `app.py`)
- Model loader → Saved model: loads model (evidence: `app.py`)
- Model loader → Fallback training: trains if needed (evidence: `app.py`)
- Fallback training → Applicant dataset: reads data (evidence: `app.py`)
- Fallback training → Prediction: fits model (evidence: `app.py`)
- Model loader → Prediction: provides model (evidence: `app.py`)
- Prediction → Chance result: predicts chance (evidence: `app.py`)
- Training script → Applicant dataset: reads data (evidence: `train_model.py`)
- Training script → Saved model: saves model (evidence: `train_model.py`)
