Skip to main content

servo-client

The public Python SDK and CLI for Servo.

Install

pip install 'servo-client>=0.2.1,<0.3'
export SERVO_BASE_URL="https://<your-servo-control-plane>"
servo login
servo key create --label laptop
export SERVO_API_KEY="sk_servo_..."

Bimanual YAM example

import os
import servo
from servo import templates

sv = servo.Servo(
    base_url=os.environ["SERVO_BASE_URL"],
    api_key=os.environ["SERVO_API_KEY"],
)
robot = sv.robots.register(templates.yam())
model = sv.models.get("molmoact2")

report = model.inspect(robot)
if not report.compatible:
    raise RuntimeError(report.issues)

policy = model.policy(robot, instruction="put everything into the box")
prediction = policy.act(templates.sample_observation(robot))

Use sv.session(policy) for a robot control loop. The client never automatically replays mutations or actions.

Package boundary

Public application APIs live in servo. Extension packages are servo_action_session, servo_data, and servo_observation. servo_contracts and servo_telemetry are implementation dependencies.

Requires Python 3.12+, a Servo control-plane URL, and an organization API key.

Full documentation

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

servo_client-0.2.1.tar.gz (482.3 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

servo_client-0.2.1-py3-none-manylinux_2_28_x86_64.whl (2.1 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ x86-64

servo_client-0.2.1-py3-none-manylinux_2_28_aarch64.whl (2.0 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ ARM64

servo_client-0.2.1-py3-none-any.whl (555.8 kB view details)

Uploaded Python 3

File details

Details for the file servo_client-0.2.1.tar.gz.

File metadata

  • Download URL: servo_client-0.2.1.tar.gz
  • Upload date:
  • Size: 482.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for servo_client-0.2.1.tar.gz
Algorithm Hash digest
SHA256 c5cb60bbd8ca8e76fc2c6026f42b650d8bed18a6b5106765c642caf137c97dc8
MD5 f471366dada5bb520d0a759f6d187098
BLAKE2b-256 25b35c91f611e93df0a6a3a17b14431a84f4601aa18bf37a7852998dd18cd2a1

See more details on using hashes here.

Provenance

The following attestation bundles were made for servo_client-0.2.1.tar.gz:

Publisher: pypi-publish.yml on npow/servo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file servo_client-0.2.1-py3-none-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for servo_client-0.2.1-py3-none-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 d7f09c903c308e9bb79eef18a8b52dd1b41b20f520ad8320f6ab4226e23db1d8
MD5 5b93188501e1f141ca533c58a5feee7e
BLAKE2b-256 a5f3d31366a5501aac23369be0435f002d060c67b2fb76d5b4924132c0f4a6e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for servo_client-0.2.1-py3-none-manylinux_2_28_x86_64.whl:

Publisher: pypi-publish.yml on npow/servo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file servo_client-0.2.1-py3-none-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for servo_client-0.2.1-py3-none-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 be990112274095e5a597ec0e05852cf85eec1b360d4c854d469b923973acfc61
MD5 50e1b1edcb6daf8eff43442db17976b7
BLAKE2b-256 758b42dbdfdf04d10d1d4906ab2e06aed16cfb3a22a2ba37f287f0bb4141cfb5

See more details on using hashes here.

Provenance

The following attestation bundles were made for servo_client-0.2.1-py3-none-manylinux_2_28_aarch64.whl:

Publisher: pypi-publish.yml on npow/servo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file servo_client-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: servo_client-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 555.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for servo_client-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0fd8a265cf4f1d2e0387129de674e3672a295a0994fe41478367bf91e2a402f4
MD5 a4d42ae4e3a7e8d6f34836342b991cdf
BLAKE2b-256 493f51b97deac44a43877aa38b958d5946a646d1cd19fd3e882425c70de66976

See more details on using hashes here.

Provenance

The following attestation bundles were made for servo_client-0.2.1-py3-none-any.whl:

Publisher: pypi-publish.yml on npow/servo

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.4.0

4 files

This release

0.2.1 This release

4 files

0.2.0

4 files

0.1.2

1 file

0.1.1

1 file

0.1.0

1 file

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