JSON Files | Agno

JsonDb stores Agent, Team, and Workflow sessions, memories, knowledge, evaluations, and traces in local JSON files.

JsonDb reads and rewrites local files without concurrency controls. Use it for demos and tests.

Usage

Start in a virtual environment and set the model key before running the example.

Set your OPENAI_API_KEY as an environment variable. You can get one from OpenAI.

export OPENAI_API_KEY=sk-***

Install the openai package:

uv pip install agno openai

json_for_agent.py

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

db = JsonDb(db_path="tmp/json_db")
agent = Agent(db=db)

Parameter	Type	Default	Description
`id`	`Optional[str]`	-	Database ID. Derived deterministically from database path when omitted.
`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).
`runs_table`	`Optional[str]`	`None`	Storage name for individual runs. Defaults to `agno_runs`, or `<session_table>_runs` when a custom session name is supplied.
`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.
`traces_table`	`Optional[str]`	-	Name of the JSON file to store traces.
`spans_table`	`Optional[str]`	-	Name of the JSON file to store spans.