---
id: prefect-client
version: "3.8.3"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# prefect-client — Workflow orchestration and management.

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

## What it is and what it does

prefect-client is a stripped-down distribution of Prefect designed to run in resource-constrained environments. It removes the CLI, server components, and related dependencies, keeping only what's needed to communicate with a remote Prefect server or Prefect Cloud. You use it to trigger deployments, emit events, and query the Prefect API from lightweight applications—particularly useful in ephemeral compute like Lambda functions where installation size and startup time matter.

The package shares the same API surface as the full Prefect library for client-side operations, so existing code often works unchanged. However, it explicitly omits server-oriented functionality and CLI tools; attempting to use those will fail. It requires Python 3.10 or later and depends on 42 runtime packages including FastAPI, Pydantic, httpx, and OpenTelemetry for observability.

Use it for:

- Trigger Prefect deployments from AWS Lambda or other serverless functions without installing the full Prefect package.
- Emit events into a Prefect event-driven system from lightweight, ephemeral workloads.
- Query Prefect's orchestration API (read concurrency limits, deployment status, etc.) from a minimal client application.
- Deploy client-side Prefect integrations in container images where installation size is constrained.
- Monitor and observe workflows from remote applications using OpenTelemetry without server-side overhead.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A lightweight client library for interacting with Prefect Cloud or remote Prefect servers, designed for resource-constrained environments like AWS Lambda by omitting CLI and server components.

Yes, if you need to interact with Prefect from a resource-constrained environment (Lambda, lightweight containers, edge functions). The low install friction, active maintenance, and permissive license make it a straightforward choice. Not suitable if you need the CLI, server components, or full Prefect functionality—use the main prefect package instead.

## Install

pip install prefect-client
uv add prefect-client
poetry add prefect-client

## Installing prefect-client

Before you install: Low friction: pure Python wheel with no compiled dependencies. Active maintenance—released 1 day ago with 23623 repository stars. Supports Python 3.10 through 3.14.

License in practice: Apache-2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions; suitable for most production and proprietary contexts.

Quickstart:

pip install prefect-client

from prefect.deployments import run_deployment

run_deployment(
    name="my-flow/my-deployment",
    parameters={"foo": "bar"},
    timeout=0,
)

Requires Python 3.10 or later; PREFECT_API_KEY and PREFECT_API_URL environment variables must be set to connect to a remote Prefect server or Prefect Cloud.

Verify before relying:

- Whether all 42 runtime dependencies are truly required for typical client-side workflows or if some are optional.
- Performance characteristics and memory footprint compared to the full prefect package in Lambda or other constrained environments.
- Completeness of API coverage—which server-oriented classes or methods remain unavailable despite being importable.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 456.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

prefect cloud client, workflow orchestration client, lightweight prefect, remote prefect server, lambda workflow trigger, event-driven orchestration, minimal prefect install, workflow-orchestration, serverless-friendly, event-driven

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