| Manjunath Kudlur | f41959c | 2015-11-06 16:27:58 -0800 | [diff] [blame] | 1 | #TensorFlow |
| 2 | |
| 3 | TensorFlow is an open source software library for numerical computation using |
| 4 | data flow graphs. Nodes in the graph represent mathematical operations, while |
| 5 | the graph edges represent the multidimensional data arrays (tensors) that flow |
| 6 | between them. This flexible architecture lets you deploy computation to one |
| 7 | or more CPUs or GPUs in a desktop, server, or mobile device without rewriting |
| 8 | code. TensorFlow was originally developed by researchers and engineers |
| 9 | working on the Google Brain team within Google's Machine Intelligence research |
| 10 | organization for the purposes of conducting machine learning and deep neural |
| 11 | networks research. The system is general enough to be applicable in a wide |
| 12 | variety of other domains, as well. |
| 13 | |
| Vijay Vasudevan | 7de9099 | 2015-11-07 10:49:41 -0800 | [diff] [blame] | 14 | |
| 15 | **Note: Currently we do not accept pull requests on github -- see |
| 16 | [CONTRIBUTING.md](CONTRIBUTING.md) for information on how to contribute code |
| 17 | changes to TensorFlow through |
| 18 | [tensorflow.googlesource.com](https://tensorflow.googlesource.com/tensorflow)** |
| 19 | |
| 20 | **We use [github issues](https://github.com/tensorflow/tensorflow/issues) for |
| 21 | tracking requests and bugs, but please see |
| Vijay Vasudevan | fddaed5 | 2015-11-07 13:58:24 -0800 | [diff] [blame] | 22 | [Community](tensorflow/g3doc/resources/index.md#community) for general questions |
| 23 | and discussion.** |
| Vijay Vasudevan | 7de9099 | 2015-11-07 10:49:41 -0800 | [diff] [blame] | 24 | |
| Manjunath Kudlur | cd9e60c | 2015-11-06 18:37:11 -0800 | [diff] [blame] | 25 | # Download and Setup |
| 26 | |
| Manjunath Kudlur | d769a3f | 2015-11-08 19:23:41 -0800 | [diff] [blame] | 27 | To install the CPU version of TensorFlow using a binary package, see the |
| 28 | instructions below. For more detailed installation instructions, including |
| 29 | installing from source, GPU-enabled support, etc., see |
| Vijay Vasudevan | 8bd3b38 | 2015-11-06 21:57:38 -0800 | [diff] [blame] | 30 | [here](tensorflow/g3doc/get_started/os_setup.md). |
| Manjunath Kudlur | cd9e60c | 2015-11-06 18:37:11 -0800 | [diff] [blame] | 31 | |
| 32 | ## Binary Installation |
| 33 | |
| Vijay Vasudevan | 3961abe | 2015-11-11 11:52:11 -0800 | [diff] [blame] | 34 | The TensorFlow Python API currently requires Python 2.7: we are |
| 35 | [working](https://github.com/tensorflow/tensorflow/issues/1) on adding support |
| Vijay Vasudevan | f2102f4 | 2015-11-11 18:45:21 -0800 | [diff] [blame^] | 36 | for Python 3. |
| Manjunath Kudlur | d769a3f | 2015-11-08 19:23:41 -0800 | [diff] [blame] | 37 | |
| 38 | The simplest way to install TensorFlow is using |
| 39 | [pip](https://pypi.python.org/pypi/pip) for both Linux and Mac. |
| 40 | |
| 41 | For the GPU-enabled version, or if you encounter installation errors, or for |
| 42 | more detailed installation instructions, see |
| 43 | [here](tensorflow/g3doc/get_started/os_setup.md#detailed_install). |
| 44 | |
| Vijay Vasudevan | 3961abe | 2015-11-11 11:52:11 -0800 | [diff] [blame] | 45 | ### Ubuntu/Linux 64-bit |
| Manjunath Kudlur | cd9e60c | 2015-11-06 18:37:11 -0800 | [diff] [blame] | 46 | |
| Manjunath Kudlur | d769a3f | 2015-11-08 19:23:41 -0800 | [diff] [blame] | 47 | ```bash |
| Manjunath Kudlur | cd9e60c | 2015-11-06 18:37:11 -0800 | [diff] [blame] | 48 | # For CPU-only version |
| Manjunath Kudlur | d769a3f | 2015-11-08 19:23:41 -0800 | [diff] [blame] | 49 | $ pip install https://storage.googleapis.com/tensorflow/linux/cpu/tensorflow-0.5.0-cp27-none-linux_x86_64.whl |
| Manjunath Kudlur | cd9e60c | 2015-11-06 18:37:11 -0800 | [diff] [blame] | 50 | ``` |
| 51 | |
| 52 | ### Mac OS X |
| 53 | |
| Manjunath Kudlur | d769a3f | 2015-11-08 19:23:41 -0800 | [diff] [blame] | 54 | ```bash |
| 55 | # Only CPU-version is available at the moment. |
| 56 | $ pip install https://storage.googleapis.com/tensorflow/mac/tensorflow-0.5.0-py2-none-any.whl |
| Manjunath Kudlur | cd9e60c | 2015-11-06 18:37:11 -0800 | [diff] [blame] | 57 | ``` |
| 58 | |
| 59 | ### Try your first TensorFlow program |
| 60 | |
| 61 | ```sh |
| 62 | $ python |
| 63 | |
| 64 | >>> import tensorflow as tf |
| 65 | >>> hello = tf.constant('Hello, TensorFlow!') |
| 66 | >>> sess = tf.Session() |
| 67 | >>> print sess.run(hello) |
| 68 | Hello, TensorFlow! |
| 69 | >>> a = tf.constant(10) |
| 70 | >>> b = tf.constant(32) |
| 71 | >>> print sess.run(a+b) |
| 72 | 42 |
| 73 | >>> |
| 74 | |
| 75 | ``` |
| 76 | |
| Manjunath Kudlur | f41959c | 2015-11-06 16:27:58 -0800 | [diff] [blame] | 77 | ##For more information |
| 78 | |
| Manjunath Kudlur | f41959c | 2015-11-06 16:27:58 -0800 | [diff] [blame] | 79 | * [TensorFlow website](http://tensorflow.org) |
| Vijay Vasudevan | 9f64983 | 2015-11-09 06:38:54 -0800 | [diff] [blame] | 80 | * [TensorFlow whitepaper](http://download.tensorflow.org/paper/whitepaper2015.pdf) |