explaingit

asaander719/coupledhsr

21PythonAudience · researcherComplexity · 4/5Setup · hard

TLDR

Research code for TacoRec, an AI model that studies multiple types of user behavior on e-commerce platforms at once to make more accurate product recommendations than single-behavior approaches.

Mindmap

mindmap
  root((coupledhsr))
    What it does
      Multi-behavior recommendation
      E-commerce prediction
      Hyperparameter sweep
    Tech Stack
      Python
      RecBole toolkit
    Datasets
      JD e-commerce data
      UserBehavior dataset
    Research Use
      Reproduce TacoRec results
      Compare with AMPL baseline
      Accuracy benchmarking
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Reproduce the TacoRec recommendation model results on the JD or UserBehavior dataset by running the provided training scripts.

USE CASE 2

Run a hyperparameter sweep to find the best learning rate and model size for TacoRec and compare accuracy against the AMPL baseline.

USE CASE 3

Adapt the data conversion script to prepare your own e-commerce interaction dataset in the format expected by RecBole.

Tech stack

PythonRecBole

Getting it running

Difficulty · hard Time to first run · 1day+

Requires downloading large e-commerce datasets and applying the original dataset preprocessing filters before running the conversion script, which only handles format conversion.

In plain English

This is a research code repository for TacoRec, an AI model designed to study how people behave on e-commerce platforms and predict what they might do next. Specifically, it looks at multiple types of user actions at once, such as clicking, adding to cart, favoriting, and purchasing, rather than treating each behavior in isolation. The goal is to make more accurate recommendations by understanding the connections between these different actions. The repository works with two datasets drawn from real e-commerce platforms: one from JD (a Chinese online retailer) and one called UB (UserBehavior). Both datasets contain hundreds of thousands of user interaction sequences. Scripts in the repo convert these datasets into a format that works with RecBole, a research toolkit for building and testing recommendation models. To use the code, a researcher would first run a conversion script to prepare the dataset files, then run a training script specifying which model and dataset to use. The README provides separate commands for running on a single behavior type (for example, just purchase data) or across all behavior types at once. There is also a hyperparameter sweep script that tries different combinations of settings, such as learning rate and model size, and records results including accuracy, training time, GPU memory usage, and computational cost. The repository also includes commands for running a baseline model called AMPL, which lets researchers compare TacoRec's results against an existing method. An important note in the README explains that the data conversion script does not apply the original dataset's preprocessing filters itself, it assumes those filters have already been applied and only handles the format conversion step. The README is written primarily for researchers reproducing or building on this work. There is no explanation of the model's internal design or links to a paper.

Copy-paste prompts

Prompt 1
I have the coupledhsr repo and the JD dataset downloaded. Show me the exact commands to run the data conversion script and then train TacoRec across all behavior types at once.
Prompt 2
How do I run the AMPL baseline in coupledhsr so I can compare its precision and recall metrics against TacoRec on the same dataset split?
Prompt 3
I want to run the hyperparameter sweep in coupledhsr. What settings does it try, which accuracy metrics does it record, and where does the output get saved?
Open on GitHub → Explain another repo

← asaander719 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.