resume-analyzer

A resume analyzer built using FastAPI, scikit-learn, and React. Covers NLP techniques, Python programming, and full-stack development.

---

stack

• backend — Python, FastAPI, Uvicorn, pdfplumber
• ml — scikit-learn (TF-IDF, cosine similarity)
• frontend — React, Tailwind CSS, Vite

---

setup

backend

cd backend
python -m venv venv
source venv/bin/activate  # windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload

frontend

cd frontend
npm install
npm run dev

backend → http://localhost:8000
frontend → http://localhost:5173
api docs → http://localhost:8000/docs

---

limitations

• text-based PDFs only, scanned/image PDFs are not supported
• keyword matching is exact, synonyms and variations are not handled
• TF-IDF does not understand context or meaning, match scores tend to be lower than expected
• scoring weights are fixed and may not suit every role or industry

---

future improvements

• semantic matching using Sentence Transformers
• OCR support for scanned PDFs
• DOCX file support
• synonym normalization for tech terms
• role-specific scoring weights