STAC-GeoParquet
Convert STAC items between JSON, GeoParquet, pgstac, and Delta Lake.
Purpose
The STAC spec defines a JSON-based schema.
But it can be hard to manage and search through many millions of STAC items in JSON format.
For one, JSON is very large on disk.
And you need to parse the entire JSON data into memory to extract just a small piece of information, say the datetime and one asset of an Item.
GeoParquet can be a good complement to JSON for many bulk-access and analytic use cases. While STAC Items are commonly distributed as individual JSON files on object storage or through a STAC API, STAC GeoParquet allows users to access a large number of STAC items in bulk without making repeated HTTP requests.
For analytic questions like "find the items in the Sentinel-2 collection in June 2024 over New York City with cloud cover of less than 20%" it can be much, much faster to find the relevant data from a GeoParquet source than from JSON, because GeoParquet needs to load only the relevant columns for that query, not the full data.
See the STAC-GeoParquet specification for details on the exact schema of the written Parquet files.
Installation
Install via pip or conda:
pip install stac-geoparquetconda install conda-forge::stac-geoparquet
Documentation
Development
Get uv, then:
git clone git@github.com:stac-utils/stac-geoparquet.git
cd stac-geoparquet
uv sync
uv run pre-commit install
uv run pytest
scripts/lint
Releasing
We use release-please to manage releases. To create a new release, look for a release PR, approve it, and merge it. release-please will create a tag and a release, which will trigger a new release on PyPI.
1 maintainer
Metadata
1 maintainer
Release files for stac-geoparquet 0.8.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| stac_geoparquet-0.8.3.tar.gz | 2.0 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| stac_geoparquet-0.8.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.0 MB
Release files / stac_geoparquet-0.8.3.tar.gz
| Download URL | stac_geoparquet-0.8.3.tar.gz |
|---|---|
| Size | 2.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5eb63e3f7221e360b23fd7c201fc00e07c69560d059cea46d40762a392129f87
|
|
BLAKE2b-256 checksum How to use checksums |
0f019e4ceacf2974fd3efdba4c237920e2f1958359fa155205db9943216590f8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logRelease files / stac_geoparquet-0.8.3-py3-none-any.whl
| Download URL | stac_geoparquet-0.8.3-py3-none-any.whl |
|---|---|
| Size | 32.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d3dad6545206e180903edce60b21992c244cd91ff22622371a79ef0c060a3a40
|
|
BLAKE2b-256 checksum How to use checksums |
6d802c790bb91c4928df5d0037f96f2198b71a678efb18de8bea8c27e8f63dd3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logSecurity for stac-geoparquet 0.8.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for stac_geoparquet-0.8.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
