This page describes how to use supported libraries in the Google App Engine Python 2.7 runtime environment. By default, this runtime environment includes the Python standard library, the App Engine libraries, and a few bundled third- party packages. For a complete list of runtime-provided libraries, see the built-in third-party libraries reference.
You can add a third-party library to your app in one of two ways: requesting the library or installing the library.
Requesting a library
You can request a library by using the
libraries: directive in
libraries: - name: PIL version: "1.1.7" - name: webob version: "1.1.1"
- The library must be one of the supported runtime-provided third-party libraries.
- When deployed, App Engine will provide the requested libraries to the runtime environment.
- Some libraries must be installed locally.
Installing a library
You can install the library into a folder in your project's source directory. The library must be implemented as pure Python code with no C extensions. The code is uploaded to App Engine with your application code, and counts towards file quotas.
The easiest way to manage this is with a
Use pip to install the library and the vendor module to enable importing packages from the third-party library directory.
Create a directory named
libin your application root directory:
To tell your app how to find libraries in this directory, create or modify a file named
appengine_config.pyin the root of your project, then add these lines:
from google.appengine.ext import vendor # Add any libraries installed in the "lib" folder. vendor.add('lib')
-t libflag to install libraries in this directory:
pip install -t lib gcloud
appengine_config.py file above assumes that the current working
directory is where the
lib folder is located. In some cases, such as unit
tests, the current working directory can be different. To avoid errors, you
can explicity pass in the full path to the
lib folder using:
pip requirements files
pip can read a list of libraries to install from a file, known as a
requirements file. Requirements files make it easy to set up a new
development environment for your app, and upgrade to new versions of libraries.
A requirements file is a text file with one line per library, listing the package name and version:
Flask==0.10 Markdown==2.5.2 google-api-python-client
To install the libraries from a requirements file, use the
-r flag in addition
-t lib flag:
pip install -t lib -r requirements.txt
Using libraries with the local development server
While several of the runtime-provided libraries are available to your local development environment through the App Engine SDK, the following libraries are platform-dependent and must be installed locally before you can use them with the development server:
sudo pip install lxml==2.3.5
Depending on your platform, you might need to install build support tools and Python sources to install these libraries.
- On Linux, the package manager can provide these prerequisites and can often provide a pre-built version of the library.
- On Windows, installers for pre-built versions are usually available. *On OS X, the Xcode Command Line Tools are required to build some packages.
Using Django or
This section provides information you should know when using the Django or
Django is a full-featured web application framework for Python. It provides a full stack of interchangable components, including dispatch, views, middleware, and templating components, and many others.
The Django data modeling interface is not compatible with the App Engine datastore. You can use the App Engine data modeling libraries (db or ndb) in your Django applications. However, third-party Django applications that use the Django data modeling interface, most notably Django's Admin application, might not directly work with App Engine.
The Datastore modeling library (DB) is the default. To use Django with the
NDB storage API instead, add
MIDDLEWARE_CLASSES entry in your Django
It's a good idea to insert it in front of any other middleware classes,
since some other middleware might make datastore calls and those won't be
handled properly if that middleware is invoked before this middleware.
You can learn more about Django middleware in the
To enable Django in your app, specify the WSGI application and Django library in
... handlers: - url: /.* script: main.app # a WSGI application in the main module's global scope libraries: - name: django version: "1.4"
DJANGO_SETTINGS_MODULE environment variable must be set to the name of
your Django settings module, typically
'settings', before packages are
If your Django settings module is something other than
settings.py, set the
DJANGO_SETTINGS_MODULE environment variable accordingly either in your
env_variables: DJANGO_SETTINGS_MODULE: 'myapp.settings'
Or in your Python code:
import os # specify the name of your settings module os.environ['DJANGO_SETTINGS_MODULE'] = 'myapp.settings' import django.core.handlers.wsgi app = django.core.handlers.wsgi.WSGIHandler()
Matplotlib is a plotting library
that produces graphs and figures in a variety of image formats. On App Engine,
the interactive modes of matplotlib are not supported, and a number of other
features are also unavailable. This means you cannot use
as many matplotlib tutorials suggest. Instead, you should use
to write image data to theoutput stream, a
instance, or the Google Cloud Storage using the
Cloud Storage Client Library.
through the use of the
matplotlibrc configuration file, which should be placed
in the application's top-level directory. Alternatively, you can set the
MATPLOTLIBRC environment variable to a path relative to your application's
is AGG, which allows writing files of all supported formats: PNG (the default
format), RAW, PS, PDF, SVG and SVGZ. If you make the PIL library available by
PIL to the
libraries section of
app.yaml, then the AGG backend will
automatically support writing JPEG and TIFF image formats as well.
Matplotlib comes with a number of fonts which are automatically available. You
can use custom fonts by uploading them in TTF format along with your
application, and setting the
TTFPATH environment variable to the path where
they are located, relative to your application's directory. For more information,
A number of matplotlib features are not supported on App Engine. In particular:
- There is no
~/.matplotlibdirectory. However, there are alternative locations to place the
matplotlibrcconfiguration file, as described above.
- Interactive backends and GUI elements are not supported.
- The EMF, Cairo and GDK backends are not supported.
- There is no caching, and therefore a number of mechanisms will re-calculate or
re-download data that would normally be cached. Specific caching mechanisms that
have been disabled include font data calculated by
matplotlib.font_manager.FontManager.findfont, sample data downloaded by
matplotlib.cbook.get_sample_dataand financial data downloaded by
- Because there is no caching, it is not possible to call
examples.downloadis set to
- Because there is no caching, it is not possible to call
- All features that invoke external commands have been disabled.
- Use of
fontconfighas been disabled. Fonts are found through the mechanism described above.
- Use of LaTeX for text rendering is not supported. Setting
Truewill not work.
- Use of an external PostScript distiller program is not supported. Setting
xpdfwill not work.
- Use of an external video encoding program is not supported. The
matplotlib.animation.Animation.savemethod will not work, and therefore, the
matplotlib.animationpackage is not useful.
matplotlib.cbook.MemoryMonitorclass are not supported.
- Use of
matplotlib.testfunction has been disabled.