Skip to main content
agentscope-extensions-redis provides full-stack Redis distributed storage — the recommended store for multi-replica production deployments.

Dependency

The module does not force a specific Redis client — import whichever you use (Jedis / Lettuce / Redisson).

One-Line Setup

Custom key prefix for multi-environment isolation:

Components Provided

1. RedisAgentStateStore

Agent state persisted to Redis. Supports Jedis / Lettuce / Redisson.

2. RedisStore (BaseStore)

Workspace filesystem KV storage for RemoteFilesystemSpec.
Concurrency-safe: put / putIfVersion use Lua scripts for atomicity.

3. RedisSnapshotSpec

Sandbox snapshots stored as Redis binary keys. Best for small workspaces + short TTL.

4. RedisSandboxExecutionGuard

Redis SET NX PX lease-based distributed lock for multi-replica sandbox concurrency control.

When to Use