https://github.com/getzep/zep
Zep | Examples, Integrations, & More
https://github.com/getzep/zep
ai knowledge-graphs language-model llm
Last synced: 28 days ago
JSON representation
Zep | Examples, Integrations, & More
- Host: GitHub
- URL: https://github.com/getzep/zep
- Owner: getzep
- License: apache-2.0
- Created: 2023-04-29T14:06:22.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-10-07T21:55:34.000Z (about 1 month ago)
- Last Synced: 2025-10-10T22:35:52.686Z (about 1 month ago)
- Topics: ai, knowledge-graphs, language-model, llm
- Language: Python
- Homepage: https://help.getzep.com
- Size: 23.5 MB
- Stars: 3,691
- Watchers: 25
- Forks: 547
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- Awesome-LLM-Productization - Zep - a fast, scalable building blocks for production LLM apps (Models and Tools / LLM Boilerplate)
- awesome - getzep/zep - Zep | Examples, Integrations, & More (Python)
- awesome-langchain - Zep - term memory store for LLM / Chatbot applications  (Tools / Services)
- StarryDivineSky - getzep/zep
- awesome-production-genai - Zep - Zep is a memory platform for AI agents that learns from user interactions and business data. (Memory Management)
- awesome-langchain-zh - Zep
- awesome-llm-tools - Zep
- awesome-llm-tools - Zep
README
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](https://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](https://help.getzep.com)
- **Discord Community**: [Join our Discord](https://discord.gg/W8Kw6bsgXQ)
- **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](https://github.com/astral-sh/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"
```
2. **Sync the workspace**:
```bash
uv sync
```
3. **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 `
- **Add dependencies to autogen integration**: `uv add --project integration/autogen `
- **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](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](https://github.com/getzep/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](https://github.com/getzep/graphiti) 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](https://blog.getzep.com/announcing-a-new-direction-for-zeps-open-source-strategy/)