Vector Setup

ruvector@0.2.25

/vector

Why this exists

/vector

ONNX WASM files not bundled. The onnx/ directory is missing.

ruvector-onnx-embeddings-wasm

Brain commands require @ruvector/pi-brain

@ruvector/pi-brain

SONA not available. Native error: Cannot find module '/.../@ruvector/sona/index.js'

@ruvector/ruvllm

LLM commands require @ruvector/ruvllm

@ruvector/ruvllm

Steps

1. Pin ruvector:
   bash

   npm install ruvector@0.2.25

2. Install the add-ons (idempotent — only what's missing):
   bash

   npm install ruvector-onnx-embeddings-wasm \
               @ruvector/pi-brain \
               @ruvector/ruvllm

   For a leaner install, pass

   --full

   to also pull

   @ruvector/graph-node

   and

   @ruvector/router

   :
   bash

   npm install ruvector-onnx-embeddings-wasm \
               @ruvector/pi-brain \
               @ruvector/ruvllm \
               @ruvector/graph-node \
               @ruvector/router

3. Verify the binary:
   bash

   npx -y ruvector@0.2.25 doctor
   npx -y ruvector@0.2.25 info

4. Register the MCP server:
   bash

   claude mcp add ruvector -- npx -y ruvector@0.2.25 mcp start
   claude mcp list | grep ruvector

5. Sanity check the most common subcommands:
   bash

   npx -y ruvector@0.2.25 hooks route "test"
   npx -y ruvector@0.2.25 attention list
   npx -y ruvector@0.2.25 rvf examples

6. (Optional) Generate a pi identity for brain + edge:
   bash

   npx -y ruvector@0.2.25 identity generate
   npx -y ruvector@0.2.25 identity show

Smoke test

bash plugins/ruflo-ruvector/scripts/smoke.sh

hooks ast-analyze

hooks route

attention list

rvf examples

info

What this does not install

• Native Rust toolchain (optional; only needed for source builds)
• Platform-specific native bindings (auto-detected by

  @ruvector/core

  )

• @ruvector/sona

  native binding (the JS fallback via

  @ruvector/ruvllm

  is sufficient on macOS arm64; Linux x64 has its own native binding)

doctor