Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,30 @@
+# Grade Predictor (Regression)
+
+Trained from dataset: **DetectiveShadow/Grade_Data**
+
+**Best model:** RandomForestRegressor
+**Metrics:** R² = 0.131 • RMSE = 10.10 • MAE = 7.98
+
+## Expected Features
+- Numeric: ['grade_level', 'attendance', 'hours_studied', 'quizzes_avg', 'confidence']
+- Categorical: ['subject', 'course_difficulty', 'group_or_solo']
+- Target: final_grade
+
+## Quick Start
+```python
+from huggingface_hub import hf_hub_download
+import joblib, pandas as pd
+
+pipe = joblib.load(hf_hub_download("DetectiveShadow/Grade_predictor", "grade_predictor.pkl"))
+sample = pd.DataFrame([{
+    "attendance": 0.95,
+    "hours_studied": 12,
+    "quizzes_avg": 85,
+    "confidence": 7,
+    "grade_level": 11,
+    "subject": "Math",
+    "course_difficulty": "Honors",
+    "group_or_solo": "Solo"
+}])
+print("Predicted final grade:", pipe.predict(sample)[0])
+```