prefect-github

What it is and what it does

prefect-github is an official Prefect integration that wraps GitHub API interactions into Prefect-native tasks and blocks, allowing you to orchestrate GitHub operations as part of larger data or automation workflows. It sits on top of sgqlc for GraphQL queries and integrates with Prefect's task and block system, letting you read repository data, trigger workflows, manage pull requests, or perform other GitHub operations within a Prefect flow.

The package is designed for developers building workflow automation that needs to interact with GitHub—whether that's monitoring repositories, triggering CI/CD pipelines, or syncing repository state into other systems. It abstracts away direct API calls and credential management, delegating those concerns to Prefect's standard authentication and block infrastructure.

Use it for:

• Trigger GitHub Actions workflows from Prefect flows in response to data pipeline events.
• Monitor GitHub repositories for changes and automatically sync repository metadata into a data warehouse.
• Automate pull request creation or updates as part of a code-generation or data-validation workflow.
• Fetch GitHub issue or discussion data for analytics or reporting within a Prefect orchestration.
• Coordinate multi-repository operations across a GitHub organization as a single Prefect workflow.

Worth the install?

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

Provides Prefect workflow tasks and blocks for interacting with GitHub repositories, enabling automation of GitHub operations within Prefect data workflows.

Yes, if you are already using Prefect and need to integrate GitHub operations into your workflows. The package is actively maintained, has no known vulnerabilities, carries a permissive license, and installs with low friction. It is a first-party integration backed by the Prefect project, making it a reliable choice for GitHub automation within Prefect.

Install

prefect-github on PyPI

pip install prefect-github

uv add prefect-github

poetry add prefect-github

Installing prefect-github

Before you install

Low install friction with a pure-Python wheel. Actively maintained with a recent release; last commit on 2026-08-14. Depends on sgqlc and prefect, both of which are standard workflow dependencies.

License in practice

Licensed under Apache License 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install prefect-github

from prefect_github import GitHubRepository

repo = GitHubRepository.load(name="my-repo")

Requires Python 3.10 or later; prefect must be installed and configured with valid GitHub credentials or authentication token.

Verify before relying

• Specific GitHub API operations supported (e.g., pull request management, issue tracking, workflow dispatch).
• Whether authentication is handled via environment variables, Prefect secrets, or GitHub app credentials.
• Performance characteristics when working with large repositories or high-frequency GitHub operations.

Package facts

Evidence: prefect_github-0.4.4-py3-none-any.whl

Keywords: prefect

Tags

More Libraries packages