---
id: streamlit-avatar
version: "0.1.3"
license: unclear
license_treatment: unclear
maintenance: dormant
---

# streamlit-avatar — Component to display avatar icon in Streamlit

License: unclear · Maintenance: dormant · Downloads: 139.7K/mo

## What it is and what it does

streamlit-avatar is a Streamlit component that renders a set of clickable avatar icons, each with an image URL, size, title, and caption. When a user clicks an avatar, the component returns a dictionary containing the title, caption, and key of the selected avatar. It supports both remote image URLs and base64-encoded data URIs, making it useful for displaying user profiles or team member selections in Streamlit dashboards.

The package is lightweight and has only streamlit as a runtime dependency. However, it has been dormant since its initial release in June 2024 with minimal community engagement (2 repository stars), so it receives no active maintenance. The license is undeclared, creating uncertainty about legal use.

Use it for:

- Display a team member selector in a Streamlit dashboard where users pick a colleague to assign a task.
- Build a user profile gallery in a Streamlit app where clicking an avatar shows detailed user information.
- Create a chat or comment interface where avatars represent different participants and users select who is speaking.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Renders clickable avatar icons with images, titles, and captions in Streamlit applications, returning metadata about which avatar was selected.

Yes, if you need a quick avatar selector component for a Streamlit prototype or internal tool. Install friction is low and there are no known vulnerabilities. However, do not use in production without first clarifying the license (currently undeclared) and accepting that the package receives no maintenance—any bugs or Streamlit compatibility issues will not be fixed.

## Install

pip install streamlit-avatar
uv add streamlit-avatar
poetry add streamlit-avatar

## Installing streamlit-avatar

Before you install: Low friction install with a single runtime dependency on streamlit. Package is dormant since its June 2024 release, with minimal repository activity (2 stars), so expect no active maintenance or bug fixes.

License in practice: License status is unclear—no SPDX identifier or raw license text is declared. Before using in production, verify the actual license terms in the repository or contact the maintainer.

Quickstart:

pip install streamlit-avatar

import streamlit as st
from streamlit_avatar import avatar

result = avatar([
    {"url": "https://example.com/image.jpg", "size": 40, "title": "Sam", "caption": "hello", "key": "avatar1"}
])
st.write(result)

Requires streamlit to be installed and running; avatars are rendered only within a Streamlit app context.

Verify before relying:

- Whether the component works with current Streamlit versions (last tested June 2024).
- What the actual license is—none is declared in package metadata.
- Whether base64-encoded image URLs work reliably across all Streamlit deployments.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 139.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

streamlit avatar component, display user avatars streamlit, avatar icon widget, streamlit profile pictures, interactive avatar selector, streamlit-component, ui-widget

[View on SkillFed](https://skillfed.io/packages/streamlit-avatar) · [View on PyPI](https://pypi.org/project/streamlit-avatar/)