SatVu API SDK
Python SDK for SatVu's satellite imagery platform.
✨ Features
- Unified Interface - Access all SatVu APIs through a single SDK
- Type Safety - Full type hints with Pydantic models for requests and responses
- Explicit Error Handling - Rust-inspired Result types for predictable error handling
- Multiple HTTP Backends - Choose httpx, requests, urllib3, or stdlib
- Built-in Pagination - Iterator methods for seamless pagination through large result sets
- Streaming Downloads - Memory-efficient downloads for large satellite imagery files
📦 Installation
The package is published on PyPI and can be installed with pip:
pip install satvu
With optional HTTP backends:
pip install satvu[http-httpx]
pip install satvu[http-requests]
pip install satvu[http-urllib3]
The SDK works out of the box with Python's built-in urllib.
🚀 Quick Start
import os
from uuid import UUID
from satvu import SatVuSDK
sdk = SatVuSDK(
client_id=os.environ["SATVU_CLIENT_ID"],
client_secret=os.environ["SATVU_CLIENT_SECRET"],
)
contract_id = UUID(os.environ["SATVU_CONTRACT_ID"])
# Search the catalog
results = sdk.catalog.get_search(contract_id=contract_id, limit=10)
for feature in results.features:
print(feature.id)
Available Services
| Service | Description |
|---|---|
sdk.catalog |
Search and discover SatVu's STAC catalog |
sdk.cos |
Order and download imagery available from SatVu's STAC catalog |
sdk.id |
Identity and user management, including webhooks |
sdk.otm |
Order and manage satellite tasking |
sdk.policy |
Check active contracts |
sdk.reseller |
Perform reseller operations |
sdk.wallet |
Check credit balances |
📖 Documentation
- Getting Started - Installation, authentication, first API call
- Authentication - OAuth2 flow, token caching, environments
- Error Handling - Result types and error patterns
- Pagination - Working with paginated endpoints
- Streaming Downloads - Downloading large imagery files
- HTTP Backends - Choosing and configuring HTTP clients
- Changelog
Requirements
- Python 3.10+
Contributing
See CONTRIBUTING.md for development setup and guidelines.
Support
For bugs and feature requests, please open an issue.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
satvu-0.9.0.20260724.1338.tar.gz
(191.2 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file satvu-0.9.0.20260724.1338.tar.gz.
File metadata
- Download URL: satvu-0.9.0.20260724.1338.tar.gz
- Upload date:
- Size: 191.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ead1b1a3d74d8e5a628694bd9283ccb53883257d4334b696902ea050efa7e3d7
|
|
| MD5 |
e201fac393f5b553c1dde8204a5ae388
|
|
| BLAKE2b-256 |
7fa534bb252625b8d33339c272235d41f2915f51cc4d8500dc390fa661435086
|
Provenance
The following attestation bundles were made for satvu-0.9.0.20260724.1338.tar.gz:
Publisher:
release.yml on SatelliteVu/satvu-api-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
satvu-0.9.0.20260724.1338.tar.gz -
Subject digest:
ead1b1a3d74d8e5a628694bd9283ccb53883257d4334b696902ea050efa7e3d7 - Sigstore transparency entry: 2234523379
- Sigstore integration time:
-
Permalink:
SatelliteVu/satvu-api-sdk@fcc8f300e91b23c9b01331bbcace8c24abb6a9f0 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SatelliteVu
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@fcc8f300e91b23c9b01331bbcace8c24abb6a9f0 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file satvu-0.9.0.20260724.1338-py3-none-any.whl.
File metadata
- Download URL: satvu-0.9.0.20260724.1338-py3-none-any.whl
- Upload date:
- Size: 286.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
629128c6d8da110cfee5572257515391c55cd379cc66de21d9acf5b1214cc44c
|
|
| MD5 |
659f3d66bfbab37ca47a742b2100b97e
|
|
| BLAKE2b-256 |
c2e4d3a41eb42a9a7004a7f976b574e45b4a6d5960c04963f2b3e4481293bf9d
|
Provenance
The following attestation bundles were made for satvu-0.9.0.20260724.1338-py3-none-any.whl:
Publisher:
release.yml on SatelliteVu/satvu-api-sdk
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
satvu-0.9.0.20260724.1338-py3-none-any.whl -
Subject digest:
629128c6d8da110cfee5572257515391c55cd379cc66de21d9acf5b1214cc44c - Sigstore transparency entry: 2234523498
- Sigstore integration time:
-
Permalink:
SatelliteVu/satvu-api-sdk@fcc8f300e91b23c9b01331bbcace8c24abb6a9f0 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/SatelliteVu
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@fcc8f300e91b23c9b01331bbcace8c24abb6a9f0 -
Trigger Event:
workflow_dispatch
-
Statement type:
