Refer’d Resume Scanner

I wanted to share a free resource we built to assist applicants with resume building. Our resume scanner identifies potential skills gaps between resumes and job listings while also serving as a resume checklist.

Explore the docs »

Report Bug
Request Feature

Table of Contents
  1. About The Project

  2. Getting Started

  3. Usage
  4. Roadmap
  5. Contact

About The Project

Product Name Screen Shot

We built this scanner to allow applicants to freely check how their resume stacks up against jobs they want to apply to. Check out our core product at

(back to top)

Built With

  • Python
  • HTML
  • CSS
  • JavaScript

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.


  • pip

    pip install -r requirements.txt 


  1. Clone the repo

    git clone
  2. Install packages

    pip install -r requirements.txt 
  3. You may need to install additional nltk word libraries

  4. Create a file (in the resume_scanner directory) specifying the parameters listed (see

(back to top)


Feel free to run this scanner on your local machine. Hopefully this gives you some insight on how you stack up to jobs you’re interested in.

REMEMBER this scanner was built to model the ones used in the market today. What may look like a bug may have been intentional but please let us know.

For the most upto date scanner please go to

(We try to keep this repository up to date but it often lags behind the live scanner)

(back to top)


  • We plan to incorporate a better list of skills
  • There are known issues with education being captured as years experience

See the open issues for a full list of proposed features (and known issues).

(back to top)


Chris Luong or Addison Narter – [email protected]

Project Link:

(back to top)


View Github