JSON Files as Database

Use local JSON files for simple agent session storage.

Agno supports using local JSON files as a “database” with the JsonDb class. This is a simple way to store your Agent’s session data without having to setup a database.

Using JSON files as a database is not recommended for production applications. Use it for demos, testing and any other use case where you don’t want to setup a database.

Usage

Install the openai package:

uv pip install openai

json_for_agent.py

from agno.agent import Agent
from agno.db.json import JsonDb

# Setup the JSON database
db = JsonDb(db_path="tmp/json_db")

# Setup your Agent with the Database
agent = Agent(db=db)

Params

Parameter	Type	Default	Description
id	Optional[str]	-	The ID of the database instance. UUID by default.
db_path	Optional[str]	-	Path to the directory where JSON files will be stored.
session_table	Optional[str]	-	Name of the JSON file to store sessions (without .json extension).
memory_table	Optional[str]	-	Name of the JSON file to store memories.
metrics_table	Optional[str]	-	Name of the JSON file to store metrics.
eval_table	Optional[str]	-	Name of the JSON file to store evaluation runs.
knowledge_table	Optional[str]	-	Name of the JSON file to store knowledge content.
culture_table	Optional[str]	-	Name of the JSON file to store cultural knowledge.
traces_table	Optional[str]	-	Name of the JSON file to store traces.
spans_table	Optional[str]	-	Name of the JSON file to store spans.