zep-cloud-memory

Zep v3 Cloud memory bridge for n8n AI Agents

Package Information

Released: 9/23/2025
Downloads: 950 weekly / 950 monthly
Latest Version: 2.2.0
Author: Fabio H

Available Nodes

Zep Memory icon
Zep Memory
No description available

Documentation

n8n Zep v3 Cloud Memory

Community node that connects n8n AI Agents to Zep Cloud persistent memory using the official Zep v3 client.

Features

  • Works as an AI Memory sub-node (output ai_memory) for the AI Agent node
  • Cria e gerencia threads do Zep v3 (antigas sessions) a partir de um Thread ID
  • Persiste as mensagens user/assistant e devolve o histórico ao agente
  • Opcionais: apagar a thread antes de iniciar o fluxo

Requirements

  • Node.js 20+
  • n8n 1.95.0 or newer (or any version capable of running community nodes)
  • Zep Cloud API key (z_…)

Installation

npm install
npm run build

Publish to npm or link the package into an n8n instance:

npm link
# inside your n8n user folder (~/.n8n)
npm link n8n-nodes-zep-cloud-memory

Usage

  1. Crie a credencial Zep Cloud API em n8n e informe sua API key.
  2. Adicione o node Zep Memory e conecte-o ao AI Agent como memória.
  3. Informe o Thread ID (por padrão {{$json.threadId || $executionId}}). Esse valor é usado diretamente como threadId no Zep v3.
  4. Ative Limpar Memória ao Iniciar caso queira excluir qualquer histórico anterior antes da execução.
  5. Execute o fluxo; o node criará/atualizará a thread usando o SDK oficial (thread.create, thread.addMessages, etc.).

Development

  • npm run build compiles TypeScript into dist/
  • npm run lint runs the official n8n community node scanner

License

MIT

Discussion