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 一行 搭服务、配环境

免费版就是全部核心，不阉割。

支持

协议

MIT License

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.9.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for KSMNStudio from gravatar.com KSMNStudio

Credits

Author: KSMN Studio

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

all embedding ui

Classifiers

Report project as malware

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.7.32.tar.gz (195.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

heropen-1.7.32-py3-none-any.whl (69.1 kB view details)

Uploaded Python 3

File details

Details for the file heropen-1.7.32.tar.gz.

File metadata

  • Download URL: heropen-1.7.32.tar.gz
  • Upload date:
  • Size: 195.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for heropen-1.7.32.tar.gz
Algorithm Hash digest
SHA256 5b1b08d0244443490f2d141d3c8f9f25abc8677e7385cfc2e29fe4c53310dfcd
MD5 1ad3fc5f87b9f81118b8a90472bca8d0
BLAKE2b-256 c47000bdcea53d238c1021e2143c6a99d444001cb86ac5fc49b7ad026e7a519e

See more details on using hashes here.

File details

Details for the file heropen-1.7.32-py3-none-any.whl.

File metadata

  • Download URL: heropen-1.7.32-py3-none-any.whl
  • Upload date:
  • Size: 69.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for heropen-1.7.32-py3-none-any.whl
Algorithm Hash digest
SHA256 83a13e0b8a3864e9e399fe1a3d53d5519dca2ec9723af933071d9e9dfb0e753d
MD5 10f22f98a7dc769ae5f6ae3bf43b2816
BLAKE2b-256 e7f6f1cee85bbece7f29e8932f3d94aa396a1cf3f3b1681c8b136e980a551450

See more details on using hashes here.

Release history Release notifications | RSS feed

1.9.1

2 files

1.9.0

2 files

1.8.9

2 files

1.8.8

2 files

1.8.7

2 files

1.8.6

2 files

1.8.5

2 files

1.8.4

2 files

1.8.3

2 files

1.8.2

2 files

1.8.1

2 files

1.8.0

2 files

This release

1.7.32 This release

2 files

1.7.31

2 files

1.7.30

2 files

1.7.29

2 files

1.7.28

2 files

1.7.27

2 files

1.7.26

2 files

1.7.25

2 files

1.7.24

2 files

1.7.23

2 files

1.7.22

2 files

1.7.21

1 file

1.7.20

1 file

1.7.19

1 file

1.7.18

1 file

1.7.17

1 file

1.7.16

1 file

1.7.15

1 file

1.7.14

1 file

1.7.13

1 file

1.7.12

1 file

1.7.11

1 file

1.7.10

1 file

1.7.9

1 file

1.7.8

1 file

1.7.7

1 file

1.7.6

1 file

1.7.5

1 file

1.7.4

1 file

1.7.3

1 file

1.7.2

2 files

1.7.1

2 files

1.7.0

2 files

1.6.3

1 file

1.6.2

1 file

1.6.1

1 file

1.6.0

1 file

1.5.4

1 file

1.5.3

2 files

1.5.2

2 files

1.5.1

2 files

1.5.0

2 files

1.4.9

2 files

1.4.8

2 files

1.4.7

2 files

1.4.6

2 files

1.4.5

2 files

1.4.4

2 files

1.4.3

1 file

1.4.2

1 file

1.4.1

1 file

1.4.0

1 file

1.3.1

2 files

1.3.0

2 files

1.2.0

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page