Pillow is the "friendly" PIL fork. PIL is the Python Imaging Library. Pillow was started for and is currently maintained by the Plone community. But it is used by many other folks in the Python web community, and probably elsewhere too.
The fork author's goal is to foster packaging improvements via:
- Publicized development and solicitation of community support.
- Exploration of packaging problems within the fork, most noticably via adding setuptools support but also via clean up & refactoring of packaging code.
PIL is currently not setuptools compatible. Please see http://mail.python.org/pipermail/image-sig/2010-August/006480.html for a more detailed explanation. Also, PIL's current release/maintenance schedule is not compatible with the various & frequent packaging issues that have occured.
Please report any non-packaging related issues here first:
Then open a ticket here:
and provide a link to the first ticket so we can track the issue(s) upstream. This project does not aim to fix image code bugs, but if we can track them properly we may consider it. (And the image code could potentially be wholesale replaced when the next PIL release comes out.)
The API documentation included with PIL has been converted (from HTML) to reStructured text (via pandoc) and is now hosted by readthedocs.org.
What follows is the original PIL README.
The Python Imaging Library (PIL) adds image processing capabilities to your Python environment. This library provides extensive file format support, an efficient internal representation, and powerful image processing capabilities.
This source kit has been built and tested with Python 2.0 and newer, on Windows, Mac OS X, and major Unix platforms. Large parts of the library also work on 1.5.2 and 1.6.
The main distribution site for this software is:
That site also contains information about free and commercial support options, PIL add-ons, answers to frequently asked questions, and more.
Development versions (alphas, betas) are available here:
The PIL handbook is not included in this distribution; to get the latest version, check:
For installation and licensing details, see below.
Secret Labs (PythonWare) offers support contracts for companies using the Python Imaging Library in commercial applications, and in mission- critical environments. The support contract includes technical support, bug fixes, extensions to the PIL library, sample applications, and more.
For the full story, check:
For support and general questions on the Python Imaging Library, send e-mail to the Image SIG mailing list:
You can join the Image SIG by sending a mail to:
Put "subscribe" in the message body to automatically subscribe to the list, or "help" to get additional information. Alternatively, you can send your questions to the Python mailing list, firstname.lastname@example.org, or post them to the newsgroup comp.lang.python. DO NOT SEND SUPPORT QUESTIONS TO PYTHONWARE ADDRESSES.
The Python Imaging Library is
Copyright (c) 1997-2009 by Secret Labs AB Copyright (c) 1995-2009 by Fredrik Lundh
By obtaining, using, and/or copying this software and/or its associated documentation, you agree that you have read, understood, and will comply with the following terms and conditions:
Permission to use, copy, modify, and distribute this software and its associated documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appears in all copies, and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Secret Labs AB or the author not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission.
SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.