← all repositories
datawhalechina/fun-rec

From collaborative filtering to diffusion models, one repo

Most recsys tutorials end at deep learning; this one keeps marching into LLMs, diffusion models, and production builds.

7.2k stars Python LearningDomain Apps
fun-rec
Not currently ranked — collecting fresh signals.
star history

What it does

Fun-Rec is an open-source Chinese textbook—self-styled the “Wheat Book”—that teaches recommendation systems from the ground up. It covers the classical cascade pipeline, from collaborative filtering and vector recall to ranking and rerank, then advances into generative territory: LLM-based reasoning, diffusion models, and hardware-aware scaling laws. The repository also includes a complete production-grade system with offline and online components.

The interesting bit

Rather than treating generative recommendation as a speculative research thread, the authors frame it as the next engineering chapter, dedicating full sections to industrial architectures like OneRec, HSTU, and even “thinking” models such as RecZero. It is essentially a community course trying to outrun the standard curriculum.

Key highlights

  • Starts with classical recall and ranking methods, then jumps to sequence modeling, multi-task learning, and diversity reranking.
  • Devotes half its syllabus to generative paradigms: tokenizer design for recsys, Scaling Law exploration, and end-to-end retrieval generation.
  • Surveys concrete industrial proposals including OneSearch, OneSug, and diffusion-based augmentations like DiffuASR.
  • Bundles a full production-level build covering system architecture, offline pipelines, online flow, and deployment.
  • Maintained by the Datawhale community under a CC BY-NC-SA 4.0 license.

Caveats

  • The project is a work in progress; the authors note that content and code change frequently and they are not currently accepting pull requests.
  • The core text is in Chinese, so non-Mandarin readers will need to rely on browser translation or the sparse English README.

Verdict

A strong bookmark for Mandarin-speaking developers who want a structured path from traditional recsys engineering to frontier generative methods. Look elsewhere if you need a polished, final-edition reference.

Frequently asked

What is datawhalechina/fun-rec?
Most recsys tutorials end at deep learning; this one keeps marching into LLMs, diffusion models, and production builds.
Is fun-rec open source?
Yes — datawhalechina/fun-rec is an open-source project tracked on heatdrop.
What language is fun-rec written in?
datawhalechina/fun-rec is primarily written in Python.
How popular is fun-rec?
datawhalechina/fun-rec has 7.2k stars on GitHub.
Where can I find fun-rec?
datawhalechina/fun-rec is on GitHub at https://github.com/datawhalechina/fun-rec.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.