Skip to content
Switch branches/tags
Go to file


Failed to load latest commit information.
Latest commit message
Commit time
Jan 16, 2021
Apr 19, 2021
Apr 24, 2020
Sep 29, 2019
Jul 31, 2020
Mar 26, 2020
Apr 19, 2021
Jan 16, 2021


Tensorpack is a neural network training interface based on TensorFlow v1.

ReadTheDoc Gitter chat model-zoo


It's Yet Another TF high-level API, with the following notable features:

  1. Focus on training speed.
  • Speed comes for free with Tensorpack -- it uses TensorFlow in the efficient way with no extra overhead. On common CNNs, it runs training 1.2~5x faster than the equivalent Keras code. Your training can probably gets faster if written with Tensorpack.

  • Scalable data-parallel multi-GPU / distributed training strategy is off-the-shelf to use. See tensorpack/benchmarks for more benchmarks.

  1. Squeeze the best data loading performance of Python with tensorpack.dataflow.
  • Symbolic programming (e.g. does not offer the data processing flexibility needed in research. Tensorpack squeezes the most performance out of pure Python with various autoparallelization strategies.
  1. Focus on reproducible and flexible research:
  1. It's not a model wrapper.
  • There are too many symbolic function wrappers already. Tensorpack includes only a few common layers. You can use any TF symbolic functions inside Tensorpack, including tf.layers/Keras/slim/tflearn/tensorlayer/....

See tutorials and documentations to know more about these features.


We refuse toy examples. Instead of showing tiny CNNs trained on MNIST/Cifar10, we provide training scripts that reproduce well-known papers.

We refuse low-quality implementations. Unlike most open source repos which only implement papers, Tensorpack examples faithfully reproduce papers, demonstrating its flexibility for actual research.


Reinforcement Learning:

Speech / NLP:



  • Python 3.3+.
  • Python bindings for OpenCV. (Optional, but required by a lot of features)
  • TensorFlow ≥ 1.5, < 2
    • TF is not not required if you only want to use tensorpack.dataflow alone as a data processing library
    • TF2 is supported in some simple models if used in graph mode (and replace tf by tf.compat.v1 when needed)
pip install --upgrade git+
# or add `--user` to install to user's local directories

Please note that tensorpack is not yet stable. If you use tensorpack in your code, remember to mark the exact version of tensorpack you use as your dependencies.

Citing Tensorpack:

If you use Tensorpack in your research or wish to refer to the examples, please cite with:

  author={Wu, Yuxin and others},