Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

AI Candidate Ranking Engine

Screen a stack of resumes against one job in about two minutes, and get back a ranked list you can defend.

Reading 200 resumes by hand takes most of a day, and the last twenty get read worse than the first twenty. This scores every candidate against the same rubric in the same way, then shows its working: the skills matched, the ones missing, and the specific things worth a second look.

What it does

  • Takes the whole stack. PDF, DOCX or TXT, dropped in together.
  • Scores against a defined role, not a vibe: required skills, preferred skills, years of experience, salary band, culture keywords.
  • Ranks with the reasoning attached. Each candidate carries a score breakdown rather than a bare number.
  • Surfaces what a skim misses. Employment gaps, short tenures, and the skills a candidate claims but does not evidence.
  • Exports where hiring actually happens. CSV, Excel, PDF, or ATS-shaped JSON.

Layout

Path What
backend/ FastAPI service: parsing, scoring, export.
frontend/ React and Vite interface: upload, define the role, read the ranking.

Running it

# backend
cd backend
python -m venv venv && venv/Scripts/activate      # source venv/bin/activate on macOS or Linux
pip install -r requirements.txt
cp .env.example .env                              # add your own OpenAI key
python main.py                                    # http://localhost:8000

# frontend, in a second terminal
cd frontend
npm install && npm run dev                        # http://localhost:3000

Then upload resumes, fill in the job, and analyse. Expect 30 to 60 seconds for a batch.

Stack

Python · FastAPI · OpenAI · React · Vite · Tailwind.

Honest limits

It ranks against the rubric it is given, so a badly specified role produces a confidently wrong ordering. It reads what a resume claims, and a resume is self-reported. Treat the output as a reading order for a human, not a decision. Anything that filters people out deserves a person looking at what it filtered.

About

AI engine that ranks 50–200 resumes instantly, generating skill-match %, red flags, compensation alignment, and culture-fit insights with CSV/PDF/ATS exports-replacing hours of manual screening.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages