Skip to content
This repository has been archived by the owner on Jun 22, 2022. It is now read-only.

Installation Guide

Jump to bottom
kamil-kaczmarek edited this page Dec 14, 2017 · 21 revisions

Prerequisites

  1. Python 3.5
  2. Linux OS (Minerva is tested only on Linux machines)

Get the code

Clone or download Minerva code. Type:

$ cd your/working/directory
$ git clone https://github.com/neptune-ml/minerva.git

Note that you must have writing permission in your working directory.

Setup virtualenv

  1. Create virtualenv:
$ cd your/working/dir
$ virtualenv minerva -p python3.5

Note that you must have writing permission in your working directory.

  1. Activate newly created environment:
$ source minerva/bin/activate
  1. Check if your python is in the Minerva environment. Type:
$ which python

You should get answer similar to this:

./minerva/bin/python`

Install CUDA-dependent packages

Minerva uses both PyTorch and TensorFlow. These packages comes in two flavors, that is with GPU acceleration and without it. Note, that it is highly recommended to train your solution on GPU.

Check your CUDA version

If you already know your CUDA version go straight to CUDA section

There are several ways to get this information:

  1. Type:
$ nvcc --version

You should get answer similar to this:

nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2016 NVIDIA Corporation
Built on Sun_Sep__4_22:14:01_CDT_2016
Cuda compilation tools, release 8.0, V8.0.44

CUDA version is printed at the end of the last line.

  1. If previous step didn't work, type:
$ cat /usr/local/cuda/version.txt

You should get answer similar to this:

CUDA Version 8.0.61
  1. If previous steps didn't work, ask your system administrator for support.

CUDA

  1. install TensorFlow 
$ pip3 install tensorflow-gpu==1.2.0
  1. install PyTorch, by following PyTorch Get Started. Make sure that you picked python 3.5 and appropriate CUDA version.

no CUDA

It this case, you will work on your processor. Also, you may want to consider using Neptune to train your models.

  1. install TensorFlow 
$ pip3 install tensorflow==1.2.0
  1. install PyTorch, by following PyTorch Get Started. Make sure that you picked python 3.5 and None CUDA version.

Install Minerva requirements

While your environment is activated (check Setup virtualenv section), install remaining requirements. Type:

$ cd <minerva/code/path>
$ pip3 install -r requirements.txt

Note that you may want to start exploring notebooks, especially Fashion MNIST, while installation proceeds.

Clone this wiki locally