Permalink
5cfa5f7 Oct 5, 2016
@lukeyeager @gheinrich @IsaacYangSLA
79 lines (54 sloc) 2.69 KB

Building DIGITS

The preferred installation method for DIGITS is using pre-built packages on Ubuntu 14.04 (instructions).

If those don't work for you for some reason, the following instructions will walk you through building the latest version of DIGITS from source. These instructions are for installation on Ubuntu 14.04 and 16.04.

Alternatively, see this guide for setting up DIGITS and Caffe on Windows machines.

Other platforms are not officially supported, but users have successfully installed DIGITS on Ubuntu 12.04, CentOS, OSX, and possibly more. Since DIGITS itself is a pure Python project, installation is usually pretty trivial regardless of the platform. The difficulty comes from installing all the required dependencies for Caffe and/or Torch7 and configuring the builds. Doing so is your own adventure.

Dependencies

Install some dependencies with Deb packages:

sudo apt-get install --no-install-recommends git graphviz python-dev python-flask python-flaskext.wtf python-gevent python-h5py python-numpy python-pil python-pip python-protobuf python-scipy

Follow these instructions to build Caffe (required).

Follow these instructions to build Torch7 (suggested).

Download source

# example location - can be customized
DIGITS_ROOT=~/digits
git clone https://github.com/NVIDIA/DIGITS.git $DIGITS_ROOT

Throughout the docs, we'll refer to your install location as DIGITS_ROOT (~/digits in this case), though you don't need to actually set that environment variable.

Python packages

Several PyPI packages need to be installed:

sudo pip install -r $DIGITS_ROOT/requirements.txt

[Optional] Enable support for plug-ins

DIGITS needs to be installed to enable loading data and visualization plug-ins:

sudo pip install -e $DIGITS_ROOT

Starting the server

./digits-devserver

Starts a server at http://localhost:5000/.

$ ./digits-devserver --help
usage: __main__.py [-h] [-p PORT] [-d] [--version]

DIGITS development server

optional arguments:
  -h, --help            show this help message and exit
  -p PORT, --port PORT  Port to run app on (default 5000)
  -d, --debug           Run the application in debug mode (reloads when the
                        source changes and gives more detailed error messages)
  --version             Print the version number and exit

Getting started

Now that you're up and running, check out the Getting Started Guide.

Troubleshooting

Most configuration options should have appropriate defaults. Read this doc for information about how to set a custom configuration for your server.