CesiumCloud for Python

CesiumCloud cloud storage client for Python 3.10+.

Installation

Install the latest version from PyPI:

python -m pip install cesiumcloud

Or install the official wheel directly:

python3 -m pip install https://cloud.cesiummc.space/clients/cesiumcloud-0.1.0-py3-none-any.whl

Command-line use

python -m cesiumcloud authenticate
python -m cesiumcloud upload "/home/user/Documents"
python -m cesiumcloud upload "/home/user/dogimages.zip"
python -m cesiumcloud download "/home/user/Restored"
python -m cesiumcloud whoami

The cesiumcloud-python command is equivalent.

Python SDK

from cesiumcloud import CesiumCloudClient

client = CesiumCloudClient()
client.authenticate()
client.upload("/home/user/dogimages.zip")
files = client.list_files()
print([file["name"] for file in files])
client.download("/home/user/Restored")

Authentication uses your CesiumCloud account without copying an API key. The Python implementation requires no Node.js runtime or third-party Python dependencies.

Current limitations

Data is streamed directly from local files. The Python client does not yet maintain restart-safe checkpoints across processes. Existing destination files are not silently overwritten. Keep an independent backup of important data.

Access management

Revoke credentials from the CesiumCloud dashboard. The logout command removes local credentials only.

Existing accounts

CesiumCloud connects to the existing API and continues reading legacy ~/.tencloud/credentials.json for backwards compatibility. Existing TenCloud package installations are not modified.