Installing from PIP

You can also install HoverPy from PIP:

$ pip install hoverpy


$ git clone
$ cd hoverpy
$ virtualenv .venv
$ source .venv/bin/activate
$ python install

This installs hoverpy and its requirements in your .venv folder; make sure to pull often, and run the python install when you do.


Please make sure everything is working before proceeding to the next steps.

$ python test

You should get a series of OKs.


testModify (hoverpy.tests.modify.testModify.TestModify) ... ok
testTemplate (hoverpy.tests.templates.testTemplates.TestTemplates) ... ok
testCapture (hoverpy.tests.testVirtualisation.TestVirt) ... ok
testPlayback (hoverpy.tests.testVirtualisation.TestVirt) ... ok

Running the examples

$ ls examples/*
$ basic       delays      modify      readthedocs tornado     unittesting urllib2eg   urllib3eg

Please note we’ll cover the examples in the usage page. But for the truly impatient, you can try running the most basic example, just to make sure everything’s working at this point.

$ python examples/basic/

Hoverfly binary

Please note that when you install HoverPy, the Hoverfly binaries get downloaded and installed in your home directory, in