Contributing

Development setup

This is a pnpm monorepo (Node 24).

git clone https://github.com/heichaowo/amem
cd amem
pnpm install        # first run: `pnpm approve-builds` for onnxruntime-node / sharp / esbuild
pnpm -r build

Running checks

pnpm -r lint               # ESLint (Flat Config)
pnpm format                # Prettier check
pnpm -r typecheck
pnpm -r test               # Vitest — integration tests need Qdrant :6333 + ANTHROPIC_API_KEY

Test coverage

Test suite is under reconstruction. See GitHub Issues for progress.

Project structure

amem/
├── packages/
│   ├── amem-core/         amem-core — the framework-agnostic engine
│   │   └── src/           memory · storage · embedding · llm · prompts · quality · evo-counter · config
│   └── openclaw-amem/     the OpenClaw plugin (bundles amem-core)
│       └── src/index.ts   plugin entry & OpenClaw hooks
├── docs/                  documentation site (VitePress)
└── pnpm-workspace.yaml

References

Reference	Role
Xu et al., A-MEM: Agentic Memory for LLM Agents, NeurIPS 2025 · arXiv:2502.12110	Core architecture
Robertson & Zaragoza, The Probabilistic Relevance Framework: BM25 and Beyond, 2009	BM25 ranking formula
Cormack et al., Reciprocal Rank Fusion, SIGIR 2009	RRF fusion formula
Sun et al., Jieba Chinese Text Segmentation	Chinese word segmentation