custom_memory_strategy.py
"""
Custom Memory Optimization Strategy
===================================
This example shows how to create and apply a custom memory optimization
strategy by subclassing MemoryOptimizationStrategy.
"""
from datetime import datetime
from typing import List
from agno.agent import Agent
from agno.db.schemas import UserMemory
from agno.db.sqlite import SqliteDb
from agno.memory import MemoryManager, MemoryOptimizationStrategy
from agno.models.base import Model
from agno.models.openai import OpenAIChat
# ---------------------------------------------------------------------------
# Create Custom Strategy
# ---------------------------------------------------------------------------
class RecentOnlyStrategy(MemoryOptimizationStrategy):
"""Keep only the N most recent memories."""
def __init__(self, keep_count: int = 2):
self.keep_count = keep_count
def optimize(
self,
memories: List[UserMemory],
model: Model,
) -> List[UserMemory]:
"""Keep only the most recent N memories."""
sorted_memories = sorted(
memories,
key=lambda m: m.updated_at or m.created_at or datetime.min,
reverse=True,
)
return sorted_memories[: self.keep_count]
async def aoptimize(
self,
memories: List[UserMemory],
model: Model,
) -> List[UserMemory]:
"""Async version of optimize."""
sorted_memories = sorted(
memories,
key=lambda m: m.updated_at or m.created_at or datetime.min,
reverse=True,
)
return sorted_memories[: self.keep_count]
# ---------------------------------------------------------------------------
# Setup
# ---------------------------------------------------------------------------
db_file = "tmp/custom_memory_strategy.db"
db = SqliteDb(db_file=db_file)
user_id = "user3"
# ---------------------------------------------------------------------------
# Create Agent and Memory Manager
# ---------------------------------------------------------------------------
agent = Agent(
model=OpenAIChat(id="gpt-4o-mini"),
db=db,
update_memory_on_run=True,
)
memory_manager = MemoryManager(
model=OpenAIChat(id="gpt-4o-mini"),
db=db,
)
# ---------------------------------------------------------------------------
# Run Optimization
# ---------------------------------------------------------------------------
if __name__ == "__main__":
print("Creating memories...")
agent.print_response(
"I'm currently learning machine learning and it's been an incredible journey so far. I started about 6 months ago with the basics - "
"linear regression, decision trees, and simple classification algorithms. Now I'm diving into more advanced topics like deep learning "
"and neural networks. I'm using Python with libraries like scikit-learn, TensorFlow, and PyTorch. "
"The math can be challenging sometimes, especially the calculus and linear algebra, but I'm working through it step by step.",
user_id=user_id,
)
agent.print_response(
"I recently completed an excellent online course on neural networks from Coursera. The course covered everything from basic perceptrons "
"to complex architectures like CNNs and RNNs. The instructor did a great job explaining backpropagation and gradient descent. "
"I completed all the programming assignments where we built neural networks from scratch and also used TensorFlow. "
"The final project was building an image classifier that achieved 92% accuracy on the test set. I'm really proud of that accomplishment.",
user_id=user_id,
)
agent.print_response(
"My ultimate goal is to build my own AI projects that solve real-world problems. I have several ideas I want to explore - "
"maybe a recommendation system, a chatbot for customer service, or perhaps something in computer vision. "
"I'm trying to identify problems where AI can make a real difference and where I have the skills to build something meaningful. "
"I know I need more experience and practice, but I'm committed to working on personal projects to build my portfolio.",
user_id=user_id,
)
agent.print_response(
"I'm particularly interested in natural language processing applications. The recent advances in large language models are fascinating. "
"I've been experimenting with transformer architectures and trying to understand how attention mechanisms work. "
"I'd love to work on projects involving text classification, sentiment analysis, or maybe even building conversational AI. "
"NLP feels like it's at the cutting edge right now and there are so many interesting problems to solve in this space.",
user_id=user_id,
)
print("\nBefore optimization:")
memories_before = agent.get_user_memories(user_id=user_id)
print(f" Memory count: {len(memories_before)}")
custom_strategy = RecentOnlyStrategy(keep_count=2)
tokens_before = custom_strategy.count_tokens(memories_before)
print(f" Token count: {tokens_before} tokens")
print("\nAll memories:")
for i, memory in enumerate(memories_before, 1):
print(f" {i}. {memory.memory}")
print("\nOptimizing with custom RecentOnlyStrategy (keep_count=2)...")
memory_manager.optimize_memories(
user_id=user_id,
strategy=custom_strategy,
apply=True,
)
print("\nAfter optimization:")
memories_after = agent.get_user_memories(user_id=user_id)
print(f" Memory count: {len(memories_after)}")
tokens_after = custom_strategy.count_tokens(memories_after)
print(f" Token count: {tokens_after} tokens")
if tokens_before > 0:
reduction_pct = ((tokens_before - tokens_after) / tokens_before) * 100
tokens_saved = tokens_before - tokens_after
print(
f" Reduction: {reduction_pct:.1f}% ({tokens_saved} tokens saved by keeping 2 most recent)"
)
print("\nRemaining memories (2 most recent):")
for i, memory in enumerate(memories_after, 1):
print(f" {i}. {memory.memory}")
Run the Example
1
Set up your virtual environment
uv venv --python 3.12
source .venv/bin/activate
uv venv --python 3.12
.venv\Scripts\activate
2
Install dependencies
uv pip install -U agno openai sqlalchemy
3
Export your OpenAI API key
export OPENAI_API_KEY="your_openai_api_key_here"
$Env:OPENAI_API_KEY="your_openai_api_key_here"
4
Run the example
Save the code above as
custom_memory_strategy.py, then run:python custom_memory_strategy.py