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

# Migrate from Zep

> Switch from Zep to MemoClaw — simpler auth, pay-per-request pricing.

Zep provides memory and knowledge graphs for AI assistants. MemoClaw offers similar capabilities with wallet-based identity — no API keys to manage.

## Key Differences

| Feature         | Zep               | MemoClaw                                |
| --------------- | ----------------- | --------------------------------------- |
| Authentication  | API key + project | Wallet signature / x402                 |
| Pricing         | Subscription      | Pay-per-request (variable per endpoint) |
| Memory model    | Session-based     | Content-based with namespaces           |
| Knowledge graph | Built-in          | Relations (5 types)                     |
| Fact extraction | Automatic         | Via `/ingest` or `/extract`             |

## Concept Mapping

| Zep                                       | MemoClaw                           |
| ----------------------------------------- | ---------------------------------- |
| `client.memory.add(session_id, messages)` | `client.ingest(messages=messages)` |
| `client.memory.search(text)`              | `client.recall(query)`             |
| Session                                   | `session_id` parameter             |
| User                                      | Wallet address (automatic)         |
| Collection                                | `namespace`                        |

## Migration Steps

<Steps>
  <Step title="Install MemoClaw">
    <CodeGroup>
      ```bash Python theme={null}
      pip install memoclaw
      ```

      ```bash TypeScript theme={null}
      npm install memoclaw
      # or pnpm add memoclaw
      ```
    </CodeGroup>
  </Step>

  <Step title="Replace session-based memory">
    <CodeGroup>
      ```python Zep (before) theme={null}
      from zep_cloud.client import Zep
      client = Zep(api_key="z_...")
      client.memory.add(session_id="s1", messages=[
          {"role": "user", "content": "I prefer dark mode"},
      ])
      results = client.memory.search("preferences", limit=5)
      ```

      ```python MemoClaw (after) theme={null}
      from memoclaw import MemoClaw
      client = MemoClaw()
      client.ingest(
          messages=[{"role": "user", "content": "I prefer dark mode"}],
          session_id="s1",
          auto_relate=True,
      )
      results = client.recall("preferences", limit=5)
      ```
    </CodeGroup>
  </Step>

  <Step title="Migrate knowledge graph to relations">
    ```python theme={null}
    client.create_relation(
        memory_id_1,
        target_id=memory_id_2,
        relation_type="related_to",
    )
    ```
  </Step>
</Steps>

## What You Gain

* **Simpler auth** — no API keys to rotate
* **Predictable costs** — pay exactly what you use
* **100 free calls** (many endpoints are completely free) — try before you pay
* **Memory types with decay** — corrections persist longer than observations
* **Consolidation** — auto-merge redundant memories