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

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.9
File Size Uploaded
servo_client-0.7.9.tar.gz 864.1 kB Details

Built distributions (wheels)

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

Total release size: 77.5 MB

Release files / servo_client-0.7.9.tar.gz

Download URL servo_client-0.7.9.tar.gz
Size 864.1 kB
Tags Source
SHA-256 checksum
How to use checksums
1ed633bbe899ecd45c2780219684f1f8f44917720141a2a5e694bfab54fde2aa
BLAKE2b-256 checksum
How to use checksums
e194cfd69121418d616424022a1ae890a1660594257c506f57ccbc070b3071e9
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.9-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.9-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
9b5fafb73422c4e907349cca6b12cfd04d176174cd88b2f0dd2f9d678767bfd4
BLAKE2b-256 checksum
How to use checksums
1d5afbf64ba265ad5ab7c8faa5aec89dfb57e205225cb384d6772c301f7528d8
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.9-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.9-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
174ef06c61745b9628a677f1710e74f45c69df9fb01a4b44465695e0fef80536
BLAKE2b-256 checksum
How to use checksums
f12c6044c8a3f87321ac86031e1b743fc67acd7c3f4f15b02c3a61beb005d306
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.9-py3-none-any.whl

Download URL servo_client-0.7.9-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
15581ee1619deee9921c0850b2154fcf2c45ce0a6b3027641d62614d258f088e
BLAKE2b-256 checksum
How to use checksums
d99a3847a17a1f618b9654b5a1fe9a1761503b9d4ff88ab20dad986b5d68f160
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