Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

12 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ HirePilot โ€” AI-Powered Candidate Ranking Platform

Redrob Hackathon 2026 Submission Transforming recruitment with AI-driven candidate discovery, ranking, explainability, and fraud detection.


๐Ÿ“Œ Problem Statement

Recruiters often receive thousands of applications for a single job opening, making manual screening slow, inconsistent, and inefficient.

HirePilot solves this problem by automatically analyzing candidate profiles, matching them against a Job Description, detecting suspicious profiles, and generating an explainable ranking of the most relevant candidates.


๐ŸŽฏ Solution Overview

HirePilot is an end-to-end AI recruitment intelligence platform that:

  • Parses and analyzes large candidate datasets
  • Matches candidates with job descriptions using semantic AI
  • Scores candidates across multiple dimensions
  • Detects fraudulent or manipulated profiles
  • Generates explainable recommendations
  • Produces recruiter-ready ranked candidate lists

The platform combines Natural Language Processing, Machine Learning, behavioral analysis, and rule-based intelligence to help recruiters identify the best talent faster.


โœจ Key Features

๐Ÿค– AI-Powered Candidate Ranking

  • Semantic Job Description matching
  • Resume-to-role relevance scoring
  • Multi-dimensional candidate evaluation
  • Intelligent ranking engine

๐Ÿง  Semantic Matching Engine

Uses Sentence Transformers to understand:

  • Skills relevance
  • Role similarity
  • Industry alignment
  • Contextual candidate-job fit

Unlike keyword matching systems, HirePilot understands meaning and context.


๐Ÿ“Š Multi-Factor Scoring Framework

Candidates are evaluated across:

Dimension Weight
Skill Match 30%
Semantic Similarity 25%
Experience 20%
Behavioral Signals 15%
Education 10%

๐Ÿ›ก Fraud Detection Engine

HirePilot automatically detects:

  • Keyword stuffing
  • Fake experience claims
  • Timeline inconsistencies
  • Honeypot profiles
  • Education anomalies
  • Incomplete profiles
  • Role-history contradictions

Suspicious candidates receive score penalties.


๐Ÿ’ก Explainable AI

Every ranked candidate includes:

  • Score breakdown
  • Matching strengths
  • Ranking justification
  • Recruiter-friendly reasoning

This ensures transparency and trust in AI decisions.


๐Ÿ“ˆ Recruiter Analytics Dashboard

Visual insights including:

  • Candidate ranking distribution
  • Score analytics
  • Skill coverage analysis
  • Candidate quality metrics

๐Ÿ— System Architecture

Candidate Dataset
        โ”‚
        โ–ผ
 Resume Parsing Layer
        โ”‚
        โ–ผ
 Feature Extraction Engine
        โ”‚
        โ–ผ
 Semantic Matching Engine
        โ”‚
        โ–ผ
 Multi-Factor Scoring
        โ”‚
        โ–ผ
 Fraud Detection Layer
        โ”‚
        โ–ผ
 Ranking Engine
        โ”‚
        โ–ผ
 Explainability Module
        โ”‚
        โ–ผ
 Top Candidate Recommendations

๐Ÿ“‚ Project Structure

backend/
โ”œโ”€โ”€ api/
โ”œโ”€โ”€ parser/
โ”œโ”€โ”€ scoring/
โ”œโ”€โ”€ ranking/
โ”œโ”€โ”€ behavioral/
โ”œโ”€โ”€ fraud_detection/
โ”œโ”€โ”€ explainability/
โ”œโ”€โ”€ validation/
โ”œโ”€โ”€ config.py
โ”œโ”€โ”€ pipeline.py
โ”œโ”€โ”€ main.py
โ””โ”€โ”€ requirements.txt

frontend/
โ”œโ”€โ”€ src/
โ”œโ”€โ”€ public/
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ vite.config.ts

data/
โ”œโ”€โ”€ candidate_schema.json
โ”œโ”€โ”€ candidates.jsonl
โ””โ”€โ”€ job_description.txt

scripts/
โ”œโ”€โ”€ generate_mock_data.py

tests/
โ”œโ”€โ”€ test_parsers.py
โ”œโ”€โ”€ test_scoring.py
โ”œโ”€โ”€ test_ranking.py
โ””โ”€โ”€ test_validation.py

โš™ Technology Stack

Backend

  • Python 3.11
  • FastAPI
  • Uvicorn
  • NumPy
  • Pandas
  • Scikit-Learn
  • Sentence Transformers

Frontend

  • React 18
  • TypeScript
  • Vite
  • Tailwind CSS
  • Zustand
  • Axios
  • Recharts

AI & NLP

  • Sentence Transformers
  • Cosine Similarity Matching
  • Feature Engineering
  • Explainability Framework

๐Ÿš€ Getting Started

1๏ธโƒฃ Clone Repository

git clone <repository-url>
cd HirePilot

2๏ธโƒฃ Backend Setup

cd backend
pip install -r requirements.txt

3๏ธโƒฃ Frontend Setup

cd frontend
npm install

4๏ธโƒฃ Start Backend

cd backend
uvicorn main:app --reload --port 8000

Backend:

http://localhost:8000

API Docs:

http://localhost:8000/api/docs

5๏ธโƒฃ Start Frontend

cd frontend
npm run dev

Frontend:

http://localhost:5173

๐Ÿ“ก API Endpoints

Method Endpoint Description
POST /api/upload/candidates Upload candidate dataset
POST /api/upload/jd Upload Job Description
POST /api/upload/jd-text Submit JD text
POST /api/process Start ranking process
GET /api/status Processing status
GET /api/candidates Ranked candidates
GET /api/candidates/{id} Candidate details
GET /api/top100 Top-ranked candidates
GET /api/export Export rankings
GET /api/validate Validate submission
GET /api/analytics Analytics dashboard

๐Ÿงช Testing

Run all tests:

pytest tests/ -v

๐ŸŽฏ Hackathon Highlights

โœ… AI-Powered Recruitment Intelligence

โœ… Semantic Resume Matching

โœ… Explainable Candidate Ranking

โœ… Fraud Detection System

โœ… FastAPI + React Full Stack Architecture

โœ… Recruiter Analytics Dashboard

โœ… Automated Validation Pipeline

โœ… Scalable Architecture for Large Candidate Pools


๐Ÿ”ฎ Future Roadmap

  • LLM-powered Interview Question Generation
  • Resume Summarization
  • ATS Integration
  • Recruiter Feedback Learning Loop
  • Multi-language Resume Support
  • Advanced Candidate Recommendations
  • Real-Time Hiring Insights

๐Ÿ‘ฅ Team

๐Ÿš€ HirePilot โ€” Redrob Hackathon Team

Team Member
Swagatam Behera
Ashwath Raj
Sahil Ranjan
Kaushik Katual

๐Ÿ“œ License

This project is licensed under the MIT License.


โญ Built for Redrob Hackathon 2026

Empowering recruiters with AI-driven hiring intelligence.

Releases

Packages

Contributors

Languages