stac-fastapi-pgstac

What it is and what it does

stac-fastapi-pgstac is a FastAPI application that wraps PgSTAC, a PostgreSQL-backed STAC (SpatioTemporal Asset Catalog) database engine. It validates incoming HTTP requests against the STAC API specification, delegates search and retrieval operations to PgSTAC's procedural SQL functions, and enriches responses with standardized STAC links. The package stores all collection and item records as JSONB fields in PostgreSQL, preserving custom fields transparently.

The package is designed for deployments that need a standards-compliant HTTP interface to large geospatial metadata catalogs. It supports the STAC Sort Extension (with optimized datetime sorting), optional API-level or database-level result hydration, and the Multi-Tenant Catalogs Extension for hierarchical catalog structures with directed acyclic graph support. Runtime dependencies include asyncpg for async database access, pydantic for validation, and orjson for fast JSON serialization.

Use it for:

• Expose a searchable STAC API endpoint over HTTP for a PostgreSQL-backed geospatial metadata catalog
• Build a multi-tenant geospatial data platform with hierarchical catalogs and poly-hierarchy link navigation
• Integrate STAC search into a larger FastAPI application using stac-fastapi-pgstac as a backend module
• Serve large spatiotemporal asset collections with optimized datetime-based sorting and filtering
• Deploy a STAC API with custom JSON fields preserved transparently through JSONB storage

Worth the install?

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

Provides a FastAPI-based HTTP interface to PgSTAC, a PostgreSQL backend for STAC API, enabling search and retrieval of geospatial collection and item metadata.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is MIT-licensed. Install it if you need a production-ready STAC API server backed by PostgreSQL. Prerequisite: you must provision a PgSTAC database schema and have PostgreSQL with PostGIS available; the package itself is the HTTP layer, not a standalone database.

Install

stac-fastapi-pgstac on PyPI

pip install stac-fastapi-pgstac

uv add stac-fastapi-pgstac

poetry add stac-fastapi-pgstac

Installing stac-fastapi-pgstac

Before you install

Low install friction with a pure-Python wheel. Active maintenance with a recent release 51 days ago and a commit history through August 2026. Requires 14 runtime dependencies including asyncpg, pydantic, and stac-fastapi ecosystem packages.

License in practice

MIT license (permissive) allows commercial and private use with minimal restrictions, making it suitable for both open and proprietary deployments.

Quickstart

# Install
pip install stac-fastapi-pgstac

# Minimal usage (requires PgSTAC database configured)
from stac_fastapi_pgstac.app import StacApi
from stac_fastapi_pgstac.config import Settings

settings = Settings()
app = StacApi.build(settings=settings)

Requires a running PostgreSQL database with PgSTAC schema installed and pypgstac package available; Python >=3.11

Verify before relying

• Whether PgSTAC database schema and pypgstac package are automatically provisioned or require separate setup
• Performance characteristics for repositories with millions of records beyond datetime sorting
• Whether Docker Compose is required for local development or if PostgreSQL/PostGIS can be configured standalone

Package facts

Evidence: stac_fastapi_pgstac-6.3.1-py3-none-any.whl

Keywords: FastAPI, PgSTAC, STAC, STAC-API

Tags

More Dynamic Content packages