blob: 102f3742e8c42587c0da08bbbb9b3cfc1a27ae78 [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
22[Community](resources/index.md#community) for general questions and
23discussion.**
24
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080025# Download and Setup
26
Vijay Vasudevan7de90992015-11-07 10:49:41 -080027To install TensorFlow using a binary package, see the instructions below. For
28more detailed installation instructions, including installing from source, see
Vijay Vasudevan8bd3b382015-11-06 21:57:38 -080029[here](tensorflow/g3doc/get_started/os_setup.md).
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080030
31## Binary Installation
32
33### Ubuntu/Linux
34
35Make sure you have [pip](https://pypi.python.org/pypi/pip) installed:
36
37```sh
38$ sudo apt-get install python-pip
39```
40
41Install TensorFlow:
42
43```sh
44# For CPU-only version
45$ sudo pip install https://storage.googleapis.com/tensorflow/linux/cpu/tensorflow-0.5.0-cp27-none-linux_x86_64.whl
46
Vijay Vasudevan7de90992015-11-07 10:49:41 -080047# For GPU-enabled version. See detailed install instructions
48# for GPU configuration information.
Manjunath Kudlurcd9e60c2015-11-06 18:37:11 -080049$ sudo pip install https://storage.googleapis.com/tensorflow/linux/gpu/tensorflow-0.5.0-cp27-none-linux_x86_64.whl
50```
51
52### Mac OS X
53
54Make sure you have [pip](https://pypi.python.org/pypi/pip) installed:
55
56If using `easy_install`:
57
58```sh
59$ sudo easy_install pip
60```
61
62Install TensorFlow (only CPU binary version is currently available).
63
64```sh
65$ sudo pip install https://storage.googleapis.com/tensorflow/mac/tensorflow-0.5.0-py2-none-any.whl
66```
67
68### Try your first TensorFlow program
69
70```sh
71$ python
72
73>>> import tensorflow as tf
74>>> hello = tf.constant('Hello, TensorFlow!')
75>>> sess = tf.Session()
76>>> print sess.run(hello)
77Hello, TensorFlow!
78>>> a = tf.constant(10)
79>>> b = tf.constant(32)
80>>> print sess.run(a+b)
8142
82>>>
83
84```
85
86
Manjunath Kudlurf41959c2015-11-06 16:27:58 -080087##For more information
88
Manjunath Kudlurf41959c2015-11-06 16:27:58 -080089* [TensorFlow website](http://tensorflow.org)