Install & Compatibility
Where this runs
tested against v0.12.0 · 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 5.5s · import 0.000s · 196MB
193MB installed
● package 193MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
rio_stac
✓ import rio_stac
✗ from rio_stac import stac
rio_stac has no submodule named 'stac'; the main module is the package itself.
stac
✓ import rio_stac
✗ from rio_stac import stac
No 'stac' function; use rio_stac.create_stac_item() directly.
Create a basic STAC Item from a raster URL.
import rio_stac
from pystac import Item
# Create a STAC item from a raster file
item = rio_stac.create_stac_item(
"https://example.com/sample.tif",
input_datetime="2023-01-01T00:00:00Z",
assets={"image": {"href": "https://example.com/sample.tif"}},
)
print(item.to_dict())
rio --version
Errors
Common errors & fixes
AttributeError: module 'rio_stac' has no attribute 'stac'
Incorrect import pattern: `from rio_stac import stac` or `rio_stac.stac(...)`
fixUse `rio_stac.create_stac_item()` directly.
TypeError: create_stac_item() missing 1 required positional argument: 'input_datetime'
Missing the required `input_datetime` parameter.
fixPass an ISO datetime string or set to None (but prefer explicit datetime).
rio_stac.errors.DateParsingError: Could not parse datetime from raster metadata
The TIFF tags do not contain a valid datetime or the format is unsupported.
fixAlways provide an explicit `input_datetime` parameter.
Upgrade
Version history
0.12.0latest on PyPI · released Sep 17, 2025
Audit
Dependencies
rasteriorequiredCore dependency for raster I/O
pystacrequiredFor STAC item creation