jazzband/django-avatar

A Django app for handling user avatars.

Python

827

568 commits

updated Oct 12, 2026

See the code

README

=============
django-avatar
=============

.. image:: https://jazzband.co/static/img/badge.png
   :target: https://jazzband.co/
   :alt: Jazzband

.. image:: https://img.shields.io/pypi/pyversions/django-avatar.svg
   :target: https://pypi.org/project/django-avatar/
   :alt: Supported Python versions

.. image:: https://img.shields.io/pypi/djversions/django-avatar.svg
   :target: https://pypi.org/project/django-avatar/
   :alt: Supported Django versions

.. image:: https://github.com/jazzband/django-avatar/actions/workflows/test.yml/badge.svg
   :target: https://github.com/jazzband/django-avatar/actions/workflows/test.yml

.. image:: https://codecov.io/gh/jazzband/django-avatar/branch/main/graph/badge.svg?token=BO1e4kkgtq
   :target: https://codecov.io/gh/jazzband/django-avatar

.. image:: https://badge.fury.io/py/django-avatar.svg
    :target: https://badge.fury.io/py/django-avatar
    :alt: PyPI badge

.. image:: https://readthedocs.org/projects/django-avatar/badge/?version=latest
    :target: https://django-avatar.readthedocs.org/en/latest/?badge=latest
    :alt: Documentation Status

Django-avatar is a reusable application for handling user avatars.  It has the
ability to default to Gravatar if no avatar is found for a certain user.
Django-avatar automatically generates thumbnails and stores them to your default
file storage backend for retrieval later.

For more information see the documentation at https://django-avatar.readthedocs.org/

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

avatar
django
python

jazzband/django-avatar

A Django app for handling user avatars.

Python

827

568 commits

updated Oct 12, 2026

See the code

README

=============
django-avatar
=============

.. image:: https://jazzband.co/static/img/badge.png
   :target: https://jazzband.co/
   :alt: Jazzband

.. image:: https://img.shields.io/pypi/pyversions/django-avatar.svg
   :target: https://pypi.org/project/django-avatar/
   :alt: Supported Python versions

.. image:: https://img.shields.io/pypi/djversions/django-avatar.svg
   :target: https://pypi.org/project/django-avatar/
   :alt: Supported Django versions

.. image:: https://github.com/jazzband/django-avatar/actions/workflows/test.yml/badge.svg
   :target: https://github.com/jazzband/django-avatar/actions/workflows/test.yml

.. image:: https://codecov.io/gh/jazzband/django-avatar/branch/main/graph/badge.svg?token=BO1e4kkgtq
   :target: https://codecov.io/gh/jazzband/django-avatar

.. image:: https://badge.fury.io/py/django-avatar.svg
    :target: https://badge.fury.io/py/django-avatar
    :alt: PyPI badge

.. image:: https://readthedocs.org/projects/django-avatar/badge/?version=latest
    :target: https://django-avatar.readthedocs.org/en/latest/?badge=latest
    :alt: Documentation Status

Django-avatar is a reusable application for handling user avatars.  It has the
ability to default to Gravatar if no avatar is found for a certain user.
Django-avatar automatically generates thumbnails and stores them to your default
file storage backend for retrieval later.

For more information see the documentation at https://django-avatar.readthedocs.org/

Not written in Markdown, so it's shown here as plain text — view it formatted on GitHub.

avatar
django
python

Project health

Latest release

9.0.0 · Jan 7, 2026

Releases this year

1

Significant stargazers

Nicole Harris

284 followers · starred Jan 2015

Frank DiRocco

10 followers · starred Dec 2009

Snow Helsing

55 followers · starred Apr 2009