# subhamgupta9/shadowfox-ml-engineer-internship architecture

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

- Interactive diagram: https://gitdiagram.com/subhamgupta9/shadowfox-ml-engineer-internship
- Repository: https://github.com/subhamgupta9/shadowfox-ml-engineer-internship

## Overview

ShadowFox is an internship portfolio containing three distinct ML applications: image classification, used-car valuation, and a language-model research lab. In each, users interact through a Streamlit app and receive predictions or evaluation views. The graph includes the documented training, benchmarking, and inspection capabilities, but source evidence is incomplete: unsampled subsystems and some app-to-runtime wiring are shown only where the README or source index supports them.

Main entry points: [`Task-3/Task-3-Language-Model-Deployment/app/app.py`](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/app.py) (NEXUS App), [`Task-3/Task-3-Language-Model-Deployment/src/model_engine.py`](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/src/model_engine.py) (FLAN-T5 Engine), [`Task-1/Task-1-Image-Tagging/app.py`](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-1/Task-1-Image-Tagging/app.py) (Image App), [`Task-2/Task-2-Car-Selling-Price-Prediction/app/app.py`](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/app/app.py) (Valuation Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vision["Image Tagging"]
  node_image_app["Image App<br/>[app.py]"]
  node_image_inference["Image Inference<br/>[predict.py]"]
  node_image_model["MobileNetV2 Model"]
end

subgraph group_cars["Car Valuation"]
  node_car_app["Valuation Dashboard<br/>[app.py]"]
  node_car_predict["Price Prediction<br/>[predict.py]"]
  node_car_model["Trained Model"]
  node_car_data[("Vehicle Dataset<br/>[car.csv]")]
  node_car_preprocess["Data Preparation"]
  node_car_train["Model Training<br/>[train.py]"]
  node_car_evaluate["Model Evaluation<br/>[evaluate.py]"]
end

subgraph group_nlp_ui["NLP Research Lab"]
  node_nlp_app["NEXUS App<br/>[app.py]"]
  node_nlp_header["UI Header<br/>[ui_header.py]"]
  node_nlp_lab["Interactive Lab<br/>[tab_lab.py]"]
  node_nlp_benchmark_ui["Benchmark Dashboard<br/>[tab_benchmark.py]"]
  node_nlp_comparator["Strategy Comparator<br/>[tab_comparator.py]"]
  node_nlp_inspector["Model Inspector<br/>[tab_inspector.py]"]
end

subgraph group_nlp_core["NLP Inference and Evaluation"]
  node_nlp_engine["FLAN-T5 Engine<br/>[model_engine.py]"]
  node_nlp_benchmark["Benchmark Runner<br/>[benchmark.py]"]
  node_nlp_metrics["Evaluation Metrics<br/>[metrics.py]"]
end

node_user(("User"))

node_user -->|"uploads image"| node_image_app
node_image_app -->|"calls inference"| node_image_inference
node_image_inference -->|"loads model"| node_image_model
node_image_app -->|"shows classification"| node_user
node_user -->|"enters vehicle details"| node_car_app
node_car_app -.->|"requests valuation"| node_car_predict
node_car_predict -.->|"uses model"| node_car_model
node_car_app -->|"shows estimate and insights"| node_user
node_car_train -->|"uses preparation"| node_car_preprocess
node_car_train -->|"uses evaluation"| node_car_evaluate
node_car_preprocess -->|"reads dataset"| node_car_data
node_user -->|"opens research lab"| node_nlp_app
node_nlp_app -->|"initializes engine"| node_nlp_engine
node_nlp_app -->|"renders header"| node_nlp_header
node_nlp_app -->|"renders tab"| node_nlp_lab
node_nlp_app -->|"renders tab"| node_nlp_benchmark_ui
node_nlp_app -->|"renders tab"| node_nlp_comparator
node_nlp_app -->|"renders tab"| node_nlp_inspector
node_nlp_lab -->|"runs generation"| node_nlp_engine
node_nlp_comparator -->|"compares generation"| node_nlp_engine
node_nlp_inspector -->|"reads specifications"| node_nlp_engine
node_nlp_benchmark -.->|"evaluates outputs"| node_nlp_metrics
node_nlp_app -->|"presents research views"| node_user

click node_image_app "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-1/Task-1-Image-Tagging/app.py"
click node_image_inference "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-1/Task-1-Image-Tagging/src/predict.py"
click node_image_model "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-1/Task-1-Image-Tagging/shadowfox_cats_dogs_mobilenetv2.keras"
click node_car_app "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/app/app.py"
click node_car_predict "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/src/predict.py"
click node_car_model "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/models/car_price_model.joblib"
click node_car_data "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/dataset/car.csv"
click node_car_preprocess "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/src/data_preprocessing.py"
click node_car_train "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/src/train.py"
click node_car_evaluate "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/src/evaluate.py"
click node_nlp_app "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/app.py"
click node_nlp_header "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/ui_header.py"
click node_nlp_lab "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/tab_lab.py"
click node_nlp_benchmark_ui "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/tab_benchmark.py"
click node_nlp_comparator "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/tab_comparator.py"
click node_nlp_inspector "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/tab_inspector.py"
click node_nlp_engine "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/src/model_engine.py"
click node_nlp_benchmark "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/src/benchmark.py"
click node_nlp_metrics "https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/src/metrics.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_image_app,node_image_inference,node_image_model,node_user toneBlue
class node_car_app,node_car_predict,node_car_model,node_car_data,node_car_preprocess,node_car_train,node_car_evaluate toneAmber
class node_nlp_app,node_nlp_header,node_nlp_lab,node_nlp_benchmark_ui,node_nlp_comparator,node_nlp_inspector toneMint
class node_nlp_engine,node_nlp_benchmark,node_nlp_metrics toneRose
```

## Components

### Image Tagging

- [Image App](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-1/Task-1-Image-Tagging/app.py): `Task-1/Task-1-Image-Tagging/app.py`
- [Image Inference](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-1/Task-1-Image-Tagging/src/predict.py): `Task-1/Task-1-Image-Tagging/src/predict.py`
- [MobileNetV2 Model](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-1/Task-1-Image-Tagging/shadowfox_cats_dogs_mobilenetv2.keras): `Task-1/Task-1-Image-Tagging/shadowfox_cats_dogs_mobilenetv2.keras`

### Car Valuation

- [Valuation Dashboard](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/app/app.py): `Task-2/Task-2-Car-Selling-Price-Prediction/app/app.py`
- [Price Prediction](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/src/predict.py): `Task-2/Task-2-Car-Selling-Price-Prediction/src/predict.py`
- [Trained Model](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/models/car_price_model.joblib): `Task-2/Task-2-Car-Selling-Price-Prediction/models/car_price_model.joblib`
- [Vehicle Dataset](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/dataset/car.csv): `Task-2/Task-2-Car-Selling-Price-Prediction/dataset/car.csv`
- [Data Preparation](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/src/data_preprocessing.py): `Task-2/Task-2-Car-Selling-Price-Prediction/src/data_preprocessing.py`
- [Model Training](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/src/train.py): `Task-2/Task-2-Car-Selling-Price-Prediction/src/train.py`
- [Model Evaluation](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-2/Task-2-Car-Selling-Price-Prediction/src/evaluate.py): `Task-2/Task-2-Car-Selling-Price-Prediction/src/evaluate.py`

### NLP Research Lab

- [NEXUS App](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/app.py): `Task-3/Task-3-Language-Model-Deployment/app/app.py`
- [UI Header](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/ui_header.py): `Task-3/Task-3-Language-Model-Deployment/app/components/ui_header.py`
- [Interactive Lab](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/tab_lab.py): `Task-3/Task-3-Language-Model-Deployment/app/components/tab_lab.py`
- [Benchmark Dashboard](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/tab_benchmark.py): `Task-3/Task-3-Language-Model-Deployment/app/components/tab_benchmark.py`
- [Strategy Comparator](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/tab_comparator.py): `Task-3/Task-3-Language-Model-Deployment/app/components/tab_comparator.py`
- [Model Inspector](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/app/components/tab_inspector.py): `Task-3/Task-3-Language-Model-Deployment/app/components/tab_inspector.py`

### NLP Inference and Evaluation

- [FLAN-T5 Engine](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/src/model_engine.py): `Task-3/Task-3-Language-Model-Deployment/src/model_engine.py`
- [Benchmark Runner](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/src/benchmark.py): `Task-3/Task-3-Language-Model-Deployment/src/benchmark.py`
- [Evaluation Metrics](https://github.com/subhamgupta9/shadowfox-ml-engineer-internship/blob/main/Task-3/Task-3-Language-Model-Deployment/src/metrics.py): `Task-3/Task-3-Language-Model-Deployment/src/metrics.py`

### Other components

- **User**

## Connections

- User → Image App: uploads image (evidence: `README.md`)
- Image App → Image Inference: calls inference (evidence: `Task-1/Task-1-Image-Tagging/app.py`)
- Image Inference → MobileNetV2 Model: loads model (evidence: `Task-1/Task-1-Image-Tagging/src/predict.py`)
- Image App → User: shows classification (evidence: `Task-1/Task-1-Image-Tagging/app.py`)
- User → Valuation Dashboard: enters vehicle details (evidence: `README.md`)
- Valuation Dashboard → Price Prediction: requests valuation
- Price Prediction → Trained Model: uses model
- Valuation Dashboard → User: shows estimate and insights (evidence: `README.md`)
- Model Training → Data Preparation: uses preparation (evidence: `Task-2/Task-2-Car-Selling-Price-Prediction/src/train.py`)
- Model Training → Model Evaluation: uses evaluation (evidence: `Task-2/Task-2-Car-Selling-Price-Prediction/src/train.py`)
- Data Preparation → Vehicle Dataset: reads dataset (evidence: `Task-2/Task-2-Car-Selling-Price-Prediction/src/data_preprocessing.py`)
- User → NEXUS App: opens research lab (evidence: `README.md`)
- NEXUS App → FLAN-T5 Engine: initializes engine (evidence: `Task-3/Task-3-Language-Model-Deployment/app/app.py`)
- NEXUS App → UI Header: renders header (evidence: `Task-3/Task-3-Language-Model-Deployment/app/app.py`)
- NEXUS App → Interactive Lab: renders tab (evidence: `Task-3/Task-3-Language-Model-Deployment/app/app.py`)
- NEXUS App → Benchmark Dashboard: renders tab (evidence: `Task-3/Task-3-Language-Model-Deployment/app/app.py`)
- NEXUS App → Strategy Comparator: renders tab (evidence: `Task-3/Task-3-Language-Model-Deployment/app/app.py`)
- NEXUS App → Model Inspector: renders tab (evidence: `Task-3/Task-3-Language-Model-Deployment/app/app.py`)
- Interactive Lab → FLAN-T5 Engine: runs generation (evidence: `Task-3/Task-3-Language-Model-Deployment/app/components/tab_lab.py`)
- Strategy Comparator → FLAN-T5 Engine: compares generation (evidence: `Task-3/Task-3-Language-Model-Deployment/app/components/tab_comparator.py`)
- Model Inspector → FLAN-T5 Engine: reads specifications (evidence: `Task-3/Task-3-Language-Model-Deployment/app/components/tab_inspector.py`)
- Benchmark Runner → Evaluation Metrics: evaluates outputs
- NEXUS App → User: presents research views (evidence: `README.md`)
