Registry / http-networking / pyworxcloud

pyworxcloud

library6.4.1pypypi✓ verified 87d ago

Python library for interacting with the Positec/Landroid cloud API. Provides asynchronous control of Landroid robotic lawn mowers. Current version 6.3.6, supports Python 3.9+ with <4.0.

http-networking aws

pip install pyworxcloud

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · PYWORXCLOUD

pyworxcloud

http-networkingpythonv6.4.1

Install

4.8s avg

Import

1151ms

Disk

33MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v6.4.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.978s · 33.6MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.8s · import 0.864s · 36MB

33MB installed

● package 33MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

WorxCloud

✓ from pyworxcloud import WorxCloud

const

✓ from pyworxcloud import const

Initializes WorxCloud and lists mowers.

import asyncio import os from pyworxcloud import WorxCloud async def main(): email = os.environ.get('EMAIL', '') password = os.environ.get('PASSWORD', '') async with WorxCloud(email, password) as cloud: # List all mowers for product in cloud.products: print(f"Mower: {product.name}, serial: {product.serial_number}") asyncio.run(main())

Debug

Known issues

breakingWorxCloud is now an async context manager (async with). You must use async/await; synchronous usage is removed.

fix

Use 'async with WorxCloud(...) as cloud' instead of WorxCloud(...) without async.

affects: >=6.0.0

gotchaRegion selection is automatic but may delay login. If you know your region, set it explicitly to avoid extra API calls.

fix

WorxCloud(email, password, region='EU'). Common regions: 'EU', 'US', 'CN'.

affects: all

deprecatedThe 'mowers' attribute was renamed to 'products' to support non-mower devices (e.g., vacuums).

fix

Use cloud.products instead of cloud.mowers.

affects: >=6.0.0

Errors

Common errors & fixes

RuntimeError: asyncio.run() cannot be called from a running event loop

Running asyncio.run() inside an event loop (e.g., in Jupyter or IPython).

fix

Use 'await main()' if already in an event loop, or nest with 'asyncio.get_event_loop().run_until_complete(main())'.

AttributeError: 'WorxCloud' object has no attribute 'mowers'

Upgrading to v6.x where 'mowers' was renamed to 'products'.

fix

Replace cloud.mowers with cloud.products.

Invalid credentials: HTTP 403

Password uses special characters incorrectly encoded, or region mismatch.

fix

URL-encode password or switch region: WorxCloud(email, password, region='EU'). Also ensure you use the exact email for the Positec account.

Upgrade

Version history

6.4.1latest on PyPI · released Jun 10, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

31 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/mtrab/pyworxcloud ↗

packagehttps://pypi.org/project/pyworxcloud/ ↗

docshttps://github.com/mtrab/pyworxcloud ↗