Basic Memory

 ](https://badge.fury.io/py/basic-memory)     

跳过安装--尝试云中的Basic Memory

克劳德、Codex或Cursor在30秒内连接。没有Python，没有JSON，没有 终端。 14.25美元/月终身锁定 （原价19美元）。7天免费 试用期——如果不适合您，请在第7天之前的任何时间取消。Beta定价-- 现在注册，你的价格永远不会上涨。OSS用户：代码 BMFOSS 拿 三个月再打八折。

免费试用→

______________________________________________________________________

基本内存

你的AI再也不会忘记了。

从你停止的地方继续——用Claude、Codex、Cursor、ChatGPT或 任何能说话的东西 主控程序.你的知识 以Markdown文件的形式存在，您和您的AI都可以读取、写入和 搜索。

• 本地优先。 磁盘上的纯文本。永远。
• 双向。 人工智能和人类写入相同的文件；同步使它们保持同步。
• 真正的知识图谱。 观察和维基链接结合在一起。
• 语义搜索。 按含义查找笔记，而不仅仅是关键字。
• MCP原生。 适用于所有主要的AI客户端和IDE。
• 渐进式工具发现。 每个工具都标有行为提示

（只读、破坏性、幂等），以便代理选择正确的工具 需求——没有浪费上下文来尝试了解它们的作用。

• 云，可选。 在需要时跨设备同步，这是不需要的。

开始

选择适合你的道路。两者在相同的Markdown上运行相同的产品。

☁️ Cloud 💻 Local install

30秒。 注册，连接您的AI客户端，完成。

• 适用于任何浏览器
• 移动、网络、桌面
• 内置跨设备同步
• 我们处理托管、备份、快照

14.25美元/月终身锁定 ·7天免费试用·随时取消

免费试用→

2分钟。 安装、配置你的AI客户端，运行。

• 永久免费（AGPL-3.0）
• 磁盘上的所有数据
• 气隙友好
• 需要Python通过 uv

uv tool install basic-memory

配置您的客户端↓

人们在说什么

基本记忆改变了我与LLM的整个关系。我从GPT切换 因此，双子座将克劳德和克劳德代码排在首位 整合和我彻底改造了我们公司的所有流程 a基本内存工作流程。 — 亚历克斯培训师日

基本记忆是人工智能聊天机器人中缺失的“哇”因素。现在我不能 想象一下没有它的克劳德或克劳德密码。 — 迦勒Caleb Picker咨询公司

我再也不会在没有基本内存的情况下编码了。这真是节省时间 能够引用我目前没有活动的项目并保持运行 我所有学习和ProTips的日志。 — @ groksrc，开发人员

更多关于 基本记忆网.

基础内存云

基本内存的托管版本。相同的产品，相同的Markdown文件，相同的 MCP工具——我们只需托管数据库，运行同步，并将其放在您的 电话。

你得到了什么

• 每一个设备，都是同一个大脑。 您在网络、移动和

桌面。机器之间没有复制粘贴。

• 连接任何MCP客户端。 克劳德桌面，克劳德代码，法典，光标，

ChatGPT（自定义GPT）、VS Code——从web应用程序一键连接。

• 与本地双向同步。 在手机上编辑，在Obsidian上查看

你的笔记本电脑。rclone具有解决冲突的能力。

• 快照和备份。 时间点恢复。浏览历史记录。从不

丢失一张纸条。

• 没有锁定。 你的笔记是纯Markdown。导出到本地Markdown任意

时间——相同的文件，相同的格式，相同的维基链接。随时取消您的数据 保持你的。

基于WorkOS AuthKit、Neon Postgres和Tigris S3构建。平台来源于 基本存储云.

定价

每月14.25美元，在订阅期内锁定 （正常价格 $19).在测试期间注册，只要你留下来，费率就永远不会上涨 订阅后，您保留价格。一个计划，没有层次，没有意外升级。 无限笔记，无限项目，每个功能。

• 7天免费试用。如果不适合您，请在第7天之前的任何时间取消。
• 之后也可以随时取消——随时导出笔记。
• OSS用户：代码 BMFOSS 再享受3个月20%的折扣（约11.40美元/月）。

开始7天免费试用→

云与本地

这两条路径使用相同的OSS引擎和相同的Markdown文件。没有了 无论哪种方式锁定——当你的需求发生变化时，在它们之间切换。

使用您已经使用的工具

从你停止的地方继续

https://github.com/user-attachments/assets/a55d8238-8dd0-454a-be4c-8860dbbd0ddc

连接您的AI客户端

如果你去 云 路由，网络应用程序会引导您完成 客户端连接。以下代码段适用于本地安装。

克劳德桌面版

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["basic-memory", "mcp"]
    }
  }
}

重新启动克劳德桌面。笔记活在 ~/basic-memory 默认情况下。

Claude Code, Codex CLI, Cursor, VS Code, ChatGPT, Obsidian

克劳德代码

claude mcp add basic-memory -- uvx basic-memory mcp

Codex CLI

添加 ~/.codex/config.toml:

[mcp_servers.basic-memory]
command = "uvx"
args = ["basic-memory", "mcp"]

光标

添加 .cursor/mcp.json （项目）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["basic-memory", "mcp"]
    }
  }
}

VS Code

添加到用户设置（JSON）：

{
  "mcp": {
    "servers": {
      "basic-memory": {
        "command": "uvx",
        "args": ["basic-memory", "mcp"]
      }
    }
  }
}

ChatGPT

基本内存公开了OpenAI兼容 search 和 fetch 自定义工具 GPT操作。请参阅 ChatGPT集成 引导.

黑曜石

没有设置。黑曜石点 ~/basic-memory （或您的项目文件夹）和 你的AI写的相同的维基链接、frontmatter和Markdown出现在你的图表中 视图。编辑任一侧——其余部分由sync处理。

尝试提示：

"Create a note about our project architecture decisions."
"Find information about JWT auth in my notes."
"What have I been working on this week?"

最新动态

• 自动更新。 基本内存保持最新状态 uv tool

Homebrew安装； bm update 触发手动检查。

• 语义向量搜索。 按含义查找笔记，而不仅仅是关键字。

使用FastEmbed嵌入的混合全文+矢量排名，在SQLite或 Postgres。

• 架构系统。 推断、验证和区分您的结构

知识库 schema_infer, schema_validate, schema_diff.

• 按项目云路由。 通过云路由单个项目

而其他人则通过API密钥留在本地(bm project set-cloud).

• 更智能的编辑。 edit_note append/prepend在以下情况下自动创建笔记

失踪； write_note 防止意外覆盖。

• 更丰富的搜索结果。 包含匹配的块文本，以便LLM获得

上下文，而不仅仅是点击。

• FastMCP 3.0+工具注释。 每个工具都带有MCP行为

提示(readOnlyHint, destructiveHint, idempotentHint, openWorldHint)因此，代理可以在以下位置逐步发现功能 运行时，而不是猜测或燃烧令牌。

• CLI大修。 --json 用于脚本编写的输出、工作空间感知命令，

以及一个受htop启发的项目仪表板。

满的 更新日志 对于v0.18→ v0.20。

为什么选择基本记忆

大多数LLM对话都是短暂的。你问一个问题，得到一个答案，然后 一切都被遗忘了。解决方案有其局限性：

• 聊天记录 捕捉对话，但不是结构化知识。
• 检索增强生成 让LLM查询您的文档，但不回写。
• 矢量DB 需要复杂的基础设施，通常生活在别人的云中。
• 知识图 需要专门的工具进行维护。

基本内存采用更简单的路径： 人类使用的结构化Markdown文件 LLM既能读也能写。

• 所有知识都保存在你控制的普通文件中。
• 双方读写相同的文件。
• 熟悉Markdown的语义模式——无需学习新格式。
• LLM可以逐链接跟踪可遍历的图形。
• 与您已经使用的编辑器（黑曜石、VS Code、任何东西）配合使用。
• 只有文件和本地SQLite索引。不需要服务器。

运作原理

您正在正常谈论咖啡：

我一直在试验酿造方法。倒过来更清晰 与法国压榨机相比，205°F的水似乎最好，新鲜研磨的豆子 产生巨大的影响。

请LLM捕捉它：

“记下咖啡的冲泡方法。”

Markdown文件实时出现在您的项目目录中：

---
title: Coffee Brewing Methods
permalink: coffee-brewing-methods
tags: [coffee, brewing]
---

# Coffee Brewing Methods

## Observations
- [method] Pour over highlights subtle flavors over body
- [technique] Water at 205°F (96°C) extracts optimal compounds
- [principle] Freshly ground beans preserve aromatics

## Relations
- relates_to [[Coffee Bean Origins]]
- requires [[Proper Grinding Technique]]
- affects [[Flavor Extraction]]

下一个会话，LLM将接管该线程。它遵循以下关系 介绍一下你对埃塞俄比亚豆类和毛刺研磨机的了解，以及 以此为基础，而不是从头开始。你在黑曜石或 你的编辑。手动编辑它们——人工智能也能看到你的变化。

真正的双向流：人类编辑Markdown，LLM通过MCP读/写，同步 保持一切一致，真相的来源始终是你的文件。

Markdown格式

每个文件都是一个 Entity.实体有 Observations （关于他们的事实）和 Relations （链接到其他实体）。这就是全部语法。

前言

---
title: 
type: note
permalink: 
tags: [optional, list]
---

观察

关于实体的事实。分类在 [brackets]，标签为 #，可选 父母的背景。

- [method] Pour over highlights subtle flavors
- [tip] Grind medium-fine for V60 #brewing
- [fact] Lighter roasts contain more caffeine than dark
- [resource] James Hoffmann's V60 technique on YouTube
- [question] How does temperature affect compound extraction?

关系

形成图形的Wiki风格链接。单令牌关系类型或引用 多单词。

- pairs_well_with [[Chocolate Desserts]]
- grown_in [[Ethiopia]]
- requires [[Burr Grinder]]
- "pairs well with" [[Dark Chocolate]]

裸露的 - [[Target]] 散文 - Worth checking out [[Target]] 索引为 links_to.完整参考 文档.

MCP工具

Basic Memory将这些工具暴露给任何MCP客户端。每个工具都有注释 使用MCP行为提示（只读、破坏性、幂等、开放世界） 代理商可以选择正确的一个，而无需反复试验：

• 内容： write_note, read_note, edit_note, move_note,

delete_note, read_content, view_note

• 搜索与发现： search, search_notes, recent_activity,

list_directory

• 知识图谱： build_context （导航 memory:// URL），

canvas （黑曜石画布一代）

• 项目： list_memory_projects, create_memory_project,

get_current_project, sync_status

• 架构： schema_infer, schema_validate, schema_diff
• 云： cloud_info, release_notes

所有MCP工具默认为文本输出；通过 output_format="json" 为了 结构化响应。完整的工具参考 文档.

CLI要点

# Projects
basic-memory project list
basic-memory project add research ~/research
basic-memory project set-cloud research   # route through cloud
basic-memory project set-local research   # revert

# Health & maintenance
basic-memory status
basic-memory doctor              # file  DB consistency check
basic-memory tool edit-note ...  # CLI access to MCP tools
basic-memory update              # check for and install updates

# Imports
basic-memory import claude conversations
basic-memory import chatgpt
basic-memory import memory-json

路由标志(--local / --cloud)当你处于混合状态时，强行瞄准目标 模式。完整的CLI参考 文档.

自动更新

CLI安装默认情况下每24小时检查一次更新并应用更新 静默（因此MCP服务器保持响应）。

• 支持的安装源： uv tool，自制
• 跳过了 uvx （由uv管理的临时运行时）
• 手册： bm update （勾选+申请）或 bm update --check （仅检查）

禁用 ~/.basic-memory/config.json:

{ "auto_update": false }

遥测

了解CLI到云转换漏斗的最小匿名事件。

我们收集的内容： 云促销展示、云登录尝试和 结果，促销选择退出事件。

我们不做的： 文件内容、笔记标题、知识库数据、个人身份信息、IP 每个命令或每个工具跟踪。

活动转到我们的 Umami云 实例（开源， 以隐私为中心）放在后台线程上——永远不会阻止CLI。

选择退出：

export BASIC_MEMORY_NO_PROMOS=1

这将禁用提示和所有遥测。

日志记录

基本内存使用 日志记录器默认值各不相同 按入口点：

日志文件： ~/.basic-memory/basic-memory.log （10MB轮换，10天 保留）。

环境变量

BASIC_MEMORY_LOG_LEVEL=DEBUG basic-memory sync
tail -f ~/.basic-memory/basic-memory.log

发展

基本内存支持SQLite（默认、快速、无Docker）和Postgres （通过测试容器——需要Docker）。

just install          # Install with dev dependencies
just test-sqlite      # All tests, SQLite
just test-postgres    # All tests, Postgres (testcontainers)
just test             # Both backends
just fast-check       # fix/format/typecheck + impacted tests + smoke
just doctor           # File  DB consistency check (temp config)
just lint
just typecheck        # Pyright (primary)
just typecheck-ty     # ty (supplemental)
just format
just check            # All quality checks
just migration "msg"  # New Alembic migration

测试使用pytest标记： windows, benchmark, smoke。参见 justfile 查看完整列表。

欢迎捐款--见 贡献.md.

许可证

AGPL-3.0.

明星历史

建于♥️ 通过 基本机器