streamlit-avatar

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 on this page — 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

streamlit-avatar on PyPI

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

Evidence: streamlit_avatar-0.1.3-py3-none-any.whl

Tags

More Application Frameworks packages