Skip to content

Commit f71ee62

Browse files
committed
Updated installation instructions.
1 parent 74ebeba commit f71ee62

File tree

1 file changed

+25
-24
lines changed

1 file changed

+25
-24
lines changed

README.md

Lines changed: 25 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ If you want to see the exact versions of the source-code that were used in the Y
5656
then you can [browse the history](https://github.com/Hvass-Labs/TensorFlow-Tutorials/commits/master)
5757
of commits to the GitHub repository.
5858

59-
## Installation
59+
## Downloading
6060

6161
Some of the Python Notebooks use source-code located in different files to allow for easy re-use
6262
across multiple tutorials. It is therefore recommended that you download the whole repository
@@ -79,16 +79,22 @@ This also makes it easy to update the tutorials, simply by executing this comman
7979
You can also [download](https://github.com/Hvass-Labs/TensorFlow-Tutorials/archive/master.zip)
8080
the contents of the GitHub repository as a Zip-file and extract it manually.
8181

82-
## Requirements
83-
84-
These tutorials were developed on Linux using **Python 3.5** (the [Anaconda](https://www.continuum.io/downloads) distribution) and [PyCharm](https://www.jetbrains.com/pycharm/).
85-
86-
There are reports that Python 2.7 gives error messages with these tutorials. Please make sure you are using **Python 3.5** or later!
82+
## Installation
8783

8884
There are different ways of installing and running TensorFlow. This section describes how I did it
8985
for these tutorials. You may want to do it differently and you can search the internet for instructions.
9086

91-
### Example Setup
87+
If you are new to using Python and Linux, etc. then this may be challenging
88+
to get working and you may need to do internet searches for error-messages, etc.
89+
It will get easier with practice.
90+
91+
### Python Version 3.5 or Later
92+
93+
These tutorials were developed on Linux using **Python 3.5 / 3.6** (the [Anaconda](https://www.continuum.io/downloads) distribution) and [PyCharm](https://www.jetbrains.com/pycharm/).
94+
95+
There are reports that Python 2.7 gives error messages with these tutorials. Please make sure you are using **Python 3.5** or later!
96+
97+
### Environment
9298

9399
After installing [Anaconda](https://www.continuum.io/downloads), you should create a [conda environment](http://conda.pydata.org/docs/using/envs.html)
94100
so you do not destroy your main installation in case you make a mistake somewhere:
@@ -99,24 +105,23 @@ Now you can switch to the new environment by running the following (on Linux):
99105

100106
source activate tf
101107

102-
Some of these tutorials use [scikit-learn](http://scikit-learn.org/stable/install.html)
103-
which can be installed in your new conda environment as follows. This also installs
104-
NumPy and other dependencies:
105-
106-
conda install scikit-learn
108+
### Required Packages
107109

108-
You may also need to install other dependencies, such as:
110+
The tutorials require several Python packages to be installed. The packages are listed in
111+
[requirements.txt](https://github.com/Hvass-Labs/TensorFlow-Tutorials/blob/master/requirements.txt)
112+
First you need to edit this file and select whether you want to install the CPU or GPU
113+
version of TensorFlow.
109114

110-
conda install jupyter matplotlib scipy pillow
115+
To install the required Python packages and dependencies you first have to activate the
116+
conda-environment as described above, and then you run the following command
117+
in a terminal:
111118

112-
Now you have to install TensorFlow. It is now possible to install the CPU-version of TensorFlow
113-
directly using pip. We also need the [PrettyTensor](https://github.com/google/prettytensor)
114-
add-on package so we install that as well:
119+
pip install -r requirements.txt
115120

116-
pip install tensorflow prettytensor
121+
Note that the GPU-version of TensorFlow also requires the installation of various
122+
NVIDIA drivers, which is not described here.
117123

118-
It is much more complicated to install the GPU-version because you also need various NVIDIA drivers.
119-
That is not described here.
124+
### Testing
120125

121126
You should now be able to run the tutorials in the Python Notebooks:
122127

@@ -125,10 +130,6 @@ You should now be able to run the tutorials in the Python Notebooks:
125130

126131
This should start a web-browser that shows the list of tutorials. Click on a tutorial to load it.
127132

128-
If you are new to using Python and Linux, etc. then this may be challenging
129-
to get working and you may need to do internet searches for error-messages, etc.
130-
It will get easier with practice.
131-
132133
## License (MIT)
133134

134135
These tutorials and source-code are published under the [MIT License](https://github.com/Hvass-Labs/TensorFlow-Tutorials/blob/master/LICENSE)

0 commit comments

Comments
 (0)