Praison AI

JSON

JSON file storage

JSON

Simple JSON file-based storage for development.

Quick Start

python
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:

BaseJSONStore
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()
TrainingStorage
from praisonai.train.agents.storage import TrainingStorage
from praisonaiagents.storage import FileBackend

with TrainingStorage(
    session_id="train-123",
    backend=FileBackend(storage_dir="~/.praisonai/train"),
) as storage:
    storage.save_iteration(...)
# .close() is a safe no-op for FileBackend — the with block keeps usage consistent
SessionManager
from praisonai.cli.state.sessions import SessionManager
from praisonaiagents.storage import FileBackend

backend = FileBackend(storage_dir="~/.praisonai/sessions")
manager = SessionManager(backend=backend)
sessions = manager.list(limit=10)
RunHistory
from praisonai.recipe.history import RunHistory
from praisonaiagents.storage import FileBackend

backend = FileBackend(storage_dir="~/.praisonai/runs")
history = RunHistory(backend=backend)
MCPToolIndex
from praisonai.mcp_server.tool_index import MCPToolIndex
from praisonaiagents.storage import FileBackend

backend = FileBackend(storage_dir="~/.praisonai/mcp")
index = MCPToolIndex(backend=backend)

CLI Usage

bash
# 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.