> ## 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 `grid robot setup` 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

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

# Staged mode: pass a @program (see grid-nexus-program) to get a RemoteDeployment.
```

Programs passed to `connect` are authored with **grid-nexus-program**; the end-to-end walkthrough is [Your first skill](/v1.0/get-started/first-skill).

## Classes

* [`RemoteRobot`](/v1.0/python-api/grid-nexus-client/remoterobot)
* [`RemoteDeployment`](/v1.0/python-api/grid-nexus-client/remotedeployment)
* [`MonitorClient`](/v1.0/python-api/grid-nexus-client/monitorclient)
* [`MonitorScope`](/v1.0/python-api/grid-nexus-client/monitorscope)
* [`MonitorSnapshot`](/v1.0/python-api/grid-nexus-client/monitorsnapshot)
* [`TraceReference`](/v1.0/python-api/grid-nexus-client/tracereference)
* [`GraphNodeStatus`](/v1.0/python-api/grid-nexus-client/graphnodestatus)
* [`PartyInstance`](/v1.0/python-api/grid-nexus-client/partyinstance)
* [`MonitorEvent`](/v1.0/python-api/grid-nexus-client/monitorevent)
* [`SessionState`](/v1.0/python-api/grid-nexus-client/sessionstate)
* [`HealthStatus`](/v1.0/python-api/grid-nexus-client/healthstatus)
* [`GridEndpointProfile`](/v1.0/python-api/grid-nexus-client/gridendpointprofile)

## Functions

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


## Related topics

- [GRID Cortex Client](/models/cortex.md)
- [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)