[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_112":113},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":-5,"_77":-5,"_78":48,"_79":-5,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93},"apiUrl","https://odel.app/api","creator","diaaaj","moduleId","a-mem-mcp","@diaaaj/a-mem-mcp","displayName","a mem mcp","tagline","Self-evolving memory system for AI agents","iconKey","https://avatars.githubusercontent.com/u/34287923?v=4","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1783334734000,"updatedAt",1788773614000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.DiaaAj%2Fa-mem-mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",34,"upstreamUpdatedAt",1768618683000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/DiaaAj/a-mem-mcp","githubRepoFullName","DiaaAj/a-mem-mcp","releaseId","ext-diaaaj-a-mem-mcp","version","0.2.1","descriptionMarkdown","# A-MEM: Self-evolving memory for coding agents\n\n

\n $\"PyPI$ \n $\"PyPI$ \n $\"MCP$ \n

\n\n**mcp-name: io.github.DiaaAj/a-mem-mcp**\n\nA-MEM is a self-evolving memory system for coding agents. Unlike simple vector stores, A-MEM automatically organizes knowledge into a Zettelkasten-style graph with dynamic relationships. Memories don't just get stored—they evolve and connect over time.\n\nCurrently tested with **Claude Code**. Support for other MCP-compatible agents is planned.\n\n

\n\n## Quick Start\n\n### Install\n\n```bash\npip install a-mem\n```\n\n### Add to Claude Code\n\n```bash\nclaude mcp add a-mem -s user -- a-mem-mcp \\\n -e LLM_BACKEND=openai \\\n -e LLM_MODEL=gpt-4o-mini \\\n -e OPENAI_API_KEY=sk-...\n```\n\nThat's it! A session-start hook installs automatically to remind Claude to use memory.\n\n> **Note:** Memory is stored per-project in `./chroma_db`. For global memory across all projects, see [Memory Scope](#memory-scope).\n\n### Uninstall\n\n```bash\na-mem-uninstall-hook # Remove hooks first\npip uninstall a-mem\n```\n\n## How It Works\n\n```\nt=0 t=1 t=2\n\n ◉───◉ ◉───◉\n ◉ │ ╱ │ ╲\n ◉ ◉──┼──◉\n │\n ◉\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━▶\n self-evolving memory\n```\n\n1. **Add a memory** → A-MEM extracts keywords, context, and tags via LLM\n2. **Find neighbors** → Searches for semantically similar existing memories\n3. **Evolve** → Decides whether to link, strengthen connections, or update related memories\n4. **Store** → Persists to ChromaDB with full metadata and relationships\n\nThe result: a knowledge graph that grows smarter over time, not just bigger.\n\n## Features\n\n**Self-Evolving Memory**\nMemories aren't static. When you add new knowledge, A-MEM automatically finds related memories and strengthens connections, updates context, and evolves tags.\n\n**Semantic + Structural Search**\nCombines vector similarity with graph traversal. Find memories by meaning, then explore their connections.\n\n**Peek and Drill**\nStart with breadth-first search to capture relevant memories via lightweight metadata (id, context, keywords, tags). Then drill depth-first into specific memories with `read_memory_note` for full content. This minimizes token usage while maximizing recall.\n\n## MCP Tools\n\nA-MEM exposes 8 tools to your coding agent:\n\n| Tool | Description |\n|------|-------------|\n| `add_memory_note` | Store new knowledge (async, returns immediately) |\n| `search_memories` | Semantic search across all memories |\n| `search_memories_agentic` | Search + follow graph connections |\n| `search_memories_by_time` | Search within a time range |\n| `read_memory_note` | Get full details (supports bulk reads) |\n| `update_memory_note` | Modify existing memory |\n| `delete_memory_note` | Remove a memory |\n| `check_task_status` | Check async task completion |\n\n### Example Usage\n\n```python\n# The agent calls these automatically, but here's what happens:\n\n# Store a memory (returns task_id immediately)\nadd_memory_note(content=\"Auth uses JWT in httpOnly cookies, validated by AuthMiddleware\")\n\n# Search later\nsearch_memories(query=\"authentication flow\", k=5)\n\n# Deep search with connections\nsearch_memories_agentic(query=\"security\", k=5)\n```\n\n## Advanced Configuration\n\n### JSON Config\n\nFor more control, edit `~/.claude/settings.json` (global) or `.claude/settings.local.json` (project):\n\n```json\n{\n \"mcpServers\": {\n \"a-mem\": {\n \"command\": \"a-mem-mcp\",\n \"env\": {\n \"LLM_BACKEND\": \"openai\",\n \"LLM_MODEL\": \"gpt-4o-mini\",\n \"OPENAI_API_KEY\": \"sk-...\"\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `LLM_BACKEND` | `openai`, `ollama`, `sglang`, `openrouter` | `openai` |\n| `LLM_MODEL` | Model name | `gpt-4o-mini` |\n| `OPENAI_API_KEY` | OpenAI API key | — |\n| `EMBEDDING_MODEL` | Sentence transformer model | `all-MiniLM-L6-v2` |\n| `CHROMA_DB_PATH` | Storage directory | `./chroma_db` |\n| `EVO_THRESHOLD` | Evolution trigger threshold | `100` |\n\n### Memory Scope\n\n- **Project-specific** (default): Each project gets isolated memory in `./chroma_db`\n- **Global**: Share across projects by setting `CHROMA_DB_PATH=~/.local/share/a-mem/chroma_db`\n\n### Alternative Backends\n\n**Ollama (local, free)**\n```bash\nclaude mcp add a-mem -s user -- a-mem-mcp \\\n -e LLM_BACKEND=ollama \\\n -e LLM_MODEL=llama2\n```\n\n**OpenRouter (100+ models)**\n```bash\nclaude mcp add a-mem -s user -- a-mem-mcp \\\n -e LLM_BACKEND=openrouter \\\n -e LLM_MODEL=anthropic/claude-3.5-sonnet \\\n -e OPENROUTER_API_KEY=sk-or-...\n```\n\n### Hook Management (Claude Code)\n\nThe session-start hook reminds Claude to use memory tools. It installs automatically with Claude Code, but you can manage it manually:\n\n```bash\na-mem-install-hook # Install/reinstall hook\na-mem-uninstall-hook # Remove hook completely\n```\n\n## Python API\n\nUse A-MEM directly in Python (works with any agent or application):\n\n```python\nfrom agentic_memory.memory_system import AgenticMemorySystem\n\nmemory = AgenticMemorySystem(\n llm_backend=\"openai\",\n llm_model=\"gpt-4o-mini\"\n)\n\n# Add (auto-generates keywords, tags, context)\nmemory_id = memory.add_note(\"FastAPI app uses dependency injection for DB sessions\")\n\n# Search\nresults = memory.search(\"database patterns\", k=5)\n\n# Read full details\nnote = memory.read(memory_id)\nprint(note.keywords, note.tags, note.links)\n```\n\n## Research\n\nA-MEM implements concepts from the paper:\n\n> **A-MEM: Agentic Memory for LLM Agents**\n> Xu et al., 2025\n> [arXiv:2502.12110](https://arxiv.org/pdf/2502.12110)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_96":97,"_98":99,"_100":101,"_102":103,"_104":-5,"_105":106},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_94":81,"_95":81},"ratingAvg","reviewCount","topics",[],"license","MIT","language","Python","registryName","io.github.DiaaAj/a-mem-mcp","homepage","packages",[107],{"_108":109,"_110":111,"_71":72},"registryType","pypi","identifier","a-mem","ENV",{"_114":115,"_116":117,"_118":119},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]