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.16

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.16
File Size Uploaded
servo_client-0.7.16.tar.gz 954.1 kB Details

Built distributions (wheels)

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

Total release size: 95.0 MB

Release files / servo_client-0.7.16.tar.gz

Download URL servo_client-0.7.16.tar.gz
Size 954.1 kB
Tags Source
SHA-256 checksum
How to use checksums
613a373f903763cdd23d9721950fe22e25b4c67beef69dabb36ccf32d3b15c02
BLAKE2b-256 checksum
How to use checksums
843361415b41470f9598a38b61bd6c7fabc60a1dd9534a67ef61f41b60f88efd
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.16-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.16-py3-none-manylinux_2_28_x86_64.whl
Size 39.4 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
f6d3c20cab1463072e7b6570e1660884aed9322d465076c695a5a54017932a9a
BLAKE2b-256 checksum
How to use checksums
63afbada5d7390707c8923bf2f09651f4b04072ef13ef479ac6894750809b8d7
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.16-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.16-py3-none-manylinux_2_28_aarch64.whl
Size 36.4 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
9c20f6c4bfa2dad43e4d0e9d8f639692c86a5495edf07bb84bd9cc1197e8bc8c
BLAKE2b-256 checksum
How to use checksums
f15eb5e1b7728e9e5ce89522e0039a80c7069520f2d6af4b8848022436542fb1
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.16-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.7.16-py3-none-macosx_13_0_arm64.whl
Size 17.1 MB
Tags Python 3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
a85684c6fa305acbeca2bc9de13169db7a8a58da5980d6ec754db666c257e252
BLAKE2b-256 checksum
How to use checksums
b908a8821d5567cbd199b388623b5df5ecc83bf4391e75c04454c7d35cb230cd
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.16-py3-none-any.whl

Download URL servo_client-0.7.16-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
f0e03e1d359d1a4725d7ceb5ecb04bd5cc70fc42e6859eda1923bac753cf93d6
BLAKE2b-256 checksum
How to use checksums
beaae0cfcdc50f3631ca13022ec16baeda84d7a9b4ec03a41bff9b658479c380
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