Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Python bindings for libgit2.

Project Description

Pygit2 is a set of Python bindings to the libgit2 shared library, libgit2 implements the core of Git. Pygit2 works with Python 2.7, 3.2, 3.3, 3.4 and pypy.

It is likely to work with Python 2.6 and 3.1, but these versions are not officially supported.

Pygit2 links:

Quick install guide

  1. Checkout the libgit2 stable branch:

    $ git clone git:// -b master
  2. Build and install libgit2—using-cmake

  3. Install pygit2 with pip:

    $ pip install pygit2

For detailed instructions check the documentation,


Fork libgit2/pygit2 on GitHub, make it awesomer (preferably in a branch named for the topic), send a pull request.


66 developers have contributed at least 1 commit to pygit2:

J. David Ibáñez            Rémi Duraffort             Adam Spiers
Nico von Geyso             Sebastian Thiel            Alexander Bayandin
Carlos Martín Nieto        Fraser Tweedale            Andrew Chin
W. Trevor King             Han-Wen Nienhuys           András Veres-Szentkirályi
Dave Borowitz              Leonardo Rhodes            Benjamin Kircher
Daniel Rodríguez Troitiño  Petr Viktorin              Benjamin Pollack
Richo Healey               Thomas Kluyver             Bryan O'Sullivan
Christian Boos             Alex Chamberlain           Daniel Bruce
Julien Miotte              Amit Bakshi                David Fischer
Xu Tao                     Andrey Devyatkin           David Sanders
Jose Plana                 Ben Davis                  Devaev Maxim
Martin Lenders             Eric Schrijver             Eric Davis
Petr Hosek                 Hervé Cauwelier            Erik Meusel
Victor Garcia              Huang Huang                Erik van Zijst
Xavier Delannoy            Ian P. McCullough          Ferengee
Yonggang Luo               Jack O'Connor              Gustavo Di Pietro
Valentin Haenel            Jared Flatow               Hugh Cole-Baker
Michael Jones              Jiunn Haur Lim             Josh Bleecher Snyder
Bernardo Heynemann         Jun Omae                   Óscar San José
John Szakmeister           Sarath Lakshman            Ridge Kennedy
Brodie Rao                 Vicent Marti               Rui Abreu Ferreira
David Versmisse            Zoran Zaric                earl


0.21.0 (2014-06-27)


  • Drop official support for Python 2.6, and add support for Python 3.4 #376
  • Upgrade to libgit2 v0.21.0 #374
  • Start using cffi #360 #361

Backward incompatible changes:

  • Replace oid by id through the API to follow libgit2 conventions.
  • Merge API overhaul following changes in libgit2.
  • New Remote.rename(...) replaces = ...
  • Now Remote.fetch() returns a TransferProgress object.
  • Now Config.get_multivar(...) returns an iterator instead of a list.

New features:

  • New Config.snapshot() and Repository.config_snapshot()
  • New Config methods: get_bool(...), get_int(...), parse_bool(...) and parse_int(...) #357
  • Blob: implement the memory buffer interface #362
  • New clone_into(...) function #368
  • Now Index can be used alone, without a repository #372
  • Add more options to init_repository #347
  • Support Repository.workdir = ... and support setting detached heads Repository.head = <Oid> #377


  • Fix again build with VS2008 #364
  • Fix Blob.diff(...) and Blob.diff_to_buffer(...) arguments passing #366
  • Fail gracefully when compiling against the wrong version of libgit2 #365
  • Several documentation improvements and updates #359 #375 #378

0.20.3 (2014-04-02)

  • A number of memory issues fixed #328 #348 #353 #355 #356
  • Compatibility fixes for PyPy (#338), Visual Studio 2008 (#343) and Python 3.3 (#351)
  • Make the sort mode parameter in Repository.walk(...) optional #337
  • New Object.peel(...) #342
  • New Index.add_all(...) #344
  • Introduce support for libgit2 options #350
  • More informative repr for Repository objects #352
  • Introduce support for credentials #354
  • Several documentation fixes #302 #336
  • Tests, remove temporary files #341

0.20.2 (2014-02-04)


  • New Repository.default_signature #310


  • New str(Oid) deprecates Oid.hex #322


  • New deprecates Object.oid #322
  • New deprecates TreeEntry.oid #322
  • New Blob.diff(...) and Blob.diff_to_buffer(...) #307
  • New Commit.tree_id and Commit.parent_ids #73 #311
  • New rich comparison between tree entries #305 #313
  • Now Tree.__contains__(key) supports paths #306 #316


  • Now possible to create IndexEntry(...) #325
  • Now IndexEntry.path, IndexEntry.oid and IndexEntry.mode are writable #325
  • Now Index.add(...) accepts an IndexEntry too #325
  • Now Index.write_tree(...) is able to write to a different repository #325
  • Fix memory leak in IndexEntry.path setter #335


  • New Config iterator replaces Config.foreach #183 #312


  • New type Refspec #314
  • New Remote.push_url #315
  • New Remote.add_push and Remote.add_fetch #255 #318
  • New Remote.fetch_refspecs replaces Remote.get_fetch_refspecs() and Remote.set_fetch_refspecs(...) #319
  • New Remote.push_refspecs replaces Remote.get_push_refspecs() and Remote.set_push_refspecs(...) #319
  • New Remote.progress, Remote.transfer_progress and Remote.update_tips #274 #324
  • New type TransferProgress #274 #324
  • Fix refcount leak in Repository.remotes #321 #332

Other: #331

0.20.1 (2013-12-24)

  • New remote ref-specs API: #290
  • New Repository.reset(...): #292, #294
  • Export GIT_DIFF_MINIMAL: #293
  • New Repository.merge(...): #295
  • Fix Repository.blame argument handling: #297
  • Fix build error on Windows: #298
  • Fix typo in the README file, Blog → Blob: #301
  • Now Diff.patch returns None if no patch: #232, #303
  • New Walker.simplify_first_parent(): #304

0.20.0 (2013-11-24)

  • Upgrade to libgit2 v0.20.0: #288
  • New Repository.head_is_unborn replaces Repository.head_is_orphaned
  • Changed pygit2.clone_repository(...). Drop push_url, fetch_spec and push_spec parameters. Add ignore_cert_errors.
  • New Patch.additions and Patch.deletions: #275
  • New Patch.is_binary: #276
  • New Reference.log_append(...): #277
  • New Blob.is_binary: #278
  • New len(Diff) shows the number of patches: #281
  • Rewrite Repository.status(): #283
  • New Reference.shorthand: #284
  • New Repository.blame(...): #285
  • Now Repository.listall_references() and Repository.listall_branches() return a list, not a tuple: #289


GPLv2 with linking exception.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 2, as published by the Free Software Foundation.

In addition to the permissions in the GNU General Public License, the authors give you unlimited permission to link the compiled version of this file into combinations with other programs, and to distribute those combinations without any restriction coming from the use of this file. (The General Public License restrictions do apply in other respects; for example, they cover modification of the file, and distribution when not linked into a combined executable.)

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; see the file COPYING. If not, write to the Free Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Release history Release notifications

History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


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.

Filename, size & hash SHA256 hash help File type Python version Upload date
pygit2-0.21.0.tar.gz (150.3 kB) Copy SHA256 hash SHA256 Source None Jun 27, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page