EOCube.Ro Tools¶

Current release

This documentation describes eocube v0.2.3.

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.

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.