Session Management | PraisonAIUI Docs

Session ManagementPraisonAIUI provides full session management for chat conversations — create, switch, view history, and delete sessions.Quick StartData Persistence Options| Mode | Flag | Persists? | Best For ||------|------|-----------|----------|| Memory | --datastore memory (default) | ❌ Lost on restart | Development, testing || JSON Files | --datastore json | ✅ ~/.praisonaiui/sessions/ | Single-user, local || JSON (custom path) | --datastore json:/path/to/dir | ✅ Custom directory | Custom setups || Custom DB | Implement BaseDataStore | ✅ Your database | Production |REST APIList SessionsCreate SessionGet Session DetailsGet Message HistoryDelete SessionSend MessageCLI CommandsEvery API endpoint has a CLI equivalent:Use --server to target a different server:Custom Data StoreImplement BaseDataStore for any database (SQLite, PostgreSQL, Redis, MongoDB, etc.):Register before the server starts:Backend Modes| Mode | Command | Transport | Session Source ||------|---------|-----------|---------------|| Standalone (default) | aiui run app.py | SSE over HTTP | DataStore || PraisonAI | aiui run app.py --backend praisonai | WebSocket | WebSocketGateway |In standalone mode, sessions are managed by the configurable DataStore.In praisonai mode, sessions are managed by the WebSocketGateway from the praisonai package.