memsearch

给 AI 智能体装上长期记忆，跨会话秒级召回关键信息

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 279 🐛 待处理 263 👀 关注 10

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 2834

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，可免费自部署使用，无在线服务或付费版本。

项目预览

项目数据

分类搜索知识

开发团队zilliztech

官网地址https://zilliztech.github.io/memsearch

GitHubhttps://github.com/zilliztech/memsearch

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，可免费自部署使用，无在线服务或付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,agent-memory,claude-code,claude-code-plugin,codex,deepseek,deepseek-harness,dsh,dsh-plugin,embeddings,hybrid-search,jev,long-term-memory,memory,milvus,openclaw,opencode,rag,semantic-search,skills

GitHub 星标★ 2834

上线时间2026-02-09 00:00:00

代码更新2026-11-06

仓库体积26.7 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

memsearch 是一个为 AI 智能体（如 Claude Code、Codex）设计的持久化统一记忆层，基于 Markdown 和 Milvus 向量数据库构建。它解决了 AI 智能体在长时间任务中缺乏长期记忆、上下文窗口有限的问题，使得智能体可以跨会话、跨项目地存储和检索关键信息。核心能力包括：自动将对话、代码片段、决策记录等结构化或非结构化内容转换为向量并存储，通过语义搜索快速召回相关记忆；支持 Markdown 格式，便于人类阅读和编辑；提供简单的 API 和命令行工具，易于集成到现有智能体工作流中。该项目使用 Python 编写，依赖 Milvus 实现高性能向量检索，适合需要持久化记忆的 AI 应用场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2834

技术标签

agent agent-memory claude-code claude-code-plugin codex

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

Python >= 3.10
能访问 PyPI 安装 memsearch（如 uv tool install）
可选：Docker，用于自托管 Milvus 服务
可选：Zilliz Cloud 账号与 API Key（推荐托管方案）
安装 Codex 插件时需联网下载 ONNX 模型

安装与启动步骤

1安装 CLI

README 提供 uv 方式把 memsearch 装成全局命令行工具，onnx 额外依赖用于本地嵌入模型。
```
uv tool install "memsearch[onnx]"
```
2运行配置向导

交互式初始化配置，写入 ~/.memsearch/config.toml，决定嵌入模型与 Milvus 后端。
```
memsearch config init
```
3确认向量后端

默认开箱即用，使用本地 ~/.memsearch/milvus.db；如需切换可改为 Zilliz Cloud 或自托管地址。
```
memsearch config get milvus.uri
```
4切换嵌入提供方

可选操作，把嵌入模型提供方切换为 onnx，实现不依赖外部 API 的本地嵌入。
```
memsearch config set embedding.provider onnx
```
5索引记忆目录

把存放 Markdown 记忆的目录建好并索引；加 --force 会重新嵌入全部内容。
```
memsearch index ./memory/
```
6执行语义搜索

混合检索（BM25 + 向量）召回相关记忆；--json-output 便于脚本消费结果。
```
memsearch search "Redis caching"
```
7安装智能体插件

以 Claude Code 为例，用 /plugin 命令从 marketplace 安装插件；Codex 走 install.sh 脚本。
```
/plugin marketplace add zilliztech/memsearch
/plugin install memsearch
```
8开启实时同步

监听记忆目录，文件变更时自动重新索引，保持记忆与检索结果一致。
```
memsearch watch ./memory/
```

关键配置

配置项	必填	说明	示例
`milvus.uri`	否	Milvus 后端地址，默认使用本地 ~/.memsearch/milvus.db	`http://localhost:19530`
`milvus.token`	否	Zilliz Cloud 集群的 API Key，使用云端时必须设置	`your-api-key`
`embedding.provider`	否	嵌入模型提供方，如切换为 onnx 走本地模型	`onnx`