EOCube.Ro Tools

Current release

This documentation describes eocube v0.3.4.

Welcome to the documentation for EOCube.Ro Tools -- eocube for short. eocube is a command-line tool and a Python library for working with the EOCube.Ro platform: authentication, the STAC catalog, object storage, and geospatial helpers. It is meant both for external users and for EOCube.Ro developers.

Installation

Install from the internal package registry. For the command-line tool, include the cli extra:

pip install "eocube[cli]" \
  --index-url https://gitlab.dev.info.uvt.ro/api/v4/projects/3491/packages/pypi/simple

Optional extras pull in heavier dependencies only when you need them:

Extra	Adds
cli	The eocube command-line interface
services	Geospatial queries (geopandas, owslib)
core	STAC client and object-storage helpers
mcp	The Model Context Protocol (MCP) server

Using eocube purely as a library (for example from eocube.common.auth import discover_client_token) needs only the base package.

Upgrading an existing environment

pystac 1.15 is split into several packages, and upgrading from pystac 1.14 in place with pip or Poetry leaves it without its modules: commands fail with module 'pystac' has no attribute 'Item'. eocube and eocube doctor report this together with the command that repairs it: python -m pip install --force-reinstall pystac, run in the environment eocube is installed in. Fresh installs are not affected.

Quick start

eocube setup init          # write the default configuration
eocube auth login          # authenticate in your browser
eocube services stac collection list

eocube setup init creates ~/.config/eocube/eocube.yml with the EOCube.Ro defaults (authentication source, object storage, STAC catalog), and eocube auth login stores your session in it.

Where to go next

• Configuration -- the eocube.yml file, the eocube setup commands, and the global --context option.
• CLI -- the command reference.
• STAC Catalog Authorization -- the ownership and visibility rules you must follow when publishing data.