Skip to content

Files

tfjs-backend-webgpu

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Aug 19, 2019
Apr 21, 2020
Oct 12, 2022
Nov 12, 2021
Dec 19, 2024
Aug 15, 2019
Aug 26, 2019
Apr 11, 2023
May 4, 2023
Aug 26, 2023
Mar 2, 2023
Mar 18, 2021
Nov 3, 2022
Apr 7, 2022
Jul 14, 2023

Usage

This package adds a GPU accelerated WebGPU backend to TensorFlow.js. It currently supports the following models:

  • BlazeFace
  • BodyPix
  • Face landmarks detection
  • HandPose
  • MobileNet
  • PoseDetection
  • Universal sentence encoder
  • AutoML Image classification
  • AutoML Object detection
  • Speech commands

Google Chrome started to support WebGPU by default in M113 on May 2, 2023.

Importing the backend

Via NPM

// Import @tensorflow/tfjs or @tensorflow/tfjs-core
import * as tf from '@tensorflow/tfjs';
// Add the WebGPU backend to the global backend registry.
import '@tensorflow/tfjs-backend-webgpu';
// Set the backend to WebGPU and wait for the module to be ready.
tf.setBackend('webgpu').then(() => main());

Via a script tag

<!-- Import @tensorflow/tfjs or @tensorflow/tfjs-core -->
<script src="https://cdn.jsdelivr.net/npm/@tensorflow/tfjs/dist/tf.min.js"> </script>

<!-- Add the WebGPU backend to the global backend registry -->
<script src="https://cdn.jsdelivr.net/npm/@tensorflow/tfjs-backend-webgpu/dist/tf-backend-webgpu.js"></script>
<script>
// Set the backend to WebGPU and wait for the module to be ready
tf.setBackend('webgpu').then(() => main());
</script>

FAQ

When should I use the WebGPU backend?

The mission of WebGPU backend is to achieve the best performance among all approaches. However, this target can not be met overnight, but we are committed to supporting it with rapid and continuous performance improvement. Many exciting features, like FP16, DP4A, will be brought in soon.

How many ops have you implemented?

See register_all_kernels.ts for an up-to-date list of supported ops. We love contributions. See the contributing document for more info.

Do you support training?

Maybe. There are still a decent number of ops that we are missing in WebGPU that are needed for gradient computation. At this point we are focused on making inference as fast as possible.

Do you work in node?

Yes. If you run into issues, please let us know.

How do I give feedback?

We'd love your feedback as we develop this backend! Please file an issue here.

Development

Building

yarn build

Testing

Currently the Canary channel of Chrome is used for testing of the WebGPU backend:

yarn test  # --test_env=CHROME_CANARY_BIN=/path/to/chrome