The Pylons Project

The Pylons Project maintains the Pyramid web framework as well as additional packages intended for use with Pyramid.

Pylons Project Documentation

The following are documentation of projects under the Pylons Project.

Pyramid Documentation
Includes the official narrative documentation, API, and tutorials, as well as links to unofficial or community contributions to cookbook recipes, and sample Pyramid applications.
Extending Pyramid
A filterable list official add-ons (supported by the Pylons Project), popular add-ons from the community, and other web-related packages.
Pylons Project Library Package Documentation
A list of packages under the Pylons Project that are useful outside of Pyramid.
Pylons (the web framework) Documentation
Documentation of Pylons (the web framework).

For the most current list of all repositories and projects under the Pylons Project, visit the Pylons Project organization page on GitHub.


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!