CoolFace
Apppublic

saadtoorx/resume-scanner-using-keyword-extraction

sourceHugging Facemitupdated 1y agoView on Hugging Face
0likes
App README

πŸ“„ Resume Scanner using Keyword Extraction

Scan PDF resumes and automatically match them to a job description using TF-IDF and cosine similarity. This project helps recruiters and developers identify the most relevant candidates from multiple resumes β€” directly in your browser.


🧠 About the Project

This app uses Natural Language Processing (NLP) techniques to compare uploaded resumes against a job description. The core idea is to extract and analyze keywords from both resumes and job descriptions using TF-IDF, then compute a similarity score to recommend the best-matching candidates.


πŸš€ Features

  • β€”πŸ“€ Upload multiple resumes in PDF format
  • β€”πŸ§Ύ Automatically extract text from resumes
  • β€”πŸ§  Convert text to keyword vectors using TF-IDF
  • β€”πŸ“ Match resumes to a custom job description using cosine similarity
  • β€”πŸ“Š Display scores and filter top matches

πŸ› οΈ Tech Stack

  • β€”Python 3.x
  • β€”Streamlit
  • β€”PyMuPDF (fitz)
  • β€”scikit-learn
  • β€”pandas

πŸ“ Project Structure

Resume-Scanner-using-Keyword-Extraction/
β”œβ”€β”€ app.py                # Streamlit web app
β”œβ”€β”€ app.ipynb             # Jupyter Notebook
β”œβ”€β”€ requirements.txt      # Python dependencies
β”œβ”€β”€ README.md             # Project documentation
β”œβ”€β”€ test_resumes          # Folder containing testing resumes (pdf)
    β”œβ”€β”€ ai_engineer_resume.pdf     # AI-Engineer Resume
    β”œβ”€β”€ archaeologist_resume.pdf   # Archaeologist Resume
    β”œβ”€β”€ gardner_resume.pdf         # Gardner Resume
β”œβ”€β”€ images
    β”œβ”€β”€ output1.png       # AI-Engineer output
    β”œβ”€β”€ output2.png       # Archaeologist output
    β”œβ”€β”€ output3.png       # Gardner output

πŸ’» How to Run

  1. 1.Clone the Repository
bash
git clone https://github.com/saadtoorx/Resume-Scanner-using-Keyword-Extraction.git
cd Resume-Scanner-using-Keyword-Extraction
  1. 1.Install Dependencies
bash
pip install -r requirements.txt
  1. 1.Launch the App
bash
streamlit run app.py
  1. 1.Usage
  • β€”Upload one or more resumes in PDF format
  • β€”Paste a job description in the text box
  • β€”Click β€œMatch Resumes” to see similarity scores

πŸ“Œ Example Use Case

Upload 5 resumes Paste: β€œLooking for a Python developer with ML, SQL, and data analysis skills” β†’ Get ranked similarity scores and best-matching resumes

🧾 License

This project is licensed under the MIT License


πŸ‘€ Author

Created by @saadtoorx If you like it, ⭐ star the repo and share with others!