---
id: pulumi-github
version: "6.15.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pulumi-github — A Pulumi package for creating and managing github cloud resources.

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

## What it is and what it does

pulumi-github is a Pulumi resource provider that bridges Python infrastructure-as-code programs to GitHub's API, letting you declare and manage GitHub resources (repositories, teams, branch protections, workflows, and more) as code rather than through the web UI. It wraps the GitHub API behind Pulumi's declarative model, so you define the desired state in Python and Pulumi handles the creation, updates, and deletions.

The package depends on pulumi (the core framework), parver and semver (for version handling), and typing-extensions for type hints. It requires Python >=3.9 and the Pulumi CLI to be installed separately. Authentication happens through GitHub personal access tokens passed via environment variables or Pulumi configuration, with optional support for GitHub Enterprise via custom base URLs.

Use it for:

- Provision and manage multiple GitHub repositories, teams, and permissions as part of a larger infrastructure deployment
- Automate GitHub branch protection rules, required status checks, and code review policies across an organization
- Define GitHub Actions workflows and repository settings alongside compute and networking infrastructure in a single Pulumi program
- Replicate GitHub organization structure and repository configurations across staging and production environments
- Integrate GitHub resource management into CI/CD pipelines that already use Pulumi for other cloud resources

## Worth the install?

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

Pulumi provider for GitHub that lets you define and manage GitHub resources (repositories, teams, workflows, etc.) as infrastructure code using Python.

Yes, if you are already using Pulumi and need to manage GitHub resources as code. The package is actively maintained, has no known vulnerabilities, installs with low friction, and supports current Python versions. Install only after setting up the Pulumi CLI and having a GitHub personal access token ready.

## Install

pip install pulumi-github
uv add pulumi-github
poetry add pulumi-github

## Installing pulumi-github

Before you install: Low install friction with a pure-Python wheel. Actively maintained with a release on 2026-08-14 and no known vulnerabilities. Requires Pulumi CLI to be installed separately before use.

License in practice: Apache-2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install pulumi-github

import pulumi
import pulumi_github as github

repo = github.Repository('my-repo', description='My repository')

Pulumi CLI must be installed first; requires Python >=3.9; GitHub authentication token or credentials must be configured via environment variables or Pulumi configuration.

Verify before relying:

- Exact scope of GitHub resources supported (repositories, teams, workflows, etc.) beyond the excerpt's examples
- Whether GitHub Enterprise Server is fully supported or has known limitations
- Performance characteristics when managing large numbers of GitHub resources

## Package facts

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

## Tags

infrastructure as code github, pulumi github provider, github resource automation, github infrastructure management, github api infrastructure, pulumi github resources, github iac python, infrastructure-as-code, github-automation, pulumi-provider

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