brsx-archive

Python client and command-line tool for BRSX Archive file storage. No dependencies beyond the standard library.

pip install brsx-archive

Get an API key

Sign in to archive.brsxlabs.com, click your name at the top right, open API keys and create one. The key starts with brsxa_ and is shown only once.

export BRSX_ARCHIVE_KEY=brsxa_...

Files you upload go to your own account and count against your storage quota.

Python

from brsx_archive import Archive

archive = Archive()                      # reads BRSX_ARCHIVE_KEY
backups = archive.folder("backups")      # created if it doesn't exist

f = archive.upload("db.sqlite", folder=backups, overwrite=True)
print(f.id, f.size)

for item in archive.files(backups):
    print(item.name, item.size)

archive.download(f, "restored.sqlite")
archive.delete(f)

usage = archive.usage()
print(usage.used, usage.limit, usage.free)

Large files are uploaded in chunks (up to 2 GB per file); failed chunks are retried automatically.

Keeping only the latest backups

from datetime import date

name = f"db-{date.today()}.sqlite"
archive.upload("db.sqlite", folder=backups, name=name)
archive.keep_latest(backups, count=7, prefix="db-")   # delete older ones

Errors

Command line

brsx-archive usage
brsx-archive ls --folder backups
brsx-archive upload db.sqlite --folder backups --overwrite
brsx-archive upload db-2026-09-21.sqlite --folder backups --keep 7
brsx-archive download 42 -o restored.sqlite
brsx-archive rm 42

A daily backup with cron:

0 3 * * * BRSX_ARCHIVE_KEY=brsxa_... brsx-archive upload /var/backups/db-$(date +\%F).sqlite --folder backups --keep 7 --quiet

HTTP API

All endpoints take Authorization: Bearer brsxa_....

License

MIT