Status and limitations
What the current alpha supports and what is still being built.
SuperSTAC is a pre-1.0, MIT-licensed project. This documentation targets version 0.2.0. APIs and YAML shapes may change.
Available
- Python sync and async clients backed by Rust.
- A Tokio-based Rust engine and command-line tool.
- In-memory catalog and provider registration.
- Collection discovery and source selection.
- Concurrent searches with per-catalog caps, retries, and timeouts.
- Collection/asset aliases and optional response normalization.
- Item-ID deduplication, failure metadata, and Rust/CLI item provenance.
Not implemented yet
- Persistent SQLite and Postgres backends. Rust enum variants exist but currently return memory storage.
- Integrated authentication, custom request headers, OAuth, or asset signing in the engine search path.
- Federated cursors, lazy Python streaming, and stable global sorting.
- CQL2, field projection, or cloud-cover search options.
- Full pystac-client API compatibility.
The package searches item metadata; it does not download, mosaic, render, or reproject imagery.
Current alpha behavior to account for
YAML and Python dictionary configuration have different required fields. Python matched() counts returned records. Python item dictionaries omit per-item provenance wrappers. sortby is currently ignored by translation. Health monitors and global monitoring settings have limitations documented in resilience.
These are implementation constraints, not promises about future releases. Track development in the repository and changelog.
License
SuperSTAC uses the MIT license. See the repository LICENSE for its terms.
