TCAM Memory System
Resilient 4-Layer Memory Architecture for TCAM v1.4 (Triadic Cognitive Augmentation Model)
Overview
The TCAM Memory System implements a fault-tolerant memory architecture where each layer operates independently, ensuring that system failures in one layer do not cascade to others. Memory operations are handled by a dedicated Memory Service running on Qwen 3.5 9B (local LLM).
Architecture
Four Independent Layers
- L1: Chronicle - Immutable historical record (file system, markdown)
- L2: Active Stream - Volatile working memory (Cloud LLM context + Redis)
- L3: Hive Mind - Semantic memory (Qdrant vector DB + Mem0)
- L4: Agent Codex - Personal knowledge base (file system, markdown)
Memory Service
Dedicated process running on Qwen 3.5 9B for:
- Truth extraction from dialogue
- Chronicle inscription
- Hive Mind indexing
- Agent Codex updates
- Sleeping cycle orchestration
Technology Stack
- TypeScript/Node.js - Core implementation
- Qwen 3.5 9B - Local LLM for memory operations
- Mem0 - Automatic fact extraction
- Qdrant - Vector database for semantic search
- Redis - Fast state persistence (LangGraph checkpointer)
- LangGraph - Multi-agent orchestration
- Jest - Testing framework
- fast-check - Property-based testing
Project Structure
Getting Started
Prerequisites
- Node.js 18+
- Ollama (for Qwen 3.5 9B)
- Docker (for Qdrant and Redis)
Installation
CLI Usage
Dashboard Features
The Terminal UI dashboard (anots dashboard) provides:
- Real-time memory layer health monitoring
- System statistics (chapters, sessions, memories)
- Activity log with timestamps
- Keyboard shortcuts (F1-F3, R, Q)
- Auto-refresh every 2 seconds
- Cyberpunk aesthetic with 90s BBS vibes
Verify Setup
Development
Importing Conversations
Import large conversation files into the ANOTS memory system:
What Gets Imported
- Chronicle: Conversation history in chapters
- Hive Mind: Semantic indexing for search
- Codex: Extracted truths and insights
See data/import/README.md for detailed documentation and examples.
Specification
See .kiro/specs/memory-system/ for complete specification:
requirements.md - Functional requirements
design.md - Technical design
tasks.md - Implementation tasks
License
MIT