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

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.15
File Size Uploaded
servo_client-0.7.15.tar.gz 944.4 kB Details

Built distributions (wheels)

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

Total release size: 94.9 MB

Release files / servo_client-0.7.15.tar.gz

Download URL servo_client-0.7.15.tar.gz
Size 944.4 kB
Tags Source
SHA-256 checksum
How to use checksums
09cca916e32d34488be56aafdd8e252d30f707b3da5399b0284bc22245c2b587
BLAKE2b-256 checksum
How to use checksums
b7deb10b57df4ee6da25d2d7f33127b6a7196552a6f091c4eb9c80a841bc81e7
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.15-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.15-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
c1d2ce1154f852489e592afc2d34d621a5392398b268c2eff39bbd7388468e08
BLAKE2b-256 checksum
How to use checksums
e8bf95cce12af1f40561345364a65c713c6b18a1eb857281fd2a17fbf7f415c0
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.15-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.15-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
21f7266bf8f962fed5ed236ace57893957e2ef41a7a89020cb75c4b92d8cacb9
BLAKE2b-256 checksum
How to use checksums
955e62e0d058b147e39c7f3e1c42547cf2238558c812569d77a29831f4394248
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.15-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.7.15-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
a5d4efc3f2507fe53f513f03cf63ff92a78c11720bd8df13c4770e2097d7487b
BLAKE2b-256 checksum
How to use checksums
59f774710180c9fd627c3f0eb49026f9f11ed2cb10e27bdc7d0b63f5724ca0f4
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.15-py3-none-any.whl

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