Python SDK
Nutze Python für typisierten Roboterstatus, Datenabläufe und Anwendungsentwicklung. Das SDK verbindet sich über gRPC mit Robot Runtime; RuntimeReadClient bietet einen kompakten Einstieg für Lesezugriffe und Vorschauen, RuntimeClient stellt die vollständigen Runtime-Operationen bereit.
Installation
Prüfe auf einem vorbereiteten Kit-PC zuerst die installierte Software. Klone den Branch dev des Quickstarts-Repositories oder öffne den gelieferten Python-Quickstart-Ordner. Verwende Python 3.12, uv ab 0.13.7, Node.js 24 LTS und npm.
Für den Git-Einstieg:
git clone --branch dev --single-branch https://bitbucket.org/fruitcore/plexa-runtime-quickstarts.gitÖffne anschließend python/ im Git-Klon oder den gelieferten Python-Ordner und führe aus:
npm ci
uv sync --locked
npm run testkitDer Python-Ordner enthält SDK-Wheel 0.2.0 und Testkit 0.5.1 als lokale Pakete sowie die Lockfiles. Führe die Installationsbefehle in diesem Ordner aus. Für gewöhnliche Drittanbieterabhängigkeiten benötigt die Erstinstallation Registry-Zugriff oder einen vorhandenen Cache.
Erster Statusabruf — lokale Fixture
Lass den Testkit-Terminal laufen. Führe in einem zweiten Terminal im selben Ordner uv run --locked python examples/read_status.py aus. Das Beispiel prüft Runtime API 0.9.0 und erwartet HORST600_S5. Der installierte Client liest Status so:
from plexa_runtime_sdk import RuntimeReadClient
with RuntimeReadClient('127.0.0.1:19040', deadline_seconds=2.0) as runtime:
robots = runtime.list_robots()
if len(robots) != 1:
raise RuntimeError('Expected one local fixture robot')
robot = robots[0]
print('Robot:', robot.name, 'model:', robot.model_id)
print('Joints in degrees:', runtime.get_current_joints(robot.name))Erwarte einen Fixture-Roboter und sechs Gelenkwerte. Der Context Manager schließt den gRPC-Kanal. Dieses Loopback-Beispiel liefert Testdaten; es verbindet sich nicht mit deinem physischen Roboter. Vom SDK erzeugte ungesicherte Kanäle sind auf Loopback beschränkt.
Deine Anwendung erweitern
Gelenkwinkel verwenden Grad, kartesische Positionen Millimeter. Nutze die mit deinem System gelieferte Verbindungskonfiguration und prüfe die erwartete Roboteridentität.