# gitpython-developers/GitPython

GitPython is a python library used to interact with Git repositories.

Repository: https://github.com/gitpython-developers/GitPython
Canonical: https://ross.abutalabs.com/products/gitpython
Homepage: http://gitpython.readthedocs.org
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: git-porcelain, git-plumbing, python-library
Last push: 2026-08-25T18:55:18+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 97, longevity 100
- inputs: {"age_days": 5755, "days_push": 8, "days_rel": 23, "gap_med": 5, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5173, forks 989 (observed 2026-08-28T04:09:11.678473+00:00)

## What it is
GitPython is a Python library for interacting with Git repositories, offering both high-level (porcelain) and low-level (plumbing) abstractions over git objects, largely by wrapping the git command-line executable. The project is in maintenance mode with no active feature development.

## Use cases
- automate git operations from python scripts
- read commit history and repository data programmatically
- build tooling that wraps git commands
- inspect and manipulate git objects in python
- script batch git repository analysis

## When to choose
- you need a mature, widely-used Python API over git repositories
- you want both high-level and low-level git access from Python
- you need a permissively licensed (BSD-3-Clause) git library

## When to avoid
- you need new features or rapid bug fixes, since the project is in maintenance mode
- you can use a Rust-based alternative like gitoxide instead
- you cannot guarantee the git executable is installed on the target system

## Facets
- artifact type: library
- maturity: maintenance
- function: version-control, developer-tools
- domain: version-control, developer-tools
- platform: python, cross-platform, cli
- tags: git, git-porcelain, git-plumbing, python-library, repository-interaction, automation

## Member repositories
- gitpython-developers/GitPython (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:11.678473+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:01:51.140076+00:00, confidence not recorded.
  - readme: https://github.com/gitpython-developers/GitPython (fetched 2026-08-28T04:09:11.678473+00:00, sha d1213e5fd4a6)
  - registry_pypi: https://pypi.org/pypi/gitpython/json (fetched 2026-08-29T08:56:19.938163+00:00, sha 952360fb4ae8)
- Data as of 2026-08-30T08:39:29.467469+00:00.