Metadata-Version: 2.4
Name: heropen
Version: 1.3.0
Summary: HeroPen — AI Agent Long-term Memory System
Project-URL: Homepage, https://ksmn.cc/heropen
Project-URL: Documentation, https://ksmn.cc/heropen/docs
Project-URL: Repository, https://github.com/koradji88/heropen
Author-email: KSMN Studio <hello@ksmn.cc>
License: MIT
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: requests>=2.28
Provides-Extra: all
Requires-Dist: fastembed>=0.6; extra == 'all'
Requires-Dist: mcp>=1.6; extra == 'all'
Requires-Dist: rich>=13.0; extra == 'all'
Provides-Extra: embedding
Requires-Dist: fastembed>=0.6; extra == 'embedding'
Provides-Extra: ui
Requires-Dist: rich>=13.0; extra == 'ui'
Description-Content-Type: text/markdown

# heropen

Persistent memory for AI agents — self-hosted, MCP-native.

## 安装

```bash
# 仅用 CLI（不需要 MCP server）
pip install heropen

# 需要 MCP server 支持
pip install heropen[all]

# 需要本地 embedding（fastembed）
pip install heropen[embedding]
```

`heropen[all]` 包含 `heropen[embedding]` + `mcp>=1.6`，安装这个就够了。

## 使用

```bash
# 初始化
heropen init

# 导入已有记忆（JSON 行格式）
heropen bootstrap --agent xiaokai < memory.jsonl

# 搜索记忆
heropen search "关键词"

# 启动 MCP server
heropen-mcp
```

## 项目地址

<https://ksmn.cc/heropen>
