CesiumCloud v0.2.0

CesiumCloud stores files as independently deletable physical storage objects. New uploads do not use shared multi-file packs, and renaming or deleting one file does not rebuild unrelated files.

Service: https://cloud.cesiummc.space/app/ API: https://api.cesiummc.space Transfer endpoint: https://transfer.cesiummc.space

CLI

Authenticate with cesiumcloud authenticate. Your credentials are local and can be revoked.

• cesiumcloud upload "path/to/file-or-folder"
• cesiumcloud list -a
• cesiumcloud search notes.txt
• cesiumcloud dir images
• cesiumcloud download "restore-directory"
• cesiumcloud download images/photo.png --location "restore-directory"
• cesiumcloud rename old.txt new.txt
• cesiumcloud move old.txt to root/archive
• cesiumcloud delete root/archive/old.txt

Uploads transfer in resumable 64 MiB chunks using a short-lived authorization grant. Individual files can be downloaded, replaced and permanently removed from active storage without rebuilding other files.

JavaScript SDK

const { IsolatedTransferClient } = require("cesiumcloud");
const storage = new IsolatedTransferClient(process.env.CESIUMCLOUD_API_KEY);
await storage.uploadFile("notes.txt", "docs/notes.txt");
const files = await storage.allFiles();
await storage.download(files[0].id, "./restored.txt");
await storage.delete(files[0].id);

Python SDK

import os
from cesiumcloud import IsolatedTransferClient
storage = IsolatedTransferClient(os.environ["CESIUMCLOUD_API_KEY"])
storage.upload_file("notes.txt", "docs/notes.txt")
files = storage.all_files()
storage.download_file(files[0]["id"], "restored.txt")
storage.delete_file(files[0]["id"])

Existing CesiumCloudClient high-level upload and download methods also use isolated file storage.

Optional local encryption

Use cesiumcloud e2ee keygen to generate a local recovery key, and cesiumcloud e2ee upload FILE to encrypt locally before upload. The server cannot recover your key. Keep an offline backup. Encryption protects contents, not filenames or sizes. The .ccenc format is authenticated and cross-platform.

Notes

Deletion removes the active storage object, not necessarily historical provider backups or copies you exported. Interrupted uploads can be resumed while their authorization and session remain valid. Keep offline backups of important data. This release does not automatically migrate old shared-pack archives.

Replacement and upload cancellation (0.2.1)

Use cesiumcloud upload --replace "file.txt" (or a folder) to replace a matching virtual path, or create it normally when absent. The SDK accepts replace=True in upload_file and upload_path and has cancel_upload(upload_id). Use cesiumcloud cancel-upload UPLOAD_ID or Ctrl+C on an active CLI upload. Already completed files are preserved. The website's ReplacedFiles history is separate from the CLI flag.