---
id: pystac-ext-label
version: "1.0.2"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pystac-ext-label — Label extension for PySTAC

License: permissive · Maintenance: active · Downloads: 4.0M/mo

## What it is and what it does

pystac-ext-label is a PySTAC extension package that implements the STAC Label Extension specification (v1.0.0 and v1.0.1). It adds structured fields to STAC catalogs and items for describing labeled training data used in machine learning workflows, including label types, classification schemes, annotation tasks, and summaries of label distributions across datasets.

The package is a thin wrapper around the Label Extension schema, designed to integrate seamlessly with PySTAC's core catalog and item APIs. It targets developers building machine learning data pipelines who need to catalog, discover, and share labeled imagery or raster data through STAC-compliant metadata. The package is actively maintained, supports modern Python versions (3.10–3.13), and carries no known security vulnerabilities.

Use it for:

- Catalog labeled satellite or aerial imagery datasets for machine learning model training and validation.
- Describe annotation tasks and label distributions in STAC items to document data preparation workflows.
- Integrate labeled training data metadata into STAC repositories for reproducible ML experiments.
- Share labeled geospatial datasets with consistent, standardized metadata across teams and projects.

## Worth the install?

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

Extends PySTAC to add support for the Label Extension specification, enabling description of labeled training data for machine learning with fields for label types, classes, tasks, methods, and label distribution overviews.

Yes. If you are building or consuming STAC catalogs that include labeled training data, this extension is the standard way to describe that metadata. Low install friction, active maintenance, permissive license, and no security issues make it a straightforward addition to a PySTAC workflow.

## Install

pip install pystac-ext-label
uv add pystac-ext-label
poetry add pystac-ext-label

## Installing pystac-ext-label

Before you install: Low friction: pure Python wheel with a single runtime dependency on pystac-core. Active maintenance with a recent release (4 days old) and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you must include a copy of the license and state significant changes.

Quickstart:

pip install pystac-ext-label

from pystac_ext_label import LabelExtension

# Use LabelExtension to work with labeled STAC items

Requires Python 3.10 or later; pystac-core must be installed as a runtime dependency.

Verify before relying:

- Whether this extension is compatible with all versions of pystac-core or only specific versions
- Performance characteristics when working with large labeled datasets

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

STAC label extension, labeled training data metadata, machine learning dataset catalog, PySTAC label support, STAC extension for labels, training data annotation metadata, stac-catalog, geospatial-metadata, machine-learning-data

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