Zep: The Memory Foundation For Your AI Stack

Examples, Integrations, & More

What is Zep? 💬

Zep is a memory platform for AI agents that learns from user interactions and business data. It builds a temporal knowledge graph to provide AI assistants with personalized, accurate, and up-to-date information, enhancing user experiences through continuous learning.

How Zep works

1. Add chat messages or data artifacts to Zep during each user interaction or agent event
2. Zep intelligently integrates new information into the user's Knowledge Graph, updating existing context as needed
3. Retrieve relevant facts from Zep for subsequent interactions or events

Zep's temporal Knowledge Graph maintains contextual information about facts, enabling reasoning about state changes and providing data provenance insights.

Getting Started

Sign up for Zep Cloud

Visit www.getzep.com to sign up for Zep Cloud, our managed service that offers low latency, scalability, and high availability with additional features like dialog classification and structured data extraction.

Find Zep SDKs

Zep offers comprehensive SDKs for multiple languages:

• Python: pip install zep-cloud
• TypeScript/JavaScript: npm install @getzep/zep-cloud
• Go: go get github.com/getzep/zep-go/v2

Get Help

• Documentation: help.getzep.com
• Discord Community: Join our Discord
• Support: Visit our help website for comprehensive guides and tutorials

About This Repository

Note: This repository is currently a work in progress.

This repository contains example projects, code samples, and other components to help you get started with Zep. Explore the examples to see how Zep integrates with popular frameworks like LangChain, LlamaIndex, and others.

Repository Structure

The repository includes:

• Example applications demonstrating Zep integration
• Code samples for different use cases
• Additional tools and utilities
• Legacy code (see Community Edition section below)

Development Setup

This project uses UV for Python package management with workspace features.

Prerequisites

• Python 3.13+
• UV package manager

Getting Started

1. Install UV (if not already installed): ```bash # On macOS and Linux curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex" ```

1. Sync the workspace: bash uv sync

2. Activate the virtual environment: ```bash # On Unix/macOS source .venv/bin/activate

# On Windows .venv\Scripts\activate ```

Workspace Structure

This project is configured as a UV workspace with the following packages:

• Main package (zep): Core Zep functionality
• Autogen integration (integration/autogen/): Integration package for Autogen framework

Working with the Workspace

• Install dependencies: uv sync
• Add dependencies to main package: uv add <package>
• Add dependencies to autogen integration: uv add --project integration/autogen <package>
• Run tests for autogen integration: uv run --project integration/autogen pytest
• Build packages: uv build

Integration Development

The autogen integration package is located in integration/autogen/ with the following structure:

integration/autogen/
├── src/zep_autogen/     # Package source code
├── tests/               # Test files
└── pyproject.toml       # Package configuration

Contributing

We welcome contributions to help improve Zep and its ecosystem. Please see the CONTRIBUTING.md file for guidelines on how to contribute, including:

• Code contributions
• Documentation improvements
• Bug reports and feature requests
• Community examples and integrations

Graphiti: The Knowledge Graph Framework

Zep is powered by Graphiti, an open-source temporal knowledge graph framework that we developed to handle changing relationships and maintain historical context.

What makes Graphiti unique is its ability to autonomously build a knowledge graph while reasoning about state changes over time. Each fact includes valid_at and invalid_at dates, allowing agents to track changes in user preferences, traits, or environment.

Visit the Graphiti repository to learn more about the knowledge graph framework that powers Zep's memory capabilities.

Community Edition (Legacy)

Note: Zep Community Edition is no longer supported and has been deprecated. The Community Edition code has been moved to the legacy/ folder in this repository.

For current Zep development, we recommend using Zep Cloud or exploring the example projects in this repository.

Read more about this change in our announcement: Announcing a New Direction for Zep's Open Source Strategy