GRID Docs | General Robotics

How a call travels

from grid_nexus_client import make_robot
from grid_cortex_client import CortexClient, ModelType

robot = make_robot("go2-lab")        # grid-nexus-client: a RemoteRobot, a proxy for one robot
frame = robot.front.getImage()    # `front` is a subcomponent; getImage runs ON the robot
rgb = frame.decode()              # grid-types: the Image came back over the network
                                  # (fit it to the model's size limit, stated on each model page)
answer = CortexClient().run(ModelType.MOONDREAM, image_input=rgb, task="vqa", prompt="What is here?")
robot.shutdown()                  # client side: closes your connection; the robot is untouched

Every attribute on the proxy is either a method or a named subcomponent, and both are the robot’s own — apart from the few RemoteRobot defines on the client side (shutdown, monitor, session), which never reach the robot. What robot.front.getImage accepts is decided by the Go2 driver running on the robot, not by the client, which is why the reference is organised by robot. Connecting neither starts nor moves a robot. A method that fails on the robot arrives as RuntimeError naming the original error in its message, never as the original type. Direct or staged? make_robot(name) is direct dispatch: each call is one round trip, right for a program that reads sensors and issues commands in a loop from your machine. make_robot(name, program=...) stages a @program graph to run on the robot itself; reach for it when a loop must not round-trip. Start with direct dispatch.

Which reference answers which question

You want to…	Read	Start at
Connect to a robot and dispatch commands	grid-nexus-client	`make_robot`
What your robot accepts, method by method	Robots	Fanuc CRX-30iA Arm · Fanuc LR Mate 200iD Arm · Flexiv Rizon Arm · Universal Robots UR3e Arm · Universal Robots UR5e Arm · Galaxea R1 Pro Mobile Manipulator · Unitree Go2 Quadruped · Ghost Robotics Vision60 · Ghost Robotics Vision60 + Ghost Arm · Composite Rig · Clearpath Jackal
See what an attached camera can do (stereo pair, intrinsics, extrinsics)	Cameras	`ZedUSBCamera`
Look up what a robot can actually do (`standUp`, `getImage`, …)	Robot interface	`Robot`
Pass poses, velocities, images between all of the above	grid-types	`overview`
Call hosted models (depth, detection, grasping, VLMs, VLAs)	grid-cortex-client	`CortexClient`
Drive a robot in the AirGen (Unreal) simulator	AirGen robots	`AirGenDrone`
Drive a robot in the Isaac Sim simulator	Isaac robots	`IsaacArm`
Move objects and reset the scene in Isaac Sim	Isaac scene	`IsaacClient`

Every page in this section is generated from the package source — signatures, parameters, and examples are the code’s own docstrings, verified fresh in CI.

Python API

Python APIs

How a call travels

Which reference answers which question

​How a call travels

​Which reference answers which question

How a call travels

Which reference answers which question