cloudcruise

What it is and what it does

CloudCruise is the official Python SDK for the CloudCruise platform, a service for defining and executing automated browser workflows. It provides a client library that lets you start workflow runs, listen to execution events in realtime via Server-Sent Events, manage encrypted credentials in a vault, and verify webhook payloads. The package depends on requests, cryptography, typing_extensions, and jsonschema to handle HTTP communication, encryption, type hints, and schema validation.

You instantiate a CloudCruise client with an API key and encryption key (or load them from environment variables), then use its subclients—runs, workflows, vault, and webhook—to interact with the platform. The runs client supports event listeners that let you react to workflow lifecycle events (start, step, success, failure) and block until execution completes. The vault client handles AES-256-GCM credential storage and retrieval. The package ships with full type hints and is actively maintained.

Use it for:

• Start and monitor automated browser workflows from Python, listening to execution events in realtime and retrieving final results.
• Store and retrieve encrypted credentials securely using the vault client with AES-256-GCM encryption.
• Validate incoming webhook payloads from CloudCruise to ensure they are authentic before processing.
• Define and validate workflow input schemas programmatically using the workflows client.
• Build backend services that trigger and track browser automation jobs asynchronously.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Official Python SDK for CloudCruise that provides automated browser workflow execution, encrypted credential management, realtime event streaming, and webhook verification.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is MIT-licensed. Install it if you need to integrate CloudCruise workflow automation into a Python application. The requirement for Python 3.10+ is a minor constraint; verify your environment supports it before adding the dependency.

Install

cloudcruise on PyPI

pip install cloudcruise

uv add cloudcruise

poetry add cloudcruise

Installing cloudcruise

Before you install

Low install friction with a pure-wheel distribution. Actively maintained with a release 5 days old and recent commits. Requires Python 3.10 or newer.

License in practice

MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions.

Quickstart

pip install cloudcruise

from cloudcruise import CloudCruise, CloudCruiseParams, StartRunRequest

client = CloudCruise(CloudCruiseParams(api_key="key", encryption_key="key"))
run = client.runs.start(StartRunRequest(workflow_id="id", run_input_variables={}))
run.on("execution.success", lambda e: print(e.payload))
result = run.wait()

Python 3.10 or newer required; CLOUDCRUISE_API_KEY and CLOUDCRUISE_ENCRYPTION_KEY credentials must be provided either as constructor arguments or environment variables.

Verify before relying

• Whether the SSE-based realtime streaming handles connection failures or reconnection automatically.
• Performance characteristics when monitoring long-running workflows or high-frequency event streams.
• Scope and detail of webhook payload verification (what attack vectors are covered).

Package facts

Evidence: cloudcruise-1.3.1-py3-none-any.whl

Keywords: cloudcruise, sdk, automation, workflows, sse, webhook

Tags

More Application Frameworks packages