Please read the entire page before you actually begin installation.
The following procedure has been tested on well-maintained machines running Linux Ubuntu 14.04. (WARNING: Machines using a different version of Ubuntu, such as 12.04, may cause problems during installation. We intend to address older Ubuntu versions such as these in a later release.)
Also ensure that you have the latest version of Caffe. Recent changes made to deep net definition specs (.prototxt) may cause errors while attempting to run
Expresso with older Caffe versions.
Note that you will also need admin-like (
sudo) privileges to install the dependencies.
We provide a detailed installation procedure below. A simplified installation procedure is given here.
This step is optional if the NVIDIA GPU drivers are already installed. If you do not have a GPU, you can skip this step. Instructions for installing NVIDIA CUDA drivers can be found here.
Expresso runs atop
Caffe, the first step is to install
Caffe’s installation procedure page, Python and/or MATLAB wrappers for
Caffe are listed as optional. However, Python wrappers of
Caffe are very much necessary for
Expresso to work. The default installation procedure for
Caffe’s dependencies may not install all python-related dependencies properly. To fix this, execute the following on the command-line before you install
sudo apt-get install git
sudo apt-get install libatlas-base-dev
sudo apt-get install python-protobuf
sudo apt-get install python-numpy
sudo apt-get install python-scipy
sudo apt-get install python-h5py
Now install Caffe. Linux Ubuntu-specific instructions for installing
Caffe can be found here. Before the actual installation, it is strongly recommended to review the
Caffe installation info provided here. We have found installation of
Caffe easiest when the underlying Ubuntu distribution is 14.04. Our experience with 12.04 has been mixed. Your experience may vary. Please refer to
Caffe’s user forums and developer issue lists to resolve any issues you may encounter.
Once done, go ahead and install
Caffe’s Python wrapper dependencies as mentioned here . For this, you need to change the directory to
CAFFE_ROOT refers to
Caffe’s root directory. However, keep the following in mind:
If you use a proxy : Suppose the proxy server string (usually of the form
HTTP_PROXY. Type the following on the command line (assuming current directory is
for req in $(cat requirements.txt); do sudo pip --proxy HTTP_PROXY install $req; done
If you do not use/require a proxy : Type as suggested by
Caffe’s installation page (assuming current directory is
for req in $(cat requirements.txt); do sudo pip install $req; done
Once this is done, go back up to
CAFFE_ROOT directory and type
NOTE: Matlab wrappers of
Caffe (matcaffe) are NOT a requirement for
Expresso can be downloaded from its github repo in the usual manner:
git clone https://github.com/val-iisc/expresso
The cloning procedure above results in a directory named
expresso. Follow the instructions in
expresso/INSTALL.md to complete the installation procedure.
Please refer to our tutorials for examples of how
Expresso can be used once it is actually installed.