How suryashkhrdutta/ai-resume-rating works
AI Resume Rating is a command-line tool that parses a job description and a folder of PDF/DOCX resumes, asks Groq to extract and compare structured requirements, then applies a deterministic Python rubric to rank candidates. Its results include skill matches and gaps, evidence, strengths, quality issues, and suggestions; they can be displayed in the terminal or exported as JSON/CSV. The README documents the workflow and capabilities; the sampled implementation is concentrated in one module, so several components share its path.
Main entry points: __init__.py CLI entry · resume_parser.py Legacy launcher
Components 17
Inputs and CLI
- CLI entry
src/resumeRating/__init__.py - Job description
src/resumeRating/__init__.py - Resume files
src/resumeRating/__init__.py - PDF/DOCX reader
src/resumeRating/__init__.py
LLM Analysis
- Job parser
src/resumeRating/__init__.py - Resume parser
src/resumeRating/__init__.py - Match analysis
src/resumeRating/__init__.py - Validated profiles
src/resumeRating/__init__.py
Scoring and Results
- Rubric scoring
src/resumeRating/__init__.py - Candidate results
src/resumeRating/__init__.py - Ranked summary
src/resumeRating/__init__.py - Terminal output
src/resumeRating/__init__.py - JSON/CSV export
src/resumeRating/__init__.py
Runtime Integration
- Groq API
- Legacy launcher
resume_parser.py
Other components
- Recruiter
- Export files
Connections 21
- Recruiter → CLI entry: runs
README.md - Recruiter → Job description: provides
README.md - Recruiter → Resume files: places resumes
README.md - CLI entry → Job description: reads
README.md - CLI entry → Resume files: processes folder
README.md - Resume files → PDF/DOCX reader: supplies files
README.md - PDF/DOCX reader → Resume parser: extracts text
README.md - Job description → Job parser: extracts requirements
README.md - Resume parser → Validated profiles: validates profile
README.md - Job parser → Validated profiles: validates requirements
README.md - Job parser → Groq API: requests extraction
src/resumeRating/__init__.py - Resume parser → Groq API: requests extraction
src/resumeRating/__init__.py - Match analysis → Groq API: requests comparison
src/resumeRating/__init__.py - Validated profiles → Match analysis: compares profiles
README.md - Match analysis → Rubric scoring: provides judgments
README.md - Rubric scoring → Candidate results: computes breakdown
src/resumeRating/__init__.py - Candidate results → Ranked summary: sorts candidates
README.md - Ranked summary → Terminal output: prints summary
README.md - Candidate results → JSON/CSV export: serializes results
src/resumeRating/__init__.py - JSON/CSV export → Export files: writes files
src/resumeRating/__init__.py - Legacy launcher → CLI entry: invokes main
resume_parser.py