Skip to content

Command-line interface

The inspect_robots CLI wraps the registry and eval.

inspect-robots list

Show registered components (builtins + installed plugins):

inspect-robots list                 # all kinds
inspect-robots list policies        # just one kind
inspect-robots list embodiments

inspect-robots run

Resolve a task/policy/embodiment from the registry and run an eval. Pass constructor arguments with -T (task), -P (policy), and -E (embodiment) as key=value (parsed as bool/int/float/None/str):

inspect-robots run --task cubepick-reach --policy scripted --embodiment cubepick
inspect-robots run --task cubepick-reach -T num_scenes=10 --policy scripted -P chunk_size=8 \
             --embodiment cubepick --log-dir logs --seed 0

The exit code is 0 on a successful eval, 1 otherwise.

inspect-robots inspect

Print a summary of a saved EvalLog:

inspect-robots inspect logs/cubepick-reach_xxxx.json
task:        cubepick-reach
policy:      scripted
embodiment:  cubepick
status:      success
scenes:      5   trials: 5
metrics:
  success_at_end: 1
scenes:
  [success] scene-0: success_at_end=1
  ...

inspect-robots --version

inspect-robots --version