Zep: End-to-End Context Engineering Platform
Examples, Integrations, & More
## What is Zep? đź’¬
Zep is an end-to-end context engineering platform that delivers the right information at the right time with sub-200ms latency. It solves the agent context problem by assembling comprehensive, relationship-aware context from multiple data sources—chat history, business data, documents, and app events—enabling AI agents to perform accurately in production.
### How Zep works
1. **Add context**: Feed chat messages, business data, and events to Zep as they occur
2. **Graph RAG**: Zep automatically extracts relationships and maintains a temporal knowledge graph that understands how context evolves over time
3. **Retrieve & assemble**: Get pre-formatted, relationship-aware context blocks optimized for your LLM
Zep's relationship-aware retrieval system delivers context about facts, relationships, and how they've changed—providing agents with current, accurate, and relevant information for better decision-making.
## Getting Started
### Sign up for Zep Cloud
Visit [www.getzep.com](https://www.getzep.com/) to sign up for Zep Cloud, our managed service delivering intelligent agent context with <200ms latency, enterprise-grade scalability, and SOC2 Type 2 / HIPAA compliance. Add context assembly to your agents in three lines of code.
### 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 examples, integrations, and tools for building intelligent agent context with Zep. Explore the example applications to see how Zep delivers context assembly with LangChain, LlamaIndex, AutoGen, and other frameworks.
### Repository Structure
The repository includes:
- Example applications demonstrating agent context assembly with Zep
- Integration packages for popular agent frameworks
- Code samples for different use cases
- Development tools and utilities
## 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 enables relationship-aware context retrieval.
Graphiti autonomously builds and maintains knowledge graphs while reasoning about state changes over time. Each fact includes `valid_at` and `invalid_at` dates, allowing agents to understand how relationships, preferences, and context have evolved—essential for accurate decision-making in dynamic environments.
Visit the [Graphiti repository](https://github.com/getzep/graphiti) to learn more about the temporal knowledge graph framework that powers Zep's context assembly 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/)