Skip to content

elabongaatuo/nukato-perfume-recommender

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nukato Perfume Recommender

Ever had trouble finding your perfume dupe or just a perfume you may like, when your favorite bottle runs out. This simple perfume recommendation system is out to solve that. Key in your perfume in the 'Find Your Perfume' page and you'll get a list of suggestions to try.It may not be perfume shazam, but it's a great place to start!

Important Links

Indulge your senses here
Would you like to know how a recommender system works?No worries, I go over a simple one and explain how this project works here

Introduction

Frustrating, is what I would describe the process of looking for a new perfume when you just can't find your favorite one in stock. Perfumes have a science to them, layers upon layers to build a scent that is unique to you. In this project, I scraped a couple of websites for perfume details to create my dataset (perfume.csv). I then made a function that offers recommendations based on cosine similarity. And for interaction, I deployed it to a website. The important links are above. :)

Project Flow

  • Create a recommendation function using cosine similarity
  • Use FASTAPI to make web-app
  • Build Interactive Website

Technologies Used

  1. Python 3.7
  2. Javascript
  3. Bootstrap CSS 5.2.3 (Installed via CDN)
  4. FASTAPI

Installation and Usage

# clone repo
git clone [email protected]:elabongaatuo/nukato-perfume-recommender.git
# change into directory
cd nukato-perfume-recommender
# install the necessary packages
pip install -r requirements.txt
# start the server
uvicorn app:app --reload

Visit http://127.0.0.1:8000/docs , you should see this...

Web Demo

Author

Elabonga Atuo
Reach out to me via email

Known Issues and Suggested Improvements

Loading the scripts may take a hot minute. Try minifying the javascript file. ToDo: Improve loading time

Files

  1. static folder - This contains the static html,css and javascript files and the demos(video and images)
  2. perfume.csv - contains a list of perfumes and details
  3. improv_recsys.py - contains the recommender system code
  4. app.py - contains FASTAPI setup

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published