Buckia - Bucket backing of an App with a local DB and assets

Manages a local cache matched by content in a remote cloud Storage Bucket. A local cache for files belonging to a single user is mirrored in a user-specific directory in the Storage Bucket. Designed to support mobile apps that manage data locally but need to secure or share it by pushing a copy to the cloud.

Buckia provides a unified interface for Bunny.net, AWS S3, Linode Object Storage, and Backblaze B2.

Installation

pip install "buckia[bunny]"    # Bunny.net
pip install "buckia[s3]"       # AWS S3
pip install "buckia[linode]"   # Linode
pip install "buckia[b2]"       # Backblaze B2
pip install "buckia[bunny,s3,linode,b2]"  # All providers

Quick Start

# Sync local directory to cloud bucket
buckia sync

# Preview changes without executing
buckia sync --dry-run

# Sync a specific named bucket from .buckia config
buckia sync --bucket production

See Configuration Overview for the .buckia config file format.

Documentation

User Guides

• Configuration Overview — .buckia file format and options
• Basic Configuration — Single-bucket quickstart
• CLI Reference — All commands and options
• Python API Reference — Python library usage
• Sync Features — Upload-only, create-only, state cache

Developer Guides

• Development Guide — Setup and contribution workflow
• Architecture — System design and backend structure
• Testing Guide — Running and writing tests
• CI Pipeline — Continuous integration

Operations

• Release Process — Publishing to PyPI
• Secrets Management — Secure credential handling

Mobile Platforms

• Swift / iOS / macOS — Native Apple platform integration

Project

• Roadmap — Planned features
• Changelog — Version history

License

Released under the AGPL v3 license. (c) 2019–2026 Henrik Vendelbo