heropen

ローカルAI記憶システム。記憶はあなた自身のマシンに保存され、アップロードも同期も収集もされません。自動で整理・刈り込みを行い、使うほど精度が向上します。

名前の由来

名前は二つの由来から来ています：her は Hermes（あなたが現在対話しているこのエージェント）から、open は OpenClaw（オープン）から取られています。her + open を合わせると heropen になります。

分解して見ると、heropen は hero で始まります——マーベルのスーパーヒーローのイメージを呼び起こします。これは記憶層です：あなたを記憶し、あなたのエージェントに代わって物事を記録します。

Related MCP server: NeuralVaultCore

インストール

pip install heropen

エージェントを再起動すれば完了です。

初回起動時に自動でエージェント（Claude Code、Cursor、Windsurf、または任意のMCPクライアント）を検出し、データベースを作成して記憶ツールを登録します。あなたのエージェントはこの新しいインストールに気づき、セットアップを案内します。

30秒クイックスタート

# 存一条记忆
heropen add "项目使用 FastAPI + SQLAlchemy，测试用 pytest"

# 搜索记忆
heropen search "项目技术栈"

# 查看状态
heropen status

# 诊断问题
heropen diagnose

エージェントへの接続（MCP）

MCPをサポートする任意のエージェントと互換性があります。v1.8+ では自動検出・設定が行われ、手動の手順は不要です。

エージェント設定に手動で追加することも可能です：

{
  "mcpServers": {
    "heropen": {
      "command": "heropen",
      "args": ["mcp"]
    }
  }
}

エージェントを再起動すると、記憶を持つようになります。バグ修正を一度保存すれば、セッションを超えて永続的に記憶されます。

プライバシーへの約束

データはあなたのローカルに留まります。テレメトリなし。ハートビートpingなし。 すべての記憶はローカルのSQLiteデータベースに保存されます。ベクトル検索はデフォルトでローカル埋め込みモデル（fastembed、pip install heropen[embedding] を実行するだけ）を使用します——完全にオフラインで、コストゼロです。また、EMBEDDING_ENDPOINT と EMBEDDING_API_KEY 環境変数を自己ホストの埋め込みエンドポイント（OpenAI互換の /v1/embeddings）に向けることもできます。これにより、第三者クラウドに支払うことは決してありません。記憶テキストはベクトル生成にのみ使用され、決して報告されません。

ローカル埋め込みモデルと自己ホストエンドポイントの両方が設定されていない場合、検索は自動的に高速全文（FTS）マッチングにフォールバックします——依然として完全にオフラインで、コストゼロです。したがって、pip install heropen はゼロ設定で直接使用できます。埋め込みは検索品質を向上させるだけで、基本使用を妨げることは決してありません。

ローカル機能はオンライン化されません（現在）：現在のバージョンのローカル記憶の読み書き、検索、パネル機能は、ネットワーク必須のクラウドサービスに移行されることはありません。無料層で提供されている機能は、将来のバージョンで削減されることはありません。オプションのネットワーク高速化項目（例：自己ホストの埋め込みエンドポイント）はこの約束の範囲外です——これらはデフォルトでオフであり、有効にするかどうかは完全にあなた次第です。

なぜローカルなのか

記憶がクラウドのプリミティブにされると、あなたの会話履歴や作業コンテキストは他人のサーバーに保存されます。heropen の選択は逆です：記憶は ~/.heropen/ に書き込まれ、エージェントごとに1つのSQLiteファイルとして、データは物理的にローカルマシンから出ません。

heropen は記憶内容をアップロードせず、クラウド同期もせず、使用データを収集しません。現在のバージョンのコア機能は外部接続がなく、ネットワーク必須のクラウドサービスにはなりません。クラウドが与えるのは便利さ。ローカルが与えるのは、あなただけが持ち出せるもの。

記憶はあなたのもの

記憶はローカルの ~/.heropen/ ディレクトリに保存され、エージェントごとに1つのSQLiteファイルがあります。いつでも：

• バックアップ / エクスポート：heropen export で全記憶をローカルJSONにエクスポート（heropen import で再インポート可能）；

• 削除 / クリア：heropen delete <id> で1件削除、rm ~/.heropen/*.db でライブラリ全体をクリア——私たちを経由する必要も、ネットワーク接続も不要です。

より使いやすい Markdown + YAML エクスポート（人間が読める、ロスレス往復、再インポート可能）はロードマップに計画されています。目標は「読みやすく、持ち出せて、戻れる」ことであり、「誰かと相互運用する」ことではありません。

コンプライアンス声明

heropen はローカルファーストの記憶・コンテキストツールであり、あなたのデータは常にローカルに保存され、完全にあなたが管理します。当社は《人工智能拟人化互动服务管理暂行办法》の関連要件に従い、ローカルファーストのアーキテクチャはユーザーデータの制御権と透明性に関する条項を自然に満たし、実行プロセスはあなたに対して透明で制御可能です。

オープンソース範囲

無料版は完全にオープンソース（Apache-2.0）。商用層（Plus / エンタープライズ版）はクローズドソースです。

なぜ heropen を選ぶのか

無料 = 完全なコア機能、機能削減なし。

heropen の差別化ポイント

ローカルファーストは heropen だけの売りではありません——すでに十数個の類似プロジェクトが SQLite + MCP を採用しています。heropen が本当に占めていて、他がまだ占めていない位置は次の3つです：

• マルチエージェントのプライベートドメイン / 共有ドメインの階層化。無料層では2つの完全にプライベートなエージェント（Hermes / WorkBuddy のような高頻度常駐エージェントがそれぞれ分離されたライブラリを持つ）に加え、オプションの共有ドメイン（_shared）でエージェント間の知識交換が可能です。ほとんどの競合製品はフラットな単一ネームスペースのみです。

• 対話前の時間認識（v1.8.7 以降）。エージェントは毎回の開始時にローカル時間、時間帯語、前回の対話からの間隔、睡眠サイクルをまたいだかどうかを自動的に取得します——インタラクション側の時間基準は、現在誰も実装していません。

• ゼロ依存のインストール面。pip install heropen の一行で済み、Docker、Postgres、Ollama は不要です。同類で「前提依存なしで実行できる」ものはほとんどありません。

選定方法

記憶ソリューションを選ぶ際、再現率だけでなく、5つのことを見てください：

1. 導入ハードル：pip install の一行で実行できるか、それとも Docker / Postgres / Ollama / APIキーが必要か？

2. 依存関係とコスト：書き込みパスがLLMトークンを消費するか？外部依存がゼロか？

3. 移植性：記憶を読み取り可能なファイルにエクスポートし、持ち出して、再インポートできるか？

4. セキュリティのデフォルト：リッスンポートはデフォルトで loopback にバインドされるか、それとも 0.0.0.0 か？テレメトリがゼロか？

5. エンジニアリング税：書き込み規律と無効化メカニズムは明確か？Prompt Cache と競合しないか？クロスモデルの容量上限はどう処理されるか？埋め込み移行にデータ税はあるか？

heropen doctor を実行すると、上記5項目がそれぞれ「合格 / 注意 / 警告」の3状態で自己チェックされます。

リンク

• 公式サイト：heropen.net

• ドキュメント：heropen.net/heropen/docs

• GitHub：github.com/Koradji77/heropen

ロードマップ

• 現在はデスクトップローカル使用に焦点。モバイル / クロスデバイス同期は現在の範囲外です——「データがローカルから出ない」というデフォルトの約束と矛盾するため、「表明」のために中途半端なものは作りません。将来行う場合も、必ずユーザー所有ストレージ + エンドツーエンド暗号化 + デフォルトオフの形式になります。

• Markdown + YAML 記憶エクスポート（ロスレス往復）。

• より多くのエージェントのプライベート / 共有ドメインの製品化能力。

ライセンス

Apache-2.0