MemMachine

面向 AI Agent 的开源记忆层。

告别无状态的 Agent。仅需 5 行代码，即可让你的 AI 拥有持久化记忆。

什么是 MemMachine？

MemMachine 是一个为 AI Agent 和基于 LLM 的应用提供的开源长期记忆层。它使你的 AI 能够学习、存储并回溯过去会话中的信息，将无状态的聊天机器人转变为具有个性化和上下文感知能力的助手。

核心能力

• 情景记忆 (Episodic Memory)：基于图（Graph）的对话上下文，可在不同会话间持久保留。
• 用户画像记忆 (Profile Memory)：存储在 SQL 中的长期用户事实和偏好。
• 工作记忆 (Working Memory)：用于当前会话的短期上下文。
• Agent 记忆持久化：记忆可跨越重启、会话甚至模型变更而保留。

快速开始

5 分钟内即可上手：

前置要求： 本代码需要运行中的 MemMachine Server。 在本地启动服务器 或在 MemMachine 平台 创建免费账户。

pip install memmachine-client

from memmachine_client import import MemMachineClient

# 初始化客户端
client = MemMachineClient(base_url="http://localhost:8080")

# 获取或创建一个项目
project = client.get_or_create_project(org_id="my_org", project_id="my_project")

# 为用户会话创建一个记忆实例
memory = project.memory(
    group_id="default",
    agent_id="travel_agent",
    user_id="alice",
    session_id="session_001"
)

# 添加一条记忆
memory.add("I prefer aisle seats on flights", metadata={"category": "travel"})
# => [AddMemoryResult(uid='...')]

# 搜索记忆
results = memory.search("What are my flight preferences?")
print(results.content.episodic_memory.long_term_memory.episodes[0].content)
# => "I prefer aisle seats on flights"

欲了解完整的安装选项（Docker、自托管、云端服务），请访问 快速开始指南。

集成

MemMachine 可以与你喜爱的 AI 框架无缝协作：

框架	说明
LangChain	LangChain Agent 的记忆提供程序
LangGraph	LangGraph 工作流的有状态记忆
CrewAI	CrewAI 多 Agent 系统的持久化记忆
LlamaIndex	LlamaIndex 应用的记忆集成
AWS Strands	AWS Strands Agent SDK 的记忆支持
n8n	无代码工作流自动化集成
Dify	Dify AI 应用的记忆后端
FastGPT	与 FastGPT 平台的集成

MCP Server 支持

MemMachine 包含一个原生的 Model Context Protocol (MCP) 服务器，可与 Claude Desktop、Cursor 以及其他兼容 MCP 的客户端无缝集成：

# Stdio 模式 (用于 Claude Desktop)
memmachine-mcp-stdio

# HTTP 模式 (用于 Web 客户端)
memmachine-mcp-http

详细设置说明请参阅 MCP 文档。

MemMachine 适合谁？

• 开发者：正在构建 AI Agent、助手或自主工作流。
• 研究人员：正在进行 Agent 架构和认知模型实验。
• 团队：需要为 LLM 应用提供跨会话持久化记忆。

关键特性

• 多种记忆类型：工作记忆（短期）、情景记忆（长期对话）和用户画像（用户事实）。
• 开发者友好的 API：Python SDK、RESTful API、TypeScript SDK 和 MCP 服务器接口。
• 灵活的存储：图数据库（Neo4j）用于存储情景记忆，SQL 用于存储用户画像。
• LLM 无关性：适用于 OpenAI、Anthropic、Bedrock、Ollama 及任何 LLM 提供商。
• 自托管或云端：支持本地运行、Docker 部署或使用我们的托管服务。

更多详细信息，请参考 API 参考文档。