NVIDIA-Merlin / NVIDIA-Merlin/Merlin

[RMP] Quick Start for Session-Based Recommendation

Open
#927 0 comments 0 reactions 2 assignees View on GitHub

@sararb is already working on this.

Since Apr 26, 2023.

roadmap
Dominant language
Python
Stars
907
Forks
129
PR merge metrics
No merged PRs in 30d

Description

Problem:

Merlin provides documentation and a number of example notebooks on how to use tools like NVTabular, Dataloader and Merlin Models. In order to build a pipeline for training and evaluation purposes, a Data Scientist needs to analyze that material, copy-and-paste code snippets demonstrating the API and glue that code together to implement scripts for experimentation and benchmarking.
It might also not be clear to the users the advanced API options featured by Merlin Models that can be mapped as a hyperparameter, and potentially improve models accuracy.

Goal:

This RMP provides a Quick-start for building a training pipeline for session-based recommendation.
It addresses the ranking models part of this larger RMP https://github.com/NVIDIA-Merlin/Merlin/issues/732, in particular the steps 4-7 of the Data Scientist journey when experimenting with Merlin.

The Quick start for ranking is composed by:

Template scripts
  • Generic template script for preprocessing data for session-based recommendation
  • Generic template script for building and training models for session-based recommendation, exposing the main hyperparameters for ranking models .
    It includes support to sequential models like YouTubeDNN, RNNs and Transformers (backed by HuggingFace library).
Documentation
  • Documentation of the scripts command line arguments
  • Documentation of best practices learned from our experimentation:
    • Hyperparameter tuning: search space, most important hyperparameters and best hparams for REES46 dataset
    • Intuitions of API options (building blocks, arguments) that can improve models accuracy

Constraints:

  • Preprocessing - The pre-processing template notebook will perform some basic feature encoding for categorical (e.g. categorify) and continuous variables (e.g. standardization). It will also group interactions by session, sorted by timestamp
    The customer can expand the template with advanced preprocessing ops demonstrated in our examples.
  • Training - The training and evaluation script for Merlin Models should be totally configurable, taking as input the parquet files and schema, and a number of hyperparameters exposed via command line arguments. The output of this script should be the evaluation metrics, being optinally logged to Weights&Biases and Tensorboard.

Investigations

  • #1051
  • #1052

Starting Point:

Tasks

Dataset choice
  • #951
Preprocessing script
  • #940
  • #941
Modeling script
  • #942
  • #943
  • #944
  • #945
  • #946
  • #960
Experiments
  • #947
Documentation
  • #948
  • #949
  • #950
Deployment and inference with Triton
Tasks moved from #433 - Tensorflow support for session based recommendations integration in Merlin
Reproducibility of Transformers4Rec results and integration tests (23.01)
Support of advanced sequential tasks and the definition of examples (22.11)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.