OpenResume Parser for Python

openresume-parser extracts structured, ATS-friendly resume data from PDF files or already-extracted text items. Parsing runs locally by default.

Install

Install the released package from PyPI:

py -m pip install openresume-parser

Install the optional OCR support when needed:

py -m pip install "openresume-parser[ocr]"

Usage

from openresume import parse_resume_from_pdf, parse_resume_from_text_items

result = parse_resume_from_pdf("resume.pdf")
if result["ok"]:
    print(result["resume"]["contact"]["email"])
else:
    print(result["error"]["code"], result["error"]["message"])

native_result = parse_resume_from_text_items([
    {
        "text": "JANE DOE",
        "x": 40, "y": 760, "width": 80, "height": 12,
        "fontName": "Helvetica-Bold", "hasEOL": True,
        "pageNumber": 1, "sourceIndex": 0,
    },
])

PDF parsing uses pypdf. OCR.Space is opt-in and requires an API key supplied by the application:

result = parse_resume_from_pdf(
    "scanned-resume.pdf",
    {"api_key": "your-api-key", "language": "eng"},
)

Build and publish

Run these commands from this directory:

py -m pip install --upgrade build twine
py -m build
py -m twine check dist/*
py -m twine upload dist/*

For a local install while developing:

py -m pip install -e ".[test]"
py -m pytest

Do not commit PyPI credentials or OCR API keys. The package requires Python 3.9 or newer.