base on Zep | Examples, Integrations, & More <p align="center"> <a href="https://www.getzep.com/"> <img src="https://github.com/user-attachments/assets/119c5682-9654-4257-8922-56b7cb8ffd73" width="150" alt="Zep Logo"> </a> </p> <h1 align="center"> Zep: The Memory Foundation For Your AI Stack </h1> <h2 align="center">Examples, Integrations, & More</h2> <br /> <p align="center"> <a href="https://discord.gg/W8Kw6bsgXQ"><img src="https://dcbadge.vercel.app/api/server/W8Kw6bsgXQ?style=flat" alt="Chat on Discord" /></a> <a href="https://twitter.com/intent/follow?screen_name=zep_ai" target="_new"><img alt="Twitter Follow" src="https://img.shields.io/twitter/follow/zep_ai"></a> </p> ## 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 <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](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/) ", Assign "at most 3 tags" to the expected json: {"id":"2320","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"