Skip to content
oweidner edited this page May 3, 2012 · 36 revisions

#Installation# Requirements:

Bliss has the following requirements:

  • Python 2.5 or newer
  • Paramiko (installs with Bliss)
  • PyCrypto (installs with Bliss)

Bliss is available for download via PyPI and may be installed using easy_install or pip (preferred). Both automatically download and install all dependencies required by Bliss if they can't be found on your system. You don't have any of these tools installed? Scroll down!

$ pip install bliss

or with easy_install:

$ easy_install bliss

Alternative Installation Locations

If you don't want to or simply can't install Bliss into your system's Python environment, both pip and easy_install give you the options to specify an alternative Python environment. This can be done either via virtualenv (recommended) or by setting the paths manually in case virtualenv is not available. If you aren’t already familiar with virtualenv, you may want to read up on it first.

$ virtualenv --no-site-package $HOME/mypython_repo/
$ . $HOME/mypython_repo/bin/activate
$ pip install bliss   

Without virtualenv, you have to manage your paths manually:

$ mkdir -p $HOME/mypython_repo/lib/python2.7/site-packages/
PYTHONPATH=$HOME/mypython_repo/lib/python2.7/site-packages/ pip install \
  --install-option="--prefix=$HOME/mypython_repo"

or with easy_install:

$ PYTHONPATH=$HOME/mypython_repo/lib/python2.7/site-packages/ easy_install \
  --prefix=$HOME/mypython_repo bliss

Help! My System Doesn't Come With easy_install

Ah, we've heard that one before. Presumably, you're trying to install Bliss on a machine that doesn't have virtualenv, easy_install or pip installed and you don't have root access to install it yourself.

Here's a simple workaround for that using the 'instant' version of virtualenv:

$ curl -s https://raw.github.com/pypa/virtualenv/master/virtualenv.py | python - $HOME/mypython_repo
$ . $HOME/mypython_repo/bin/activate
$ pip install bliss   

Installation Options

TODO

Latest Development Version

The latest development version of Bliss can be highly unstable or even completely broken. Don't blame us. We have warned you!

You can install the latest development version of Bliss directly from our Git repository using pip:

$ pip install -e git://github.com/saga-project/bliss.git#egg=bliss