内容
海洛彭 给你的 AI 代理长久的记忆。数据保留在你的机器上；搜索成本为零代币。
## 为什么是“海洛彭”
两个地方：**her** 来自赫尔墨斯（你这篇文章的代理），**open自 OpenClaw（开放her + open 组合在一起就是。
书面形式上，海洛彭以 **hero** 开头 —— 唤起了漫威超级英雄的典故。它是一个记忆层，记住你并为你的代理记录事情。
## 安装bash
pip install heropen
```
重启你的代理。就这样。
启动时，它会自动检测你的代理（Claude Code、Cursor、W 或任何 MCP 客户端），设置数据库，并注册记忆工具。你的代理会注意到新的安装并引导你完成设置。
## 30 秒快速入门
```bash
# 保存记忆
heropen add "项目使用 FastAPI +，测试使用 pytest"
# 搜索记忆
heropen search "项目"
# 检查状态
her
# 诊断问题
heropen diagnose
```
## 连接你的代理（MCP）
与任何 MCP 兼容的代理一起工作。v8+ 自动检测和配置 — 无步骤。
或者，在你的中手动添加：
```json "mcpServers": "heropen": {
": "heropen",
"args": ["mcp"]
}
}
```
重启你的代理，它记忆。存储一次 bug 修复，永久记住跨会话。
## 隐私承诺
**数据保留在上。无遥测。无心。** 所有记忆都存储在本地 SQLite 数据库中。向量搜索默认使用**本地嵌入模型**（fastembed，`pip install heropen[embedding]`）— 完全离线，零成本。可选地，你可以将其指向**你自己的自托管嵌入端点**，通过设置 `EMBEDDING_ENDPOINT` 和 `EMBEDDING_API_KEY` 环境变量（OpenAI 兼容的 `/v1/embeddings`），因此永远不会有第三方云计费。记忆文本仅用于生成向量，永远不会被报告。
如果既没有配置本地嵌入模型，也没有自托管端点，搜索级为快速全文（FTS）匹配 — 仍然完全离线且零成本。因此，`pip install heropen` 可以**零设置嵌入仅*升级*搜索质量，从不限制基本使用。
## 开源范围
免费版本是完全开源的（Apache-2.0）。商业层（Plus / Enterprise）是闭源的。
## 为什么选择海洛彭
| | 海洛彭（免费） | 其他解决方案 |
|---|---|---|
| 存储 | 无限制 | 通常有限 |
| 搜索 | 无限制 | 按查询付费 |
| 需要 否 | 是 |
| 数据所有权 | 你的机器 | 他们的服务器 |
| 安装 | 一个 `pip install` | 服务器 + 配置 |
免费 = 完整核心功能。无残缺功能。
## 链接
- 首页：[heropen.net](https://)
- 文档：[heropen.net/heropen/docs](https://heropen.net/heropen/docs)
- GitHub：[github.com/Koradji77/heropen](https://github.com/Koradji77/heropen)
## 许可证
Apache-2.0
