---
id: cloudcruise
version: "1.3.1"
license: MIT License
license_treatment: permissive
maintenance: active
---

# cloudcruise — The official CloudCruise Python SDK

License: permissive · Maintenance: active · Downloads: 912.9K/mo

## 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 above — 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

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

- License: MIT License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 912.9K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

browser automation sdk, workflow execution python, encrypted credential storage, realtime event streaming, webhook verification, cloudcruise api client, sse monitoring, browser-automation, workflow-orchestration, credential-management

[View on SkillFed](https://skillfed.io/packages/cloudcruise) · [View on PyPI](https://pypi.org/project/cloudcruise/)