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

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.7
File Size Uploaded
servo_client-0.7.7.tar.gz 851.4 kB Details

Built distributions (wheels)

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

Total release size: 77.4 MB

Release files / servo_client-0.7.7.tar.gz

Download URL servo_client-0.7.7.tar.gz
Size 851.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4fa3a54e08ff1ee30e9ec2248578a1ce588b3781064df80515253ee80db1b792
BLAKE2b-256 checksum
How to use checksums
b34045680c177502becc0a9e8f183be1c596d12b427328b4fe7c7758d6fd69ca
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.7-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.7-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
3eed76754b539291d5f0e2c71b27610171c1457a3c5c41cb7f4441d0da203647
BLAKE2b-256 checksum
How to use checksums
fbc6a421b336d65df8d81b1dda676465faf58aadd0b50fb6331aafece6bc1076
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.7-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.7-py3-none-manylinux_2_28_aarch64.whl
Size 36.3 MB
Tags Linux glibc 2.28+ ARM64 Python 3
SHA-256 checksum
How to use checksums
ff9e5deb7fe6b9c5c78e8153582ddd6389739136113383f87eaa34d6ae225133
BLAKE2b-256 checksum
How to use checksums
d982cad7237241f73d924a317eba6e4231bad5d18f549709fc8c72f82361674e
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.7-py3-none-any.whl

Download URL servo_client-0.7.7-py3-none-any.whl
Size 988.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a652b4d2e96f65481200545cbc59577383e128b76c6185927bbaadcb0043ec78
BLAKE2b-256 checksum
How to use checksums
158a31bc85b5fcfa0f445b71282266d67568a09c81a1ebe4110813c34aa45683
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