README.md

metadata

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