basic-memory

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 353 🐛 待处理 78 👀 关注 14

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4530

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，AGPL-3.0许可，可自行部署使用，完全免费。

项目预览

项目数据

分类开源模型

开发团队basicmachines-co

官网地址https://basicmemory.com

GitHubhttps://github.com/basicmachines-co/basic-memory

定价模式🏷️完全免费

价格说明开源项目，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 星标★ 4530

上线时间2024-12-02 00:00:00

代码更新2026-11-07

仓库体积60.6 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

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

Star 增长趋势

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

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

技术标签

ai claude knowledge-management llm local-first

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

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

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

环境要求

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

安装与启动步骤

1注册云端试用

README 首推跳过安装直接上云。打开 basicmemory.com 开始 7 天免费试用，第 7 天前可随时取消。
2选择订阅方式

月付 15.00 美元并终身锁定该价格，年付为 12.50 美元/月。目前为 Beta 定价，注册后费率不再上涨。
3开源用户领优惠

如果你是开源用户，在注册时使用优惠码 BMFOSS，可在 3 个月内再享 8 折。
4连接 AI 客户端

按官方引导把 Claude、Codex 或 Cursor 连上，README 称 30 秒内即可完成，无需写配置文件。
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 当时的描述，可能随项目调整，请以下单页面为准。