blob: 44f85d979933d346b112a0d6c5d83c54e1e68193 [file] [log] [blame] [view]
Manjunath Kudlurf41959c2015-11-06 16:27:58 -08001#TensorFlow
2
3TensorFlow is an open source software library for numerical computation using
4data flow graphs. Nodes in the graph represent mathematical operations, while
5the graph edges represent the multidimensional data arrays (tensors) that flow
6between them. This flexible architecture lets you deploy computation to one
7or more CPUs or GPUs in a desktop, server, or mobile device without rewriting
8code. TensorFlow was originally developed by researchers and engineers
9working on the Google Brain team within Google's Machine Intelligence research
10organization for the purposes of conducting machine learning and deep neural
11networks research. The system is general enough to be applicable in a wide
12variety of other domains, as well.
13
Vijay Vasudevan7de90992015-11-07 10:49:41 -080014
15**Note: Currently we do not accept pull requests on github -- see
16[CONTRIBUTING.md](CONTRIBUTING.md) for information on how to contribute code
17changes 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
21tracking requests and bugs, but please see
Vijay Vasudevanfddaed52015-11-07 13:58:24 -080022[Community](tensorflow/g3doc/resources/index.md#community) for general questions
23and discussion.**
Vijay Vasudevan7de90992015-11-07 10:49:41 -080024
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080025# Download and Setup
26
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080027To install the CPU version of TensorFlow using a binary package, see the
28instructions below. For more detailed installation instructions, including
29installing from source, GPU-enabled support, etc., see
Vijay Vasudevan8bd3b382015-11-06 21:57:38 -080030[here](tensorflow/g3doc/get_started/os_setup.md).
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080031
32## Binary Installation
33
Vijay Vasudevan3961abe2015-11-11 11:52:11 -080034The TensorFlow Python API currently requires Python 2.7: we are
35[working](https://github.com/tensorflow/tensorflow/issues/1) on adding support
Vijay Vasudevanf2102f42015-11-11 18:45:21 -080036for Python 3.
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080037
38The simplest way to install TensorFlow is using
39[pip](https://pypi.python.org/pypi/pip) for both Linux and Mac.
40
41For the GPU-enabled version, or if you encounter installation errors, or for
42more detailed installation instructions, see
43[here](tensorflow/g3doc/get_started/os_setup.md#detailed_install).
44
Vijay Vasudevan3961abe2015-11-11 11:52:11 -080045### Ubuntu/Linux 64-bit
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080046
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080047```bash
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080048# For CPU-only version
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080049$ pip install https://storage.googleapis.com/tensorflow/linux/cpu/tensorflow-0.5.0-cp27-none-linux_x86_64.whl
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080050```
51
52### Mac OS X
53
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080054```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 Kudlurcd9e60c2015-11-06 18:37:11 -080057```
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)
68Hello, TensorFlow!
69>>> a = tf.constant(10)
70>>> b = tf.constant(32)
71>>> print sess.run(a+b)
7242
73>>>
74
75```
76
Manjunath Kudlurf41959c2015-11-06 16:27:58 -080077##For more information
78
Manjunath Kudlurf41959c2015-11-06 16:27:58 -080079* [TensorFlow website](http://tensorflow.org)
Vijay Vasudevan9f649832015-11-09 06:38:54 -080080* [TensorFlow whitepaper](http://download.tensorflow.org/paper/whitepaper2015.pdf)