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

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.14
File Size Uploaded
servo_client-0.7.14.tar.gz 938.7 kB Details

Built distributions (wheels)

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

Total release size: 94.9 MB

Release files / servo_client-0.7.14.tar.gz

Download URL servo_client-0.7.14.tar.gz
Size 938.7 kB
Tags Source
SHA-256 checksum
How to use checksums
69eb0128cab37cbc8deaf6932851021c21e7b1c9304a0dd24f17305a45868222
BLAKE2b-256 checksum
How to use checksums
7d90fb432f9ab65320c3800ab2ca3063f124548cf5319246f2f13780f087bd94
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.14-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.14-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
b017ab6d121d8bf89e9b54d6e36602e0e553e957281ee56b4600f73fadb21b6c
BLAKE2b-256 checksum
How to use checksums
0587331ec68d21f1d01e3549862bac6c2067ccd19b5f96aa20db55267cff8351
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.14-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.14-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
5c7bcacb7d2201ade1345da999f36de19d6ddbb50d43a13f2cac9b93f4d325d5
BLAKE2b-256 checksum
How to use checksums
83acc7e4f07225d5eb0cc6f2bf463ed41e481d562343856e5d82662449225458
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.14-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.7.14-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
9fbf8cfa45ddd4dcd73d569ba4f30293795867270b337d9961f03e0bc1d185dd
BLAKE2b-256 checksum
How to use checksums
39bef657875672c30ab472c657895bf0bdcffa02d557f62630b93ca30d6e5f4b
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.14-py3-none-any.whl

Download URL servo_client-0.7.14-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a1a8d30a887047bbc6af9783eec3cbf9cde1c3ed5ab9293aeb4c597ceee486bb
BLAKE2b-256 checksum
How to use checksums
750e94b847fa51c82631a600e410535fbc2941b8c3b69da4f56d9ae54f3f5151
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