Repolode
pyg-team

pyg-team/pytorch-frame

A PyTorch extension for building and training deep learning models on tabular data with mixed column types, including text and images.

Stars
802
Forks
75
Open issues
25
Last commit
5 days ago

What is it?

PyTorch Frame is a deep learning extension for PyTorch aimed at heterogeneous tabular data, where columns can be numerical, categorical, multi-categorical, timestamp, text, image, or embedding values. It provides a modular pipeline that turns a pandas DataFrame into a tensor frame, encodes each column type, models interactions between columns, and decodes predictions per row.

The library includes implementations of several deep tabular architectures, such as FTTransformer, ResNet, TabNet, TabTransformer, Trompt and ExcelFormer, along with XGBoost, CatBoost and LightGBM examples that use Optuna for hyperparameter tuning. It also ships with readily usable benchmark datasets and supports custom data. Text columns can be encoded with embeddings from OpenAI, Cohere, Voyage AI or Hugging Face models.

Because it builds directly on PyTorch and works with PyTorch Geometric, it can be combined with other PyTorch models, for example in relational database learning.

Key features

  • 01Supports numerical, categorical, multi-categorical, timestamp, text, image and embedding columns.
  • 02Implements several deep tabular models including FTTransformer, ResNet, TabNet and TabTransformer.
  • 03Provides GBDT examples (XGBoost, CatBoost, LightGBM) with Optuna hyperparameter tuning.
  • 04Offers a modular encoder, convolution and decoder design for building custom models.
  • 05Includes built-in tabular datasets and mini-batch data loaders.
  • 06Integrates with embedding APIs and Hugging Face models for text columns.

Use cases

  • Training a neural network on a business dataset that mixes numbers, categories and free-text fields.
  • Comparing new deep tabular architectures against GBDT baselines on standard benchmarks.
  • Adding LLM-generated text embeddings as features in a tabular prediction model.
  • Building custom tabular model architectures on top of PyTorch.

Things to know

  • The README excerpt has no installation instructions, so no install steps are listed here.
  • Some text-embedding examples rely on paid external embedding APIs such as OpenAI, Cohere, or Voyage AI.

Topics

FAQ

What is pytorch-frame?
A PyTorch extension for building and training deep learning models on tabular data with mixed column types, including text and images. PyTorch Frame is a deep learning extension for PyTorch aimed at heterogeneous tabular data, where columns can be numerical, categorical, multi-categorical, timestamp, text, image, or embedding values. It provides a modular pipeline that turns a pandas DataFrame into a tensor frame, encodes each column type, models interactions between columns, and decodes predictions per row.
Is pytorch-frame free to use? What license does it have?
pytorch-frame is open source under the MIT license. Check the license terms before using it in commercial products.
Is pytorch-frame still maintained?
Actively maintained. The last commit to pytorch-frame was on Nov 2, 2026.
What can I use pytorch-frame for?
Training a neural network on a business dataset that mixes numbers, categories and free-text fields. Comparing new deep tabular architectures against GBDT baselines on standard benchmarks. Adding LLM-generated text embeddings as features in a tabular prediction model. Building custom tabular model architectures on top of PyTorch.
Where can I get pytorch-frame?
The source code and installation instructions are on GitHub: https://github.com/pyg-team/pytorch-frame

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects