ekstra-provider-sdk 0.1.1

Standalone Python provider SDK for the Ekstra motion network

Ekstra.OS Python Provider SDK

This folder presents the standalone Python SDK surface for Ekstra.OS.

Current implementation:

• source: ekstra_os/providers/sdk.py
• primary class: ProviderSDK
• package wrapper: sdk/python/src/ekstra_provider_sdk
• purpose: minimal provider helper for publishing MotionSample events into motiond

Install shape

Package metadata now lives in sdk/python/pyproject.toml.

The distributable package name is:

ekstra-provider-sdk

Published install:

pip install ekstra-provider-sdk

Primary import:

from ekstra_provider_sdk import MotionSample, ProviderSDK

What it supports today

1. Provider identity connect
2. Provider manifest registration
3. Attested provider registration
4. Heartbeat management
5. Motion sample publish
6. Automatic reconnect on publish failure

Primary source

from ekstra_provider_sdk import MotionSample, ProviderSDK

provider = ProviderSDK(
    provider_id="python-provider",
    actor_id="actor-1",
    parts=["hand.right"],
)
provider.connect({"name": "Python Provider"})

sample = MotionSample(
    actor_id="actor-1",
    part="hand.right",
    frame="device:python",
    timestamp=1.0,
)
provider.publish_sample("motion.samples", sample)
provider.close()

Test

$env:PYTEST_DISABLE_PLUGIN_AUTOLOAD='1'
python -m pytest -q ekstra_os/tests/test_provider_sdk.py ekstra_os/tests/test_python_sdk_package.py
python sdk/python/scripts/smoke_build_install.py

Current status

• Verified locally on 2026-03-13
• Builds as a standalone Python distribution under sdk/python
• Still depends on the main ekstra-os runtime package for the underlying implementation

Release

Python release tags:

python-sdk-vX.Y.Z

The release workflow verifies:

1. provider SDK tests
2. wheel and sdist build
3. clean virtual environment install smoke
4. twine check
5. publish only on release tags or explicit manual release