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

A machine can use its organization API key through SERVO_API_KEY instead. 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.3

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.3
File Size Uploaded
servo_client-0.7.3.tar.gz 841.2 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for servo-client 0.7.3
File Interpreter ABI Platform
servo_client-0.7.3-py3-none-manylinux_2_28_x86_64.whl Python 3 none Linux glibc 2.28+ x86-64 Details
servo_client-0.7.3-py3-none-manylinux_2_28_aarch64.whl Python 3 none Linux glibc 2.28+ ARM64 Details
servo_client-0.7.3-py3-none-any.whl Python 3 none any Details

Total release size: 77.3 MB

Release files / servo_client-0.7.3.tar.gz

Download URL servo_client-0.7.3.tar.gz
Size 841.2 kB
Tags Source
SHA-256 checksum
How to use checksums
22458660cfe400b86ee3fc061714feb671c44164d2ed5c669e209840d7a657d0
BLAKE2b-256 checksum
How to use checksums
96e6c11b54ae476e9f48969f62b5d1e13a1acf8d83b4e2929e408605303afb86
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.3-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.3-py3-none-manylinux_2_28_x86_64.whl
Size 39.3 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
4be15a1edff9104b7637b681fb5634a93ac0101460502744de28c4948d08cc18
BLAKE2b-256 checksum
How to use checksums
671daef29b76c31217e4c0a08a7dac14c4b565eb70299efb5ad9fdc0ace46da2
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.3-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.3-py3-none-manylinux_2_28_aarch64.whl
Size 36.2 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
c11ab6170c313176302237e48dabe8ca95e9b66d2615592bae549d569a0fa6f1
BLAKE2b-256 checksum
How to use checksums
9c0ae1802e884b537399536ab209183e2684350cded8d70b1210799af8a9af79
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.3-py3-none-any.whl

Download URL servo_client-0.7.3-py3-none-any.whl
Size 975.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
acac2c900bd7b92283b2c2aab262be50416d7b6fcfb079ec17e5464f7f51e44c
BLAKE2b-256 checksum
How to use checksums
3d65ae3834ebd64d026c2470198b05ea421d27d94c34c4499d0bf6c4f7620e51
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