• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<div align="center">
2  <img src="https://www.tensorflow.org/images/tf_logo_social.png">
3</div>
4
5[![Python](https://img.shields.io/pypi/pyversions/tensorflow.svg?style=plastic)](https://badge.fury.io/py/tensorflow)
6[![PyPI](https://badge.fury.io/py/tensorflow.svg)](https://badge.fury.io/py/tensorflow)
7[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4724125.svg)](https://doi.org/10.5281/zenodo.4724125)
8
9**`Documentation`** |
10------------------- |
11[![Documentation](https://img.shields.io/badge/api-reference-blue.svg)](https://www.tensorflow.org/api_docs/) |
12
13[TensorFlow](https://www.tensorflow.org/) is an end-to-end open source platform
14for machine learning. It has a comprehensive, flexible ecosystem of
15[tools](https://www.tensorflow.org/resources/tools),
16[libraries](https://www.tensorflow.org/resources/libraries-extensions), and
17[community](https://www.tensorflow.org/community) resources that lets
18researchers push the state-of-the-art in ML and developers easily build and
19deploy ML-powered applications.
20
21TensorFlow was originally developed by researchers and engineers working on the
22Google Brain team within Google's Machine Intelligence Research organization to
23conduct machine learning and deep neural networks research. The system is
24general enough to be applicable in a wide variety of other domains, as well.
25
26TensorFlow provides stable [Python](https://www.tensorflow.org/api_docs/python)
27and [C++](https://www.tensorflow.org/api_docs/cc) APIs, as well as
28non-guaranteed backward compatible API for
29[other languages](https://www.tensorflow.org/api_docs).
30
31Keep up-to-date with release announcements and security updates by subscribing
32to
33[announce@tensorflow.org](https://groups.google.com/a/tensorflow.org/forum/#!forum/announce).
34See all the [mailing lists](https://www.tensorflow.org/community/forums).
35
36## Install
37
38See the [TensorFlow install guide](https://www.tensorflow.org/install) for the
39[pip package](https://www.tensorflow.org/install/pip), to
40[enable GPU support](https://www.tensorflow.org/install/gpu), use a
41[Docker container](https://www.tensorflow.org/install/docker), and
42[build from source](https://www.tensorflow.org/install/source).
43
44To install the current release, which includes support for
45[CUDA-enabled GPU cards](https://www.tensorflow.org/install/gpu) *(Ubuntu and
46Windows)*:
47
48```
49$ pip install tensorflow
50```
51
52A smaller CPU-only package is also available:
53
54```
55$ pip install tensorflow-cpu
56```
57
58To update TensorFlow to the latest version, add `--upgrade` flag to the above
59commands.
60
61*Nightly binaries are available for testing using the
62[tf-nightly](https://pypi.python.org/pypi/tf-nightly) and
63[tf-nightly-cpu](https://pypi.python.org/pypi/tf-nightly-cpu) packages on PyPi.*
64
65#### *Try your first TensorFlow program*
66
67```shell
68$ python
69```
70
71```python
72>>> import tensorflow as tf
73>>> tf.add(1, 2).numpy()
743
75>>> hello = tf.constant('Hello, TensorFlow!')
76>>> hello.numpy()
77b'Hello, TensorFlow!'
78```
79
80For more examples, see the
81[TensorFlow tutorials](https://www.tensorflow.org/tutorials/).
82
83## Contribution guidelines
84
85**If you want to contribute to TensorFlow, be sure to review the
86[contribution guidelines](CONTRIBUTING.md). This project adheres to TensorFlow's
87[code of conduct](CODE_OF_CONDUCT.md). By participating, you are expected to
88uphold this code.**
89
90**We use [GitHub issues](https://github.com/tensorflow/tensorflow/issues) for
91tracking requests and bugs, please see
92[TensorFlow Discuss](https://groups.google.com/a/tensorflow.org/forum/#!forum/discuss)
93for general questions and discussion, and please direct specific questions to
94[Stack Overflow](https://stackoverflow.com/questions/tagged/tensorflow).**
95
96The TensorFlow project strives to abide by generally accepted best practices in
97open-source software development:
98
99[![Fuzzing Status](https://oss-fuzz-build-logs.storage.googleapis.com/badges/tensorflow.svg)](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:tensorflow)
100[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/1486/badge)](https://bestpractices.coreinfrastructure.org/projects/1486)
101[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
102
103## Continuous build status
104
105You can find more community-supported platforms and configurations in the
106[TensorFlow SIG Build community builds table](https://github.com/tensorflow/build#community-supported-tensorflow-builds).
107
108### Official Builds
109
110Build Type                    | Status                                                                                                                                                                           | Artifacts
111----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------
112**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/)
113**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/)
114**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
115**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/)
116**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/)
117**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/)
118**Android**                   | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/android.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/android.html)               | [Download](https://bintray.com/google/tensorflow/tensorflow/_latestVersion)
119**Raspberry Pi 0 and 1**      | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi01-py3.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi01-py3.html)           | [Py3](https://storage.googleapis.com/tensorflow-nightly/tensorflow-1.10.0-cp34-none-linux_armv6l.whl)
120**Raspberry Pi 2 and 3**      | [![Status](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi23-py3.svg)](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi23-py3.html)           | [Py3](https://storage.googleapis.com/tensorflow-nightly/tensorflow-1.10.0-cp34-none-linux_armv7l.whl)
121**Libtensorflow MacOS CPU**   | Status Temporarily Unavailable                                                                                                                                                   | [Nightly Binary](https://storage.googleapis.com/libtensorflow-nightly/prod/tensorflow/release/macos/latest/macos_cpu_libtensorflow_binaries.tar.gz) [Official GCS](https://storage.googleapis.com/tensorflow/)
122**Libtensorflow Linux CPU**   | Status Temporarily Unavailable                                                                                                                                                   | [Nightly Binary](https://storage.googleapis.com/libtensorflow-nightly/prod/tensorflow/release/ubuntu_16/latest/cpu/ubuntu_cpu_libtensorflow_binaries.tar.gz) [Official GCS](https://storage.googleapis.com/tensorflow/)
123**Libtensorflow Linux GPU**   | Status Temporarily Unavailable                                                                                                                                                   | [Nightly Binary](https://storage.googleapis.com/libtensorflow-nightly/prod/tensorflow/release/ubuntu_16/latest/gpu/ubuntu_gpu_libtensorflow_binaries.tar.gz) [Official GCS](https://storage.googleapis.com/tensorflow/)
124**Libtensorflow Windows CPU** | Status Temporarily Unavailable                                                                                                                                                   | [Nightly Binary](https://storage.googleapis.com/libtensorflow-nightly/prod/tensorflow/release/windows/latest/cpu/windows_cpu_libtensorflow_binaries.tar.gz) [Official GCS](https://storage.googleapis.com/tensorflow/)
125**Libtensorflow Windows GPU** | Status Temporarily Unavailable                                                                                                                                                   | [Nightly Binary](https://storage.googleapis.com/libtensorflow-nightly/prod/tensorflow/release/windows/latest/gpu/windows_gpu_libtensorflow_binaries.tar.gz) [Official GCS](https://storage.googleapis.com/tensorflow/)
126
127## Resources
128
129*   [TensorFlow.org](https://www.tensorflow.org)
130*   [TensorFlow Tutorials](https://www.tensorflow.org/tutorials/)
131*   [TensorFlow Official Models](https://github.com/tensorflow/models/tree/master/official)
132*   [TensorFlow Examples](https://github.com/tensorflow/examples)
133*   [DeepLearning.AI TensorFlow Developer Professional Certificate](https://www.coursera.org/specializations/tensorflow-in-practice)
134*   [TensorFlow: Data and Deployment from Coursera](https://www.coursera.org/specializations/tensorflow-data-and-deployment)
135*   [Getting Started with TensorFlow 2 from Coursera](https://www.coursera.org/learn/getting-started-with-tensor-flow2)
136*   [TensorFlow: Advanced Techniques from Coursera](https://www.coursera.org/specializations/tensorflow-advanced-techniques)
137*   [Intro to TensorFlow for A.I, M.L, and D.L from Coursera](https://www.coursera.org/learn/introduction-tensorflow)
138*   [Intro to TensorFlow for Deep Learning from Udacity](https://www.udacity.com/course/intro-to-tensorflow-for-deep-learning--ud187)
139*   [Introduction to TensorFlow Lite from Udacity](https://www.udacity.com/course/intro-to-tensorflow-lite--ud190)
140*   [Machine Learning with TensorFlow on GCP](https://www.coursera.org/specializations/machine-learning-tensorflow-gcp)
141*   [TensorFlow Codelabs](https://codelabs.developers.google.com/?cat=TensorFlow)
142*   [TensorFlow Blog](https://blog.tensorflow.org)
143*   [Learn ML with TensorFlow](https://www.tensorflow.org/resources/learn-ml)
144*   [TensorFlow Twitter](https://twitter.com/tensorflow)
145*   [TensorFlow YouTube](https://www.youtube.com/channel/UC0rqucBdTuFTjJiefW5t-IQ)
146*   [TensorFlow model optimization roadmap](https://www.tensorflow.org/model_optimization/guide/roadmap)
147*   [TensorFlow White Papers](https://www.tensorflow.org/about/bib)
148*   [TensorBoard Visualization Toolkit](https://github.com/tensorflow/tensorboard)
149
150Learn more about the
151[TensorFlow community](https://www.tensorflow.org/community) and how to
152[contribute](https://www.tensorflow.org/community/contribute).
153
154## License
155
156[Apache License 2.0](LICENSE)
157