157 lines
11 KiB
Markdown
157 lines
11 KiB
Markdown
<div align="center">
|
|
<img src="https://www.tensorflow.org/images/tf_logo_social.png">
|
|
</div>
|
|
|
|
[](https://badge.fury.io/py/tensorflow)
|
|
[](https://badge.fury.io/py/tensorflow)
|
|
[](https://doi.org/10.5281/zenodo.4724125)
|
|
|
|
**`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 to
|
|
conduct 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 backward 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, which includes support for
|
|
[CUDA-enabled GPU cards](https://www.tensorflow.org/install/gpu) *(Ubuntu and
|
|
Windows)*:
|
|
|
|
```
|
|
$ pip install tensorflow
|
|
```
|
|
|
|
A smaller CPU-only package is also available:
|
|
|
|
```
|
|
$ pip install tensorflow-cpu
|
|
```
|
|
|
|
To update TensorFlow to the latest version, add `--upgrade` flag to the above
|
|
commands.
|
|
|
|
*Nightly binaries are available for testing using the
|
|
[tf-nightly](https://pypi.python.org/pypi/tf-nightly) and
|
|
[tf-nightly-cpu](https://pypi.python.org/pypi/tf-nightly-cpu) packages on PyPi.*
|
|
|
|
#### *Try your first TensorFlow program*
|
|
|
|
```shell
|
|
$ python
|
|
```
|
|
|
|
```python
|
|
>>> import tensorflow as tf
|
|
>>> tf.add(1, 2).numpy()
|
|
3
|
|
>>> hello = tf.constant('Hello, TensorFlow!')
|
|
>>> hello.numpy()
|
|
b'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://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:tensorflow)
|
|
[](https://bestpractices.coreinfrastructure.org/projects/1486)
|
|
[](CODE_OF_CONDUCT.md)
|
|
|
|
## Continuous build status
|
|
|
|
You can find more community-supported platforms and configurations in the
|
|
[TensorFlow SIG Build community builds table](https://github.com/tensorflow/build#community-supported-tensorflow-builds).
|
|
|
|
### 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) | [Download](https://bintray.com/google/tensorflow/tensorflow/_latestVersion)
|
|
**Raspberry Pi 0 and 1** | [](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)
|
|
**Raspberry Pi 2 and 3** | [](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)
|
|
**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/)
|
|
**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/)
|
|
**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/)
|
|
**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/)
|
|
**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/)
|
|
|
|
## 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)
|
|
* [DeepLearning.AI TensorFlow Developer Professional Certificate](https://www.coursera.org/specializations/tensorflow-in-practice)
|
|
* [TensorFlow: Data and Deployment from Coursera](https://www.coursera.org/specializations/tensorflow-data-and-deployment)
|
|
* [Getting Started with TensorFlow 2 from Coursera](https://www.coursera.org/learn/getting-started-with-tensor-flow2)
|
|
* [TensorFlow: Advanced Techniques from Coursera](https://www.coursera.org/specializations/tensorflow-advanced-techniques)
|
|
* [Intro to TensorFlow for A.I, M.L, and D.L from Coursera](https://www.coursera.org/learn/introduction-tensorflow)
|
|
* [Intro to TensorFlow for Deep Learning from Udacity](https://www.udacity.com/course/intro-to-tensorflow-for-deep-learning--ud187)
|
|
* [Introduction to TensorFlow Lite from Udacity](https://www.udacity.com/course/intro-to-tensorflow-lite--ud190)
|
|
* [Machine Learning with TensorFlow on GCP](https://www.coursera.org/specializations/machine-learning-tensorflow-gcp)
|
|
* [TensorFlow Codelabs](https://codelabs.developers.google.com/?cat=TensorFlow)
|
|
* [TensorFlow Blog](https://blog.tensorflow.org)
|
|
* [Learn ML with TensorFlow](https://www.tensorflow.org/resources/learn-ml)
|
|
* [TensorFlow Twitter](https://twitter.com/tensorflow)
|
|
* [TensorFlow YouTube](https://www.youtube.com/channel/UC0rqucBdTuFTjJiefW5t-IQ)
|
|
* [TensorFlow model optimization roadmap](https://www.tensorflow.org/model_optimization/guide/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)
|