Skip to main content

Redis

Redis is used for state management, caching, and vector search.

Installation

pip install "praisonaiagents[tools]"

Docker Setup

docker run -d --name praison-redis -p 6379:6379 redis:7

Quick Start

from praisonaiagents import Agent

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant.",
    memory={
        "backend": "redis",
        "db": "redis://localhost:6379",
        "session_id": "my-session"
    }
)

response = agent.start("Hello!")
print(response)

Connection String Format

redis://localhost:6379
redis://:password@host:port/db_number

Environment Variables

export PRAISON_STATE_URL="redis://localhost:6379"
import os
from praisonaiagents import Agent

agent = Agent(
    name="Assistant",
    memory={"db": os.getenv("PRAISON_STATE_URL")}
)

CLI

# Validate connection
praisonai persistence doctor \
    --state-url "redis://localhost:6379"

Use Cases

  • Session state caching
  • Rate limiting
  • Temporary data storage
  • Vector search (Redis Stack)