solohq-agno 0.1.0

Agno plugin for SoloHQ Context Memory — adds persistent context memory to Agno agents

solohq-agno

Agno framework integration for SoloHQ context memory.

Installation

pip install solohq-agno

Quick Start

from agno.agent import Agent
from agno.models.anthropic import Claude
from solohq_memory import SqliteVecStorage
from solohq_agno import (
    AgnoContextMemory,
    AgnoLLMAdapter,
    AgnoEmbeddingAdapter,
    MemoryToolkit,
)

# Set up storage and adapters
model = Claude(id="claude-sonnet-4-6")
storage = SqliteVecStorage("memory.db", dimensions=1536)
llm_adapter = AgnoLLMAdapter(model)
embedding_adapter = AgnoEmbeddingAdapter(model)

# Create plugin
memory = AgnoContextMemory(
    storage=storage,
    llm=llm_adapter,
    embedder=embedding_adapter,
)

# Create agent with memory
agent = Agent(
    model=model,
    plugins=[memory],
    tools=[MemoryToolkit(memory)],
)

agent.print_response("What do you remember about our project?")

Components

AgnoContextMemory (Plugin)

Attaches pre/post hooks to Agno agent:

• pre_hook — classifies message, loads context, injects artifacts/history/blocks into system prompt
• post_hook — records episode, updates context state, detects relationships, creates session blocks

MemoryToolkit (Tools)

10 agent-callable tools:

• search_memory — search across all contexts
• save_artifact — save a versioned artifact
• list_contexts — list all contexts
• switch_context — switch active context
• recall_episode — recall past episodes
• index_file — index a file (store path + summary)
• upload_file — upload file content to memory
• index_directory — index all files in a directory
• read_indexed_file — read an indexed file's content
• refresh_index — refresh stale file indexes

Adapters

• AgnoLLMAdapter — wraps Agno model as LLMProvider
• AgnoEmbeddingAdapter — wraps Agno model as EmbeddingProvider

License

MIT