> ## 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.

# grid-nexus-client

> Python client for GRID Nexus

Python client for GRID Nexus — connect to a robot on the GRID network for direct command dispatch (`RemoteRobot`) or staged program deployment (`RemoteDeployment`), with live monitoring of the running graph.

## Install

```bash theme={null}
# Preinstalled in every GRID session workspace. For local use, install
# from the GRID package index with your organization's read-only
# credentials (the same pair `robot add` provisions on robots):
export UV_INDEX_GRID_PYPI_USERNAME=<username>
export UV_INDEX_GRID_PYPI_PASSWORD=<token>
uv pip install grid-nexus-client --index grid-pypi=https://pypi.generalrobotics.dev/simple/
```

## Quickstart

```python theme={null}
from grid_nexus_client import connect
from grid_types import Velocity

# Direct dispatch: a RemoteRobot whose methods are the robot's capabilities.
robot = connect("<robot-name>")
robot.getState()

# standUp/moveByVelocity are a quadruped's; what any given robot
# exposes is its own — see Robot interface.
robot.standUp()
robot.moveByVelocity(Velocity(0.1, 0.0, 0.0), Velocity(0.0, 0.0, 0.0))
```

The methods a `RemoteRobot` exposes are the robot's own — see **Robot interface** for the catalog. The end-to-end walkthrough is [Your first skill](/v2.1/get-started/first-skill).

## Classes

* [`RemoteRobot`](/v2.1/python-api/grid-nexus-client/remoterobot)
* [`RemoteDeployment`](/v2.1/python-api/grid-nexus-client/remotedeployment)
* [`MonitorClient`](/v2.1/python-api/grid-nexus-client/monitorclient)
* [`MonitorScope`](/v2.1/python-api/grid-nexus-client/monitorscope)
* [`MonitorSnapshot`](/v2.1/python-api/grid-nexus-client/monitorsnapshot)
* [`TraceReference`](/v2.1/python-api/grid-nexus-client/tracereference)
* [`BlockStepSubscription`](/v2.1/python-api/grid-nexus-client/blockstepsubscription)
* [`BlockStep`](/v2.1/python-api/grid-nexus-client/blockstep)
* [`FailedStep`](/v2.1/python-api/grid-nexus-client/failedstep)
* [`GraphNodeStatus`](/v2.1/python-api/grid-nexus-client/graphnodestatus)
* [`PartyInstance`](/v2.1/python-api/grid-nexus-client/partyinstance)
* [`MonitorEvent`](/v2.1/python-api/grid-nexus-client/monitorevent)
* [`SessionState`](/v2.1/python-api/grid-nexus-client/sessionstate)
* [`HealthStatus`](/v2.1/python-api/grid-nexus-client/healthstatus)
* [`GridEndpointProfile`](/v2.1/python-api/grid-nexus-client/gridendpointprofile)

## Functions

* [`connect`](/v2.1/python-api/grid-nexus-client/connect)
* [`observe`](/v2.1/python-api/grid-nexus-client/observe)
* [`resolve_grid_profile`](/v2.1/python-api/grid-nexus-client/resolve_grid_profile)


## Related topics

- [grid-cortex-client](/python-api/grid-cortex-client/overview.md)
- [CortexClient](/python-api/grid-cortex-client/cortexclient.md)
- [AsyncCortexClient](/python-api/grid-cortex-client/asynccortexclient.md)
- [CortexHubClient](/python-api/grid-cortex-client/cortexhubclient.md)
- [Overview](/models/overview.md)