pipedream

What it is and what it does

Pipedream is a Python SDK that wraps the Pipedream APIs, allowing developers to programmatically interact with Pipedream workflows, actions, and apps. It handles authentication (OAuth client credentials or bearer token), automatic token refresh, and request/response serialization through Pydantic models. The library supports both synchronous and asynchronous clients built on httpx, with configurable timeouts, retries, and custom HTTP client configuration for proxies or specialized transports.

The SDK includes pagination support for list operations, exception handling for API errors, raw response access for headers and status codes, and automatic retry logic with exponential backoff on transient failures (408, 409, 429, and 5xx errors by default). It is typed and supports modern Python versions (3.10–3.15), making it suitable for both simple scripts and production integrations.

Use it for:

• Trigger or run Pipedream actions programmatically from Python applications or scheduled jobs
• Query and list Pipedream apps, actions, and triggers to build dynamic workflow management tools
• Build async-first applications that interact with Pipedream without blocking on API calls
• Integrate Pipedream into CI/CD pipelines or monitoring systems that need to invoke workflows

Worth the install?

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

Provides a Python client library for accessing the Pipedream APIs, with support for both synchronous and asynchronous requests, automatic OAuth token management, and built-in retry logic.

Yes, with a caveat on license clarity. The package is actively maintained, has low install friction, no known vulnerabilities, and provides a well-structured, typed client for Pipedream's APIs. However, the license status is unclear in the metadata—verify the actual license (check the repository directly) before use in proprietary or license-sensitive contexts. For most development and integration use cases, it is a solid choice.

Install

pipedream on PyPI

pip install pipedream

uv add pipedream

poetry add pipedream

Installing pipedream

Before you install

Low install friction with a pure-wheel distribution. Actively maintained with a recent release (14 days ago) and a clean repository. Dependencies are minimal and well-established (httpx, pydantic, typing_extensions).

License in practice

License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license terms before using in proprietary or copyleft-sensitive projects.

Quickstart

pip install pipedream

from pipedream import Pipedream

client = Pipedream(
    client_id="your-client-id",
    client_secret="your-client-secret",
)

client.actions.run(
    id="action-id",
    external_user_id="user-id",
)

Requires Python 3.10 or later (supports up to 3.15). OAuth credentials (client_id and client_secret) or a pre-generated bearer token must be provided.

Verify before relying

• Specific API endpoints and resource types available through the client beyond actions and apps
• Rate limiting behavior and whether automatic retries respect Pipedream's rate-limit headers
• Whether the async client supports all the same operations as the sync client

Package facts

Evidence: pipedream-2.1.16-py3-none-any.whl

Tags

More Python Modules packages