> ## Documentation Index
> Fetch the complete documentation index at: https://docs.generalrobotics.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# RemoteRobot

> Live connection to a remote robot, with its methods exposed as Python attributes

```python theme={null}
from grid_nexus_client import RemoteRobot
```

Live connection to a remote robot, with its methods exposed as Python attributes.

Created by `connect()` when no program is provided. The robot is the
root of a recursive component tree discovered at construction time:
robot methods are direct calls (`robot.set_velocity(0.5)`), and every
named subcomponent — sensors, end effector, arms, and their own
children — is a `RemoteComponent` reachable both via the
`subcomponents` mapping and as an attribute
(`robot.left_arm.wrist_cam.getImage()`).

## Fields

<ResponseField name="subcomponents">
  Dict of child name → RemoteComponent for every top-level child of the robot.
</ResponseField>

<ResponseField name="sensors">
  Derived dict of the children whose remote role is sensor.
</ResponseField>

<ResponseField name="end_effector">
  Derived RemoteComponent for the child end effector, or None.
</ResponseField>

## Constructor

```python Signature theme={null}
RemoteRobot(
    handle: RobotHandle,
    client: SignalingClient | None = None,
    signaling_url: str | None = None,
)
```

## Properties

<ResponseField name="end_effector" type="RemoteComponent | None">
  The child end effector, or `None` (derived view).

  Prefers the child named `"end_effector"`, else the first child
  whose remote role is end effector.
</ResponseField>

<ResponseField name="monitor" type="MonitorClient" />

<ResponseField name="robot_id" type="str" />

<ResponseField name="sensors" type="dict[str, RemoteComponent]">
  Child components whose remote role is sensor (derived view).
</ResponseField>

<ResponseField name="session" type="RobotHandle">
  The underlying low-level robot handle (Zenoh session).
</ResponseField>

<ResponseField name="subcomponents" type="dict[str, RemoteComponent]">
  Named child components of this node (snapshot dict).
</ResponseField>

<ResponseField name="zenoh_session_config" type="str" />

## Methods

### `shutdown()`

```python Signature theme={null}
shutdown()
```

Close this Python handle's local resources and owned signaling session.


## Related topics

- [CLI reference](/cli/reference.md)
- [The Intelligence Grid for Physical AI](/introduction.md)
- [Common FAQs](/faq/common-faqs.md)
- [Your first session](/get-started/first-session.md)
- [Environment Config](/simulation/isaac/session_configuration/env.md)