This guide describes how to install HappyBase.
On this page
The recommended way to install HappyBase and Thrift is to use a virtual environment created by virtualenv. Setup and activate a new virtual environment like this:
$ virtualenv envname $ source envname/bin/activate
If you use the virtualenvwrapper scripts, type this instead:
$ mkvirtualenv envname
The next step is to install HappyBase. The easiest way is to use pip to fetch the package from the Python Package Index (PyPI). This will also install the Thrift package for Python.
(envname) $ pip install happybase
Generating and installing the HBase Thrift Python modules (using
--gen py on the
.thrift file) is not necessary, since HappyBase
bundles pregenerated versions of those modules.
Verify that the packages are installed correctly:
(envname) $ python -c 'import happybase'
If you don't see any errors, the installation was successful. Congratulations!
Now that you successfully installed HappyBase on your machine, continue with the :doc:`user guide <user>` to learn how to use it.