Fork me on GitHub


Python bindings for the Gravatar API


Alek Storm (


To install, run:

pip install py-gravatar
You can download the source code in either zip or tar formats, or browse it online at its GitHub page.

You can also clone the project with Git by running:

$ git clone git://

Getting Started

To verify that the library is working and can connect to the server, run:

>>> import gravatar
>>> user = gravatar.User(<email>, password=<password>) # substitute the email address and password of a Gravatar account
>>> user.test()
1315290974 # however many seconds have passed since 1970


Full API documentation is available here.

The underlying XML-RPC API specification is also available here.