SecurityRonin/alaya

Features

• Three-store architecture (episodic/semantic/implicit) + Hebbian graph overlay
• 7 lifecycle operations: consolidate, transform, forget, perfume, emergent ontology, RIF, purge
• Modular RAG retrieval: BM25 + vector + graph + RRF fusion + semantic/preference enrichment
• Bjork dual-strength forgetting with retrieval-induced suppression (RIF)
• LTD (Long-Term Depression): Hebbian link decay weakens unused associations each transform cycle
• Enriched retrieval: query results include semantic knowledge and preferences alongside episodes
• Tombstone tracking: cascade deletion records audit trail for every purged node
• Zero-dependency Rust library with SQLite WAL + FTS5
• Category hierarchy with parent_id — categories form tree structures; auto-split when too broad
• Cross-domain bridging via MemberOf links — spreading activation traverses category boundaries
• EmbeddingProvider trait — embed() + embed_batch() wired into store_episode() and query()
• ExtractionProvider trait — extract() enables auto-consolidation; LlmExtractionProvider (behind llm feature flag) calls any OpenAI-compatible API
• 13 MCP tools — remember, recall, learn, status, preferences, knowledge, maintain, purge, categories, neighbors, node_category, import_claude_mem, import_claude_code
• Auto-lifecycle — auto-maintenance every 25 episodes; auto-consolidation (or prompt) after 10 unconsolidated
• 442 tests across unit, integration, property-based (proptest), and doc tests

Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| ALAYA_DB | ~/.alaya/memory.db | Path to SQLite database |
| ALAYA_LLM_API_KEY | (none) | API key for auto-consolidation (requires llm feature) |
| ALAYA_LLM_API_URL | https://api.openai.com/v1/chat/completions | OpenAI-compatible endpoint |
| ALAYA_LLM_MODEL | gpt-4o-mini | Model name |

Build

# MCP server only
cargo build --release --features mcp

# MCP server with auto-consolidation
cargo build --release --features "mcp llm"

Full Changelog: https://github.com/SecurityRonin/alaya/compare/v0.1.0...v0.2.0