aiohttp-debugtoolbar

What it is and what it does

aiohttp-debugtoolbar is a development middleware that injects an interactive debug toolbar into aiohttp web applications. It provides panels for inspecting HTTP headers, application settings, middleware stack, routes, request variables, and logging output. The toolbar also intercepts exceptions to display formatted tracebacks with source code context, intercepts redirects to show intermediate pages, and includes an interactive Python console for runtime inspection.

The package is a port of pyramid_debugtoolbar adapted for async/await patterns. It requires aiohttp and aiohttp-jinja2 as runtime dependencies and is configured by calling setup() on your application instance. Configuration options control which hosts can access the toolbar, request history limits, and the toolbar's URL path prefix.

Use it for:

• Inspect HTTP request/response headers and middleware execution order during development
• Debug exceptions with formatted tracebacks, source code display, and interactive console access
• Profile request performance and identify slow handlers or middleware
• Monitor application settings, routes, and request variables in real time
• Trace redirect chains by intercepting and displaying intermediate redirect pages

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adds an interactive debug toolbar to aiohttp web applications, displaying request headers, performance metrics, tracebacks, middleware info, and an interactive Python console.

Yes, for development environments. Low install friction, active maintenance through 2026, no known vulnerabilities, and permissive licensing. Useful for debugging aiohttp applications but intended only for development—disable in production via the enabled flag or host restrictions.

Install

aiohttp-debugtoolbar on PyPI

pip install aiohttp-debugtoolbar

uv add aiohttp-debugtoolbar

poetry add aiohttp-debugtoolbar

Installing aiohttp-debugtoolbar

Before you install

Low friction install with only two runtime dependencies (aiohttp and aiohttp-jinja2). Actively maintained as of May 2026 with recent updates for aiohttp 3.9 compatibility and Python 3.11 support.

License in practice

Apache 2 permissive license allows use in commercial and open-source projects with minimal restrictions.

Quickstart

pip install aiohttp-debugtoolbar

import aiohttp_debugtoolbar
from aiohttp import web

app = web.Application()
aiohttp_debugtoolbar.setup(app)
# app now has debug toolbar middleware attached

Verify before relying

• Whether the toolbar works with aiohttp versions prior to 3.3 (changelog indicates 3.3+ only, but requires_python is unspecified)

Package facts

Evidence: aiohttp_debugtoolbar-0.6.1-py3-none-any.whl

Tags

More WWW/HTTP packages