streamlit-image-coordinates

What it is and what it does

Streamlit-Image-Coordinates is a custom Streamlit component that embeds an interactive image viewer in a Streamlit app. When a user clicks on the displayed image, the component captures and returns the pixel coordinates of the click along with the Unix timestamp of when the click occurred. This is useful for building interactive image annotation, selection, or analysis tools within Streamlit applications.

The package wraps a single runtime dependency on streamlit and is designed to integrate seamlessly into Streamlit workflows. It supports modern Python versions (3.10 through 3.13) and has been actively maintained. The component is distributed as a pure Python wheel with no compiled dependencies, making installation straightforward across platforms.

Use it for:

• Build an image annotation tool where users click to mark regions of interest and capture their pixel locations.
• Create an interactive image explorer that logs where users click to identify areas of attention.
• Develop a data labeling interface that records pixel coordinates for training computer vision models.
• Implement a point-and-click interface for selecting features or objects within an image for further analysis.
• Track user interaction patterns by recording click coordinates and timestamps on reference images.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Streamlit component that displays an image and captures pixel coordinates when clicked, returning both the x,y position and the click timestamp in Unix format.

Yes. The package is actively maintained, has no known vulnerabilities, carries a permissive MIT license, and solves a specific gap in Streamlit's built-in components. Install friction is minimal. It is worth adding if you need interactive image coordinate capture in a Streamlit app; skip it if your workflow does not require click-based image interaction.

Install

streamlit-image-coordinates on PyPI

pip install streamlit-image-coordinates

uv add streamlit-image-coordinates

poetry add streamlit-image-coordinates

Installing streamlit-image-coordinates

Before you install

Low friction install with a single runtime dependency on streamlit. Actively maintained as of the latest release.

License in practice

MIT License permits unrestricted use, modification, and distribution with only the requirement to include the license notice and copyright.

Quickstart

pip install streamlit-image-coordinates

import streamlit as st
from streamlit_image_coordinates import streamlit_image_coordinates

value = streamlit_image_coordinates("https://placekitten.com/200/300")
st.write(value)

Requires Python 3.10 or later and a working Streamlit environment.

Verify before relying

• Whether the component works with local file paths in addition to URLs
• What data structure the returned value contains beyond coordinates and timestamp
• Whether the component supports image scaling or zoom interactions
• Performance characteristics with large images or rapid clicks

Package facts

Evidence: streamlit_image_coordinates-0.4.1-py3-none-any.whl

Keywords: python, streamlit, images, component, streamlit-component

Tags

More Python Modules packages