SurrealDB

Agno supports using SurrealDB as a database with the SurrealDb class. You can get started with SurrealDB following their documentation. Run SurrealDB locally with the following command:

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

Usage

Install the surrealdb and openai packages:

uv pip install surrealdb openai

surrealdb_for_agent.py

from agno.agent import Agent
from agno.db.surrealdb import SurrealDb

# 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)

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.

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Usage

Params

​Usage

​Params

Usage

Params