Skip to content

aragrishah/FairHire_Project

Repository files navigation

๐Ÿš€ FairHire โ€“ Explainable AI for Bias-Free Hiring

Transparent โ€ข Fair โ€ข Explainable Recruitment powered by AI


๐ŸŒ Live Application

๐Ÿ‘‰ Launch FairHire Dashboard


๐ŸŒ The Vision

AI in hiring should not just be accurate โ€” it should be fair, transparent, and accountable.

FairHire is an Explainable AI (XAI)-driven recruitment system that transforms hiring into a data-driven, bias-aware, and interpretable process.


๐ŸŽฏ Problem

Modern AI hiring systems often:

  • โŒ Operate as black boxes
  • โŒ Hide decision logic
  • โŒ Introduce bias (gender, education, etc.)
  • โŒ Reduce recruiter trust

โžก๏ธ Result: Unfair and unreliable hiring decisions


๐Ÿ’ก Solution

FairHire is an end-to-end intelligent hiring system that:

  • ๐Ÿค– Predicts candidate hiring probability
  • ๐Ÿง  Explains decisions using SHAP
  • โš–๏ธ Detects bias using fairness metrics
  • ๐Ÿ“„ Extracts resume data using NLP
  • ๐Ÿ“Š Visualizes insights via interactive dashboard

๐Ÿ‘‰ Not replacing recruiters โ€” empowering them


๐Ÿง  Core Components

๐Ÿค– Hiring Prediction Model

  • Random Forest Classifier
  • Predicts probability of selection

๐Ÿงพ Explainable AI (SHAP)

  • Shows why a candidate was selected
  • Feature-level contribution
  • Transparent decision-making

โš–๏ธ Fairness & Bias Detection

  • Uses Demographic Parity
  • Detects imbalance across groups
  • Flags bias automatically

๐Ÿ“„ Resume Intelligence (NLP)

  • PDF parsing via pdfplumber

  • NER using BERT

  • Extracts:

    • Skills
    • Experience
    • Certifications

๐Ÿ“Š Interactive Dashboard

  • Real-time filtering
  • Candidate comparison
  • Hiring probability insights
  • Bias monitoring

๐Ÿ“ธ Dashboard Screenshots

๐Ÿง‘โ€๐Ÿ’ผ Candidate Pool & Filtering

Candidate Pool


๐Ÿ“Š Hiring Insights & Distribution

Insights


๐Ÿง  AI Explanation (SHAP)

SHAP


๐Ÿ“ˆ Candidate Comparison

Comparison


โš™๏ธ System Architecture

flowchart TD
A[Resume Input] --> B[Data Processing]
B --> C[Feature Extraction]
C --> D[Random Forest Model]
D --> E[SHAP Explainability]
D --> F[Fairness Engine]
E --> G[Dashboard]
F --> G
G --> H[Human Decision Support]
Loading

๐Ÿ“Š Model Evaluation

Metric Purpose
Accuracy Overall correctness
Precision Quality of shortlist
Recall Identifying good candidates
ROC-AUC Model separability

โœ” Balanced performance across hiring decisions โœ” Reliable classification with explainability


๐Ÿ” Key Insights

  • ๐Ÿ“Œ Interview score & experience drive hiring decisions
  • ๐Ÿ“Œ SHAP reveals clear decision reasoning
  • ๐Ÿ“Œ Bias detection ensures fairness across groups
  • ๐Ÿ“Œ Dashboard enables data-driven HR decisions

๐Ÿ› ๏ธ Tech Stack

Language:

  • Python

ML & Data:

  • Scikit-learn
  • Pandas, NumPy

Explainable AI:

  • SHAP

NLP:

  • BERT (dslim/bert-base-NER)
  • pdfplumber

Visualization:

  • Plotly, Matplotlib

Deployment:

  • Streamlit
  • Pickle

โšก Run Locally

git clone https://github.com/aragrishah/FairHire_Project.git
cd FairHire_Project
pip install -r requirements.txt
streamlit run app.py

๐Ÿšง Limitations

  • Synthetic dataset
  • Limited real-world hiring signals
  • No enterprise HR integration

๐Ÿ”ฎ Future Improvements

  • Deep Learning-based scoring
  • Real-time hiring pipelines
  • Cloud deployment (AWS/GCP)
  • Bias mitigation algorithms
  • Interview AI integration

๐Ÿ“ˆ Why This Project Stands Out

  • ๐ŸŒ Solves real-world ethical AI problem
  • ๐Ÿง  Combines ML + NLP + XAI + Fairness
  • โš–๏ธ Focus on Responsible AI
  • ๐Ÿ“Š Strong product-level dashboard
  • ๐Ÿ’ผ Highly relevant for AI/Data roles

๐Ÿ‘ฉโ€๐Ÿ’ป Team

  • Riya Shah
  • Jhanvi Vakharia

โญ Final Thought

FairHire proves that AI can be both powerful and responsible โ€” not just predicting outcomes, but explaining them.

About

AI-powered hiring system using NLP & ML to screen candidates, predict suitability, and reduce bias in recruitment decisions.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages