Resume Matcher

Resume Matcher is a modern Python GUI application that compares your resume to a job description using NLP. It provides:

• A Match Score (based on keyword overlap)
• A Similarity Score (based on TF-IDF cosine similarity)
• Beautiful circular progress indicators
• Lists of matched and missing keywords
• A clean, professional UI using PyQt5

---

Installation Instructions

1. Clone the repository

git clone https://github.com/mtafoya-web/ResumeMatcher.git
cd ResumeMatcher

(optional create virtual enviorment)

python -m venv venv
venv\Scripts\activate        # Windows
# or
source venv/bin/activate     # macOS/Linux

install python dependancies

pip install PyQt5==5.15.9 scikit-learn==1.4.1.post1 spacy==3.7.2 numpy==1.24.4 threadpoolctl==3.1.0 joblib==1.3.2 scipy==1.10.1

install the spaCy model

python -m spacy download en_core_web_sm

How to run the app

python main.py

Features

• Upload resume text
• Upload job description text
• Keyword extraction
• Match score calculation
• Cosine similarity scoring
• Missing keyword detection
• Clean GUI interface

---

How It Works

1. Text Preprocessing

   • Lowercasing
   • Tokenization
   • Stopword removal

2. Vectorization

   • TF-IDF vectorization converts text into numerical vectors.

3. Similarity Calculation

   • Cosine similarity measures how close the resume is to the job description.

4. Keyword Analysis

   • Identifies overlapping keywords
   • Detects missing important job-related terms

---

🛠 Tech Stack

• Python
• Scikit-learn
• TF-IDF Vectorizer
• Cosine Similarity
• Tkinter (GUI)

---