vresto 0.0.13

satellite product browser

vresto

A beautiful, professional Python toolkit for searching and accessing Copernicus Sentinel satellite data

---

Features

• 🗺️ Interactive Map Interface - Visually search and filter satellite products
• 🔍 Smart Search - Filter by location, date range, cloud cover, and product type
• 📦 Product Management - Download quicklooks and metadata from S3
• 🐍 Professional API - Clean Python API for programmatic access
• 🔐 Secure - Handle S3 credentials safely with static key support
• ⚡ Efficient - Batch operations and smart caching

Quick Start

Note: You need Copernicus credentials to use vresto. Get free access at https://dataspace.copernicus.eu/

Installation

From PyPI (recommended for users):

pip install vresto
# or with uv
uv pip install vresto

For development:

git clone https://github.com/kalfasyan/vresto.git
cd vresto
uv pip install -e .

Configuration

Configure your credentials (see Setup Guide for details):

export COPERNICUS_USERNAME="[e-mail]"
export COPERNICUS_PASSWORD="your_password"

Or run the interactive setup helper which writes a .env in the project root:

python scripts/setup_credentials.py

Launch the App

Simply run:

make app

Or directly with Python:

python src/vresto/ui/app.py

Opens at http://localhost:8080

API usage:

from vresto.api import CatalogSearch, BoundingBox, CopernicusConfig
from vresto.products import ProductsManager

config = CopernicusConfig()
catalog = CatalogSearch(config=config)
bbox = BoundingBox(west=4.65, south=50.85, east=4.75, north=50.90)

products = catalog.search_products(
    bbox=bbox,
    start_date="2024-01-01",
    max_cloud_cover=20,
)

manager = ProductsManager(config=config)
for product in products[:5]:
    quicklook = manager.get_quicklook(product)
    if quicklook:
        quicklook.save_to_file(f"{product.name}.jpg")

For detailed setup and usage, see the documentation below.

Documentation

• Setup Guide ⭐ Start here - Installation, credentials setup, and configuration
• API Guide - Programmatic usage examples and reference
• AWS CLI Guide - Direct S3 access with AWS CLI
• Contributing - Development setup

Requirements

• Python 3.9+
• uv package manager (optional but recommended)

License

See LICENSE.txt