Skip to content

ruvnet/RuLake

Repository files navigation

ruLake — A Memory Lake for Agentic AI

ruLake Console — live demo at ruvnet.github.io/RuLake/

Try the live Console → — boots in DEMO, auto-probes the hosted MCP at rulake-mcp.ruv.io, flips to ● LIVE when the wire's up. Eight tools served, zero install.

Crates.io Rust 1.89+ RuVector ruv.io MIT / Apache-2.0

rulake-mcp rvdna-mcp ruqu-mcp

Self-learning memory for your AI agents — without standing up a vector database.

ruLake gives your AI agents memory that gets faster the more it's used. Point it at the storage you already have (S3, BigQuery, Snowflake, Parquet, files), and every agent — on every host — shares the same fast, trustworthy recall. It learns what gets asked (so the next ask returns in about a millisecond), pins each answer to a cryptographic receipt (so two agents on two machines see the byte-identical result), and refuses to guess when the underlying data has changed (an honest "I don't know" beats a confident lie). Roughly 1 ms per lookup at 100,000 things to remember, 32× less RAM than the raw embeddings, zero per-query cost.

Created by rUv. Part of the RuVector ecosystem alongside ruvector-rabitq (1-bit compression kernel) and RVF (durable segment format). Powered by Cognitum.

Quick start

# Five install paths. Pick the one that fits where your agent runs.
cargo add rulake                      # Rust
pip   install rulake                  # Python
npm   install rulake                  # Node.js / TypeScript (native binary)
npm   install rulake-wasm             # Browsers, Cloudflare Workers, Deno, Bun
# Claude Code, Cursor, Cline — install the marketplace (ADR-009)
/plugin marketplace add ruvnet/RuLake
/plugin install rulake-stack@rulake-marketplace
/reload-plugins                                  # required — Claude Code's install message asks for this

# Slash commands resolve via <plugin>:<command>. Type /ru to autocomplete.
/rulake-stack:rulake-query "what does ADR-157 commit to?"
/rulake-stack:rulake-verify path/to/table.rulake.json
/rulake-stack:rulake-bundle-info path/to/table.rulake.json

rulake-stack is the killer-path install. To use the namespaced form /rulake-core:*, /rulake-witness:*, or /rulake-kernels:*, install those plugins separately (/plugin install <name>@rulake-marketplace).

Claude Code integration — at a glance

Feature What it does
One-command install /plugin install rulake-stack@rulake-marketplace — no API keys, no config files, nothing to set up
🚀 Working in under a minute Type four lines, get a real query result with a receipt back
🔌 Three free demo servers built in Talks to rulake-mcp.ruv.io, rvdna-mcp.ruv.io, ruqu-mcp.ruv.io out of the box
🎯 18 ready-to-use tools 8 retrieval (search / verify / explain / refresh) + 5 genomic + 5 quantum
🛡️ Cryptographic receipt on every answer Each result is fingerprinted; tampered or stale data is rejected, not served
📊 A decision trace with every answer The agent sees how it was made: what it cost, where it came from, how long it took, what was refused
🔬 Verify an answer without the network /rulake-stack:rulake-verify path/to/bundle.json — runs locally, no server needed
🧬 Genomic memory built in Find variants, score sequences, trace lineage, translate to protein — five tools
⚛️ Quantum simulation built in Run circuits, verify results, replay history, optimize, schedule error-correction — five tools
⚙️ Optional speed-ups for big workloads Plug in CPU vector instructions or GPU shaders when you need them; fall back to plain CPU when you don't
🏗️ Six plugins, mix and match stack (all-in-one) plus core, substrates, kernels, witness, loop-vector for finer control
💸 Free forever, $0 per query MIT or Apache-2.0; no service to pay for, no per-query metering, no API key

Six-plugin catalog + trust posture: see ADR-009. For the bare npm install rulake-wasm path on edge runtimes (browsers, Cloudflare Workers, Deno, Bun), see the install paths above.

Where to next

  • USERGUIDE.md — full README content moved here: architecture, performance, capabilities (35 features), backends, kernels, security model, examples, status, comparisons.
  • docs/userguide/ — screen-by-screen Console walkthrough with all 7 screenshots. 11 markdown files covering Stats / App Store / Connect / Backends / Bundle / Playground / Audit + Live MCP setup + Troubleshooting.
  • docs/gists/ — 11 deep gists, ~34k words. One per shipped ADR.
  • docs/deploy/cloud-run.md — production deploy recipe (the one that powers https://rulake-mcp.ruv.io/).
  • ADR-009 — the Claude Code plugin marketplace shape + trust posture.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option. Open source. ❤️ Free forever.

About

A cache-coherent vector execution fabric — sits in front of any vector store/lakehouse and makes queries fast. Part of the RuVector ecosystem.

Resources

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Packages

 
 
 

Contributors