Cell-mem: An Open-Source Solution for Building Brain-Inspired Memory Systems for AI Agents

Project Overview

Cell-mem is an open-source solution for brain-inspired memory systems for AI Agents, using a four-layer memory architecture (working memory, episodic memory, semantic memory, procedural memory) to achieve persistent storage, supporting memory consolidation, self-reflection, generative replay, and creative hypothesis discovery.

Core Information

• Original Author/Maintainer: Aether-liusiqi
• Source Platform: GitHub
• Project Link: https://github.com/Aether-liusiqi/cell-mem
• Release Date: June 6, 2026

Most current AI Agents lack true memory capabilities; each interaction starts fresh, making it impossible to effectively retain past interactions, knowledge, or experiences. The human brain has evolved over millions of years to form an efficient multi-layer memory architecture. Cell-mem translates this biological wisdom into engineering practice, providing AI Agents with a fully functional memory infrastructure.

Working Memory

Capacity of approximately 50 records, based on an attention decay mechanism, simulating the prefrontal cortex's short-term buffer. When about to be removed, it enters a "warm-up zone".

Episodic Memory

Stores specific experience fragments, uses 384-dimensional embedding vectors projected into a 2048-dimensional space to reduce interference. Each memory has an "consolidation score" based on emotional rating, similar to how the hippocampus stores events.

Semantic Memory

Stores facts/rules, supports falsifiable conditions (e.g., version change updates), automatically verifies to ensure memories are not outdated, and locks the lifecycle of high-confidence memories.

Procedural Memory

Stores skill templates, triggered by cosine similarity. Reinforcement learning mechanism: success weight ×1.05, failure ×0.85, maintaining an 80% utilization /20% exploration balance.

• Multi-dimensional Emotional Scoring: Evaluates memory importance based on recency, frequency, valence, and surprise.
• DBSCAN Pattern Detection: Clusters to identify emerging knowledge patterns, organizing scattered experiences into structured understanding.
• Intelligent Forgetting: Memories with three consecutive low scores are archived to "cold storage" (recoverable), simulating the human "tip-of-the-tongue phenomenon".

Four-dimensional meta-reasoning analysis of failure events:

1. Effect Attribution: Establish a causal chain of the problem
2. Strategy Evaluation: Track success rates and identify redundant strategies
3. Knowledge Gap Detection: Mark missing facts/retrieval failures
4. Result Processing: Update memory weights/confidence and create meta-knowledge

Five-stage hypothesis engine:

1. Biased Sampling: Select seed memories based on recency × emotion × novelty
2. Random Walk: 3-step walk (80% strong connections /20% weak connections)
3. Cross-domain Pairing: Pair low-similarity concepts from different seeds
4. Four-layer Filtering: Contradiction check/triviality/dual-source verification/confidence threshold
5. Idea Pool Management: Hypothesis lifecycle (to be verified → confirmed/rejected → upgraded)

Built-in 10 noise constraints to prevent hallucination solidification.

Tech Stack

• Storage: SQLite (sqlite-vec vector search, FTS5 full-text search, NetworkX graph storage)
• Cold Storage: Recoverable archived forgotten memories

MCP Tools

12 tools: Memory saving, cross-layer retrieval, health monitoring, memory association, manual forgetting, trigger consolidation, verify falsifiable conditions, self-reflection, etc.

Deployment

• Stdio Mode: Subprocess with no network dependency
• HTTP Mode: Daemon process supports multiple Agents; shared key authentication is recommended for production environments.

Applicable Scenarios

• Long-term Collaboration Agents: Programming assistants/writing partners
• Learning Agents: Automated systems that accumulate experience from failures
• Research Agents: Exploration systems that maintain knowledge bases
• Enterprise Knowledge Management: Precipitate procedural knowledge

Conclusion

Cell-mem enables the transition of AI Agents from stateless to stateful, serving as a complete cognitive architecture and providing developers with an elegant and effective open-source solution.