---
id: gitdb
version: "4.0.12"
license: BSD License
license_treatment: permissive
maintenance: abandoned
---

# gitdb — Git Object Database

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

## Install

pip install gitdb
uv add gitdb
poetry add gitdb

## Description

# Archive Notice

The entire history of this repository is now contained in https://github.com/gitpython-developers/GitPython, where it is now maintained.
For issues, please use its issue tracker as well.

# GitDB

GitDB allows you to access bare git repositories for reading and writing. It aims at allowing full access to loose objects as well as packs with performance and scalability in mind. It operates exclusively on streams, allowing to handle large objects with a small memory footprint.

## Installation

[![Latest Version](https://img.shields.io/pypi/v/gitdb.svg)](https://pypi.python.org/pypi/gitdb/)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/gitdb.svg)](https://pypi.python.org/pypi/gitdb/)
[![Documentation Status](https://readthedocs.org/projects/gitdb/badge/?version=latest)](https://readthedocs.org/projects/gitdb/?badge=latest)

From [PyPI](https://pypi.python.org/pypi/gitdb):

```shell
pip install gitdb
```

## Speedups

If you want to go up to 20% faster, you can install gitdb-speedups with:

```shell
pip install gitdb-speedups
```

However, please note that gitdb-speedups is not currently maintained.

## Requirements

* smmap — declared as a...

## AI interpretation — verify before relying

GitDB provides stream-based read and write access to bare git repositories, handling loose objects and packs efficiently with a small memory footprint.

Verdict: GitDB is a mature, stable library for accessing git object storage, but its archived status and lack of active maintenance mean no new features or bug fixes are expected. Safe for existing deployments relying on it (notably GitPython), but not recommended for new projects seeking ongoing support.

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