git clone

If you don't have pip already installed, follow the instructions on the pip installation page before running the command below.

Depending on the environment, you may need to run 'sudo pip install boto', if the following command doesn't work due to insufficient permissions.

pip install boto

Create your credentials file at ~/.aws/credentials (C:\Users\USER_NAME\.aws\credentials for Windows users) and save the following lines after replacing the underlined values with your own.


aws_access_key_id = YOUR_ACCESS_KEY_ID

aws_secret_access_key = YOUR_SECRET_ACCESS_KEY

cd aws-python-sample


This sample application is designed to show you how to:

  • Install the AWS SDK for Python using pip.
  • Read access keys from ~/.aws/credentials.
  • Instantiate an Amazon Simple Storage Service (Amazon S3) client.
  • Interact with Amazon S3 in various ways, such as creating a bucket and uploading a file.

The project's README file contains more information about this sample code. If you have trouble getting set up or have other feedback about this sample, let us know on GitHub.

For in-depth user guides, API documentation, developer forums, and other developer resources, see the AWS SDK for Python page.