Swarmauri Memory Storage Adapter

In-memory storage adapter for SwarmauriSDK workflows. This adapter is ideal for unit tests, demos, or short-lived workloads where you want to avoid persistent storage and rely entirely on process memory.

Features

• Keeps uploaded artifacts in an in-memory dictionary for fast access.
• Supports optional key prefixes to scope uploads and downloads.
• Provides helper methods for bulk upload/download operations.
• Emits memory:// URIs so downstream components can trace stored artifacts.
• Supports Python 3.10 through 3.12.

Installation

Install the package with your preferred Python packaging tool:

uv pip install swarmauri_storage_memory

pip install swarmauri_storage_memory

Usage

import io

from swarmauri_storage_memory import MemoryStorageAdapter

adapter = MemoryStorageAdapter(prefix="session")

uri = adapter.upload("example.txt", io.BytesIO(b"hello"))
print("Stored at:", uri)

downloaded = adapter.download("example.txt").read().decode("utf-8")
print("Contents:", downloaded)

keys = list(adapter.iter_prefix(""))
print("Keys:", keys)

The adapter above stores data purely in memory, making it suitable for lightweight or ephemeral workflows. Use upload_dir and download_dir for bulk transfers when you need to stage many artifacts in memory at once.

Want to help?

If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.