148 lines
12 KiB
Markdown
148 lines
12 KiB
Markdown
<div align="center">
|
|
<img src="https://www.tensorflow.org/images/tf_logo_social.png">
|
|
</div>
|
|
|
|
| **`Documentation`** |
|
|
|-----------------|
|
|
| [](https://www.tensorflow.org/api_docs/) |
|
|
|
|
[TensorFlow](https://www.tensorflow.org/) is an end-to-end open source platform
|
|
for machine learning. It has a comprehensive, flexible ecosystem of
|
|
[tools](https://www.tensorflow.org/resources/tools),
|
|
[libraries](https://www.tensorflow.org/resources/libraries-extensions), and
|
|
[community](https://www.tensorflow.org/community) resources that lets
|
|
researchers push the state-of-the-art in ML and developers easily build and
|
|
deploy ML powered applications.
|
|
|
|
TensorFlow was originally developed by researchers and engineers working on the
|
|
Google Brain team within Google's Machine Intelligence Research organization for
|
|
the purposes of conducting machine learning and deep neural networks research.
|
|
The system is general enough to be applicable in a wide variety of other
|
|
domains, as well.
|
|
|
|
TensorFlow provides stable [Python](https://www.tensorflow.org/api_docs/python)
|
|
and [C++](https://www.tensorflow.org/api_docs/cc) APIs, as well as
|
|
non-guaranteed backwards compatible API for
|
|
[other languages](https://www.tensorflow.org/api_docs).
|
|
|
|
Keep up-to-date with release announcements and security updates by subscribing
|
|
to
|
|
[announce@tensorflow.org](https://groups.google.com/a/tensorflow.org/forum/#!forum/announce).
|
|
See all the [mailing lists](https://www.tensorflow.org/community/forums).
|
|
|
|
## Install
|
|
|
|
See the [TensorFlow install guide](https://www.tensorflow.org/install) for the
|
|
[pip package](https://www.tensorflow.org/install/pip), to
|
|
[enable GPU support](https://www.tensorflow.org/install/gpu), use a
|
|
[Docker container](https://www.tensorflow.org/install/docker), and
|
|
[build from source](https://www.tensorflow.org/install/source).
|
|
|
|
To install the current release:
|
|
|
|
```
|
|
$ pip install tensorflow
|
|
```
|
|
The `tensorflow` package also includes GPU support on Linux and Windows.
|
|
|
|
If package size is a concern, CPU-only packages can be installed with:
|
|
```
|
|
$ pip install tensorflow-cpu
|
|
```
|
|
|
|
*Nightly binaries are available for testing using the
|
|
[tf-nightly](https://pypi.python.org/pypi/tf-nightly) and
|
|
[tf-nightly-gpu](https://pypi.python.org/pypi/tf-nightly-gpu) packages on PyPi.*
|
|
|
|
#### *Try your first TensorFlow program*
|
|
|
|
```shell
|
|
$ python
|
|
```
|
|
|
|
```python
|
|
>>> import tensorflow as tf
|
|
>>> tf.enable_eager_execution()
|
|
>>> tf.add(1, 2).numpy()
|
|
3
|
|
>>> hello = tf.constant('Hello, TensorFlow!')
|
|
>>> hello.numpy()
|
|
'Hello, TensorFlow!'
|
|
```
|
|
|
|
For more examples, see the
|
|
[TensorFlow tutorials](https://www.tensorflow.org/tutorials/).
|
|
|
|
## Contribution guidelines
|
|
|
|
**If you want to contribute to TensorFlow, be sure to review the [contribution
|
|
guidelines](CONTRIBUTING.md). This project adheres to TensorFlow's
|
|
[code of conduct](CODE_OF_CONDUCT.md). By participating, you are expected to
|
|
uphold this code.**
|
|
|
|
**We use [GitHub issues](https://github.com/tensorflow/tensorflow/issues) for
|
|
tracking requests and bugs, please see
|
|
[TensorFlow Discuss](https://groups.google.com/a/tensorflow.org/forum/#!forum/discuss)
|
|
for general questions and discussion, and please direct specific questions to
|
|
[Stack Overflow](https://stackoverflow.com/questions/tagged/tensorflow).**
|
|
|
|
The TensorFlow project strives to abide by generally accepted best practices in open-source software development:
|
|
|
|
[](https://bestpractices.coreinfrastructure.org/projects/1486)
|
|
[](CODE_OF_CONDUCT.md)
|
|
|
|
## Continuous build status
|
|
|
|
### Official Builds
|
|
|
|
| Build Type | Status | Artifacts |
|
|
| --- | --- | --- |
|
|
| **Linux CPU** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-cc.html) | [pypi](https://pypi.org/project/tf-nightly/) |
|
|
| **Linux GPU** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-gpu-py3.html) | [pypi](https://pypi.org/project/tf-nightly-gpu/) |
|
|
| **Linux XLA** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/ubuntu-xla.html) | TBA |
|
|
| **MacOS** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/macos-py2-cc.html) | [pypi](https://pypi.org/project/tf-nightly/) |
|
|
| **Windows CPU** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/windows-cpu.html) | [pypi](https://pypi.org/project/tf-nightly/) |
|
|
| **Windows GPU** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/windows-gpu.html) | [pypi](https://pypi.org/project/tf-nightly-gpu/) |
|
|
| **Android** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/android.html) | [](https://bintray.com/google/tensorflow/tensorflow/_latestVersion) |
|
|
| **Raspberry Pi 0 and 1** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi01-py2.html) [](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) |
|
|
| **Raspberry Pi 2 and 3** | [](https://storage.googleapis.com/tensorflow-kokoro-build-badges/rpi23-py2.html) [](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) |
|
|
|
|
|
|
### Community Supported Builds
|
|
|
|
Build Type | Status | Artifacts
|
|
--------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------
|
|
**Linux AMD ROCm GPU** Nightly | [](http://ml-ci.amd.com:21096/job/tensorflow-rocm-nightly) | [Nightly](http://ml-ci.amd.com:21096/job/tensorflow-rocm-nightly/lastSuccessfulBuild/)
|
|
**Linux AMD ROCm GPU** Stable Release | [](http://ml-ci.amd.com:21096/job/tensorflow-rocm-release/) | [Release](http://ml-ci.amd.com:21096/job/tensorflow-rocm-release/lastSuccessfulBuild/)
|
|
**Linux s390x** Nightly | [](http://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_CI/) | [Nightly](http://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_CI/)
|
|
**Linux s390x CPU** Stable Release | [](https://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_Release_Build/) | [Release](https://ibmz-ci.osuosl.org/job/TensorFlow_IBMZ_Release_Build/)
|
|
**Linux ppc64le CPU** Nightly | [](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Build/) | [Nightly](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Nightly_Artifact/)
|
|
**Linux ppc64le CPU** Stable Release | [](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Release_Build/) | [Release](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_CPU_Release_Build/)
|
|
**Linux ppc64le GPU** Nightly | [](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Build/) | [Nightly](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Nightly_Artifact/)
|
|
**Linux ppc64le GPU** Stable Release | [](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Release_Build/) | [Release](https://powerci.osuosl.org/job/TensorFlow_PPC64LE_GPU_Release_Build/)
|
|
**Linux CPU with Intel® MKL-DNN** Nightly | [](https://tensorflow-ci.intel.com/job/tensorflow-mkl-linux-cpu/) | [Nightly](https://tensorflow-ci.intel.com/job/tensorflow-mkl-build-whl-nightly/)
|
|
**Linux CPU with Intel® MKL-DNN** <br> **Supports Python 2.7, 3.4, 3.5, and 3.6** | [](https://tensorflow-ci.intel.com/job/tensorflow-mkl-build-release-whl/lastStableBuild) | [1.13.1 pypi](https://pypi.org/project/intel-tensorflow/)
|
|
**Red Hat® Enterprise Linux® 7.6 CPU & GPU** <br> Python 2.7, 3.6 | [](https://jenkins-tensorflow.apps.ci.centos.org/job/tensorflow-rhel7-3.6/2/) | [1.13.1 pypi](https://tensorflow.pypi.thoth-station.ninja/index/)
|
|
|
|
## Resources
|
|
|
|
* [TensorFlow.org](https://www.tensorflow.org)
|
|
* [TensorFlow tutorials](https://www.tensorflow.org/tutorials/)
|
|
* [TensorFlow official models](https://github.com/tensorflow/models/tree/master/official)
|
|
* [TensorFlow examples](https://github.com/tensorflow/examples)
|
|
* [TensorFlow in Practice from Coursera](https://www.coursera.org/specializations/tensorflow-in-practice)
|
|
* [TensorFlow blog](https://blog.tensorflow.org)
|
|
* [TensorFlow Twitter](https://twitter.com/tensorflow)
|
|
* [TensorFlow YouTube](https://www.youtube.com/channel/UC0rqucBdTuFTjJiefW5t-IQ)
|
|
* [TensorFlow roadmap](https://www.tensorflow.org/community/roadmap)
|
|
* [TensorFlow white papers](https://www.tensorflow.org/about/bib)
|
|
* [TensorBoard visualization toolkit](https://github.com/tensorflow/tensorboard)
|
|
|
|
Learn more about the
|
|
[TensorFlow community](https://www.tensorflow.org/community) and how to
|
|
[contribute](https://www.tensorflow.org/community/contribute).
|
|
|
|
## License
|
|
|
|
[Apache License 2.0](LICENSE)
|