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

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

Built distributions (wheels)

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

Total release size: 95.5 MB

Release files / servo_client-0.7.19.tar.gz

Download URL servo_client-0.7.19.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
5929c85b6f4d0032234f9cf2fc3188dd1f4972796f807e647fcdcdbd6e423633
BLAKE2b-256 checksum
How to use checksums
a5cf53e113c34aff40d548e5d709675328af83d1500c8cc103bdd038811267e4
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.19-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.19-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
8d5933f4d259bb3f84b556e9aea469dbe794ca6be706534bfea38229fba8b411
BLAKE2b-256 checksum
How to use checksums
21db5395a95fad6ae7acf4a5580ed151938bf1c9fe194fed29089fb96836e4f8
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.19-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.19-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
3b623d7098ce34953d3cf43ccea56b9be6f8224b9c551c55949f0e30f3b9511f
BLAKE2b-256 checksum
How to use checksums
3b68437ef54a8ec83706c10c24d85388e2d40dea742a4b1afe05ed7683cb6cf5
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.19-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.7.19-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
67ec609adff43b6ae6173b0abdbb985375deec427064e33250fa5d8e05a80af6
BLAKE2b-256 checksum
How to use checksums
fce5a1c71dd89b41994d761f6d9709710c605175a6390b391bf549c7d6c0324d
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.19-py3-none-any.whl

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