Core concepts
Tenants, datasets, experiments and runs, model versions, approval, runtime images, serving, edge, alerts, drift
Terms that recur throughout the manual. Skim them once and the other chapters get easier.
Tenants and roles
Tenant
The unit in which the platform is shared (a team, business unit or customer). Datasets, experiments, models, images, devices and alerts all belong to a tenant, and other tenants' items are invisible. Switch tenants with the selector at the top right. Features (training, serving, edge and so on) can be switched on or off per tenant.
Members and roles
A user becomes a member of a tenant with one role (VIEWER, DEVELOPER, OPERATOR, APPROVER or ADMIN). The role decides the permissions → Roles and permissions
Global administrator
An account that manages the whole platform regardless of tenant. It creates tenants, wires GPUs and uses the system console.
Data and training
Dataset
A set of files used for training. It is finalised when created, and files can still be added or removed afterwards. Every change rewrites the file list (manifest), so it is recorded which files a training run used. Upload directly or sync from an external DataOps system.
Training run
One training job submitted from the wizard. The server shows progress in six stages: queue → runtime preparation → data staging → training → registration → finalisation. It runs as a Kubernetes Job and can be stopped or resubmitted with the same settings. There is no way to continue a stopped run as-is; upload its checkpoint as starting weights and start a new run.
Training runtime
The container image that holds the training code. There are built-in runtimes such as YOLO, RF-DETR and Pointcept, and images built by partners can be registered as external images. Shared runtimes serve every tenant, and a tenant can also keep its own.
Experiments and runs
Each training run becomes one MLflow run. A run keeps parameters, metrics (per-epoch curves) and artifacts (model files and so on), and runs with the same purpose are grouped into one experiment.
Models and delivery
Model versions and stages
A registered model gets a version number, and its stage says what it is for: Staging (under validation) → Production (in service) → Archived. When training succeeds, the model is registered automatically and moved to Staging.
Approval
Promotion to Production never happens directly: it always starts as an approval request. Someone with the promotion permission (APPROVER, ADMIN) creates the request, and it takes effect once someone with the approve permission approves it. Safety-critical models (tagged geo.safety_critical) need two approvals.
Serving images and API services
A serving image is a model version built into an inference-server container. Running that image on the cluster and calling it over REST is an API service, which you can try right away in the on-screen inference console.
Deployment
The record of delivering a model to a target (an API service or a set of field devices). It can be rolled back to the previous version.
Field and monitoring
Edge device
An inference device in the field. The geo-mlops-sdk agent sends heartbeats (the periodic "I am alive" signal), uploads sensor and PLC data and inference results, and receives commands, policies and models from the centre. When the network drops it buffers locally and sends once reconnected.
Alerts and notifications
An alert is a problem the system detected (a device went silent, API latency, drift…) that you acknowledge, resolve or mute. A notification is news addressed to you (an approval request, a training result…) that lands in the inbox under the bell icon. They are different things.
Drift
The distribution of inputs in production drifting away from what the model was trained on. The platform measures how far the two distributions differ with the PSI and KS metrics, raises an alert when it crosses the threshold, and lets you start retraining from the same screen.
GPU wiring
Allocating the cluster's GPUs to tenants. There are shared pools used by several tenants and dedicated GPUs used by one; a tenant with no wiring cannot use GPUs for training or serving (CPU only).