README.md 2.7 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13
#TensorFlow

TensorFlow is an open source software library for numerical computation using
data flow graphs.  Nodes in the graph represent mathematical operations, while
the graph edges represent the multidimensional data arrays (tensors) that flow
between them.  This flexible architecture lets you deploy computation to one
or more CPUs or GPUs in a desktop, server, or mobile device without rewriting
code.  TensorFlow was originally developed by researchers and engineers
working on the Google Brain team within Google's Machine Intelligence research
organization for the purposes of conducting machine learning and deep neural
networks research.  The system is general enough to be applicable in a wide
variety of other domains, as well.

14 15 16 17 18 19 20 21

**Note: Currently we do not accept pull requests on github -- see
[CONTRIBUTING.md](CONTRIBUTING.md) for information on how to contribute code
changes to TensorFlow through
[tensorflow.googlesource.com](https://tensorflow.googlesource.com/tensorflow)**

**We use [github issues](https://github.com/tensorflow/tensorflow/issues) for
tracking requests and bugs, but please see
22 23
[Community](tensorflow/g3doc/resources/index.md#community) for general questions
and discussion.**
24

25 26
# Download and Setup

27 28 29
To install the CPU version of TensorFlow using a binary package, see the
instructions below.  For more detailed installation instructions, including
installing from source, GPU-enabled support, etc., see
30
[here](tensorflow/g3doc/get_started/os_setup.md).
31 32 33

## Binary Installation

34 35
The TensorFlow Python API currently requires Python 2.7: we are
[working](https://github.com/tensorflow/tensorflow/issues/1) on adding support
36
for Python 3.
37

38 39
The simplest way to install TensorFlow is using
[pip](https://pypi.python.org/pypi/pip) for both Linux and Mac.
40

41 42 43
For the GPU-enabled version, or if you encounter installation errors, or for
more detailed installation instructions, see
[here](tensorflow/g3doc/get_started/os_setup.md#detailed_install).
44

45
### Ubuntu/Linux 64-bit
46

47
```bash
48
# For CPU-only version
49
$ pip install https://storage.googleapis.com/tensorflow/linux/cpu/tensorflow-0.5.0-cp27-none-linux_x86_64.whl
50 51 52 53
```

### Mac OS X

54 55 56
```bash
# Only CPU-version is available at the moment.
$ pip install https://storage.googleapis.com/tensorflow/mac/tensorflow-0.5.0-py2-none-any.whl
57 58 59 60 61 62 63 64 65 66
```

### Try your first TensorFlow program

```sh
$ python

>>> import tensorflow as tf
>>> hello = tf.constant('Hello, TensorFlow!')
>>> sess = tf.Session()
67
>>> sess.run(hello)
68 69 70
Hello, TensorFlow!
>>> a = tf.constant(10)
>>> b = tf.constant(32)
71
>>> sess.run(a+b)
72 73 74 75 76
42
>>>

```

77 78 79
##For more information

* [TensorFlow website](http://tensorflow.org)
80
* [TensorFlow whitepaper](http://download.tensorflow.org/paper/whitepaper2015.pdf)