---
id: streamlit-image-coordinates
version: "0.4.1"
license: MIT License Copyright (c) 2022, Zachary Blackwood Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# streamlit-image-coordinates — Streamlit component that displays an image and returns the coordinates when you click on it

License: permissive · Maintenance: active · Downloads: 297.6K/mo

## 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 above — 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

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

- License: MIT License Copyright (c) 2022, Zachary Blackwood Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 297.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

streamlit image click coordinates, get pixel position from image click, streamlit interactive image component, image coordinate picker, streamlit click event handler, image annotation tool streamlit, mouse position on image, streamlit-component, image-interaction, ui-widget

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