Justinaquino: Add Resume / CV Renamer Pipeline tool article (intake, OCR/vision-OCR, AI extraction, rename, VCF export)

2026-07-31T14:25:40Z

Add Resume / CV Renamer Pipeline tool article (intake, OCR/vision-OCR, AI extraction, rename, VCF export)

New page

= Resume / CV Renamer Pipeline =

<div style="background:#f8f9fa; border:1px solid #ddd; border-radius:4px; padding:10px 16px; margin-bottom:16px;">
Automated resume ingestion, OCR, AI extraction, file renaming, and VCF contact export for recruitment workflows.
</div>

'''Location:''' <code>/path/to/resume-renamer/</code> (configure to your local HR/resume folder)

'''Upstream docs:''' [[Frappe HRMS - Ch01 Recruitment]]

----

== What It Does ==

# Drop a resume file (PDF, DOCX, JPG, PNG) into the folder.
# The scanner detects the new file and extracts text with <code>pdftotext</code>.
# Image files or image-based PDFs are converted with <code>img2pdf</code> and OCR'd with <code>ocrmypdf</code> if available.
# If OCR fails or is unavailable, the scanner falls back to '''vision OCR''' using a local VLM (e.g. <code>glm-ocr:bf16</code>).
# A local LLM extracts structured candidate data.
# The file is renamed to: <code>YYMMDD Full Name Degree.pdf</code>
# A <code>YYMMDD-HHMMSS_Bulk_Import.vcf</code> file is generated for contact import.

The single source of truth is the SQLite database <code>resumes.db</code>.

----

== Supported Inputs ==

{| class="wikitable"
! Format !! Handling
|-
| PDF with text || Direct extraction
|-
| Image-based PDF || <code>ocrmypdf</code> → vision OCR fallback
|-
| JPG / PNG || <code>img2pdf</code> → vision OCR fallback
|-
| DOCX || Detected; convert to PDF manually if needed
|}

----

== Quick Start ==

=== Run once manually ===

<syntaxhighlight lang="bash">
cd /path/to/resume-renamer
source ./venv/bin/activate
python cv_auto_scanner.py --once
</syntaxhighlight>

=== Dry-run preview ===

<syntaxhighlight lang="bash">
python cv_auto_scanner.py --once --dry-run
</syntaxhighlight>

=== Daemon mode ===

<syntaxhighlight lang="bash">
python cv_auto_scanner.py --daemon --interval 900 # 15 minutes
</syntaxhighlight>

=== Force a full re-scan ===

<syntaxhighlight lang="bash">
rm -f .scanner_state.json
python cv_auto_scanner.py --once
</syntaxhighlight>

----

== Common Issues ==

=== Degree shows "General" or is empty ===

The scanner now explicitly accepts diplomas and certificates in the <code>degree</code> field. If an older file still shows "General", reset it and reprocess:

<syntaxhighlight lang="bash">
source ./venv/bin/activate
python3 -c "
import resume_db
resume_db.init_db()
resume_db.upsert_candidate('ORIGINAL_FILENAME.pdf', status='pending', retry_count=0, last_error=None)
"
rm -f .scanner_state.json
python cv_auto_scanner.py --once
</syntaxhighlight>

=== "Text too short / unreadable" ===

The scanner automatically tries OCR and vision OCR. If it still fails:

<syntaxhighlight lang="bash">
source ./venv/bin/activate
python /path/to/rpdf-skills/vision_ocr.py FAILED_FILE.pdf --model glm-ocr:bf16 --format text -o extracted.txt
</syntaxhighlight>

Then rebuild a searchable PDF and re-run the scanner.

=== venv broken after Python upgrade ===

<syntaxhighlight lang="bash">
sudo apt install python3.14-venv python3-pip
cd /path/to/resume-renamer
rm -rf venv
python3.14 -m venv venv
source ./venv/bin/activate
pip install --upgrade pip
pip install img2pdf requests pdfplumber psycopg2-binary fpdf2
</syntaxhighlight>

----

== VCF Import ==

New <code>*_Bulk_Import.vcf</code> files are generated automatically. Import them into your contacts app:

* '''Google Contacts:''' contacts.google.com → Import → Select VCF
* '''Android:''' Copy VCF to phone → Contacts → Settings → Import
* '''Thunderbird:''' <code>thunderbird -compose "to=hr@example.com,subject=Contact Card,attachment=/path/to/YYMMDD-HHMMSS_Bulk_Import.vcf"</code>

The VCF uses a non-standard layout for multi-part names:

{| class="wikitable"
! vCard Field !! Value
|-
| <code>N</code> (Last Name) || Role context, e.g. <code>Electrical Applicant 260616</code>
|-
| <code>N</code> (First Name) || Candidate's full name
|-
| <code>FN</code> || <code>{Full Name} - {Context}</code>
|}

To specify the context for a batch:

<syntaxhighlight lang="bash">
python cv_auto_scanner.py --vcf-context "Electrical Applicant 260616"
</syntaxhighlight>

----

== Related Pages ==

* [[Frappe HRMS]]
* [[Frappe HRMS - Ch01 Recruitment]]
* [[Steps to Repair and OCR a Scanned or Corrupted PDF in Ubuntu]]
* [[🧠 Process: Selecting and Installing the Right Ollama Model for Your Hardware]]

[[Category:HR]]
[[Category:Recruitment]]
[[Category:Automation]]
[[Category:Comfac]]
[[Category:IT Operations]]

Resume CV Renamer Pipeline - Revision history

Justinaquino: Add Resume / CV Renamer Pipeline tool article (intake, OCR/vision-OCR, AI extraction, rename, VCF export)