Werkzeug is a powerful WSGI utility library for Python. It includes an interactive debugger and feature-packed request and response objects.

This plugin integrates werkzeug.wrappers.Request and werkzeug.wrappers.Response as an alternative to the built-in implementations, adds support for werkzeug.exceptions and replaces the default error page with an interactive debugger.


Install with one of the following commands:

$ pip install bottle-werkzeug
$ easy_install bottle-werkzeug

or download the latest version from github:

$ git clone git://
$ cd bottle/plugins/werkzeug
$ python install


Once installed to an application, this plugin adds support for werkzeug.wrappers.Response, all kinds of werkzeug.exceptions and provides a thread-local instance of werkzeug.wrappers.Request that is updated with each request. The plugin instance itself doubles as a werkzeug module object, so you don’t have to import werkzeug in your application. Here is an example:

import bottle
from bottle.ext import werkzeug

app = bottle.Bottle()
werkzeug = werkzeug.Plugin()

req = werkzeug.request # For the lazy.

def say_hello(name):
    greet = {'en':'Hello', 'de':'Hallo', 'fr':'Bonjour'}
    language = req.accept_languages.best_match(greet.keys())
    if language:
        return werkzeug.Response('%s %s!' % (greet[language], name))
        raise werkzeug.exceptions.NotAcceptable()

Using the Debugger

This plugin replaces the default error page with an advanced debugger. If you have the evalex feature enabled, you will get an interactive console that allows you to inspect the error context in the browser. Please read Debugging Applications with werkzeug before you enable this feature.


The following configuration options exist for the plugin class: