---
id: pyramid
version: "2.1"
license: LicenseRef-Repoze-BSD-derived
license_treatment: permissive
maintenance: active
---

# pyramid — The Pyramid Web Framework, a Pylons project

License: permissive · Maintenance: active · Downloads: 2.5M/mo

## What it is and what it does

Pyramid is a small, down-to-earth Python web framework built on WSGI for constructing real-world web applications. It provides core routing, view configuration, and request/response handling through a Configurator API, letting developers define routes and map them to view functions with minimal ceremony. The framework depends on webob for HTTP abstractions, venusian for decorator-driven configuration, plaster for configuration file parsing, and zope.interface for component architecture—a focused set of dependencies that keeps the core lightweight while enabling extensibility through add-ons.

The framework is mature and actively maintained, supporting modern Python versions including 3.10 through 3.14 and PyPy. It is positioned as an alternative to larger frameworks, emphasizing predictability and productivity for developers who want control over their application structure without excessive convention-driven magic.

Use it for:

- Build small to medium-sized web applications where explicit routing and view configuration are preferred over convention-heavy frameworks.
- Create RESTful APIs using WSGI-compatible deployment with fine-grained control over request handling and response serialization.
- Develop web services that integrate with existing WSGI middleware and deployment infrastructure.
- Prototype web applications quickly using Pyramid's minimal boilerplate and straightforward Configurator API.

## Worth the install?

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

Pyramid is a Python web framework for building WSGI applications, handling HTTP routing, request/response handling, and view configuration with minimal boilerplate.

Yes. Pyramid is a mature, actively maintained framework with low install friction, permissive licensing, and no known vulnerabilities. It is suitable for developers building WSGI applications who value explicit configuration and a focused dependency set. Choose it if you prefer clarity and control over convention-driven frameworks.

## Install

pip install pyramid
uv add pyramid
poetry add pyramid

## Installing pyramid

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with recent commits and a mature codebase; supports current Python versions (3.10–3.14) and PyPy.

License in practice: Licensed under a permissive Repoze BSD-derived license, allowing commercial and private use with minimal restrictions.

Quickstart:

pip install pyramid

from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response

def hello_world(request):
    return Response('Hello World!')

with Configurator() as config:
    config.add_route('hello', '/')
    config.add_view(hello_world, route_name='hello')
    app = config.make_wsgi_app()
server = make_server('0.0.0.0', 6543, app)
server.serve_forever()

Requires Python 3.10 or later.

Verify before relying:

- Specific performance characteristics or scalability limits compared to other frameworks.
- Ecosystem maturity and availability of third-party add-ons beyond what is documented.

## Package facts

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

## Tags

python web framework, wsgi application framework, lightweight web development, http routing and views, pyramid web framework, request response handling, web application routing, web-framework, wsgi

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