pail – Python Adaptive Images Library

pail is a WSGI middleware providing Adaptive Images. Delivering small images to small devices.

It detects your visitor’s screen size and automatically creates, and delivers device appropriate re-scaled versions of your web page’s embeded HTML images. No (major) mark-up changes needed. It is intended for use with Responsive Designs and to be combined with Fluid Image techniques.

This package is based on the ideas of Matt Wilcox and (more loosely) on his PHP script for the same purpose. Matt is in no way to blame for any shortcomings of this Python port.

pail provides special support for use with Paste.

Please note, that this package is still in a very early state and changes, also to the API, are likely to happen in near future.

Comments and patches are welcome. Please send these to uli at gnufix dot de.


The package can be installed by:

$ pip install pail

Afterwards you should be able to use pail in any WSGI environment. See the documentation for details.


Adapting Images base idea: Matt Wilcox

Created by Uli Fouquet

Indices and tables


Copyright 2013 Uli Fouquet

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see <>.


0.2 (2013-05-17)

  • Add very plain mobile detection. Now, if no device width is given (via cookie) detected mobile devices get images with the smallest predefined resolution while non-mobile devices get the images with the largest predefined resolution.
  • Removed zc.buildout stuff (we do not need it).

0.1 (2013-05-07)

  • First implementation based on Matt Wilcox’ PHP script.

Project Versions

Table Of Contents

Next topic

How it works

This Page