---
title: File memory
description: Store durable per-principal memory in a private Vercel Blob store provisioned for the agent.
type: memory
keywords:
  - memory
  - file memory
  - Vercel Blob
  - private storage
  - long-term memory
  - per-principal memory
  - OIDC
---

# File memory

Memory provider integration for eve. Store durable per-principal memory in a private Vercel Blob store provisioned for the agent.

## Install

Install and provision file memory for eve:

```bash
eve add memory/file
```

After you approve setup, eve creates or reuses a dedicated private Vercel Blob store, connects it to production, preview, and development, and pulls the resulting environment variables. Vercel Blob usage may incur charges.

## Quick start

The registry writes this memory slot:

```ts title="agent/memory/file.ts"
import { fileMemory } from "eve/memory/file";
import { defineMemory } from "eve/memory";
import { byPrincipal } from "eve/memory/scope";

export default defineMemory({
  description: "Remember stable facts and preferences about the caller.",
  provider: fileMemory(),
  scope: byPrincipal,
});
```

During `eve dev`, file memory stays in the local process. On Vercel, the default backend uses the private Blob store provisioned by setup.

## Configure

Run `eve integration setup file-memory` to repair or re-run provisioning without reinstalling the registry item. Setup uses the first configured function region, preserves an existing eve-owned store if the project region later changes, and never adopts or changes an application store connected with `BLOB_*`.

Provisioned bindings use the `EVE_MEMORY_BLOB_*` namespace. `fileMemory()` prefers `EVE_MEMORY_BLOB_READ_WRITE_TOKEN`, then `EVE_MEMORY_BLOB_STORE_ID` with Vercel OIDC from the environment or request context. Generic `BLOB_*` credentials remain a fallback for manually connected stores. See [File memory](/docs/memory/file) for backend behavior and manual configuration.

[Read the full memory provider documentation](/docs/memory/file)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)