blob: e9fc94c6ecf7ccdecefa0013a64ac942fa0c27ee [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
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080034The TensorFlow Python API requires Python 2.7.
35
36The simplest way to install TensorFlow is using
37[pip](https://pypi.python.org/pypi/pip) for both Linux and Mac.
38
39For the GPU-enabled version, or if you encounter installation errors, or for
40more detailed installation instructions, see
41[here](tensorflow/g3doc/get_started/os_setup.md#detailed_install).
42
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080043### Ubuntu/Linux
44
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080045```bash
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080046# For CPU-only version
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080047$ 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 -080048```
49
50### Mac OS X
51
Manjunath Kudlurd769a3f2015-11-08 19:23:41 -080052```bash
53# Only CPU-version is available at the moment.
54$ pip install https://storage.googleapis.com/tensorflow/mac/tensorflow-0.5.0-py2-none-any.whl
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080055```
56
57### Try your first TensorFlow program
58
59```sh
60$ python
61
62>>> import tensorflow as tf
63>>> hello = tf.constant('Hello, TensorFlow!')
64>>> sess = tf.Session()
65>>> print sess.run(hello)
66Hello, TensorFlow!
67>>> a = tf.constant(10)
68>>> b = tf.constant(32)
69>>> print sess.run(a+b)
7042
71>>>
72
73```
74
Manjunath Kudlurf41959c2015-11-06 16:27:58 -080075##For more information
76
Manjunath Kudlurf41959c2015-11-06 16:27:58 -080077* [TensorFlow website](http://tensorflow.org)