# StoreBackend

> **Class** in `deepagents`

📖 [View in docs](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend)

Backend that stores files in LangGraph's BaseStore (persistent).

Uses LangGraph's Store for persistent, cross-conversation storage.
Files are organized via namespaces and persist across all threads.

The namespace can include an optional assistant_id for multi-agent isolation.

## Signature

```python
StoreBackend(
    self,
    runtime: object = None,
    *,
    store: BaseStore | None = None,
    namespace: NamespaceFactory | None = None,
    file_format: FileFormat = 'v2',
)
```

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `runtime` | `object` | No | Deprecated - accepted for backward compatibility but ignored.  Store and context are now obtained via ``get_store()`` / ``get_runtime()``. (default: `None`) |
| `store` | `BaseStore \| None` | No | Optional ``BaseStore`` instance.  When provided, this store is used directly.  When ``None`` (the default), the store is obtained at call time via ``get_store()``, which requires a LangGraph graph execution context. (default: `None`) |
| `namespace` | `NamespaceFactory \| None` | No | Optional callable that receives a ``Runtime`` and returns a namespace tuple for scoping store operations. Wildcards (``*``) are forbidden. If ``None``, uses legacy assistant_id detection from metadata (deprecated).  Old-style callables that accept ``BackendContext`` still work but are deprecated and will be removed in v0.7. (default: `None`) |
| `file_format` | `FileFormat` | No | Storage format version. `"v1"` (default) stores content as `list[str]` (lines split on `\\n`) without an `encoding` field.  `"v2"` stores content as a plain `str` with an `encoding` field. (default: `'v2'`) |

## Extends

- `BackendProtocol`

## Constructors

```python
__init__(
    self,
    runtime: object = None,
    *,
    store: BaseStore | None = None,
    namespace: NamespaceFactory | None = None,
    file_format: FileFormat = 'v2',
) -> None
```

| Name | Type |
|------|------|
| `runtime` | `object` |
| `store` | `BaseStore \| None` |
| `namespace` | `NamespaceFactory \| None` |
| `file_format` | `FileFormat` |


## Methods

- [`ls()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/ls)
- [`read()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/read)
- [`aread()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/aread)
- [`write()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/write)
- [`awrite()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/awrite)
- [`edit()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/edit)
- [`aedit()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/aedit)
- [`grep()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/grep)
- [`glob()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/glob)
- [`upload_files()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/upload_files)
- [`download_files()`](https://reference.langchain.com/python/deepagents/backends/store/StoreBackend/download_files)

---

[View source on GitHub](https://github.com/langchain-ai/deepagents/blob/a9e6e4f7ad7fe161dd9affc3d74bb19784aca70b/libs/deepagents/deepagents/backends/store.py#L153)