---
id: pierre-storage
version: "1.16.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# pierre-storage — Pierre Git Storage SDK for Python

License: permissive · Maintenance: active · Downloads: 3.8M/mo

## What it is and what it does

Pierre Storage is an async Python SDK for interacting with Git repositories hosted on Pierre's cloud storage platform. It abstracts Git operations—repository creation, file access, branching, merging, and GitHub synchronization—behind a Python API, eliminating the need to shell out to git commands or manage raw Git protocol details. The SDK uses JWT-authenticated HTTPS URLs for secure remote access and supports both standard and ephemeral namespaces for temporary or preview work.

Typical workflows include creating or discovering repositories, reading and writing files, listing branches and tags, performing merges with conflict detection, and syncing with external GitHub repositories. All operations are async-first, built on httpx for HTTP transport and pydantic for data validation. The SDK is in Beta status and actively maintained, with comprehensive support for modern Python versions (3.9–3.12).

Use it for:

- Programmatically create and manage Git repositories without direct git CLI calls in cloud-native applications.
- Sync external GitHub repositories into Pierre storage and perform operations on the synced copy.
- Implement preview or ephemeral branches for temporary work, testing, or CI/CD workflows.
- Read file content and repository metadata (commits, branches, tags) for analysis or reporting.
- Automate merge operations with conflict detection and custom merge strategies in deployment pipelines.

## Worth the install?

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

Python SDK for managing Git repositories through Pierre's cloud storage service, with support for repository creation, file operations, branching, merging, and GitHub synchronization.

Yes, if you are building on the Pierre platform or need programmatic Git repository management without shell commands. The low install friction, active maintenance, MIT license, and zero known vulnerabilities make it a safe choice. The async-first design and comprehensive API surface support complex workflows. Verify that Pierre's service tier and availability meet your production requirements before committing.

## Install

pip install pierre-storage
uv add pierre-storage
poetry add pierre-storage

## Installing pierre-storage

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a recent release (21 days ago) and substantial repository engagement (5995 stars). Depends on standard libraries: httpx, pyjwt, cryptography, pydantic, and typing-extensions.

License in practice: MIT license permits commercial and private use with minimal restrictions—suitable for most projects without legal friction.

Quickstart:

pip install pierre-storage

from pierre_storage import GitStorage

storage = GitStorage({"name": "your-name", "key": "your-key"})
repo = await storage.create_repo()
url = await repo.get_remote_url()

Requires Python 3.9 or later; all operations are async and require an event loop.

Verify before relying:

- Whether the service requires a paid account or has free tier limits.
- Performance characteristics when working with large repositories or files.
- Availability and uptime SLA for the Pierre storage backend.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 3.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

git repository management sdk, cloud git storage python, remote git operations api, repository branching and merging, github sync integration, git-sdk, async-first, cloud-storage

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