PySTAC

Build Status PyPI version Conda (channel only) Documentation codecov Gitter License

PySTAC is a library for working with the SpatioTemporal Asset Catalog specification in Python 3.

Installation

Install from PyPi (recommended)

python -m pip install pystac

If you would like to enable the validation feature utilizing the jsonschema project, install with the optional validation requirements:

python -m pip install 'pystac[validation]'

If you would like to use the orjson instead of the standard json library for JSON serialization/deserialization, install with the optional orjson requirements:

python -m pip install 'pystac[orjson]'

If you would like to use a custom RetryStacIO class for automatically retrying network requests when reading with PySTAC, or if you have non-ASCII characters in your urls you'll need urllib3:

python -m pip install 'pystac[urllib3]'

If you are using jupyter notebooks and want to enable pretty display of pystac objects you'll need jinja2

python -m pip install 'pystac[jinja2]'

Install from source

git clone https://github.com/stac-utils/pystac.git
cd pystac
python -m pip install .

See the installation page for more options.

Versioning

The core PySTAC API follows Semantic Versioning. As of Spring 2026, our extension implementations have moved to their own Python packages, so they can be versioned independently of the core PySTAC API. Breaking changes to the API of extension packages are not considered breaking changes for the purposes of PySTAC versioning.

The STAC extension packages' version will match the version extension itself, e.g. pystac-ext-projection v2.0.0 corresponds to the v2.0.0 release of the projection extension. Any changes to the software (not the extension) will be released via post releases.

Documentation

See the documentation page for the latest docs.

Developing

See contributing docs for details on contributing to this project.

Running the quickstart and tutorials

There is a quickstart and tutorials written as jupyter notebooks in the docs/tutorials folder. To run the notebooks, run a jupyter notebook with the docs directory as the notebook directory:

jupyter notebook --ip 0.0.0.0 --port 8888 --notebook-dir=docs

You can then navigate to the notebooks and execute them.

Requires Jupyter be installed.

Project links

Data verified by PyPI on Jul 27, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for quentonc from gravatar.com quentonc Avatar for stac-utils from gravatar.com stac-utils

Credits

PyPI data
Data sourced directly from PyPI's database.

Maintainer: Pete Gadomski

Author: Rob Emanuele

GitHub Statistics

Data verified by PyPI on Jul 27, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache-2.0)

Requires

Python >=3.10

Provides Extra

jinja2 orjson urllib3 validation

Tags

STAC catalog imagery pystac raster

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pystac-1.15.2.tar.gz (7.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pystac-1.15.2-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

File details

Details for the file pystac-1.15.2.tar.gz.

File metadata

  • Download URL: pystac-1.15.2.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pystac-1.15.2.tar.gz
Algorithm Hash digest
SHA256 4c9a3b2352cad7eb3c226145251c65cbe5c1b04b25d4265b30c015dddf5f391d
MD5 b091f4e986e0699ff05087a21fae4783
BLAKE2b-256 8338300a9bc5bf30748c7bc768afd8564e0b6958810c8ca0c50f1c0847676a40

See more details on using hashes here.

Provenance

The following attestation bundles were made for pystac-1.15.2.tar.gz:

Publisher: release.yml on stac-utils/pystac

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pystac-1.15.2-py3-none-any.whl.

File metadata

  • Download URL: pystac-1.15.2-py3-none-any.whl
  • Upload date:
  • Size: 5.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pystac-1.15.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b006833253d7e5acd04d877bb7504e14aa1dc98dd0f0ab12f893595030dda2b3
MD5 2deec511b7c299ad8452830faacd96ad
BLAKE2b-256 345481ca429d8ee0fa1ff78ad3102a612cfb8224aae4ba42ac625c726b13f81c

See more details on using hashes here.

Provenance

The following attestation bundles were made for pystac-1.15.2-py3-none-any.whl:

Publisher: release.yml on stac-utils/pystac

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.15.2 This release

2 files

1.15.1

2 files

Yanked

1.15.0

2 files

Yanked reason: Released with invalid version specifier for the core package

Pre-release

1.15.0rc1

2 files

Yanked

1.15.0rc0

2 files

Yanked reason: Dependencies were broken

1.14.3

2 files

1.14.2

2 files

1.14.1

2 files

1.14.0

2 files

1.13.0

2 files

1.12.2

2 files

1.12.1

2 files

1.12.0

2 files

1.11.0

2 files

1.10.1

2 files

1.10.0

2 files

1.9.0

2 files

1.8.4

2 files

1.8.3

2 files

1.8.2

2 files

1.8.1

2 files

Yanked

1.8.0

2 files

Yanked reason: JSONSchemas were not distributed

1.7.3

2 files

1.7.2

2 files

1.7.1

2 files

1.7.0

2 files

1.6.1

2 files

1.6.0

2 files

1.5.0

2 files

1.4.0

2 files

1.3.0

2 files

1.2.0

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

Pre-release

1.0.0rc3

2 files

Pre-release

1.0.0rc2

2 files

Pre-release

1.0.0rc1

2 files

Pre-release

1.0.0b3

2 files

Pre-release

1.0.0b2

2 files

Pre-release

1.0.0b1

2 files

0.5.6

2 files

0.5.5

2 files

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

Pre-release

0.5.0rc1

2 files

0.4.0

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.1

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page