MenteDB is a purpose-built database engine designed for AI agent memory, providing capabilities like vector similarity search, a typed knowledge graph, token budget-aware context assembly, contradiction detection, and trajectory tracking. It delivers its full Rust-based engine as a native Node.js addon via `napi-rs`, offering zero runtime dependencies for prebuilt binaries. The package is currently at version 0.3.1, indicating an early development stage with potentially rapid API evolution. It releases frequently, with minor versions and bug fixes appearing regularly across its main package and internal sub-packages like `mentedb-storage` and `mentedb-query`. Its key differentiators include its focus on agent-specific cognitive features and its performance benefits from the Rust-native implementation.
npm install mentedbVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to initialize MenteDB, store and search memories with embeddings, perform MQL recalls, and utilize its cognitive features like CognitionStream and TrajectoryTracker.
Always pin to exact versions (e.g., `npm install mentedb@0.3.1`) and thoroughly review release notes before upgrading in production environments. Regular dependency audits are recommended.
Ensure Rust and `napi-rs` are installed as per the `mentedb` README. Check `npm install` logs for specific compilation errors related to the native addon. Run `npm run build` in the `sdks/typescript` directory if troubleshooting.
Develop or integrate an embedding generation service (e.g., OpenAI, Cohere, custom model) to produce numerical vector representations of your memory content and queries. Pass these `number[]` arrays to `db.store()` and `db.search()`.
Install Rust and `napi-rs` build tools, then try installing again. Alternatively, check the GitHub releases for prebuilt binaries for your specific platform or consult the project's documentation for supported environments.
Ensure your project is configured for ES Modules (add `"type": "module"` to `package.json`) and use `import { MenteDB } from 'mentedb';` syntax.Verify the `dataDir` path exists and is writable by the Node.js process. Ensure no other process is actively using the same database directory. If corruption is suspected, try deleting the directory and restarting (losing data).
No dependency data recorded yet.