Examples

Each file is one short, runnable script, kept in the examples directory of the SDK repository. Examples without a connection mode in their name use the saved robot (menlo setup); set MENLO_ROBOT=NAME to pick another. Read the docstring at the top of a file before you run it: it says what the robot must be doing.

git clone https://github.com/menloresearch/menlo-sdk.git
cd menlo-sdk
python examples/07_read_state.py

Connect

Script	What it shows
01_connect_udp.py	`udp` from an address on the robot's network; no SDK credential
02_connect_hybrid.py	`hybrid`: udp drive and state, LiveKit media, from the robot's address, its Asimov Manager URL and `MENLO_CREDENTIAL`
03_connect_livekit.py	`livekit` from anywhere, with the SDK credential

Move Safely

Script	What it shows
04_preflight.py	`preflight("move")`: every reason the robot is not ready, without sending anything
05_stand_and_walk.py	`stand()`, `wait_ready("move")`, a bounded `set_velocity(wait=True)`
06_stop_and_shutdown.py	cutting a hold short with `stop()`, and `damp()` on a supported robot

State

Script	What it shows
07_read_state.py	`robot.state`, `robot.armed`, the hottest joint, and the mode and alert callbacks

Joints

Script	What it shows
08_move_joints.py	`goto()` on one named joint, on a supported robot, then DAMP

Media

Script	What it shows
09_camera_and_audio.py	a photo, a clip with audio, and a tone on the speaker

Recording

Script	What it shows
10_record_and_replay.py	`robot.record()` for three seconds, then reading the file back

Without the SDK

Script	What it shows
11_raw_livekit.py	the protocol itself: a room token, one `RobotCommand` on the `commands` topic, state from the `state` track

Apps

Script	What it shows
apps/agent_room.py	the SDK half of a voice or vision agent: `look()` saves a photo, `walk()` is a bounded velocity
apps/follow_the_ball.py	a camera-driven walk: fresh frame or `stop()`, short holds, `hybrid` or `livekit`, needs numpy

Quickstart: the first script, step by step

Command Line: the same verbs without writing a script

On this page