Skip to content
A simple resume parser used for extracting information from resumes
Branch: master
Clone or download

Latest commit

Latest commit 1a81c13 Mar 29, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Feb 6, 2020
docs Updated README Dec 14, 2019
pyresparser flake8 fixes Mar 29, 2020
.gitignore Initial commit Jul 1, 2019
.travis.yml Update .travis.yml Nov 7, 2019
LICENSE Initial commit Jul 1, 2019 Released new version with custom model Oct 2, 2019
OmkarResume.pdf Added export data to JSON functionality Nov 10, 2019 Updated README Dec 14, 2019
README.rst Release v1.0.6 Dec 15, 2019
mkdocs.yml Fixes #10 Dec 14, 2019
requirements.txt Bump nltk from 3.4.3 to 3.4.5 Aug 27, 2019 Release v1.0.6 Dec 15, 2019 Added export data to JSON functionality Nov 10, 2019


A simple resume parser used for extracting information from resumes

Built with ❤︎ and ☕️ by Omkar Pathak

GitHub stars PyPI Downloads GitHub PyPI - Python Version Say Thanks! Build Status codecov


  • Extract name
  • Extract email
  • Extract mobile numbers
  • Extract skills
  • Extract total experience
  • Extract college name
  • Extract degree
  • Extract designation
  • Extract company names


  • You can install this package using
pip install pyresparser
  • For NLP operations we use spacy and nltk. Install them using below commands:
# spaCy
python -m spacy download en_core_web_sm

# nltk
python -m nltk.downloader words


Official documentation is available at:

Supported File Formats

  • PDF and DOCx files are supported on all Operating Systems
  • If you want to extract DOC files you can install textract for your OS (Linux, MacOS)
  • Note: You just have to install textract (and nothing else) and doc files will get parsed easily


  • Import it in your Python project
from pyresparser import ResumeParser
data = ResumeParser('/path/to/resume/file').get_extracted_data()


For running the resume extractor you can also use the cli provided

usage: pyresparser [-h] [-f FILE] [-d DIRECTORY] [-r REMOTEFILE]
                   [-re CUSTOM_REGEX] [-sf SKILLSFILE] [-e EXPORT_FORMAT]

optional arguments:
  -h, --help            show this help message and exit
  -f FILE, --file FILE  resume file to be extracted
  -d DIRECTORY, --directory DIRECTORY
                        directory containing all the resumes to be extracted
  -r REMOTEFILE, --remotefile REMOTEFILE
                        remote path for resume file to be extracted
  -re CUSTOM_REGEX, --custom-regex CUSTOM_REGEX
                        custom regex for parsing mobile numbers
  -sf SKILLSFILE, --skillsfile SKILLSFILE
                        custom skills CSV file against which skills are
                        searched for
  -e EXPORT_FORMAT, --export-format EXPORT_FORMAT
                        the information export format (json)


  • If you are running the app on windows, then you can only extract .docs and .pdf files


The module would return a list of dictionary objects with result as follows:

    'college_name': ['Marathwada Mitra Mandal’s College of Engineering'],
    'company_names': None,
    'degree': ['B.E. IN COMPUTER ENGINEERING'],
    'designation': ['Manager',
                    'TECHNICAL CONTENT WRITER',
                    'DATA ENGINEER'],
    'email': '',
    'mobile_number': '8087996634',
    'name': 'Omkar Pathak',
    'no_of_pages': 3,
    'skills': ['Operating systems',
    'total_experience': 1.83

References that helped me get here


If you have found my softwares to be of any use to you, do consider helping me pay my internet bills. This would encourage me to create many such softwares 😄

PayPal Donate via PayPal!
₹ (INR) Donate via Instamojo

Stargazer over time

Stargazers over time

You can’t perform that action at this time.