Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Generates default avatars from a given string (such as username).

Project Description

# Avatar Generator

Generates default avatars from a given string (such as username). This is mainly for an usage in web apps, but you can olso use it to populate LDAP "jpegPhoto" field, for instance.

This is largely inspired by [Richard O'Dwyer's randomavatar](

![](examples/photo3.png "")
![](examples/photo2.png "")
![](examples/photo1.png "")

## Installation

pip install avatar-generator

## Example in a Flask app

from avatar_generator import Avatar
from flask import make_response

def photo():
avatar = Avatar.generate(128, "", "PNG")
headers = { 'Content-Type': 'image/png' }
return make_response(avatar, 200, headers)

## Licence

This code is under [WTFPL]( Just do what the fuck you want with it.

Release History

This version
History Node


History Node


History Node


Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate