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

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.6
File Size Uploaded
servo_client-0.7.6.tar.gz 849.5 kB Details

Built distributions (wheels)

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

Total release size: 77.4 MB

Release files / servo_client-0.7.6.tar.gz

Download URL servo_client-0.7.6.tar.gz
Size 849.5 kB
Tags Source
SHA-256 checksum
How to use checksums
734988c1fb8ecfe718bd062d833d90009faabf0de4a932c27608daacda2a9065
BLAKE2b-256 checksum
How to use checksums
ec46c5ea3e7179b500878d3c0fd54f6df3135291f1eb7fe83e8b6c08366d87ae
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.6-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.6-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
e16a5a0990a2475b0f35cc10700e5299929547b46aa4581230da9c019cef6cf5
BLAKE2b-256 checksum
How to use checksums
bf2b9b1f42f984cd3e02bb233bffa56c366a439e4940e80e49d24978de35e828
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.6-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.6-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
44dec4e77cc5d7007bb3f91eebe512c32324022668c0cb08eb744e6885d45472
BLAKE2b-256 checksum
How to use checksums
5ad0e0d62da7f2a507ffcf1b23a48cf8f84f22ecf3ff2da1e9b6ec5013e08ed3
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.6-py3-none-any.whl

Download URL servo_client-0.7.6-py3-none-any.whl
Size 986.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0bb311c4dfe58e42d6eacbe9a0a9eb1cb1c501eb2baaf5054bc2cec20686f176
BLAKE2b-256 checksum
How to use checksums
6db54ff15b20b2d129fe6db1057beb5005f82f9b6ff0e9d06927661bc245d0d8
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