Argon Memory

Memoria de proyecto duradera para agentes que hacen trabajo real

Un sistema de conocimiento MCP de código abierto que convierte documentos, resultados de agentes, decisiones y conversaciones verificadas en una memoria de proyecto persistente y consciente de la evidencia.

中文 · Arquitectura · Herramientas MCP · Benchmarks · Seguridad

La mayoría de los sistemas de memoria de agentes guardan fragmentos de chat. Argon Memory mantiene un proyecto.

Proporciona a cada agente conectado el mismo mapa compacto del proyecto, le permite recuperar evidencia exacta solo cuando es necesario y cierra el ciclo al conservar resultados duraderos y conocimiento destilado tras el trabajo. Los hechos no se sobrescriben silenciosamente entre sí: la procedencia, las revisiones, el estado de validación y los conflictos no resueltos permanecen visibles.

Por qué Argon Memory

• Memoria con forma de proyecto — un archivo principal estable, secciones de dominio mantenidas, un grafo de conocimiento y Artefactos enlazados.

• Contexto eficiente en tokens — carga primero el mapa pequeño del proyecto; recupera secciones y fragmentos de evidencia solo cuando la tarea los necesita.

• Evidencia antes que confianza — la memoria aceptada enlaza con los registros fuente; los candidatos no respaldados se ponen en cuarentena en lugar de convertirse en hechos.

• Cierre duradero del agente — los elementos de trabajo, los recursos generados, las decisiones, las lecciones y las preguntas no resueltas sobreviven más allá de una sesión de chat.

• Consciente de conflictos por diseño — las afirmaciones contrapuestas se revelan y se dirigen a un resolvedor humano autorizado; el modelo no puede elegir a un ganador en silencio.

• Historial de solo anexión — manifiestos de revisión inmutables, huellas SHA-256, eventos de auditoría y sustitución en lugar de borrado destructivo.

• Nativo de MCP — funciona con Codex, Claude Code, Qoder, Hermes, Cursor o cualquier cliente MCP Streamable HTTP.

• Independiente del modelo — la ruta de consulta no requiere un LLM. Un trabajador de mantenimiento opcional y separado puede usar el modelo y el proveedor que elijas.

Related MCP server: lore

Modelo mental

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

Las capas tienen funciones distintas:

Inicio rápido

Requistos: Node.js 22+; Python 3.10+ solo cuando se usa el adaptador opcional de MinerU.

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

El endpoint MCP es http://127.0.0.1:8793/mcp; la comprobación de salud está disponible en http://127.0.0.1:8793/health.

Inicializa el primer proyecto con kb_bootstrap_project:

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

Después de la inicialización, ejecta agentes normales con el perfi project-contribute e instala la argon-memory Skill incluida.

Conecta un cliente MCP

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

Para un experimento local de un solo usuario, omite la cabecera solo cuando ARGON_MEMORY_ALLOW_UNAUTHENTICATED=true. Nunca expongas a una red los perfiles de contribución u operaciones sin autenticación.

El flujo de trabajo del agente

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

1. kb_brief carga el mapa de proyecto compacto completo.

2. kb_graph_context abre una sección mantenida y su evidencia enlazada.

3. kb_search recupera hechos, nombres, fechas, versiones, citas y fragmentos de Artefactos precisos.

4. kb_start_work crea una identidad de tarea duradera antes de que comience el trabajo material.

5. kb_publish_resource almacena resultados útiles; kb_capture_context envía candidatos de memoria destilada.

6. kb_finish_work registra el resultdo, la evidencia, los elementos no resueltos y el hash de resultado idempotente.

Esta separación evita dos fallos habituales: inundar cada prompt con el archivo completo y pretender que un resumen breve es evidencia suficiente.

Perfiles de permisos

Los tokens principales se almacenan como hashes SHA-256 en ARGON_MEMORY_MCP_PRINCIPALS_JSON. El acceso del resolvedor requiere además el rol project-owner o designated-resolver. Un token compartido nunca demuestra qué humano habló.

Almacenamiento canónico

Argon Memory conserva deliberadamente Markdown inspeccionable por humanos y frontmatter YAML como verdad canónica. Los índices de búsqueda y las vistas de grafo son derivados y reconstruibles.

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

No se distribuyen datos de proyecto en este repositorio. El árbol data/ se crea en tiempo de ejecución y Git lo ignora.

Normalización de artefactos

El texto, Markdown, CSV, JSON y YAML se vuelven buscables de inmediato. Los documentos binarios permanecen como Artefactos inmutables hasta que se normalizan.

MinerU Cloud es un adaptador opcional:

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

Entonces, un principal de operaciones puede registrar una raíz de origen, ingerir el inventario y llamar a kb_parse_artifact. La salida de la API se escribe en el registro de auditoría. Argon Memory no está acoplado a la capa de almacenamiento ni de modelos de MinerU; otros normalizadores pueden escribir el mismo contrato de Markdown normalizado.

Qué se excluye intencionadamente

• Sin interfaz de chat ni agente en línea alojado.

• Sin ejecuor de comandos, espacio de trabajo en contenedor ni plano de ejecución remota.

• Sin documentos de proyecto, archivos de usuario, base de datos de producción, credenciales ni secretos de despliegue.

• Sin modelo que responda en nombre de los clientes conectados.

• Sin fixtures de prueba ni corpus de prueba en el paquete publicado.

Argon Memory es la capa de memoria. Tu agente local o alojado sigue siendo la capa de razonamiento y ejecución.

Estado

0.1.1 es la versión independiente actual de Argon, extraída de un sistema de memoria de proyectos en producción. El contrato de almacenamiento, la superficie MCP, las reglas de procedencia y los límites de conflictos son utilizables hoy; los backends vectoriales a gran escala y los adaptadores de normalización adicionales siguen siendo trabajo futuro.

Benchmark público

Argon Memory incluye un adaptador nativo MCP para el benchmark oficial de memoria de agentes LongMemEval-V2. Evalúa trayectorias web y empresariales de horizonte largo en cinco capacidades de memoria, midiendo la calidad de las respuestas y la latencia de las consultas. Los casos sintéticos se usan solo como pruebas de humo y nunca se informan como puntuaciones del benchmark. Consulta benchmarks, la política de reporte y el primer diagnóstico público de recuperación.

La comparación anterior reproduce los puntos de precisión/latencia oficiaes publicados de RAG, AgentRunbook-R, Codex y AgentRunbook-C, y etiqueta por separado la actualización de investigación AgentRunbook-C V2. La precisión de respuesta oficia de Argon y su LAFS siguen pendientes; el diagnóstico siguiente es solo de recuperación y no se representta como precisión de respuesta.

Origen y licencia

Argon Memory se derivó de un trabajo de memória de proyectos construido sobre el MinerU Document Exploror, con licencia MIT. Argon Memory 0.1.1 y versiones posteriores se publican bajo la Apache License 2.0, incluida una concesión explícita de patente. La atribución upstream y el aviso MIT original se conservan en NOTICE y THIRD_PARTY_NOTICES.md.

Contribuyentes

Argon Memory está creado y dirigido por Tangtaizong-BUAA, con OpenAI Codex reconocido como colaborador de ingeniería de IA. Los roles y los límites de atribución se documentan en CONTRIBUTORS.md.

Las contribuciones son bienvenidas. Por favor, lee CONTRIBUTING.md y SECURITY.md antes de abrir un pull request o de notificar una vulnerabilidad.