heropen 1.3.0__tar.gz

heropen-1.3.0/PKG-INFO

@@ -0,0 +1,62 @@
+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>

heropen-1.3.0/README.md

@@ -0,0 +1,38 @@
+# 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>

heropen-1.3.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "heropen"
+version = "1.3.0"
+description = "HeroPen — AI Agent Long-term Memory System"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "KSMN Studio", email = "hello@ksmn.cc"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "requests>=2.28",
+]
+
+[project.optional-dependencies]
+embedding = [
+    "fastembed>=0.6",
+]
+ui = [
+    "rich>=13.0",
+]
+all = [
+    "heropen[embedding]",
+    "heropen[ui]",
+    "mcp>=1.6",
+]
+
+[project.scripts]
+heropen = "heropen.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/heropen"]
+
+[project.urls]
+Homepage = "https://ksmn.cc/heropen"
+Documentation = "https://ksmn.cc/heropen/docs"
+Repository = "https://github.com/koradji88/heropen"

heropen-1.3.0/src/heropen/__init__.py

@@ -0,0 +1,41 @@
+"""
+heropen — Persistent memory for AI agents.
+
+Self-hosted, MCP-native memory system with vector + FTS + LIKE search,
+automatic backup, crash recovery, and multi-agent isolation.
+"""
+
+__version__ = "1.2.1"
+__all__ = [
+    "add_entry", "update_entry",
+    "search_vector", "search_fts", "search_graph",
+    "search_by_date", "search_by_tag", "search_recent",
+    "search_with_date_filter",
+    "auto_backup", "integrity_check", "startup_self_heal",
+    "init_db", "conn", "db_path",
+    "get_embedding", "cosine_similarity",
+    "capture_session_content",
+    "AGENTS",
+]
+
+from heropen.core import (
+    add_entry,
+    update_entry,
+    search_vector,
+    search_fts,
+    search_graph,
+    search_by_date,
+    search_by_tag,
+    search_recent,
+    search_with_date_filter,
+    auto_backup,
+    integrity_check,
+    startup_self_heal,
+    init_db,
+    conn,
+    db_path,
+    get_embedding,
+    cosine_similarity,
+    capture_session_content,
+    AGENTS,
+)

heropen-1.3.0/src/heropen/cli.py

@@ -0,0 +1,147 @@
+"""
+heropen.cli — Command-line interface for HeroPen.
+
+Usage:
+    heropen --help
+    heropen install      # new in v1.2.0
+    heropen init ...
+    heropen recall ...
+    heropen add ...
+    heropen bootstrap ...
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+from heropen.core import HERO_PEN_DIR
+
+
+def main():
+    args = sys.argv[1:]
+    if not args:
+        print_help()
+        return
+
+    cmd = args[0].lower()
+
+    # ── Install wizard (v1.2.0) ────────────────────────
+    if cmd in ("install", "setup"):
+        # Lazy import to avoid loading rich unless needed
+        from heropen.install import cmd_install
+        cmd_install(args[1:])
+        return
+
+    # ── Existing commands (all lazy-loaded) ─────────────
+    if cmd == "init":
+        from heropen.cli_commands import cmd_init
+        cmd_init(args[1:])
+    elif cmd == "recall":
+        from heropen.cli_commands import cmd_recall
+        cmd_recall(args[1:])
+    elif cmd == "add":
+        from heropen.cli_commands import cmd_add
+        cmd_add(args[1:])
+    elif cmd == "bootstrap":
+        from heropen.cli_commands import cmd_bootstrap
+        cmd_bootstrap(args[1:])
+    elif cmd == "health":
+        from heropen.cli_commands import cmd_status
+        cmd_status(args[1:])
+    elif cmd == "search":
+        from heropen.cli_commands import cmd_recall
+        cmd_recall(args[1:])
+    elif cmd == "list":
+        from heropen.cli_commands import cmd_status
+        cmd_status(args[1:])
+    elif cmd == "embed":
+        from heropen.cli_commands import cmd_embed
+        cmd_embed(args[1:])
+    elif cmd == "backup":
+        from heropen.cli_commands import cmd_export
+        cmd_export(args[1:])
+    elif cmd == "restore":
+        from heropen.cli_commands import cmd_import
+        cmd_import(args[1:])
+    elif cmd == "mcp":
+        from heropen.mcp_server import main as mcp_main
+        mcp_main()
+    elif cmd in ("--help", "-h", "help"):
+        print_help()
+    elif cmd in ("--version", "-V", "version"):
+        from heropen.core import __version__
+        print(f"heropen {__version__}")
+    elif cmd == "status":
+        from heropen.cli_commands import cmd_status
+        cmd_status(args[1:])
+    elif cmd in ("entities",):
+        from heropen.cli_commands import cmd_entities
+        cmd_entities(args[1:])
+    elif cmd in ("capture",):
+        from heropen.cli_commands import cmd_capture
+        cmd_capture(args[1:])
+    elif cmd in ("sync",):
+        from heropen.cli_commands import cmd_sync
+        cmd_sync(args[1:])
+    elif cmd in ("init-all",):
+        from heropen.cli_commands import cmd_init_all
+        cmd_init_all(args[1:])
+    elif cmd in ("export",):
+        from heropen.cli_commands import cmd_export
+        cmd_export(args[1:])
+    elif cmd in ("import",):
+        from heropen.cli_commands import cmd_import
+        cmd_import(args[1:])
+    elif cmd in ("delete",):
+        from heropen.cli_commands import cmd_delete
+        cmd_delete(args[1:])
+    elif cmd in ("session",):
+        from heropen.cli_commands import cmd_session
+        cmd_session(args[1:])
+    else:
+        print(f"heropen: unknown command '{cmd}'")
+        print_help()
+        sys.exit(1)
+
+
+def print_help():
+    help_text = f"""
+HeroPen v1.2.0 — AI Agent Long-term Memory System
+
+Usage:
+    heropen <command> [options]
+
+Commands:
+    install         Interactive install wizard (NEW in v1.2.0)
+    init            Initialize agent memory database
+    add             Add a new memory entry
+    recall          Search and recall memories
+    search          Search memories (alias for recall)
+    list            List memory stats (alias for status)
+    status          Database statistics
+    entities        View knowledge graph
+    bootstrap       Agent memory startup summary
+    capture         Auto-capture key sentences from stdin
+    sync            Sync from diary.md to database
+    embed           Generate embeddings for existing entries
+    backup          Export memories to JSON
+    restore         Import memories from JSON backup
+    delete          Delete a memory entry
+    health          Check system health (alias for status)
+    session         Save or recover session checkpoint
+    mcp             Start MCP server
+    help            Show this help message
+    version         Show version
+
+Options:
+    -h, --help     Show this help message
+    -V, --version  Show version
+
+Data directory: {HERO_PEN_DIR}
+"""
+    print(help_text.strip())
+
+
+if __name__ == "__main__":
+    main()