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

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.18
File Size Uploaded
servo_client-0.7.18.tar.gz 957.8 kB Details

Built distributions (wheels)

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

Total release size: 95.0 MB

Release files / servo_client-0.7.18.tar.gz

Download URL servo_client-0.7.18.tar.gz
Size 957.8 kB
Tags Source
SHA-256 checksum
How to use checksums
850ec07153f5c7054303650183fd95f0fdaa7bcde62b348e0412c719bb51f038
BLAKE2b-256 checksum
How to use checksums
5712ee2a280d9f204c4c4899b3791a9eb5b79d4b641c5908644a0d4db131a215
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.18-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.18-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
613234b3ef35ac1a768b5f035cdcd42611290dd2c603cd34abc7eaf5f9cb104a
BLAKE2b-256 checksum
How to use checksums
e94823845c1d15b5b940265a4eda7dd55b61f90b3652de163f059a59d2a1faa9
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.18-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.18-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
8fa37d5558673eff83aa5d8b8fb43450afdcb2ad757e06e0749cf8acfe9aa737
BLAKE2b-256 checksum
How to use checksums
30ea0ca868eddc86c1d2e95fc8099814775647d6af392f4662bccf3b71dd88bc
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.18-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.7.18-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
796998c3b22c6200178a0155173568994257bb5d812e5115b166bdf2213bfd66
BLAKE2b-256 checksum
How to use checksums
3559f6475112226f46aa125dd17869a35adae1f33d87a71c73f2cd6677e86cc4
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.18-py3-none-any.whl

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