Installation

Viper is written in Python and Python >= 3.4 is recommended (python 2.7 should still work) to function properly. In this documentation we will use Debian GNU/Linux based distributions, such as Ubuntu, as a reference platform. The following installation instructions should apply similarly to other distributions and possibly to Mac OS X as well, although it has not been properly tested.

Before proceeding, you should make sure you have the basic tools installed to be able to compile additional Python extensions:

$ sudo apt-get install gcc python3-dev python3-pip

In order to have support for certain modules, you will need to install the following dependencies too before proceeding:

$ sudo apt-get install libssl-dev swig libffi-dev ssdeep libfuzzy-dev

To install Viper:

$ git clone https://github.com/viper-framework/viper
$ cd viper
$ git submodule init
$ git submodule update
$ sudo make install

First launch

If everything worked out fine, you should be able to launch Viper’s shell without raising any exceptions, like following:

nex@nex:~/$ ./viper-cli
         _
        (_)
   _   _ _ ____  _____  ____
  | | | | |  _ \| ___ |/ ___)
   \ V /| | |_| | ____| |
    \_/ |_|  __/|_____)_| v1.3
          |_|

You have 0 files in your default repository
shell >

Uninstall

To uninstall Viper:

$ cd viper
$ sudo make uninstall