Install & Compatibility
Where this runs
tested against v0.5.2 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 13.6s · import 0.000s · 342MB
345MB installed
● package 345MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
stac_load
✓ from odc.stac import stac_load
✗ from odc_stac import stac_load
Module uses dot notation (odc.stac), not underscore.
configure_s3_access
✓ from odc.stac import configure_s3_access
load
✓ from odc.stac.load import stac_load
✗ from odc.stac import load
load is a module, not the function directly.
Load Sentinel-2 L2A data from Planetary Computer STAC API.
import pystac_client
import planetary_computer
from odc.stac import stac_load, configure_s3_access
catalog = pystac_client.Client.open(
"https://planetarycomputer.microsoft.com/api/stac/v1",
modifier=planetary_computer.sign_inplace,
)
query = catalog.search(
collections=["sentinel-2-l2a"],
bbox=[142, -37, 143, -36],
datetime="2022-01-01/2022-01-31",
max_items=10,
)
items = list(query.items())
configure_s3_access(aws_unsigned=True)
ds = stac_load(
items,
bands=["red", "green", "blue"],
resolution=10,
chunks={},
groupby="solar_day",
)
print(ds)
odc-stac --version
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'odc.stac'
Python cannot find the odc-stac package; either not installed or import path is wrong.
fixInstall with `pip install odc-stac`. Ensure you are using `from odc.stac import ...` (dot notation, not underscore).
ModuleNotFoundError: No module named 'odc.loader'
odc-loader package not installed. Required since odc-stac 0.5.0.
fixInstall odc-loader: `pip install odc-loader`.
AttributeError: 'NoneType' object has no attribute 'shape'
stac_load returned None or empty dataset due to no matching data or incorrect parameters.
fixCheck item collection, bands, and ensure `configure_s3_access` is called for cloud data access. Verify items have the requested bands.
TypeError: stac_load() got an unexpected keyword argument 'chunks'
chunks parameter changed between odc-loader versions; older version expects `dask_chunks` or different dict format.
fixUse `chunks={}` (dict) for automatic chunking. For odc-loader <0.6.0, use `dask_chunks=True/False`. Upgrade odc-loader: `pip install odc-loader>=0.6.0`. Upgrade
Version history
0.5.2latest on PyPI · released Jan 19, 2026
Audit
Dependencies
odc-georequiredCore geometry and CRS utilities
pystacrequiredSTAC metadata reading
pystac-clientoptionalFetching STAC items from APIs
xarrayrequiredData array loading
rasteriorequiredRaster data access
odc-loaderrequiredLoading raster data (since 0.5.0)