Skip to main content

​
JSON

Simple JSON file-based storage for development.

​
Quick Start

from praisonaiagents import Agent

agent = Agent(
    name="Assistant",
    instructions="You are a helpful assistant.",
    memory={
        "backend": "file",
        "session_id": "my-session"
    }
)

response = agent.start("Hello!")
print(response)

​
File Location

By default, JSON files are stored in:
  • ~/.praisonai/memory/ for memory data
  • ~/.praisonai/sessions/ for session data

​
When to Use

✅ Good for:
  • Local development
  • Testing
  • Quick prototyping
❌ Not recommended for:
  • Production deployments
  • Multi-user applications
  • Large datasets

​
Storage Backend (Advanced)

For training data, sessions, and general persistence, use the FileBackend: 
from praisonaiagents.storage import FileBackend, BaseJSONStore

backend = FileBackend(storage_dir="~/.praisonai/data")
store = BaseJSONStore("session.json", backend=backend)
store.save({"messages": ["Hello"]})
data = store.load()

​
CLI Usage

# Training with file backend (default)
praisonai train agents --input "Hello" --storage-backend file --storage-path ~/.praisonai/train

# Session list with file backend
praisonai session list --storage-backend file --storage-path ~/.praisonai/sessions
See Storage Backends for more details.