このプロジェクトについて

abmindは、継続的に稼働するAIエージェント、特に多言語会話を処理するエージェント向けに設計された永続メモリシステムです。ベクトルデータベースのラッパーではなく、SQLite上に構築された完全なメモリ管理エンジンです。 **コアアーキテクチャ** - **取り込み**: メッセージが記録され、インライン抽出によって型付け・分類・スコアリングされたメモリが作成されます。 - **リコール**: クエリは4層検索をトリガーします。FTS5全文検索(英語)、FTS5全文検索(原語)、トライグラム曖昧一致、セマンティック埋め込み(コサイン類似度)です。結果はランク付けされ、重複排除され、分類によってゲートされます。 - **スリープ**: 夜間メンテナンスパイプラインは、日次要約、抽出、回顧分析、トピック割り当て、メモリダーウィニズム(昇格/降格/統合)、翻訳、感情アーク追跡、統合、ガベージコレクションを実行します。サイクルごとに10~14回のLLM呼び出しを自律的に実行します。 **主な機能** - **膠着語サポート**: 単語境界が明確でない日本語、トルコ語、ハンガリー語などの言語を処理するため、FTS5とともにトライグラム曖昧検索を使用します。これにより、あらゆる言語での保存とリコールが可能になります。 - **認証情報ボールト**: シークレットは保存時に暗号化され(AES-256-GCM)、会話履歴からは伏せ字化され、分類でゲートされたリコールを通じて所有者のみが取得できます。バックアップに生の認証情報が含まれることはありません。 - **マルチ解像度コンテキスト**: 3つのズームレベル(最近の逐語的なターン、圧縮されたターンごとのアトム(ABM-L形式でトークン3倍削減)、長期的なテーマ別要約)を提供し、同じトークン予算内で3倍のカバレッジを実現します。 - **分類**: NATO Admiralty Codes(0公開~3秘密/暗号化)を使用し、信頼性、完全性、信用度スコアを付けます。リコールはユーザーのクリアランスでフィルタリングされ、マルチユーザー分離によりユーザー間の漏洩を防ぎます。 - **インジェクション検出**: 14の検出カテゴリ(プロンプトインジェクション、ジェイルブレイク、ロールハイジャックなど)が、悪意のある入力がメモリに入る前にブロックします。感度は設定可能です。 **統合パス** - **ライブラリ**: 任意のNode.jsエージェントで`MemoryManager`をインポートします。 - **CLI**: `abmind store`、`abmind recall`、`abmind sleep`、`abmind mcp`などのコマンド。 - **MCPサーバー**: kiro-cli、Claude Code、Codex CLI、Gemini CLI、Cursor、OpenCodeなどのエディタやホスト向けにstdio MCPサーバーを起動します。 - **エージェントフック**: Kiro CLI、Claude Code、Gemini CLI、Codexと互換性があります。 - **フレームワーク**: Hermes Agentのプラグイン、OpenClawのネイティブメモリスロット、abTARSのインプロセスメモリとして動作します。 **データストレージ** デフォルトの場所は`~/.abmind/`です(`ABMIND_HOME`で上書き可能)。メッセージ、抽出されたメモリ、埋め込み用のSQLiteデータベース(`memory.db`)に加え、日次ナラティブ要約とスリープ監査ログが含まれます。スリーププロンプトは上書きできます。 **LLM設定** スリープメンテナンスには、`{PROMPT_FILE}`プレースホルダーを含む`ABMIND_LLM_CMD`の設定が必要です。`kiro-cli chat --no-tool-use < {PROMPT_FILE}`や`cat {PROMPT_FILE} | claude -p`などのコマンドをサポートします。 **バージョン**: 0.2.7 | **ライセンス**: Apache 2.0