heropen — AI Agent Memory

heropen

English · 简体中文

忘れることを解決するために作られました。使うほど、あなたのことをよく理解します。

AI エージェントのためのローカルファーストなメモリーシステムです。メモリーはご自身のマシン上に保存され、アップロードも同期もされず、失われることもありません。heropen がメモリーを自動で整理し、不要なものを削除するため、時間とともに検索結果がより的確になり、パーソナライズされていきます。

⭐ 役に立ちましたか？スターを付けてください → 右上の ★ Star をクリックして、より多くのエージェントユーザーに見つけてもらいましょう。

30 秒でわかること

• 1 行でインストール：pip install heropen。Docker、Postgres、API キーは不要です。一般的なクライアントでは MCP 設定が自動で書き込まれます。Hermes などでは heropen-mcp を手動で接続する必要があります。
• エージェントに長期記憶を追加：セッションをまたいで人物、出来事、コンテキストを記憶し、会話のたびにゼロから始める必要がなくなります。
• データは 100％ご自身のマシンに保存：テレメトリーもクラウド同期も請求もありません。メモリーはディスク上に保存され、削除できるのはご自身だけです。

インストール

pip install heropen                 # Core: MCP + full-text search, pure-Python deps, any architecture (incl. ARM64)
pip install 'heropen[embedding]'    # Optional: local embeddings (pulls in onnxruntime / fastembed)
pip install 'heropen[tray]'         # Optional: Windows system tray badge (always-visible presence + workbench)

ARM64 に関する注意事項

プラットフォーム	推奨事項
Apple Silicon（macOS arm64）	通常は pip install 'heropen[embedding]' だけで問題なく動作します
Windows ARM64	同様です。Python の ARM64 ビルドを使用してください
Linux aarch64	まずコアをインストールし、その後 embedding を試してください。対応する onnxruntime ホイールがない場合は、EMBEDDING_ENDPOINT をセルフホスト可能なエンドポイントに指定するか、FTS のみを使用してください

ローカル埋め込みがない場合、search / recall は適切にフォールバックして全文検索を使用します。メモリーの保存と取得は引き続き機能します。

エージェントを再起動すれば完了です。初回起動時に heropen は、一般的なクライアント（Claude Code、Cursor、Windsurf、WorkBuddy など）の既知の設定パスを調べ、メモリーツールを登録します。Hermes のようなカスタム mcp_servers 設定は自動で書き込まれません。下記の「エージェントを接続する」に従って手動で設定してください。

30 秒で始める

heropen add "Project uses FastAPI + SQLAlchemy, tests run on pytest"   # store a memory
heropen search "project tech stack"                                    # search memories
heropen status                                                         # check status
heropen diagnose                                                       # diagnose problems

実際に定着させる方法：公式の使用ガイド（唯一の信頼できる情報源）をお読みください — docs/usage-ssot-zh.md (中国語)。 要点：heropen に保存するのは事実のみです。ホットレイヤーには厳守すべきルール、使用頻度の高い項目、参照先を保持します。各セッションの開始時に prime、続いて search を実行します。自由形式のタグが主要な仕組みです。

最初の add では、約 95 MB の埋め込みモデルはダウンロードされません。書き込みは直接全文検索に登録されます。ローカルでのセマンティック検索を利用する場合は、明示的に実行してください。

pip install 'heropen[embedding]'
heropen embed          # download the model and generate embeddings for existing entries

エージェントを接続する（MCP）

専用の heropen-mcp エントリーポイント（stdio）を使用してください。heropen mcp も動作しますが、MCP クライアント設定では以下の形式を推奨します。

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

heropen-mcp が PATH 上にない場合（例：隔離された環境に uv tool install でインストールした場合）は、command をその環境内の絶対パスに置き換えてください。

Claude Code / Cursor / Windsurf / WorkBuddy の場合：heropen auto-setup を実行すると、既知の設定パスへの書き込みが試みられます。Hermes やその他のカスタム設定形式の場合は、上記のブロックを独自の mcp_servers に追加し、エージェントを再起動してください。

エージェントを再起動すれば、メモリーを利用できます。バグ修正を一度保存すれば、セッションをまたいで永続的に記憶されます。

トレイバッジ（Windows システムトレイ、heropen[tray]）

heropen[tray] をインストールしたら、heropen tray を実行すると、タスクバーのトレイ（WeChat／Bluetooth／IME と同じ領域）に heropen のネイティブアイコンが固定表示されます。ウィンドウのコンテンツを覆うことはありません。「存在感のないメモリシステムは、ジャンクウェアと誤解されてアンインストールされやすい」という問題を解決します。

pip install 'heropen[tray]'   # Windows only
heropen tray                  # start the badge (auto-starts on boot by default)

右クリックメニュー：

項目	動作
ステータス行	実行中 · Free / Plus · エージェント N 件 · メモリ N 件
バージョン vX.Y.Z	変更履歴を開きます
ストレージモード（エージェントごと）	各エージェントがバルク保存／ターンごとに保存／自動検出を個別に選択します
ワークベンチを開く	アイコンを左クリックしても同じ動作です — ライブデータのワークベンチページを開きます
ホームページを開く	heropen.net を開きます
更新を確認	pip install -U heropen
起動時に開始	切り替え（デフォルトでオン。レジストリの Run キーに書き込みます）
再起動／終了	最新のコードを読み込むために再起動／完全に終了します

アイコンにカーソルを合わせると、ひと目でわかる 4 つのステータスが表示されます。識別情報（heropen エージェントメモリシステム）、ストレージモード、保存済みエントリ数、利用日数です。

実データであり、捏造ではありません：バッジとワークベンチは、ローカルの ~/.heropen/*.db にある実際の entries テーブルを読み取ります。ハードコードされた情報はありません。読み取り可能なデータベースがない場合は「データなし／0」と表示し、数値を作り出すことはありません（--mock はデモ専用です）。ローカルデータベースのみを反映するため、別のマシン（たとえば、別のコンピューター上の別のエージェント）のメモリはここには表示されません。これは想定どおりの動作です（バッジはマシンごとに独立しています）。

ストレージモード（コアに組み込まれています）：3 つのモードで、メモリを heropen にコミットする頻度と粒度を制御します。バルク保存はまとめて保存し、ターンごとの保存は各ターンを記録し、自動検出は「覚えておいて／決めた／パス／好み」などのトリガーワードに基づいて適切に選択します。エージェントごとに設定できます。このモードが制御するのはコミットのみであり、取得方法やトレイに表示される内容ではありません。書き込まれる内容は、引き続きローカルのファクトストアに保存されます。詳しくは docs/2.0-开场签名与存储内核.md (中国語) を参照してください。

インターフェース言語（2.0.4 以降）：トレイメニューの「言語」項目から、简体中文 / English / 日本語 / 한국어 / Español / Français / Deutsch / Português / Русский を切り替えられます。メニュー、ホバーツールチップ、通知、ワークベンチページは即座に切り替わり、選択内容はローカルに保存されます（~/.heropen/_tray_state.json）。

削除機能なし：バッジ、ワークベンチ、CLI のいずれにも、削除のための入り口は一切ありません。

オープニングシグネチャ

会話が始まるたびに、エージェントが実際に作業を始める前に、heropen はステータス行を 1 行だけコンテキストに挿入します。コマンドを入力する必要も、パネルを開く必要もありません。

heropen ready · 187 local memories · ~3 hours since last conversation · agent=xiaokai

これは MCP の prime_conversation の戻り値の先頭に付加されます（CLI の bootstrap でも出力されます）。

2.0 における存在感 = オープニングシグネチャ + トレイ：シグネチャは「チャット中に目に入る」ことを担い、トレイは「タスクバーに常に表示される」ことを担います。

heropen を選ぶ理由

	heropen（無料）	その他の選択肢
ストレージ	無制限	通常は上限あり
取得	無制限	呼び出しごとに課金
ネットワーク接続が必要	いいえ	はい
データの所有者	あなたのマシン	相手のサーバー
インストール	pip install 1 回	サーバー + 設定

無料版でも、制限された機能はなく、コア機能をすべて利用できます。

heropen の独自の強み

ローカルファーストは heropen だけのものではありません。SQLite と MCP を組み合わせた同種のプロジェクトは数多くあります。heropen が独自に備え、他のプロジェクトがまだ実現していないのは、次の 3 点です。

• 複数のエージェントにまたがるプライベートドメイン／共有ドメインのレイヤー構成。無料プランでは、完全にプライベートなエージェントを 8 つ利用できます（Hermes や WorkBuddy のような高頻度で常時稼働するエージェントには、それぞれ分離されたデータベースが割り当てられます）。さらに、必要に応じてエージェント間で知識を交換するための共有ドメイン（_shared）も利用できます。無料プランと Plus の違いは利用数ではなく機能です（Plus では、スキルの収集や共有など、実用的な機能が追加されます）。多くの競合製品が提供するのは、単一のフラットな名前空間だけです。
• 会話の開始前から時間を考慮（v1.8.7 以降）。各セッションの開始時に、エージェントは現地時刻、時間帯を表す言葉、前回の会話からの経過時間、睡眠サイクルをまたいだかどうかを自動的に受け取ります。これは対話側の時間的な基準となるもので、他の製品にはありません。
• 依存関係ゼロでのインストール。pip install heropen を 1 行実行するだけです。Docker、Postgres、Ollama は必要ありません。

プライバシーへの取り組み

データはお使いのマシンにとどまります。テレメトリーも、ハートビートの送信もありません。 すべてのメモリはローカルの SQLite データベースに保存されます。ベクトル検索には、デフォルトでローカルの埋め込みモデルを使用します（fastembed、pip install heropen[embedding]）。完全にオフラインで、無料です。また、環境変数 EMBEDDING_ENDPOINT と EMBEDDING_API_KEY をご自身のセルフホスト可能な埋め込みエンドポイント（OpenAI 互換の /v1/embeddings）に設定することもできます。これにより、サードパーティーのクラウドに料金を支払う必要はありません。

ローカルの埋め込みもセルフホスト可能なエンドポイントも設定されていない場合、検索は高速な全文検索（FTS）による照合にフォールバックします。これも完全にオフラインで、無料です。pip install heropen は設定ゼロで動作します。埋め込みは検索品質を向上させるだけで、基本的な利用を妨げることはありません。

ローカル機能はローカルにとどまります（現時点）。現在のバージョンでは、ローカルメモリの読み書き、検索、パネルの各機能を、ネットワークアクセスが必要なサービスに移行することはありません。無料プランで利用できる機能が、今後のバージョンで縮小されることもありません。

ローカルである理由

メモリがクラウドの機能になると、会話履歴や作業コンテキストが他者のサーバーに保存されることになります。heropen はその逆を選びます。メモリは ~/.heropen/ にエージェントごとに 1 つの SQLite ファイルとして書き込まれ、データがマシンの外に出ることはありません。

クラウドがもたらすのは利便性です。一方、ローカルがもたらすのは、取り上げられるのがあなただけだということです。

メモリはあなたのものです

メモリはローカルの ~/.heropen/ ディレクトリに、エージェントごとに 1 つの SQLite ファイルとして保存されます。いつでも次の操作ができます。

• バックアップ／エクスポート：heropen export ですべてのメモリをローカルの JSON ファイルに書き出します（heropen import で読み戻せます）。
• 削除機能なし：heropen には削除／消去のための操作手段がありません。メモリはローカルにあり、あなたが管理でき、エクスポートもできますが、取り返しのつかない誤操作を防ぐため、意図的にどこにも「削除」ボタンを設けていません（クラウド上にコピーはなく、削除すると完全に失われます）。どうしても整理が必要な場合は、~/.heropen/ にある該当の SQLite ファイルを削除するだけです。私たちを介する必要も、ネットワーク接続も必要ありません。

より扱いやすいMarkdown + YAML エクスポート（人間が読める形式、完全な往復変換が可能、再インポート可能）は、ロードマップに含まれています。

選び方

メモリソリューションを選ぶ際は、想起性能だけでなく、次の5つの点を確認してください。

1. デプロイコスト：pip install だけで使い始められますか。それとも Docker ／ Postgres ／ Ollama ／ API キーが必要ですか？
2. 依存関係とコスト：書き込み処理で LLM のトークンを消費しますか？外部依存がまったくありませんか？
3. ポータビリティ：メモリを読みやすいファイルとしてエクスポートし、別の場所に持ち運んで再インポートできますか？
4. セキュアなデフォルト設定：リッスンポートはデフォルトでループバックアドレスまたは 0.0.0.0 にバインドされますか？テレメトリはありませんか？
5. エンジニアリング上の負担：書き込みのルールと無効化の仕組みは明確ですか？プロンプトキャッシュに対応していますか？モデル間の容量制限はどのように処理されますか？

heropen doctor を実行すると、5項目すべてを自己診断し、それぞれに合格／要確認／警告の判定を示します。

バージョンと位置付け

バージョン	位置付け	対象ユーザー
Free	メモリという1つの機能に特化し、ローカルでプライベートに使えるうえ、使うほど優れたものになります	自分のマシンで動作するエージェントに長期記憶を持たせたい方
Plus	優れたメモリに加えて、あなたの作業成果を提供します。最初の機能はスキルの収集と共有で、記憶した内容を複数のエージェントで再利用できます	継続的に追加される新機能に対価を払う意欲のある個人創業者／インディー開発者
Enterprise	多数の従業員 × 多数の顧客に対応するメモリ基盤（セルフホスト＋分離＋監査）	多数の従業員が多数の顧客にサービスを提供する組織

Free バージョンは完全なオープンソース（Apache-2.0）です。Plus ／ Enterprise はクローズドソースです。

コンプライアンスに関する声明

heropen はローカルファーストのメモリおよびコンテキストツールです。データは常にあなたのマシン上に保管され、完全にあなたの管理下にあります。ローカルファーストのアーキテクチャにより、ユーザーデータの管理と透明性に関する要件を本質的に満たします。その動作は透明で、あなた自身で管理できます。

オープンソースの範囲

Free バージョンは完全なオープンソース（Apache-2.0）です。商用レイヤー（Plus ／ Enterprise）はクローズドソースです。

リンクとサポート

• ホームページ：heropen.net
• ドキュメント：heropen.net/docs
• GitHub：github.com/Koradji77/heropen

⭐ 気に入ったらスターを付けてください — これが私たちへの最大の支援になります。★ Star をクリックしてください。

ロードマップ

• 現在はデスクトップでのローカル利用に注力しています。モバイル対応／デバイス間同期は、「データがマシンの外に出ることはない」というデフォルトの約束に反するため、現時点では対象外です。将来実装する場合も、ユーザー所有のストレージ＋エンドツーエンド暗号化＋デフォルトで無効という形が必須です。
• Markdown ＋ YAML によるメモリエクスポート（完全な往復変換に対応）。
• エージェント間で使える、より製品化されたプライベートドメイン／共有ドメイン機能。

ライセンス

Apache-2.0