# yashuu05/bike-rental-prediction architecture

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

- Interactive diagram: https://gitdiagram.com/yashuu05/bike-rental-prediction
- Repository: https://github.com/yashuu05/bike-rental-prediction

## Overview

Souel Bike Rental Prediction is an end-to-end bike-demand ML project with a FastAPI prediction service and an offline training workflow. The main user path is browser input to API, preprocessing, model inference, and optional database persistence; training selects and tunes a model for later inference. The README also describes ETL, validation, DVC data versioning, experiment tracking, AWS storage, and Airflow orchestration. Some of those capabilities are documented but their implementation links are not shown in the sampled source, so those links are omitted or marked unverified.

Main entry points: [`app/main.py`](https://github.com/yashuu05/bike-rental-prediction/blob/main/app/main.py) (FastAPI routes), [`src/training/pipeline.py`](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/training/pipeline.py) (Training pipeline), [`src/ingestion/ingestion.py`](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/ingestion/ingestion.py) (Data ingestion), [`src/prediction/predict.py`](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/prediction/predict.py) (Prediction pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_serving["Prediction service"]
  node_web["Web interface<br/>[index.html]"]
  node_browser["Browser behavior<br/>[main.js]"]
  node_api["FastAPI routes<br/>[main.py]"]
  node_schemas["Request schemas<br/>[schemas.py]"]
  node_records["Prediction records<br/>[models.py]"]
  node_database[("MySQL database<br/>[database.py]")]
end

subgraph group_ml["ML lifecycle"]
  node_inference["Prediction pipeline<br/>[predict.py]"]
  node_prep["Saved preprocessor"]
  node_model["Trained model<br/>[model.joblib.dvc]"]
  node_training["Training pipeline<br/>[pipeline.py]"]
  node_base["Base model training<br/>[train_1.py]"]
  node_tuning["Hyperparameter tuning<br/>[train_2.py]"]
  node_evaluation["Model evaluation<br/>[model_evalution.py]"]
  node_modelconfig["Model configuration<br/>[models.py]"]
end

subgraph group_data["Data preparation"]
  node_features["Feature engineering<br/>[feature_engg.py]"]
  node_extract["Dataset extraction<br/>[extract.py]"]
  node_ingest["Data ingestion<br/>[ingestion.py]"]
  node_validate["Data validation<br/>[validate.py]"]
  node_transform["Preprocessing<br/>[transform.py]"]
end

subgraph group_platform["Data and operations"]
  node_paths["Artifact paths<br/>[paths.py]"]
  node_utilities["File utilities<br/>[utilities.py]"]
  node_s3["S3 integration<br/>[s3.py]"]
  node_airflow["Airflow DAG<br/>[exampledag.py]"]
  node_dvc["Versioned datasets"]
end

node_user(("Bike renter"))
node_publicdata["Public dataset"]
node_aws[("AWS S3")]

node_user -->|"enters inputs"| node_web
node_web -->|"loads scripts"| node_browser
node_browser -.->|"submits request"| node_api
node_api -->|"validates request"| node_schemas
node_api -->|"loads resources"| node_inference
node_api -->|"preprocesses input"| node_inference
node_api -->|"predicts with"| node_model
node_api -->|"transforms with"| node_prep
node_inference -->|"creates features"| node_features
node_api -->|"creates record"| node_records
node_api -->|"commits prediction"| node_database
node_api -->|"queries history"| node_database
node_publicdata -.->|"provides dataset"| node_extract
node_extract -.->|"feeds ingestion"| node_ingest
node_ingest -.->|"passes data"| node_validate
node_validate -.->|"validated data"| node_transform
node_transform -->|"engineers features"| node_features
node_training -->|"selects model"| node_base
node_training -->|"tunes selection"| node_tuning
node_training -->|"uses models"| node_modelconfig
node_base -->|"evaluates models"| node_evaluation
node_tuning -->|"evaluates tuned model"| node_evaluation
node_training -->|"saves model"| node_utilities
node_training -->|"uses artifact path"| node_paths
node_ingest -->|"uses S3 helper"| node_s3
node_s3 -.->|"stores data"| node_aws
node_publicdata -.->|"tracks versions"| node_dvc
node_airflow -.->|"orchestrates ETL"| node_extract

click node_web "https://github.com/yashuu05/bike-rental-prediction/blob/main/app/static/index.html"
click node_browser "https://github.com/yashuu05/bike-rental-prediction/blob/main/app/static/js/main.js"
click node_api "https://github.com/yashuu05/bike-rental-prediction/blob/main/app/main.py"
click node_schemas "https://github.com/yashuu05/bike-rental-prediction/blob/main/app/schemas.py"
click node_inference "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/prediction/predict.py"
click node_prep "https://github.com/yashuu05/bike-rental-prediction/blob/main/models/preprocessor.joblib.dvc"
click node_model "https://github.com/yashuu05/bike-rental-prediction/blob/main/models/model.joblib.dvc"
click node_features "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/features/feature_engg.py"
click node_records "https://github.com/yashuu05/bike-rental-prediction/blob/main/app/models.py"
click node_database "https://github.com/yashuu05/bike-rental-prediction/blob/main/app/database.py"
click node_extract "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/extraction/extract.py"
click node_ingest "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/ingestion/ingestion.py"
click node_validate "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/validation/validate.py"
click node_transform "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/preprocessing/transform.py"
click node_training "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/training/pipeline.py"
click node_base "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/training/train_1.py"
click node_tuning "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/training/train_2.py"
click node_evaluation "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/model_evalution.py"
click node_modelconfig "https://github.com/yashuu05/bike-rental-prediction/blob/main/configs/models.py"
click node_paths "https://github.com/yashuu05/bike-rental-prediction/blob/main/configs/paths.py"
click node_utilities "https://github.com/yashuu05/bike-rental-prediction/blob/main/utils/utilities.py"
click node_s3 "https://github.com/yashuu05/bike-rental-prediction/blob/main/src/aws/s3.py"
click node_airflow "https://github.com/yashuu05/bike-rental-prediction/blob/main/dags/exampledag.py"
click node_dvc "https://github.com/yashuu05/bike-rental-prediction/blob/main/data/raw/input_features.csv.dvc"

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_web,node_browser,node_api,node_schemas,node_records,node_database toneBlue
class node_inference,node_prep,node_model,node_training,node_base,node_tuning,node_evaluation,node_modelconfig,node_aws toneAmber
class node_features,node_extract,node_ingest,node_validate,node_transform toneMint
class node_paths,node_utilities,node_s3,node_airflow,node_dvc toneRose
class node_user,node_publicdata toneIndigo
```

## Components

### Prediction service

- [Web interface](https://github.com/yashuu05/bike-rental-prediction/blob/main/app/static/index.html): `app/static/index.html`
- [Browser behavior](https://github.com/yashuu05/bike-rental-prediction/blob/main/app/static/js/main.js): `app/static/js/main.js`
- [FastAPI routes](https://github.com/yashuu05/bike-rental-prediction/blob/main/app/main.py): `app/main.py`
- [Request schemas](https://github.com/yashuu05/bike-rental-prediction/blob/main/app/schemas.py): `app/schemas.py`
- [Prediction records](https://github.com/yashuu05/bike-rental-prediction/blob/main/app/models.py): `app/models.py`
- [MySQL database](https://github.com/yashuu05/bike-rental-prediction/blob/main/app/database.py): `app/database.py`

### ML lifecycle

- [Prediction pipeline](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/prediction/predict.py): `src/prediction/predict.py`
- [Saved preprocessor](https://github.com/yashuu05/bike-rental-prediction/blob/main/models/preprocessor.joblib.dvc): `models/preprocessor.joblib.dvc`
- [Trained model](https://github.com/yashuu05/bike-rental-prediction/blob/main/models/model.joblib.dvc): `models/model.joblib.dvc`
- [Training pipeline](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/training/pipeline.py): `src/training/pipeline.py`
- [Base model training](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/training/train_1.py): `src/training/train_1.py`
- [Hyperparameter tuning](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/training/train_2.py): `src/training/train_2.py`
- [Model evaluation](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/model_evalution.py): `src/model_evalution.py`
- [Model configuration](https://github.com/yashuu05/bike-rental-prediction/blob/main/configs/models.py): `configs/models.py`

### Data preparation

- [Feature engineering](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/features/feature_engg.py): `src/features/feature_engg.py`
- [Dataset extraction](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/extraction/extract.py): `src/extraction/extract.py`
- [Data ingestion](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/ingestion/ingestion.py): `src/ingestion/ingestion.py`
- [Data validation](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/validation/validate.py): `src/validation/validate.py`
- [Preprocessing](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/preprocessing/transform.py): `src/preprocessing/transform.py`

### Data and operations

- [Artifact paths](https://github.com/yashuu05/bike-rental-prediction/blob/main/configs/paths.py): `configs/paths.py`
- [File utilities](https://github.com/yashuu05/bike-rental-prediction/blob/main/utils/utilities.py): `utils/utilities.py`
- [S3 integration](https://github.com/yashuu05/bike-rental-prediction/blob/main/src/aws/s3.py): `src/aws/s3.py`
- [Airflow DAG](https://github.com/yashuu05/bike-rental-prediction/blob/main/dags/exampledag.py): `dags/exampledag.py`
- [Versioned datasets](https://github.com/yashuu05/bike-rental-prediction/blob/main/data/raw/input_features.csv.dvc): `data/raw/input_features.csv.dvc`

### Other components

- **Bike renter**
- **Public dataset**
- **AWS S3**

## Connections

- Bike renter → Web interface: enters inputs (evidence: `README.md`)
- Web interface → Browser behavior: loads scripts
- Browser behavior → FastAPI routes: submits request
- FastAPI routes → Request schemas: validates request (evidence: `app/main.py`)
- FastAPI routes → Prediction pipeline: loads resources (evidence: `app/main.py`)
- FastAPI routes → Prediction pipeline: preprocesses input (evidence: `app/main.py`)
- FastAPI routes → Trained model: predicts with (evidence: `app/main.py`)
- FastAPI routes → Saved preprocessor: transforms with (evidence: `app/main.py`)
- Prediction pipeline → Feature engineering: creates features (evidence: `src/prediction/predict.py`)
- FastAPI routes → Prediction records: creates record (evidence: `app/main.py`)
- FastAPI routes → MySQL database: commits prediction (evidence: `app/main.py`)
- FastAPI routes → MySQL database: queries history (evidence: `app/main.py`)
- Public dataset → Dataset extraction: provides dataset
- Dataset extraction → Data ingestion: feeds ingestion
- Data ingestion → Data validation: passes data
- Data validation → Preprocessing: validated data
- Preprocessing → Feature engineering: engineers features (evidence: `src/preprocessing/transform.py`)
- Training pipeline → Base model training: selects model (evidence: `src/training/pipeline.py`)
- Training pipeline → Hyperparameter tuning: tunes selection (evidence: `src/training/pipeline.py`)
- Training pipeline → Model configuration: uses models (evidence: `src/training/pipeline.py`)
- Base model training → Model evaluation: evaluates models (evidence: `src/training/train_1.py`)
- Hyperparameter tuning → Model evaluation: evaluates tuned model (evidence: `src/training/train_2.py`)
- Training pipeline → File utilities: saves model (evidence: `src/training/pipeline.py`)
- Training pipeline → Artifact paths: uses artifact path (evidence: `src/training/pipeline.py`)
- Data ingestion → S3 integration: uses S3 helper (evidence: `src/ingestion/ingestion.py`)
- S3 integration → AWS S3: stores data
- Public dataset → Versioned datasets: tracks versions (evidence: `README.md`)
- Airflow DAG → Dataset extraction: orchestrates ETL
