HeroPen — AI Agent Long-term Memory System
Project description
heropen
给本地大模型 Agent 装上长期记忆。一次
pip install,不用每次从头教。
你的 agent 每次开新会话都要重新交代一遍——项目怎么组织的、习惯用什么工具、之前踩过的坑、写好的配置和 skill。heropen 就是解决这个的:装完以后,agent 自己记得住。
数据 100% 在你自己的机器上,SQLite + 向量搜索,不联网、不上云。
安装
pip install heropen
heropen auto-setup
两行搞定。会装好数据库、自动检测你的 agent(Claude Code / Cursor / Windsurf 等),配好 MCP。
装完重启 agent,它就有记忆了。
如果你用 heropen install 可以走交互式向导手动选择。
快速开始
# 存一条记忆
heropen add "项目用 FastAPI + SQLAlchemy,测试走 pytest"
# 搜索之前记过的
heropen search "项目技术栈"
# 查看状态
heropen status
接入 Agent(MCP 协议)
主流 agent 工具都能接。heropen auto-setup 会自动检测并配置。
也可以手动配,在 agent 的配置里加上:
{
"mcpServers": {
"heropen": {
"command": "heropen",
"args": ["mcp"]
}
}
}
重启 agent,它就有记忆了。
接上 MCP 之后,agent 甚至可以自己在干活过程中自动存和查——遇到一个坑记下来,下次另一个会话里遇到同样问题,自己翻出来。
为什么是 heropen
| heropen 免费版 | 其他方案 | |
|---|---|---|
| 记忆条数 | 不限 | 通常有限制 |
| 搜索次数 | 不限 | 按量收费 |
| 联网 | 不需要 | 必须联网 |
| 数据在哪 | 你的机器 | 别人的服务器 |
| 安装 | pip install 一行 |
搭服务、配环境 |
免费版就是全部核心,不阉割。
支持
- 官网:ksmn.cc/heropen
- 文档:ksmn.cc/heropen/docs
- 问题反馈:GitHub Issues
协议
MIT License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
heropen-1.6.1.tar.gz
(46.3 kB
view details)
File details
Details for the file heropen-1.6.1.tar.gz.
File metadata
- Download URL: heropen-1.6.1.tar.gz
- Upload date:
- Size: 46.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f45b9f4a3dc943b878fbe4e29467c0508ec4531983690a006771574234ecc35d
|
|
| MD5 |
54d5af614abeb65dde1b62daa09d783f
|
|
| BLAKE2b-256 |
029ba23b0050b30a8160e809d7b316a2fe756fa2eca2e76a2b0660181debd055
|