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

138 Stars 33 Forks 247 Commits 0 Opened issues


A tour through recommendation algorithms in python [IN PROGRESS]

Services available


Need anything else?

Contributors list

# 85,968
243 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.

At the moment the datasets included are:

  1. the Ponpare coupon dataset, which corresponds to a coupon purchase prediction competition at Kaggle (i.e. recommending coupons to customers).
  2. the Amazon Reviews dataset, in particular the 5-core Movies and TV reviews

Each of the two datasets is used to illustrate a set of different techniques, although I explored a wider range of techniques with the

dataset and the corresponding notebooks are, in general, more detailed.

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.

This is what you will find in the notebooks:


  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


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

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.