---
id: git-remote-s3
version: "0.3.2"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# git-remote-s3 — A git remote helper for Amazon S3

License: permissive · Maintenance: active · Downloads: 178.8K/mo

## What it is and what it does

git-remote-s3 is a Python-based git remote helper that allows you to use an Amazon S3 bucket as a fully functional Git repository without running a dedicated Git server. It implements the git remote helper protocol to intercept S3-prefixed URLs (s3://, s3+zip://) and translates Git operations into S3 API calls via boto3. The package also provides a git-lfs custom transfer implementation, enabling you to store large files managed by Git LFS in the same S3 bucket alongside your repository data.

The tool is designed for serverless Git workflows where you want to avoid infrastructure overhead. It supports standard Git operations—push, pull, clone, branching—and integrates with AWS CodePipeline by optionally creating zip archives of your repository. Access control is enforced through IAM policies at the bucket, prefix, or KMS key level, and data is encrypted at rest and in transit by default. It requires Python >= 3.10 and AWS credentials with appropriate S3 permissions.

Use it for:

- Store private Git repositories in S3 without managing a Git server, using IAM for access control.
- Integrate Git repositories with AWS CodePipeline by pushing to s3+zip:// URIs to generate deployment-ready archives.
- Host multiple Git repositories in a single S3 bucket using prefixes, each with separate IAM permissions.
- Store large binary files via Git LFS in S3 alongside your repository, avoiding separate LFS infrastructure.
- Enable Git workflows in CI/CD pipelines running on AWS Lambda or EC2 with S3-based source control.

## Worth the install?

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

Enables Git to use Amazon S3 as a remote repository and LFS server, implementing a git remote helper and git-lfs custom transfer protocol.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and solves a specific problem—serverless Git hosting on S3—with a permissive license. Install it if you need S3-backed Git repositories and have AWS infrastructure already in place; skip it if you prefer traditional Git hosting or don't use AWS.

## Install

pip install git-remote-s3
uv add git-remote-s3
poetry add git-remote-s3

## Installing git-remote-s3

Before you install: Low install friction with a pure Python wheel distribution. Actively maintained with recent releases. Depends on boto3, botocore, and urllib3—all widely used AWS SDK libraries with stable maintenance.

License in practice: Apache-2.0 is permissive; you may use, modify, and distribute this package freely in commercial and private projects without significant restrictions.

Quickstart:

pip install git-remote-s3

# Then configure git to use S3 as a remote:
git remote add origin s3://my-bucket/my-repo
git push origin main

Requires Python >= 3.10. AWS credentials must be configured (via AWS CLI, environment variables, or IAM role) with S3 permissions (s3:PutObject, s3:GetObject, s3:DeleteObject, s3:ListBucket).

Verify before relying:

- Performance characteristics when handling large repositories or concurrent writes to S3
- Compatibility with specific Git versions or workflows beyond the documented examples

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 178.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

git s3 remote, serverless git repository, s3 git hosting, git lfs s3 storage, amazon s3 git remote helper, aws-integration, git-hosting, lfs-support

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