shraddha-dsa/shl_assessment_consultant — explained in plain English
Analysis updated 2026-05-18
Let recruiters describe a role in plain language and get matching SHL assessments back.
Prototype a retrieval-augmented chatbot that grounds LLM answers in a fixed document set.
Learn how to combine FAISS semantic search with a Groq-hosted language model in a FastAPI service.
| shraddha-dsa/shl_assessment_consultant | 0xhassaan/nn-from-scratch | 3ks/embedoc | |
|---|---|---|---|
| Stars | 0 | 0 | — |
| Language | Python | Python | Python |
| Last pushed | — | — | 2023-06-08 |
| Maintenance | — | — | Dormant |
| Setup difficulty | moderate | moderate | hard |
| Complexity | 3/5 | 4/5 | 1/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Needs a Groq API key and a prebuilt FAISS index of SHL assessments to run.
SHL Conversational Assessment Recommender is an AI chat system that helps recruiters and hiring managers find the right SHL assessments through natural language conversation. Instead of searching a catalog manually, you describe the role you are hiring for and the system suggests relevant assessments, refining its recommendations as the conversation continues. Under the hood it uses a Retrieval-Augmented Generation (RAG) pipeline, a pattern that combines a database search step with a language model generation step. When you send a message, the system converts it into a numerical representation using Sentence Transformers, then searches a pre-built FAISS index of SHL assessments to find the most relevant candidates. A Groq-powered language model generates a grounded conversational response based on those search results rather than relying on general knowledge. Each response includes structured recommendations in JSON format with assessment names, URLs, and test types. The system supports multi-turn conversations, meaning it tracks context across several exchanges so you can ask follow-up questions or narrow down recommendations. The API is stateless, since each request includes the full conversation history, making it straightforward to deploy. It is written in Python and runs as a FastAPI service deployed on Render. Challenges noted in the README include reducing hallucination, keeping responses grounded to the SHL catalog, and handling cold start delays on free hosting. The project was built as part of the SHL AI Intern Take-Home Assignment.
An AI chatbot that recommends relevant SHL hiring assessments based on a natural language description of the role you are hiring for.
Mainly Python. The stack also includes Python, FastAPI, FAISS.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.