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

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.11
File Size Uploaded
servo_client-0.7.11.tar.gz 875.5 kB Details

Built distributions (wheels)

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

Total release size: 77.5 MB

Release files / servo_client-0.7.11.tar.gz

Download URL servo_client-0.7.11.tar.gz
Size 875.5 kB
Tags Source
SHA-256 checksum
How to use checksums
65f7a25c4aa1b1dbe88c2b99a24335acb9b3563ed651da3dc2a345347d59d8ef
BLAKE2b-256 checksum
How to use checksums
605d85bee5cbeff51c2b72f12e56e7879b6410e431cc299f3d4ca59c5826e6c2
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.11-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.11-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
92d91e8a11a6f2501ff592073d0ff5619d96cf6df4a813711561ce34e7fa4cdb
BLAKE2b-256 checksum
How to use checksums
08899c4272c5962f0999ec81c83235fc8257492077af0c0f3509d659f323f599
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.11-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.11-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
89148239ad11453da0756ee2ed017b5f35d89ecd8be6187edba1077f939b9d40
BLAKE2b-256 checksum
How to use checksums
13f3ee9433d6f2e1a27b2f1294ca39de420259a948bcf22640b061ca9a8e641a
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.11-py3-none-any.whl

Download URL servo_client-0.7.11-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
067b2d5a685f27fbeb3b0cccec4a18e6632b441d1f739591ef4737c1c1875eff
BLAKE2b-256 checksum
How to use checksums
db9999cfbe109d23f2fd6738063b83f5f5ff283659deaa375e9b40ba879dcff3
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