SparseOperationKit

Sparse Operation Kit (SOK) is a Python package wrapped GPU accelerated operations dedicated for sparse training / inference cases. It is designed to be compatible with common deep learning (DL) frameworks like TensorFlow.

Most of the algorithm implementations in SOK are extracted from HugeCTR. HugeCTR is a GPU-accelerated recommender framework designed to distribute training across multiple GPUs and nodes for Click-Through Rate (CTR) estimation. If you are looking for a very efficient solution for CTR estimation, please see the HugeCTR documentation or our GitHub repository.

Features

Model-Parallelism GPU Embedding Layer
In sparse training / inference scenarios, for instance, CTR estimation, there are vast amounts of parameters which cannot fit into the memory of a single GPU. Many common DL frameworks only offer limited support for model parallelism (MP), because it can complicate using all available GPUs in a cluster to accelerate the whole training process.

SOK provides broad MP functionality to fully utilize all available GPUs, regardless of whether these GPUs are located in a single machine or multiple machines. Simultaneously, SOK takes advantage of existing data-parallel (DP) capabilities of DL frameworks to accelerate training while minimizing code changes. With SOK embedding layers, you can build a DNN model with mixed MP and DP. MP is used to shard large embedding parameter tables, such that they are distributed among the available GPUs to balance the workload, while DP is used for layers that only consume little GPU resources.

SOK provides multiple types of MP embedding layers, optimized for different application scenarios. These embedding layers can leverage all available GPU memory in your cluster to store/retrieve embedding parameters. As a result, all utilized GPUs work synchronously.

SOK is compatible with DP training provided by common synchronized training frameworks, such as Horovod. Because the input data fed to these embedding layers can take advantage of DP, additional DP from/to MP transformations are needed when SOK is used to scale up your DNN model from single GPU to multiple GPUs. The following picture illustrates the workflow of these embedding layers.

Installation

There are several ways to install this package.

Obtaining SOK and HugeCTR via Docker

This is the quickest way to get started with SOK. We provide containers with pre-compiled binaries of the latest HugeCTR and SOK versions(also can manually install SOK into nvcr.io/nvidia/tensorflow series images). To get started quickly with container on your machine, run the following command:

docker run nvcr.io/nvidia/merlin/merlin-tensorflow:23.11

In production, replace the latest tag with a specific version. Refer to the Merlin TensorFlow container page on NGC for more information.

Sparse Operation Kit is already installed in the container. You can import the library as shown in the following code block:

import sparse_operation_kit as sok

Installing SOK via pip

You can install SOK using the following command:

pip install sparse_operation_kit --no-build-isolation

Installing SOK from source

You can also build the SOK module from source code. Here are the steps to follow:

• Download the source code

  $ git clone https://github.com/NVIDIA-Merlin/HugeCTR hugectr
  

• Install to system from python setup install

  $ cd hugectr/
  $ git submodule update --init --recursive
  $ cd sparse_operation_kit/
  $ python setup.py install
  

• Install to system from cmake

  $ cd hugectr/
  $ git submodule update --init --recursive
  $ cd sparse_operation_kit/
  $ mkdir build && cd build
  $ cmake -DSM={your GPU SM version} ../
  $ make -j && make install
  $ cp -r ../sparse_operation_kit {image python dist-packages folder, for example:/usr/local/lib/python3.10/dist-packages/}
  

Pre-requisites

CUDA Version:>= 11.2

TF2 Version:2.6.0~2.14.0

TF1 Version:1.15

Cmake Version:>= 3.20

GCC Version:>=9.3.0

Build requires: scikit-build>=0.13.1, ninja

Documents

Want to find more about SparseOperationKit? Take a look at the SparseOperationKit documentation!