Skip to main content

servo-client

Python and CLI access to Servo's hosted model inference service. Requires Python 3.12+.

pip install servo-client
servo login

Set SERVO_BASE_URL when using a different control plane.

Import a pi0.5 checkpoint and deploy near your application:

import numpy as np
import servo

sv = servo.Servo()
model = sv.models.import_checkpoint(
    "https://huggingface.co/npow/pi05-yam-red-cap-full-7500",
    revision="39c6876521b3d8363452bed6731c8705b3944c24",
)
deployment = model.deploy(city="Zurich, Switzerland").wait(timeout_s=900)
policy = deployment.policy()
inputs = {
    "middle": np.load("middle.npy"),
    "left": np.load("left.npy"),
    "right": np.load("right.npy"),
    "state": np.load("state.npy"),
}
with sv.session(policy, instruction="pick up the red cap") as session:
    chunk = session.predict(inputs=inputs)
print(chunk.actions)

Your application supplies arrays matching policy.input_contract. The inspected checkpoint specifies image dimensions, state shape, and output shape. Servo handles checkpoint loading, preparation, private endpoint access, and prediction; it does not control physical devices.

Save deployment.id and reconnect with sv.deployments.get(deployment_id). Deployment remains running until stopped with deployment.delete() or servo deployment stop <deployment-id>. A local timeout does not stop remote preparation or deployment; inspect status before retrying.

Quickstart

Third-party notices

The Linux platform wheels ship Tailscale's tailscaled and tailscale executables (servo/_native/), redistributed unmodified under the BSD 3-Clause license. The license, patent grant, and the notices for the dependencies compiled into them are installed with the package under servo/licenses/tailscale/.

Metadata

Release files for servo-client 0.7.20

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.7.20
File Size Uploaded
servo_client-0.7.20.tar.gz 1.0 MB Details

Built distributions (wheels)

Table of built distributions (wheels) for servo-client 0.7.20
File
servo_client-0.7.20-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details
servo_client-0.7.20-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details
servo_client-0.7.20-py3-none-macosx_13_0_arm64.whl Python 3 none macOS 13.0+ ARM64 Details
servo_client-0.7.20-py3-none-any.whl Python 3 none any Details

Total release size: 95.5 MB

Release files / servo_client-0.7.20.tar.gz

Download URL servo_client-0.7.20.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
dd281787a90b37eb409cc779ac60bb39bd671a7947f90092b3a1d1f28167a94c
BLAKE2b-256 checksum
How to use checksums
a52f3f9ef326b6040b8134a7d6fdcf525eea7bf3f7577170fbc0c22300d9e1ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

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

Download URL servo_client-0.7.20-py3-none-manylinux_2_28_x86_64.whl
Size 39.5 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
8308f9eb52c81d20ad7d2b40fb1e07eb5392f3152ea41b369df398ae6618234e
BLAKE2b-256 checksum
How to use checksums
80eb3ebe0ec8b8c642349a7fa2e2831d6315ffee7787c6462bdd71e453d33070
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

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

Download URL servo_client-0.7.20-py3-none-manylinux_2_28_aarch64.whl
Size 36.5 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
05adbb926f2b2f571166843db0b6f3a0894c09c009a645ca46cd58d759e494db
BLAKE2b-256 checksum
How to use checksums
4f52470b383e3adcb2eeee7d05a743c41ab3ea1addf33afc097abe27de4711cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

Release files / servo_client-0.7.20-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.7.20-py3-none-macosx_13_0_arm64.whl
Size 17.2 MB
Tags Python 3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
18eef5c913d874f03aedf68c023742a4b0dfe2a252ad4880a7edef83a4e27fe9
BLAKE2b-256 checksum
How to use checksums
9749bcc0efbd2d54c62e0d44dd60743f66038a65d8cb6f6921d2709f049535d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13

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

Download URL servo_client-0.7.20-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
9d30caa0749ca6cfe9bcd516ae88a81d5c66ac514641d2067718ea84f2a172a6
BLAKE2b-256 checksum
How to use checksums
38e62df0cf43731f24624a54f9b0dce01c7602da278cd7e839fd3782ea44773e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.13
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