Overview / Install

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

GitPython is a port of the grit library in Ruby created by Tom Preston-Werner and Chris Wanstrath.


Installing GitPython

Installing GitPython is easily done using setuptools. Assuming it is installed, just run the following from the command-line:

# easy_install GitPython

This command will download the latest version of GitPython from the Python Package Index and install it to your system. More information about easy_install and pypi can be found here:

Alternatively, you can install from the distribution using the setup.py script:

# python setup.py install

Getting Started

  • GitPython Tutorial - This tutorial provides a walk-through of some of the basic functionality and concepts used in GitPython. It, however, is not exhaustive so you are encouraged to spend some time in the API Reference.

API Reference

An organized section of the GitPthon API is at API Reference.

Source Code

GitPython’s git repo is available on Gitorious, which can be browsed at:


and cloned from:


License Information

GitPython is licensed under the New BSD License. See the LICENSE file for more information.