github.com/johnnyeven/libtools@v0.0.0-20191126065708-61829c1adf46/README.md (about)

     1  <div align="center">
     2    <img src="https://www.tensorflow.org/images/tf_logo_social.png">
     3  </div>
     4  
     5  | **`Documentation`** |
     6  |-----------------|
     7  | [![Documentation](https://img.shields.io/badge/api-reference-blue.svg)](https://www.tensorflow.org/api_docs/) |
     8  
     9  [TensorFlow](https://www.tensorflow.org/) is an end-to-end open source platform
    10  for machine learning. It has a comprehensive, flexible ecosystem of
    11  [tools](https://www.tensorflow.org/resources/tools),
    12  [libraries](https://www.tensorflow.org/resources/libraries-extensions), and
    13  [community](https://www.tensorflow.org/community) resources that lets
    14  researchers push the state-of-the-art in ML and developers easily build and
    15  deploy ML powered applications.
    16  
    17  TensorFlow was originally developed by researchers and engineers working on the
    18  Google Brain team within Google's Machine Intelligence Research organization for
    19  the purposes of conducting machine learning and deep neural networks research.
    20  The system is general enough to be applicable in a wide variety of other
    21  domains, as well.
    22  
    23  TensorFlow provides stable [Python](https://www.tensorflow.org/api_docs/python)
    24  and [C++](https://www.tensorflow.org/api_docs/cc) APIs, as well as
    25  non-guaranteed backwards compatible API for
    26  [other languages](https://www.tensorflow.org/api_docs).
    27  
    28  Keep up-to-date with release announcements and security updates by subscribing
    29  to
    30  [announce@tensorflow.org](https://groups.google.com/a/tensorflow.org/forum/#!forum/announce).
    31  See all the [mailing lists](https://www.tensorflow.org/community/forums).
    32  
    33  ## Install
    34  
    35  See the [TensorFlow install guide](https://www.tensorflow.org/install) for the
    36  [pip package](https://www.tensorflow.org/install/pip), to
    37  [enable GPU support](https://www.tensorflow.org/install/gpu), use a
    38  [Docker container](https://www.tensorflow.org/install/docker), and
    39  [build from source](https://www.tensorflow.org/install/source).
    40  
    41  To install the current release for CPU-only:
    42  
    43  ```
    44  $ pip install tensorflow
    45  ```
    46  
    47  Use the GPU package for
    48  [CUDA-enabled GPU cards](https://www.tensorflow.org/install/gpu):
    49  
    50  ```
    51  $ pip install tensorflow-gpu
    52  ```
    53  
    54  *Nightly binaries are available for testing using the
    55  [tf-nightly](https://pypi.python.org/pypi/tf-nightly) and
    56  [tf-nightly-gpu](https://pypi.python.org/pypi/tf-nightly-gpu) packages on PyPi.*
    57  
    58  #### *Try your first TensorFlow program*
    59  
    60  ```shell
    61  $ python
    62  ```
    63  
    64  ```python
    65  >>> import tensorflow as tf
    66  >>> tf.enable_eager_execution()
    67  >>> tf.add(1, 2).numpy()
    68  3
    69  >>> hello = tf.constant('Hello, TensorFlow!')
    70  >>> hello.numpy()
    71  'Hello, TensorFlow!'
    72  ```
    73  
    74  For more examples, see the
    75  [TensorFlow tutorials](https://www.tensorflow.org/tutorials/).
    76  
    77  ## Contribution guidelines
    78  
    79  **If you want to contribute to TensorFlow, be sure to review the [contribution
    80  guidelines](CONTRIBUTING.md). This project adheres to TensorFlow's
    81  [code of conduct](CODE_OF_CONDUCT.md). By participating, you are expected to
    82  uphold this code.**
    83  
    84  **We use [GitHub issues](https://github.com/tensorflow/tensorflow/issues) for
    85  tracking requests and bugs, please see
    86  [TensorFlow Discuss](https://groups.google.com/a/tensorflow.org/forum/#!forum/discuss)
    87  for general questions and discussion, and please direct specific questions to
    88  [Stack Overflow](https://stackoverflow.com/questions/tagged/tensorflow).**
    89  
    90  The TensorFlow project strives to abide by generally accepted best practices in open-source software development:
    91  
    92  [![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/1486/badge)](https://bestpractices.coreinfrastructure.org/projects/1486)
    93  [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
    94  
    95  ## Continuous build status
    96  
    97  ### Official Builds
    98  
    99  | Build Type      | Status | Artifacts |
   100  | ---             | ---    | ---       |
   101  | **Linux CPU**   | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-cc.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-cc.html) | [pypi](https://pypi.org/project/tf-nightly/) |
   102  | **Linux GPU**   | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-gpu-py3.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-gpu-py3.html) | [pypi](https://pypi.org/project/tf-nightly-gpu/) |
   103  | **Linux XLA**   | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-xla.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-xla.html) | TBA |
   104  | **MacOS**       | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/macos-py2-cc.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/macos-py2-cc.html) | [pypi](https://pypi.org/project/tf-nightly/) |
   105  | **Windows CPU** | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/windows-cpu.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/windows-cpu.html) | [pypi](https://pypi.org/project/tf-nightly/) |
   106  | **Windows GPU** | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/windows-gpu.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/windows-gpu.html) | [pypi](https://pypi.org/project/tf-nightly-gpu/) |
   107  | **Android**     | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/android.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/android.html) | [![Download](https://api.bintray.com/packages/google/tensorflow/tensorflow/images/download.svg)](https://bintray.com/google/tensorflow/tensorflow/_latestVersion) |
   108  | **Raspberry Pi 0 and 1** | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi01-py2.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi01-py2.html) [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi01-py3.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi01-py3.html) | [Py2](https://storage.googleapis.com/tensorflow-nightly/tensorflow-1.10.0-cp27-none-linux_armv6l.whl) [Py3](https://storage.googleapis.com/tensorflow-nightly/tensorflow-1.10.0-cp34-none-linux_armv6l.whl) |
   109  | **Raspberry Pi 2 and 3** | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi23-py2.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi23-py2.html) [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi23-py3.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi23-py3.html) | [Py2](https://storage.googleapis.com/tensorflow-nightly/tensorflow-1.10.0-cp27-none-linux_armv7l.whl) [Py3](https://storage.googleapis.com/tensorflow-nightly/tensorflow-1.10.0-cp34-none-linux_armv7l.whl) |
   110  
   111  
   112  ### Community Supported Builds
   113  
   114  Build Type                                                                        | Status                                                                                                                                                                                        | Artifacts
   115  --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------
   116  **Linux AMD ROCm GPU** Nightly                                                    | [![Build Status](http://ml-ci.amd.com:21096/job/tensorflow-rocm-nightly/badge/icon)](http://ml-ci.amd.com:21096/job/tensorflow-rocm-nightly)                                                  | [Nightly](http://ml-ci.amd.com:21096/job/tensorflow-rocm-nightly/lastSuccessfulBuild/)
   117  **Linux AMD ROCm GPU** Stable Release                                             | [![Build Status](http://ml-ci.amd.com:21096/job/tensorflow-rocm-release/badge/icon)](http://ml-ci.amd.com:21096/job/tensorflow-rocm-release/)                                                 | [Release](http://ml-ci.amd.com:21096/job/tensorflow-rocm-release/lastSuccessfulBuild/)
   118  **Linux s390x** Nightly                                                           | [![Build Status](http://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_CI/badge/icon)](http://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_CI/)                                                             | [Nightly](http://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_CI/)
   119  **Linux s390x CPU** Stable Release                                                | [![Build Status](http://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_Release_Build/badge/icon)](https://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_Release_Build/)                                      | [Release](https://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_Release_Build/)
   120  **Linux ppc64le CPU** Nightly                                                     | [![Build Status](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Build/badge/icon)](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Build/)                                       | [Nightly](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Nightly_Artifact/)
   121  **Linux ppc64le CPU** Stable Release                                              | [![Build Status](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Release_Build/badge/icon)](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Release_Build/)                       | [Release](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Release_Build/)
   122  **Linux ppc64le GPU** Nightly                                                     | [![Build Status](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Build/badge/icon)](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Build/)                                       | [Nightly](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Nightly_Artifact/)
   123  **Linux ppc64le GPU** Stable Release                                              | [![Build Status](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Release_Build/badge/icon)](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Release_Build/)                       | [Release](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Release_Build/)
   124  **Linux CPU with Intel® MKL-DNN** Nightly                                         | [![Build Status](https://tensorflow-ci.intel.com/job/tensorflow-mkl-linux-cpu/badge/icon)](https://tensorflow-ci.intel.com/job/tensorflow-mkl-linux-cpu/)                                     | [Nightly](https://tensorflow-ci.intel.com/job/tensorflow-mkl-build-whl-nightly/)
   125  **Linux CPU with Intel® MKL-DNN** <br> **Supports Python 2.7, 3.4, 3.5, and 3.6** | [![Build Status](https://tensorflow-ci.intel.com/job/tensorflow-mkl-build-release-whl/badge/icon)](https://tensorflow-ci.intel.com/job/tensorflow-mkl-build-release-whl/lastStableBuild)      | [1.13.1 pypi](https://pypi.org/project/intel-tensorflow/)
   126  **Red Hat® Enterprise Linux® 7.6 CPU & GPU** <br> Python 2.7, 3.6                 | [![Build Status](https://jenkins-tensorflow.apps.ci.centos.org/buildStatus/icon?job=tensorflow-rhel7-3.6&build=2)](https://jenkins-tensorflow.apps.ci.centos.org/job/tensorflow-rhel7-3.6/2/) | [1.13.1 pypi](https://tensorflow.pypi.thoth-station.ninja/index/)
   127  
   128  ## Resources
   129  
   130  *   [TensorFlow.org](https://www.tensorflow.org)
   131  *   [TensorFlow tutorials](https://www.tensorflow.org/tutorials/)
   132  *   [TensorFlow official models](https://github.com/tensorflow/models/tree/master/official)
   133  *   [TensorFlow examples](https://github.com/tensorflow/examples)
   134  *   [TensorFlow in Practice from Coursera](https://www.coursera.org/specializations/tensorflow-in-practice)
   135  *   [TensorFlow blog](https://blog.tensorflow.org)
   136  *   [TensorFlow Twitter](https://twitter.com/tensorflow)
   137  *   [TensorFlow YouTube](https://www.youtube.com/channel/UC0rqucBdTuFTjJiefW5t-IQ)
   138  *   [TensorFlow roadmap](https://www.tensorflow.org/community/roadmap)
   139  *   [TensorFlow white papers](https://www.tensorflow.org/about/bib)
   140  *   [TensorBoard visualization toolkit](https://github.com/tensorflow/tensorboard)
   141  
   142  Learn more about the
   143  [TensorFlow community](https://www.tensorflow.org/community) and how to
   144  [contribute](https://www.tensorflow.org/community/contribute).
   145  
   146  ## License
   147  
   148  [Apache License 2.0](LICENSE)