Skip to content
oweidner edited this page Oct 29, 2011 · 36 revisions

#Installation# Requirements:

  • Python 2.4 or newer

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.

$ 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 Sucks

Ah, we've heard that one before. Presumably, you're trying to install Bliss on a multimillion-$$ cluster somewhere within FutureGrid, XSEDE or EGI that doesn't have virtualenv, easy_install or pip installed. Don't worry - we've got you covered!

Here's a simple bootstrapping script that can set up everything you need in user space. The following command downloads and installs virtualenv, pip and bliss for you in your home directory - regardless how crappy your environment might be (you will still need at least Python 2.4, though):

curl -fsSLk https://raw.github.com/gist/1321016 > pystrap.sh && /bin/sh pystrap.sh -l 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/oweidner/bliss.git#egg=bliss