Redis State Store

High-performance in-memory state storage for fast agent data access

Redis stores agent state in memory for sub-millisecond access — pair it with a SQL backend for conversation history.

from praisonaiagents import Agent, db

agent = Agent(
    name="FastBot",
    instructions="You are a helpful assistant.",
    db=db(state_url="redis://localhost:6379"),
    session_id="redis-session",
)
agent.start("Store my preferences in Redis")

The user updates session state; Redis serves fast reads while SQL can hold conversation history.

Quick Start

1. Simple Usage

   pip install redis praisonai
   

   from praisonaiagents import Agent, db
   
   agent = Agent(
       name="FastBot",
       db=db(state_url="redis://localhost:6379"),
       session_id="session-1",
   )
   agent.start("Hello!")
   
2. With Configuration

   Hybrid setup — SQL for conversations, Redis for state:

   from praisonaiagents import Agent, db
   
   agent = Agent(
       name="HybridBot",
       db=db(
           database_url="postgresql://user:pass@localhost/conversations",
           state_url="redis://localhost:6379",
       ),
       session_id="hybrid-session",
   )
   agent.start("Conversations in Postgres, state in Redis")
   

---

How It Works

Redis is a state store — fast key-value access for agent preferences and runtime data. Conversation history uses database_url separately.

Feature	Description
In-memory speed	Sub-millisecond reads and writes
TTL support	Expire keys automatically with ttl
Key prefix	Namespace keys with prefix (default praison:)

---

Configuration Options

Option	Type	Default	Description
url	str	None	Full Redis URL (overrides host/port/db/password)
host	str	"localhost"	Redis host when url is not set
port	int	6379	Redis port
db	int	0	Redis database number
password	str	None	Redis password
prefix	str	"praison:"	Key prefix for namespacing
decode_responses	bool	True	Compatibility flag (not used internally)
socket_timeout	int	5	Socket timeout in seconds
max_connections	int	10	Compatibility flag for pool size

URL formats

db(state_url="redis://localhost:6379")
db(state_url="redis://:password@host:6379/0")

---

Best Practices

Pair Redis with a SQL conversation backend

Use database_url for chat history and state_url for fast ephemeral state.

Set TTL on ephemeral keys

Pass ttl when storing session-scoped data that should expire automatically.

Use a key prefix per environment

Set prefix="prod:" vs prefix="staging:" to isolate keys on a shared Redis instance.

Enable persistence for durability

Configure Redis AOF or RDB snapshots if state must survive Redis restarts.

---

Related

MongoDB State Store

Document-based state with flexible schemas

Database Persistence

Overview of conversation and state backends