Installation

ReproZip is available as open source, released under the Revised BSD License. The tool is comprised of two components: reprozip (for the packing step) and reprounzip (for the unpack step). Additional components and plugins are also provided for reprounzip: reprounzip-vagrant, which unpacks the experiment in a Vagrant virtual machine; reprounzip-docker, which unpacks the experiment in a Docker container; and reprounzip-vistrails, which creates a VisTrails workflow to reproduce the experiment. More plugins may be developed in the future (and, of course, you are free to roll your own). In our website, you can find links to our PyPI packages and our GitHub repository.

In the following, you will find installation instructions for Linux, Mac OS X, and Windows. ReproZip is also available for the Anaconda Python distribution.

Linux

For Linux distributions, both reprozip and reprounzip components are available.

Required Software Packages

Python 2.7.3 or greater, or 3.3 or greater is required to run ReproZip [1]. If you don’t have Python on your machine, you can get it from python.org. You will also need the pip installer.

Besides Python and pip, each component or plugin to be used may have additional dependencies that you need to install (if you do not have them already installed in your environment), as described below:

Component / Plugin Required Software Packages
reprozip SQLite, Python headers, a working C compiler
reprounzip None
reprounzip-vagrant Python headers, a working C compiler, SSL library [2], FFI library [2], Vagrant v1.1+, VirtualBox
reprounzip-docker Docker
reprounzip-vistrails None [3]

Debian and Ubuntu

You can get all the required dependencies using APT:

apt-get install python python-dev python-pip gcc libsqlite3-dev libssl-dev libffi-dev

Fedora & CentOS

You can get the dependencies using the Yum packaging manager:

yum install python python-devel gcc sqlite-devel openssl-devel libffi-devel
[1]reprozip and reprounzip graph will not work before 2.7.3 due to Python bug 13676 related to sqlite3. Python 2.6 is ancient and unsupported.
[2](1, 2) Required to build PyCrypto.
[3]VisTrails v2.2.3+ is required to run the workflow generated by the plugin.

Installing reprozip

To install or update the reprozip component, simply run the following command:

$ pip install -U reprozip

Installing reprounzip

You can install or update reprounzip with all the available components and plugins using:

$ pip install -U reprounzip[all]

Or you can install reprounzip and choose components manually:

# Example, this installs all the components
$ pip install -U reprounzip reprounzip-docker reprounzip-vagrant reprounzip-vistrails

Mac OS X

For Mac OS X, only the reprounzip component is available.

Binaries

An installer containing Python 2.7, reprounzip, and all the plugins can be downloaded from GitHub.

Required Software Packages

Python 2.7.3 or greater, or 3.3 or greater is required to run ReproZip [4]. If you don’t have Python on your machine, you can get it from python.org; you should prefer a 2.x release to a 3.x one. You will also need the pip installer.

Besides Python and pip, each component or plugin to be used may have additional dependencies that you need to install (if you do not have them already installed in your environment), as described below:

Component / Plugin Required Software Packages
reprounzip None
reprounzip-vagrant Python headers, a working C compiler [5], Vagrant v1.1+, VirtualBox
reprounzip-docker Docker
reprounzip-vistrails None [6]

You will need Xcode installed, which you can get from the Mac App Store, and the Command Line Developer Tools; instrucions on installing the latter may depend on your Mac OS X version (some information on StackOverflow here).

[4]reprozip and reprounzip graph will not work before 2.7.3 due to Python bug 13676 related to sqlite3. Python 2.6 is ancient and unsupported.
[5]Required to build PyCrypto.
[6]VisTrails v2.2.3+ is required to run the workflow generated by the plugin.

Installing reprounzip

First, be sure to upgrade setuptools:

$ pip install -U setuptools

You can install or update reprounzip with all the available components and plugins using:

$ pip install -U reprounzip[all]

Or you can install reprounzip and choose components manually:

# Example, this installs all the components
$ pip install -U reprounzip reprounzip-docker reprounzip-vagrant reprounzip-vistrails

Windows

For Windows, only the reprounzip component is available.

Binaries

A 32-bit installer containing Python 2.7, reprounzip, and all the plugins can be downloaded from GitHub.

Required Software Packages

Python 2.7.3 or greater, or 3.3 or greater is required to run ReproZip [7]. If you don’t have Python on your machine, you can get it from python.org; you should prefer a 2.x release to a 3.x one. You will also need the pip installer.

Besides Python and pip, each component or plugin to be used may have additional dependencies that you need to install (if you do not have them already installed in your environment), as described below:

Component / Plugin Required Software Packages
reprounzip None
reprounzip-vagrant PyCrypto [8], Vagrant v1.1+, VirtualBox
reprounzip-docker Docker
reprounzip-vistrails None [9]
[7]reprozip and reprounzip graph will not work before 2.7.3 due to Python bug 13676 related to sqlite3. Python 2.6 is ancient and unsupported.
[8]A working C compiler is required to build PyCrypto. For installation without building from source, please see this page.
[9]VisTrails v2.2.3+ is required to run the workflow generated by the plugin.

Installing reprounzip

You can install or update reprounzip with all the available components and plugins using:

$ pip install -U reprounzip[all]

Or you can install reprounzip and choose components manually:

# Example, this installs all the components
$ pip install -U reprounzip reprounzip-docker reprounzip-vagrant reprounzip-vistrails

Anaconda

reprozip and reprounzip can also be installed on the Anaconda Python distribution, from anaconda.org:

$ conda install --channel vida-nyu reprozip reprounzip reprounzip-docker reprounzip-vagrant reprounzip-vistrails

Note, however, that reprozip is only available for Linux.