Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
204 lines (151 sloc) 5.38 KB

The Pyramid Web Application Development Framework

:app:`Pyramid` is a small, fast, down-to-earth Python web application development framework. It is developed as part of the Pylons Project. It is licensed under a BSD-like license.


Pyramid is the latest iteration of the web framework previously known as :mod:`repoze.bfg`.

Front Matter

Narrative documentation

Narrative documentation in chapter form explaining how to use :app:`Pyramid`.


Detailed tutorials explaining how to use :app:`Pyramid` to build various types of applications and how to deploy :app:`Pyramid` applications to various platforms.

Reference Material

Reference material includes documentation for every :app:`Pyramid` API.

Detailed Change History

Design Documentation

Sample Applications

cluegun is a simple pastebin application based on Rocky Burt's ClueBin. It demonstrates form processing, security, and the use of :term:`ZODB` within a :app:`Pyramid` application. Check this application out via:

git clone git://

virginia is a very simple dynamic file rendering application. It is willing to render structured text documents, HTML documents, and images from a filesystem directory. An earlier version of this application runs the website. Check this application out via:

git clone git://

shootout is an example "idea competition" application by Carlos de la Guardia. It demonstrates a hybrid of :term:`URL dispatch` and :term:`traversal` and integration with SQLAlchemy, :term:`repoze.who`, and Deliverance. Check this application out of version control via:

git clone git://

Older Sample Applications (repoze.bfg)


These applications are for an older version of :app:`Pyramid`, which was named :mod:`repoze.bfg`. They won't work unmodified under Pyramid, but might provide useful clues.

bfgsite is the software which runs the website. It demonstrates integration with Trac, and includes several mini-applications such as a pastebin and tutorial engine. Check a buildout for this application out of Subversion via:

svn co bfgsite_buildout

KARL is a moderately-sized application (roughly 70K lines of Python code) built on top of :mod:`repoze.bfg` and other Repoze software. It is an open source web system for collaboration, organizational intranets, and knowledge management, It provides facilities for wikis, calendars, manuals, searching, tagging, commenting, and file uploads. See the KARL site for download and installation details.

Support and Development

The Pylons Project web site is the main online source of :app:`Pyramid` support and development information.

To report bugs, use the issue tracker.

If you've got questions that aren't answered by this documentation, contact the Pylons-devel maillist or join the #pylons IRC channel.

Browse and check out tagged and trunk versions of :app:`Pyramid` via the Pyramid GitHub repository. To check out the trunk via git, use this command:

git clone

To find out how to become a contributor to :app:`Pyramid`, please see the contributor's section of the documentation.

Index and Glossary

Jump to Line
Something went wrong with that request. Please try again.