Overview
Memory lets Omni retain selected context across future chats and background agent runs. It is disabled by default and must be enabled at deployment time with MEMORY_ENABLED=true.
Memory requires an active embedding provider. Configure one in Settings → Embedding Providers before enabling memory for users.
Admin Settings
Navigate to Settings → Memory to configure:
| Setting | Description |
|---|
| Default mode | Organization-wide memory ceiling and default for users without a personal preference |
| Memory model | LLM used to extract and recall memories. If unset, Omni uses the default chat model |
Memory Modes
| Mode | Behavior |
|---|
| Off | Memory is disabled for all users and agents |
| Chat memory | Completed chat turns can be summarized into memories and recalled in later chats |
| Full memory | Chat memory plus agent run context for background agents |
The organization default is a ceiling. Users can choose a lower personal mode from Settings → Memory, but cannot exceed the mode selected by an admin.
User Controls
Users can view and delete their own memories from Settings → Memory. They can also delete all stored memories for their account.
Deleting memories is permanent. Omni will not be able to recall deleted context in future chats.
Deployment Configuration
Set these environment variables before starting Omni:
| Variable | Default | Description |
|---|
MEMORY_ENABLED | false | Enables Memory settings pages and AI-service memory initialization |
MEMORY_PROVIDER | mem0 | Memory backend provider. mem0 is currently supported |
See Configuration Reference for the full environment variable reference.