---
id: git-credentials
version: "1.0.0"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# git-credentials — Simple library to interact with Git Credentials

License: permissive · Maintenance: abandoned · Downloads: 163.6K/mo

## What it is and what it does

git-credentials is a lightweight Python wrapper around Git's built-in `git credential` command, allowing you to query, approve, and reject credentials programmatically. It provides a simple interface to interact with Git's credential storage system—whether that's the OS keychain, a credential helper, or plaintext storage—without needing to shell out to Git directly or parse its output yourself.

The package has no external dependencies beyond Git itself and is designed for scenarios where you need to retrieve stored credentials, validate them in code, and optionally store new ones back into Git's credential system. It's useful in automation scripts, CI/CD pipelines, or tools that need to authenticate with Git repositories but want to leverage Git's existing credential infrastructure rather than managing secrets independently.

Use it for:

- Retrieve stored Git credentials in a Python script to authenticate with a private repository.
- Validate credentials programmatically and tell Git whether they worked, updating its cache accordingly.
- Build automation tools that need Git credentials without hardcoding them or managing a separate secrets store.
- Implement custom credential workflows that integrate with Git's native credential helpers.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Wraps the `git credential` command to retrieve, store, and manage Git credentials from Python code without external dependencies beyond Git itself.

No. The package is abandoned (last release January 2022, last commit August 2022) with no maintenance signal. While it has low install friction and permissive licensing, the lack of updates means it may break with newer Python versions, Git releases, or edge cases. For credential management, prefer actively maintained alternatives or direct use of Git's credential system via subprocess calls with proper error handling.

## Install

pip install git-credentials
uv add git-credentials
poetry add git-credentials

## Installing git-credentials

Before you install: Low install friction with no runtime dependencies. However, the package is abandoned—last release was 2022-01-31 and last commit 2022-08-03—so expect no maintenance, bug fixes, or updates for newer Python versions or Git changes.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart:

from git_credentials import GitCredentials, GitCredentialDescription

cred = GitCredentials("/path/to/repo")
response = cred.fill(GitCredentialDescription(
    protocol="https",
    host="example.com",
    path="/"
))
print(response.username, response.password)

Git must be installed and available in PATH; the package is a thin wrapper around the `git credential` command.

Verify before relying:

- Whether the package works reliably with modern Git versions and recent Python releases (3.10+) given the 2022 abandonment.
- Whether the package handles all edge cases in credential storage across different Git credential helper backends.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 163.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

git credential management, retrieve git credentials python, git password storage, git credential helper, git authentication interface, git-integration, credential-management, abandoned

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