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

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.4
File Size Uploaded
servo_client-0.7.4.tar.gz 845.2 kB Details

Built distributions (wheels)

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

Total release size: 77.4 MB

Release files / servo_client-0.7.4.tar.gz

Download URL servo_client-0.7.4.tar.gz
Size 845.2 kB
Tags Source
SHA-256 checksum
How to use checksums
b6be4667b0b7342e9bbf7d67edaa82072c7b8bfaf0f99a66992a0f5c2fecbdd4
BLAKE2b-256 checksum
How to use checksums
49146473dc5ed7a873f4e25fe356ef52f944c78b46bf43cc0fc84c21d87105fd
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.4-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.4-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
78d281ece4ae827e55c93037cd9516773720d564e62c2bb66d3dec43e3df1876
BLAKE2b-256 checksum
How to use checksums
0d69e3aa327a2d0160e84153ebdead38a223471b3aef3c487a483c32d00e76fb
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.4-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.4-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
9fb2cceba12e1f9b032a2df5e09fcef8fa3d604456a623be21e86e6370707045
BLAKE2b-256 checksum
How to use checksums
e6de7dcf6ad276850b10e6be6d55ba1b25027083451f45c412d19acba6f9ddf0
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.4-py3-none-any.whl

Download URL servo_client-0.7.4-py3-none-any.whl
Size 980.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f42fdd6cfad12843e2b9a5ef6bd07914395726f1094cfdb29bb55c9dcec938d5
BLAKE2b-256 checksum
How to use checksums
6a5f55f8337d973a0bd58f2d8e45ce05cdb4c93f3d45fbac406e1ae4ccabeda8
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