Skip to main content
`Ctrl`+`K`

# `stactools` documentation

`stactools` is a library for working with SpatioTemporal Asset Catalogs (STAC). It is based on PySTAC. The `stactools` package provides:

- A core Python API, available via `stactools.core`, which provides high-level utility functions for working with STAC objects

- A command-line interface, available via the `stac` command, e.g.:

    $ stac --help

There are a variety of `stactools` packages built for specific datasets or to provide extra functionality. See the stactools-packages website and the stactools-packages Github organization for more information.

## Requirements

- Python 3.8 or greater

## STAC version support

All versions of `stactools` support STAC v1.0.0.

## Installation

    $ pip install stactools

Filesystem I/O is provided by fsspec. To enable AWS S3 support via s3fs, you can enable it during installation.

    $ pip install 'stactools[s3]'

Note

If you need to access s3 data via requester pays, use this environment variable: `AWS_REQUEST_PAYER='requester'`.