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

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.13
File Size Uploaded
servo_client-0.7.13.tar.gz 922.0 kB Details

Built distributions (wheels)

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

Total release size: 94.8 MB

Release files / servo_client-0.7.13.tar.gz

Download URL servo_client-0.7.13.tar.gz
Size 922.0 kB
Tags Source
SHA-256 checksum
How to use checksums
984a9023bee33fa247b05d7bdd0184a1573a14eabb2f603092f10c90f4cb77b7
BLAKE2b-256 checksum
How to use checksums
6e3e67a81bd8aec26fc5d7171df60480d6393561b6065b13ca9451371ba731b1
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.13-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.13-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
cde97c541026c86fe1a43946e26607e8c0a1a3b5fb4d344e0a84d0bfaffb041f
BLAKE2b-256 checksum
How to use checksums
55850ad1e3b9e048dce270535c5ee60e41506e2ef81fdd00cdd744d134fdca8e
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.13-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.13-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
874d056c5ca7c683415b703b39f7905f511ee2b13eb145d94f539f6b4882f20a
BLAKE2b-256 checksum
How to use checksums
d41970cc3fa9af9663062ce9937e7b53bf919d574afe73309d8a6daf5c1cdfcc
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.13-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.7.13-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
e8573e0fdb4b4ab19aa95b501d2b8c8d7f7db9e947108c444ae057cb0dd375c4
BLAKE2b-256 checksum
How to use checksums
db90439fa9b12167a9c31dcbe17c6d2b4c3090ada6bc54ef313e14014162fae7
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.13-py3-none-any.whl

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