# lavatar

**Repository Path**: mirrors_KDAB/lavatar

## Basic Information

- **Project Name**: lavatar
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-12-03
- **Last Updated**: 2026-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Lavatar
=======

Lavatar is an LDAP-backend avatar server with `Gravatar <https://secure.gravatar.com/site/implement>`_ like URL support.

Lavatar fetches all email addresses from an LDAP server with a given search filter and stores them with their md5hash on Redis. Per defualt Lavatar also use Redis to cache the avatar images.

For now lavatar only support image requests.

Quick start
-----------

You can use the docker container image and the docker-compose example to test this app:

.. code-block:: shell

    wget https://raw.githubusercontent.com/rroemhild/lavatar/master/docker-compose.yml
    docker-compose up

and test in browser: http://localhost:5000/avatar/982391f62e589420d9fdb56a62c5e16c

Install
-------

.. code-block:: shell

    git clone https://github.com/rroemhild/lavatar.git
    cd lavatar
    pip install -r requirements.txt gevent
    cp lavatar/default_settings.py settings.py

Configure lavatar in settings.py and run ``python production.py`` example.

Image Request
-------------

The default image size for the base request is 80x80, max size limit is 1024x1024.

.. code-block:: shell

    http://localhost:5000/avatar/HASH

Set ``s`` or ``size`` to scale the avatar image

.. code-block:: shell

    http://localhost:5000/avatar/HASH?s=160

Set ``d`` or ``default`` for the default image available in ``static/img``.

.. code-block:: shell

    http://localhost:5000/avatar/HASH?d=keyword

Set ``m`` or ``method`` to resize Image with the specified method: 'crop', 'cover', 'contain', 'width', 'height' or 'thumbnail'. Default is ``thumbnail``

.. code-block:: shell

    http://localhost:5000/avatar/HASH?s=120&m=cover

Set ``w`` or ``width`` to resize width and ``h`` or ``height`` to resize height.

.. code-block:: shell

    http://localhost:5000/avatar/HASH?h=120&m=height