---
id: aiohttp-debugtoolbar
version: "0.6.1"
license: Apache 2
license_treatment: permissive
maintenance: active
---

# aiohttp-debugtoolbar — debugtoolbar for aiohttp

License: permissive · Maintenance: active · Downloads: 97.1K/mo

## 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 above — 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

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

- License: Apache 2 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 97.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aiohttp debug toolbar, web app debugging middleware, async request inspection, aiohttp performance profiling, interactive console for aiohttp, exception traceback viewer, aiohttp request history, debugging, aiohttp-middleware, development-tools

[View on SkillFed](https://skillfed.io/packages/aiohttp-debugtoolbar) · [View on PyPI](https://pypi.org/project/aiohttp-debugtoolbar/)