Argon Memory

実際の作業を行うエージェントのための永続的なプロジェクトメモリ

文書、エージェントの出力、決定、検証済みの会話を、永続的で証拠を認識するプロジェクトメモリに変換するオープンソースのMCP知識システムです。

中文 · アーキテクチャ · MCPツール · ベンチマーク · セキュリティ

ほとんどのエージェントメモリシステムはチャットの断片を保存します。Argon Memoryはプロジェクトを維持します。

接続されたすべてのエージェントに同じコンパクトなプロジェクトマップを提供し、必要なときだけ正確な証拠を取得できるようにし、作業後に永続的な出力と蒸留された知識を保存することでループを閉じます。事実が互いに静かに上書きされることはありません。来歴、リビジョン、検証状態、未解決の競合は可視化されたままです。

Argon Memoryを選ぶ理由

• プロジェクト型メモリ — 安定した単一のメインファイル、維持されたドメインセクション、知識グラフ、リンクされたArtifacts。

• トークン効率の高いコンテキスト — まず小さなプロジェクトマップを読み込み、タスクに必要なときだけセクションと証拠の抜粋を取得します。

• 確信の前に証拠 — 受け入れられたメモリはソースレコードにリンクされます。裏付けのない候補は事実になる代わりに隔離されます。

• 永続的なエージェントのクローズアウト — 作業項目、生成されたリソース、決定、教訓、未解決の質問はチャットセッションを超えて存続します。

• 設計による競合認識 — 競合する主張は開示され、権限のある人間のリゾルバにルーティングされます。モデルが静かに勝者を選ぶことはできません。

• 追記のみの履歴 — 不変のリビジョンマニフェスト、SHA-256フィンガープリント、監査イベント、破壊的な削除の代わりとなる置き換え。

• MCPネイティブ — Codex、Claude Code、Qoder、Hermes、Cursor、または任意のStreamable HTTP MCPクライアントで動作します。

• モデル中立 — クエリパスはLLMを必要としません。別のオプションのメンテナンスワーカーは、選択したモデルとプロバイダーを使用できます。

Related MCP server: Memory Cortex

メンタルモデル

flowchart LR
  A["Agent starts a task"] --> B["Main project file"]
  B --> C["Maintained section"]
  C --> D["Linked Artifact evidence"]
  C --> E["Accepted memory"]
  D --> F["Precise answer or project work"]
  E --> F
  F --> G["Work closeout"]
  G --> H["Outputs + distilled knowledge"]
  H --> I["Validation and conflict routing"]
  I --> B

レイヤーには異なる役割があります:

クイックスタート

要件: Node.js 22+。オプションのMinerUアダプタを使用する場合のみPython 3.10+。

git clone https://github.com/Tangtaizong-BUAA/ArgonMemory.git
cd ArgonMemory
npm install
npm run build

export ARGON_MEMORY_KB_ROOT="$PWD/data"
export ARGON_MEMORY_MCP_PROFILE="project-ops"
export ARGON_MEMORY_ALLOW_UNAUTHENTICATED="true" # local bootstrap only
npm start

MCPエンドポイントはhttp://127.0.0.1:8793/mcpです。ヘルスチェックはhttp://127.0.0.1:8793/healthで利用できます。

kb_bootstrap_projectで最初のプロジェクトをブートストラップします:

{
  "project_id": "project:my-product",
  "title": "My Product",
  "mission": "Maintain a trustworthy, durable operating memory for this product."
}

ブートストラップ後、project-contributeプロファイルで通常のエージェントを実行し、同梱のargon-memoryスキルをインストールします。

MCPクライアントを接続する

{
  "mcpServers": {
    "argon_memory": {
      "url": "http://127.0.0.1:8793/mcp",
      "headers": {
        "Authorization": "Bearer ${ARGON_MEMORY_TOKEN}"
      }
    }
  }
}

ローカルのシングルユーザー実験では、ARGON_MEMORY_ALLOW_UNAUTHENTICATED=trueの場合のみヘッダーを省略してください。認証されていないcontributeまたはopsプロファイルをネットワークに公開しないでください。

エージェントのワークフロー

kb_sync_skill → kb_brief → kb_graph_context → kb_search as needed
              → kb_start_work → publish/capture → kb_finish_work

1. kb_briefが完全なコンパクトなプロジェクトマップを読み込みます。

2. kb_graph_contextが維持されたセクションとそれにリンクされた証拠を開きます。

3. kb_searchが正確な事実、名前、日付、バージョン、引用、Artifactの抜粋を取得します。

4. kb_start_workが実際の作業が始まる前に永続的なタスクIDを作成します。

5. kb_publish_resourceが有用な出力を保存し、kb_capture_contextが蒸留されたメモリ候補を提出します。

6. kb_finish_workが結果、証拠、未解決項目、冪等な結果ハッシュを記録します。

この分離により、すべてのプロンプトにアーカイブ全体を詰め込むことと、短い要約が十分な証拠であるかのように扱うことという、2つの一般的な失敗を回避します。

権限プロファイル

プリンシパルトークンはARGON_MEMORY_MCP_PRINCIPALS_JSONにSHA-256ハッシュとして保存されます。リゾルバアクセスにはさらにproject-ownerまたはdesignated-resolverロールが必要です。共有トークンは、どの人間が話したかを証明することはありません。

正規ストレージ

Argon Memoryは、人間が検査可能なMarkdownとYAMLフロントマターを正規の真実として意図的に保持します。検索インデックスとグラフビューは派生であり、再構築可能です。

data/
├── registry/                 # projects, sections, work, Artifacts, conflicts
├── memory/                   # structured memory records
├── events/                   # durable activity records
├── resources/                # immutable uploaded bytes
├── normalized/               # parser-derived Markdown and media links
├── audit/events.jsonl        # append-only audit stream
├── maintenance/queue.sqlite  # bounded maintenance ChangePackets
└── knowledge/
    ├── revisions/            # immutable canonical snapshots
    ├── indexes/              # rebuildable derived indexes
    └── current-revision.json # atomic pointer to one consistent snapshot

このリポジトリにはプロジェクトデータは同梱されません。data/ツリーは実行時に作成され、Gitによって無視されます。

Artifactの正規化

テキスト、Markdown、CSV、JSON、YAMLは即座に検索可能になります。バイナリドキュメントは正規化されるまで不変のArtifactとして残ります。

MinerU Cloudはオプションのアダプタです:

python3 -m pip install mineru-open-sdk
export MINERU_API_KEY="..."

その後、opsプリンシパルはソースルートを登録し、インベントリを取り込み、kb_parse_artifactを呼び出すことができます。APIエグレスは監査ログに記録されます。Argon MemoryはMinerUのストレージやモデルレイヤーに結合されていません。他のノーマライザも同じ正規化されたMarkdownコントラクトを書き込むことができます。

意図的に含まれないもの

• チャットUIやホスト型オンラインエージェントはありません。

• コマンドランナー、コンテナワークスペース、リモート実行プレーンはありません。

• プロジェクトドキュメント、ユーザーファイル、本番データベース、資格情報、デプロイメントシークレットはありません。

• 接続されたクライアントに代わって回答するモデルはありません。

• 公開パッケージにテストフィクスチャやテストコーパスはありません。

Argon Memoryはメモリレイヤーです。ローカルまたはホスト型のエージェントは、推論と実行のレイヤーであり続けます。

ステータス

0.1.1は、本番のプロジェクトメモリシステムから抽出された、現在のスタンドアロンArgonリリースです。ストレージコントラクト、MCPサーフェス、来歴ルール、競合境界は今日使用可能です。大規模なベクトルバックエンドと追加のノーマライザアダプタは将来の作業です。

公開ベンチマーク

Argon Memoryには、公式のLongMemEval-V2エージェントメモリベンチマーク用のMCPネイティブアダプタが含まれています。5つのメモリ能力にわたる長期的なWebおよびエンタープライズのトラジェクトリを評価し、回答品質とクエリレイテンシを測定します。合成ケースはスモークゲートとしてのみ使用され、ベンチマークスコアとして報告されることは決してありません。ベンチマーク、レポートポリシー、最初の公開取得診断を参照してください。

上記の比較は、公式に公開されたRAG、AgentRunbook-R、Codex、AgentRunbook-Cの精度/レイテンシポイントを再現し、AgentRunbook-C V2研究アップデートを別途ラベル付けしています。Argonの公式な回答精度とLAFSは保留中です。以下の診断は取得のみであり、回答精度としてプロットされていません。

由来とライセンス

Argon Memoryは、MITライセンスのMinerU Document Explorer上に構築されたプロジェクトメモリ作業から派生しました。Argon Memory 0.1.1以降は、明示的な特許許諾を含むApache License 2.0の下でリリースされています。上流の帰属表示と元のMIT通知は、NOTICEとTHIRD_PARTY_NOTICES.mdに保持されています。

コントリビューター

Argon MemoryはTangtaizong-BUAAによって作成・主導されており、OpenAI CodexがAIエンジニアリングコラボレーターとして認められています。役割と帰属の境界はCONTRIBUTORS.mdに文書化されています。

コントリビューションを歓迎します。プルリクエストを開いたり脆弱性を報告したりする前に、CONTRIBUTING.mdとSECURITY.mdをお読みください。