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

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.8.1
File Size Uploaded
servo_client-0.8.1.tar.gz 1.1 MB Details

Built distributions (wheels)

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

Total release size: 95.6 MB

Release files / servo_client-0.8.1.tar.gz

Download URL servo_client-0.8.1.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
32cd765d89e2b3a510a91d5a3b9bcc2285848caa4f8f511449cafd473d3e0dc8
BLAKE2b-256 checksum
How to use checksums
102e72cf4d95518825710035e9f2fbb4bc814b34c7a96d3e52126ca326db6964
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.8.1-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.8.1-py3-none-manylinux_2_28_x86_64.whl
Size 39.6 MB
Tags Linux glibc 2.28+ x86-64 Python 3
SHA-256 checksum
How to use checksums
d25b5192c721717e830d73588e6b61659b5929c998ec7e366766322d03b59a10
BLAKE2b-256 checksum
How to use checksums
4a9760e816439fc7070b5debd06b7bde39bcd89d74986654222322ca42a83258
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.8.1-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.8.1-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
1ff889273eabe43b797286a17b6b1eef0bac19b9dbe843a994a21cd30f169509
BLAKE2b-256 checksum
How to use checksums
064dfc8d464f93286180402a6b85c9090e2169fd9e5864363959a63333ab6791
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.8.1-py3-none-macosx_13_0_arm64.whl

Download URL servo_client-0.8.1-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
ca8a9a296dd3f8eed9a1908a8689763acd17e6f357d12869ac167b12eccda560
BLAKE2b-256 checksum
How to use checksums
7cb6a5021692912f6fc823062bd89c7d4626b0a4fe8890e06fac0eb686cefd84
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.8.1-py3-none-any.whl

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