---
id: gitpython
version: "3.1.59"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# GitPython — GitPython is a Python library used to interact with Git repositories

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install gitpython
uv add gitpython
poetry add gitpython

## Description

![Python package](https://github.com/gitpython-developers/GitPython/workflows/Python%20package/badge.svg)
[![Documentation Status](https://readthedocs.org/projects/gitpython/badge/?version=stable)](https://readthedocs.org/projects/gitpython/?badge=stable)
[![Packaging status](https://repology.org/badge/tiny-repos/python:gitpython.svg)](https://repology.org/metapackage/python:gitpython/versions)

## [Gitoxide](https://github.com/Byron/gitoxide): A peek into the future…

I started working on GitPython in 2009, back in the days when Python was 'my thing' and I had great plans with it.
Of course, back in the days, I didn't really know what I was doing and this shows in many places. Somewhat similar to
Python this happens to be 'good enough', but at the same time is deeply flawed and broken beyond repair.

By now, GitPython is widely used and I am sure there is a good reason for that, it's something to be proud of and happy about.
The community is maintaining the software and is keeping it relevant for which I am absolutely grateful. For the time to come I am happy to continue maintaining GitPython, remaining hopeful that one day it won't be needed anymore.

More than 15 years after...

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