gitdb

Git Object Database

gitdb Permissive license BSD License Abandoned ★ 227 v4.0.12 released 2025-01-02

Install

gitdb on PyPI

pip

pip install gitdb

uv

uv add gitdb

poetry

poetry add gitdb

Package facts

License	BSD License (permissive)
Python support	supports the current Python release (>=3.7)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — smmap
Maintenance	abandoned — 588 days since the last release
Last repo commit	2026-07-26 (repository archived)
First released	2010-07-08
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: gitdb-4.0.12-py3-none-any.whl

Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: OS IndependentOperating System :: POSIXProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9

About gitdb

from the package's own PyPI description — quoted content, verbatim

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 (image) Supported Python versions (image) Documentation Status (image)

From PyPI:

pip install gitdb

Speedups

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

pip install gitdb-speedups

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

Requirements

smmap — declared as a...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

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

Installation is straightforward with a single runtime dependency (smmap) that installs automatically. However, the package is archived and abandoned; maintenance ended 588 days ago, though it remains stable for its primary use in GitPython.

Licensed under BSD License (permissive), allowing commercial and private use with minimal restrictions.

Usage

pip install gitdb

import gitdb
repo = gitdb.GitDB('/path/to/bare/repo.git')

Requires Python 3.7 or later; a bare git repository path is needed to instantiate GitDB.

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.

Needs verification

Whether GitDB's stream-based API and performance characteristics remain suitable for current large-object workloads.
Whether the archived repository status affects security patch responsiveness or dependency updates.

git repository access librarybare git object databasegit pack and loose object readerstream-based git storagegit object streamingpython git databasegit repository python bindings