{"id":13409332,"url":"https://github.com/getzep/zep","last_synced_at":"2025-10-13T19:16:25.728Z","repository":{"id":163542852,"uuid":"634244448","full_name":"getzep/zep","owner":"getzep","description":"Zep | Examples, Integrations, \u0026 More","archived":false,"fork":false,"pushed_at":"2025-10-07T21:55:34.000Z","size":24601,"stargazers_count":3691,"open_issues_count":17,"forks_count":547,"subscribers_count":25,"default_branch":"main","last_synced_at":"2025-10-10T22:35:52.686Z","etag":null,"topics":["ai","knowledge-graphs","language-model","llm"],"latest_commit_sha":null,"homepage":"https://help.getzep.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getzep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-04-29T14:06:22.000Z","updated_at":"2025-10-10T17:58:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"e4d75d08-abbd-40a2-8f1d-d056d1636fc6","html_url":"https://github.com/getzep/zep","commit_stats":{"total_commits":268,"total_committers":14,"mean_commits":"19.142857142857142","dds":0.1977611940298507,"last_synced_commit":"bff3c40a3fadf211320df7970affb3cd8cc4070f"},"previous_names":["danielchalef/zep"],"tags_count":60,"template":false,"template_full_name":null,"purl":"pkg:github/getzep/zep","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getzep%2Fzep","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getzep%2Fzep/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getzep%2Fzep/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getzep%2Fzep/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getzep","download_url":"https://codeload.github.com/getzep/zep/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getzep%2Fzep/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279016887,"owners_count":26085884,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","knowledge-graphs","language-model","llm"],"created_at":"2024-07-30T20:00:59.939Z","updated_at":"2025-10-13T19:16:25.723Z","avatar_url":"https://github.com/getzep.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.getzep.com/\"\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/119c5682-9654-4257-8922-56b7cb8ffd73\" width=\"150\" alt=\"Zep Logo\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003e\nZep: The Memory Foundation For Your AI Stack\n\u003c/h1\u003e\n\n\u003ch2 align=\"center\"\u003eExamples, Integrations, \u0026 More\u003c/h2\u003e\n\n\u003cbr /\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://discord.gg/W8Kw6bsgXQ\"\u003e\u003cimg\n    src=\"https://img.shields.io/badge/Discord-%235865F2.svg?\u0026logo=discord\u0026logoColor=white\"\n    alt=\"Chat on Discord\"\n  /\u003e\u003c/a\u003e\n  \u003ca href=\"https://twitter.com/intent/follow?screen_name=zep_ai\" target=\"_new\"\u003e\u003cimg alt=\"Twitter Follow\" src=\"https://img.shields.io/twitter/follow/zep_ai\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## What is Zep? 💬\n\nZep 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.\n\n### How Zep works\n\n1. Add chat messages or data artifacts to Zep during each user interaction or agent event\n2. Zep intelligently integrates new information into the user's Knowledge Graph, updating existing context as needed\n3. Retrieve relevant facts from Zep for subsequent interactions or events\n\nZep's temporal Knowledge Graph maintains contextual information about facts, enabling reasoning about state changes and providing data provenance insights.\n\n## Getting Started\n\n### Sign up for Zep Cloud\n\nVisit [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.\n\n### Find Zep SDKs\n\nZep offers comprehensive SDKs for multiple languages:\n\n- **Python**: `pip install zep-cloud`\n- **TypeScript/JavaScript**: `npm install @getzep/zep-cloud`\n- **Go**: `go get github.com/getzep/zep-go/v2`\n\n### Get Help\n\n- **Documentation**: [help.getzep.com](https://help.getzep.com)\n- **Discord Community**: [Join our Discord](https://discord.gg/W8Kw6bsgXQ)\n- **Support**: Visit our help website for comprehensive guides and tutorials\n\n## About This Repository\n\n**Note**: This repository is currently a work in progress.\n\nThis 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.\n\n### Repository Structure\n\nThe repository includes:\n\n- Example applications demonstrating Zep integration\n- Code samples for different use cases\n- Additional tools and utilities\n- Legacy code (see Community Edition section below)\n\n## Development Setup\n\nThis project uses [UV](https://github.com/astral-sh/uv) for Python package management with workspace features.\n\n### Prerequisites\n\n- Python 3.13+\n- UV package manager\n\n### Getting Started\n\n1. **Install UV** (if not already installed):\n   ```bash\n   # On macOS and Linux\n   curl -LsSf https://astral.sh/uv/install.sh | sh\n   \n   # On Windows\n   powershell -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n   ```\n\n2. **Sync the workspace**:\n   ```bash\n   uv sync\n   ```\n\n3. **Activate the virtual environment**:\n   ```bash\n   # On Unix/macOS\n   source .venv/bin/activate\n   \n   # On Windows\n   .venv\\Scripts\\activate\n   ```\n\n### Workspace Structure\n\nThis project is configured as a UV workspace with the following packages:\n\n- **Main package** (`zep`): Core Zep functionality\n- **Autogen integration** (`integration/autogen/`): Integration package for Autogen framework\n\n### Working with the Workspace\n\n- **Install dependencies**: `uv sync`\n- **Add dependencies to main package**: `uv add \u003cpackage\u003e`\n- **Add dependencies to autogen integration**: `uv add --project integration/autogen \u003cpackage\u003e`\n- **Run tests for autogen integration**: `uv run --project integration/autogen pytest`\n- **Build packages**: `uv build`\n\n### Integration Development\n\nThe autogen integration package is located in `integration/autogen/` with the following structure:\n\n```\nintegration/autogen/\n├── src/zep_autogen/     # Package source code\n├── tests/               # Test files\n└── pyproject.toml       # Package configuration\n```\n\n## Contributing\n\nWe welcome contributions to help improve Zep and its ecosystem. Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines on how to contribute, including:\n\n- Code contributions\n- Documentation improvements\n- Bug reports and feature requests\n- Community examples and integrations\n\n## Graphiti: The Knowledge Graph Framework\n\nZep 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.\n\nWhat 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.\n\nVisit the [Graphiti repository](https://github.com/getzep/graphiti) to learn more about the knowledge graph framework that powers Zep's memory capabilities.\n\n\n## Community Edition (Legacy)\n\n**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.\n\nFor current Zep development, we recommend using Zep Cloud or exploring the example projects in this repository.\n\nRead 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/)\n","funding_links":[],"categories":["Models and Tools","Go","Python","Tools","A01_文本生成_文本对话","🛠️ Tools and Frameworks (Memory Infrastructure)","Memory Management","工具","🧐 Memory \u0026 Persistence","MCP \u0026 Model Context Protocol","AI Agent Frameworks \u0026 SDKs","Knowledge Graphs and Memory","Agent Infrastructure","2. Systems \u0026 Frameworks (stateful agents / memory managers)"],"sub_categories":["LLM Boilerplate","Services","大语言对话模型及数据","服务","Long-term Memory Systems","Agent Memory \u0026 Context","Cognitive Architecture Frameworks","Benchmark Reality Check (real-world tool use)","Memory \u0026 State"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetzep%2Fzep","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetzep%2Fzep","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetzep%2Fzep/lists"}