Viverra is a fairly simple little collection of files, using only the Python 2.4 (and above) standard library, and doesn't require admin privileges or the compilation of C modules or anything remotely complicated. Simply place the viverra folder somewhere in your web application's module path (e.g. in the same folder), and you'll be able to import viverra in your code!

If you're setting Viverra up for use with a WSGI server solution, you'll need to point it at viverra.config.app to pick up the configured application (by default the Viverra core). Viverra also comes with it's own mod_python adapter, in viverra.server, and to enable this you will need to point mod_python at the Viverra code and tell it to use viverra.server.handler to handle requests. For instance, the following snippet of configuration (to be placed in the Apache configuration or in a .htaccess file) will do the trick:

<Location "/viverra/">
  SetHandler python-program                    # Tells Apache mod_python should handle things
  PythonDebug On                               # NOTE you may want to turn debugging off in production
  PythonPath "['/path/to/viverra'] + sys.path" # Ensure that Viverra is in mod_python's PATH
  PythonHandler viverra.server.handler         # Points mod_python at Viverra
  SetEnv VIVERRA_CONFIG_DIR  /path/to/config   # OPTIONAL: see configuration docs for details
</Location>

So far, Viverra has only been extensively tested with mod_python; apart from some development testing with CherryPy's server, it's untested on other server solutions. Please let me know if you do run it on something else!