Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Open In Colab

Made by Byron Knoll. GitHub repository:


tensorflow-compress performs lossless data compression using neural networks in TensorFlow. It can run on GPUs with a large batch size to get a substantial speed improvement. It is made using Colab, which should make it easy to run through a web browser. You can choose a file, perform compression (or decompression), and download the result.

tensorflow-compress is open source and the code should hopefully be easy to understand and modify. Feel free to experiment with the code and create pull requests with improvements.

The neural network is trained from scratch during compression and decompression, so the model weights do not need to be stored. Arithmetic coding is used to encode the model predictions to a file.

Feel free to contact me at if you have any questions.


Basic usage: configure all the fields in the "Parameters" section and select Runtime->Run All.

Advanced usage: save a copy of this notebook and modify the code.

Related Projects

  • NNCP - this uses a similar LSTM architecture to tensorflow-compress. It is limited to running only on CPUs.
  • lstm-compress - similar to NNCP, but has a batch size limit of one (so it is significantly slower).
  • cmix - shares the same LSTM code as lstm-compress, but contains a bunch of other components to get better compression rate.
  • DeepZip - this also performs compression using TensorFlow. However, it has some substantial architecture differences to tensorflow-compress: it uses pretraining (using multiple passes over the training data) and stores the model weights in the compressed file.


These benchmarks were performed using tensorflow-compress v3 with the default parameter settings. Some parameters differ between enwik8 and enwik9 as noted in the parameter comments. Colab Pro was used with Tesla V100 GPU. Compression time and decompression time are approximately the same.

  • enwik8: compressed to 16,128,954 bytes in 32,113.38 seconds. NNCP preprocessing time: 206.38 seconds. Dictionary size: 65,987 bytes.
  • enwik9: compressed to 118,938,744 bytes in 297,505.98 seconds. NNCP preprocessing time: 2,598.77 seconds. Dictionary size: 79,876 bytes. Since Colab has a 24 hour time limit, the preprocessed enwik9 file was split into four parts using this notebook. The "checkpoint" option was used to save/load model weights between processing each part. For the first part, start_learning_rate=0.0007 and end_learning_rate=0.0005 was used. For the remaining three parts, a constant 0.00035 learning rate was used.

See the Large Text Compression Benchmark for more information about the test files and a comparison with other programs.


  • v3 - released November 28, 2020. Changes from v2:
    • Parameter tuning
    • New notebook for file splitting
    • Support for learning rate decay
  • v2 - released September 6, 2020. Changes from v1:
    • 16 bit floats for improved speed
    • Weight updates occur at every timestep (instead of at spaced intervals)
    • Support for saving/loading model weights
  • v1 - released July 20, 2020.


Data compression using LSTM in TensorFlow




No packages published