Tencent-Hunyuan/Hy-Memory

这是什么？

核心功能

• 01提供聊天、办公、编程三种场景，各自拥有独立的记忆流程与存储。
• 02支持 lite、pro、ultra 三种模式，从不调用 LLM 的向量存储到完整的 schema 归纳。
• 03向量存储可选 ChromaDB、Qdrant、FAISS，图存储可选 Kuzu 或 Neo4j。
• 04编程场景保存代码修改的 diff 链，包括已被回滚的版本。
• 05兼容任意 OpenAI 接口的大模型与向量模型服务。
• 06MemHub 桌面应用与命令行工具可在授权的 AI 编程工具之间共享记忆。

适用场景

• 为聊天助手或面向用户的智能体增加持久化的个人记忆。
• 让编程智能体回忆同一仓库与分支中早前的修复和被回滚的代码改动。
• 将多个 AI 工具的对话与编程记录统一存放在本地。
• 以零 LLM 调用成本的 lite 模式搭建或测试智能体记忆原型。

快速上手

1. 1

   从 PyPI 安装核心 hy-memory 包

   pip install hy-memory==2.0.4
2. 2

   设置 OpenAI API 密钥（或配置兼容 OpenAI 的 LLM 与嵌入端点）

   export OPENAI_API_KEY="sk-your-key"
3. 3

   在 pro 模式下创建 HyMemoryClient，并按 README 的 Python 示例写入和检索聊天记忆

使用前须知

• !pro 和 ultra 模式需要来自兼容 OpenAI 服务的 LLM 与嵌入 API 密钥。
• !ultra 模式始终使用图数据库，会增加部署配置成本。

收录于专题

标签

常见问题

Hy-Memory 是什么？

面向 LLM 智能体的双系统长期记忆 Python SDK，并提供 MemHub 桌面与命令行工具，覆盖聊天、办公与编程场景。 Hy Memory 是一个 Python SDK（包名 hy-memory），为 LLM 智能体提供持久化记忆，采用双系统认知架构设计。记忆按场景分为三类：面向聊天的分层长期记忆；面向办公任务、由会话事实与可复用经验组成的两层记忆；以及面向软件工程、在两层记忆之上附加代码版本演化链的编程记忆。写入支持纯文本或 OpenAI 格式的消息，检索结果按通道分组返回。

Hy-Memory 可以免费使用吗？用的什么许可证？

Hy-Memory 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

Hy-Memory 还在维护吗？

活跃维护中。Hy-Memory 最近一次提交是在 2026年11月6日。

Hy-Memory 适合用来做什么？

为聊天助手或面向用户的智能体增加持久化的个人记忆。 让编程智能体回忆同一仓库与分支中早前的修复和被回滚的代码改动。 将多个 AI 工具的对话与编程记录统一存放在本地。 以零 LLM 调用成本的 lite 模式搭建或测试智能体记忆原型。

Hy-Memory 怎么安装和运行？

从 PyPI 安装核心 hy-memory 包: pip install hy-memory==2.0.4 设置 OpenAI API 密钥（或配置兼容 OpenAI 的 LLM 与嵌入端点）: export OPENAI_API_KEY="sk-your-key" 在 pro 模式下创建 HyMemoryClient，并按 README 的 Python 示例写入和检索聊天记忆

在哪里获取 Hy-Memory？

源代码和安装说明在 GitHub 上：https://github.com/Tencent-Hunyuan/Hy-Memory