wandelbots_api_client

What it is and what it does

wandelbots-api-client is a Python SDK that wraps the Wandelbots robot control API, enabling developers to authenticate and interact with Wandelbots robot systems programmatically. It implements OAuth2 device code flow authentication for both Entra ID and Auth0, making it suitable for CLI applications, scripts, and headless environments where interactive browser-based login is impractical.

The package is built on async/await patterns using aiohttp and websockets, allowing concurrent API calls and real-time communication with robot instances. It uses pydantic for data validation, furl for URL handling, and pyhumps for JSON field transformation. The SDK targets API version 1.5.0 and requires Python >=3.9, with a pure-wheel distribution that installs with low friction.

Use it for:

• Authenticate a CLI tool or headless script using device code flow, then make authenticated API calls to control or query robot state.
• Build an async Python application that maintains a long-lived connection to a Wandelbots instance with token refresh.
• Integrate Wandelbots robot control into a larger automation pipeline where OAuth2 credentials are managed centrally.
• Develop real-time monitoring dashboards that use websockets to stream robot telemetry asynchronously.
• Test or prototype robot behaviors by scripting API calls in Python without building a full UI application.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python SDK for authenticating with and making API calls to Wandelbots robot control systems, supporting OAuth2 device code flow via Entra ID or Auth0.

Yes. The package is actively maintained (released within 10 days), has low install friction, carries no known vulnerabilities, and uses a permissive Apache-2.0 license. Install it if you need to programmatically authenticate with and control Wandelbots robots from Python. The async-first design and OAuth2 device code support are well-suited to automation and headless environments. Verify that your Wandelbots instance runs API version 1.5.0 before starting.

Install

wandelbots-api-client on PyPI

pip install wandelbots-api-client

uv add wandelbots-api-client

poetry add wandelbots-api-client

Installing wandelbots_api_client

Before you install

Low install friction with a pure-wheel distribution. Active maintenance with a release within the past 10 days. Requires Python >=3.9 and depends on 11 runtime packages including aiohttp, pydantic, and websockets.

License in practice

Apache-2.0 is a permissive license; you can use, modify, and distribute this package freely in commercial and private projects, provided you include a copy of the license and state significant changes.

Quickstart

import asyncio
from wandelbots_api_client import ApiClient, Configuration
from wandelbots_api_client.authorization import EntraIDConfig

async def main():
    auth = EntraIDConfig(client_id="ID", tenant_id="TENANT")
    device_response = await auth.request_device_code()
    token_response = await auth.poll_token_endpoint(
        device_code=device_response["device_code"],
        interval=device_response.get("interval", 5)
    )
    config = Configuration(host="https://instance.wandelbots.io",
                          access_token=token_response["access_token"])
    async with ApiClient(configuration=config) as api_client:
        pass

asyncio.run(main())

Requires Python >=3.9. All API interactions are async/await. Entra ID or Auth0 credentials and instance URL must be configured.

Verify before relying

• Whether token refresh is automatic or must be manually managed in long-running applications
• Real-time capabilities and latency characteristics for websocket-based communication
• Supported robot models and control scenarios beyond API version 1.5.0

Package facts

Evidence: wandelbots_api_client-26.5.3-py3-none-any.whl

Tags

More Software Development packages