prefect-cloud 0.1.0a4

Package for easily deploying to Prefect Cloud.

prefect-cloud

:zap: Deploy your code on Prefect Cloud in seconds! :zap:

Deploy and run your Python functions on Prefect Cloud with a single command.

Installation

First, install uv if you haven't already. See installation docs here

curl -LsSf https://astral.sh/uv/install.sh | sh

Create and activate a virtual environment:

uv venv && source .venv/bin/activate

Then install prefect-cloud:

uv pip install prefect-cloud

Alternatively, you can run prefect-cloud as a tool without installing it using uvx. See uv tools guide for more details.

Login to Prefect Cloud

prefect-cloud login

Deploy your workflow

Deploy any Python function from a GitHub repository. For example:

# https://github.com/PrefectHQ/prefect-cloud/blob/main/examples/hello.py

def hello_world():
    print("Hello, World!")

Deploy and run it using:

prefect-cloud deploy hello_world --from https://github.com/PrefectHQ/prefect-cloud/blob/main/examples/hello.py --run

Options

Only Deploy

prefect-cloud deploy ...

Deploy and Run

prefect-cloud deploy ... --run --parameters name=value

Dependencies

# Package names
prefect-cloud deploy ... --with pandas --with numpy

# Or from files
prefect-cloud deploy ... --with requirements.txt
prefect-cloud deploy ... --with pyproject.toml

Environment Variables

prefect-cloud deploy ... --env KEY=VALUE --env KEY2=VALUE2

Private Repositories

prefect-cloud deploy ... --from https://github.com/myorg/private-repo/blob/main/flows.py --credentials GITHUB_TOKEN

Managing Deployments

List all deployments:

prefect-cloud ls

Run a deployment:

prefect-cloud run function_name/deployment_name

Schedule a deployment (using cron):

prefect-cloud schedule function_name/deployment_name "*/5 * * * *"  # Run every 5 minutes
prefect-cloud schedule function_name/deployment_name none  # Remove schedule

Format: minute hour day-of-month month day-of-week

Pause/Resume a deployment:

prefect-cloud pause function_name/deployment_name
prefect-cloud resume function_name/deployment_name