File size: 2,700 Bytes
c30e7e5 ab616b2 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 |
---
license: other
license_name: proprietary
license_link: LICENSE
language:
- en
pipeline_tag: tabular-classification
metrics:
- accuracy
tags:
- education
---
# FutureGuard Student Dropout Risk Prediction Models
## Overview
This repository contains the trained machine learning artifacts used by **FutureGuard**, a student dropout risk prediction system designed for educational institutions.
The models are used as part of a backend ML microservice and are **not intended to be used standalone** without the FutureGuard application stack.
The primary goal of these models is to estimate the probability of a student dropping out based on academic, attendance, and administrative indicators, and to support early intervention workflows.
---
## Models Included
This repository provides:
* **Tabular classification model**
* Algorithm: Gradient-boosted decision trees (XGBoost)
* Output: Dropout risk probability
* **Preprocessing artifacts**
* Feature scaler used during training
* Fixed feature ordering required for inference consistency
The models are consumed dynamically by the FutureGuard ML service at runtime.
---
## Intended Use
The models are intended to be used for:
* Academic risk analysis
* Early identification of at-risk students
* Supporting mentoring and counseling workflows
* Institutional analytics and reporting
They are designed to operate in conjunction with:
* Rule-based risk checks
* Structured metadata-driven feature mapping
* A FastAPI-based inference service
---
## Input & Output
### Input
* Structured tabular data representing student attributes
* Features must match the expected schema and preprocessing pipeline
### Output
* Dropout risk score (probability)
* Risk category (low, medium, high)
* Used downstream for explanations and recommendations
---
## Integration
These models are loaded at runtime by the **FutureGuard ML Service**, which:
* Downloads the model artifacts securely
* Applies preprocessing and scaling
* Combines ML predictions with rule-based logic
* Exposes a single `/predict` API endpoint
Direct inference from this repository is **not supported**.
---
## License
This repository and all included model artifacts are released under a **proprietary license**.
* Copyright © 2025 Manpreet Singh and Sumit Kumar
* All rights reserved
* Use permitted as-is
* Modification, redistribution, resale, or derivative works are prohibited without explicit permission
See the `LICENSE` file for full terms.
---
## Disclaimer
The models are provided **as-is**, without any warranties.
Predictions should be used as decision-support signals and not as the sole basis for academic or administrative actions.
|