[note: this is a wiki post so you can edit it to improve it]
Please use this thread for any fastai v0.7 (i.e. pre-fastai-1.x.x) installation related issues. For fastai-v1 installation issue please refer to this thread instead.
Since fastai-1.0.1 release in Oct 2018, fastai-v1 is now the main code base inside fastai git repo. The fastai-v0.7 code base has moved to the
old/fastai directory inside the same repository. And there is a symlink that points from
../../old/fastai so the notebooks under
courses/*/*.ipynb currently still work with the v0.7 code base (windows users using their own GPU will need to tweak the symlinks, see the instructions in the windows-installation links below).
First, please make sure you have the latest
pip, depending on the package manager you use:
pip install pip -U conda update conda
Currently, there are two ways to install fastai-0.7.x: (1) via conda from git source (best), or (2) via pip package (outdated code):
Conda installation from source:
1a. First, create the
fastaiconda environment. It will install all the dependencies that are needed. Do it only once:
git clone https://github.com/fastai/fastai.git cd fastai conda env create -f environment.yml
You then activate that environment with:
conda activate fastai
If you don’t have GPU, build the
git clone https://github.com/fastai/fastai.git cd fastai conda env create -f environment-cpu.yml
You then activate that environment with:
conda activate fastai-cpu
Windows users wanting to use their own GPU, rather than cloud or vm solutions, will have extra steps to take. Please see the links to windows-dedicated threads at the end of this post.
1b. and now you can start running the course notebooks:
Once the jupyter notebook environment has started, in your browser navigate to
courses/dl1/lesson1.ipynband execute the notebook.
From now on remember that you need to activate either
fastai-cpuenvironment that you created before in the shell that you code or notebooks from.
Some time later, to update to the latest
cd fastai git pull conda env update
If something gets messed up, delete the old env first:
conda env remove -y -n fastai
conda env remove -y -n fastai-cpu
and then re-create the environment as explained in steps 1 a+b above.
This post goes into more exact details on what else you might need to undo and restart from scratch. This probably mostly affects people who are updating their old setup, which no longer functions.
pip install fastai==0.7.0 pip install torchtext==0.2.3
This currently will install the fastai version from May 13, 2018 (outdated)
Some troubleshooting ideas
Tell me where Python is looking for my modules to import from:
import sys print(sys.path)
Tell me which
fastai library got loaded (we want to know the exact path)
import sys, fastai print(sys.modules['fastai'])
At times a quick hack can be used to get your first notebook working and then sorting out the setup. Say you checked out
cd /tmp/ git clone https://github.com/fastai/fastai cd fastai/old/
So now you know that your uninstalled
fastai is located under `/tmp/fastai/old/. Next, put the following on the very top of your notebook:
import sys sys.path.append("/tmp/fastai/old") # on windows use \'s instead import fastai
and it should just work. Now, go and sort out the symlinks, so that you don’t need to do it for every notebook.
Installation on Windows (not recommended for beginners, use cloud instead)
If you encounter installation issues please report them in this thread.
For windows-specific install issues it’s probably the best to post in this dedicated thread.
When you make your report include as much information as possible, including your platform details and in particular the exact steps you executed (all of them) that lead you to a problem. Please remember, we can’t guess what you may have done.
Please do not send screenshots with trace/error messages - we can’t copy-n-paste from the images, instead paste them verbatim into your post and use the markdown gui menu so that it’s code-formatted.
If your system is configured to use a non-English locale, if possible, re-run the problematic code after running:
So that the error messages will be in English. You can run
locale to see which locales you have installed.
p.s. if there are cloud/vm-service-specific instructional threads/posts that are up-to-date, please add a link, so this thread can send users to the more specific threads where a specific environment is discussed. Thanks.