Zouroboros Memory

Usage

安装: npm 安装 zouroboros-memory

命令行工具 npx zouroboros-memory --help npx zouroboros-memory init npx zouroboros-memory store --entity user --key name --value "Alice" --decay permanent npx zouroboros-memory 搜索 "project preferences" --limit 5 npx zouroboros-memory stats

MCP Server

添加 to your .mcp.json:

{ "servers": { "memory": { "command": "npx", "args": ["zouroboros-memory-mcp", "--db-path", "~/.zouroboros/memory.db"] } } }

Programmatic API 导入 { init, storeFact, 搜索Facts, 搜索FactsHybrid, 获取Stats } from 'zouroboros-memory'; 导入 type { MemoryConfig } from 'zouroboros-memory';

const config: MemoryConfig = { enabled: true, dbPath: '~/.zouroboros/memory.db', vectorEnabled: false, ollamaUrl: 'http://localhost:11434', ollama模型: 'nomic-embed-text', autoCapture: false, captureIntervalMinutes: 30, graphBoost: true, hydeExpansion: false, decayConfig: { permanent: Infinity, long: 365, medium: 90, short: 30 }, };

init(config);

// Store a fact awAIt storeFact({ entity: 'user', key: 'preference', value: 'dark mode' }, config);

// Keyword 搜索 const 结果s = 搜索Facts('dark mode', { limit: 5 });

// Hybrid 搜索 (RRF fusion of keyword + vector) const hybrid结果s = awAIt 搜索FactsHybrid('user preferences', config, { limit: 10 });

MCP 工具s 工具 Description memory_store Store a fact with optional decay class memory_搜索 Keyword or hybrid 搜索 memory_episodes 创建/搜索 episodic memories cognitive_性能分析 获取/更新 entity cognitive 性能分析s memory_graph 查询 entity relationship graph memory_procedures 查询 stored 工作流 procedures memory_stats Database statistics memory_删除 删除 a fact by ID memory_p运行e 移除 expired facts Decay Classes Class TTL permanent Never expires long 365 days medium 90 days (default) short 30 days