---
id: githubkit
version: "0.16.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# GitHubKit — GitHub SDK for Python

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

## What it is and what it does

GitHubKit is a modern Python SDK for interacting with GitHub's APIs. It wraps GitHub's REST and GraphQL endpoints with full type hints, making it easier to write IDE-friendly code that catches errors at development time rather than runtime. The package handles authentication (including OAuth flows), pagination, webhook event validation via Pydantic, and HTTP caching automatically.

You create a GitHub instance with a token, then call methods like `github.rest.repos.get()` to fetch data with full type information. It supports both synchronous and asynchronous calls, so you can use it in blocking scripts or async applications. The SDK stays current with GitHub's API through generated schemas and includes optional data validation for webhook events and API responses.

Use it for:

- Automating repository management tasks like creating issues, managing pull requests, or updating repository settings.
- Building GitHub-integrated bots or CI/CD tools that need to query repository data or post status updates.
- Fetching and processing webhook events from GitHub with automatic type validation and deserialization.
- Writing async applications that interact with multiple GitHub repositories or organizations concurrently.
- Building internal tools that need to query GitHub's REST API with full IDE autocomplete and type safety.

## Worth the install?

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

A fully typed Python SDK for GitHub's REST and GraphQL APIs with support for both sync and async calls, built-in caching, pagination, and webhook validation.

Yes. GitHubKit is actively maintained, has no known vulnerabilities, installs with low friction, and provides a modern, fully typed interface to GitHub's APIs. It's a solid choice if you're building Python tools that interact with GitHub and want type safety and async support. The MIT license poses no restrictions.

## Install

pip install githubkit
uv add githubkit
poetry add githubkit

## Installing GitHubKit

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a release on 2026-08-14 and 341 repository stars. Depends on six runtime packages including httpx, pydantic, and hishel, all of which are well-maintained.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely in both open-source and commercial projects with minimal restrictions.

Quickstart:

pip install githubkit

from githubkit import GitHub
from githubkit_schemas.latest.models import FullRepository

github = GitHub("<your_token_here>")
resp = github.rest.repos.get("owner", "repo")
repo: FullRepository = resp.parsed_data
print(repo.full_name)

Requires Python 3.10 or later. You must provide a GitHub Personal Access Token (PAT) to authenticate.

Verify before relying:

- Whether the built-in HTTP cache and auto-retry behavior can be configured or disabled for specific use cases.
- Performance characteristics when handling large numbers of paginated API calls.
- Compatibility with GitHub Enterprise Cloud (GHEC) versioning in practice.

## Package facts

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

## Tags

github api client python, github rest api sdk, github graphql python, async github client, github webhook validation, github authentication python, github api wrapper, github-api, async-support, fully-typed

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