Skip to content

simulo asset publish

Publish a USD or URDF package as a new immutable asset version: inspect + upload + cloud-validate in one command.

usage: simulo asset publish [-h] [--kind {robot,world,prop}] [--name NAME] [--entry FILE]
[--root DIR] [--base {fixed,floating}] [--report PATH] [--json]
[--scale FACTOR] [--detach]
path
Argument Description
PATH Directory (or single USD/URDF file) to publish.
Option Description
--kind {robot,world,prop} Asset kind — selects the validation profile; never guessed. One of: robot, world, prop.
--name NAME Asset name slug (default: the slugified entry-file or directory name, echoed back).
--entry FILE Package-root-relative entry file — required only when auto-detection is ambiguous.
--root DIR Package root — the explicit security and portability boundary: dependencies are collected beneath it and never from elsewhere on this machine.
--base {fixed,floating} Robot base mode: fixed (bolted down — manipulators) or floating (mobile/legged). URDF cannot express this; default for URDF robots is fixed, always echoed. One of: fixed, floating.
--report PATH Write the validation (or local packaging) report JSON to PATH.
--json Print a machine-readable JSON result on stdout (progress lines go to stderr).
--scale FACTOR URDF only: global unit-scale applied by the cloud converter (e.g. 0.001 for a millimeter-authored URDF). Folds into content identity — the same source at a different scale is a new version; the source files are never rewritten.
--detach Return as soon as the upload completes, without waiting for cloud validation.