Skip to main content

bosdyn-client

The bosdyn-client wheel contains client interfaces for interacting with the Boston Dynamics Spot API. The client interfaces implement the Remote Procedure Calls (RPCs) defined in the bosdyn-api wheel.

Main Classes

The main classes contained in this wheel are Sdk and Robot.

  • Sdk: Class for settings typically common to a single developer and/or robot fleet.
  • Robot: Class for settings common to one user's access to one robot. This is the main point of access to all client functionality.

For example, to list the robot image sources using the Image client, simply create an Sdk object, create a Robot object, authenticate, create the client and call the corresponding method, as shown below. It is that simple!

>>> import bosdyn.client
>>> sdk = bosdyn.client.create_standard_sdk('image_capture')
>>> robot = sdk.create_robot(hostname)
>>> robot.authenticate(username, password)
>>> image_client = robot.ensure_client(ImageClient.default_service_name)
>>> image_sources = image_client.list_image_sources()

Clients that trigger robot movement also need to set up the TimeSync, Lease and E-Stop clients. Our examples repository contains many tutorials on how to use the clients included in this wheel.

Command-line Support

Some of the clients included in this wheel can also be accessed directly from the command-line.

python3 -m bosdyn.client hostname -h
usage: bosdyn.client [-h] [-v] [--username USERNAME] [--password PASSWORD]
                     hostname
                     {dir,payload,fault,id,license,log-status,state,log,data,time-sync,lease,become-estop,estop,image,local_grid,acquire,self-ip,power,keepalive}
                     ...

Command-line interface for interacting with robot services.
...

For example, to list the robot image sources from the command-line:

$ python3 -m bosdyn.client hostname image list-sources
back_depth                     (240x424)
back_depth_in_visual_frame     (480x640)
back_fisheye_image             (480x640)
frontleft_depth                (240x424)
frontleft_depth_in_visual_frame (480x640)
frontleft_fisheye_image        (480x640)
frontright_depth               (240x424)
frontright_depth_in_visual_frame (480x640)
frontright_fisheye_image       (480x640)
left_depth                     (240x424)
left_depth_in_visual_frame     (480x640)
left_fisheye_image             (480x640)
right_depth                    (240x424)
right_depth_in_visual_frame    (480x640)
right_fisheye_image            (480x640)

Release files for bosdyn-client 5.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for bosdyn-client 5.2.0
File Interpreter ABI Platform
bosdyn_client-5.2.0-py3-none-any.whl Python 3 none any Details

Release files / bosdyn_client-5.2.0-py3-none-any.whl

Download URL bosdyn_client-5.2.0-py3-none-any.whl
Size 312.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
02cb182acf5fc2c1aabd177a10cc8ce508a732ebcd69a1ca514ddb2ec92b553c
BLAKE2b-256 checksum
How to use checksums
2aca6e4dfdffe3a3f7820c67debe609b0407f26ab96ff9c3e2a4d7a15d3d6ca7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.10.12

Release history Release notifications | RSS feed

This release

5.2.0 This release

1 release file

5.1.9

1 release file

5.1.4

1 release file

5.1.1

1 release file

5.1.0

1 release file

5.0.1.2

1 release file

5.0.1

1 release file

5.0.0

1 release file

4.1.1

1 release file

4.1.0

1 release file

4.0.3

1 release file

4.0.2

1 release file

4.0.1

1 release file

4.0.0

1 release file

3.3.2

1 release file

3.3.1

1 release file

3.3.0

1 release file

3.2.3

1 release file

3.2.2

1 release file

3.2.1

1 release file

3.2.0

1 release file

3.1.2.1

1 release file

3.1.2

1 release file

3.1.1

1 release file

3.1.0

1 release file

3.0.3

1 release file

3.0.2

1 release file

3.0.1

1 release file

3.0.0

1 release file

2.3.5

1 release file

2.3.4

1 release file

2.3.3

1 release file

2.3.2

1 release file

2.3.0

1 release file

2.2.0

1 release file

2.1.0

1 release file

2.0.2

1 release file

2.0.1

1 release file

2.0.0

1 release file

1.1.2

1 release file

1.1.0

1 release file

1.0.1

1 release file

1.0.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page