Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A utility for interacting with data from git repositories as Pandas dataframes

Project Description

![license]( [![Coverage Status](]( ![travis status]( [![PyPI version](]( ![downloads](

![Cumulative Blame](

A simple set of wrappers around gitpython for creating pandas dataframes out of git data. The project is centered around two primary objects:

  • Repository
  • ProjectDirectory

A Repository object contains a single git repo, and is used to interact with it. A ProjectDirectory references a directory in your filesystem which may have in it multiple git repositories. The subdirectories are all walked to find any child repos, and any analysis is aggregated up from all of those into a single output (pandas dataframe).

Current functionality includes:

  • Commit history with extension and directory filtering
  • Edited files history with extension and directory filtering
  • Blame with extension and directory filtering
  • Branches
  • Tags
  • ProjectDirectory-level general information table
  • Approximate bus factor
  • Cumulative Blame as a time series
  • profile analysis via GitHubProfile object
  • Plotting helpers in utilities module
  • Punchcard dataframe and plotting utility
  • Filewise blame
  • File owner approximation
  • Estimation of hours spent per project or per author across projects

Please see examples for more detailed usage. The image above is generated using the repository object’s cumulative blame function on stravalib.


Git-pandas supports python 2.7+ and 3.3+. To install use:

pip install git-pandas


We are looking for contributors, so if you are interested, please review our contributor guidelines in, which includes some proposed starter issues, or if you have an idea of your own, send us a pull request.

Projects Using Git-Pandas


This is BSD licensed (see

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(20.1 kB) Copy SHA256 Hash SHA256
Source May 15, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting