Swarmauri Storage S3

Generic S3-compatible storage adapter for SwarmauriSDK.

Features

• Stores and retrieves objects through direct S3 client operations.
• Supports AWS S3 and S3-conformant endpoints such as MinIO, Cloudflare R2, Wasabi, Ceph, DigitalOcean Spaces, Garage, and BucketWarden when they expose the required S3 API.
• Accepts endpoint, region, credentials, TLS verification, path-style addressing, and client configuration options.
• Provides discoverable swarmauri.storage_adapters and peagen.plugins.storage_adapters entry points.

Installation

Install this package with uv or pip.

uv add swarmauri_storage_s3

pip install swarmauri_storage_s3

Usage

Use this adapter when the workflow should talk to an S3-compatible object API directly.

from swarmauri_storage_s3 import S3StorageAdapter

adapter = S3StorageAdapter.from_uri("s3://model-artifacts/runs")
uri = adapter.put_blob("latest/result.json", b'{"status":"ok"}')
payload = adapter.get_blob("latest/result.json")

print(uri)
print(payload)

Configure provider credentials and endpoint settings in the constructor or through environment variables owned by the surrounding Swarmauri or Tigrbl workflow.

License: Apache-2.0. See LICENSE.