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

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.5
File Size Uploaded
servo_client-0.7.5.tar.gz 846.4 kB Details

Built distributions (wheels)

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

Total release size: 77.4 MB

Release files / servo_client-0.7.5.tar.gz

Download URL servo_client-0.7.5.tar.gz
Size 846.4 kB
Tags Source
SHA-256 checksum
How to use checksums
7843a21cdaa86ba3666cea3dd3d169c0307d9dbac39928c2a59b93afe85c0a82
BLAKE2b-256 checksum
How to use checksums
e793f24d3ff8808a62044f1faba4ea8572d2a6f81f6cf8c3dd220c331c515df1
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.5-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.5-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
9e1fa9624deebcdcfdf911571faef21686851bc4121dd7267d424b58c42b950e
BLAKE2b-256 checksum
How to use checksums
fc82de94eba6418ff4ceba2dd48c18024107a1b569d73d967602c1f97a3c4064
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.5-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.5-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
fe41f0d8ecbc1a6d1a8fd40dfcbcd66a32bcfca012195cd19a8a65312266f105
BLAKE2b-256 checksum
How to use checksums
b175534bf581c3d0810dc5e2c1994714b9431be6606503966a95c138f92fa59f
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.5-py3-none-any.whl

Download URL servo_client-0.7.5-py3-none-any.whl
Size 982.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1f94323f7188584bcc05c66f48f1585333f0531bccd7c271682db78b3dc956fb
BLAKE2b-256 checksum
How to use checksums
5f4fa5b7d0182656e2d5af1f7dcd859de9b1aeb702f45268cb55f5781688300d
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