Skip to content

shubhamtopiyal/job-recommendation-engine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

10 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Job Recommendation Engine

A personalised Job Recommendation Engine built with FastAPI, MongoDB, and Scikit-learn. It suggests jobs to candidates based on their skills using TF-IDF and Cosine Similarity.

๐Ÿš€ Features

  • Content-based job recommendations (skills โ†’ jobs)
  • FastAPI backend with REST API endpoints
  • MongoDB as the data source for users & job posts
  • Real-time recommendations based on candidate profile

๐Ÿ› ๏ธ Tech Stack

  • Backend: FastAPI (Python)
  • Database: MongoDB
  • Machine Learning: Scikit-learn (TF-IDF, Cosine Similarity)

โš™๏ธ Workflow

  • User adds skills in the portal.
  • React frontend sends request โ†’ /recommend/{user_id}.
  • FastAPI backend fetches user profile + job posts from MongoDB.
  • Recommender Engine (TF-IDF + Cosine Similarity) finds top matches.
  • Backend returns JSON with recommended jobs.
  • Frontend displays jobs to the user.

๐Ÿ“‚ Project Structure

job-recommendation-engine/
โ”‚โ”€โ”€ main.py                 # FastAPI entry point
โ”‚โ”€โ”€ routes/                 # API routes
โ”‚   โ””โ”€โ”€ recommendation.py   # Job recommendation endpoint
โ”‚โ”€โ”€ model/                  
โ”‚   โ””โ”€โ”€ recommender.py      # TF-IDF + Cosine similarity logic
โ”‚โ”€โ”€ database/               
โ”‚   โ””โ”€โ”€ db_connection.py    # MongoDB connection
โ”‚โ”€โ”€ requirements.txt        # Python dependencies
โ”‚โ”€โ”€ README.md               # Project documentation

๐Ÿ”ฎ Future Enhancements

  • Hybrid recommendations (skills + job history)
  • Resume parsing for auto-skill extraction
  • Deployment to cloud (Render, Vercel, or AWS)

๐ŸŒ Live Demo:

๐Ÿ“ง Contact:

Developed by Shubham Topiyal

๐Ÿ“จ shubhamtopiyal0786@gmail.com

๐Ÿ“Œ Feel free to reach out for feedback or collaboration!

About

๐Ÿš€ A Job Recommendation Engine built with FastAPI and MongoDB, designed to integrate with a job portal frontend. Uses TF-IDF + Cosine Similarity to recommend jobs to users based on their skills. Exposes a /recommend/{user_id} endpoint that returns personalized job suggestions in real-time.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages