---
id: prefect-github
version: "0.4.4"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# prefect-github — Prefect integrations interacting with GitHub

License: permissive · Maintenance: active · Downloads: 1.1M/mo

## 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 above — 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

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

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

## Tags

prefect github integration, github workflow automation, prefect github tasks, github api prefect, github repository automation, prefect github blocks, github ci/cd integration, workflow-orchestration, github-integration, prefect-ecosystem

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