Yash-Codezz commited on
Commit
103df32
Β·
verified Β·
1 Parent(s): 221bfc7

Create README.md

Browse files
Files changed (1) hide show
  1. README.md +117 -0
README.md ADDED
@@ -0,0 +1,117 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ language: pyt
4
+ pipeline_tag: tabular-regression
5
+ tags:
6
+ - machine-learning
7
+ - stacking-regression
8
+ library_name: sklearn
9
+ ---
10
+
11
+ # πŸ’Έ PayPredictor:
12
+ ### Student Placement Salary Prediction using Stacking Regression
13
+
14
+ - **PayPredictor** is a Machine Learning regression project developed to predict student salary packages (LPA) using academic and placement-related features.
15
+
16
+ - The model follows a **Stacking Regression Architecture**, combining three different base estimators with a Linear Regression meta-model.
17
+
18
+ - The complete preprocessing and modeling pipeline is serialized using Joblib, making it ready for integration into other Python applications.
19
+
20
+ ---
21
+
22
+ ## πŸ“Š Model Performance
23
+
24
+ Evaluated using an 80/20 train-test split and 10-fold cross-validation.
25
+
26
+ | Evaluation Metric | Score |
27
+ |:---|---:|
28
+ | RΒ² Score | **78.23%** |
29
+ | MAPE | **5.75%** |
30
+
31
+ ---
32
+
33
+ ## πŸ—οΈ Model Architecture
34
+
35
+ PayPredictor uses a Stacking Regressor consisting of three base models and one meta-model.
36
+
37
+ ```text
38
+ Input Features
39
+ |
40
+ β–Ό
41
+ Preprocessing
42
+ (Ordinal + One-Hot Encoding)
43
+ |
44
+ β–Ό
45
+ StandardScaler
46
+ |
47
+ β–Ό
48
+ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
49
+ β”‚ Base Models β”‚
50
+ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
51
+ / | \
52
+ / | \
53
+ β–Ό β–Ό β–Ό
54
+ Ridge KNN Random Forest
55
+ \ | /
56
+ \ | /
57
+ β–Ό
58
+ Linear Regression
59
+ (Meta Model)
60
+ |
61
+ β–Ό
62
+ Predicted Salary
63
+ (LPA)
64
+ ```
65
+
66
+ ---
67
+
68
+ ## πŸ› οΈ Tech Stack
69
+
70
+ - Python
71
+ - Pandas
72
+ - NumPy
73
+ - Scikit-Learn
74
+ - Joblib
75
+ - Hugging Face Hub
76
+
77
+ ## πŸ“₯ Download & Usage
78
+
79
+ ### 1. Install Dependencies
80
+
81
+ ```bash
82
+ pip install numpy pandas scikit-learn joblib huggingface_hub
83
+ ```
84
+
85
+ ### 2. Download the Model
86
+
87
+ ```python
88
+ from huggingface_hub import hf_hub_download
89
+ import joblib
90
+
91
+ model_path = hf_hub_download(
92
+ repo_id="Yash-Codezz/Student.Placement.Model",
93
+ filename="PayPredictor.pkl"
94
+ )
95
+
96
+ model = joblib.load(model_path)
97
+ ```
98
+
99
+ ---
100
+
101
+ ## πŸ“ Repository Structure
102
+
103
+ ```text
104
+ Student.Placement.Model/
105
+ β”‚
106
+ β”œβ”€β”€ .gitattributes
107
+ β”œβ”€β”€ PayPredictor.pkl
108
+ └── README.md
109
+ ```
110
+
111
+ ---
112
+
113
+ ## πŸ‘¨β€πŸ’» Author
114
+
115
+ **Yash-Codezz**
116
+
117
+ ⭐ If you find this project interesting, consider giving the repository a star!