Add Memory

Enable memory so agents remember what users told them - within a conversation and across sessions. This guide adds persistent memory to your formation.

Overview

MUXI memory layers:

1. Buffer - Recent messages (in-memory)
2. Vector Search - Semantic similarity
3. Persistent - Long-term storage (database)

Step 1: Enable Buffer Memory

Add to formation.afs:

memory:
  buffer:
    size: 50        # Keep 50 recent messages

This remembers the current conversation.

Step 2: Enable Vector Search

Find related past conversations:

memory:
  buffer:
    size: 50
    vector_search: true

Step 3: Enable Persistent Memory

Save across sessions:

SQLite (Simple)

memory:
  persistent:
    enabled: true
    provider: sqlite

PostgreSQL (Multi-user)

memory:
  persistent:
    enabled: true
    provider: postgresql
    connection_string: ${{ secrets.POSTGRES_URI }}

Add secret:

muxi secrets set POSTGRES_URI
# Enter: postgresql://user:pass@host:5432/muxi

Step 4: Test

muxi dev

Test memory:

You: My name is Alice
Assistant: Nice to meet you, Alice!

[Restart formation]

You: What's my name?
Assistant: Your name is Alice.

Full Configuration

memory:
  buffer:
    size: 50
    multiplier: 10
    vector_search: true

  persistent:
    enabled: true
    provider: postgresql
    connection_string: ${{ secrets.POSTGRES_URI }}
    user_isolation: true

Multi-User Memory

Isolate memory per user:

memory:
  persistent:
    enabled: true
    provider: postgresql
    user_isolation: true

Pass user ID in requests:

curl -H "X-Muxi-User-Id: user_123" ...

Disable Memory

For stateless interactions:

memory:
  buffer:
    size: 0
  persistent:
    enabled: false

Troubleshooting

Memory Not Persisting

Check database connection:

psql $POSTGRES_URI -c "SELECT 1"

High Memory Usage

Reduce buffer size:

memory:
  buffer:
    size: 20

Learn More

Memory Reference - Configuration options
Memory Concept - Architecture overview
Deep Dive: Memory Systems - Technical internals
Multi-User Support - User isolation