---
id: tensorflow-recommenders
version: "0.7.7"
license: Apache 2.0
license_treatment: permissive
maintenance: active
---

# tensorflow-recommenders — Tensorflow Recommenders, a TensorFlow library for recommender systems.

License: permissive · Maintenance: active · Downloads: 203.9K/mo

## What it is and what it does

TensorFlow Recommenders is a Keras-based library for building recommender systems on top of TensorFlow. It abstracts away common patterns in recommendation workflows—embedding layers, ranking tasks, retrieval metrics—so you can focus on model architecture rather than boilerplate. The library is designed with a gentle learning curve but retains flexibility for complex models; it handles data preparation, model formulation, training, evaluation, and deployment as an integrated workflow.

The package depends on tensorflow, tf-keras, and absl-py, and is built to work seamlessly within the TensorFlow ecosystem. It provides task abstractions (like Retrieval) and metric classes (like FactorizedTopK) that simplify the definition of loss functions and evaluation criteria for recommendation problems. The library is actively maintained, with recent commits and a permissive Apache 2.0 license.

Use it for:

- Build a matrix factorization model to predict user ratings for unseen movies or products.
- Train a two-tower neural network for candidate retrieval in a large-scale recommendation system.
- Evaluate ranking quality using built-in metrics like FactorizedTopK across a full candidate set.
- Combine user and item embeddings with custom Keras layers to model complex interaction patterns.
- Deploy a trained recommender model using TensorFlow's standard serving infrastructure.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

TensorFlow Recommenders provides a Keras-based library for building recommender system models, covering the full workflow from data preparation through training, evaluation, and deployment.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and offers a well-structured abstraction for a common ML task. It is suitable for developers building recommender systems who want to leverage TensorFlow's ecosystem without writing boilerplate. The Apache 2.0 license is permissive for commercial use.

## Install

pip install tensorflow-recommenders
uv add tensorflow-recommenders
poetry add tensorflow-recommenders

## Installing tensorflow-recommenders

Before you install: Low install friction with a pure-Python wheel. The package is actively maintained with recent commits and depends on core TensorFlow ecosystem libraries (tensorflow, tf-keras, absl-py), all of which are well-established.

License in practice: Apache 2.0 is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install tensorflow-recommenders

import tensorflow_recommenders as tfrs
import tensorflow as tf

class Model(tfrs.Model):
  def __init__(self):
    super().__init__()
    self.user_model = tf.keras.layers.Embedding(input_dim=2000, output_dim=64)
    self.item_model = tf.keras.layers.Embedding(input_dim=2000, output_dim=64)
    self.task = tfrs.tasks.Retrieval()
  
  def compute_loss(self, features, training=False):
    user_embeddings = self.user_model(features["user_id"])
    item_embeddings = self.item_model(features["item_id"])
    return self.task(user_embeddings, item_embeddings)

model = Model()
model.compile(optimizer=tf.keras.optimizers.Adagrad(0.5))

Requires TensorFlow 2.x to be installed separately; the package does not bundle TensorFlow itself.

Verify before relying:

- Whether the package supports distributed training across multiple GPUs or TPUs.
- Performance characteristics and scalability limits for large-scale datasets.
- Availability of pre-built models or transfer learning capabilities.

## Package facts

- License: Apache 2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 203.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

recommendation system tensorflow, collaborative filtering keras, neural recommender models, matrix factorization tensorflow, ranking and retrieval models, user item embedding, recommender system framework, recommendation-engine, neural-networks, keras-framework

[View on SkillFed](https://skillfed.io/packages/tensorflow-recommenders) · [View on PyPI](https://pypi.org/project/tensorflow-recommenders/)