SurrealDB for Agent

Agno supports using SurrealDB as a storage backend for Agents using the SurrealDb class.

Usage

Run SurreabDB locally with the following command:

docker run --rm --pull always -p 8000:8000 surrealdb/surrealdb:latest start --user root --pass root

surrealdb_for_agent.py

from agno.agent import Agent
from agno.db.surrealdb import SurrealDb
from agno.models.anthropic import Claude
from agno.tools.hackernews import HackerNewsTools

# SurrealDB connection parameters
SURREALDB_URL = "ws://localhost:8000"
SURREALDB_USER = "root"
SURREALDB_PASSWORD = "root"
SURREALDB_NAMESPACE = "agno"
SURREALDB_DATABASE = "surrealdb_for_agent"

creds = {"username": SURREALDB_USER, "password": SURREALDB_PASSWORD}
db = SurrealDb(None, SURREALDB_URL, creds, SURREALDB_NAMESPACE, SURREALDB_DATABASE)

agent = Agent(
    db=db,
    model=Claude(id="claude-sonnet-4-5-20250929"),
    tools=[HackerNewsTools()],
    add_history_to_context=True,
)
agent.print_response("How many people live in Costa Rica?")
agent.print_response("What is their national anthem called?")

Params

Parameter	Type	Default	Description
id	Optional[str]	-	The ID of the database instance. UUID by default.
client	Optional[Union[BlockingWsSurrealConnection, BlockingHttpSurrealConnection]]	-	A blocking connection, either HTTP or WebSocket.
db_url	str	-	The SurrealDB connection URL.
db_creds	dict[str, str]	-	Database credentials dictionary (username, password).
db_ns	str	-	The SurrealDB namespace to use.
db_db	str	-	The SurrealDB database name to use.
session_table	Optional[str]	-	Name of the table to store Agent, Team and Workflow sessions.
memory_table	Optional[str]	-	Name of the table to store user memories.
metrics_table	Optional[str]	-	Name of the table to store metrics.
eval_table	Optional[str]	-	Name of the table to store evaluation runs data.
knowledge_table	Optional[str]	-	Name of the table to store knowledge documents data.
culture_table	Optional[str]	-	Name of the table to store cultural knowledge data.
traces_table	Optional[str]	-	Name of the table to store traces.
spans_table	Optional[str]	-	Name of the table to store spans.