Original author is Magnus Erik Hvass Pedersen
The following tutorials have been updated and work with TensorFlow 2 (some of them run in "v.1 compatibility mode").
The following tutorials only work with the older TensorFlow 1 API, so you would need to install an older version of TensorFlow to run these. It would take too much time and effort to convert these tutorials to TensorFlow 2.
These tutorials are also available as YouTube videos.
These tutorials have been translated to the following languages:
You can help by translating the remaining tutorials or reviewing the ones that have already been translated. You can also help by translating to other languages.
It is a very big job to translate all the tutorials, so you should just start with Tutorials #01, #02 and #03-C which are the most important for beginners.
You are also very welcome to record your own YouTube videos in other languages. It is strongly recommended that you get a decent microphone because good sound quality is very important. I used
vokoscreen for recording the videos and the free DaVinci Resolve for editing the videos.
See the selected list of forks for community modifications to these tutorials.
There are different ways of installing and running TensorFlow. This section describes how I did it for these tutorials. You may want to do it differently and you can search the internet for instructions.
If you are new to using Python and Linux then this may be challenging to get working and you may need to do internet searches for error-messages, etc. It will get easier with practice. You can also run the tutorials without installing anything by using Google Colab, see further below.
Some of the Python Notebooks use source-code located in different files to allow for easy re-use across multiple tutorials. It is therefore recommended that you download the whole repository from GitHub, instead of just downloading the individual Python Notebooks.
The easiest way to download and install these tutorials is by using git from the command-line:
git clone https://github.com/Hvass-Labs/TensorFlow-Tutorials.git
This will create the directory
TensorFlow-Tutorials and download all the files to it.
This also makes it easy to update the tutorials, simply by executing this command inside that directory:
You can also download the contents of the GitHub repository as a Zip-file and extract it manually.
I use Anaconda because it comes with many Python packages already installed and it is easy to work with. After installing Anaconda, you should create a conda environment so you do not destroy your main installation in case you make a mistake somewhere:
conda create --name tf python=3
When Python gets updated to a new version, it takes a while before TensorFlow also uses the new Python version. So if the TensorFlow installation fails, then you may have to specify an older Python version for your new environment, such as:
conda create --name tf python=3.6
Now you can switch to the new environment by running the following (on Linux):
source activate tf
The tutorials require several Python packages to be installed. The packages are listed in requirements.txt
To install the required Python packages and dependencies you first have to activate the conda-environment as described above, and then you run the following command in a terminal:
pip install -r requirements.txt
Starting with TensorFlow 2.1 it includes both the CPU and GPU versions and will automatically switch if you have a GPU. But this requires the installation of various NVIDIA drivers, which is a bit complicated and is not described here.
There are reports that Python 2.7 gives error messages with these tutorials. Please make sure you are using Python 3.5 or later!
If you have followed the above installation instructions, you should now be able to run the tutorials in the Python Notebooks:
cd ~/development/TensorFlow-Tutorials/ # Your installation directory. jupyter notebook
This should start a web-browser that shows the list of tutorials. Click on a tutorial to load it.
If you do not want to install anything on your own computer, then the Notebooks can be viewed, edited and run entirely on the internet by using Google Colab. There is a YouTube video explaining how to do this. You click the "Google Colab"-link next to each tutorial listed above. You can view the Notebook on Colab but in order to run it you need to login using your Google account. Then you need to execute the following commands at the top of the Notebook, which clones the contents of this repository to your work-directory on Colab.
# Clone the repository from GitHub to Google Colab's temporary drive. import os work_dir = "/content/TensorFlow-Tutorials/" if not os.path.exists(work_dir): !git clone https://github.com/Hvass-Labs/TensorFlow-Tutorials.git os.chdir(work_dir)
All required packages should already be installed on Colab, otherwise you can run the following command:
!pip install -r requirements.txt
Sometimes the source-code has changed from that shown in the YouTube videos. This may be due to bug-fixes, improvements, or because code-sections are moved to separate files for easy re-use.
If you want to see the exact versions of the source-code that were used in the YouTube videos, then you can browse the history of commits to the GitHub repository.
These tutorials and source-code are published under the MIT License which allows very broad use for both academic and commercial purposes.
A few of the images used for demonstration purposes may be under copyright. These images are included under the "fair usage" laws.
You are very welcome to modify these tutorials and use them in your own projects. Please keep a link to the original repository.