---
id: gidgethub
version: "5.4.0"
license: Apache
license_treatment: permissive
maintenance: active
---

# gidgethub — An async GitHub API library

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

## What it is and what it does

Gidgethub is a sans-I/O asynchronous library for the GitHub API that separates GitHub protocol logic from HTTP transport. It provides a base library that handles GitHub-specific details without doing any I/O itself, letting you plug in whatever async HTTP client you prefer. On top of that base, it offers an abstract base class and concrete implementations for immediate usage.

The library is designed for developers who want to automate GitHub workflows, build bots, or integrate GitHub data into applications. It requires Python 3.8 or later and depends only on uritemplate and PyJWT for URL templating and JWT token handling. With 417 stars and active maintenance, it's a stable choice for GitHub API integration in async Python applications.

Use it for:

- Build GitHub bots that respond to webhooks and automate repository management tasks
- Fetch repository metadata, issues, pull requests, and other GitHub data for analysis or reporting
- Automate CI/CD workflows by creating checks, updating statuses, or managing releases via the GitHub API
- Integrate GitHub events into monitoring or notification systems that need async I/O
- Develop tools that interact with multiple repositories programmatically

## Worth the install?

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

Gidgethub is an asynchronous GitHub API library that handles GitHub-specific protocol details without performing I/O itself, letting you choose your HTTP client.

Yes. Gidgethub is a stable, actively maintained library with low install friction and permissive licensing. It's well-suited for async Python applications that need to interact with the GitHub API. The sans-I/O design gives you flexibility to choose your HTTP client. No known vulnerabilities and broad Python version support (3.8–3.13) make it a reliable choice.

## Install

pip install gidgethub
uv add gidgethub
poetry add gidgethub

## Installing gidgethub

Before you install: Low install friction with only two runtime dependencies (uritemplate and PyJWT). Active maintenance with a recent commit on 2026-06-03 and stable production status.

License in practice: Licensed under Apache (permissive), so you can use it freely in commercial and open-source projects without viral obligations.

Quickstart:

pip install gidgethub

import gidgethub
# Use gidgethub with your chosen async HTTP library

Requires Python 3.8 or later; you must also install an async HTTP library to use gidgethub's concrete implementations.

Verify before relying:

- Which async HTTP libraries have concrete implementations provided by gidgethub
- Specific GitHub API endpoints and features covered by the library
- Whether the sans-I/O base library can be used independently of concrete implementations

## Package facts

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

## Tags

github api client, async github library, sans-io github, github rest api python, github automation, github api wrapper, github integration, github-api, async, sans-io

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