Pre-release

This release is a pre-release and may not be stable for production use.

prefect-client

The prefect-client package is a minimal-installation of prefect which is designed for interacting with Prefect Cloud or remote any prefect server. It sheds some functionality and dependencies in exchange for a smaller installation size, making it ideal for use in lightweight or ephemeral environments. These characteristics make it ideal for use in lambdas or other resource-constrained environments.

Getting started

prefect-client shares the same installation requirements as prefect. To install, make sure you are on Python 3.10 or later and run the following command:

pip install prefect-client

Next, ensure that your prefect-client has access to a remote prefect server by exporting the PREFECT_API_KEY (if using Prefect Cloud) and PREFECT_API_URL environment variables. Once those are set, use the package in your code as you would normally use prefect!

For example, to remotely trigger a run a deployment:

from prefect.deployments import run_deployment


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

my_lambda({})

To emit events in an event driven system:

from prefect.events import emit_event


def something_happened():
    emit_event("my-event", resource={"prefect.resource.id": "foo.bar"})

something_happened()

Or just interact with a prefect API:

from prefect.client.orchestration import get_client


async def query_api():
    async with get_client() as client:
        limits = await client.read_concurrency_limits(limit=10, offset=0)
        print(limits)


query_api()

Known limitations

By design, prefect-client omits all CLI and server components. This means that the CLI is not available for use and attempts to access server objects will fail. Furthermore, some classes, methods, and objects may be available for import in prefect-client but may not be "runnable" if they tap into server-oriented functionality. If you encounter such a limitation, feel free to open an issue describing the functionality you are interested in using and we will do our best to make it available.

Next steps

There's lots more you can do to orchestrate and observe your workflows with Prefect! Start with our friendly tutorial or explore the core concepts of Prefect workflows.

Join the community

Prefect is made possible by the fastest growing community of thousands of friendly data engineers. Join us in building a new kind of workflow system. The Prefect Slack community is a fantastic place to learn more about Prefect, ask questions, or get help with workflow design. All community forums, including code contributions, issue discussions, and Slack messages are subject to our Code of Conduct.

Contribute

See our documentation on contributing to Prefect.

Thanks for being part of the mission to build a new kind of workflow system and, of course, happy engineering!

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

prefect_client-3.8.5.dev1.tar.gz (938.6 kB view details)

Uploaded Aug 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

prefect_client-3.8.5.dev1-py3-none-any.whl (1.2 MB view details)

Uploaded Aug 27, 2026 Python 3

File details

Details for the file prefect_client-3.8.5.dev1.tar.gz.

File metadata

Download URL: prefect_client-3.8.5.dev1.tar.gz
Upload date: Aug 27, 2026
Size: 938.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for prefect_client-3.8.5.dev1.tar.gz
Algorithm	Hash digest
SHA256	`4c943ac7893f088c1e2b69682d4c8ec14d270f47d5a5a5d5f1baca915df17fe6`
MD5	`05a9c57494be3ad8a95bd36cbe3cc3b1`
BLAKE2b-256	`8b76ba4748e61d6a31355d70724ec0c83f9f76c20be6d6ec0a71cabc61b9543e`

See more details on using hashes here.

Provenance

The following attestation bundles were made for prefect_client-3.8.5.dev1.tar.gz:

Publisher: prefect-client-publish.yaml on PrefectHQ/prefect

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: prefect_client-3.8.5.dev1.tar.gz
- Subject digest: 4c943ac7893f088c1e2b69682d4c8ec14d270f47d5a5a5d5f1baca915df17fe6
- Sigstore transparency entry: 2616395818
- Sigstore integration time: Aug 27, 2026
Source repository:
- Permalink: PrefectHQ/prefect@38041e65c47f7e3c350fce8f7e5c64de3bc1e103
- Branch / Tag: refs/tags/3.8.5.dev1
- Owner: https://github.com/PrefectHQ
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: prefect-client-publish.yaml@38041e65c47f7e3c350fce8f7e5c64de3bc1e103
- Trigger Event: release