GitDB: Git Object Database

4.0.12 · active · verified Sat Mar 28

GitDB is a Python library for interacting with Git object databases, providing efficient access to Git repositories. The current version is 4.0.12, released on March 28, 2026. It follows a regular release cadence, with recent updates focusing on performance improvements and compatibility enhancements.

Warnings

breaking GitDB 4.0.12 introduces changes that may affect compatibility with previous versions. Review the release notes for detailed information.
Fix: Update your codebase to align with the new API changes.
gotcha Ensure that the 'smmap' dependency is installed to prevent ImportError when using GitDB.
Fix: Install 'smmap' using pip: pip install smmap

Install

pip install gitdb Install GitDB

Imports

GitDB
```
from gitdb import GitDB
```
Ensure correct import path to avoid ImportError

Quickstart

Basic usage of GitDB to interact with a Git repository.

import os
from gitdb import GitDB

gitdb = GitDB(os.environ.get('GIT_REPO_PATH', '/path/to/repo'))
# Perform operations with gitdb

view raw JSON →