mentedb
A cognition aware database engine for AI agent memory. Purpose built in Rust with WAL, HNSW, knowledge graphs, and speculative context pre assembly. Not a wrapper, a ground up storage engine that thinks.
File Explorer
Download Latest Version (.zip)- ci.yml
- publish-sdks.yml
- release-plz.yml
- release.yml
- copilot-instructions.md
- copilot-setup-steps.yml
- dependabot.yml
- codex_agents.atoms.dedup.json
- codex_agents.atoms.json
- codex_agents.md
- codex_agents.rules.json
- dev_claude.md
- dev_claude.rules.json
- freerouting_agents.atoms.json
- freerouting_agents.md
- freerouting_agents.rules.json
- kiali_agents.atoms.dedup.json
- kiali_agents.atoms.json
- kiali_agents.md
- kiali_agents.rules.json
- ops_meridian.md
- ops_meridian.rules.json
- SOURCES.md
- temporal_agents.atoms.dedup.json
- temporal_agents.atoms.json
- temporal_agents.md
- temporal_agents.rules.json
- cohere_space.py
- common.py
- llm_ingest.py
- README.md
- run_compliance.py
- run_coverage.py
- tasks_codex.json
- tasks_dev.json
- tasks_freerouting.json
- tasks_kiali.json
- tasks_ops.json
- tasks_temporal.json
- two_pass.py
- hypotheses_baseline-shared_q0-500.jsonl
- hypotheses_baseline-shared_q0-500.jsonl.eval-results-gpt-4o-2024-08-06
- hypotheses_baseline-shared_q0-500_report.md
- longmemeval_s_results.jsonl
- .gitignore
- clean.sh
- diagnose_failures.py
- download_data.py
- dry_run.py
- evaluate.py
- evaluate_all.py
- pre_extract.py
- README.md
- requirements.txt
- run_benchmark.py
- run_enriched.py
- run_full_benchmark.sh
- attention_budget.py
- candle_vs_openai.py
- delta_savings.py
- harness.py
- learn_manage.py
- learn_manage_scale.py
- learn_manage_vs_mem0.py
- learn_manage_vs_mem0_deep.py
- learn_manage_vs_mem0_hard.py
- learn_manage_vs_mem0_lme.py
- learn_manage_vs_mem0_stress.py
- mem0_comparison.py
- noise_ratio.py
- README.md
- requirements.txt
- run_all.py
- scale_10k.py
- stale_belief.py
- sustained_conversation.py
- VS_MEM0.md
- context_assembly.rs
- insert_throughput.rs
- similarity_search.rs
- storage_bench.rs
- basic_usage.rs
- cognitive_features.rs
- context_assembly.rs
- token_efficiency.rs
- gossip.rs
- placement.rs
- agent_file.rs
- calibration.rs
- enrichment.rs
- export.rs
- injection.rs
- lib.rs
- llm_consolidation.rs
- mmr.rs
- process_turn.rs
- reranker.rs
- sharding.rs
- action_rules.rs
- agent_file_ingest.rs
- agent_file_llm.rs
- agent_isolation.rs
- browse_index.rs
- cluster_completion.rs
- forget_durability.rs
- injection_escalation.rs
- integration.rs
- memory_dedup.rs
- mode_activation.rs
- own_agent_boost.rs
- process_turn.rs
- read_path_index.rs
- realistic.rs
- retrieval_stack.rs
- scenarios.rs
- scope_counts.rs
- snapshot_amortization.rs
- standing_rules.rs
- supersession_history.rs
- user_isolation.rs
- value_update.rs
- Cargo.toml
- CHANGELOG.md
- main.rs
- Cargo.toml
- CHANGELOG.md
- speculative_bench.rs
- entity.rs
- interference.rs
- lib.rs
- llm.rs
- pain.rs
- phantom.rs
- speculative.rs
- stream.rs
- trajectory.rs
- write_inference.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- archival.rs
- compression.rs
- consolidation.rs
- decay.rs
- extraction.rs
- forget.rs
- lib.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- assembler.rs
- budget.rs
- delta.rs
- layout.rs
- lib.rs
- serializer.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- agent.rs
- config.rs
- conflict.rs
- edge.rs
- error.rs
- event.rs
- lib.rs
- limits.rs
- memory.rs
- metrics.rs
- mvcc.rs
- space.rs
- text.rs
- tier.rs
- types.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- bedrock_provider.rs
- cache.rs
- candle_provider.rs
- hash_provider.rs
- http_provider.rs
- lib.rs
- manager.rs
- provider.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- cognitive_adapter.rs
- config.rs
- error.rs
- lib.rs
- pipeline.rs
- prompts.rs
- provider.rs
- schema.rs
- integration_tests.rs
- llm_accuracy.rs
- Cargo.toml
- CHANGELOG.md
- belief.rs
- contradiction.rs
- csr.rs
- lib.rs
- manager.rs
- traversal.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- bitmap.rs
- bm25.rs
- hnsw.rs
- lib.rs
- manager.rs
- salience.rs
- temporal.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- ast.rs
- lexer.rs
- lib.rs
- mql.rs
- parser.rs
- planner.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- cluster.rs
- config.rs
- lib.rs
- network.rs
- raft_node.rs
- store.rs
- Cargo.toml
- mentedb.proto
- auth.rs
- cluster.rs
- console.rs
- error.rs
- extraction_queue.rs
- grpc.rs
- handlers.rs
- lib.rs
- main.rs
- maintenance.rs
- metrics.rs
- rate_limit.rs
- routes.rs
- state.rs
- websocket.rs
- extraction_integration.rs
- integration.rs
- build.rs
- Cargo.toml
- CHANGELOG.md
- grafana-dashboard.json
- backup.rs
- buffer.rs
- engine.rs
- lib.rs
- lock.rs
- page.rs
- wal.rs
- integration.rs
- Cargo.toml
- CHANGELOG.md
- BUILD_AN_AGENT.md
- CLOUD.md
- SELF_HOSTING.md
- mentedb.json
- provider.yml
- datasource.yml
- docker-compose.yml
- prometheus.yml
- README.md
- sync-sdk-versions.sh
- __init__.py
- memory.py
- tool.py
- pyproject.toml
- README.md
- __init__.py
- chat_history.py
- memory.py
- retriever.py
- test_memory.py
- pyproject.toml
- README.md
- __init__.py
- _internal.py
- client.py
- hosted.py
- reranker.py
- types.py
- lib.rs
- test_basic.py
- test_cognitive.py
- test_hosted.py
- test_relate_integration.py
- .gitignore
- Cargo.lock
- Cargo.toml
- pyproject.toml
- README.md
- basic.test.ts
- client.ts
- index.ts
- types.ts
- lib.rs
- .gitignore
- .npmignore
- build.rs
- Cargo.lock
- Cargo.toml
- package-lock.json
- package.json
- README.md
- tsconfig.json
- .dockerignore
- .gitignore
- ARCHITECTURE.md
- Cargo.lock
- Cargo.toml
- CHANGELOG.md
- CLAUDE.md
- CONTRIBUTING.md
- docker-compose.yml
- Dockerfile
- LICENSE
- README.md
- release-plz.toml
- release.toml
- test_context_embeddings.py
- test_pipeline_audit.py
- VISION.md
# Installation Guide
git clone https://github.com/nambok/mentedb
Downloads the entire project code from GitHub to your computer.
cd mentedb
Moves into the project folder you just downloaded.
2. Official Install Script
Easy Recommended- Rust (rustup) Rust is required to use cargo.
- Python 3 Python is required to use pip.
cargo install mentedb-server
Builds and installs the package published on crates.io β no need to clone the repo yourself.
pip install mentedb
Installs the package published on PyPI directly β no need to clone the source.
pip install mentedb-langchain # LangChain memory provider
Installs the package published on PyPI directly β no need to clone the source.
pip install mentedb-crewai # CrewAI memory provider
Installs the package published on PyPI directly β no need to clone the source.
Pulled directly from this repo's README.
3. Docker
Easy- Git Needed to download the project code from GitHub.
- Docker Desktop Needed to build and run containers. Install it and keep it running in the background.
docker run -p 6677:6677 \
Runs the built image as an actual container.
docker compose -f observability/docker-compose.yml up -d
Runs the command against the services defined in the compose file.
docker build -t mentedb .
Builds a runnable image based on the Dockerfile.
docker-compose up -d
Runs the command against the services defined in the compose file.
Pulled directly from this repo's README.
4. Node.js
Easynpm install mentedb
Downloads and installs the libraries listed in package.json.
Pulled directly from this repo's README.
5. Python
Easypip install mentedb
Installs the package published on PyPI directly β no need to clone the source.
python3 -m venv .venv && .venv/bin/pip install mentedb
Installs the Python libraries listed in requirements.txt (or similar).
pip install mentedb-langchain # LangChain memory provider
Installs the package published on PyPI directly β no need to clone the source.
pip install mentedb-crewai # CrewAI memory provider
Installs the package published on PyPI directly β no need to clone the source.
Pulled directly from this repo's README.
6. Rust
Medium- Git Needed to download the project code from GitHub.
- Rust (rustup) Installing via rustup also installs cargo.
cargo install mentedb-server
Builds and installs the package published on crates.io β no need to clone the repo yourself.
cargo install mentedb-mcp
Builds and installs the package published on crates.io β no need to clone the repo yourself.
cargo run -p mentedb-server -- --data-dir ./data --jwt-secret-file ./secret.key
Builds and then immediately runs the program.
// Enable enrichment in Cargo.toml:
Type this command into your terminal and run it.
cargo test -p mentedb-extraction --test llm_accuracy -- --ignored --nocapture
Type this command into your terminal and run it.
Pulled directly from this repo's README.