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

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.17
File Size Uploaded
servo_client-0.7.17.tar.gz 956.9 kB Details

Built distributions (wheels)

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

Total release size: 95.0 MB

Release files / servo_client-0.7.17.tar.gz

Download URL servo_client-0.7.17.tar.gz
Size 956.9 kB
Tags Source
SHA-256 checksum
How to use checksums
4842160515b721e27c009d35b6fb52b283ca757dde556dbd0106b7563b64bf3a
BLAKE2b-256 checksum
How to use checksums
836c3456b0c208ef1b5851e106503cbe2a2e43bc2446cb2c21a937b0ab990d87
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.17-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.17-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
990c416d8f315639a3e98fc7ef19074e3a60076117cb8319a186cbadee2b4549
BLAKE2b-256 checksum
How to use checksums
aaaefc6aeb4fe754cffddbaf46e8d86a11828aa241d05f9e2676f7e77b4b55b2
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.17-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.17-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
9f6145f3663232ed622978d0c6600f1f5837144db22a238f10e7c644f6ef39e0
BLAKE2b-256 checksum
How to use checksums
b5f2f722ed68d80ccefc71e75904558ede744a85129d9cd63344c4cb8d625b02
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.17-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.7.17-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
5c6f4783435e7e2812a7bd78a79563c5d70df66115895a7227aed3dcbafa707a
BLAKE2b-256 checksum
How to use checksums
0a8423f9f16e78a1d98c8b583cf97e1c675f8aca96c6e42eff02e5f0a6f0cd4d
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.17-py3-none-any.whl

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