Skip to main content

High Level Tensorflow Deep Learning Library for Researcher and Engineer.

Project description

TENSORLAYER-LOGO

Awesome Documentation-EN Documentation-CN Book-CN Downloads

PyPI PyPI-Prerelease Commits-Since Python TensorFlow

Travis Docker RTD-EN RTD-CN PyUP Docker-Pulls Code-Quality

JOIN-SLACK-LOGO

TensorLayer is a novel TensorFlow-based deep learning and reinforcement learning library designed for researchers and engineers. It provides a large collection of customizable neural layers / functions that are key to build real-world AI applications. TensorLayer is awarded the 2017 Best Open Source Software by the ACM Multimedia Society.

Why another deep learning library: TensorLayer

As deep learning practitioners, we have been looking for a library that can address various development purposes. This library is easy to adopt by providing diverse examples, tutorials and pre-trained models. Also, it allow users to easily fine-tune TensorFlow; while being suitable for production deployment. TensorLayer aims to satisfy all these purposes. It has three key features:

  • Simplicity : TensorLayer lifts the low-level dataflow interface of TensorFlow to high-level layers / models. It is very easy to learn through the rich example codes contributed by a wide community.

  • Flexibility : TensorLayer APIs are transparent: it does not mask TensorFlow from users; but leaving massive hooks that help low-level tuning and deep customization.

  • Zero-cost Abstraction : TensorLayer can achieve the full power of TensorFlow. The following table shows the training speeds of classic models using TensorLayer and native TensorFlow on a Titan X Pascal GPU.

    CIFAR-10

    PTB LSTM

    Word2Vec

    TensorLayer

    2528 images/s

    18063 words/s

    58167 words/s

    TensorFlow

    2530 images/s

    18075 words/s

    58181 words/s

TensorLayer stands at a unique spot in the library landscape. Other wrapper libraries like Keras and TFLearn also provide high-level abstractions. They, however, often hide the underlying engine from users, which make them hard to customize and fine-tune. On the contrary, TensorLayer APIs are generally flexible and transparent. Users often find it easy to start with the examples and tutorials, and then dive into TensorFlow seamlessly. In addition, TensorLayer does not create library lock-in through native supports for importing components from Keras, TFSlim and TFLearn.

TensorLayer has a fast growing usage among top researchers and engineers, from universities like Imperial College London, UC Berkeley, Carnegie Mellon University, Stanford University, and University of Technology of Compiegne (UTC), and companies like Google, Microsoft, Alibaba, Tencent, Xiaomi, and Bloomberg.

Install

TensorLayer has pre-requisites including TensorFlow, numpy, and others. For GPU support, CUDA and cuDNN are required. The simplest way to install TensorLayer is to use the Python Package Index (PyPI):

# for last stable version
pip install --upgrade tensorlayer

# for latest release candidate
pip install --upgrade --pre tensorlayer

# if you want to install the additional dependencies, you can also run
pip install --upgrade tensorlayer[all]              # all additional dependencies
pip install --upgrade tensorlayer[extra]            # only the `extra` dependencies
pip install --upgrade tensorlayer[contrib_loggers]  # only the `contrib_loggers` dependencies

Alternatively, you can install the latest or development version by directly pulling from github:

pip install https://github.com/tensorlayer/tensorlayer/archive/master.zip
# or
# pip install https://github.com/tensorlayer/tensorlayer/archive/<branch-name>.zip

Using Docker - a ready-to-use environment

The TensorLayer containers are built on top of the official TensorFlow containers:

Containers with CPU support

# for CPU version and Python 2
docker pull tensorlayer/tensorlayer:latest
docker run -it --rm -p 8888:8888 -p 6006:6006 -e PASSWORD=JUPYTER_NB_PASSWORD tensorlayer/tensorlayer:latest

# for CPU version and Python 3
docker pull tensorlayer/tensorlayer:latest-py3
docker run -it --rm -p 8888:8888 -p 6006:6006 -e PASSWORD=JUPYTER_NB_PASSWORD tensorlayer/tensorlayer:latest-py3

Containers with GPU support

NVIDIA-Docker is required for these containers to work: Project Link

# for GPU version and Python 2
docker pull tensorlayer/tensorlayer:latest-gpu
nvidia-docker run -it --rm -p 8888:88888 -p 6006:6006 -e PASSWORD=JUPYTER_NB_PASSWORD tensorlayer/tensorlayer:latest-gpu

# for GPU version and Python 3
docker pull tensorlayer/tensorlayer:latest-gpu-py3
nvidia-docker run -it --rm -p 8888:8888 -p 6006:6006 -e PASSWORD=JUPYTER_NB_PASSWORD tensorlayer/tensorlayer:latest-gpu-py3

Contribute

Please read the Contributor Guideline before submitting your PRs.

Cite

If you find this project useful, we would be grateful if you cite the TensorLayer paper:

@article{tensorlayer2017,
    author  = {Dong, Hao and Supratak, Akara and Mai, Luo and Liu, Fangde and Oehmichen, Axel and Yu, Simiao and Guo, Yike},
    journal = {ACM Multimedia},
    title   = {{TensorLayer: A Versatile Library for Efficient Deep Learning Development}},
    url     = {http://tensorlayer.org},
    year    = {2017}
}

License

TensorLayer is released under the Apache 2.0 license.

Project details


Release history Release notifications | RSS feed

This version

2.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tensorlayer-2.0.0.tar.gz (253.4 kB view details)

Uploaded Source

Built Distributions

tensorlayer-2.0.0-py3-none-any.whl (347.0 kB view details)

Uploaded Python 3

tensorlayer-2.0.0-py2.py3-none-any.whl (347.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file tensorlayer-2.0.0.tar.gz.

File metadata

  • Download URL: tensorlayer-2.0.0.tar.gz
  • Upload date:
  • Size: 253.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.6.3

File hashes

Hashes for tensorlayer-2.0.0.tar.gz
Algorithm Hash digest
SHA256 997c36825bd29e251d489f083b9f0cc599987fd67d48dbb8ef498aa25b015499
MD5 baf5ee5fd93e0720debeeca5119faf46
BLAKE2b-256 f75a9baf70ea62cf2c3c5b456eda6e125777e7b6bd4de93de83535d50c6567eb

See more details on using hashes here.

Provenance

File details

Details for the file tensorlayer-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: tensorlayer-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 347.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.6.3

File hashes

Hashes for tensorlayer-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a39ae42ed65e63d043ffb6d58d27edfaffc8ec8534b146c0ce113761f769e09c
MD5 611c61461652f7769fd952e69297af25
BLAKE2b-256 2b3c22cdbad1e86c070dc70fd63fa09365550b1679d8c3f3f003b787e6a59c40

See more details on using hashes here.

Provenance

File details

Details for the file tensorlayer-2.0.0-py2.py3-none-any.whl.

File metadata

  • Download URL: tensorlayer-2.0.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 347.1 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.6.3

File hashes

Hashes for tensorlayer-2.0.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 49e0dfe84c0ef6ba61c24779ed1ba6837e4965c6dd8ecee572d6cbe9dad19c35
MD5 a41c81334fc848486df4bc0981711be5
BLAKE2b-256 49a21131aaad76abf49a9fa0a2e8cb25c98dbf692d1e331201e7f848a85ac1a4

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page