loan-default-prediction-pipeline

Loan Default Prediction Pipeline

A scikit-learn machine learning pipeline that predicts whether a loan applicant is at risk of defaulting, based on their financial profile and personal details.

Model: Random Forest Classifier
Task: Binary Classification (default risk: 0 = Low Risk, 1 = High Risk)
Validation Accuracy: ~89.7%

---

Model Description

This pipeline was trained on 252,000 loan applicant records. It combines a full data preprocessing pipeline with a tuned Random Forest Classifier. The preprocessing handles:

• Missing value imputation
• Snake-case column name formatting
• Boolean encoding (married/single status, car ownership, house ownership)
• Job stability ordinal encoding
• City tier ordinal encoding (Tier 1 / Tier 2 / Tier 3)
• State-level default rate target encoding
• Standard scaling of numerical features
• One-hot encoding of nominal categorical features
• Feature selection

---

How to Use

Install dependencies

pip install scikit-learn joblib pandas huggingface_hub

Load and use the pipeline

import joblib
import pandas as pd
from huggingface_hub import hf_hub_download

# Download the pipeline from Hugging Face Hub
model_path = hf_hub_download(
    repo_id="amanbokaro/loan-default-prediction-pipeline",
    filename="loan_default_rf_pipeline.joblib"
)

# Load the pipeline
pipeline = joblib.load(model_path)

# Example input (single applicant)
applicant = pd.DataFrame([{
    "Income":          500000,
    "Age":             35,
    "Experience":      8,
    "Married/Single":  "married",
    "House_Ownership": "rented",
    "Car_Ownership":   "yes",
    "Profession":      "Software_Developer",
    "CITY":            "Mumbai",
    "STATE":           "Maharashtra",
    "CURRENT_JOB_YRS": 4,
    "CURRENT_HOUSE_YRS": 3
}])

# Predict
prediction = pipeline.predict(applicant)
probability = pipeline.predict_proba(applicant)

print("Prediction:", "High Risk" if prediction[0] == 1 else "Low Risk")
print(f"Default probability: {probability[0][1]:.2%}")

---

Input Features

---

Output

---

Training Details

---

Files

---

License

MIT License — see LICENSE for details.