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

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.10
File Size Uploaded
servo_client-0.7.10.tar.gz 864.9 kB Details

Built distributions (wheels)

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

Total release size: 77.5 MB

Release files / servo_client-0.7.10.tar.gz

Download URL servo_client-0.7.10.tar.gz
Size 864.9 kB
Tags Source
SHA-256 checksum
How to use checksums
7145232cbd5e192f5777615eefb5c95d6a7e3b77a63c92ca3bd5013478b6165b
BLAKE2b-256 checksum
How to use checksums
54fc6ef242a6f36557256eb4991e613d81e110cbae315e5cc825b953841a1a73
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.10-py3-none-manylinux_2_28_x86_64.whl

Download URL servo_client-0.7.10-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
61392e790326b7a8c73942be03a12e9e9854f3bde0f7d72ce641969e2347f4b3
BLAKE2b-256 checksum
How to use checksums
816fdf5cfbe41b393c4d2e65695456614a9964704305aa1a78c15ee250d63811
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.10-py3-none-manylinux_2_28_aarch64.whl

Download URL servo_client-0.7.10-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
ebf20a9d5fb7824eb154cb775e301d4852eee7eb03c8b5fa820d343eff57a278
BLAKE2b-256 checksum
How to use checksums
60b7858e8f26602745d6f2463ba42751cb289ccb6dba1a4758d0306047d2b399
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.10-py3-none-any.whl

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