JSON files as database, on Google Cloud Storage (GCS)

Use Google Cloud Storage for JSON-based agent session storage.

Agno supports using Google Cloud Storage (GCS) as a database with the GcsJsonDb class. Session data will be stored as JSON blobs in a GCS bucket.

You can get started with GCS following their Get Started guide.

Usage

gcs_for_agent.py

import uuid
import google.auth
from agno.agent import Agent
from agno.db.gcs_json import GcsJsonDb

# Obtain the default credentials and project id from your gcloud CLI session.
credentials, project_id = google.auth.default()

# Generate a unique bucket name using a base name and a UUID4 suffix.
base_bucket_name = "example-gcs-bucket"
unique_bucket_name = f"{base_bucket_name}-{uuid.uuid4().hex[:12]}"
print(f"Using bucket: {unique_bucket_name}")

# Initialize GCSJsonDb with explicit credentials, unique bucket name, and project.
db = GcsJsonDb(
    bucket_name=unique_bucket_name,
    prefix="agent/",
    project=project_id,
    credentials=credentials,
)

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

Params

See the full example here.