Registry / crm-productivity / robocorp-storage

robocorp-storage

JSON →
library1.1.0pypypi✓ verified 82d ago

robocorp-storage is the Robocorp Asset Storage library, providing functions to manage (read, write, list) assets in the Robocorp Control Room or local development environment. It is part of the larger Robocorp ecosystem, typically updated alongside other Robocorp libraries, with a focus on stability for its core asset management API. The current version is 1.1.0.

pip install robocorp-storage
INSTALL
IMPORT
SIG · ROBOCORP-STORAGE
R
robocorp-storage
crm-productivitypythonv1.1.0
Install
2.2s avg
Import
Disk
20MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v1.1.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.920 runs
installs and imports cleanly · install 0.0s · import 0.000s · 21.5MB
glibc
py 3.103.920 runs
installs and imports cleanly · install 2.2s · import 0.000s · 22MB
20MB installed
● package 20MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

get_asset
from robocorp import storage
from robocorp.storage import get_asset

This quickstart demonstrates how to set and retrieve a simple text asset. When run locally, assets are stored in a temporary directory. When executed within a Robocorp Control Room robot, assets are securely stored in the cloud. The optional cleanup code is commented out as it's typically for local development.

from robocorp.storage import get_asset, set_asset import os # Assets stored via robocorp-storage are persisted in Robocorp Control Room # when run in a robot, or in a local temporary directory otherwise. asset_name = "my-robot-state" asset_value = "Current processing step: Data extraction complete." print(f"Setting asset '{asset_name}'...") # Assets are typically stored as bytes, hence the .encode() set_asset(asset_name, asset_value.encode("utf-8"), "text/plain") print(f"Asset '{asset_name}' stored.") print(f"Retrieving asset '{asset_name}'...") asset = get_asset(asset_name) if asset: retrieved_value = asset.get_bytes().decode("utf-8") print(f"Successfully retrieved asset: '{retrieved_value}'") assert retrieved_value == asset_value else: print(f"Asset '{asset_name}' not found.") # Example of clearing assets (useful for local development cleanup) # from robocorp.storage import clear_assets_from_disk # if os.environ.get("RC_API_SECRET") is None: # Only clear if running locally, not in Control Room # clear_assets_from_disk()
Debug
Known issues
gotchaAsset persistence is context-dependent. When `robocorp-storage` is used outside of a Robocorp Control Room robot run (e.g., local development), assets are stored in a temporary directory and are not automatically synced to the cloud or persisted across process restarts unless explicitly configured.
fix
Ensure your robot runs within the Robocorp Control Room for cloud persistence. For local testing, be aware that assets are ephemeral by default. To debug local persistence issues, check the temporary directory used by the library.
affects: All versions
gotchaThis library is designed for managing 'assets' (relatively small pieces of data or configuration files). For handling large datasets or multiple related files that form an input/output of a task, consider using `robocorp-workitems`.
fix
Evaluate your data storage needs: use `robocorp-storage` for configuration, small files, or state; use `robocorp-workitems` for larger datasets, inputs, or outputs of processing steps.
affects: All versions
deprecatedOlder projects might have custom asset management solutions or rely on `rpaframework`'s `Vault` for some functionalities. `robocorp-storage` provides the official and recommended way to interact with Robocorp's Asset Storage.
fix
Migrate any custom asset logic to use the `robocorp.storage` API for better compatibility, maintainability, and direct integration with the Control Room's asset features.
affects: < 1.0.0
Upgrade
Version history
1.1.0latest on PyPI · released Mar 13, 2026
Audit
Dependencies
rpaframework-corerequiredInternal dependency for core RPA functionalities.
robocorp-apprequiredInternal dependency for Robocorp application context.
Agent activity
24 hits · last 30 days
node
22
OpenAI (training)
1
Resources
robocorp-storage — pip install robocorp-storage · libregistry