basic-memory

让 AI 记住每次对话,告别反复解释项目背景

basic-memory 是一个面向 AI 对话的持久记忆层开源项目,旨在解决 AI 助手在多次对话中丢失上下文、需要用户反复解释背景的问题。它通过将对话中的关键信息(如项目细节、用户偏好、决策记录)结构化存储为本地 Markdown 文件,并利用嵌入向量实现语义检索,让 AI 在后续对话中自动召回相关记忆。核心能力包括:自动从对话中提取并保存记忆、支持自然语言查询历史记忆、与 Claude 等主流 AI 工具无缝集成、提供 CLI 和 MCP 服务器接口。项目采用 Python 构建,设计轻量,数据完全本地化,强调隐私和可移植性。目前处于活跃开发阶段,社区通过 Discord 协作,适合个人开发者或小团队构建长期 AI 工作流。

开源 free 开源模型
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 4029
维护状态 活跃
是否开源
定价模式 free

项目数据

分类开源模型
开发团队basicmachines-co
所属国家
定价模式free
价格说明开源项目,AGPL-3.0许可,可自行部署使用,完全免费。
访问状态
是否开源
开源协议AGPL-3.0
主要语言Python
技术栈/模型ai,claude,knowledge-management,knowlege-graph,llm,local-first,markdown,mcp,obsidian,obsidian-md,open-source,privacy-first,privacy-first-ai,productivity,python
GitHub 星标★ 4029
30天Star增速
HF 下载量
上线时间2024-12-02 00:00:00
最近更新2026-09-23 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数3

使用教程

难度:入门 约 5 分钟 部署方式:云服务 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • 支持 MCP 协议的 AI 客户端(如 Claude、Codex、Cursor)
  • 浏览器,用于注册云端服务
  • 无需 Python、无需编辑 JSON、无需终端(云服务方式)

安装与启动步骤

  1. 1注册云端试用

    README 首推跳过安装直接上云。打开 basicmemory.com 开始 7 天免费试用,第 7 天前可随时取消。

  2. 2选择订阅方式

    月付 15.00 美元并终身锁定该价格,年付为 12.50 美元/月。目前为 Beta 定价,注册后费率不再上涨。

  3. 3开源用户领优惠

    如果你是开源用户,在注册时使用优惠码 BMFOSS,可在 3 个月内再享 8 折。

  4. 4连接 AI 客户端

    按官方引导把 Claude、Codex 或 Cursor 连上,README 称 30 秒内即可完成,无需写配置文件。

  5. 5启用团队工作区

    需要多人协作可开通 Basic Memory Teams:团队成员写入的内容会立即对其他人及其 AI 助手可见,可从 1 人起步逐步加人。

关键配置

配置项必填说明示例
BMFOSS开源用户优惠码,3 个月内额外 8 折BMFOSS

如何确认成功

AI 客户端显示已连接 Basic Memory,并能读取、写入磁盘上的 Markdown 笔记即算成功。

常见问题

Q:不想装 Python 能用吗?

A:可以。README 明确提供云端方式,30 秒内连上 Claude、Codex 或 Cursor,不需要 Python、JSON 或终端。

Q:数据存在哪里?

A:项目定位为 local-first,知识以纯文本 Markdown 文件保存在你自己的磁盘上,人与 AI 读写的是同一批文件。

Q:有免费试用吗?

A:有 7 天免费试用,在第 7 天前取消即可,之后按月 15.00 美元或年付 12.50 美元/月计费。

Q:团队能共享记忆吗?

A:可以,Basic Memory Teams 提供共享云工作区,队友写的内容会立刻对所有人及其 AI 助手可见。

Q:开源用户有折扣吗?

A:注册时使用优惠码 BMFOSS,可在 3 个月内额外享受 20% 折扣。

注意事项

  • 本次 README 节选只有云端试用与团队版介绍,未包含 git clone、pip/uv 安装等本地部署命令,因此本教程未给出任何本地安装步骤。
  • 如需本地安装,请以 GitHub 仓库 https://github.com/basicmachines-co/basic-memory 的最新 README 为准。
  • 价格与优惠信息来自 README 当时的描述,可能随项目调整,请以下单页面为准。

核心亮点

  • 自动提取对话关键信息,无需手动整理笔记
  • 本地 Markdown 存储,数据透明且易迁移
  • 提供 MCP 服务器,可无缝接入 Claude 等主流 AI 工具

不足之处

  • 文档/社区待观察
  • 依赖嵌入模型,离线场景下检索效果受限

适用场景

  • 长期项目开发中,让 AI 助手保持项目上下文
  • 个人知识库管理,自动沉淀对话中的决策和偏好
  • 团队协作时,共享 AI 记忆以减少重复沟通

替代项目

Mem0、Letta、MemGPT

项目介绍

basic-memory 是基础设施领域的开源项目,由 basicmachines-co 开发,2024 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(4,029)位列前 30%,在基础设施分类中处于中上游。

近 42 天,它的 GitHub 星标从 3,641 增加到 4,029,净增 388。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-23。AGPL-3.0许可,可自行部署使用,完全免费。

它主要面向的使用场景是:长期项目开发中,让AI助手保持项目上下文。同类可对比的替代方案包括 Mem0、Letta、MemGPT。

上一篇:FastDeploy

下一篇:Rapid-MLX

同类项目推荐

freebuff-proxy 开源

聚合多账号,一键接入 OpenAI 兼容 API,轻松管理会话。

Multi-account OpenAI-compatible gateway for coding models. Pooled keys, session life···

★ 213 2026-08-20
microduck 开源

用 Rust 造一只会走路的桌面小鸭,快速上手双足机器人。

A Tiny biped duck robot

★ 8684 2026-09-10
soperator 开源

用 Kubernetes 原生方式运行 Slurm,简化 HPC 集群管理。

Run Slurm in Kubernetes

★ 439 2026-08-10
ollama 开源

一条命令本地跑起大模型,免费、私密、不卡顿

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other···

★ 181484 2026-08-09