---
id: pyramid-debugtoolbar
version: "4.12.1"
license: BSD
license_treatment: permissive
maintenance: dormant
---

# pyramid-debugtoolbar — A package which provides an interactive HTML debugger for Pyramid application development

License: permissive · Maintenance: dormant · Downloads: 2.0M/mo

## What it is and what it does

Pyramid_debugtoolbar is a development-time debugging extension for Pyramid web applications that injects an interactive toolbar into HTML responses. It displays detailed information about each HTTP request, including route matching, request variables, response headers, SQL queries (with timing), logging output, and performance metrics. The toolbar is modeled after similar tools in Flask and Django ecosystems and includes a Werkzeug-derived interactive debugger for exception inspection.

The package depends on Pyramid, pyramid-mako for templating, Pygments for syntax highlighting, and importlib-metadata for compatibility. It's designed to be included in your Pyramid configuration during development and disabled in production. Recent versions added session tracking, improved SQLAlchemy 2.x support, and fixed issues with long-running requests and sensitive request attribute access.

Use it for:

- Inspect HTTP request/response details and route matching during Pyramid app development without adding print statements.
- Profile SQL query execution and timing to identify N+1 queries and database bottlenecks in your application.
- Track session and cookie changes across a request lifecycle to debug authentication and state management issues.
- View application logs and their severity levels inline with request context to correlate errors with specific requests.
- Interactively debug exceptions with a Werkzeug-powered debugger showing stack traces and local variable inspection.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Pyramid_debugtoolbar injects an interactive HTML debug toolbar into your Pyramid web application during development, showing request details, SQL queries, logging, and performance metrics.

Yes, if you are actively developing a Pyramid application. The toolbar is a standard development utility that provides real-time visibility into request handling, database queries, and logging. Install it as a development dependency only; dormant maintenance is not a concern for a stable, mature tool used only during development. No known vulnerabilities.

## Install

pip install pyramid-debugtoolbar
uv add pyramid-debugtoolbar
poetry add pyramid-debugtoolbar

## Installing pyramid-debugtoolbar

Before you install: Low install friction with a pure-Python wheel. Dormant maintenance status (921 days since last release) but no recent vulnerabilities; last release was 2024-02-05 and supports current Python versions through 3.12.

License in practice: BSD license (permissive); you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.

Quickstart:

pip install pyramid-debugtoolbar

In your Pyramid app configuration:
from pyramid.config import Configurator
config = Configurator()
config.include('pyramid_debugtoolbar')
app = config.make_wsgi_app()

Requires Pyramid application; toolbar only functions in development mode and injects HTML into responses.

Verify before relying:

- Whether dormant maintenance status affects compatibility with future Pyramid releases beyond 3.12.
- Performance overhead of toolbar injection on large response bodies or high-traffic development servers.

## Package facts

- License: BSD (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 2.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pyramid debug toolbar, web app debugging panel, request inspection tool, sql query profiling, wsgi application debugger, pyramid development tools, http request tracking, pyramid-framework, development-debugging, wsgi-middleware

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