koolsla

Linux	Windows

Description

koolsla (Coleslaw) is a recommendation tool based on Machine Learning with contents. Developed with the power of tf-idf and Cosine Similarity.

The user gives a natural number that corresponds to the ID of a unique dish name. Through tf-idf the plot summaries of 424508 different dishes that reside in the dataset, are analyzed and vectorized. Set of dishes (number set by user) is chosen as recommendations based on their cosine similarity with the vectorized input.

koolsla is mainly an educational project.

Installation

You can install koolsla using:

$ pip install koolsla

Getting the code

The code is hosted at https://github.com/abdullahselek/koolsla

Check out the latest development version anonymously with:

$ git clone git://github.com/abdullahselek/koolsla.git
$ cd koolsla

To install test dependencies, run either:

$ pip install -Ur requirements.testing.txt

Running Tests

The test suite can be run against a single Python version which requires pip install pytest and optionally pip install pytest-cov (these are included if you have installed dependencies from requirements.testing.txt)

To run the unit tests with a single Python version:

$ py.test -v

To also run code coverage:

$ py.test --cov=koolsla

To run the unit tests against a set of Python versions:

$ tox

Sample Usage

Import recommender:

from koolsla import recommender

Getting recommendations with dish id and recommendation count:

// Returns dictionary of tuples [(dish_id_1, similarity_ratio1), (dish_id_2, similarity_ratio2), (dish_id_3, similarity_ratio3)]
recommendatons = recommender.recommend(82, 3)

CLI

After getting the code from https://github.com/abdullahselek/koolsla, run command:

$ pip install -r requirements.txt

And it's ready to use, there is detailed help menu which you can follow. One of the most used function for recommendation:

$ python koolsla.py -d 25 --recommend 3

For the help menu:

$ python koolsla.py --help