AWS Encryption SDK
Developer Guide

AWS Encryption SDK for Python

This topic explains how to install and use the AWS Encryption SDK for Python. For details about programming with the SDK, see the aws-encryption-sdk-python repository on GitHub and the Python documentation for the AWS Encryption SDK for Python.


Before you install the AWS Encryption SDK for Python, be sure you have the following prerequisites.

A supported version of Python

To use this SDK, you need Python 2.7, or Python 3.3 or later. To download Python, see Python downloads.

The pip installation tool for Python

If you have Python 2.7.9 or later, or Python 3.4 or later, you already have pip, though you might want to upgrade it. For more information about upgrading or installing pip, see Installation in the pip documentation.


Use pip to install the AWS Encryption SDK for Python, as shown in the following examples.

To install the latest version
pip install aws-encryption-sdk
To install a specific version

The following example installs version 1.2.0.

pip install aws-encryption-sdk=1.2.0

When you use pip to install the SDK on Linux, pip builds the cryptography library, one of the SDK's dependencies. If your Linux environment doesn't have the tools needed to build the cryptography library, you must install them. For more information, see Building cryptography on Linux.

For the latest development version of this SDK, go to the aws-encryption-sdk-python GitHub repository.

After you install the SDK, get started by looking at the example Python code in this guide.

On this page: