Skip to content

Quick Start

CLI

The command-line interface provides tools for working with metadata files. You can list available entity types, generate empty templates, validate existing files, and convert between YAML and JSON formats.

metaseed entities
metaseed template investigation
metaseed validate data.yaml
metaseed convert data.yaml data.json

Python API

The MetaseedClient provides a clean programmatic API for working with metadata:

from metaseed import MetaseedClient

client = MetaseedClient("miappe", "1.2")

# Create entities
inv = client.create_entity("Investigation", {
    "unique_id": "INV001",
    "title": "Drought study"
})

study = client.create_entity("Study", {
    "unique_id": "STU001",
    "title": "Field trial",
    "investigation_id": "INV001"
}, parent_id=inv.id)

# Validate
result = client.validate()
if not result.valid:
    for issue in result.issues:
        print(f"{issue.field}: {issue.message}")

# Serialize/load
data = client.serialize()
client.load(data)

See MetaseedClient API for complete documentation.

Interactive Facade (Jupyter/Notebooks)

For interactive use with tab completion:

from metaseed import miappe

m = miappe()
m.Investigation.help()  # Show fields
inv = m.Investigation(unique_id="INV001", title="Drought study")

See Profiles for ISA and other available profiles.

Web UI

The web interface provides a visual editor for creating and editing metadata. Forms are generated dynamically from the schema specifications and validate input in real-time.

metaseed ui

This opens a browser at http://127.0.0.1:8080.