servo-client 0.1.2

Python SDK for Servo's hosted robot model API

servo-client

The public Python SDK for Servo's hosted robot model API.

Servo gives robotics teams one typed API for working with hosted robot policies, world models, datasets, fine-tuning jobs, evaluations, and deployments. Your application talks to Servo resources; Servo handles model-specific adapters, compatibility checks, provider orchestration, and usage tracking behind the hosted API.

Install

pip install servo-client

Quickstart

import os

import servo
from servo import templates

sv = servo.Servo(
    api_key=os.environ["SERVO_API_KEY"],
)

robot = sv.robots.register(templates.so101())
obs = templates.sample_observation(robot)

model = sv.models.get("smolvla")
model.inspect(robot)  # compatibility, cameras, action space, readiness

chunk = model.policy(robot, instruction="pick up the cube").act(obs)
print(chunk.actions[0])

What You Can Do

• Call hosted policy models through model.policy(robot).act(observation).
• Inspect model/robot compatibility before sending actions to hardware.
• Register robots, datasets, models, checkpoints, deployments, and jobs.
• Stream data, curate rollout failures, fine-tune, evaluate, and redeploy through one client.
• View hosted usage and billing state for your organization.

Authentication

Servo uses organization-scoped API keys:

export SERVO_API_KEY="sk_..."

Pass the key to servo.Servo(...); the client sends it as Authorization: Bearer <key>. The SDK uses Servo's hosted control plane by default. Set SERVO_BASE_URL only to target a different deployment, such as http://127.0.0.1:8000 during local development.

Package Boundary

This distribution contains only the public servo client and servo_contracts wire contracts. It does not include servo_platform, Modal app launchers, FastAPI routes, SQLAlchemy models, provider credentials, private endpoint URLs, or other hosted-service backend code.

Requirements

• Python 3.12+
• A Servo hosted API URL and organization API key