For the latest version of boto, see https://github.com/boto/boto3 -- Python interface to Amazon Web Services
This package is no longer maintained and has been replaced by
Boto3. Issues and pull requests are not reviewed. If you are having an issue with the
Boto3package or the
AWS CLI__, please open an issue on their respective repositories.
.. image:: https://pypip.in/d/boto/badge.svg :target: https://pypi.python.org/pypi/boto/
Boto is a Python package that provides interfaces to Amazon Web Services. Currently, all features work with Python 2.6 and 2.7. Work is under way to support Python 3.3+ in the same codebase. Modules are being ported one at a time with the help of the open source community, so please check below for compatibility with Python 3.3+.
To port a module to Python 3.3+, please view our
Contributing Guidelines_ and the
Porting Guide_. If you would like, you can open an issue to let others know about your work in progress. Tests must pass on Python 2.6, 2.7, 3.3, and 3.4 for pull requests to be accepted.
At the moment, boto supports:
Deployment and Management
Administration & Security
Payments and Billing
The goal of boto is to support the full breadth and depth of Amazon Web Services. In addition, boto provides support for other public services such as Google Storage in addition to private cloud systems like Eucalyptus, OpenStack and Open Nebula.
Boto is developed mainly using Python 2.6.6 and Python 2.7.3 on Mac OSX and Ubuntu Maverick. It is known to work on other Linux distributions and on Windows. Most of Boto requires no additional libraries or packages other than those that are distributed with Python. Efforts are made to keep boto compatible with Python 2.5.x but no guarantees are made.
$ pip install boto
Install from source:
$ git clone git://github.com/boto/boto.git $ cd boto $ python setup.py install
To see what has changed over time in boto, you can check out the release notes at
Finding Out More About Boto
The main source code repository for boto can be found on
github.com. The boto project uses the
gitflowmodel for branching.
Online documentation_ is also available. The online documentation includes full API documentation as well as Getting Started Guides for many of the boto modules.
Boto releases can be found on the
Python Cheese Shop_.
Join our IRC channel
#botoon FreeNode. Webchat IRC channel: http://webchat.freenode.net/?channels=boto
boto-users Google Group_.
Getting Started with Boto
Your credentials can be passed into the methods that create connections. Alternatively, boto will check for the existence of the following environment variables to ascertain your credentials:
AWSACCESSKEY_ID - Your AWS Access Key ID
AWSSECRETACCESS_KEY - Your AWS Secret Access Key
Credentials and other boto-related settings can also be stored in a boto config file. See
this_ for details.
.. Contributing Guidelines: https://github.com/boto/boto/blob/develop/CONTRIBUTING .. _Porting Guide: http://boto.readthedocs.org/en/latest/portingguide.html .. pip: http://www.pip-installer.org/ .. _release notes: https://github.com/boto/boto/wiki .. _github.com: http://github.com/boto/boto .. _Online documentation: http://docs.pythonboto.org .. _Python Cheese Shop: http://pypi.python.org/pypi/boto .. _this: http://docs.pythonboto.org/en/latest/botoconfig_tut.html .. _gitflow: http://nvie.com/posts/a-successful-git-branching-model/ .. _neo: https://github.com/boto/boto/tree/neo .. _boto-users Google Group: https://groups.google.com/forum/?fromgroups#!forum/boto-users