resume-matcher-bert

Resume Matcher – BERT Model (Domain-Adapted MiniLM)

This repository contains a domain-adapted BERT model (MiniLM variant) designed for semantic matching of resumes and job descriptions.
It also includes a pre-built FAISS index of job embeddings for fast similarity search.

---

Repository Contents

• applicant/
  • jobs.faiss – FAISS index with pre-computed embeddings for job descriptions.
• dapt_minilm_huggingface/
  • Fine-tuned model files (config, tokenizer, vocabulary, and weights).

---

How to Use

Applicant Use Case

An applicant can provide a single resume and retrieve the top-k most relevant job titles, based on semantic similarity rather than keyword overlap.

from sentence_transformers import SentenceTransformer
import faiss, numpy as np

# Load model
model = SentenceTransformer("your-username/resume-matcher-bert/dapt_minilm_huggingface")

# Encode resume
resume_text = "Experienced data scientist skilled in NLP and computer vision."
resume_vec = model.encode([resume_text])

# Load FAISS index
index = faiss.read_index("applicant/jobs.faiss")

# Search top matches
D, I = index.search(np.array(resume_vec, dtype="float32"), k=5)
print("Top matching job indices:", I[0])

Recruiter Use Case

A recruiter can upload a job description and a set of candidate resumes. The system encodes all documents with the MiniLM model and ranks the resumes according to their semantic closeness to the job description.

from sentence_transformers import SentenceTransformer
from sklearn.metrics.pairwise import cosine_similarity
import numpy as np

# Load model
model = SentenceTransformer("your-username/resume-matcher-bert/dapt_minilm_huggingface")

# Example job description
job_desc = "Hiring a data scientist with experience in Python, NLP, and deep learning."
job_vec = model.encode([job_desc])

# Example resumes
resumes = [
    "Software engineer with Java and Spring Boot background.",
    "Data scientist with Python, NLP, and machine learning expertise.",
    "Frontend developer with React and UI/UX design skills."
]

# Encode resumes
resume_matrix = model.encode(resumes)

# Compute similarity
scores = cosine_similarity([job_vec], resume_matrix)[0]

# Rank resumes
ranked_indices = np.argsort(scores)[::-1]
for idx in ranked_indices:
    print(f"Resume: {resumes[idx]} | Score: {scores[idx]:.4f}")

---

License

This project is released under the Apache License 2.0. It may be used for both academic and commercial purposes, with proper attribution.

---

Notes

• Use this model when you need contextual, semantic understanding rather than keyword matching.
• If you require a lighter baseline or need faster results, refer to the TF-IDF version.