Need help with RecoTour?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

147 Stars 38 Forks 251 Commits 0 Opened issues


A tour through recommendation algorithms in python [IN PROGRESS]

Services available


Need anything else?

Contributors list

# 70,836
246 commits


This repo intends to be a tour through some recommendation algorithms in python using various dataset. Companion posts are:

  1. Recotour: a tour through recommendation algorithms in python

  2. RecoTour II: neural recommendation algorithms

  3. RecoTour III: Variational Autoencoders for Collaborative Filtering with Mxnet and Pytorch.

The repo is organised as follows:

  1. recotour: this is the original "tour" through recommendation algorithms using the Ponpare coupon dataset. In particular, the algorithms included in the
    directory are:
    1. Data processing, with a deep dive into feature engineering
    2. Most Popular recommendations (the baseline)
    3. Item-User similarity based recommendations
    4. kNN Collaborative Filtering recommendations
    5. GBM based recommendations using
      with a tutorial on how to optimize gbms
    6. Non-Negative Matrix Factorization recommendations
    7. Factorization Machines (Steffen Rendle 2010) recommendations using
    8. Field Aware Factorization Machines (Yuchin Juan, et al, 2016) recommendations using
    9. Deep Learning based recommendations (Wide and Deep, Heng-Tze Cheng, et al, 2016) using

I have included a more modular (nicer looking) version of a possible final solution (described in

) in the directory

In addition, I have included an illustration of how to use other evaluation metrics apart from the one shown in the notebooks ( the mean average precision or MAP) such as the Normalized Discounted Cumulative Gain (NDCG). This can be found in
in the directory

In addition, there are other, DL-based recommendation algorithms that use mainly the Amazon Reviews dataset, in particular the 5-core Movies and TV reviews. These are:

  1. neural_cf: Neural Collaborative Filtering (Xiangnan He et al., 2017)
  2. neuralgraphcf: Neural Graph Collaborative Filtering (Wang Xiang et al. 2019)
  3. mult-vae: Variational Autoencoders for Collaborative Filtering (Dawen Liang et al,. 2018)

The core of the repo are the notebooks in each directory. They intend to be self-contained and in consequence, there is some of code repetition. The code is, of course, "notebook-oriented". The notebooks have plenty of explanations and references to relevant papers or packages. My intention was to focus on the code, but you will also find some math.

I hope the code here is useful to someone. If you have any idea on how to improve the content of the repo, or you want to contribute, let me know.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.