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

# storage • AI Agents Framework

> Storage adapter implementations for PraisonAI.

# storage

<Badge color="purple">AI Agents Framework</Badge>

Storage adapter implementations for PraisonAI.

Heavy implementations that follow StorageBackendProtocol for:

* Redis (praisonai\[redis])
* MongoDB (praisonai\[mongodb])
* PostgreSQL (praisonai\[postgresql])
* DynamoDB (praisonai\[dynamodb])
* Valkey (praisonai\[valkey])

NOTE: `praisonai.storage` holds the canonical, low-level storage adapters.
It is NOT dead code — `praisonai.persistence` builds on top of it. For
example `praisonai.persistence.state.redis.RedisStateStore` is a thin wrapper
around `RedisStorageAdapter` defined here, so this module is load-bearing and
canonical for the backends that `persistence` wraps.

Note on remaining duplication: `persistence.state.mongodb` / `dynamodb` /
`valkey` currently keep their own driver logic instead of wrapping the
adapters here. This is because `StateStore` and these adapters implement
different contracts — `StateStore` adds per-key TTL, hash operations
(`hget`/`hset`) and counters (`incr`/`decr`), and the DynamoDB store
uses a different partition-key schema (`pk`) than the adapter (`key`).
Collapsing them therefore requires care to avoid changing stored-data layout;
until that is done, treat these adapters as the canonical KV/blob layer and the
`persistence.state` stores as the richer, TTL/hash-aware state layer.

Application code that just needs a persistence layer should use
`create_state_store`, `create_conversation_store`, or
`create_knowledge_store` from `praisonai.persistence.factory`.

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai import storage
```

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="RAG Concept" icon="magnifying-glass" href="/docs/docs/concepts/rag" />

  <Card title="RAG Overview" icon="database" href="/docs/docs/rag/overview" />

  <Card title="Chunking Strategies" icon="scissors" href="/docs/docs/rag/strategies/overview" />
</CardGroup>