anycubic-cloud-api
Async Python client for the Anycubic Cloud API and its MQTT telemetry stream.
Extracted from the Home Assistant Anycubic integration so it can be versioned, tested and used independently.
Attribution
The bulk of this library is the work of @WaresWichall, from hass-anycubic_cloud — the Anycubic cloud API client, the MQTT layer and the printer data models all originated there, under GPL-3.0.
This package extracts that code so it can be versioned and tested on its own, and adds to it: the LAN Mode client, the filament-usage maths, tolerant parsing of partial reports, and the test suite. Those additions and modifications are by @Nino6689, from 2026 onwards.
It remains GPL-3.0-or-later, as it must.
Anycubic's certificates
This package ships Anycubic's own TLS certificates and client key, because their MQTT broker requires mutual TLS using that identity and there is no other way for a third-party client to reach it. They are Anycubic's property, not covered by this licence, and no ownership is claimed — see COPYRIGHT. They are a shared identity taken from Anycubic's own slicer rather than a per-user credential, and they came from the upstream project this is derived from.
The LAN Mode client needs none of this. If you only talk to the printer locally, no Anycubic credential is involved at any point.
Install
pip install anycubic-cloud-api
Use
import aiohttp
from anycubic_cloud_api import AnycubicMQTTAPI, AnycubicAuthMode
async with aiohttp.ClientSession() as session:
api = AnycubicMQTTAPI(session=session)
api.set_authentication(auth_token="eyJ...", auth_mode=AnycubicAuthMode.SLICER)
if await api.check_api_tokens():
for printer in await api.list_my_printers():
print(printer.name, printer.current_status)
Authentication
Anycubic's login is captcha- and 2FA-protected, so there is no automated sign-in: you supply a token obtained from the Anycubic slicer, website, or Android app. Slicer tokens are 90-day JWTs and additionally unlock the MQTT stream; web tokens are polling-only.
TLS
The MQTT broker requires mutual TLS using Anycubic's own certificates, which ship inside this package. The client verifies the broker against Anycubic's pinned root CA with hostname checking enabled. Two relaxations are unavoidable and forced by Anycubic's certificates:
- their client certificate is SHA-1 signed, so OpenSSL 3.x will not load it at the default security level
- their root CA omits the
keyUsageextension, which Python 3.13+ rejects as a trust anchor underVERIFY_X509_STRICT
Neither weakens chain or hostname verification.
Licence
GPL-3.0-or-later, matching the integration it came from.
1 maintainer
Release files for anycubic-cloud-api 0.4.25
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| anycubic_cloud_api-0.4.25.tar.gz | 130.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| anycubic_cloud_api-0.4.25-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 244.3 kB
Release files / anycubic_cloud_api-0.4.25.tar.gz
| Download URL | anycubic_cloud_api-0.4.25.tar.gz |
|---|---|
| Size | 130.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
72f3e95f50055c4f35e164463ad9011c2a4db79d0acd92d1bbf7a124f28028d7
|
|
BLAKE2b-256 checksum How to use checksums |
38635f5ab3fbc240732f13a7ba3c22e6222d61f3f6c3489e4ca52eaccd200146
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / anycubic_cloud_api-0.4.25-py3-none-any.whl
| Download URL | anycubic_cloud_api-0.4.25-py3-none-any.whl |
|---|---|
| Size | 113.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2f71edb949f00ad9cb31e2828e80be26cf3f31a8200cbd44253f0ec6a8b60016
|
|
BLAKE2b-256 checksum How to use checksums |
6fb7f153f10e80ee489421cfb1ef353fad192fa654efa9cfc3d8815ccee7f4fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.15 {"installer":{"name":"uv","version":"0.11.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
