Repolode
datawhalechina

datawhalechina/torch-rechub

Framework PyTorch para criar modelos de recomendação, com mais de 30 modelos integrados de ranking, matching, multitarefa e generativos, além de exportação para ONNX.

Estrelas
1,233
Forks
158
Issues abertas
4
Último commit
há 8 horas

O que é?

O Torch-RecHub é um framework baseado em PyTorch para criar sistemas de recomendação. Ele reúne uma biblioteca de modelos clássicos e recentes, incluindo modelos de ranking de CTR, como DeepFM e DCN; modelos de matching de duas torres e sequenciais, como DSSM e SASRec; modelos multitarefa, como MMoE e PLE; e sistemas de recomendação generativa, como HSTU e TIGER. Cada modelo é treinado por meio de trainers compartilhados para configurações de CTR, matching e multitarefa, com fluxos unificados de carregamento de dados e avaliação.

O framework foi projetado para ser modular, permitindo adicionar novos modelos, conjuntos de dados e métricas sem reescrever o pipeline. Os modelos treinados podem ser exportados para ONNX para implantação. Ele funciona em CPU, NVIDIA CUDA, AMD ROCm e Huawei Ascend NPU, e oferece extras opcionais para busca vetorial com Annoy, FAISS e Milvus, processamento de dados compatível com PySpark via PyArrow e acompanhamento de experimentos com WandB, SwanLab ou TensorBoardX.

Recursos principais

  • 01Implementa mais de 30 modelos de recomendação de ranking, matching, multitarefa e generativos.
  • 02Oferece trainers e carregadores de dados unificados para treinamento de CTR, matching e multitarefa.
  • 03Exporta modelos treinados para ONNX para implantação em produção.
  • 04Funciona em CPU, GPU NVIDIA, AMD ROCm e Huawei Ascend NPU.
  • 05Integra WandB, SwanLab e TensorBoardX para acompanhar experimentos.
  • 06Oferece suporte opcional a FAISS, Annoy e Milvus para busca vetorial.

Casos de uso

  • Criar protótipos de modelos de previsão de CTR com conjuntos de dados como Criteo ou Avazu.
  • Criar modelos de recuperação de duas torres e exportar separadamente as torres de usuários e itens.
  • Treinar modelos de ranking multitarefa para objetivos conjuntos, como cliques e conversões.
  • Experimentar métodos de recomendação baseados em LLM ou generativos, como HSTU e HLLM.

Início rápido

  1. 1

    Instale o PyTorch e o pacote com pip

    pip install torch && pip install torch-rechub
  2. 2

    Clone o repositório

    git clone https://github.com/datawhalechina/torch-rechub.git
  3. 3

    Instale as dependências com uv

    uv sync
  4. 4

    Execute o exemplo de correspondência DSSM na pasta correspondente

    cd examples/matching && python run_ml_dssm.py

Antes de usar

  • É necessária uma versão do PyTorch compatível com o hardware, o driver e o ambiente de execução, o que pode exigir algum esforço de configuração.
  • Alguns recursos, como exportação para ONNX, visualização e rastreamento, exigem a instalação separada de extras opcionais.

Tópicos

Perguntas frequentes

O que é torch-rechub?
Framework PyTorch para criar modelos de recomendação, com mais de 30 modelos integrados de ranking, matching, multitarefa e generativos, além de exportação para ONNX. O Torch-RecHub é um framework baseado em PyTorch para criar sistemas de recomendação. Ele reúne uma biblioteca de modelos clássicos e recentes, incluindo modelos de ranking de CTR, como DeepFM e DCN; modelos de matching de duas torres e sequenciais, como DSSM e SASRec; modelos multitarefa, como MMoE e PLE; e sistemas de recomendação generativa, como HSTU e TIGER. Cada modelo é treinado por meio de trainers compartilhados para configurações de CTR, matching e multitarefa, com fluxos unificados de carregamento de dados e avaliação.
torch-rechub é gratuito? Qual é a licença?
torch-rechub é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
torch-rechub ainda é mantido?
Manutenção ativa. O último commit de torch-rechub foi em 22 de out. de 2026.
Para que posso usar torch-rechub?
Criar protótipos de modelos de previsão de CTR com conjuntos de dados como Criteo ou Avazu. Criar modelos de recuperação de duas torres e exportar separadamente as torres de usuários e itens. Treinar modelos de ranking multitarefa para objetivos conjuntos, como cliques e conversões. Experimentar métodos de recomendação baseados em LLM ou generativos, como HSTU e HLLM.
Como instalar torch-rechub?
Instale o PyTorch e o pacote com pip: pip install torch && pip install torch-rechub Clone o repositório: git clone https://github.com/datawhalechina/torch-rechub.git Instale as dependências com uv: uv sync Execute o exemplo de correspondência DSSM na pasta correspondente: cd examples/matching && python run_ml_dssm.py
Onde consigo torch-rechub?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/datawhalechina/torch-rechub

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados