源码系统概览
文章正文
Basic Memory 是一套开源的本地优先 AI 记忆知识图谱源码，知识存储为纯 Markdown 文件，支持语义搜索和 MCP 协议，提供企业管理平台级别的知识管理功能。该平台能显著提升个人和团队的知识管理和记忆持久化效率。
源码简介
项目由 basicmachines-co 开发，基于 Python 和 TypeScript 构建。SQLite 和 PostgreSQL 双后端，fastembed 向量嵌入实现语义搜索。MCP 服务提供笔记写入、笔记搜索、上下文构建工具，AI 和人类双向写入同一文件，同步保持一致。渐进式工具发现，标注只读、破坏性、幂等行为。插件生态包含 Claude Code、Codex、OpenClaw、Hermes。项目采用 AGPL v3 协议开源，社区活跃，欢迎贡献 star 和 fork。最后更新 2026 年，更新日志见 GitHub 发布页面。当前版本号 v1.0.0。
适用场景
适用于 AI 助手持久记忆管理、团队知识库构建、个人笔记语义搜索、MCP 客户端上下文增强等场景，可替代云端笔记和知识管理服务。
技术栈与运行环境
主要使用 Python 开发，包含八百九十六个 Python 文件。TypeScript 文件四十八个。数据库支持 SQLite 和 PostgreSQL 双后端。向量嵌入使用 fastembed。代码检查使用 Ruff。包管理使用 uv。
功能亮点
- 本地优先，知识存储为纯 Markdown 文件
- AI 和人类双向写入同一文件，同步保持一致
- 语义搜索，按含义而非关键词查找笔记
- MCP 原生支持，兼容 Claude/Codex/Cursor 等
- 渐进式工具发现，标注只读/破坏性/幂等
技术架构与部署指南
安装与部署提示
首先克隆仓库到本地，使用 uv pip 安装依赖文件。运行环境需要 Python 3.12 以上。最后更新 2026 年，更新日志见 GitHub 发布页面。当前版本号 v1.0.0。
截图与演示说明
封面图展示 Basic Memory 知识图谱界面，可见思维导图式节点连接布局。
中心节点是知识类型，分支为笔记、文档、媒体、数据四个分类，每个分类标注了功能说明。
笔记用于快速记录原始内容，文档支持富文本结构化组织，媒体覆盖图片视频和音频，数据用于结构化查询。
界面顶部有编辑工具栏，支持节点拖拽和连线编辑。
截图来自项目测试截图文件，呈现了知识管理 MCP 平台的可视化图谱功能和节点关系浏览界面，直观展示了知识管理的分类体系。
常见问题
问：Basic Memory 是什么？
Basic Memory 是本地优先的 AI 记忆知识图谱，知识存为 Markdown，支持语义搜索和 MCP 协议。
问：Basic Memory 和 Obsidian 有什么区别？
Basic Memory 原生集成 MCP 协议，AI 可直接读写。Obsidian 需插件桥接。Basic Memory 是开源 AGPL 协议。
问：Basic Memory 怎么安装？
git clone 后 uv pip install -r requirements.txt，需要 Python 3.12+。也可 pip install basic-memory。
问：Basic Memory 免费吗？
采用 AGPL v3 开源协议，自用免费。商业用途需遵守 AGPL 条款或购买云服务。
问：支持哪些 AI 客户端？
支持 Claude Code/Codex/Cursor/ChatGPT 等所有支持 MCP 协议的 AI 客户端。
安全风险提示
扫描发现一处动态执行和两处硬编码凭据，位于测试代码中。
跨域资源共享由 MCP 服务配置，需限制来源域名。
Docker 容器部署时注意 PostgreSQL 密码修改和数据目录文件权限设置。
下载说明
已打包为 zip 压缩包，包含一千三百四十九个文件。下载后解压即可使用，包含完整的 Python 源码、MCP 服务配置和插件模板文件。提取码为 8888。
对比，区别 vs Obsidian：Basic Memory 知识管理MCP平台 和 Obsidian 的区别在于各自定位不同。下表展示主要差异：
| 项目 | 特点 |
|---|---|
| Obsidian | 笔记应用但无 AI/MCP 原生集成 |
| Notion | 云端但非本地优先 |
| Mem.ai | AI 笔记但不开源 |
GitHub项目开源地址：https://github.com/basicmachines-co/basic-memory
