README.md

---
title: SHL Assessment Recommendation System
emoji: 🎯
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
python_version: 3.11
app_file: app.py
pinned: false
license: mit
---

# 🎯 SHL Assessment Recommendation System

AI-powered recommendation engine for matching job descriptions with relevant SHL assessments.

## Features

- 🔍 **Semantic Search**: Uses sentence-transformers for intelligent matching
- 🤖 **AI Explanations**: Google Gemini LLM generates detailed reasoning
- ⚖️ **Smart Balancing**: Automatically mixes technical and behavioral assessments
- 📊 **54 Real Assessments**: From actual SHL catalog

## How to Use

1. **Web Interface Tab**: Enter your job description and get recommendations
2. **API Tab**: Test the JSON API response format

## Technology Stack

- **Embeddings**: sentence-transformers (all-MiniLM-L6-v2)
- **LLM**: Google Gemini 2.5 Flash
- **Framework**: Gradio + FastAPI
- **ML**: scikit-learn, numpy, pandas

## Example Queries

- "Java developer with collaboration skills"
- "Senior data analyst proficient in Python and SQL"
- "Entry-level sales professional"

## GitHub

Full code: [Aadi-1911/SHL--Assigmennt](https://github.com/Aadi-1911/SHL--Assigmennt)