stac-pydantic

What it is and what it does

stac-pydantic wraps the STAC specification (Spatiotemporal Asset Catalog) in Pydantic models, letting you validate and serialize geospatial metadata as strongly-typed Python objects. It covers core STAC Catalogs, Collections, and Items, plus the STAC API extensions for dynamic catalog queries. The library is built on pydantic, click, geojson-pydantic, and typing-extensions, making it lightweight and suitable for embedding in web services like FastAPI.

The main use case is request/response validation in APIs that serve or consume STAC data. It handles the namespace aliasing that STAC extensions require (e.g., eo:cloud_cover becomes a Python attribute), provides extension validation against remote JSON schemas, and ensures required fields are preserved during export even when null. For comprehensive schema validation and robust extension support, the documentation recommends pystac as an alternative.

Use it for:

• Validate STAC Items and Catalogs in a FastAPI endpoint before storing or forwarding them.
• Serialize Python geospatial metadata objects to STAC-compliant JSON with automatic namespace handling.
• Validate STAC extension fields (e.g., EO, Projection) against their published JSON schemas.
• Build a STAC API server that accepts ItemSearch queries and returns ItemCollections with type safety.
• Parse and validate STAC Catalogs from remote URLs or local files into typed Python objects.

Worth the install?

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

Provides Pydantic models for validating and serializing STAC (Spatiotemporal Asset Catalog) Catalogs, Collections, Items, and STAC API specifications, enabling type-safe request/response handling in web frameworks.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It is the standard choice for type-safe STAC handling in Python web frameworks. Install it if you are building or consuming STAC APIs or need to validate geospatial catalog metadata.

Install

stac-pydantic on PyPI

pip install stac-pydantic

uv add stac-pydantic

poetry add stac-pydantic

Installing stac-pydantic

Before you install

Low friction: pure Python wheel with only four runtime dependencies (click, geojson-pydantic, pydantic, typing-extensions). Actively maintained with a release 49 days ago and no known vulnerabilities.

License in practice

MIT License permits unrestricted use, modification, and distribution in both open-source and commercial projects with minimal restrictions.

Quickstart

pip install stac-pydantic

from stac_pydantic import Catalog

stac_catalog = {
  "type": "Catalog",
  "stac_version": "1.0.0",
  "id": "sample",
  "description": "Sample catalog",
  "links": [{"href": "item.json", "rel": "item"}]
}

catalog = Catalog(**stac_catalog)
print(catalog.id)

Requires Python 3.10 or later.

Verify before relying

• Whether the library's extension validation (validate_extensions) works reliably with custom vendor extensions beyond the official STAC registry.
• Performance characteristics when handling large catalogs with many items or deeply nested structures.
• Whether the CLI validate-item command supports all STAC Item variants and extensions.

Package facts

Evidence: stac_pydantic-3.6.0-py3-none-any.whl

Keywords: pydantic, stac, validation

Tags

More Information Analysis packages