Installation Guide

Note: This is still a work in progress and should be considered incomplete. Suggestions, requests, etc, are welcome.

Preinstallation

Installing dependencies

The following dependencies are required. However, it is worth noting that the following items do not need to reside on the same machine

• NodeJS v4.1.1
• MongoDB v3.0.7
• Torch

Installation

MongoDB

Download and install from the website. If you are planning on running MongoDB locally on the same machine as DeepForge, simply start mongod and continue to setting up DeepForge.

If you are planning on running MongoDB remotely, set the environment variable "MONGO_URI" to the URI of the Mongo instance that DeepForge will be using:

MONGO_URI="mongodb://pathToMyMongo.com:27017/myCollection" npm start

DeepForge Server

First, clone the repository:

git clone https://github.com/dfst/deepforge.git

Then install the project dependencies:

npm install

To run all executions locally start with

npm run local

and navigate to http://localhost:8888 to start using DeepForge!

Alternatively, run npm start locally and navigate to http://localhost:8888 if jobs are going to be executed on an external worker.

DeepForge Worker

If you are using npm start you will need to set up a DeepForge worker (npm run local starts a local worker for you!). DeepForge workers are slave machines connected to DeepForge which execute the provided jobs. This allows the jobs to access the GPU, etc, and provides a number of benefits over trying to perform deep learning tasks in the browser.

Once DeepForge is installed on the worker, start it with

npm run worker

Note: If you are running the worker on a different machine, put the address of the DeepForge server as an argument to the command. For example:

npm run worker http://myaddress.com:1234