Skip to contents

luz is a higher level API for torch providing abstractions to allow for much less verbose training loops.

This package is in very early stage of development. Don’t use for anything meaningful yet.

It’s heavily inspired in other higher level frameworks for deep learning, to cite a few:

  • FastAI: we are heavily inspired in the FastAI library, specially the Learner object and the callbacks API.

  • Keras: We are also heavily inspired by Keras, specially callback names, the lightning module interface is similar to compile too.

  • PyTorch Lightning: The idea of the luz_module being a subclass of nn_module is inspired in the LightningModule object in lightning.

  • HuggingFace Accelerate: The internal device placement API is heavily inspired in Accelerate, but much more modest in features. Currenly only CPU and Single GPU are supported.


You can install the released version from CRAN with:

or the development version with:



Luz let’s you take your Torch nn_module definition and fit it to a dataloader, while handling the boring parts like moving data between devices, updating the weights, showing progress bars and tracking metrics.

Here’s an example defining and training an Autoencoder for the MNIST dataset. We selected parts of the code to highlight Luz functionality. You can find the full example code here.

net <- nn_module(
  initialize = function() {
    self$encoder <- nn_sequential(
      nn_conv2d(1, 6, kernel_size=5),
      nn_conv2d(6, 16, kernel_size=5),
    self$decoder <- nn_sequential(
      nn_conv_transpose2d(16, 6, kernel_size = 5),
      nn_conv_transpose2d(6, 1, kernel_size = 5),
  forward = function(x) {
    x %>%
      self$encoder() %>%

Now that we have defined the Autoencder architecture using torch::nn_module(), we can fit it using Luz:

fitted <- net %>%
    loss = nn_mse_loss(),
    optimizer = optim_adam
  ) %>%
  fit(train_dl, epochs = 1, valid_data = test_dl)



Dev status

  • R-CMD-check
  • Codecov test coverage
  • Discord
  • CRAN status