Skip to content
Marivo

Marivo 0.2.5

Marivo 0.2.5 is a v0.2 patch release for agent-facing semantic authoring, catalog browsing, and local runtime observability. It narrows the semantic surface around project-local files, makes catalog traversal more direct, and removes the old decision ledger from the public contract.

Highlights

Section titled “Highlights”
  • Semantic projects can now load multiple layer roots from layer_paths, so teams can split datasource, domain, and metric declarations across several files without flattening them into one module.
  • The semantic decision ledger has been removed from the public surface. Readiness and verification now focus on declared semantic objects and source evidence instead of a separate internal decision log.
  • The catalog browsing model introduced a kind-first API with bounded output, explicit drill-down keys, and agent-facing help that points to concrete next calls.
  • Migration: The kind-first browsing API has since been replaced by typed catalog collections (catalog.domains, catalog.metrics, etc.) and concrete catalog objects. Use catalog.domains.show() and sales.entities.get("orders") for typed navigation instead of the earlier kind-scope matrix.
  • Local usage telemetry is now recorded project-locally so CLI and runtime usage can be inspected without sending data to an external service.

Changed

Section titled “Changed”
  • Catalog discovery output is organized around kinds such as datasources, domains, entities, dimensions, measures, metrics, and relationships.
  • Semantic loader and reader behavior now treats configured layer roots as the project contract and fails closed on ambiguous names.
  • Agent help and bundled semantic/analysis skills now route authors through the current help, discovery, verification, and catalog-browsing surfaces.

Fixed

Section titled “Fixed”
  • Scalar row-count quality checks no longer emit noisy warnings for valid single-row aggregate outputs.
  • Analysis error rendering and frame guidance were tightened around the current semantic-input contract.

Documentation

Section titled “Documentation”
  • Added design notes for multi-root semantic projects and kind-first catalog browsing.
  • Updated the latest and v0.2 installation, quick start, semantic-layer, and readiness documentation for the current semantic project model.

Installation

Section titled “Installation”
Terminal window
pip install marivo

Install the backend extra for the datasource you plan to use:

Terminal window
pip install "marivo[duckdb]"
pip install "marivo[mysql]"
pip install "marivo[trino]"
pip install "marivo[postgres]"
pip install "marivo[clickhouse]"
pip install "marivo[all]"

Marivo 0.2.5 requires Python 3.12 or newer.

Documentation

Section titled “Documentation”