sobe

A simple command-line tool to upload files to an AWS S3 bucket, typically one served publicly through a CloudFront distribution (the CDN part is optional). This is the traditional "drop box" use case that existed long before the advent of modern file sharing services.

Full documentation: https://sobe.readthedocs.io/en/latest/

It will upload any files you give it to your bucket, defaulting to a current year directory, because that's the only easy way to organize chaos.

"Sobe" (pronounced SAW-bee) is Portuguese for "take it up" (in the imperative), as in "upload".

Installation

Use uv to manage it.

uv tool install sobe

If you have Python ≥ 3.11, you can also install it via pip:

pip install sobe

Configuration

On first run, sobe will create its config file as appropriate to the platform and tell you its location. You'll need to edit this file with at least your AWS bucket details; a public URL and a CloudFront distribution are optional, and you can define several named targets.

Here's a minimal set up.

[target.main]
url = "https://example.com/"

[target.main.storage]
type = "aws_s3"
bucket = "your-bucket-name"

[target.main.cache]
type = "aws_cloudfront"
distribution = "your-cloudfront-distribution-id"

More information in the docs.

Usage

The basic example is uploading files to current year directory:

$ sobe file1.jpg file2.pdf
https://example.com/2025/file1.jpg ...ok.
https://example.com/2025/file2.pdf ...ok.

You can call it with --help for all available options. You can list files, delete them, clear the CloudFront cache (cached objects stay for 1 day by default), select a different upload directory. The documentation contains better examples.

License

See the LICENSE file for details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sobe-1.0.0rc1.tar.gz (9.6 kB view details)

Uploaded Jul 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sobe-1.0.0rc1-py3-none-any.whl (11.0 kB view details)

Uploaded Jul 18, 2026 Python 3

File details

Details for the file sobe-1.0.0rc1.tar.gz.

File metadata

Download URL: sobe-1.0.0rc1.tar.gz
Upload date: Jul 18, 2026
Size: 9.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for sobe-1.0.0rc1.tar.gz
Algorithm	Hash digest
SHA256	`a5b8d469ab2fdab1bd073b94b55fa09f9b82eff8d34b763ec08d32f3098b6101`
MD5	`290b31391571e32682602bd6296fb091`
BLAKE2b-256	`e134be6cde159d0b363f4c189149d2a82ab3e41696a4f245a807449049a2ccb1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for sobe-1.0.0rc1.tar.gz:

Publisher: pypi.yaml on Liz4v/sobe

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: sobe-1.0.0rc1.tar.gz
- Subject digest: a5b8d469ab2fdab1bd073b94b55fa09f9b82eff8d34b763ec08d32f3098b6101
- Sigstore transparency entry: 2193480989
- Sigstore integration time: Jul 18, 2026
Source repository:
- Permalink: Liz4v/sobe@f1257584c8740999d99ed6c3cfe824ec3bfa23f3
- Branch / Tag: refs/tags/1.0.0rc1
- Owner: https://github.com/Liz4v
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: pypi.yaml@f1257584c8740999d99ed6c3cfe824ec3bfa23f3
- Trigger Event: push