Registry / aws / git-remote-s3

git-remote-s3

library0.3.2pypypi✓ verified 84d ago

A git remote helper for Amazon S3. Enables git push/pull from S3 buckets using S3 URLs. Current version 0.3.2, requires Python >=3.10. Beta stage, infrequent releases.

aws devops

pip install git-remote-s3

package ↗

INSTALL

IMPORT

SIG · GIT-REMOTE-S3

git-remote-s3

awspythonv0.3.2

Install

3.7s avg

Import

—

Disk

50MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.3.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 51MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.7s · import 0.000s · 52MB

50MB installed

● package 50MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

S3Remote

✓ from git_remote_s3 import S3Remote

✗ from git_remote_s3 import RemoteS3Helper

Doctor

✓ from git_remote_s3 import Doctor

parse_git_url

✓ from git_remote_s3 import parse_git_url

Clone a git repo stored on S3, make changes, and push back.

git clone s3://mybucket/myrepo.git cd myrepo # Make changes # Configure AWS credentials via environment variables or ~/.aws/credentials # Push back git push s3://mybucket/myrepo.git master

Debug

Known issues

gotchaThe git remote helper only supports S3 URLs in the format s3://bucket-name/repo-path.git. Using regular http:// or https:// will fail.

fix

Use s3:// scheme for remote URLs.

affects: all

gotchaThis tool is a git remote helper, not a standalone Python library. Importing git_remote_s3 directly in Python code is not intended and may not work as expected.

fix

Do not import in Python scripts; use via git commands.

affects: all

gotchaRequires AWS credentials configured. The helper uses boto3, which searches for credentials in order: environment variables, ~/.aws/credentials, IAM roles. Missing credentials cause silent failures.

fix

Set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables before using git commands.

affects: all

deprecatedPython 3.9 and below are not supported. Requires >=3.10.

fix

Upgrade Python to 3.10+.

affects: 0.3.2

breakingVersion 0.3.0 changed the S3 URL format from s3://bucket/repo to s3://bucket/repo.git. Older versions may fail with repositories not ending in .git.

fix

Ensure repository paths end with .git when using version 0.3.0+.

affects: >=0.3.0

Upgrade

Version history

0.3.2latest on PyPI · released Mar 14, 2026

Audit

Dependencies

boto3requiredAWS S3 interaction

Agent activity

26 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/git-remote-s3/ ↗