Edit me on GitHub

The Pylons Project

The Pylons Project maintains the Pyramid web framework as well as additional packages intended for use with Pyramid. Documentation for all of these projects is collected under the Pylons Project.

Project Documentation Index

Documentation of projects under the Pylons Project are listed below.


Development questions related to projects under the Pylons Project can be discussed on the pylons-discuss mail list.

On IRC, developers are generally available on the #pylons channel on the Freenode IRC Network. Each project may have its own channel, too.

Using Support Wisely

Before asking a technical question on the mail list(s) or in IRC, please make sure to try the following things (paraphrased from Before You Ask):

  • Try to find an answer by reading the manual.
  • Try to find an answer by searching the mail list archives.
  • Try to find an answer by searching the Web.
  • Try to find an answer by inspection or experimentation.
  • If you’re a programmer, try to find an answer by reading the source code.

After exhausting these avenues, it’s completely appropriate to ask a question on the Pylons-discuss mail list or #pylons IRC channel. When you ask your question, please describe what you’ve learned from the efforts above, as it will help the developers focus on answering your question quickly. It also helps tremendously if you are able to provide a code or configuration snippet that makes the problem easily repeatable.


For Pylons users coming from Pylons 1 or repoze.bfg, the change to a new core package might raise some questions regarding how to proceed and what it means for existing applications.


Pylons Podcasts are a series of audio podcasts from developers of the Pylons Project. You can either subscribe in iTunes or Rhythmbox (or your favorite audio client) using the Feed URL below, or listen to individual podcasts.

Feed URL (RSS/iTunes)


To promote the Pylons Project and its related technologies, or your own work made with our tools, we provide logos, badges, and desktop wallpapers.


The Pylons Project welcomes contributors. Please read the following documentation about how the Pylons Project functions, coding styles expected for contributions, and the community standards we expect everyone to abide by.


Don’t worry, none of these are actually true. We swear!

Table Of Contents

Next topic

Pyramid Documentation