Skip to main content
Chibi supports multiple storage backends for persisting user data and conversation history.

​
Storage Priority

Chibi selects the storage backend based on the available configuration, in the following order of priority:
  1. Redis (if REDIS URL is set)
  2. DynamoDB (if AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are set)
  3. Local Filesystem (Default fallback)

​
Local Filesystem

The default storage method. Data is serialized using Python Pickle (.pkl) and stored in the specified directory.
[!NOTE] Since data is stored in binary .pkl files, it is not manually editable.

​
Redis

Redis is the recommended backend for Docker deployments. It offers better performance and handles concurrency well.

​
AWS DynamoDB

For serverless and high-scale deployments, DynamoDB is supported.
[!WARNING] Security Advisory Your AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY grant access to your AWS account. Use IAM roles with least privilege.

​
Metrics (InfluxDB)

Chibi can export operational metrics (e.g., token usage, response times) to InfluxDB.