# TorchEasyRec

**Repository Path**: alibaba/TorchEasyRec

## Basic Information

- **Project Name**: TorchEasyRec
- **Description**: An easy-to-use for large scale recommendation algorithms.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2024-10-31
- **Last Updated**: 2025-12-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TorchEasyRec Introduction

## What is TorchEasyRec?

![intro.png](docs/images/intro.png)

### TorchEasyRec is an easy-to-use framework for Recommendation

TorchEasyRec implements state of the art deep learning models used in common recommendation tasks: candidate generation(matching), scoring(ranking), multi-task learning and generative recommendation. It improves the efficiency of generating high performance models by simple configuration and easy customization.

### Get Started

- [Local](docs/source/quick_start/local_tutorial.md)
- [PAI-DLC](docs/source/quick_start/dlc_tutorial.md)

## Why TorchEasyRec?

### Run everywhere

- Local / [PAI-DLC](https://help.aliyun.com/zh/pai/user-guide/container-training) / [PAI-DSW](https://help.aliyun.com/zh/pai/user-guide/dsw-notebook-service) / [EMR-DataScience](https://help.aliyun.com/document_detail/170836.html)

### Diversified input data

- [MaxCompute Table](https://help.aliyun.com/document_detail/27819.html)
- [OSS files](https://help.aliyun.com/product/31815.html)
- CSV files
- Parquet files

### Easy-to-use

- Flexible feature config and model config
- Easy to implement [customized models](docs/source/models/user_define.md)
- Easy deployment to [EAS](https://help.aliyun.com/zh/pai/user-guide/eas-model-serving): automatic scaling, easy monitoring

### Fast and robust

- Efficient and robust feature generation
- Large scale embedding with different sharding strategies
- Hybrid data-parallelism/model-parallelism
- Optimized kernels for RecSys powered by TorchRec
- Mixed precision
- Consistency guarantee: train and serving

### A variety of features & models

- IdFeature / RawFeature / ComboFeature / LookupFeature / MatchFeature / ExprFeature / KvDotProduct / BoolMaskFeature / OverlapFeature / TokenizeFeature / SequenceIdFeature / SequenceRawFeature / SequenceFeature
- Match: [DSSM](docs/source/models/dssm.md) / [TDM](docs/source/models/tdm.md) / [DAT](docs/source/models/dat.md) / [MIND](docs/source/models/mind.md)
- Rank: [WideAndDeep](docs/source/models/wide_and_deep.md) / [DeepFM](docs/source/models/deepfm.md) / [MultiTower](docs/source/models/multi_tower.md) / [DIN](docs/source/models/din.md) / [RocketLaunching](docs/source/models/rocket_launching.md) / [DLRM](docs/source/models/dlrm.md) / [MaskNet](docs/source/models/masknet.md) / [DCN](docs/source/models/dcn.md) / [DCNv2](docs/source/models/dcn_v2.md) / [xDeepFM](docs/source/models/xdeepfm.md)
- Multi-Task: [MMoE](docs/source/models/mmoe.md) / [DBMTL](docs/source/models/dbmtl.md) / [PLE](docs/source/models/ple.md)
- Generative-Rec: [DlrmHSTU](docs/source/models/dlrm_hstu.md)
- More models in development

## Contribute

Any contributions you make are greatly appreciated!

- Please report bugs by submitting a issue.
- Please submit contributions using pull requests.
- Please refer to the [Development](docs/source/develop.md) document for more details.

## Contact

### Join Us

- DingDing Group: 32260796, click [this url](https://h5.dingtalk.com/circle/joinCircle.html?corpId=ding1fe214a7fea14f55a39a90f97fcb1e09&token=a970cf981a8cd15424aeb839c0fdc2a4&groupCode=v1,k1,QH4dGSsGXXWW+onmBBumO1U9mQElyRKWi2x16a6oTVY=&from=group&ext=%7B%22channel%22%3A%22QR_GROUP_NORMAL%22%2C%22extension%22%3A%7B%22groupCode%22%3A%22v1%2Ck1%2CQH4dGSsGXXWW%2BonmBBumO1U9mQElyRKWi2x16a6oTVY%3D%22%2C%22groupFrom%22%3A%22group%22%7D%2C%22inviteId%22%3A75657307%2C%22orgId%22%3A644683226%2C%22shareType%22%3A%22GROUP%22%7D&origin=11) or scan QrCode to join!

- DingDing Group2: 37930014162, click [this url](https://h5.dingtalk.com/circle/joinCircle.html?corpId=ding1fe214a7fea14f55a39a90f97fcb1e09&token=a970cf981a8cd15424aeb839c0fdc2a4&groupCode=v1,k1,qTwau91MJZmxUClHh77gCsgcLASX0/eyhysrOf+8emQ=&from=group&ext=%7B%22channel%22%3A%22QR_GROUP_NORMAL%22%2C%22extension%22%3A%7B%22groupCode%22%3A%22v1%2Ck1%2CqTwau91MJZmxUClHh77gCsgcLASX0%2FeyhysrOf%2B8emQ%3D%22%2C%22groupFrom%22%3A%22group%22%7D%2C%22inviteId%22%3A75657307%2C%22orgId%22%3A644683226%2C%22shareType%22%3A%22GROUP%22%7D&origin=11) or scan QrCode to join!

  <img src="docs/images/qrcode/dinggroup1.JPG" alt="dingroup1" width="350">
    <img src="docs/images/qrcode/dinggroup2.JPG" alt="dingroup2" width="350">

- Email Group: easy_rec@service.aliyun.com.

### Enterprise Service

- If you have any questions about how to use TorchEasyRec, please join the DingTalk group and contact us.
- If you have enterprise service needs or need to purchase Alibaba Cloud services to build a recommendation system, please join the DingTalk group to contact us.

## License

TorchEasyRec is released under Apache License 2.0. Please note that third-party libraries may not have the same license as TorchEasyRec.