Swarmauri Storage S3FS

Filesystem-style S3 storage adapter for SwarmauriSDK backed strictly by s3fs.

Features

• Stores and retrieves objects from s3:// locations through s3fs.S3FileSystem.
• Supports S3-compatible endpoints through endpoint_url and client_kwargs.
• Provides discoverable swarmauri.storage_adapters and peagen.plugins.storage_adapters entry points.
• Handles object upload, download, range reads, prefix iteration, directory push/pull, bucket creation, and object removal.

Installation

Install this package with uv or pip.

uv add swarmauri_storage_s3fs

pip install swarmauri_storage_s3fs

Usage

Use this adapter when the workflow should use the s3fs filesystem API.

from swarmauri_storage_s3fs import S3FSStorageAdapter

adapter = S3FSStorageAdapter.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 credentials through s3fs, environment variables, or explicit constructor arguments owned by the surrounding Swarmauri or Tigrbl workflow.

License: Apache-2.0. See LICENSE.