> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# JSON

> JSON file storage

# JSON

Simple JSON file-based storage for development.

## Quick Start

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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`:

<CodeGroup>
  ```python BaseJSONStore theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  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()
  ```

  ```python TrainingStorage theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  from praisonai.train.agents.storage import TrainingStorage
  from praisonaiagents.storage import FileBackend

  backend = FileBackend(storage_dir="~/.praisonai/train")
  storage = TrainingStorage(session_id="train-123", backend=backend)
  ```

  ```python SessionManager theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  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)
  ```

  ```python RunHistory theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  from praisonai.recipe.history import RunHistory
  from praisonaiagents.storage import FileBackend

  backend = FileBackend(storage_dir="~/.praisonai/runs")
  history = RunHistory(backend=backend)
  ```

  ```python MCPToolIndex theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
  from praisonai.mcp_server.tool_index import MCPToolIndex
  from praisonaiagents.storage import FileBackend

  backend = FileBackend(storage_dir="~/.praisonai/mcp")
  index = MCPToolIndex(backend=backend)
  ```
</CodeGroup>

### CLI Usage

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# 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](/docs/storage/backends) for more details.