🚀 CareerCompass - Resume & JD Matchmaking App

CareerCompass is a smart, interactive web app that helps candidates compare their Resume against any Job Description (JD) and discover:

• ✅ Skill Match %
• 📉 Missing skills
• 💡 Recommended projects to improve alignment

This project was designed as a personal job-seeking assistant to impress ATS systems and interviewers — and now it's open-sourced for others to benefit too!

---

🌟 Features

Capability	Description
📄 Resume Upload	Upload your resume (PDF) for analysis
📋 JD Input	Paste or upload job descriptions
🧠 Skill Extraction	NLP-based keyword extraction from resume and JD
📊 Match % Calculation	Uses TF-IDF + cosine similarity for match scoring
❌ Missing Skills Detection	Highlights the gaps in your resume
🔍 Smart Project Recommender	Suggests tailored projects from a JSON knowledge base
📈 Visual Insights	Live heatmaps and gauge charts for visual understanding

🧱 Project Architecture

careercompass_project/
├── app/
│   ├── jd_parser.py          # JD keyword extractor
│   ├── matcher.py            # Match % calculator
│   ├── recommender.py        # Recommends projects
│   ├── resume_parser.py      # Resume keyword extractor
│   └── utils.py              # Reusable NLP helpers
│
├── assets/
│   └── project_ideas.json    # 250 curated project suggestions
│
├── main.py                   # 🚀 Streamlit app entry point
├── requirements.txt          # All dependencies
├── runtime.txt               # Python version pin
├── README.md                 # You're reading it!
└── .gitignore

---

🔍 How It Works

1. Resume Parsing -Reads PDF content using PyPDF2 -Tokenizes, removes stopwords, extracts keywords

2. JD Parsing -Similar NLP pipeline as resume parsing -Extracts important required skills and terms

3. TF-IDF + Cosine Similarity -Converts both keyword lists into vectors -Calculates match percentage

4. Project Recommendations -Compares missing JD skills with skills in a curated list of 250+ projects -Suggests relevant project ideas

---

🌐 Deployment The app is deployed on Render at:

🔗 https://careercompass-app.onrender.com

---

🧠 Use Cases

• ✅ Freshers or students analyzing their resume before applying

• 🎯 Mid-level devs matching with job descriptions

• 📚 Project-based learning paths based on real-world JDs

• 📈 Career counselors helping others optimize resumes

---

🧩 Possible Future Enhancements

• 🔐 Login system with history tracking

• 🗂 Resume repository with versioning

• 🧠 LLMs for advanced JD parsing and personalized recommendations

• 🧪 Automated resume scoring with feedback

• ☁️ Cloud storage for parsed data