Installation

ELFI requires Python 3.5 or greater (see below how to install). To install ELFI, simply type in your terminal:

pip install elfi

In some OS you may have to first install numpy with pip install numpy. If you don’t have pip installed, this Python installation guide can guide you through the process.

Installing Python 3.5

If you are new to Python, perhaps the simplest way to install it is with Anaconda that manages different Python versions. After installing Anaconda, you can create a Python 3.5. environment with ELFI:

conda create -n elfi python=3.5 numpy
source activate elfi
pip install elfi

Optional dependencies

We recommend to install:

  • graphviz for drawing graphical models (pip install graphviz requires Graphviz binaries which are already available in many unix-like OS).

Potential problems with installation

ELFI depends on several other Python packages, which have their own dependencies. Resolving these may sometimes go wrong:

  • If you receive an error about missing numpy, please install it first.
  • If you receive an error about yaml.load, install pyyaml.
  • On OS X with Anaconda virtual environment say conda install python.app and then use pythonw instead of python.
  • Note that ELFI requires Python 3.5 or greater

Developer installation from sources

The sources for ELFI can be downloaded from the Github repo.

You can either clone the public repository:

git clone https://github.com/elfi-dev/elfi.git

Or download the development tarball:

curl -OL https://github.com/elfi-dev/elfi/tarball/dev

Note that for development it is recommended to base your work on the dev branch instead of master.

Once you have a copy of the source, go to the folder and type:

pip install -e .

This will install ELFI along with its default requirements. Note that the dot in the end means the current folder.