Skip to main content

Avatar picker and uploader for

Project description


Python avatar picker and uploader for

Current version of **avatarsio** is **0.1**; it's stable.

Requirements, dependencies

`avatarsio` supports both Python 2 and Python 3 and is on

As described in `requirements.txt`, the only dependency is
[`requests`]( (HTTP for humans, because, well,
it is awesome and should be built-in).

You can install it from source or using `pip` (eg. in a virtualenv):

pip install avatarsio


You don't really need the lib if you just want to get user avatars from
services such as Twitter of Facebook. Just use the corresponding URL as
explained on [](

The lib is useful for custom avatar upload. You need first to
[register an app]( on Chute. Then, it's quite

>>> from avatarsio import AvatarsIO
>>> avtio = AvatarsIO('my-client-id', 'my-access-token')

# With a file name:
>>> avtio.upload('kitten.png')

# With a file object:
>>> fobj = open('kitten.png', 'rb')
>>> avtio.upload(fobj)

# You can give a custom identifer:
>>> avtio.upload('kitten.png', 'my-identifier')

# And obviously, build sersvice avatar URLs:
# (but sersiouly, you don't need the lib for that)
>>> AvatarsIO.avatar_url('twitter', 'my-identifier')


Extra stuff
Feel free to submit bug reports and improvements on the
[bug tracker](

Project details

Release history Release notifications | RSS feed

This version


Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page