heropen
让 AI Agent 拥有长期记忆。数据不出本机，搜索不用 token。
为什么叫 heropen
名字来自两个地方：her 取自 Hermes（你阅读这里用的 Agent），pen 取自 Open（OpenClaw，开放）。合起来就是 heropen。
hero 也撞上了漫威的超级英雄——一个记住你、替你写下的伙伴。
安装
pip install heropen
重启你的 Agent。仅此而已。
首次启动自动检测 Agent（Claude Code, Cursor, Windsurf 或任何 MCP 客户端），配置数据库并注册记忆工具。你的 Agent 会注意到新安装并引导你完成设置。
30 秒开箱
# 保存一条记忆
heropen add "项目使用 FastAPI + SQLAlchemy，测试用 pytest"
# 搜索记忆
heropen search "项目技术栈"
# 查看状态
heropen status
# 诊断问题
heropen diagnose
连接你的 Agent（MCP）
支持任何兼容 MCP 的 Agent。v1.8+ 自动检测并配置——无需手动操作。
或者手动加到你的 Agent 配置：
{
"mcpServers": {
"heropen": {
"command": "heropen",
"args": ["mcp"]
}
}
}
重启 Agent，它就有记忆了。遇到 bug 存一次，跨会话永久记住。
隐私承诺
数据不出本机。无遥测。无心跳上报。 所有记忆存储在本地 SQLite 数据库中。向量检索默认调用 SiliconFlow embedding API（使用你的密钥），记忆文本仅用于生成向量，不上报。也支持纯本地 embedding（fastembed 可选依赖，pip install heropen[embedding]）。
开源范围
免费版全量开源（Apache-2.0），商业层（Plus/Enterprise）闭源。
为什么选 heropen
| heropen（免费） | 其他方案 | |
|---|---|---|
| 存储空间 | 无限制 | 通常有上限 |
| 搜索次数 | 无限制 | 按次计费 |
| 需要联网 | 否 | 是 |
| 数据归属 | 你的机器 | 他们的服务器 |
| 安装 | pip install 一条命令 |
服务器 + 配置 |
免费 = 完整核心功能。没有功能阉割。
链接
- 主页: ksmn.cc/heropen
- 文档: ksmn.cc/heropen/docs
- GitHub: github.com/Koradji77/heropen
License
Apache-2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file heropen-1.8.5.tar.gz.
File metadata
- Download URL: heropen-1.8.5.tar.gz
- Upload date:
- Size: 202.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
25505af93dd91f5cd9d7c4741f01983fa6a2cf86e524d9e5c2dd2b1bbfd5e12c
|
|
| MD5 |
cdaafb10abf658f5fb02c00aecf9e67e
|
|
| BLAKE2b-256 |
5982cc3d15e7c6ad9e0a12680c6ac289f82947bf61688273b85e85ade5705fc3
|
File details
Details for the file heropen-1.8.5-py3-none-any.whl.
File metadata
- Download URL: heropen-1.8.5-py3-none-any.whl
- Upload date:
- Size: 75.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bf0f85124304b32aa175214047854c9b23bfa91ded0ffb36e19b10024a85e6ef
|
|
| MD5 |
cf46eb1250d3dbeaac426ae981a99f07
|
|
| BLAKE2b-256 |
c745c39a0b9f75315e8596cd4fddf238290a959496ed07ae9f7b5bd7cd7f3ed0
|
