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

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.8.0
File Size Uploaded
servo_client-0.8.0.tar.gz 1.1 MB Details

Built distributions (wheels)

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

Total release size: 95.6 MB

Release files / servo_client-0.8.0.tar.gz

Download URL servo_client-0.8.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
8b766ac34c65f9bc43d248855aa4c286113e72e7d5b748c13237f69a24659a22
BLAKE2b-256 checksum
How to use checksums
0103c14df2ab3884ec96be2387495bb8ee377f1ffc9792ddac5b1c40c1cd907b
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.8.0-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.8.0-py3-none-manylinux_2_28_x86_64.whl
Size 39.6 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
f1f55fa42ce3fd554e1f05111a00ade18436d2527ba04de98b0242ee05b1847b
BLAKE2b-256 checksum
How to use checksums
fd6bf32080473882cceb74a61db28327626d4bda62372320023618e7f49aa3e9
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.8.0-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.8.0-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
85615d402b3d6607025ca967a8c076ac6c6838d3cfbeea3803d714b9b5ca167f
BLAKE2b-256 checksum
How to use checksums
ab60d5797e017a657c81a9584f826197e11d70db0d5a77c9b689d41ebc1aba7e
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.8.0-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.8.0-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
07016d42213ff0a04e316334f6a4cc9ad7250d414ab43879e5a479f47191b631
BLAKE2b-256 checksum
How to use checksums
6c60baa529898d0793389eec4e8723610cc255907b960775ce9fc5c99b6c49f4
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.8.0-py3-none-any.whl

Download URL servo_client-0.8.0-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
0ec739a9cde28ae38dbfa2edb8d096b20b2186ee686d4c94f09c7078b09cc31f
BLAKE2b-256 checksum
How to use checksums
3c39a4871ce410b1530d864d07d3fb3232e16fb58c79fb0c868c3d7d840621ae
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