RedisStorage - Upsonic AI

Overview

RedisStorage provides a Redis-based storage backend. Ideal for distributed systems, high-performance requirements, and applications needing TTL-based expiration.

Install

Install the Redis storage optional dependency group:

uv pip install "upsonic[redis-storage]"

Basic Usage

from upsonic import Agent, Task
from upsonic.storage.memory import Memory
from upsonic.storage.redis import RedisStorage

storage = RedisStorage(
    db_url="redis://localhost:6379/0",
    db_prefix="myapp",
    expire=86400  # 24 hours TTL
)

memory = Memory(
    storage=storage,
    session_id="session_001",
    user_id="user_123",
    full_session_memory=True,
    summary_memory=True,
    user_analysis_memory=True,
    model="anthropic/claude-sonnet-4-5"
)

agent = Agent("anthropic/claude-sonnet-4-5", memory=memory)

result1 = agent.do(Task("My name is Alice"))
result2 = agent.do(Task("What's my name?"))
print(result2)  # "Your name is Alice"

Parameters

Parameter	Type	Default	Description
`db_url`	`str \| None`	`None`	Redis connection URL (e.g., `redis://localhost:6379/0`)
`redis_client`	`Redis \| RedisCluster \| None`	`None`	Pre-existing Redis client
`db_prefix`	`str`	`"upsonic"`	Prefix for all Redis keys
`expire`	`int \| None`	`None`	TTL in seconds for all keys
`session_table`	`str \| None`	`"sessions"`	Session key namespace
`user_memory_table`	`str \| None`	`"user_memories"`	User memory key namespace
`knowledge_table`	`str \| None`	`"upsonic_knowledge"`	Knowledge registry key namespace (used by KnowledgeBase)
`id`	`str \| None`	auto-generated	Storage instance ID

Storage Type

RedisStorage is a synchronous storage implementation. For Redis Cluster support, provide a pre-configured RedisCluster client.

Key Structure

Keys are structured as: {db_prefix}:{table}:{id} Example: myapp:sessions:session_001

​Overview

​Install

​Basic Usage

​Parameters

​Storage Type

​Key Structure

Overview

Install

Basic Usage

Parameters

Storage Type

Key Structure