Installation¶
Environment¶
When installing software, you typically have two choices: install as root, or install as user in your own user space. You may only have one choice if you don’t have root privileges on your machine.
If you want to install humanbingo
in the system’s executable domain,
you will probably need to preface any command below with sudo
.
If you already know what that means, proceed with caution. If you don’t,
consider one of the alternatives, which are designed to prevent you from
wrecking your system unintentionally.
To install in user space, you will need to add --user
to the
installation commands. The install scripts will put the files in the
places within your user directory that will automatically be searched.
But humanbingo
relies on other python packages to run correctly.
Installing humanbingo
will automatically download and install those
packages as well. This can be trouble if you have other versions of
those packages already installed, and different modules require different
versions.
So as an alternative, python has virtual environments. This is a way to set up a complete python sandbox with packages and executables. Here is how to do that.
You should have a virtualenv
executable on your system. Run
it and give it the name of a directory, in which the environment will
reside:
$ virtualenv ~/Library/virtualenv/humanbingo
or, from another unix:
$ virtualenv ~/lib/virtualenv/humanbingo
Not sure of the best place for Windows. This will give you a shiny new python installation that is independent from any others on your machine. To activate it, change into the directory specified above and run:
$ source bin/activate
(humanbingo)$ which python
...
Notice how the prompt changes to indicate the active virtual environment.
Your which
command should return the directory of your virtual
environment, with bin/python
attached.
You can learn more about this from the Virtualenv user guide. Trust me, it’s worth it.
Stable release¶
To install Human Bingo, run this command in your terminal:
$ pip install humanbingo
Along with using a virtual environment as above, is the preferred method to install Human Bingo, as it will always install the most recent stable release.
If you don’t have pip installed, this Python installation guide can guide you through the process.
From sources¶
The sources for Human Bingo can be downloaded from the Github repo.
You can either clone the public repository:
$ git clone git://github.com/leingang/humanbingo
Or download the tarball:
$ curl -OL https://github.com/leingang/humanbingo/tarball/master
Once you have a copy of the source, you can install it with:
$ python setup.py install