Awesome

RecBole-FairRec

RecBole-FairRec is a library toolkit built upon RecBole for reproducing and developing fairness-aware recommendation.

Highlights

• Easy-to-use: Our library shares unified API and input(atomic files) as RecBole.
• Conveniently learn and compare: Our library provides several fairess-metrics and frameworks for learning and comparing.
• Extensive FairRec library: Recently proposed fairness-aware algorithms can be easily equipped in our library.

Requirements

python>=3.7.0
recbole>=1.0.1
numpy>=1.20.3
torch>=1.11.0
tqdm>=4.62.3

Quick-Start

With the source code, you can use the provided script for initial usage of our library:

python run_recbole.py

If you want to change the models or datasets, just run the script by setting additional command parameters:

python run_recbole.py -m [model] -d [dataset] -c [config_files]

Implement Models

We list the models that we have implemented up to now:

• FOCF from Sirui Yao et al:Beyond Parity：Fairness Objectives for Collaborative Filtering(NIPS 2017). Note: We implement this model with ranking-based metrics, e.g. NDCG@K.
• PFCN from Yunqi Li et al:Towards Personalized Fairness based on Causal Notion(SIGIR 2021)
  • PFCN_MLP
  • PFCN_BiasedMF
  • PFCN_DMF
  • PFCN_PMF
• FairGo from Wu Le et al:Learning Fair Representations for Recommendation: A Graph-based Perspective (WWW 2021)
  • FairGo_PMF(WAP,LBA,LVA)
  • FairGo_GCN(WAP,LBA,LVA)
• NFCF from Rashidul Islam et al:Debiasing career recommendations with neural fair collaborative filtering (WWW 2021)

Datasets

The datasets used can be downloaded from Datasets Link.

Hyper-parameters

We train the models with the default parameter settings, suggested in their original paper.[link]

The Team

RecBole-FairRec is developed and maintained by members from RUCAIBox, the main developers is Jiakai Tang (@Tangjiakai).

Acknowledgement

The implementation is based on the open-source recommendation library RecBole.

Please cite the following paper as the reference if you use our code or processed datasets.

@inproceedings{zhao2021recbole,
  title={Recbole: Towards a unified, comprehensive and efficient framework for recommendation algorithms},
  author={Wayne Xin Zhao and Shanlei Mu and Yupeng Hou and Zihan Lin and Kaiyuan Li and Yushuo Chen and Yujie Lu and Hui Wang and Changxin Tian and Xingyu Pan and Yingqian Min and Zhichao Feng and Xinyan Fan and Xu Chen and Pengfei Wang and Wendi Ji and Yaliang Li and Xiaoling Wang and Ji-Rong Wen},
  booktitle={{CIKM}},
  year={2021}
}