Resume Analyzer

Resume Analyzer is a Python project that leverages AI to parse resumes (PDF/DOCX) and evaluate them against job descriptions.
It extracts structured information such as skills, education, and experience, calculates match scores, highlights missing skills, and ranks candidates.
This tool helps recruiters shortlist faster and job seekers benchmark their resumes.

---

🧠 Architecture Mind Map

mindmap
  root((Resume Analyzer))
    Job Description Parser
      Extract role
      Required skills
      Education
      Responsibilities
    Resume Parser
      PDF parsing
      DOCX parsing
      Skills extraction
      Experience extraction
    Matching Engine
      Compare resume vs job
      Calculate match %
      Identify missing skills
      Rank candidates
    Output
      Top candidates
      Lowest candidates
      Final verdict

Loading

📐 Architecture Overview

The project is divided into clear modules:

1. Job Description Parser

   • Converts raw job descriptions into structured JSON using LLMs.
   • Captures role, required skills, education, and responsibilities.

2. Resume Parser

   • Reads resumes in PDF/DOCX format using pypdf and python-docx.
   • Extracts candidate details (skills, education, experience, projects).
   • Normalizes data into a consistent schema.

3. Matching Engine

   • Compares resume data against job requirements.
   • Calculates match percentage, identifies missing skills, and generates verdicts.
   • Outputs top and lowest candidates.

4. Error Handling

   • Skips corrupted/unreadable files gracefully.
   • Ensures batch processing continues without interruption.

---

⚙️ Tech Stack

• Python
• python-docx → DOCX parsing
• pypdf → PDF parsing
• python-dotenv → API key management
• groq → LLM-powered analysis
• pydantic → Data models & validation

---

🚀 Installation

Clone the repository and install dependencies:

git clone https://github.com/hrithik0408/Resume_Analyzer.git
cd Resume_Analyzer
pip install -r requirements.txt

🔑 API Key Setup

This project uses the Groq API for AI-powered resume and job description analysis.
To run the project, you need to set your API key in a .env file.

1. Create a file named .env in the root of the project.
2. Add your API key like this: