---
id: wandelbots-api-client
version: "26.5.3"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# wandelbots_api_client — Wandelbots Python Client: Interact with robots in an easy and intuitive way. 

License: permissive · Maintenance: active · Downloads: 82.7K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 82.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

wandelbots robot api client, robot control sdk python, oauth2 device code authentication, entra id auth0 device flow, async robot api wrapper, wandelbots api integration, robot automation client library, robot-control, oauth2-device-flow, async-api-client

[View on SkillFed](https://skillfed.io/packages/wandelbots-api-client) · [View on PyPI](https://pypi.org/project/wandelbots-api-client/)