Skip to main content

servo-client

Python and CLI access to Servo's hosted robot policy service.

pip install 'servo-client>=0.4,<0.5'
export SERVO_BASE_URL="https://<your-servo-control-plane>"
servo login
servo account
servo key create --label yam-cell-01
export SERVO_API_KEY="sk_servo_..."

Register a Bimanual YAM on its robot computer, then list compatible models:

servo robot setup yam-cell-01 \
  --config /opt/yam/configs/yam_left.yaml \
  --config /opt/yam/configs/yam_right.yaml \
  --region us-west-2

servo model list yam-cell-01

Run pi0.5 with the calibrated robot object from your application:

import os

import servo
from my_robot_app import open_yam

sv = servo.Servo(
    base_url=os.environ["SERVO_BASE_URL"],
    api_key=os.environ["SERVO_API_KEY"],
)
robot = sv.robots.attach("yam-cell-01", runtime=open_yam)
model = sv.models.get("pi0.5")
deployment = model.deploy(robot=robot).wait(timeout_s=900)
policy = deployment.policy(robot, instruction="place the red lid on the black box")
check = robot.check(policy)
print(check.completed, len(check.chunks), check.steps)
robot.run(policy, seconds=120)

open_yam is the factory function that opens the calibrated YAM runtime. Servo recognizes its camera, joint-state, command, and close methods directly. --config accepts your local hardware configuration files (or placeholder files for testing), which Servo hashes to record an immutable fingerprint. Calibration and device configuration stay in your application.

Save deployment.id and reuse it with sv.deployments.get(deployment_id). Review active capacity with servo deployment list, and stop unused capacity with servo deployment stop <deployment-id>.

Requires Python 3.12+, a Servo control-plane URL, and an organization API key.

Quickstart · Robots and calibration · Robot fleets

Metadata

Release files for servo-client 0.5.1

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

Source distribution (sdist)

Source distribution for servo-client 0.5.1
File Size Uploaded
servo_client-0.5.1.tar.gz 807.8 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for servo-client 0.5.1
File Interpreter ABI Platform
servo_client-0.5.1-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details
servo_client-0.5.1-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details
servo_client-0.5.1-py3-none-any.whl Python 3 none any Details

Total release size: 6.6 MB

Release files / servo_client-0.5.1.tar.gz

Download URL servo_client-0.5.1.tar.gz
Size 807.8 kB
Tags Source
SHA-256 checksum
How to use checksums
bf5ffaa84a32dc205b90e1f0372e5a2d8ad599f2289fd46ddb968571c5928e87
BLAKE2b-256 checksum
How to use checksums
5e6e31d2640b5d5ee482fbcfe0bf6f8af096ff7cf80eb50d17439272aba0b700
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.14

Release files / servo_client-0.5.1-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.5.1-py3-none-manylinux_2_28_x86_64.whl
Size 2.5 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
2ef849bfbd9a9563b4a399d9c0c61047b16d9899a6dd1d6e4e4ad95beea0face
BLAKE2b-256 checksum
How to use checksums
de3c28f9979fd7e0f131436b4af45b033d42122c5dff6faeeb31547c4f5bd454
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.14

Release files / servo_client-0.5.1-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.5.1-py3-none-manylinux_2_28_aarch64.whl
Size 2.4 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
b594477ea112c7c424e6b2181db8ad85a4f476ee8ff154238d5fd3b44e6fb5bd
BLAKE2b-256 checksum
How to use checksums
a42f6744b2ebacd17c0c91150167d4e594244e0783b075414e0961f393ec1602
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.14

Release files / servo_client-0.5.1-py3-none-any.whl

Download URL servo_client-0.5.1-py3-none-any.whl
Size 928.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
943643705e07b4e2821485bbd52887cd03b94f6ff64707dce27247f8a0a789c8
BLAKE2b-256 checksum
How to use checksums
22184409101d119ef6e531885e493b45eb72911663d10665d45b051227309c76
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.14
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