Skip to content

sudormrf-dev/redis-stack-agentic-memory

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

redis-stack-agentic-memory

Redis Stack patterns for multi-layer agentic memory: short-term context, long-term facts, and episodic event logs.

Memory Layers

Layer Class Redis Type Expiry
Short-term ShortTermMemory STRING+SETEX Sliding TTL
Long-term LongTermFacts HASH None
Episodic EpisodicMemory ZSET Max-events trim

Quick Start

import redis
from src.memory.short_term import ShortTermMemory
from src.memory.long_term_facts import LongTermFacts
from src.memory.episodic_memory import EpisodicMemory

r = redis.Redis()
stm = ShortTermMemory(r, session_id="sess-1", ttl=3600)
facts = LongTermFacts(r, agent_id="agent-1")
ep = EpisodicMemory(r, agent_id="agent-1")

stm.set("current_task", {"intent": "search"})
facts.store("user_name", "Alice")
ep.record({"type": "user_turn", "text": "Hello"})

Install

pip install -e ".[dev]"

Test

python -m pytest tests/ -v --cov=src --cov-report=term-missing

License

MIT

About

Production patterns for AI agent memory using Redis Stack. 4-layer architecture: short-term, long-term facts, vector recall (RediSearch HNSW), episodic (Streams). Sub-ms P99 recall.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages