Demo
Features
- 🗺️ Interactive Map Interface — visually search and filter satellite products
- 🛰️ High-Resolution Tile Server — visualize full-resolution product bands on the map (via
localtileserver) - 🎯 Click-to-Stream — click any MGRS grid tile to stream its latest True Color Image (TCI)
- 🌍 14 Contextual Overlays — land cover (WorldCover, LCM, LC100, TCD), terrain (Copernicus DEM), vegetation & productivity (NDVI climatology, FAPAR, Dry Matter Productivity), thermal (hourly LST), water & soil (Soil Moisture, Soil Water Index, Water Bodies), and hazard layers (Burned Area)
- 🔍 Smart Search — filter by location, date range, cloud cover, and product type
- 📦 Granular Downloads — Band-Resolution matrix for precise data selection and de-duplicated downloads
- 🔌 Dual Backend Support — discovery via OData or STAC APIs
- 🐍 Professional API — clean Python API for programmatic access
- 🔐 Secure — handle S3 credentials safely with static key support
- ⚡ Efficient — batch operations and smart caching
Requirements
- Python 3.11+
- Docker and Docker Compose (optional, for the Docker setup)
uvpackage manager (optional, recommended for development)
Credentials: You need free Copernicus credentials to use vresto — get them at https://dataspace.copernicus.eu/. See the Setup Guide for configuration details.
Installation
From PyPI:
pip install vresto
For development:
git clone https://github.com/kalfasyan/vresto.git
cd vresto
uv sync --extra dev
Usage
Docker
The fastest way to run vresto:
git clone https://github.com/kalfasyan/vresto.git && cd vresto
make docker-up
The dashboard opens at http://localhost:8610. Add your Copernicus credentials anytime via the ☰ menu → Settings, or provide them up front in a .env file (see .env.example). Use make docker-rebuild after pulling changes.
Python
Launch the app:
vresto # or: uv run vresto / pixi run vresto / make app
Search and download from Python:
from vresto.api import CatalogSearch, CopernicusConfig
from vresto.products import ProductsManager
config = CopernicusConfig()
catalog = CatalogSearch(config=config)
manager = ProductsManager(config=config)
# Search for a product by name
products = catalog.search_products_by_name("S2A_MSIL2A", max_results=5)
# Download specific bands (Red, Green, Blue)
manager.download_product_bands(
product=products[0].name,
bands=["B04", "B03", "B02"],
resolution=10,
dest_dir="./data",
)
CLI
vresto-cli search-name "S2A_MSIL2A" --max-results 5
vresto-cli download-bands "S2A_MSIL2A_20200612T023601_N0500_R089_T50NKJ_20230327T190018" "B04,B03,B02" --resolution 10 --output ./data
Documentation
- Setup Guide ⭐ start here — installation, credentials, configuration
- API Guide — programmatic usage
- CLI Guide — command-line reference
- AWS CLI Guide — direct S3 access
- Contributing — development setup
License
This project is licensed under the terms in LICENSE.txt.
1 maintainer
Metadata
1 maintainer
Release files for vresto 0.4.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vresto-0.4.5.tar.gz | 734.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vresto-0.4.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 946.6 kB
Release files / vresto-0.4.5.tar.gz
| Download URL | vresto-0.4.5.tar.gz |
|---|---|
| Size | 734.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3a549af4a9d83d69360fa6520955fbe6525ebe2ea5e687e260dd6731eab5487e
|
|
BLAKE2b-256 checksum How to use checksums |
3553918a28ddfb46ffae7b5e969a3c418e54f76d424943d2c4d1aaa5e202483c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 4, 2026.
Transparency logRelease files / vresto-0.4.5-py3-none-any.whl
| Download URL | vresto-0.4.5-py3-none-any.whl |
|---|---|
| Size | 211.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dd5c4c451e6917475077df7dd18c6738215d14ee8d1cd8e3fe60b4524c47aa70
|
|
BLAKE2b-256 checksum How to use checksums |
7584a3aa202e0aaf4d6e7a61344f1f4f5a3e7bbf0411116c475199ad884f674b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Oct 4, 2026.
Transparency log
