Reviews4Rec

This repository contains many popular recommender algorithms which use reviews as additional data. The code accompanies the paper "How Useful are Reviews for Recommendation? A Critical Review and Potential Improvements" [ACM] [Public PDF] where we critique different existing review-based recommendation algorithms and questions their reported performance.

If you find any module of this repository helpful for your own research, please consider citing the below SIGIR'20 paper. Thanks!

@inproceedings{SachdevaMcAuley20,
  author = {Noveen Sachdeva and Julian McAuley},
  title = {How Useful are Reviews for Recommendation? A Critical Review and Potential Improvements},
  booktitle = {ACM Conference on Research and Development in Information Retrieval (SIGIR)},
  year = {2020}
}

Code Author: Noveen Sachdeva (ernoveen@gmail.com)

Environents

Python3
- Pytorch >= 0.4.0
- Surprise: https://github.com/NicolasHug/Surprise
- Gensim: https://github.com/RaRe-Technologies/gensim
- h5py: https://github.com/h5py/h5py
Python2.7 (only for MPCN)
- Tensorflow-gpu >= 1.17.0
- Keras
- sklearn
- scipy

Setup

Data Setup

Once you've correctly setup the python environments and downloaded the dataset of your choice (Amazon: http://jmcauley.ucsd.edu/data/amazon/), the following steps need to be run:

$ ./prep_all_data.sh <HUMAN_FRIENDLY_DATASET_NAME> path/to/data/file.json

The above command will create the train/test/val splits along with some pre-processing scripts for running review-based methods like DeepCoNN/NARRE/TransNet much faster.

Setup for MPCN (Skip if not needed)

Since running MPCN requires a Python2.7 environment, you will need to modify Line#2 in the script run_MPCN_in_p2.sh to edit how to switch to the Python2.7 environment.

Run Instructions

Edit the hyper_params.py file which lists all config parameters, including what type of model to run. Currently supported models:

Model Type	Model Name	Paper Link
Non-textual	bias_only (or) baseline
Non-textual	MF_dot (or) NMF
Non-textual	SVD (or) SVD++
Non-textual	MF-dot
Non-textual	MF	MLP only version in NeuMF
Non-textual	NeuMF	LINK
Reviews as regularizer	HFT	LINK
Reviews as features	deepconn (or) deepconn++	LINK
Reviews as features	NARRE	LINK
Reviews as features	transnet (or) transnet++	LINK
Reviews as features	MPCN	LINK

Finally, type the following command to run:

$ CUDA_VISIBLE_DEVICES=<SOME_GPU_ID> python main.py

Contribution

As more and more algorithms using reviews for recommendation are published, please feel free to send a pull request with your algorithm and I'll be happy to merge it into this repository.

License

MIT

Beingafish/reviews4rec