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

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.2
File Size Uploaded
servo_client-0.7.2.tar.gz 826.0 kB Details

Built distributions (wheels)

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

Total release size: 77.2 MB

Release files / servo_client-0.7.2.tar.gz

Download URL servo_client-0.7.2.tar.gz
Size 826.0 kB
Tags Source
SHA-256 checksum
How to use checksums
b32287592142797664113d7c82023fbeb346c0718e49356e5ef04cf98d70240b
BLAKE2b-256 checksum
How to use checksums
320a06cf2af3b48a075f7083587684470f5ee02ad405a0272071871375d84643
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.2-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.2-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
23cda7ba6c994000f507d088048bf468aa68fe7f06e8d68ae08c4434856bc3ef
BLAKE2b-256 checksum
How to use checksums
490927025b5946dcee35c4de5e6e817ac1de4fec5c3bc410d522e3e95b72d00c
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.2-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.2-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
23e5b962b023ec8b0c0a078a845f82f8d420ad166a28530b2bc90df5770b9f9e
BLAKE2b-256 checksum
How to use checksums
76b764a46457e41fee750126e6bd72b3903aa6e2cc42146124d0e5fdfc2b4ea6
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.2-py3-none-any.whl

Download URL servo_client-0.7.2-py3-none-any.whl
Size 955.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
334631cc103744da66f913ca341218b873d4b016c3cf716d9f5724276643c6a0
BLAKE2b-256 checksum
How to use checksums
6304ee379cb5961112b2a65016e156def1b5b639c7baf98411672c4219ceeb51
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