An open API service indexing awesome lists of open source software.

https://github.com/octodemo/noseknows-universe

get the most out of Github Copilot
https://github.com/octodemo/noseknows-universe

Last synced: 6 months ago
JSON representation

get the most out of Github Copilot

Awesome Lists containing this project

README

          

# NoseKnows: Fragrance Recommendation API 🌸

NoseKnows analyzes your favorite perfumes and makes a recommendation for other fragrances you may like.

## Features
**Personalized Recommendations**: Leveraging KNN Algorithm, NoseKnows provides users with personalized fragrance recommendations that align with their unique preferences and past selections.

## Tech Stack

- **AI & Machine Learning**: Python with Scikit-learn
- **Backend**: Python with Flask
- **Database**: TBD

> The initial dataset is from Kaggle and can be found by [clicking here](https://www.kaggle.com/datasets/nandini1999/perfume-recommendation-dataset).

## Local Development

1. Clone the repository
2. Install the dependencies by running `pip install -r requirements.txt`
3. Run the application by executing `flask run`
4. Navigate to to the endpoint `/api/recommend` to perform a `POST` request

In the body of the request, include the following JSON object:
```
{
"fav_perfumes": [
"Sola Parfum",
"Amber Eau de Parfum",
"Black Citrus Eau de Parfum"
]
}
```

## Resources to learn more

- [Using GitHub Copilot in your IDE: Tips, tricks, and best practices](https://github.blog/2024-03-25-how-to-use-github-copilot-in-your-ide-tips-tricks-and-best-practices/)
- [10 unexpected ways to use GitHub Copilot](https://github.blog/2024-01-22-10-unexpected-ways-to-use-github-copilot/)
- [How to use Github Copilot in the CLI](https://www.youtube.com/watch?v=fHwtrOcLAnI&t=32s)
- [Prompt crafting with GitHub Copilot](https://www.youtube.com/watch?v=GPLUGJsVx0s)

---