SatelliteVu SDK for Python
⚠️ DEPRECATED: This package is deprecated and will no longer be maintained. Please use satvu-api-sdk instead.
Lightweight API Client SDK for SatelliteVu's Platform APIs, providing authorization handling and convenience methods to interact with the published APIs.
Installation
The package is published to PyPi and can be installed with pip:
pip install satellitevu
Currently, versions of Python >=3.10 and above are supported.
Usage
A User API Client credential set consisting of an client id and client secret is needed and should be set in your script's environment variables.
Check out the full API and SDK documentation and the examples provided. The examples can for example be run locally with
poetry run python ./examples/catalog.py --example=recent
Simple Client Usage
The easiest way to get started is to use the satellitevu.Client class, which needs
a client_id and client_secret only:
import os
from satellitevu import Client
client = Client(os.getenv("CLIENT_ID"), os.getenv("CLIENT_SECRET"))
contract_id = os.getenv("CONTRACT_ID")
print(client.catalog_v1.search(contract_id=contract_id).json())
client.catalog_v1.search supports all request body parameters documented
in the API docs, with special handling for datetime which is
constructed from the optional date_from and date_to parameters and a default result
page size limit of 25.
Authentication Handling
The satellitevu.Auth class provides the main interface to retrieve an
authorization token required to interact with the API endpoints.
import os
from satellitevu import Auth
auth = Auth(client_id=os.getenv("CLIENT_ID"), client_secret=os.getenv("CLIENT_SECRET"))
print(auth.token())
Thus retrieved token can be used for bearer token authentication in HTTP request Authorization headers.
The Auth class by default uses a file based cache which will store the token in
~/.cache/SatelliteVuon Linux~/Library/Caches/SatelliteVuon MacOSC:\Documents and Settings\<username>\Local Settings\Application Data\SatelliteVu\Cacheon Windows
Other cache implementations must implement the satellitevu.auth.cache.AbstractCache
class.
HTTP Client Wrappers
Convenience wrapper classes for common HTTP client implementations are provided as
implementations of satellitevu.http.AbstractClient, which provides an request method
with an interface similar to requests.request and returning an
satellitevu.http.ResponseWrapper instance, where the response object of the underlying
implementation is available in the raw property.
Commonly used properties and methods are exposed on both AbstractClient and
ResponseWrapper.
satellitevu.http.UrllibClientfor Python standard lib'surllibsatellitevu.http.requests.RequestsSessionusingrequests.Sessionclasssatellitevu.http.httpx.HttpxClientusinghttpx.Client(Todo)
Implementations based on requests and httpx allow setting an instance of the
underlying implementation, but will provide a default instance if not.
2 maintainers
Release files for satellitevu 6.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| satellitevu-6.0.0.tar.gz | 33.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| satellitevu-6.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 76.7 kB
Release files / satellitevu-6.0.0.tar.gz
| Download URL | satellitevu-6.0.0.tar.gz |
|---|---|
| Size | 33.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
08eee93d85a63286ba952a201b6d674885182b50206a70f754e4f547215c2cf1
|
|
BLAKE2b-256 checksum How to use checksums |
c8e099b518fc162de94523669eb59f261b795073d98418f29d8cacee0ba0f636
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency logRelease files / satellitevu-6.0.0-py3-none-any.whl
| Download URL | satellitevu-6.0.0-py3-none-any.whl |
|---|---|
| Size | 43.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
044757ee5513be7070af907e042ccbabe0a579b903cfc24649350b08c1139a98
|
|
BLAKE2b-256 checksum How to use checksums |
8cf676c2b579b71dea132ae627f98c30aeb9020e7ab0e339fc8e16b1db4dd3ae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 8, 2026.
Transparency log
